react-native-bottom-sheet-stack 1.9.2 → 1.11.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,8 +1,10 @@
 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;
+    backdrop?: boolean;
     params?: TParams;
 }
 type OpenOptions<T extends BottomSheetPortalId> = Omit<BaseOpenOptions<BottomSheetPortalParams<T>>, 'params'> & (HasParams<T> extends true ? {
@@ -14,6 +16,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,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,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,CAsDhC"}

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

@@ -1,13 +1,19 @@
 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;
         groupId?: string;
         mode?: OpenMode;
         scaleBackground?: boolean;
+        backdrop?: boolean;
     }) => string;
     close: (id: string) => void;
+    closeAll: (options?: CloseAllOptions) => Promise<void>;
     clear: () => void;
     /** @deprecated Use `open` instead */
     openBottomSheet: (content: React.ReactElement, options?: {
@@ -15,6 +21,7 @@ export declare const useBottomSheetManager: () => {
         groupId?: string;
         mode?: OpenMode;
         scaleBackground?: boolean;
+        backdrop?: boolean;
     }) => string;
     /** @deprecated Use `clear` instead */
     clearAll: () => void;

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;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;gBA4BgB,MAAM;yBAIG,eAAe;;IAezC,qCAAqC;+BAtD5B,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;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;IAiDD,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,6 +1,6 @@
 {
   "name": "react-native-bottom-sheet-stack",
-  "version": "1.9.2",
+  "version": "1.11.0",
   "description": "Bottom Sheet Stack Manager",
   "source": "./src/index.tsx",
   "main": "lib/commonjs/index.js",

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

@@ -7,12 +7,14 @@ import { PortalHost } from 'react-native-teleport';
 import { cleanupAnimatedIndex, getAnimatedIndex } from './animatedRegistry';
 import { BottomSheetContext } from './BottomSheet.context';
 import {
+  useSheetBackdrop,
   useSheetContent,
   useSheetKeepMounted,
   useSheetPortalSession,
   useSheetUsePortal,
 } from './bottomSheet.store';
 import { BottomSheetBackdrop } from './BottomSheetBackdrop';
+import { removeOnBeforeClose } from './onBeforeCloseRegistry';
 import { cleanupSheetRef } from './refsMap';
 import { useSheetScaleAnimatedStyle } from './useScaleAnimation';
 
@@ -31,6 +33,7 @@ export const QueueItem = memo(function QueueItem({
   const usePortal = useSheetUsePortal(id);
   const keepMounted = useSheetKeepMounted(id);
   const portalSession = useSheetPortalSession(id);
+  const backdrop = useSheetBackdrop(id);
 
   const { width, height } = useSafeAreaFrame();
 
@@ -40,6 +43,7 @@ export const QueueItem = memo(function QueueItem({
     return () => {
       cleanupSheetRef(id);
       cleanupAnimatedIndex(id);
+      removeOnBeforeClose(id);
     };
   }, [id, keepMounted]);
 
@@ -54,7 +58,7 @@ export const QueueItem = memo(function QueueItem({
 
   return (
     <>
-      {isActive && (
+      {isActive && backdrop !== false && (
         <View
           style={[StyleSheet.absoluteFillObject, { zIndex: backdropZIndex }]}
           pointerEvents="box-none"

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

@@ -1,6 +1,7 @@
 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';
@@ -35,6 +36,7 @@ export const ActionsSheetAdapter = React.forwardRef<
   const { id } = useBottomSheetContext();
   const ref = useAdapterRef(forwardedRef);
   const animatedIndex = useAnimatedIndex();
+  const preventDismiss = useSheetPreventDismiss(id);
 
   const actionSheetRef = useRef<any>(null);
 
@@ -63,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

@@ -7,6 +7,7 @@ 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';
@@ -39,6 +40,7 @@ export const GorhomSheetAdapter = React.forwardRef<
     const ref = useAdapterRef(forwardedRef);
     const contextAnimatedIndex = useAnimatedIndex();
     const defaultIndex = useBottomSheetDefaultIndex();
+    const preventDismiss = useSheetPreventDismiss(id);
 
     const gorhomRef = useRef<BottomSheetMethods | null>(null);
 
@@ -110,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/react-native-modal/ReactNativeModalAdapter.tsx

@@ -1,6 +1,7 @@
 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';
@@ -34,6 +35,7 @@ export const ReactNativeModalAdapter = React.forwardRef<
   const { id } = useBottomSheetContext();
   const ref = useAdapterRef(forwardedRef);
   const animatedIndex = useAnimatedIndex();
+  const preventDismiss = useSheetPreventDismiss(id);
   const [isVisible, setIsVisible] = useState(false);
 
   const { handleDismiss, handleOpened, handleClosed } =
@@ -57,7 +59,7 @@ export const ReactNativeModalAdapter = React.forwardRef<
   return (
     <RNModal
       // Adapter defaults (overridable via spread)
-      swipeDirection="down"
+      swipeDirection={preventDismiss ? undefined : 'down'}
       useNativeDriver
       hideModalContentWhileAnimating
       {...modalProps}
@@ -71,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

@@ -20,14 +20,21 @@ export type {
 } 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,
@@ -41,6 +48,7 @@ export {
   useBottomSheetStatus,
   type UseBottomSheetStatusReturn,
 } from './useBottomSheetStatus';
+export { useOnBeforeClose } from './useOnBeforeClose';
 
 // Types
 export type { ScaleConfig, ScaleAnimationConfig } from './useScaleAnimation';
@@ -57,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 {
@@ -64,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();
+}

package/src/store/hooks.ts

@@ -20,8 +20,17 @@ export const useSheetUsePortal = (id: string) =>
 
 export const useSheetKeepMounted = (id: string) =>
   useBottomSheetStore((state) => state.sheetsById[id]?.keepMounted, shallow);
+
+export const useSheetBackdrop = (id: string) =>
+  useBottomSheetStore((state) => state.sheetsById[id]?.backdrop, shallow);
+
 export const useSheetPortalSession = (id: string) =>
   useBottomSheetStore((state) => state.sheetsById[id]?.portalSession, shallow);
+export const useSheetPreventDismiss = (id: string) =>
+  useBottomSheetStore(
+    (state) => state.sheetsById[id]?.preventDismiss ?? false,
+    shallow
+  );
 
 export const useSheetExists = (id: string) =>
   useBottomSheetStore((state) => !!state.sheetsById[id], shallow);
@@ -70,6 +79,9 @@ export const useUpdateParams = () =>
 export const useClearGroup = () =>
   useBottomSheetStore((state) => state.clearGroup);
 
+export const useSetPreventDismiss = () =>
+  useBottomSheetStore((state) => state.setPreventDismiss);
+
 export const useMount = () => useBottomSheetStore((state) => state.mount);
 
 export const useUnmount = () => useBottomSheetStore((state) => state.unmount);

package/src/store/store.ts

@@ -54,6 +54,7 @@ export const useBottomSheetStore = create(
               status: 'opening',
               scaleBackground:
                 sheet.scaleBackground ?? existingSheet.scaleBackground,
+              backdrop: sheet.backdrop ?? existingSheet.backdrop,
               params: sheet.params ?? existingSheet.params,
               portalSession: existingSheet.keepMounted
                 ? existingSheet.portalSession
@@ -130,6 +131,16 @@ export const useBottomSheetStore = create(
         return { sheetsById: updateSheet(state.sheetsById, id, { params }) };
       }),
 
+    setPreventDismiss: (id, prevent) =>
+      set((state) => {
+        if (!state.sheetsById[id]) return state;
+        return {
+          sheetsById: updateSheet(state.sheetsById, id, {
+            preventDismiss: prevent,
+          }),
+        };
+      }),
+
     clearGroup: (groupId) =>
       set((state) => {
         const idsToRemove = new Set(

package/src/store/types.ts

@@ -9,6 +9,7 @@ export interface BottomSheetState {
   content?: ReactNode;
   status: BottomSheetStatus;
   scaleBackground?: boolean;
+  backdrop?: boolean;
   usePortal?: boolean;
   params?: Record<string, unknown>;
   keepMounted?: boolean;
@@ -18,6 +19,13 @@ export interface BottomSheetState {
    * react-native-teleport connection issues after replace flows.
    */
   portalSession?: number;
+  /**
+   * When true, the adapter should block user-initiated dismiss gestures
+   * (swipe down, backdrop tap). Set by `useOnBeforeClose` to ensure the
+   * interceptor runs before closing. Programmatic close via `forceClose()`
+   * bypasses this.
+   */
+  preventDismiss?: boolean;
 }
 
 export type TriggerState = Omit<BottomSheetState, 'status'>;
@@ -33,6 +41,7 @@ export interface BottomSheetStoreActions {
   startClosing(id: string): void;
   finishClosing(id: string): void;
   updateParams(id: string, params: Record<string, unknown> | undefined): void;
+  setPreventDismiss(id: string, prevent: boolean): void;
   clearGroup(groupId: string): void;
   clearAll(): void;
   mount(sheet: Omit<BottomSheetState, 'status'>): void;