@ahrowe/ui 0.41.1 → 0.41.2

package/dist/types/common/hooks/useAnchorTracking.d.ts

@@ -9,10 +9,11 @@ export interface UseAnchorTrackingArgs {
      */
     elementRefs: RefObject<HTMLElement | null>[];
     /**
-     * Positions the popup. Called once on setup and then on every scroll, resize and tracked size
-     * change. Reads the caller's own refs for everything beyond the two arguments.
+     * Positions the popup. Called once on setup and then on every scroll, resize, tracked size
+     * change and end of a CSS animation that moved the trigger, plus whenever it calls `rerun` for
+     * an end none of those report. Reads the caller's own refs for everything else.
      */
-    update: (trigger: HTMLElement, ancestors: HTMLElement[]) => void;
+    update: (trigger: HTMLElement, ancestors: HTMLElement[], rerun: () => void) => void;
     /**
      * Elements whose own size changes must re-run `update`: a popup whose content changes size
      * while open (a filtered list shrinking, an async list loading in) otherwise keeps coordinates

package/dist/types/common/popover/usePopoverPosition.d.ts

@@ -32,6 +32,11 @@ export interface UsePopoverPositionArgs {
      * panel that overhangs it.
      */
     shrinkToFit?: boolean;
+    /**
+     * Called when a newly opened panel first becomes visible. Focus has to wait for it: a panel
+     * still hidden, waiting out an ancestor's animation, takes none.
+     */
+    onShown?: () => void;
 }
 /**
  * Positions a portaled, `position: fixed` popover on any of the four sides of its trigger with
@@ -42,4 +47,4 @@ export interface UsePopoverPositionArgs {
  * `useAnchorTracking` supplies the lifecycle around this: mount wait, ancestor resolution, and
  * re-running on scroll, viewport resize and panel size changes.
  */
-export declare function usePopoverPosition({ isOpen, placement, align, offset, triggerRef, floatingRef, panelRef, arrowRef, matchTriggerWidth, shrinkToFit, }: UsePopoverPositionArgs): void;
+export declare function usePopoverPosition({ isOpen, placement, align, offset, triggerRef, floatingRef, panelRef, arrowRef, matchTriggerWidth, shrinkToFit, onShown, }: UsePopoverPositionArgs): void;

package/docs/Modal.md

@@ -8,7 +8,7 @@
 
 The panel itself never scrolls: the header is fixed and the children scroll inside the `body` slot, so the title and close button stay visible no matter how long the content is. Pass `footer` for anything that should stay put below the content, typically the action buttons.
 
-While open, the modal traps focus (focus moves into the panel and returns to whatever was focused before on close), locks scrolling on the page behind it, and closes on Escape. A key already held down when it opens does not repeat into it, so holding Enter on the button that opens it does not go on to press whatever the modal focused first. Modals nest correctly: Escape closes only the topmost one, and the page stays locked until the last one closes. The same applies to anything opened from inside a modal — a `Menu`, `Dropdown` or `Popover` counts as the layer above it, so Escape closes that first, and the modal's focus trap leaves focus alone while it's open (all three render through the same portal, so their DOM sits beside the modal's panel rather than inside it).
+While open, the modal traps focus (focus moves into the panel and returns to whatever was focused before on close), locks scrolling on the page behind it, and closes on Escape. A key already held down when it opens does not repeat into it, so holding Enter on the button that opens it does not go on to press whatever the modal focused first. Modals nest correctly: Escape closes only the topmost one, and the page stays locked until the last one closes. Modal, Popover and Tooltip share one `z-index`, so whichever opened last paints on top, a Modal opened from a Popover included. The same applies to anything opened from inside a modal — a `Menu`, `Dropdown` or `Popover` counts as the layer above it, so Escape closes that first, and the modal's focus trap leaves focus alone while it's open (all three render through the same portal, so their DOM sits beside the modal's panel rather than inside it).
 
 ```tsx
 import { Modal, ActionButtons } from '@ahrowe/ui';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahrowe/ui",
-  "version": "0.41.1",
+  "version": "0.41.2",
   "description": "A React UI component library with theming, CSS Modules, and TypeScript support",
   "keywords": [
     "agent",