FE-1350: fix popover point positioning

[alex-e-leon]

🌟 What is the purpose of this PR?

• Fixes popover positioning + tracking when position "point" is set
• Adds autofocus: "never" prop to inputs + buttons now that ark-ui + zag have implemented it (Support data-no-autofocus in focusTrap or similar chakra-ui/zag#3161 (comment))
• Prevents close buttons + tooltips from being autofocused in dialogs
• Removes custom code in popover to handle focus out properly now that zag.js have fixed the issue
• Splits Tooltip + BaseTooltip to allow for full tooltip UI customization.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• does not modify any publishable blocks or libraries, or modifications do not need publishing

📜 Does this require a change to the docs?

The changes in this PR:

• are internal and do not require a docs change

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview	Aug 12, 2026 9:03am
hashdotdesign-tokens	Ready	Preview	Aug 12, 2026 9:03am
petrinaut	Ready	Preview	Aug 12, 2026 9:03am

[cursor]

PR Summary

Medium Risk
Touches focus management across many form/overlay components and rewrite popover positioning logic, so regressions could affect keyboard accessibility and overlay placement. No auth, security, or data-handling changes.

Overview
Fixes popover positionFromPoint positioning and live tracking, and improves overlay autofocus behavior after bumping @ark-ui/react / @zag-js.

Popover now keeps point and cross-axis gap values current via refs + animation-frame listeners, applies flip-aware main-axis gaps through offset with a RepositionOnGapChange nudge, and replaces the custom tab-focus proxy with zag’s proxyTabFocus. Also adds positionerClassName and a transform-origin for open/close animation.

Autofocus gains autoFocus="never" (via resolveAutoFocusProps → data-no-autofocus) on buttons and form controls. Dialog/drawer/popover close buttons and header action buttons opt out so focus lands on real content instead of chrome.

Tooltip is split into an unstyled, exported BaseTooltip plus a thin styled Tooltip wrapper for custom tooltip UIs.

^{Reviewed by Cursor Bugbot for commit eff00bb. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 4e4eca5. Configure here.}

[lunelson]

Looks good, although I don't quite get the "center" and "outside" position options

[alex-e-leon]

Looks good, although I don't quite get the "center" and "outside" position options

Those 2 story examples are poorly labeled/named. The 2 prop options are actually:

// The preferred position of the popover - depending on the viewport, trigger and content another position may be chosen for better fit
position?: Position;

// Instead of positioning around the trigger, position from a specific point inside or outside the trigger where 0,0 is the top left of the trigger element
positionFromPoint?: { x: number; y: number };

And the center and outside examples are just test cases for positionFromPoint.

positionFromPoint was specifically added for attaching a popover to an element inside a canvas (which has no dom node to connect to), which I needed in graph-viz, and almost all the tables in hash-app currently are virtualized in canvas too.

[alex-e-leon]

Also, in case I haven't said this before - it's worth noting that ladle examples are actually the UI tests for the DS rather than documentation, the goal being to render out specific edge cases for visual testing + regressions.

It also happens to have a lot of crossover with documenting the various features + props though, which is great while we don't have proper generated documentation yet - but it can mean that you'll sometimes see examples which are more for handling edge cases than real expected usage.