react-native-bottom-sheet-stack 1.9.1 → 1.10.0

package/lib/typescript/src/useBottomSheetContext.d.ts

@@ -3,6 +3,11 @@ export interface UseBottomSheetContextReturn<TParams> {
     id: string;
     params: TParams;
     close: () => void;
+    /**
+     * Close the sheet, bypassing any onBeforeClose interceptor.
+     * Useful for force-closing from within onBeforeClose confirmation flows.
+     */
+    forceClose: () => void;
     /** @deprecated Use `close` instead */
     closeBottomSheet: () => void;
 }

package/lib/typescript/src/useBottomSheetContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBottomSheetContext.d.ts","sourceRoot":"","sources":["../../../src/useBottomSheetContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,2BAA2B,CAAC,OAAO;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAC;AAC9E,2DAA2D;AAC3D,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,mBAAmB,KAC1B,2BAA2B,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;AAwB7D;;GAEG;AACH,eAAO,MAAM,mBAAmB,8BAAwB,CAAC"}
+{"version":3,"file":"useBottomSheetContext.d.ts","sourceRoot":"","sources":["../../../src/useBottomSheetContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,2BAA2B,CAAC,OAAO;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAC;AAC9E,2DAA2D;AAC3D,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,mBAAmB,KAC1B,2BAA2B,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;AA4B7D;;GAEG;AACH,eAAO,MAAM,mBAAmB,8BAAwB,CAAC"}

package/lib/typescript/src/useBottomSheetControl.d.ts

@@ -1,5 +1,6 @@
 import { type OpenMode } from './bottomSheet.store';
 import type { BottomSheetPortalId, BottomSheetPortalParams, HasParams } from './portal.types';
+import type { CloseAllOptions } from './useBottomSheetManager';
 interface BaseOpenOptions<TParams> {
     mode?: OpenMode;
     scaleBackground?: boolean;
@@ -14,6 +15,7 @@ type OpenFunction<T extends BottomSheetPortalId> = HasParams<T> extends true ? (
 export interface UseBottomSheetControlReturn<T extends BottomSheetPortalId> {
     open: OpenFunction<T>;
     close: () => void;
+    closeAll: (options?: CloseAllOptions) => Promise<void>;
     updateParams: (params: BottomSheetPortalParams<T>) => void;
     resetParams: () => void;
 }

package/lib/typescript/src/useBottomSheetControl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBottomSheetControl.d.ts","sourceRoot":"","sources":["../../../src/useBottomSheetControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACV,MAAM,gBAAgB,CAAC;AAGxB,UAAU,eAAe,CAAC,OAAO;IAC/B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,KAAK,WAAW,CAAC,CAAC,SAAS,mBAAmB,IAAI,IAAI,CACpD,eAAe,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAC3C,QAAQ,CACT,GACC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GACtB;IAAE,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAA;CAAE,GACtC;IAAE,MAAM,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAAC;AAE/C,KAAK,YAAY,CAAC,CAAC,SAAS,mBAAmB,IAC7C,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GACrB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACjC,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEzC,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,mBAAmB;IACxE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,YAAY,EAAE,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3D,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,mBAAmB,EACjE,EAAE,EAAE,CAAC,GACJ,2BAA2B,CAAC,CAAC,CAAC,CAgDhC"}
+{"version":3,"file":"useBottomSheetControl.d.ts","sourceRoot":"","sources":["../../../src/useBottomSheetControl.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,UAAU,eAAe,CAAC,OAAO;IAC/B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,KAAK,WAAW,CAAC,CAAC,SAAS,mBAAmB,IAAI,IAAI,CACpD,eAAe,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAC3C,QAAQ,CACT,GACC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GACtB;IAAE,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAA;CAAE,GACtC;IAAE,MAAM,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAAC;AAE/C,KAAK,YAAY,CAAC,CAAC,SAAS,mBAAmB,IAC7C,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GACrB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACjC,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEzC,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,mBAAmB;IACxE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,YAAY,EAAE,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3D,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,mBAAmB,EACjE,EAAE,EAAE,CAAC,GACJ,2BAA2B,CAAC,CAAC,CAAC,CAqDhC"}

package/lib/typescript/src/useBottomSheetManager.d.ts

@@ -1,5 +1,9 @@
 import React from 'react';
 import { type OpenMode } from './bottomSheet.store';
+export interface CloseAllOptions {
+    /** Delay in ms between each cascading close animation. Default: 100 */
+    stagger?: number;
+}
 export declare const useBottomSheetManager: () => {
     open: (content: React.ReactElement, options?: {
         id?: string;
@@ -8,6 +12,7 @@ export declare const useBottomSheetManager: () => {
         scaleBackground?: boolean;
     }) => string;
     close: (id: string) => void;
+    closeAll: (options?: CloseAllOptions) => Promise<void>;
     clear: () => void;
     /** @deprecated Use `open` instead */
     openBottomSheet: (content: React.ReactElement, options?: {

package/lib/typescript/src/useBottomSheetManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBottomSheetManager.d.ts","sourceRoot":"","sources":["../../../src/useBottomSheetManager.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAK7B,eAAO,MAAM,qBAAqB;oBAQrB,KAAK,CAAC,YAAY,YAClB;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;gBA2BgB,MAAM;;IAavB,qCAAqC;+BA9C5B,KAAK,CAAC,YAAY,YAClB;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IA0CD,sCAAsC;;CAGzC,CAAC"}
+{"version":3,"file":"useBottomSheetManager.d.ts","sourceRoot":"","sources":["../../../src/useBottomSheetManager.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAM5E,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,qBAAqB;oBAOrB,KAAK,CAAC,YAAY,YAClB;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;gBA2BgB,MAAM;yBAIG,eAAe;;IAezC,qCAAqC;+BApD5B,KAAK,CAAC,YAAY,YAClB;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAgDD,sCAAsC;;CAGzC,CAAC"}

package/lib/typescript/src/useOnBeforeClose.d.ts

@@ -0,0 +1,65 @@
+import type { OnBeforeCloseCallback } from './onBeforeCloseRegistry';
+/**
+ * Registers an interceptor that is called before the sheet closes.
+ *
+ * When active, this hook:
+ * 1. Sets `preventDismiss` on the sheet so adapters block user-initiated
+ *    gestures (swipe down, pan-to-close) at the native level.
+ * 2. Intercepts all programmatic close paths (backdrop tap, back button,
+ *    `close()`, `closeAll()`) and calls the callback first.
+ *
+ * The interceptor receives `onConfirm` and `onCancel` callbacks. Call these
+ * when the user makes a decision. This works seamlessly with `Alert.alert`:
+ *
+ * ```tsx
+ * useOnBeforeClose(({ onConfirm, onCancel }) => {
+ *   if (dirty) {
+ *     Alert.alert('Discard changes?', '', [
+ *       { text: 'Cancel', onPress: onCancel },
+ *       { text: 'Discard', onPress: onConfirm },
+ *     ]);
+ *   } else {
+ *     onConfirm(); // Allow close immediately
+ *   }
+ * });
+ * ```
+ *
+ * For backward compatibility, you can still return `boolean` or `Promise<boolean>`:
+ * - Return `false` (or resolve to `false`) to prevent closing
+ * - Return `true` (or resolve to `true`) to allow closing
+ *
+ * Use `forceClose()` from `useBottomSheetContext` to bypass the interceptor entirely.
+ *
+ * Must be used inside a sheet component (within BottomSheetContext).
+ *
+ * @example Callback pattern (recommended)
+ * ```tsx
+ * function MySheet() {
+ *   const [dirty, setDirty] = useState(false);
+ *
+ *   useOnBeforeClose(({ onConfirm, onCancel }) => {
+ *     if (dirty) {
+ *       Alert.alert('Discard changes?', '', [
+ *         { text: 'Cancel', style: 'cancel', onPress: onCancel },
+ *         { text: 'Discard', onPress: onConfirm },
+ *       ]);
+ *     } else {
+ *       onConfirm();
+ *     }
+ *   });
+ * }
+ * ```
+ *
+ * @example Boolean return (backward compatible)
+ * ```tsx
+ * function MySheet() {
+ *   const [dirty, setDirty] = useState(false);
+ *
+ *   useOnBeforeClose(() => {
+ *     return !dirty; // false blocks, true allows
+ *   });
+ * }
+ * ```
+ */
+export declare function useOnBeforeClose(callback: OnBeforeCloseCallback): void;
+//# sourceMappingURL=useOnBeforeClose.d.ts.map

package/lib/typescript/src/useOnBeforeClose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOnBeforeClose.d.ts","sourceRoot":"","sources":["../../../src/useOnBeforeClose.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAqBtE"}

package/package.json

@@ -1,10 +1,28 @@
 {
   "name": "react-native-bottom-sheet-stack",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Bottom Sheet Stack Manager",
   "source": "./src/index.tsx",
   "main": "lib/commonjs/index.js",
   "types": "lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/commonjs/index.js"
+    },
+    "./gorhom": {
+      "types": "./lib/typescript/src/adapters/gorhom-sheet/index.d.ts",
+      "default": "./lib/commonjs/adapters/gorhom-sheet/index.js"
+    },
+    "./react-native-modal": {
+      "types": "./lib/typescript/src/adapters/react-native-modal/index.d.ts",
+      "default": "./lib/commonjs/adapters/react-native-modal/index.js"
+    },
+    "./actions-sheet": {
+      "types": "./lib/typescript/src/adapters/actions-sheet/index.d.ts",
+      "default": "./lib/commonjs/adapters/actions-sheet/index.js"
+    }
+  },
   "files": [
     "src",
     "lib/typescript",

package/src/BottomSheetBackdrop.tsx

@@ -6,7 +6,7 @@ import Animated, {
   useAnimatedStyle,
 } from 'react-native-reanimated';
 import { getAnimatedIndex } from './animatedRegistry';
-import { useStartClosing } from './store';
+import { requestClose } from './bottomSheetCoordinator';
 
 interface BottomSheetBackdropProps {
   sheetId: string;
@@ -14,7 +14,6 @@ interface BottomSheetBackdropProps {
 
 export function BottomSheetBackdrop({ sheetId }: BottomSheetBackdropProps) {
   const animatedIndex = getAnimatedIndex(sheetId);
-  const startClosing = useStartClosing();
 
   if (!animatedIndex) {
     throw new Error('animatedIndex must be defined in BottomSheetBackdrop');
@@ -46,7 +45,7 @@ export function BottomSheetBackdrop({ sheetId }: BottomSheetBackdropProps) {
   return (
     <Pressable
       style={StyleSheet.absoluteFillObject}
-      onPress={() => startClosing(sheetId)}
+      onPress={() => requestClose(sheetId)}
     >
       <Animated.View
         style={[StyleSheet.absoluteFillObject, animatedStyle, styles.backdrop]}

package/src/QueueItem.tsx

@@ -13,6 +13,7 @@ import {
   useSheetUsePortal,
 } from './bottomSheet.store';
 import { BottomSheetBackdrop } from './BottomSheetBackdrop';
+import { removeOnBeforeClose } from './onBeforeCloseRegistry';
 import { cleanupSheetRef } from './refsMap';
 import { useSheetScaleAnimatedStyle } from './useScaleAnimation';
 
@@ -40,6 +41,7 @@ export const QueueItem = memo(function QueueItem({
     return () => {
       cleanupSheetRef(id);
       cleanupAnimatedIndex(id);
+      removeOnBeforeClose(id);
     };
   }, [id, keepMounted]);
 

package/src/adapters/actions-sheet/ActionsSheetAdapter.tsx

@@ -1,17 +1,13 @@
 import React, { useImperativeHandle, useRef } from 'react';
 
 import type { SheetAdapterRef } from '../../adapter.types';
+import { useSheetPreventDismiss } from '../../bottomSheet.store';
 import { createSheetEventHandlers } from '../../bottomSheetCoordinator';
 import { useAdapterRef } from '../../useAdapterRef';
 import { useAnimatedIndex } from '../../useAnimatedIndex';
 import { useBottomSheetContext } from '../../useBottomSheetContext';
 
-let ActionSheet: any;
-try {
-  ActionSheet = require('react-native-actions-sheet').default;
-} catch {
-  // Optional dependency — resolved lazily when the adapter renders.
-}
+const ActionSheet = require('react-native-actions-sheet').default;
 
 /**
  * Adapter for `react-native-actions-sheet` — a zero-dependency action sheet
@@ -37,15 +33,10 @@ export const ActionsSheetAdapter = React.forwardRef<
   SheetAdapterRef,
   ActionsSheetAdapterProps
 >(({ children, ...sheetProps }, forwardedRef) => {
-  if (!ActionSheet) {
-    throw new Error(
-      'ActionsSheetAdapter requires "react-native-actions-sheet". Install it with: yarn add react-native-actions-sheet'
-    );
-  }
-
   const { id } = useBottomSheetContext();
   const ref = useAdapterRef(forwardedRef);
   const animatedIndex = useAnimatedIndex();
+  const preventDismiss = useSheetPreventDismiss(id);
 
   const actionSheetRef = useRef<any>(null);
 
@@ -74,9 +65,9 @@ export const ActionsSheetAdapter = React.forwardRef<
   return (
     <ActionSheet
       // Adapter defaults (overridable via spread)
-      gestureEnabled
-      closeOnTouchBackdrop
-      closeOnPressBack
+      gestureEnabled={!preventDismiss}
+      closeOnTouchBackdrop={!preventDismiss}
+      closeOnPressBack={!preventDismiss}
       keyboardHandlerEnabled
       {...sheetProps}
       // Managed by adapter (not overridable)

package/src/adapters/gorhom-sheet/GorhomSheetAdapter.tsx

@@ -1,9 +1,13 @@
-import type { BottomSheetProps } from '@gorhom/bottom-sheet';
+import BottomSheetOriginal, {
+  useBottomSheetSpringConfigs,
+  type BottomSheetProps,
+} from '@gorhom/bottom-sheet';
 import type { BottomSheetMethods } from '@gorhom/bottom-sheet/lib/typescript/types';
 import React, { useImperativeHandle, useRef } from 'react';
 import { useAnimatedReaction } from 'react-native-reanimated';
 
 import type { SheetAdapterRef } from '../../adapter.types';
+import { useSheetPreventDismiss } from '../../bottomSheet.store';
 import { createSheetEventHandlers } from '../../bottomSheetCoordinator';
 import { useBottomSheetDefaultIndex } from '../../BottomSheetDefaultIndex.context';
 import { useAdapterRef } from '../../useAdapterRef';
@@ -11,16 +15,6 @@ import { useAnimatedIndex } from '../../useAnimatedIndex';
 import { useBackHandler } from '../../useBackHandler';
 import { useBottomSheetContext } from '../../useBottomSheetContext';
 
-let BottomSheetOriginal: any;
-let useBottomSheetSpringConfigs: any;
-try {
-  const gorhom = require('@gorhom/bottom-sheet');
-  BottomSheetOriginal = gorhom.default;
-  useBottomSheetSpringConfigs = gorhom.useBottomSheetSpringConfigs;
-} catch {
-  // Optional dependency — resolved lazily when the adapter renders.
-}
-
 export interface GorhomSheetAdapterProps extends BottomSheetProps {}
 
 const nullBackdrop = () => null;
@@ -42,16 +36,11 @@ export const GorhomSheetAdapter = React.forwardRef<
     },
     forwardedRef
   ) => {
-    if (!BottomSheetOriginal) {
-      throw new Error(
-        'GorhomSheetAdapter requires "@gorhom/bottom-sheet". Install it with: yarn add @gorhom/bottom-sheet react-native-gesture-handler'
-      );
-    }
-
     const { id } = useBottomSheetContext();
     const ref = useAdapterRef(forwardedRef);
     const contextAnimatedIndex = useAnimatedIndex();
     const defaultIndex = useBottomSheetDefaultIndex();
+    const preventDismiss = useSheetPreventDismiss(id);
 
     const gorhomRef = useRef<BottomSheetMethods | null>(null);
 
@@ -123,7 +112,7 @@ export const GorhomSheetAdapter = React.forwardRef<
         onClose={wrappedOnClose}
         onAnimate={wrappedOnAnimate}
         backdropComponent={backdropComponent}
-        enablePanDownToClose={enablePanDownToClose}
+        enablePanDownToClose={preventDismiss ? false : enablePanDownToClose}
       >
         {children}
       </BottomSheetOriginal>

package/src/adapters/gorhom-sheet/index.ts

@@ -2,3 +2,8 @@ export {
   GorhomSheetAdapter,
   type GorhomSheetAdapterProps,
 } from './GorhomSheetAdapter';
+
+/** @deprecated Use `GorhomSheetAdapter` instead. */
+export { GorhomSheetAdapter as BottomSheetManaged } from './GorhomSheetAdapter';
+/** @deprecated Use `GorhomSheetAdapterProps` instead. */
+export { type GorhomSheetAdapterProps as BottomSheetManagedProps } from './GorhomSheetAdapter';

package/src/adapters/react-native-modal/ReactNativeModalAdapter.tsx

@@ -1,17 +1,13 @@
 import React, { useImperativeHandle, useState } from 'react';
 
 import type { SheetAdapterRef } from '../../adapter.types';
+import { useSheetPreventDismiss } from '../../bottomSheet.store';
 import { createSheetEventHandlers } from '../../bottomSheetCoordinator';
 import { useAdapterRef } from '../../useAdapterRef';
 import { useAnimatedIndex } from '../../useAnimatedIndex';
 import { useBottomSheetContext } from '../../useBottomSheetContext';
 
-let RNModal: any;
-try {
-  RNModal = require('react-native-modal').default;
-} catch {
-  // Optional dependency — resolved lazily when the adapter renders.
-}
+const RNModal = require('react-native-modal').default;
 
 /**
  * Adapter for `react-native-modal`.
@@ -36,15 +32,10 @@ export const ReactNativeModalAdapter = React.forwardRef<
   SheetAdapterRef,
   ReactNativeModalAdapterProps
 >(({ children, ...modalProps }, forwardedRef) => {
-  if (!RNModal) {
-    throw new Error(
-      'ReactNativeModalAdapter requires "react-native-modal". Install it with: yarn add react-native-modal'
-    );
-  }
-
   const { id } = useBottomSheetContext();
   const ref = useAdapterRef(forwardedRef);
   const animatedIndex = useAnimatedIndex();
+  const preventDismiss = useSheetPreventDismiss(id);
   const [isVisible, setIsVisible] = useState(false);
 
   const { handleDismiss, handleOpened, handleClosed } =
@@ -68,7 +59,7 @@ export const ReactNativeModalAdapter = React.forwardRef<
   return (
     <RNModal
       // Adapter defaults (overridable via spread)
-      swipeDirection="down"
+      swipeDirection={preventDismiss ? undefined : 'down'}
       useNativeDriver
       hideModalContentWhileAnimating
       {...modalProps}
@@ -82,7 +73,7 @@ export const ReactNativeModalAdapter = React.forwardRef<
       onModalShow={handleOpened}
       onModalHide={handleClosed}
       onBackButtonPress={handleDismiss}
-      onSwipeComplete={handleDismiss}
+      onSwipeComplete={preventDismiss ? undefined : handleDismiss}
     >
       {children}
     </RNModal>

package/src/bottomSheetCoordinator.ts

@@ -1,5 +1,6 @@
 import type { SheetAdapterEvents } from './adapter.types';
 import { useBottomSheetStore } from './bottomSheet.store';
+import { getOnBeforeClose } from './onBeforeCloseRegistry';
 import { getSheetRef } from './refsMap';
 
 /**
@@ -42,6 +43,126 @@ export function initBottomSheetCoordinator(groupId: string) {
   );
 }
 
+/**
+ * Attempts to close a sheet, respecting the onBeforeClose interceptor.
+ *
+ * If an onBeforeClose callback is registered for the sheet and it returns
+ * `false` (or resolves to `false`), the close is cancelled.
+ *
+ * @returns `true` if the close proceeded, `false` if it was intercepted.
+ */
+export async function requestClose(sheetId: string): Promise<boolean> {
+  const state = useBottomSheetStore.getState();
+  const currentStatus = state.sheetsById[sheetId]?.status;
+
+  // Don't run interceptor if sheet is already closing
+  // This prevents duplicate interceptor calls during close animations
+  if (currentStatus === 'closing') {
+    return false;
+  }
+
+  const interceptor = getOnBeforeClose(sheetId);
+
+  if (interceptor) {
+    try {
+      const allowed = await new Promise<boolean>((resolve) => {
+        const result = interceptor({
+          onConfirm: () => resolve(true),
+          onCancel: () => resolve(false),
+        });
+
+        if (result) {
+          if (typeof result === 'boolean') {
+            resolve(result);
+          } else if (
+            result &&
+            typeof result === 'object' &&
+            'then' in result &&
+            typeof result.then === 'function'
+          ) {
+            // It's a Promise
+            result.then(resolve);
+          }
+        }
+      });
+
+      if (!allowed) {
+        return false;
+      }
+    } catch (error) {
+      // If the interceptor throws, cancel the close for safety
+      if (__DEV__) {
+        console.warn(
+          `[BottomSheet] onBeforeClose interceptor threw an error for sheet "${sheetId}". ` +
+            'Close cancelled for safety. Fix the interceptor to avoid this warning.',
+          error
+        );
+      }
+      return false;
+    }
+  }
+
+  if (currentStatus === 'open' || currentStatus === 'opening') {
+    state.startClosing(sheetId);
+  }
+
+  return true;
+}
+
+/**
+ * Default stagger delay between cascading close animations (ms).
+ */
+const DEFAULT_STAGGER_MS = 100;
+
+/**
+ * Closes all sheets in a group from top to bottom with cascading animation.
+ *
+ * Each sheet is closed with a staggered delay so the user sees them
+ * peel off one-by-one (similar to `popToRoot` in React Navigation).
+ *
+ * If a sheet has an `onBeforeClose` interceptor that rejects, the cascade
+ * stops at that sheet — sheets below it remain open.
+ *
+ * @param groupId - The manager group to close sheets in.
+ * @param options.stagger - Delay in ms between each close (default: 100).
+ * @returns A promise that resolves when the cascade finishes (or is stopped).
+ */
+export async function closeAllAnimated(
+  groupId: string,
+  options?: { stagger?: number }
+): Promise<void> {
+  const stagger = options?.stagger ?? DEFAULT_STAGGER_MS;
+
+  const state = useBottomSheetStore.getState();
+  const groupSheetIds = state.stackOrder.filter(
+    (id) => state.sheetsById[id]?.groupId === groupId
+  );
+
+  // Close from top to bottom (reverse order)
+  const reversed = [...groupSheetIds].reverse();
+
+  for (const sheetId of reversed) {
+    const currentState = useBottomSheetStore.getState();
+    const sheet = currentState.sheetsById[sheetId];
+
+    // Skip sheets that are already closing or hidden
+    if (!sheet || sheet.status === 'closing' || sheet.status === 'hidden') {
+      continue;
+    }
+
+    const closed = await requestClose(sheetId);
+
+    if (!closed) {
+      // Interceptor blocked — stop the cascade
+      break;
+    }
+
+    if (stagger > 0 && reversed.indexOf(sheetId) < reversed.length - 1) {
+      await new Promise<void>((resolve) => setTimeout(resolve, stagger));
+    }
+  }
+}
+
 /**
  * Creates event handlers that adapters call to sync UI state back to the store.
  * Direction: Adapter Events → Store
@@ -53,6 +174,13 @@ export function initBottomSheetCoordinator(groupId: string) {
  */
 export function createSheetEventHandlers(sheetId: string): SheetAdapterEvents {
   const handleDismiss = () => {
+    const interceptor = getOnBeforeClose(sheetId);
+
+    if (interceptor) {
+      requestClose(sheetId);
+      return;
+    }
+
     const state = useBottomSheetStore.getState();
     const currentStatus = state.sheetsById[sheetId]?.status;
 

package/src/index.tsx

@@ -2,46 +2,39 @@
 export { BottomSheetManagerProvider } from './BottomSheetManager.provider';
 export { BottomSheetHost } from './BottomSheetHost';
 export { BottomSheetScaleView } from './BottomSheetScaleView';
-export { BottomSheetManaged, type BottomSheetRef } from './BottomSheetManaged';
 export { BottomSheetPortal } from './BottomSheetPortal';
 export { BottomSheetPersistent } from './BottomSheetPersistent';
 
-// Adapters
-export {
-  GorhomSheetAdapter,
-  type GorhomSheetAdapterProps,
-} from './adapters/gorhom-sheet';
+// Adapters (only those with zero 3rd-party deps)
 export {
   CustomModalAdapter,
   type ModalAdapterProps,
 } from './adapters/custom-modal';
-/** @deprecated Use `CustomModalAdapter` instead. */
-export { ModalAdapter } from './adapters/custom-modal';
-export {
-  ReactNativeModalAdapter,
-  type ReactNativeModalAdapterProps,
-} from './adapters/react-native-modal';
-export {
-  ActionsSheetAdapter,
-  type ActionsSheetAdapterProps,
-} from './adapters/actions-sheet';
 
 // Adapter types
 export type {
   SheetAdapterRef,
+  SheetAdapterRef as BottomSheetRef,
   SheetAdapterEvents,
   SheetRef,
 } from './adapter.types';
 
 // Adapter utilities (for custom adapter authors)
-export { createSheetEventHandlers } from './bottomSheetCoordinator';
+export {
+  createSheetEventHandlers,
+  requestClose,
+  closeAllAnimated,
+} from './bottomSheetCoordinator';
 export { useAdapterRef } from './useAdapterRef';
 export { useAnimatedIndex } from './useAnimatedIndex';
 export { useBackHandler } from './useBackHandler';
 export { getAnimatedIndex, setAnimatedIndexValue } from './animatedRegistry';
 
 // Hooks
-export { useBottomSheetManager } from './useBottomSheetManager';
+export {
+  useBottomSheetManager,
+  type CloseAllOptions,
+} from './useBottomSheetManager';
 export {
   useBottomSheetControl,
   type UseBottomSheetControlReturn,
@@ -55,6 +48,7 @@ export {
   useBottomSheetStatus,
   type UseBottomSheetStatusReturn,
 } from './useBottomSheetStatus';
+export { useOnBeforeClose } from './useOnBeforeClose';
 
 // Types
 export type { ScaleConfig, ScaleAnimationConfig } from './useScaleAnimation';
@@ -71,6 +65,10 @@ export type {
 
 export { useBottomSheetStore } from './bottomSheet.store';
 
+// onBeforeClose registry
+export type { OnBeforeCloseCallback } from './onBeforeCloseRegistry';
+export { setOnBeforeClose, removeOnBeforeClose } from './onBeforeCloseRegistry';
+
 // Testing utilities (internal use)
 export { __resetSheetRefs } from './refsMap';
 export {
@@ -78,3 +76,4 @@ export {
   __getAllAnimatedIndexes,
 } from './animatedRegistry';
 export { __resetPortalSessions } from './portalSessionRegistry';
+export { __resetOnBeforeClose } from './onBeforeCloseRegistry';

package/src/onBeforeCloseRegistry.ts

@@ -0,0 +1,44 @@
+/**
+ * Registry for onBeforeClose interceptors.
+ *
+ * Callbacks are keyed by sheet ID. When a sheet is about to close,
+ * the coordinator checks this registry and calls the interceptor.
+ *
+ * The interceptor receives `onConfirm` and `onCancel` callbacks that
+ * should be called when the user makes a decision. Alternatively, it can
+ * return `boolean` or `Promise<boolean>` for backward compatibility.
+ *
+ * If the interceptor returns `false` (or resolves to `false`), or if
+ * `onCancel()` is called, the close is cancelled.
+ */
+export type OnBeforeCloseCallback = (context: {
+  onConfirm: () => void;
+  onCancel: () => void;
+}) => void | boolean | Promise<boolean>;
+
+const onBeforeCloseMap = new Map<string, OnBeforeCloseCallback>();
+
+export function getOnBeforeClose(
+  sheetId: string
+): OnBeforeCloseCallback | undefined {
+  return onBeforeCloseMap.get(sheetId);
+}
+
+export function setOnBeforeClose(
+  sheetId: string,
+  callback: OnBeforeCloseCallback
+): void {
+  onBeforeCloseMap.set(sheetId, callback);
+}
+
+export function removeOnBeforeClose(sheetId: string): void {
+  onBeforeCloseMap.delete(sheetId);
+}
+
+/**
+ * Reset all interceptors. Useful for testing.
+ * @internal
+ */
+export function __resetOnBeforeClose(): void {
+  onBeforeCloseMap.clear();
+}