@astryxdesign/core 0.5.2-canary.c9c8564 → 0.5.2-canary.e4f8e4e

package/dist/Selector/selectorPresentation.stylex.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file selectorPresentation.stylex.ts
+ * @input Uses field border tokens
+ * @output Shared focus-return styles for Selector and MultiSelector
+ * @position Internal visual policy for selector presentation changes
+ */
+import * as stylex from '@stylexjs/stylex';
+export declare const selectorPresentationStyles: Readonly<{
+    readonly pointerRestoredFocus: Readonly<{
+        readonly borderColor: stylex.StyleXClassNameFor<"borderColor", "light-dark(#CCD3DB, #494D53)">;
+        readonly boxShadow: stylex.StyleXClassNameFor<"boxShadow", "none">;
+        readonly outlineWidth: stylex.StyleXClassNameFor<"outlineWidth", "0">;
+        readonly outlineStyle: stylex.StyleXClassNameFor<"outlineStyle", "none">;
+    }>;
+}>;
+//# sourceMappingURL=selectorPresentation.stylex.d.ts.map

package/dist/Selector/selectorPresentation.stylex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectorPresentation.stylex.d.ts","sourceRoot":"","sources":["../../src/Selector/selectorPresentation.stylex.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAG3C,eAAO,MAAM,0BAA0B;;;;;;;EAOrC,CAAC"}

package/dist/Selector/selectorPresentation.stylex.js

@@ -0,0 +1,21 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file selectorPresentation.stylex.ts
+ * @input Uses field border tokens
+ * @output Shared focus-return styles for Selector and MultiSelector
+ * @position Internal visual policy for selector presentation changes
+ */
+
+import * as stylex from '@stylexjs/stylex';
+import "../theme/tokens.stylex.js";
+import { colorVars } from "../theme/tokens.stylex.js";
+export const selectorPresentationStyles = {
+  pointerRestoredFocus: {
+    kVAM5u: "xvy26l8",
+    kGVxlE: "x1gnnqk1",
+    kMeerF: "x1k57tk5",
+    k3XXqK: "x1t137rt",
+    $$css: true
+  }
+};

package/dist/Selector/useSelectorPresentation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @file useSelectorPresentation.ts
+ * @input Uses the shared adaptive presentation policy and usePopover
+ * @output Coordinates popover and bottom-sheet disclosure state
+ * @position Internal presentation controller shared by Selector and MultiSelector
+ */
+import { type FocusEvent, type RefObject } from 'react';
+import { type UsePopoverOptions, type UsePopoverReturn } from '../Popover/usePopover';
+import { type AdaptivePresentation, type ResolvedAdaptivePresentation } from '../hooks/useAdaptivePresentation';
+interface UseSelectorPresentationOptions {
+    presentation: AdaptivePresentation;
+    onHide: () => void;
+    popoverOptions: Omit<UsePopoverOptions, 'onHide'>;
+    triggerRef: RefObject<HTMLElement | null>;
+}
+interface SelectorPresentationController {
+    activePresentation: ResolvedAdaptivePresentation;
+    hide: () => void;
+    isOpen: boolean;
+    isSheetOpen: boolean;
+    isTriggerFocusRingSuppressed: boolean;
+    onSheetOpenChange: (isOpen: boolean) => void;
+    onTriggerFocus: (event: FocusEvent<HTMLElement>) => void;
+    popover: UsePopoverReturn & {
+        wasJustDismissed: () => boolean;
+    };
+    show: () => void;
+    wasJustDismissed: () => boolean;
+}
+export declare function useSelectorPresentation({ presentation, onHide, popoverOptions, triggerRef, }: UseSelectorPresentationOptions): SelectorPresentationController;
+export {};
+//# sourceMappingURL=useSelectorPresentation.d.ts.map

package/dist/Selector/useSelectorPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectorPresentation.d.ts","sourceRoot":"","sources":["../../src/Selector/useSelectorPresentation.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EAClC,MAAM,kCAAkC,CAAC;AAG1C,UAAU,8BAA8B;IACtC,YAAY,EAAE,oBAAoB,CAAC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,cAAc,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAClD,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED,UAAU,8BAA8B;IACtC,kBAAkB,EAAE,4BAA4B,CAAC;IACjD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B,EAAE,OAAO,CAAC;IACtC,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,gBAAgB,GAAG;QAAC,gBAAgB,EAAE,MAAM,OAAO,CAAA;KAAC,CAAC;IAC9D,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,gBAAgB,EAAE,MAAM,OAAO,CAAC;CACjC;AAED,wBAAgB,uBAAuB,CAAC,EACtC,YAAY,EACZ,MAAM,EACN,cAAc,EACd,UAAU,GACX,EAAE,8BAA8B,GAAG,8BAA8B,CA2FjE"}

package/dist/Selector/useSelectorPresentation.js

@@ -0,0 +1,90 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useSelectorPresentation.ts
+ * @input Uses the shared adaptive presentation policy and usePopover
+ * @output Coordinates popover and bottom-sheet disclosure state
+ * @position Internal presentation controller shared by Selector and MultiSelector
+ */
+import { useCallback, useRef, useState } from 'react';
+import { usePopoverInternal } from "../Popover/usePopover.js";
+import { useAdaptivePresentation } from "../hooks/useAdaptivePresentation.js";
+import { useFocusReturnVisibility } from "../hooks/useFocusReturnVisibility.js";
+export function useSelectorPresentation({
+  presentation,
+  onHide,
+  popoverOptions,
+  triggerRef
+}) {
+  const resolvedPresentation = useAdaptivePresentation(presentation);
+  const activePresentationRef = useRef(resolvedPresentation);
+  const [isSheetOpen, setIsSheetOpen] = useState(false);
+  const isSheetOpenRef = useRef(false);
+  const onHideRef = useRef(onHide);
+  const {
+    isFocusRingSuppressed,
+    onFocusReturnTargetFocus,
+    prepareFocusReturn,
+    resetFocusReturn
+  } = useFocusReturnVisibility();
+  onHideRef.current = onHide;
+  const handlePopoverHide = useCallback(() => {
+    prepareFocusReturn();
+    onHideRef.current();
+    triggerRef.current?.focus();
+  }, [prepareFocusReturn, triggerRef]);
+  const popover = usePopoverInternal({
+    ...popoverOptions,
+    onHide: handlePopoverHide
+  });
+  const {
+    hide: hidePopover,
+    show: showPopover,
+    wasJustDismissed: wasPopoverJustDismissed
+  } = popover;
+  const show = useCallback(() => {
+    resetFocusReturn();
+    activePresentationRef.current = resolvedPresentation;
+    if (resolvedPresentation === 'bottom-sheet') {
+      isSheetOpenRef.current = true;
+      setIsSheetOpen(true);
+    } else {
+      showPopover();
+    }
+  }, [resetFocusReturn, resolvedPresentation, showPopover]);
+  const hide = useCallback(() => {
+    if (isSheetOpenRef.current) {
+      prepareFocusReturn();
+      isSheetOpenRef.current = false;
+      setIsSheetOpen(false);
+      onHideRef.current();
+    } else {
+      hidePopover();
+    }
+  }, [hidePopover, prepareFocusReturn]);
+  const handleTriggerFocus = useCallback(_event => onFocusReturnTargetFocus(), [onFocusReturnTargetFocus]);
+  const handleSheetOpenChange = useCallback(nextIsOpen => {
+    if (nextIsOpen) {
+      show();
+    } else {
+      hide();
+    }
+  }, [hide, show]);
+  const isOpen = popover.isOpen || isSheetOpen;
+  const activePresentation = isOpen ? activePresentationRef.current : resolvedPresentation;
+  const wasJustDismissed = useCallback(() => activePresentationRef.current === 'popover' && wasPopoverJustDismissed(), [wasPopoverJustDismissed]);
+  return {
+    activePresentation,
+    hide,
+    isOpen,
+    isSheetOpen,
+    isTriggerFocusRingSuppressed: isFocusRingSuppressed,
+    onSheetOpenChange: handleSheetOpenChange,
+    onTriggerFocus: handleTriggerFocus,
+    popover,
+    show,
+    wasJustDismissed
+  };
+}

package/dist/Toast/useToastGesture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToastGesture.d.ts","sourceRoot":"","sources":["../../src/Toast/useToastGesture.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAC,YAAY,IAAI,iBAAiB,EAAE,SAAS,EAAC,MAAM,OAAO,CAAC;AAWxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAoB3C,UAAU,sBAAsB;IAC9B,SAAS,EAAE,qBAAqB,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kBAAkB,EAAE,CAClB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,IAAI,EAAE,WAAW,KACd,OAAO,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAClE,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAClE,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAChE,eAAe,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACpE,oBAAoB,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CAC1E;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC1C,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAcD,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,OAAO,EACP,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,OAAO,EACP,kBAAkB,GACnB,EAAE,sBAAsB,GAAG,qBAAqB,CA4QhD"}
+{"version":3,"file":"useToastGesture.d.ts","sourceRoot":"","sources":["../../src/Toast/useToastGesture.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAC,YAAY,IAAI,iBAAiB,EAAE,SAAS,EAAC,MAAM,OAAO,CAAC;AAWxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAsB3C,UAAU,sBAAsB;IAC9B,SAAS,EAAE,qBAAqB,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kBAAkB,EAAE,CAClB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,IAAI,EAAE,WAAW,KACd,OAAO,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAClE,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAClE,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAChE,eAAe,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACpE,oBAAoB,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CAC1E;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC1C,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAcD,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,OAAO,EACP,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,OAAO,EACP,kBAAkB,GACnB,EAAE,sBAAsB,GAAG,qBAAqB,CA+ThD"}

package/dist/Toast/useToastGesture.js

@@ -62,6 +62,7 @@ export function useToastGesture({
     }
     const surfaceSize = Math.max(root.getBoundingClientRect().height, 1);
     gestureRef.current = {
+      source: point.source,
       pointerId: point.pointerId,
       startX: point.clientX,
       startY: point.clientY,
@@ -77,7 +78,7 @@ export function useToastGesture({
   const moveGesture = useCallback((point, preventDefault, releaseCapture) => {
     const state = gestureRef.current;
     const root = rootRef.current;
-    if (!state || !root || point.pointerId !== state.pointerId) {
+    if (!state || !root || point.source !== state.source || point.pointerId !== state.pointerId) {
       return;
     }
     const deltaX = point.clientX - state.startX;
@@ -111,7 +112,7 @@ export function useToastGesture({
   const endGesture = useCallback(point => {
     const state = gestureRef.current;
     const root = rootRef.current;
-    if (!state || !root || point.pointerId !== state.pointerId) {
+    if (!state || !root || point.source !== state.source || point.pointerId !== state.pointerId) {
       return;
     }
     const travel = Math.max(0, (point.clientY - state.startY) * state.direction);
@@ -120,6 +121,10 @@ export function useToastGesture({
     gestureRef.current = null;
     root.style.removeProperty('transition-duration');
     if (isDismissed) {
+      // The exit animation owns the final translation. Clear the live-drag
+      // transform/fade/scale first so a standalone Toast does not remain
+      // partially translated or faded after its dismiss callback fires.
+      clearTransientStyles(root);
       root.style.setProperty('--_toast-swipe-exit-y', state.direction === 1 ? SWIPE_EXIT_DISTANCE : `calc(-1 * ${SWIPE_EXIT_DISTANCE})`);
       dismiss();
       return;
@@ -130,7 +135,12 @@ export function useToastGesture({
     }
   }, [dismiss, resumeTimer]);
   const handlePointerDown = useCallback(event => {
-    if (event.pointerType === 'pen' && (event.button == null || event.button === 0) && beginGesture(event, event.target)) {
+    if (event.pointerType === 'pen' && (event.button == null || event.button === 0) && beginGesture({
+      source: 'pen',
+      pointerId: event.pointerId,
+      clientX: event.clientX,
+      clientY: event.clientY
+    }, event.target)) {
       rootRef.current?.setPointerCapture?.(event.pointerId);
     }
   }, [beginGesture]);
@@ -138,17 +148,27 @@ export function useToastGesture({
     if (event.pointerType !== 'pen') {
       return;
     }
-    moveGesture(event, () => event.preventDefault(), () => rootRef.current?.releasePointerCapture?.(event.pointerId));
+    moveGesture({
+      source: 'pen',
+      pointerId: event.pointerId,
+      clientX: event.clientX,
+      clientY: event.clientY
+    }, () => event.preventDefault(), () => rootRef.current?.releasePointerCapture?.(event.pointerId));
   }, [moveGesture]);
   const handlePointerUp = useCallback(event => {
     if (event.pointerType !== 'pen') {
       return;
     }
     rootRef.current?.releasePointerCapture?.(event.pointerId);
-    endGesture(event);
+    endGesture({
+      source: 'pen',
+      pointerId: event.pointerId,
+      clientX: event.clientX,
+      clientY: event.clientY
+    });
   }, [endGesture]);
   const handlePointerCancel = useCallback(event => {
-    if (event.pointerType === 'pen' && gestureRef.current?.pointerId === event.pointerId) {
+    if (event.pointerType === 'pen' && gestureRef.current?.source === 'pen' && gestureRef.current?.pointerId === event.pointerId) {
       resetGesture(true);
     }
   }, [resetGesture]);
@@ -158,21 +178,34 @@ export function useToastGesture({
       return;
     }
     const point = touch => ({
+      source: 'touch',
       pointerId: touch.identifier,
       clientX: touch.clientX,
       clientY: touch.clientY
     });
     const changedTouch = event => {
-      const pointerId = gestureRef.current?.pointerId;
+      const state = gestureRef.current;
+      const pointerId = state?.source === 'touch' ? state.pointerId : null;
       return pointerId == null ? undefined : [...event.changedTouches].find(touch => touch.identifier === pointerId);
     };
     const handleTouchStart = event => {
-      const touch = event.touches.length === 1 ? event.changedTouches[0] : null;
-      if (touch) {
+      if (event.touches?.length !== 1) {
+        // A second contact means the browser may be handling pinch zoom or
+        // two-finger scrolling. Abandon any accepted one-finger swipe before
+        // touchmove can suppress that native gesture.
+        resetGesture(true);
+        return;
+      }
+      const touch = event.changedTouches[0];
+      if (touch != null) {
         beginGesture(point(touch), event.target);
       }
     };
     const handleTouchMove = event => {
+      if (event.touches?.length !== 1) {
+        resetGesture(true);
+        return;
+      }
       const touch = changedTouch(event);
       if (touch) {
         moveGesture(point(touch), () => {
@@ -183,6 +216,10 @@ export function useToastGesture({
       }
     };
     const handleTouchEnd = event => {
+      if (event.touches.length > 0) {
+        resetGesture(true);
+        return;
+      }
       const touch = changedTouch(event);
       if (touch) {
         endGesture(point(touch));

package/dist/astryx.css

@@ -494,6 +494,7 @@
   .x1ho7dyk:not(#\#):not(#\#){margin-inline:calc(-1 * var(--spacing-2))}
   .x1ng9b9t:not(#\#):not(#\#){margin-inline:calc(-1 * var(--spacing-4))}
   .xhrcg97:not(#\#):not(#\#){margin-inline:var(--spacing-1)}
+  .xam6yil:not(#\#):not(#\#){margin-inline:var(--spacing-3)}
   .xvlecxo:not(#\#):not(#\#){margin-inline:var(--x-marginInline)}
   .x1a2a7pz:not(#\#):not(#\#){outline:none}
   .xaw4jrz:not(#\#):not(#\#){outline:var(--_focus-outline,none)}
@@ -597,6 +598,7 @@
   .x1i10hfl:not(#\#):not(#\#):not(#\#){-webkit-tap-highlight-color:transparent}
   .xg7jpbn:not(#\#):not(#\#):not(#\#){-webkit-text-fill-color:transparent}
   .xpdipgo:not(#\#):not(#\#):not(#\#){-webkit-touch-callout:none}
+  .x1winvzj:not(#\#):not(#\#):not(#\#){-webkit-user-select:none}
   .x8gbvx8:not(#\#):not(#\#):not(#\#){align-content:flex-start}
   .x1pha0wt:not(#\#):not(#\#):not(#\#){align-items:baseline}
   .x6s0dn4:not(#\#):not(#\#):not(#\#){align-items:center}
@@ -709,6 +711,7 @@
   .xafqdz2:not(#\#):not(#\#):not(#\#){background-image:linear-gradient(to bottom,var(--color-background-surface) 60%,transparent)}
   .x1vrk509:not(#\#):not(#\#):not(#\#){background-image:linear-gradient(var(--color-background-muted),var(--color-background-muted))}
   .x14bno8m:not(#\#):not(#\#):not(#\#){background-image:linear-gradient(var(--color-neutral),var(--color-neutral))}
+  .xpl5ynk:not(#\#):not(#\#):not(#\#){background-image:linear-gradient(var(--color-overlay-pressed),var(--color-overlay-pressed))}
   .x18o3ruo:not(#\#):not(#\#):not(#\#){background-image:none}
   .x1mwwwfo:not(#\#):not(#\#):not(#\#){border-collapse:collapse}
   .x16uus16:not(#\#):not(#\#):not(#\#){border-end-end-radius:0}
@@ -1012,6 +1015,7 @@
   .xkd40ry:not(#\#):not(#\#):not(#\#){margin-inline-end:calc(-1 * var(--spacing-1))}
   .x3kzqx6:not(#\#):not(#\#):not(#\#){margin-inline-end:calc(-1 * var(--spacing-2))}
   .xmequkd:not(#\#):not(#\#):not(#\#){margin-inline-end:calc(var(--spacing-1) * -1)}
+  .xxeicf8:not(#\#):not(#\#):not(#\#){margin-inline-end:max(var(--spacing-4),env(safe-area-inset-left,0px),env(safe-area-inset-right,0px))}
   .xnur1sd:not(#\#):not(#\#):not(#\#){margin-inline-end:var(--spacing-1)}
   .x1c9tiao:not(#\#):not(#\#):not(#\#){margin-inline-end:var(--x-marginInlineEnd)}
   .x1qfufaz:not(#\#):not(#\#):not(#\#){margin-inline-start:-8px}
@@ -1022,9 +1026,11 @@
   .x1wim8z0:not(#\#):not(#\#):not(#\#){margin-inline-start:calc(-1 * var(--layout-padding-inner-x,var(--spacing-4)))}
   .x1s1akpx:not(#\#):not(#\#):not(#\#){margin-inline-start:calc(-1 * var(--spacing-2))}
   .x1xrm450:not(#\#):not(#\#):not(#\#){margin-inline-start:calc(var(--spacing-2) - var(--spacing-1) + 1px)}
+  .x47fqr9:not(#\#):not(#\#):not(#\#){margin-inline-start:max(var(--spacing-4),env(safe-area-inset-left,0px),env(safe-area-inset-right,0px))}
   .x12vn87o:not(#\#):not(#\#):not(#\#){margin-inline-start:var(--_tree-indent,0px)}
   .xladpz9:not(#\#):not(#\#):not(#\#){margin-inline-start:var(--spacing-0-5)}
   .x11g1kdw:not(#\#):not(#\#):not(#\#){margin-inline-start:var(--spacing-1)}
+  .x6i7dpz:not(#\#):not(#\#):not(#\#){margin-inline-start:var(--spacing-3)}
   .x1l10yog:not(#\#):not(#\#):not(#\#){margin-inline-start:var(--spacing-6)}
   .x4lel18:not(#\#):not(#\#):not(#\#){margin-inline-start:var(--x-marginInlineStart)}
   .xkm2don:not(#\#):not(#\#):not(#\#){mask-image:linear-gradient(to bottom,transparent,black 24px)}
@@ -1298,6 +1304,7 @@
   .x1vxsm5i:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){animation-name:xu7jd1z-B}
   .x18lne9g:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){animation-name:xwmkjkf-B}
   .x1spg45b.x1spg45b:hover:where(:not(:disabled,[aria-disabled="true"])):not(#\#):not(#\#):not(#\#){background-color:var(--color-accent)}
+  .x1anq1lc.x1anq1lc:active:where(:not(:disabled,[aria-disabled="true"])):not(#\#):not(#\#):not(#\#){background-color:var(--color-overlay-pressed)}
   .x1rmb4wm:not(:has(~ *:not([popover]):not(template))):not(#\#):not(#\#):not(#\#){border-end-end-radius:var(--radius-element)}
   .xturttb:not(:has(~ *:not([popover]):not(template))):not(#\#):not(#\#):not(#\#){border-end-start-radius:var(--radius-element)}
   .x1tzxhge:not(:has(~ *:not([popover]):not(template))):not(#\#):not(#\#):not(#\#){border-start-end-radius:var(--radius-element)}
@@ -1310,7 +1317,9 @@
   .x16khyan:is(:disabled,[aria-disabled="true"]):not(#\#):not(#\#):not(#\#){cursor:default}
   .x1y40yee:popover-open:not(#\#):not(#\#):not(#\#){display:flex}
   .x1sik18w:not(:first-child):not(#\#):not(#\#):not(#\#){margin-inline-start:var(--_avatar-group-overlap)}
+  .x17xqekc:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){mask-image:linear-gradient(to left,transparent 0%,rgba(0,0,0,.3) 2px,black var(--spacing-1))}
   .x1nwey30:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){mask-image:linear-gradient(to left,transparent var(--_tab-strip-bleed),black calc(var(--_tab-strip-bleed) + var(--spacing-8)))}
+  .x8ulde1:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){mask-image:linear-gradient(to right,transparent 0%,rgba(0,0,0,.3) 2px,black var(--spacing-1))}
   .x1rxa4r8:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){mask-image:linear-gradient(to right,transparent var(--_tab-strip-bleed),black calc(var(--_tab-strip-bleed) + var(--spacing-8)))}
   .x1euntei:focus-within:not(#\#):not(#\#):not(#\#){opacity:1}
   .x25t5g8:focus-visible:not(#\#):not(#\#):not(#\#){opacity:1}
@@ -1331,6 +1340,7 @@
   .xbt4iw:focus-within:not(#\#):not(#\#):not(#\#){pointer-events:auto}
   .xo74pv5:focus-within:not(#\#):not(#\#):not(#\#){position:static}
   .x1mqgsch:is([data-astryx-scrolling]):not(#\#):not(#\#):not(#\#){scrollbar-width:none}
+  .x8ppqj.x8ppqj:active:where(:not(:disabled,[aria-disabled="true"])):not(#\#):not(#\#):not(#\#){transform:scale(.98)}
   .xaafvuh:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){transform:scaleX(-1) rotate(0deg)}
   .x1nxqau:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){transform:scaleX(-1) rotate(90deg)}
   .xgtlewx:is([dir="rtl"] *):not(#\#):not(#\#):not(#\#){transform:scaleX(-1)}
@@ -1414,7 +1424,6 @@
   @media (prefers-reduced-motion: reduce){.xsr0bmt.xsr0bmt:not(#\#):not(#\#):not(#\#){transition-duration:0s,0s}}
   @media (prefers-reduced-motion: reduce){.x12w9bfk.x12w9bfk:not(#\#):not(#\#):not(#\#){transition-duration:0s}}
   @media (prefers-reduced-motion: reduce){.x4wkmsb.x4wkmsb:not(#\#):not(#\#):not(#\#){transition-property:none}}
-  .x1anq1lc.x1anq1lc:active:where(:not(:disabled,[aria-disabled="true"])):not(#\#):not(#\#):not(#\#){background-color:var(--color-overlay-pressed)}
   .xzmimnh.xzmimnh:active:where(:not(:disabled,[aria-disabled="true"])):not(#\#):not(#\#):not(#\#){background-image:linear-gradient(var(--color-overlay-pressed),var(--color-overlay-pressed)),linear-gradient(var(--color-neutral),var(--color-neutral))}
   .x7uyq82.x7uyq82:active:where(:not(:disabled,[aria-disabled="true"])):not(#\#):not(#\#):not(#\#){background-image:linear-gradient(var(--color-overlay-pressed),var(--color-overlay-pressed))}
   @media (hover: hover) and (forced-colors: none){.xcgwt1n.xcgwt1n.xcgwt1n:where(.x1iwu4tg:hover *):not(#\#):not(#\#):not(#\#){background-color:color-mix(in srgb,var(--color-accent),var(--color-tint-hover) 15%)}}
@@ -1555,6 +1564,7 @@
   .x6h7pi7:not(#\#):not(#\#):not(#\#):not(#\#){margin-bottom:calc(-1 * var(--container-padding-block-end,0px))}
   .x1cdrix3:not(#\#):not(#\#):not(#\#):not(#\#){margin-bottom:calc(-1 * var(--radius-chat))}
   .xdrfirk:not(#\#):not(#\#):not(#\#):not(#\#){margin-bottom:calc(-1 * var(--spacing-1-5))}
+  .x1kps3mo:not(#\#):not(#\#):not(#\#):not(#\#){margin-bottom:max(var(--spacing-4),env(safe-area-inset-bottom,0px))}
   .xlstkdb:not(#\#):not(#\#):not(#\#):not(#\#){margin-bottom:var(--spacing-0-5)}
   .x14cgwvg:not(#\#):not(#\#):not(#\#):not(#\#){margin-bottom:var(--spacing-1)}
   .x1p37lm5:not(#\#):not(#\#):not(#\#):not(#\#){margin-bottom:var(--spacing-2)}
@@ -1572,6 +1582,7 @@
   .x1c40v9y:not(#\#):not(#\#):not(#\#):not(#\#){margin-top:calc(-1 * var(--spacing-1-5))}
   .x1ajqlyv:not(#\#):not(#\#):not(#\#):not(#\#){margin-top:calc(-1 * var(--spacing-2))}
   .x1233pnv:not(#\#):not(#\#):not(#\#):not(#\#){margin-top:calc((1em * var(--text-body-leading) - 6px) / 2)}
+  .xsoubt3:not(#\#):not(#\#):not(#\#):not(#\#){margin-top:max(var(--spacing-4),env(safe-area-inset-top,0px))}
   .xjc2qm6:not(#\#):not(#\#):not(#\#):not(#\#){margin-top:var(--spacing-0-5)}
   .xcsaf9d:not(#\#):not(#\#):not(#\#):not(#\#){margin-top:var(--spacing-1)}
   .xtbrsbv:not(#\#):not(#\#):not(#\#):not(#\#){margin-top:var(--spacing-2)}
@@ -1585,7 +1596,9 @@
   .x1xiyphd:not(#\#):not(#\#):not(#\#):not(#\#){max-height:240px}
   .xuyqlj2:not(#\#):not(#\#):not(#\#):not(#\#){max-height:300px}
   .xbhvqqn:not(#\#):not(#\#):not(#\#):not(#\#){max-height:calc(100% - var(--spacing-3))}
+  .xtm2925:not(#\#):not(#\#):not(#\#):not(#\#){max-height:calc(100vh - var(--spacing-4) - var(--spacing-4));max-height:calc(100dvb - max(var(--spacing-4),env(safe-area-inset-top,0px)) - max(var(--spacing-4),env(safe-area-inset-bottom,0px)))}
   .x14bu9tk:not(#\#):not(#\#):not(#\#):not(#\#){max-height:calc(92dvh + 48px)}
+  .x1hkkhfe:not(#\#):not(#\#):not(#\#):not(#\#){max-height:min(300px,calc(100vh - var(--spacing-4) - var(--spacing-4)));max-height:min(300px,calc(100dvb - max(var(--spacing-4),env(safe-area-inset-top,0px)) - max(var(--spacing-4),env(safe-area-inset-bottom,0px))))}
   .xpnbb6b:not(#\#):not(#\#):not(#\#):not(#\#){max-height:min(480px,calc(100vh - 32px))}
   .x7ab17h:not(#\#):not(#\#):not(#\#):not(#\#){max-height:none}
   .xenllk4:not(#\#):not(#\#):not(#\#):not(#\#){max-height:var(--container-max-height,none)}
@@ -1604,6 +1617,8 @@
   .x11gisft:not(#\#):not(#\#):not(#\#):not(#\#){max-width:640px}
   .x1ap80js:not(#\#):not(#\#):not(#\#):not(#\#){max-width:800px}
   .xq8v1hd:not(#\#):not(#\#):not(#\#):not(#\#){max-width:90%}
+  .xbd96yr:not(#\#):not(#\#):not(#\#):not(#\#){max-width:calc(100% - var(--spacing-4));max-width:calc(100% - max(var(--spacing-4),env(safe-area-inset-left,0px),env(safe-area-inset-right,0px)))}
+  .xs2v1xk:not(#\#):not(#\#):not(#\#):not(#\#){max-width:calc(100vw - var(--spacing-4) - var(--spacing-4));max-width:calc(100vi - max(var(--spacing-4),env(safe-area-inset-left,0px)) - max(var(--spacing-4),env(safe-area-inset-right,0px)))}
   .xl6temz:not(#\#):not(#\#):not(#\#):not(#\#){max-width:max(80%,280px)}
   .x1m1aaou:not(#\#):not(#\#):not(#\#):not(#\#){max-width:min(960px,calc(100dvw - var(--spacing-4)))}
   .x1x1rfll:not(#\#):not(#\#):not(#\#):not(#\#){max-width:none}
@@ -1629,6 +1644,7 @@
   .xeuugli:not(#\#):not(#\#):not(#\#):not(#\#){min-width:0}
   .x1i9suas:not(#\#):not(#\#):not(#\#):not(#\#){min-width:120px}
   .x1d77m7x:not(#\#):not(#\#):not(#\#):not(#\#){min-width:140px}
+  .x12knhqr:not(#\#):not(#\#):not(#\#):not(#\#){min-width:160px;min-width:min(160px,calc(100vw - var(--spacing-4) - var(--spacing-4)));min-width:min(160px,calc(100vi - max(var(--spacing-4),env(safe-area-inset-left,0px)) - max(var(--spacing-4),env(safe-area-inset-right,0px))))}
   .x5w4yej:not(#\#):not(#\#):not(#\#):not(#\#){min-width:160px}
   .xfb3i0g:not(#\#):not(#\#):not(#\#):not(#\#){min-width:180px}
   .xgomdpo:not(#\#):not(#\#):not(#\#):not(#\#){min-width:1rem}
@@ -1641,6 +1657,8 @@
   .x900493:not(#\#):not(#\#):not(#\#):not(#\#){min-width:48px}
   .x13n9wmd:not(#\#):not(#\#):not(#\#):not(#\#){min-width:4ch}
   .xfvyar9:not(#\#):not(#\#):not(#\#):not(#\#){min-width:60px}
+  .x1ks9poc:not(#\#):not(#\#):not(#\#):not(#\#){min-width:anchor-size(width);min-width:min(anchor-size(width),calc(100% - var(--spacing-4)));min-width:min(anchor-size(width),calc(100% - max(var(--spacing-4),env(safe-area-inset-left,0px),env(safe-area-inset-right,0px))))}
+  .xagy28z:not(#\#):not(#\#):not(#\#):not(#\#){min-width:anchor-size(width);min-width:min(anchor-size(width),calc(100vw - var(--spacing-4) - var(--spacing-4)));min-width:min(anchor-size(width),calc(100vi - max(var(--spacing-4),env(safe-area-inset-left,0px)) - max(var(--spacing-4),env(safe-area-inset-right,0px))))}
   .xrzjruh:not(#\#):not(#\#):not(#\#):not(#\#){min-width:anchor-size(width)}
   .x8wyhu6:not(#\#):not(#\#):not(#\#):not(#\#){min-width:calc(anchor-size(width) + 16px)}
   .x1pshirs:not(#\#):not(#\#):not(#\#):not(#\#){min-width:fit-content}

package/dist/hooks/useAdaptivePresentation.d.ts

@@ -0,0 +1,5 @@
+export type AdaptivePresentation = 'popover' | 'bottom-sheet' | 'adaptive';
+export type ResolvedAdaptivePresentation = Exclude<AdaptivePresentation, 'adaptive'>;
+export declare const COMPACT_TOUCH_PRESENTATION_QUERY = "(max-width: 768px) and (pointer: coarse)";
+export declare function useAdaptivePresentation(presentation: AdaptivePresentation): ResolvedAdaptivePresentation;
+//# sourceMappingURL=useAdaptivePresentation.d.ts.map

package/dist/hooks/useAdaptivePresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAdaptivePresentation.d.ts","sourceRoot":"","sources":["../../src/hooks/useAdaptivePresentation.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,cAAc,GAAG,UAAU,CAAC;AAC3E,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,oBAAoB,EACpB,UAAU,CACX,CAAC;AAKF,eAAO,MAAM,gCAAgC,6CACD,CAAC;AAE7C,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,oBAAoB,GACjC,4BAA4B,CAO9B"}

package/dist/hooks/useAdaptivePresentation.js

@@ -0,0 +1,19 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useAdaptivePresentation.ts
+ * @input Uses the shared SSR-safe media-query hook
+ * @output Resolves popover/bottom-sheet presentation policy
+ * @position Internal overlay policy shared across component families
+ */
+import { useMediaQuery } from "./useMediaQuery.js";
+// Width keeps desktop-class tablets and large touch displays anchored by
+// default. Pointer capability, rather than `hover: none`, avoids excluding
+// touch browsers that also report hover capability.
+export const COMPACT_TOUCH_PRESENTATION_QUERY = '(max-width: 768px) and (pointer: coarse)';
+export function useAdaptivePresentation(presentation) {
+  const isCompactTouch = useMediaQuery(COMPACT_TOUCH_PRESENTATION_QUERY);
+  return presentation === 'adaptive' ? isCompactTouch ? 'bottom-sheet' : 'popover' : presentation;
+}

package/dist/hooks/useFocusReturnVisibility.d.ts

@@ -0,0 +1,7 @@
+export declare function useFocusReturnVisibility(): {
+    isFocusRingSuppressed: boolean;
+    onFocusReturnTargetFocus: () => void;
+    prepareFocusReturn: () => void;
+    resetFocusReturn: () => void;
+};
+//# sourceMappingURL=useFocusReturnVisibility.d.ts.map

package/dist/hooks/useFocusReturnVisibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusReturnVisibility.d.ts","sourceRoot":"","sources":["../../src/hooks/useFocusReturnVisibility.ts"],"names":[],"mappings":"AAiBA,wBAAgB,wBAAwB;;;;;EA2BvC"}

package/dist/hooks/useFocusReturnVisibility.js

@@ -0,0 +1,35 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useFocusReturnVisibility.ts
+ * @input Uses the shared interaction-modality tracker
+ * @output Preserves returned focus while suppressing pointer-only focus rings
+ * @position Internal focus-return policy for adaptive overlays
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { getInteractionModality, trackInteractionModality } from "../utils/interactionModality.js";
+export function useFocusReturnVisibility() {
+  const [isFocusRingSuppressed, setIsFocusRingSuppressed] = useState(false);
+  useEffect(() => {
+    trackInteractionModality();
+  }, []);
+  const prepareFocusReturn = useCallback(() => {
+    setIsFocusRingSuppressed(getInteractionModality() === 'pointer');
+  }, []);
+  const resetFocusReturn = useCallback(() => {
+    setIsFocusRingSuppressed(false);
+  }, []);
+  const onFocusReturnTargetFocus = useCallback(() => {
+    if (getInteractionModality() === 'keyboard') {
+      setIsFocusRingSuppressed(false);
+    }
+  }, []);
+  return {
+    isFocusRingSuppressed,
+    onFocusReturnTargetFocus,
+    prepareFocusReturn,
+    resetFocusReturn
+  };
+}

package/dist/hooks/useFocusTrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.ts"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAgFD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACrE;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9D,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAAC,CAAC,CAAC,CA6NvB"}
+{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.ts"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAgFD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACrE;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9D,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAAC,CAAC,CAAC,CA0OvB"}

package/dist/hooks/useFocusTrap.js

@@ -321,6 +321,18 @@ export function useFocusTrap(options) {
         }
         const first = focusable[0];
         const last = focusable[focusable.length - 1];
+        if (document.activeElement === container) {
+          // Programmatic initial focus can sit on the trap container itself
+          // (for example a dialog panel with no content controls). Move into
+          // the tabbable cycle instead of letting Tab escape to the page.
+          event.preventDefault();
+          if (event.shiftKey) {
+            last.focus();
+          } else {
+            first.focus();
+          }
+          return;
+        }
         if (event.shiftKey) {
           // Shift+Tab: if on first element, wrap to last
           if (document.activeElement === first) {

package/locales/en.json

@@ -415,6 +415,10 @@
     "defaultMessage": "Menu",
     "description": "Screen-reader-only fallback name for a dropdown menu popover. Very generic; consumers usually override. Noun (\"a menu\"), not the imperative."
   },
+  "@astryx.dropdownMenu.back": {
+    "defaultMessage": "Back",
+    "description": "Button label that returns from a nested action list to its parent inside a DropdownMenu bottom sheet. Imperative navigation action."
+  },
   "@astryx.lightbox.close": {
     "defaultMessage": "Close",
     "description": "\"Close\" = shut/dismiss (not \"nearby\"). Screen-reader-only label on the X button that dismisses a Lightbox."
@@ -951,6 +955,22 @@
     "defaultMessage": "Error: {message}",
     "description": "Screen-reader text for a tool call that failed. {message} is the error detail."
   },
+  "@astryx.chatToolCalls.status.pending": {
+    "defaultMessage": "Pending",
+    "description": "Screen-reader-only status label for a tool call that is waiting to begin."
+  },
+  "@astryx.chatToolCalls.status.running": {
+    "defaultMessage": "Running",
+    "description": "Screen-reader-only status label for a tool call that is currently running."
+  },
+  "@astryx.chatToolCalls.status.complete": {
+    "defaultMessage": "Complete",
+    "description": "Screen-reader-only status label for a tool call that completed successfully."
+  },
+  "@astryx.chatToolCalls.status.error": {
+    "defaultMessage": "Failed",
+    "description": "Screen-reader-only status label for a failed tool call when no error detail is supplied."
+  },
   "@astryx.chatToolCalls.groupLabel": {
     "defaultMessage": "{count} tool calls",
     "description": "Summary label shown in the group header when multiple tool calls are expanded. {count} is the number of calls."

package/locales/pseudo.json

@@ -311,6 +311,9 @@
   "@astryx.dropdownMenu.label": {
     "defaultMessage": "⟦Ṁéñú⟧"
   },
+  "@astryx.dropdownMenu.back": {
+    "defaultMessage": "⟦Ɓàçķ⟧"
+  },
   "@astryx.lightbox.close": {
     "defaultMessage": "⟦Çłóšé⟧"
   },
@@ -713,6 +716,18 @@
   "@astryx.chatToolCalls.error": {
     "defaultMessage": "⟦Éřřóř: {message}⟧"
   },
+  "@astryx.chatToolCalls.status.pending": {
+    "defaultMessage": "⟦Þéñðíñĝ⟧"
+  },
+  "@astryx.chatToolCalls.status.running": {
+    "defaultMessage": "⟦Řúññíñĝ⟧"
+  },
+  "@astryx.chatToolCalls.status.complete": {
+    "defaultMessage": "⟦Çóɱþłéţé⟧"
+  },
+  "@astryx.chatToolCalls.status.error": {
+    "defaultMessage": "⟦Ƒàíłéð⟧"
+  },
   "@astryx.chatToolCalls.groupLabel": {
     "defaultMessage": "⟦{count} ţóół çàłłš⟧"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.5.2-canary.c9c8564",
+  "version": "0.5.2-canary.e4f8e4e",
   "displayName": "Astryx Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",
@@ -661,7 +661,7 @@
     "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@astryxdesign/cli": "0.5.2-canary.c9c8564",
+    "@astryxdesign/cli": "0.5.2-canary.e4f8e4e",
     "@babel/cli": "^8.0.4",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^8.0.1",

package/src/BottomSheet/BottomSheet.doc.mjs

@@ -71,6 +71,12 @@ export const docs = {
       description:
         'For a standalone sheet, called when it requests an open-state change. Automatic calls follow purpose: info dismisses on Escape, scrim click, or swipe; form dismisses on Escape only; required never dismisses implicitly. Omit inside BottomSheetSwitcher.',
     },
+    {
+      name: 'finalFocusRef',
+      type: 'RefObject<HTMLElement | null>',
+      description:
+        'Optional explicit focus-return target for a standalone sheet. Use when the opener can remount or the active element is not a reliable trigger, such as an adaptive presentation switch. Omit inside BottomSheetSwitcher.',
+    },
     {
       name: 'purpose',
       type: "'required' | 'form' | 'info'",