@astryxdesign/core 0.7.4 → 0.7.5-canary.0418c47

package/dist/BottomSheet/BottomSheetSwitcher.js

@@ -4,7 +4,7 @@
 
 /**
  * @file BottomSheetSwitcher.tsx
- * @input Uses React context, StyleX, shared layer dismissal, BottomSheetSwitcherContext
+ * @input Uses React context, StyleX, shared layer dismissal, the modal outlet registry, the private bottom-sheet stack, BottomSheetSwitcherContext, BottomSheetHostContext
  * @output Exports BottomSheetSwitcher and BottomSheetSwitcherProps
  * @position Core switcher for mutually exclusive BottomSheet flows
  *
@@ -15,11 +15,13 @@
  * down at the same time until their top edges align; otherwise it stays
  * stationary. The previous sheet fades only after both motions complete.
  *
- * Every child sheet owns a native `<dialog>`, exactly like a standalone
- * sheet: a scrim flow presents each sheet with showModal(), a no-scrim flow
- * with show(). The browser then does what a modal dialog does -- the page is
- * inert, focus stays in the top-layer dialog, Escape and the platform close
- * arrive as `cancel`. The switcher is the coordinator: it decides which
+ * Every child sheet owns a native `<dialog>`: a scrim flow presents each
+ * sheet with showModal(), as a standalone modal sheet does, and a no-scrim
+ * flow with show() inside the flow wrapper (a standalone no-scrim sheet is a
+ * manual popover in the top layer instead; this deprecated path keeps its
+ * released hosting). For a modal flow the browser then does what a modal
+ * dialog does -- the page is inert, focus stays in the top-layer dialog,
+ * Escape and the platform close arrive as `cancel`. The switcher is the coordinator: it decides which
  * sheet dialog is presented, retained, or hidden, keeps one scrim painted
  * across a handoff (the retained sheet's backdrop until it fades, then the
  * new sheet's, swapped without a fade), holds the flow's one page scroll
@@ -43,8 +45,26 @@
  * Every other dialog prop and handler, `onCancel` included, applies to every
  * sheet dialog; the browser raises `cancel` on the dialog it presents.
  *
+ * A scrim flow is one level of the private bottom-sheet stack
+ * (bottomSheetStack.ts) while it is visible: it stacks over, or under, other
+ * modal sheets in open order, recedes as a whole when covered, and switching
+ * its step in place never changes its position. The level is realized by the
+ * active step's dialog; on a handoff the registry is told the dialog changed
+ * so the sheets above the flow stay above its new dialog. A flow stacked
+ * above another sheet keeps every step backdrop clear; a flow beneath owns
+ * the stack's one scrim and hands it between its own steps as it always did.
+ * A switcher step is never paired in a replace: the flow replaces its own
+ * steps. A flow rendered in another sheet's content leaves and returns with
+ * that sheet, like a standalone sheet, without its state being written. A
+ * modal flow's host dialog is a toast outlet like a standalone scrim sheet's
+ * (Layer/modalOutlet.ts), following the handoff. The switcher is deprecated
+ * in favour of standalone step sheets.
+ *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/BottomSheet/BottomSheet.tsx
+ * - /packages/core/src/BottomSheet/bottomSheetStack.ts
+ * - /packages/core/src/BottomSheet/BottomSheetHostContext.ts
+ * - /packages/core/src/BottomSheet/BottomSheetStacking.test.tsx
  * - /packages/core/src/BottomSheet/BottomSheetSwitcherContext.ts
  * - /packages/core/src/BottomSheet/BottomSheetSwitcher.doc.mjs
  * - /packages/core/src/BottomSheet/BottomSheetSwitcher.spec.md
@@ -53,14 +73,17 @@
  * - /apps/storybook/stories/BottomSheetSwitcher.stories.tsx
  * - /packages/cli/assets/templates/blocks/components/BottomSheet/BottomSheetSwitcherShowcase.tsx
  */
-import { useCallback, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
 import * as stylex from '@stylexjs/stylex';
-import { useScrollLock } from "../hooks/index.js";
+import { useScrollLock } from "../hooks/useScrollLock.js";
 import { useFocusTrapEscapeCompatibilitySignal } from "../hooks/useFocusTrap.js";
 import { dispatchLayerEscapeKeyDown } from "../Layer/layerStack.js";
 import { useLayerDismissal } from "../Layer/useLayerDismissal.js";
 import { composeEventHandlers } from "../utils/index.js";
 import { mergeRefs } from "../utils/mergeRefs.js";
+import { useModalOutlet } from "../Layer/modalOutlet.js";
+import { BottomSheetHostContext } from "./BottomSheetHostContext.js";
+import { BOTTOM_SHEET_STACK_DEFAULT_VIEW, cancelScrimWrite, closeDialogKeepingFocus, focusSheetPanel, getBottomSheetBeneath, isClosingTogether, notifyBottomSheetHostChanged, presentStepModally, presentWithClearScrim, registerBottomSheet, reportClosedTogether, sealBottomSheetBatch, setBottomSheetOpen, writeScrimOpacity } from "./bottomSheetStack.js";
 import { BottomSheetSwitcherContext } from "./BottomSheetSwitcherContext.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const IDLE_TRANSITION = {
@@ -135,23 +158,44 @@ function takeOverScrim(dialog, opacity) {
   }
   dialog.style.removeProperty('--_sheet-scrim-duration');
 }
+
+/**
+ * @deprecated Write each step as its own `BottomSheet` with `isOpen`, driven
+ * by one state value that names the open step; closing the top sheet and
+ * opening the next in the same update, from inside the open step, runs the
+ * same replace handoff (see BottomSheet, "Replacing a sheet"). Keeps working until a future minor
+ * release removes it: on its own as released (plus two fixes: a toast raised
+ * from a step now renders above the flow and can be pressed, and reduced motion
+ * follows design:reduced-motion), as one stack level when stacked.
+ */
+
 /**
  * Coordinates a set of BottomSheets so zero or one is active at a time, each
  * in its own native dialog. During a handoff the previous panel stays visible
  * and inert beneath the entering panel, then fades after motion completes.
  *
- * @example
+ * @deprecated Write each step as its own `BottomSheet` with `isOpen`, driven
+ * by one state value that names the open step:
+ *
  * ```
- * <BottomSheetSwitcher
- *   activeSheet={activeSheet}
- *   onActiveSheetChange={setActiveSheet}>
- *   <BottomSheet sheetId="details" label="Details">…</BottomSheet>
- *   <BottomSheet sheetId="confirm" label="Confirm">…</BottomSheet>
- * </BottomSheetSwitcher>
+ * const [step, setStep] = useState(null);
+ * const close = own => isOpen => !isOpen && setStep(c => (c === own ? null : c));
+ * <BottomSheet isOpen={step === 'details'} onOpenChange={close('details')} label="Details">…</BottomSheet>
+ * <BottomSheet isOpen={step === 'confirm'} onOpenChange={close('confirm')} label="Confirm">…</BottomSheet>
  * ```
+ *
+ * Closing the top sheet and opening the next in the same update, from a
+ * control inside the open step, runs the same replace handoff, with no
+ * `sheetId` and no switcher, for modal and `hasScrim={false}` flows alike; a
+ * step changed from outside the flow's sheets closes and opens with the
+ * sheets' own motion. The switcher keeps working until a future
+ * minor release removes it: on its own as released (plus two fixes: a toast
+ * raised from a step now renders above the flow and can be pressed, and reduced
+ * motion follows design:reduced-motion), and as one level of the stack when
+ * stacked with other sheets.
  */
 export function BottomSheetSwitcher({
-  activeSheet,
+  activeSheet: activeSheetProp,
   onActiveSheetChange,
   hasScrim = true,
   children,
@@ -164,6 +208,14 @@ export function BottomSheetSwitcher({
   xstyle,
   ...restDialogProps
 }) {
+  // A flow rendered in another sheet's content is part of that sheet, as a
+  // standalone sheet is: it is presented only while its host is open, leaves
+  // with it, and comes back with it if its own `activeSheet` still names a
+  // step (see BottomSheetHostContext). The consumer's state is never written
+  // for it; with the host closed the flow simply reads as closed.
+  const host = use(BottomSheetHostContext);
+  const isHostOpen = host?.isOpen ?? true;
+  const activeSheet = isHostOpen ? activeSheetProp : null;
   // Every sheet host applies the switcher's dialog surface to its own dialog.
   const dialogProps = useShallowStable({
     ...restDialogProps,
@@ -172,6 +224,7 @@ export function BottomSheetSwitcher({
     xstyle
   });
   const hostDialogRef = useRef(null);
+  const flowRef = useRef(null);
   const sheetDialogsRef = useRef(new Map());
   // Sheet ids in the order their dialogs mounted (tree order on first mount).
   // State, not a ref: the resting host below is rendered -- it carries the
@@ -190,6 +243,23 @@ export function BottomSheetSwitcher({
   const committedActiveSheetRef = useRef(activeSheet);
   const scrimOpacityRef = useRef(1);
   const scrimOwnerRef = useRef(null);
+  // The flow's place in the stack of presented modal sheets; default until
+  // the stack reports, in the commit that presents the flow. The whole flow
+  // is one level, keyed once for its lifetime, so a handoff keeps its rank.
+  const stackKeyRef = useRef({});
+  const [stackView, setStackView] = useState(BOTTOM_SHEET_STACK_DEFAULT_VIEW);
+  const stackViewRef = useRef(stackView);
+  stackViewRef.current = stackView;
+  const scrimWriteRef = useRef({
+    frame: null
+  });
+  useEffect(() => () => cancelScrimWrite(scrimWriteRef.current), []);
+  // What the flow's place in the stack was when it left the registry: its
+  // depth and the open sheet beneath it. React runs the registration
+  // effect's cleanup before the focus-return effect below in the same
+  // commit, so by then the registry no longer knows the flow; the cleanup
+  // records what the return needs.
+  const leftStackRef = useRef(null);
   const [sheetPurposes, setSheetPurposes] = useState(() => new Map());
   const [unmountedSheetIds, setUnmountedSheetIds] = useState(() => new Set());
   const [transition, setTransition] = useState(IDLE_TRANSITION);
@@ -219,6 +289,13 @@ export function BottomSheetSwitcher({
   // keeps it through a handoff so the entering dialog, presented above it in
   // the top layer, does not dim the previous panel beneath its own backdrop.
   const scrimOwnerSheet = presentedRetainedSheet ?? presentedActiveSheet;
+  // Whether the flow's one scrim is the stack's visible scrim. A flow stacked
+  // above another sheet keeps every step backdrop clear: the sheet beneath
+  // dims the page, and a second dim would double it.
+  const flowOwnsStackScrim = !stackView.isStacked || stackView.ownsScrim;
+  const isFlowOpen = activeSheet != null;
+  const isFlowOpenRef = useRef(isFlowOpen);
+  isFlowOpenRef.current = isFlowOpen;
   const isFlowClosing = isFlowVisible && activeSheet == null;
   const activeSheetPurpose = (activeSheet == null ? null : sheetPurposes.get(activeSheet)) ?? 'info';
   const allowsEscapeDismiss = activeSheetPurpose !== 'required';
@@ -258,7 +335,10 @@ export function BottomSheetSwitcher({
     escapeBehavior: allowsEscapeDismiss ? 'close' : 'block',
     onDismiss: dismissOnEscape,
     getContainer: () => hostDialogRef.current,
-    isPresent: () => hostDialogRef.current?.open ?? false
+    // A covered flow stands down from dismissal while a sheet covers it, so
+    // Escape and the platform close request reach the top sheet; see the
+    // standalone host.
+    isPresent: () => (hostDialogRef.current?.open ?? false) && !stackViewRef.current.isCovered
   });
 
   // Point the consumer ref and the dismissal registration at the host dialog.
@@ -274,7 +354,13 @@ export function BottomSheetSwitcher({
   const attachedRef = useRef(null);
   useLayoutEffect(() => {
     const host = hostSheet == null ? sheetDialogsRef.current.values().next().value ?? null : sheetDialogsRef.current.get(hostSheet) ?? null;
+    const previousHost = hostDialogRef.current;
     hostDialogRef.current = host;
+    if (host != null && host !== previousHost) {
+      // The level's dialog changed on a handoff; the registry puts the
+      // sheets above the flow back above its new dialog.
+      notifyBottomSheetHostChanged(stackKeyRef.current);
+    }
     const attached = attachedRef.current;
     if (attached?.host === host && attached.ref === ref) {
       return;
@@ -297,6 +383,16 @@ export function BottomSheetSwitcher({
     attachedRef.current = null;
   }, []);
 
+  // The flow's host dialog is an outlet for app-global surfaces (toasts)
+  // while the flow is a modal one, as a standalone scrim sheet's dialog is
+  // (`component:BottomSheet` FR13): every open scrim sheet supplies one, the
+  // latest among sheets follows the stack, and a Dialog supplied later stays
+  // above. The host changes on a handoff, so the supply follows `hostSheet`;
+  // the retained step's dialog, inert and fading, is never the outlet. A
+  // closing flow stops supplying at once, as a closing sheet does. Passive:
+  // it runs after the layout effects that present the step dialogs.
+  useModalOutlet(hostDialogRef, isModal && isFlowOpen, stackView.isTop || !stackView.isStacked, 'bottom-sheet', hostSheet);
+
   // Focus return is native per dialog: each showModal() records the focused
   // element and close() focuses it again. That serves a one-sheet flow, but
   // the second sheet of a flow records a control inside the first, which is
@@ -321,18 +417,119 @@ export function BottomSheetSwitcher({
       }
       return;
     }
+    const left = leftStackRef.current;
+    leftStackRef.current = null;
     if (modalFlowRef.current) {
-      // Like the browser's own return on close(), without scrolling: the
-      // page kept its scroll offset under the lock, and an opener scrolled
-      // out of view must not drag the page back to itself.
-      triggerRef.current?.focus({
-        preventScroll: true
-      });
+      const depth = left?.depth ?? stackViewRef.current.depth;
+      if (depth > 0) {
+        // Closed from code beneath open sheets: focus stays in the sheet on
+        // top; the flow's own close must not pull it back to the opener.
+      } else if (left?.closingTogether) {
+        // Closing together with the other sheets of its stack ("Close all"):
+        // the registry returns focus once, after the last dialog has left.
+        reportClosedTogether(stackKeyRef.current);
+      } else {
+        // With a sheet still open beneath the flow, focus returns into that
+        // sheet: to the opener when it is there, else to the sheet's panel.
+        // Otherwise, like the browser's own return on close(), without
+        // scrolling: the page kept its scroll offset under the lock, and an
+        // opener scrolled out of view must not drag the page back to itself.
+        const revealed = left?.revealed ?? getBottomSheetBeneath(stackKeyRef.current);
+        const trigger = triggerRef.current;
+        if (revealed != null && (trigger == null || !revealed.element.contains(trigger))) {
+          revealed.focus();
+        } else {
+          trigger?.focus({
+            preventScroll: true
+          });
+        }
+      }
     }
     triggerRef.current = null;
     modalFlowRef.current = false;
     presentationOrderRef.current.clear();
   }, [hasScrim, isFlowVisible]);
+
+  // A scrim flow is one level of the bottom-sheet stack while it is visible.
+  // The step hosts present their own dialogs; the registry re-presents the
+  // level's dialog only to restore open order, moves focus into the active
+  // panel when the flow lands on top, and reports the flow's view (top,
+  // covered, depth, scrim ownership). Switching the step never
+  // re-registers, so a switch in place keeps the flow's position.
+  useLayoutEffect(() => {
+    if (!isFlowVisible || !hasScrim) {
+      return;
+    }
+    const key = stackKeyRef.current;
+    const unregister = registerBottomSheet({
+      key,
+      getElement: () => hostDialogRef.current,
+      // The flow wrapper contains every step dialog, so it orders the flow
+      // against sheets opened in the same commit whichever step is active.
+      getTreeAnchor: () => flowRef.current,
+      show: () => {
+        const dialog = hostDialogRef.current;
+        if (dialog == null || dialog.open) {
+          return;
+        }
+        const hostId = [...sheetDialogsRef.current].find(([, candidate]) => candidate === dialog)?.[0];
+        if (hostId != null) {
+          onBeforeSheetPresent(hostId);
+        }
+        const ownsFlowScrim = hostId != null && hostId === scrimOwnerRef.current;
+        const view = stackViewRef.current;
+        if (ownsFlowScrim && (!view.isStacked || view.ownsScrim)) {
+          dialog.style.setProperty('--_sheet-scrim-opacity', String(scrimOpacityRef.current));
+          presentStepModally(dialog);
+        } else {
+          presentWithClearScrim(dialog);
+        }
+      },
+      hide: () => closeDialogKeepingFocus(hostDialogRef.current),
+      getReturnTarget: () => triggerRef.current,
+      focus: reason => {
+        const active = committedActiveSheetRef.current;
+        const panel = active == null ? undefined : sheetElementsRef.current.get(active);
+        focusSheetPanel(panel ?? null, reason, true);
+      },
+      onView: view => {
+        const previous = stackViewRef.current;
+        stackViewRef.current = view;
+        setStackView(view);
+        // A change of the stack's scrim owner lands with no fade on the
+        // flow's own owner dialog; see writeScrimOpacity.
+        const owner = scrimOwnerRef.current == null ? null : sheetDialogsRef.current.get(scrimOwnerRef.current) ?? null;
+        if (owner == null) {
+          return;
+        }
+        const ownsNow = !view.isStacked || view.ownsScrim;
+        const ownedBefore = !previous.isStacked || previous.ownsScrim;
+        if (isFlowOpenRef.current && ownsNow !== ownedBefore) {
+          writeScrimOpacity(owner, ownsNow && scrimOpacityRef.current > 0 ? '1' : '0', scrimWriteRef.current);
+        } else if (!isFlowOpenRef.current && view.isScrimTakenOver) {
+          writeScrimOpacity(owner, '0', scrimWriteRef.current);
+        }
+      }
+    }, isFlowOpenRef.current);
+    return () => {
+      // Read before the entry leaves: the focus-return effect runs after.
+      leftStackRef.current = {
+        depth: stackViewRef.current.depth,
+        revealed: getBottomSheetBeneath(key),
+        closingTogether: isClosingTogether(key)
+      };
+      unregister();
+    };
+  }, [hasScrim, isFlowVisible, onBeforeSheetPresent]);
+  useLayoutEffect(() => {
+    if (isFlowVisible && hasScrim) {
+      setBottomSheetOpen(stackKeyRef.current, isFlowOpen);
+    }
+  }, [hasScrim, isFlowOpen, isFlowVisible]);
+  // Closes a batch of same-commit opens; see sealBottomSheetBatch.
+  useEffect(() => {
+    sealBottomSheetBatch();
+  });
   const getSheetPhase = useCallback(sheetId => {
     if (sheetId === activeSheet) {
       return sheetId === visibleTransition.enteringSheet ? 'entering' : 'active';
@@ -475,8 +672,11 @@ export function BottomSheetSwitcher({
   // When ownership moves — the retained dialog has faded and closes, or a
   // rapid replacement hides it — the new owner takes the value without a
   // fade, in the same layout pass that closes the old one.
+  // A flow stacked above another sheet keeps every backdrop clear: the
+  // stack's owner beneath dims the page (`flowOwnsStackScrim`).
   const applyScrimOpacity = useCallback(() => {
     const owner = scrimOwnerSheet == null ? null : sheetDialogsRef.current.get(scrimOwnerSheet) ?? null;
+    const value = flowOwnsStackScrim ? scrimOpacityRef.current : 0;
     // A fresh open keeps the backdrop's @starting-style fade; only a hand
     // from one presented dialog to another swaps without one.
     const ownerChanged = scrimOwnerRef.current != null && scrimOwnerRef.current !== scrimOwnerSheet;
@@ -484,15 +684,15 @@ export function BottomSheetSwitcher({
     for (const [sheetId, dialog] of sheetDialogsRef.current) {
       if (dialog === owner) {
         if (ownerChanged && dialog.open) {
-          takeOverScrim(dialog, scrimOpacityRef.current);
+          takeOverScrim(dialog, value);
         } else {
-          dialog.style.setProperty('--_sheet-scrim-opacity', String(scrimOpacityRef.current));
+          dialog.style.setProperty('--_sheet-scrim-opacity', String(value));
         }
       } else if (sheetId !== scrimOwnerSheet) {
         dialog.style.setProperty('--_sheet-scrim-opacity', '0');
       }
     }
-  }, [scrimOwnerSheet]);
+  }, [flowOwnsStackScrim, scrimOwnerSheet]);
   const onSheetScrimOpacityChange = useCallback((sheetId, opacity) => {
     // A pointer captured by the outgoing sheet can keep delivering gesture
     // events after a handoff. Only the currently committed sheet owns the
@@ -561,14 +761,16 @@ export function BottomSheetSwitcher({
     onSheetEnterStart,
     onSheetTransitionComplete,
     onSheetScrimOpacityChange,
+    stackView,
     dialogProps,
     onDialogCancel,
     onDialogClick,
     onDialogKeyDown
-  }), [activeSheet, dialogProps, getSheetAlignmentOffset, getSheetPhase, hasScrim, hostSheet, isCoveredInTopLayer, isFlowClosing, isScrimOwner, onActiveSheetChange, onBeforeSheetPresent, onDialogCancel, onDialogClick, onDialogKeyDown, onSheetEnterStart, onSheetScrimOpacityChange, onSheetTransitionComplete, registerSheetDialog, registerSheetElement, registerSheetPurpose]);
+  }), [activeSheet, dialogProps, getSheetAlignmentOffset, getSheetPhase, hasScrim, hostSheet, isCoveredInTopLayer, isFlowClosing, isScrimOwner, onActiveSheetChange, onBeforeSheetPresent, onDialogCancel, onDialogClick, onDialogKeyDown, onSheetEnterStart, onSheetScrimOpacityChange, onSheetTransitionComplete, registerSheetDialog, registerSheetElement, registerSheetPurpose, stackView]);
   return /*#__PURE__*/_jsx(BottomSheetSwitcherContext, {
     value: contextValue,
     children: /*#__PURE__*/_jsx("div", {
+      ref: flowRef,
       ...{
         0: {
           className: "xjp7ctv"

package/dist/BottomSheet/BottomSheetSwitcherContext.d.ts

@@ -10,8 +10,9 @@
  * down to those sheet hosts.
  */
 import type { KeyboardEvent as ReactKeyboardEvent, MouseEvent as ReactMouseEvent, SyntheticEvent } from 'react';
-import type { BaseProps } from '../BaseProps';
-import type { DialogPurpose } from '../Dialog';
+import type { BaseProps } from '../BaseProps.js';
+import type { DialogPurpose } from '../Dialog/index.js';
+import type { BottomSheetStackView } from './bottomSheetStack.js';
 export type BottomSheetSwitcherPhase = 'entering' | 'active' | 'covered' | 'aligning' | 'fading' | 'exiting' | 'hidden';
 export interface BottomSheetSwitcherTransitionEvent {
     sheetId: string;
@@ -61,6 +62,11 @@ export interface BottomSheetSwitcherContextValue {
     onSheetEnterStart: (sheetId: string) => void;
     onSheetTransitionComplete: (event: BottomSheetSwitcherTransitionEvent) => void;
     onSheetScrimOpacityChange: (sheetId: string, opacity: number) => void;
+    /**
+     * The switcher's place in the stack of presented modal sheets. The whole
+     * switcher is one level; each step's positioner recedes by this view.
+     */
+    stackView: BottomSheetStackView;
     /** Consumer dialog props the switcher forwards to every sheet dialog. */
     dialogProps: BottomSheetSwitcherDialogProps;
     onDialogCancel: (event: SyntheticEvent<HTMLDialogElement>) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"BottomSheetSwitcherContext.d.ts","sourceRoot":"","sources":["../../src/BottomSheet/BottomSheetSwitcherContext.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,aAAa,IAAI,kBAAkB,EACnC,UAAU,IAAI,eAAe,EAC7B,cAAc,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAChC,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvD;AAED;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,SAAS,CAAC,iBAAiB,CAAC,EAC5B,SAAS,GAAG,WAAW,CACxB,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,wBAAwB,CAAC;IAC7D,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD;;;;;OAKG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;IACvB,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7E,mBAAmB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,GAAG,IAAI,KAC7B,IAAI,CAAC;IACV,oBAAoB,EAAE,CACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,GAAG,IAAI,KAC1B,IAAI,CAAC;IACV;;;OAGG;IACH,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,yBAAyB,EAAE,CACzB,KAAK,EAAE,kCAAkC,KACtC,IAAI,CAAC;IACV,yBAAyB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE,yEAAyE;IACzE,WAAW,EAAE,8BAA8B,CAAC;IAC5C,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACnE,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACnE,eAAe,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CACzE;AAED,eAAO,MAAM,0BAA0B,iEACsB,CAAC"}
+{"version":3,"file":"BottomSheetSwitcherContext.d.ts","sourceRoot":"","sources":["../../src/BottomSheet/BottomSheetSwitcherContext.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,aAAa,IAAI,kBAAkB,EACnC,UAAU,IAAI,eAAe,EAC7B,cAAc,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,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,wBAAwB,GAChC,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvD;AAED;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,SAAS,CAAC,iBAAiB,CAAC,EAC5B,SAAS,GAAG,WAAW,CACxB,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,wBAAwB,CAAC;IAC7D,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD;;;;;OAKG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;IACvB,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7E,mBAAmB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,GAAG,IAAI,KAC7B,IAAI,CAAC;IACV,oBAAoB,EAAE,CACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,GAAG,IAAI,KAC1B,IAAI,CAAC;IACV;;;OAGG;IACH,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,yBAAyB,EAAE,CACzB,KAAK,EAAE,kCAAkC,KACtC,IAAI,CAAC;IACV,yBAAyB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE;;;OAGG;IACH,SAAS,EAAE,oBAAoB,CAAC;IAChC,yEAAyE;IACzE,WAAW,EAAE,8BAA8B,CAAC;IAC5C,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACnE,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACnE,eAAe,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CACzE;AAED,eAAO,MAAM,0BAA0B,iEACsB,CAAC"}

package/dist/BottomSheet/bottomSheetEscape.d.ts

@@ -0,0 +1,3 @@
+/** Whether Escape may dismiss the sheet; `purpose="required"` still blocks it. */
+export declare const BottomSheetEscapeContext: import("react").Context<boolean>;
+//# sourceMappingURL=bottomSheetEscape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bottomSheetEscape.d.ts","sourceRoot":"","sources":["../../src/BottomSheet/bottomSheetEscape.ts"],"names":[],"mappings":"AAkBA,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,kCAAsB,CAAC"}

package/dist/BottomSheet/bottomSheetEscape.js

@@ -0,0 +1,20 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file bottomSheetEscape.ts
+ * @input React context
+ * @output BottomSheetEscapeContext: whether Escape (and the platform's close
+ *   request) may dismiss the standalone sheet below it
+ * @position Internal to Core, not exported from the package: Popover's sheet
+ *   presentation passes `hasEscapeDismiss` through it, so its sheet can
+ *   light-dismiss (scrim tap, swipe down) while Escape stays off
+ *   (component:Popover DEC-8). A standalone BottomSheet reads the default
+ *   (true), so its `purpose` rule is unchanged.
+ */
+import { createContext } from 'react';
+
+/** Whether Escape may dismiss the sheet; `purpose="required"` still blocks it. */
+export const BottomSheetEscapeContext = /*#__PURE__*/createContext(true);
+BottomSheetEscapeContext.displayName = 'BottomSheetEscapeContext';