@astryxdesign/core 0.7.5-canary.dbcfc30 → 0.7.5-canary.dcdb356

package/dist/AlertDialog/AlertDialog.js

@@ -28,7 +28,7 @@ import { Button } from "../Button/index.js";
 import { mergeProps } from "../utils/index.js";
 import { themeProps } from "../utils/themeProps.js";
 import { useTranslator } from "../i18n/index.js";
-import { useMediaQuery } from "../hooks/index.js";
+import { useMediaQuery } from "../hooks/useMediaQuery.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const SMALL_SCREEN_QUERY = '(max-width: 640px)';
 const styles = {

package/dist/BottomSheet/BottomSheet.d.ts

@@ -1,6 +1,6 @@
 /**
  * @file BottomSheet.tsx
- * @input Uses React, StyleX, core hooks, shared layer dismissal, the modal outlet registry, the shared interaction modality, named BottomSheetPanel, BottomSheetSwitcherContext
+ * @input Uses React, StyleX, core hooks, shared layer dismissal, the modal outlet registry, the shared interaction modality, named BottomSheetPanel, BottomSheetSwitcherContext, BottomSheetHostContext, the private bottom-sheet stack registry
  * @output Exports BottomSheet component and BottomSheetProps
  * @position Public BottomSheet router plus private standalone/switcher hosts
  *
@@ -19,24 +19,57 @@
  * scroll is locked by the shared useScrollLock hook, as for Dialog: a
  * standalone sheet holds it while presented, a switcher holds one for the
  * whole modal flow. The remaining script is what no single dialog can
- * decide: gating `cancel` by `purpose` and the shared dismissal stack, and,
- * in a switcher, handing one scrim between two dialogs and keeping focus in
- * the active sheet when a retained dialog closes.
+ * decide: gating `cancel` by `purpose` and the shared dismissal stack, the
+ * stack of sheets below, and, in a switcher, handing one scrim between two
+ * dialogs and keeping focus in the active sheet when a retained dialog
+ * closes.
  *
- * While a standalone modal sheet is open, its dialog is the outlet that
- * app-global surfaces (toasts) render into (Layer/modalOutlet.ts).
+ * A standalone sheet also joins the private bottom-sheet stack
+ * (bottomSheetStack.ts) while it is presented. The stack is behaviour, not
+ * API: a modal sheet opened while another modal sheet is open stacks on top
+ * of it, the covered sheet recedes and is blocked, one scrim stays visible,
+ * and the native top layer is kept in open order even when several sheets
+ * open in one commit. A sheet rendered in another sheet's content leaves
+ * with its host and returns with it while its own `isOpen` is still true;
+ * its state is never written for it. A modal sheet on its own never
+ * notices the stack; when every sheet of a stack closes in one update, the
+ * registry returns focus once, to the bottom sheet's target, after the last
+ * dialog has closed.
+ *
+ * A standalone sheet closing in the same update as another standalone sheet
+ * opens, at the same level and from a control inside the closing sheet, is
+ * replaced by it: the two run the handoff a BottomSheetSwitcher runs between
+ * its steps (entering sheet above, retained sheet aligning down then fading,
+ * one steady scrim, focus into the new sheet and back to the flow's opener
+ * on close). The registry pairs them and drives the handoff; this host
+ * renders the retained panel state it reports, and reports its panel's
+ * motions back. Non-modal sheets (`hasScrim={false}`) are hosted as manual
+ * popovers so the top layer orders them, with `show()` below the Popover API
+ * floor; they never stack, but they replace each other the same way, and
+ * return focus to their opener on close only while the person is still in
+ * them.
+ *
+ * Every open standalone modal sheet supplies its dialog as an outlet for
+ * app-global surfaces (toasts) (Layer/modalOutlet.ts); the latest outlet,
+ * the one they render into, follows the sheet stack's order, so toasts land
+ * in the top sheet and return to the sheet beneath when it closes.
  *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/BottomSheet/BottomSheetPanel.tsx
  * - /packages/core/src/BottomSheet/BottomSheetEdgeTint.tsx
+ * - /packages/core/src/BottomSheet/BottomSheetHostContext.ts
+ * - /packages/core/src/BottomSheet/bottomSheetStack.ts
  * - /packages/core/src/BottomSheet/BottomSheet.doc.mjs
  * - /packages/core/src/BottomSheet/BottomSheet.test.tsx
+ * - /packages/core/src/BottomSheet/BottomSheetStacking.test.tsx
  * - /packages/core/src/BottomSheet/BottomSheetSwitcher.tsx
  * - /packages/core/src/BottomSheet/BottomSheetSwitcher.test.tsx
  * - /packages/core/src/Layer/layerDismissalFamilies.test.tsx
  * - /packages/core/src/Layer/layerDismissalInvariants.test.tsx
  * - /packages/core/src/Toast/ToastViewport.modalHost.test.tsx
  * - /apps/storybook/stories/BottomSheet.stories.tsx
+ * - /apps/storybook/stories/BottomSheetStacking.stories.tsx
+ * - /apps/storybook/stories/BottomSheetReplace.stories.tsx
  * - /packages/cli/assets/templates/blocks/components/BottomSheet/BottomSheetShowcase.tsx
  */
 import { type RefObject, type ReactNode } from 'react';
@@ -86,11 +119,22 @@ interface StandaloneBottomSheetProps extends BottomSheetSharedProps {
     isOpen: boolean;
     onOpenChange: (isOpen: boolean) => void;
     hasScrim?: boolean;
-    /** Element that receives focus after the sheet closes. */
+    /**
+     * Element that receives focus after the sheet closes. For a sheet on its
+     * own, or the last sheet of a stack, it is always focused, wherever focus
+     * was. When the sheet closes with a modal sheet still open beneath it,
+     * focus returns into that sheet instead (to this element if it is inside
+     * it, else the revealed sheet's panel), because the page is still inert.
+     */
     finalFocusRef?: RefObject<HTMLElement | null>;
     sheetId?: never;
 }
 interface SwitcherBottomSheetProps extends BottomSheetSharedProps {
+    /**
+     * @deprecated `BottomSheetSwitcher` is deprecated; give each step its own
+     * standalone sheet with `isOpen` instead. Keeps working until a future
+     * minor release removes the switcher.
+     */
     sheetId: string;
     isOpen?: never;
     onOpenChange?: never;

package/dist/BottomSheet/BottomSheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BottomSheet.d.ts","sourceRoot":"","sources":["../../src/BottomSheet/BottomSheet.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAqBhD,YAAY,EAAC,iBAAiB,EAAE,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAC,iBAAiB,EAAE,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAqGhF,UAAU,sBAAuB,SAAQ,SAAS,CAAC,cAAc,CAAC;IAChE,qDAAqD;IACrD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,wGAAwG;IACxG,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAEjD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,UAAU,0BAA2B,SAAQ,sBAAsB;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,UAAU,wBAAyB,SAAQ,sBAAsB;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAC1B,0BAA0B,GAAG,wBAAwB,CAAC;AAolBxD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BA6BlD;yBA7Be,WAAW"}
+{"version":3,"file":"BottomSheet.d.ts","sourceRoot":"","sources":["../../src/BottomSheet/BottomSheet.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AAEH,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAsDhD,YAAY,EAAC,iBAAiB,EAAE,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAC,iBAAiB,EAAE,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAsJhF,UAAU,sBAAuB,SAAQ,SAAS,CAAC,cAAc,CAAC;IAChE,qDAAqD;IACrD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,wGAAwG;IACxG,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAEjD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,UAAU,0BAA2B,SAAQ,sBAAsB;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,UAAU,wBAAyB,SAAQ,sBAAsB;IAC/D;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAC1B,0BAA0B,GAAG,wBAAwB,CAAC;AAm0BxD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BA6BlD;yBA7Be,WAAW"}