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

package/src/store/hooks.ts

@@ -22,6 +22,11 @@ export const useSheetKeepMounted = (id: string) =>
   useBottomSheetStore((state) => state.sheetsById[id]?.keepMounted, 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 +75,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

@@ -130,6 +130,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

@@ -18,6 +18,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 +40,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;

package/src/useBottomSheetContext.ts

@@ -1,5 +1,6 @@
 import { useMaybeBottomSheetContext } from './BottomSheet.context';
 import { useSheetParams, useStartClosing } from './bottomSheet.store';
+import { requestClose } from './bottomSheetCoordinator';
 import type {
   BottomSheetPortalId,
   BottomSheetPortalParams,
@@ -9,6 +10,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;
 }
@@ -32,12 +38,16 @@ export function useBottomSheetContext<
     );
   }
 
-  const close = () => startClosing(context.id);
+  const close = () => {
+    requestClose(context.id);
+  };
+  const forceClose = () => startClosing(context.id);
 
   return {
     id: context.id,
     params: params as BottomSheetPortalParams<T>,
     close,
+    forceClose,
     closeBottomSheet: close,
   };
 }

package/src/useBottomSheetControl.ts

@@ -1,19 +1,16 @@
 import React from 'react';
 import type { SheetAdapterRef } from './adapter.types';
 
-import {
-  useOpen,
-  useStartClosing,
-  useUpdateParams,
-  type OpenMode,
-} from './bottomSheet.store';
+import { useOpen, useUpdateParams, type OpenMode } from './bottomSheet.store';
 import { useMaybeBottomSheetManagerContext } from './BottomSheetManager.provider';
+import { closeAllAnimated, requestClose } from './bottomSheetCoordinator';
 import type {
   BottomSheetPortalId,
   BottomSheetPortalParams,
   HasParams,
 } from './portal.types';
 import { getSheetRef, setSheetRef } from './refsMap';
+import type { CloseAllOptions } from './useBottomSheetManager';
 
 interface BaseOpenOptions<TParams> {
   mode?: OpenMode;
@@ -37,6 +34,7 @@ type OpenFunction<T extends BottomSheetPortalId> =
 export interface UseBottomSheetControlReturn<T extends BottomSheetPortalId> {
   open: OpenFunction<T>;
   close: () => void;
+  closeAll: (options?: CloseAllOptions) => Promise<void>;
   updateParams: (params: BottomSheetPortalParams<T>) => void;
   resetParams: () => void;
 }
@@ -47,7 +45,6 @@ export function useBottomSheetControl<T extends BottomSheetPortalId>(
   const bottomSheetManagerContext = useMaybeBottomSheetManagerContext();
 
   const storeOpen = useOpen();
-  const startClosing = useStartClosing();
   const storeUpdateParams = useUpdateParams();
 
   const open = (options?: OpenOptions<T>) => {
@@ -74,7 +71,12 @@ export function useBottomSheetControl<T extends BottomSheetPortalId>(
   };
 
   const close = () => {
-    startClosing(id);
+    requestClose(id);
+  };
+
+  const closeAll = (options?: CloseAllOptions) => {
+    const groupId = bottomSheetManagerContext?.groupId || 'default';
+    return closeAllAnimated(groupId, options);
   };
 
   const updateParams = (params: BottomSheetPortalParams<T>) => {
@@ -88,6 +90,7 @@ export function useBottomSheetControl<T extends BottomSheetPortalId>(
   return {
     open: open as OpenFunction<T>,
     close,
+    closeAll,
     updateParams,
     resetParams,
   };

package/src/useBottomSheetManager.tsx

@@ -1,20 +1,20 @@
 import React from 'react';
 
-import {
-  useOpen,
-  useStartClosing,
-  useClearGroup,
-  type OpenMode,
-} from './bottomSheet.store';
+import { useOpen, useClearGroup, type OpenMode } from './bottomSheet.store';
 import { useMaybeBottomSheetManagerContext } from './BottomSheetManager.provider';
 import type { SheetAdapterRef } from './adapter.types';
+import { closeAllAnimated, requestClose } from './bottomSheetCoordinator';
 import { setSheetRef } from './refsMap';
 
+export interface CloseAllOptions {
+  /** Delay in ms between each cascading close animation. Default: 100 */
+  stagger?: number;
+}
+
 export const useBottomSheetManager = () => {
   const bottomSheetManagerContext = useMaybeBottomSheetManagerContext();
 
   const storeOpen = useOpen();
-  const startClosing = useStartClosing();
   const storeClearGroup = useClearGroup();
 
   const openBottomSheet = (
@@ -52,7 +52,12 @@ export const useBottomSheetManager = () => {
   };
 
   const close = (id: string) => {
-    startClosing(id);
+    requestClose(id);
+  };
+
+  const closeAll = (options?: CloseAllOptions) => {
+    const groupId = bottomSheetManagerContext?.groupId || 'default';
+    return closeAllAnimated(groupId, options);
   };
 
   const clear = () => {
@@ -63,6 +68,7 @@ export const useBottomSheetManager = () => {
   return {
     open: openBottomSheet,
     close,
+    closeAll,
     clear,
     /** @deprecated Use `open` instead */
     openBottomSheet,

package/src/useOnBeforeClose.ts

@@ -0,0 +1,92 @@
+import { useEffect } from 'react';
+
+import { useMaybeBottomSheetContext } from './BottomSheet.context';
+import { useSetPreventDismiss } from './bottomSheet.store';
+import type { OnBeforeCloseCallback } from './onBeforeCloseRegistry';
+import { removeOnBeforeClose, setOnBeforeClose } from './onBeforeCloseRegistry';
+import { useEvent } from './useEvent';
+
+/**
+ * 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 function useOnBeforeClose(callback: OnBeforeCloseCallback): void {
+  const context = useMaybeBottomSheetContext();
+  const setPreventDismiss = useSetPreventDismiss();
+
+  if (!context?.id) {
+    throw new Error(
+      'useOnBeforeClose must be used within a BottomSheet component'
+    );
+  }
+
+  const id = context.id;
+  const stableCallback = useEvent(callback);
+
+  useEffect(() => {
+    setOnBeforeClose(id, stableCallback);
+    setPreventDismiss(id, true);
+    return () => {
+      removeOnBeforeClose(id);
+      setPreventDismiss(id, false);
+    };
+  }, [id, stableCallback, setPreventDismiss]);
+}

package/lib/commonjs/BottomSheetManaged.js

@@ -1,13 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "BottomSheetManaged", {
-  enumerable: true,
-  get: function () {
-    return _gorhomSheet.GorhomSheetAdapter;
-  }
-});
-var _gorhomSheet = require("./adapters/gorhom-sheet");
-//# sourceMappingURL=BottomSheetManaged.js.map

package/lib/commonjs/BottomSheetManaged.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_gorhomSheet","require"],"sourceRoot":"../../src","sources":["BottomSheetManaged.tsx"],"mappings":";;;;;;;;;;;AAQA,IAAAA,YAAA,GAAAC,OAAA","ignoreList":[]}

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

@@ -1,11 +0,0 @@
-/**
- * Backward-compatible re-export of GorhomSheetAdapter.
- *
- * Existing users can continue importing `BottomSheetManaged` and `BottomSheetRef`
- * without any changes. For new code, prefer importing `GorhomSheetAdapter` directly
- * from 'react-native-bottom-sheet-stack/adapters/gorhom' or use the `ModalAdapter`
- * for modal-based sheets.
- */
-export { GorhomSheetAdapter as BottomSheetManaged, type GorhomSheetAdapterProps as BottomSheetManagedProps, } from './adapters/gorhom-sheet';
-export type { SheetAdapterRef as BottomSheetRef } from './adapter.types';
-//# sourceMappingURL=BottomSheetManaged.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"BottomSheetManaged.d.ts","sourceRoot":"","sources":["../../../src/BottomSheetManaged.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,kBAAkB,IAAI,kBAAkB,EACxC,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,eAAe,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/src/BottomSheetManaged.tsx

@@ -1,14 +0,0 @@
-/**
- * Backward-compatible re-export of GorhomSheetAdapter.
- *
- * Existing users can continue importing `BottomSheetManaged` and `BottomSheetRef`
- * without any changes. For new code, prefer importing `GorhomSheetAdapter` directly
- * from 'react-native-bottom-sheet-stack/adapters/gorhom' or use the `ModalAdapter`
- * for modal-based sheets.
- */
-export {
-  GorhomSheetAdapter as BottomSheetManaged,
-  type GorhomSheetAdapterProps as BottomSheetManagedProps,
-} from './adapters/gorhom-sheet';
-
-export type { SheetAdapterRef as BottomSheetRef } from './adapter.types';