react-native-bottom-sheet-stack 1.7.6 → 1.9.0

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

@@ -1,6 +1,10 @@
 import { type SharedValue } from 'react-native-reanimated';
 export declare function ensureAnimatedIndex(sheetId: string): SharedValue<number>;
 export declare function getAnimatedIndex(sheetId: string): SharedValue<number> | undefined;
+/**
+ * Set the animated index value for a sheet.
+ */
+export declare function setAnimatedIndexValue(sheetId: string, value: number): void;
 export declare function cleanupAnimatedIndex(sheetId: string): void;
 /**
  * Reset all animated indexes. Useful for testing.

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

@@ -1 +1 @@
-{"version":3,"file":"animatedRegistry.d.ts","sourceRoot":"","sources":["../../../src/animatedRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AASxE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CASxE;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAGjC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAE1E"}
+{"version":3,"file":"animatedRegistry.d.ts","sourceRoot":"","sources":["../../../src/animatedRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AASxE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CASxE;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAEjC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK1E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAE1E"}

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

@@ -1,11 +1,17 @@
+import type { SheetAdapterEvents } from './adapter.types';
+/**
+ * Subscribes to store changes and calls adapter ref methods.
+ * Direction: Store → Adapter (via SheetAdapterRef)
+ */
 export declare function initBottomSheetCoordinator(groupId: string): () => void;
 /**
- * Creates event handlers for a bottom sheet that sync gorhom events back to the store.
- * Direction: Gorhom Events → Store
+ * Creates event handlers that adapters call to sync UI state back to the store.
+ * Direction: Adapter Events → Store
+ *
+ * Adapters must call:
+ * - `handleDismiss()` when the user initiates dismissal (swipe, backdrop tap, back button)
+ * - `handleOpened()` when the show animation completes
+ * - `handleClosed()` when the hide animation completes
  */
-export declare function createSheetEventHandlers(sheetId: string): {
-    handleAnimate: (_fromIndex: number, toIndex: number) => void;
-    handleChange: (index: number) => void;
-    handleClose: () => void;
-};
+export declare function createSheetEventHandlers(sheetId: string): SheetAdapterEvents;
 //# sourceMappingURL=bottomSheetCoordinator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bottomSheetCoordinator.d.ts","sourceRoot":"","sources":["../../../src/bottomSheetCoordinator.ts"],"names":[],"mappings":"AAGA,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,cA8BzD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM;gCAInB,MAAM,WAAW,MAAM;0BAY7B,MAAM;;EAuBpC"}
+{"version":3,"file":"bottomSheetCoordinator.d.ts","sourceRoot":"","sources":["../../../src/bottomSheetCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,cAkCzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAiC5E"}

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

@@ -4,6 +4,18 @@ export { BottomSheetScaleView } from './BottomSheetScaleView';
 export { BottomSheetManaged, type BottomSheetRef } from './BottomSheetManaged';
 export { BottomSheetPortal } from './BottomSheetPortal';
 export { BottomSheetPersistent } from './BottomSheetPersistent';
+export { GorhomSheetAdapter, type GorhomSheetAdapterProps, } from './adapters/gorhom-sheet';
+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';
+export type { SheetAdapterRef, SheetAdapterEvents, SheetRef, } from './adapter.types';
+export { createSheetEventHandlers } from './bottomSheetCoordinator';
+export { useAdapterRef } from './useAdapterRef';
+export { useAnimatedIndex } from './useAnimatedIndex';
+export { useBackHandler } from './useBackHandler';
+export { getAnimatedIndex, setAnimatedIndexValue } from './animatedRegistry';
 export { useBottomSheetManager } from './useBottomSheetManager';
 export { useBottomSheetControl, type UseBottomSheetControlReturn, } from './useBottomSheetControl';
 export { useBottomSheetContext, useBottomSheetState, type UseBottomSheetContextReturn, } from './useBottomSheetContext';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,oDAAoD;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -1,6 +1,4 @@
-import type { BottomSheetMethods } from '@gorhom/bottom-sheet/lib/typescript/types';
-import type { RefObject } from 'react';
-type SheetRef = RefObject<BottomSheetMethods | null>;
+import type { SheetRef } from './adapter.types';
 export declare function getSheetRef(sheetId: string): SheetRef | undefined;
 export declare function setSheetRef(sheetId: string, ref: SheetRef): void;
 export declare function cleanupSheetRef(sheetId: string): void;
@@ -9,5 +7,4 @@ export declare function cleanupSheetRef(sheetId: string): void;
  * @internal
  */
 export declare function __resetSheetRefs(): void;
-export {};
 //# sourceMappingURL=refsMap.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"refsMap.d.ts","sourceRoot":"","sources":["../../../src/refsMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,KAAK,QAAQ,GAAG,SAAS,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;AAIrD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEjE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAEhE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}
+{"version":3,"file":"refsMap.d.ts","sourceRoot":"","sources":["../../../src/refsMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEjE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAEhE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

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

@@ -0,0 +1,21 @@
+import type { ForwardedRef } from 'react';
+import type { SheetAdapterRef, SheetRef } from './adapter.types';
+/**
+ * Returns the correct ref for a custom adapter.
+ *
+ * Handles the internal ref routing between portal/persistent mode
+ * (where the ref comes from context) and inline mode (where the ref
+ * is forwarded by `useBottomSheetManager`).
+ *
+ * Usage:
+ * ```tsx
+ * const MyAdapter = React.forwardRef<SheetAdapterRef, Props>(
+ *   ({ children }, forwardedRef) => {
+ *     const ref = useAdapterRef(forwardedRef);
+ *     useImperativeHandle(ref, () => ({ expand: ..., close: ... }));
+ *   }
+ * );
+ * ```
+ */
+export declare function useAdapterRef(forwardedRef: ForwardedRef<SheetAdapterRef>): SheetRef | ForwardedRef<SheetAdapterRef>;
+//# sourceMappingURL=useAdapterRef.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdapterRef.d.ts","sourceRoot":"","sources":["../../../src/useAdapterRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGjE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,YAAY,CAAC,eAAe,CAAC,GAC1C,QAAQ,GAAG,YAAY,CAAC,eAAe,CAAC,CAG1C"}

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

@@ -0,0 +1,25 @@
+import type { SharedValue } from 'react-native-reanimated';
+/**
+ * Returns the `animatedIndex` shared value for the current sheet.
+ *
+ * The value drives backdrop opacity and scale animations:
+ * - `-1` = hidden (backdrop transparent)
+ * - `0`  = fully visible (backdrop opaque)
+ *
+ * **Binary strategy** — set to `0` on expand and `-1` on close:
+ * ```ts
+ * const animatedIndex = useAnimatedIndex();
+ * // in expand: animatedIndex.set(0);
+ * // in close:  animatedIndex.set(-1);
+ * ```
+ *
+ * **Continuous strategy** — pass directly to a library that updates it during gestures:
+ * ```ts
+ * const animatedIndex = useAnimatedIndex();
+ * <SomeSheet animatedIndex={animatedIndex} />
+ * ```
+ *
+ * Must be called inside a sheet component (within `BottomSheetContext`).
+ */
+export declare function useAnimatedIndex(): SharedValue<number>;
+//# sourceMappingURL=useAnimatedIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimatedIndex.d.ts","sourceRoot":"","sources":["../../../src/useAnimatedIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAAC,MAAM,CAAC,CAGtD"}

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

@@ -0,0 +1,8 @@
+/**
+ * Manages Android hardware back button for a sheet.
+ *
+ * The listener is only active when the sheet is fully open
+ * AND is the topmost sheet in the stack.
+ */
+export declare function useBackHandler(id: string, onBackPress: () => void): void;
+//# sourceMappingURL=useBackHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBackHandler.d.ts","sourceRoot":"","sources":["../../../src/useBackHandler.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,GAAG,IAAI,CAoBxE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-bottom-sheet-stack",
-  "version": "1.7.6",
+  "version": "1.9.0",
   "description": "Bottom Sheet Stack Manager",
   "source": "./src/index.tsx",
   "main": "lib/commonjs/index.js",
@@ -73,12 +73,29 @@
     "@gorhom/bottom-sheet": ">=5.0.0",
     "react": "*",
     "react-native": "*",
+    "react-native-actions-sheet": ">=0.9.0",
     "react-native-gesture-handler": ">=2.0.0",
+    "react-native-modal": ">=11.0.0",
     "react-native-reanimated": ">=3.0.0",
     "react-native-safe-area-context": ">=5.0.0",
     "react-native-teleport": ">=0.5.0",
+    "react-native-worklets": ">=0.7.0",
     "zustand": ">=5.0.0"
   },
+  "peerDependenciesMeta": {
+    "@gorhom/bottom-sheet": {
+      "optional": true
+    },
+    "react-native-actions-sheet": {
+      "optional": true
+    },
+    "react-native-gesture-handler": {
+      "optional": true
+    },
+    "react-native-modal": {
+      "optional": true
+    }
+  },
   "workspaces": [
     "example"
   ],
@@ -109,7 +126,21 @@
     "plugins": {
       "@release-it/conventional-changelog": {
         "preset": {
-          "name": "angular"
+          "name": "conventionalcommits",
+          "types": [
+            {
+              "type": "feat",
+              "section": "Features"
+            },
+            {
+              "type": "fix",
+              "section": "Bug Fixes"
+            },
+            {
+              "type": "perf",
+              "section": "Performance"
+            }
+          ]
         }
       }
     }

package/src/BottomSheetManaged.tsx

@@ -1,106 +1,14 @@
-import BottomSheetOriginal, {
-  useBottomSheetSpringConfigs,
-  type BottomSheetProps,
-} from '@gorhom/bottom-sheet';
-import { type BottomSheetMethods } from '@gorhom/bottom-sheet/lib/typescript/types';
-import React from 'react';
-
-import { useAnimatedReaction } from 'react-native-reanimated';
-import { getAnimatedIndex } from './animatedRegistry';
-import { createSheetEventHandlers } from './bottomSheetCoordinator';
-import { useBottomSheetDefaultIndex } from './BottomSheetDefaultIndex.context';
-import { useBottomSheetRefContext } from './BottomSheetRef.context';
-import { useBottomSheetContext } from './useBottomSheetContext';
-
-export interface BottomSheetRef extends BottomSheetMethods {}
-
-interface BottomSheetManagedProps extends BottomSheetProps {}
-
-const nullBackdrop = () => null;
-
-export const BottomSheetManaged = React.forwardRef<
-  BottomSheetRef,
-  BottomSheetManagedProps
->(
-  (
-    {
-      children,
-      onAnimate,
-      onChange,
-      onClose,
-      enablePanDownToClose = true,
-      backdropComponent = nullBackdrop,
-      animatedIndex: externalAnimatedIndex,
-      ...props
-    },
-    forwardedRef
-  ) => {
-    const { id } = useBottomSheetContext();
-    const contextRef = useBottomSheetRefContext();
-    const ref = contextRef ?? forwardedRef;
-
-    const defaultIndex = useBottomSheetDefaultIndex();
-    const contextAnimatedIndex = getAnimatedIndex(id);
-
-    if (!contextAnimatedIndex) {
-      throw new Error('animatedIndex must be defined in BottomSheetManaged');
-    }
-
-    useAnimatedReaction(
-      () => contextAnimatedIndex.value,
-      (value) => {
-        externalAnimatedIndex?.set(value);
-      }
-    );
-
-    const { handleAnimate, handleChange, handleClose } =
-      createSheetEventHandlers(id);
-
-    const wrappedOnAnimate: BottomSheetProps['onAnimate'] = (
-      fromIndex,
-      toIndex,
-      fromPosition,
-      toPosition
-    ) => {
-      handleAnimate(fromIndex, toIndex);
-      onAnimate?.(fromIndex, toIndex, fromPosition, toPosition);
-    };
-
-    const wrappedOnChange: BottomSheetProps['onChange'] = (
-      index,
-      position,
-      type
-    ) => {
-      handleChange(index);
-      onChange?.(index, position, type);
-    };
-
-    const wrappedOnClose = () => {
-      onClose?.();
-      handleClose();
-    };
-
-    const config = useBottomSheetSpringConfigs({
-      stiffness: 400,
-      damping: 80,
-      mass: 0.7,
-    });
-
-    return (
-      <BottomSheetOriginal
-        animationConfigs={config}
-        ref={ref}
-        {...props}
-        index={defaultIndex}
-        animatedIndex={contextAnimatedIndex}
-        onChange={wrappedOnChange}
-        onClose={wrappedOnClose}
-        onAnimate={wrappedOnAnimate}
-        backdropComponent={backdropComponent}
-        enablePanDownToClose={enablePanDownToClose}
-      >
-        {children}
-      </BottomSheetOriginal>
-    );
-  }
-);
+/**
+ * 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';

package/src/BottomSheetPersistent.tsx

@@ -1,5 +1,5 @@
-import type { BottomSheetMethods } from '@gorhom/bottom-sheet/lib/typescript/types';
 import React, { useEffect, useRef } from 'react';
+import type { SheetAdapterRef } from './adapter.types';
 
 import { Portal } from 'react-native-teleport';
 import { BottomSheetContext } from './BottomSheet.context';
@@ -30,7 +30,7 @@ export function BottomSheetPersistent({
   const unmount = useUnmount();
   const sheetExists = useSheetExists(id);
   const portalSession = useSheetPortalSession(id);
-  const sheetRef = useRef<BottomSheetMethods>(null);
+  const sheetRef = useRef<SheetAdapterRef>(null);
   const groupId = bottomSheetManagerContext?.groupId || 'default';
 
   const mountSheet = useEvent(() => {

package/src/BottomSheetRef.context.ts

@@ -1,7 +1,5 @@
-import { createContext, useContext, type RefObject } from 'react';
-import type { BottomSheetMethods } from '@gorhom/bottom-sheet/lib/typescript/types';
-
-type SheetRef = RefObject<BottomSheetMethods | null>;
+import { createContext, useContext } from 'react';
+import type { SheetRef } from './adapter.types';
 
 /**
  * Context for passing sheet ref from BottomSheetPersistent/BottomSheetPortal

package/src/adapter.types.ts

@@ -0,0 +1,35 @@
+import type { RefObject } from 'react';
+
+/**
+ * Minimal ref interface for controlling a sheet/modal/overlay.
+ * Every adapter must implement these two methods.
+ *
+ * The coordinator calls:
+ * - `expand()` when status transitions to 'opening'
+ * - `close()` when status transitions to 'closing' or 'hidden'
+ */
+export interface SheetAdapterRef {
+  expand(): void;
+  close(): void;
+}
+
+/**
+ * Event handlers that adapters MUST call to sync UI state back to the store.
+ * Returned by `createSheetEventHandlers(sheetId)`.
+ *
+ * Lifecycle:
+ * 1. Coordinator calls `ref.expand()` → adapter shows UI
+ * 2. Adapter calls `handleOpened()` when show animation completes
+ * 3. User dismisses (swipe/backdrop/back) → adapter calls `handleDismiss()`
+ * 4. Adapter calls `handleClosed()` when hide animation completes
+ */
+export interface SheetAdapterEvents {
+  /** User-initiated dismiss (swipe down, backdrop tap, hardware back button) */
+  handleDismiss(): void;
+  /** Show animation completed — sheet is fully visible and interactive */
+  handleOpened(): void;
+  /** Hide animation completed — sheet is fully hidden */
+  handleClosed(): void;
+}
+
+export type SheetRef = RefObject<SheetAdapterRef | null>;

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

@@ -0,0 +1,83 @@
+import React, { useImperativeHandle, useRef } from 'react';
+
+import type { SheetAdapterRef } from '../../adapter.types';
+import { createSheetEventHandlers } from '../../bottomSheetCoordinator';
+import { useAdapterRef } from '../../useAdapterRef';
+import { useAnimatedIndex } from '../../useAnimatedIndex';
+import { useBottomSheetContext } from '../../useBottomSheetContext';
+
+const ActionSheet = require('react-native-actions-sheet').default;
+
+/**
+ * Adapter for `react-native-actions-sheet` — a zero-dependency action sheet
+ * with snap points and gesture controls.
+ *
+ * All ActionSheet props are accepted via spread and forwarded to the
+ * underlying component. Uses `isModal={false}` internally — the stack
+ * manager handles the overlay lifecycle.
+ *
+ * Requires `react-native-actions-sheet` as a peer dependency:
+ * ```
+ * npm install react-native-actions-sheet
+ * ```
+ *
+ * @see https://github.com/ammarahm-ed/react-native-actions-sheet
+ */
+export interface ActionsSheetAdapterProps {
+  children: React.ReactNode;
+  [key: string]: unknown;
+}
+
+export const ActionsSheetAdapter = React.forwardRef<
+  SheetAdapterRef,
+  ActionsSheetAdapterProps
+>(({ children, ...sheetProps }, forwardedRef) => {
+  const { id } = useBottomSheetContext();
+  const ref = useAdapterRef(forwardedRef);
+  const animatedIndex = useAnimatedIndex();
+
+  const actionSheetRef = useRef<any>(null);
+
+  const { handleDismiss, handleOpened, handleClosed } =
+    createSheetEventHandlers(id);
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      expand: () => actionSheetRef.current?.show(),
+      close: () => actionSheetRef.current?.hide(),
+    }),
+    []
+  );
+
+  const onOpen = () => {
+    animatedIndex.set(0);
+    handleOpened();
+  };
+
+  const onClose = () => {
+    animatedIndex.set(-1);
+    handleClosed();
+  };
+
+  return (
+    <ActionSheet
+      // Adapter defaults (overridable via spread)
+      gestureEnabled
+      closeOnTouchBackdrop
+      closeOnPressBack
+      keyboardHandlerEnabled
+      {...sheetProps}
+      // Managed by adapter (not overridable)
+      ref={actionSheetRef}
+      isModal={false}
+      onOpen={onOpen}
+      onClose={onClose}
+      onBeforeClose={handleDismiss}
+    >
+      {children}
+    </ActionSheet>
+  );
+});
+
+ActionsSheetAdapter.displayName = 'ActionsSheetAdapter';

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

@@ -0,0 +1,4 @@
+export {
+  ActionsSheetAdapter,
+  type ActionsSheetAdapterProps,
+} from './ActionsSheetAdapter';

package/src/adapters/custom-modal/CustomModalAdapter.tsx

@@ -0,0 +1,117 @@
+import React, { useImperativeHandle, useState } from 'react';
+import { StyleSheet, type StyleProp, type ViewStyle } from 'react-native';
+import Animated, {
+  useAnimatedReaction,
+  useAnimatedStyle,
+  useSharedValue,
+  withTiming,
+} from 'react-native-reanimated';
+import { scheduleOnRN } from 'react-native-worklets';
+
+import type { SheetAdapterRef } from '../../adapter.types';
+import { createSheetEventHandlers } from '../../bottomSheetCoordinator';
+import { useAdapterRef } from '../../useAdapterRef';
+import { useAnimatedIndex } from '../../useAnimatedIndex';
+import { useBackHandler } from '../../useBackHandler';
+import { useBottomSheetContext } from '../../useBottomSheetContext';
+
+const ANIMATION_DURATION = 300;
+
+const ZOOM_INITIAL_SCALE = 0.85;
+
+export interface ModalAdapterProps {
+  children: React.ReactNode;
+  contentContainerStyle?: StyleProp<ViewStyle>;
+}
+
+export const CustomModalAdapter = React.forwardRef<
+  SheetAdapterRef,
+  ModalAdapterProps
+>(({ children, contentContainerStyle }, forwardedRef) => {
+  const { id } = useBottomSheetContext();
+  const ref = useAdapterRef(forwardedRef);
+  const animatedIndex = useAnimatedIndex();
+  const [rendered, setRendered] = useState(false);
+  const [open, setOpen] = useState(false);
+
+  const progress = useSharedValue(0);
+
+  const { handleDismiss, handleOpened, handleClosed } =
+    createSheetEventHandlers(id);
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      expand: () => {
+        setRendered(true);
+        setOpen(true);
+        animatedIndex.set(0);
+      },
+      close: () => {
+        setOpen(false);
+        animatedIndex.set(-1);
+      },
+    }),
+    [animatedIndex]
+  );
+
+  const onAnimationEnd = (value: boolean) => {
+    'worklet';
+    if (value) {
+      scheduleOnRN(handleOpened);
+    } else {
+      scheduleOnRN(setRendered, false);
+      scheduleOnRN(handleClosed);
+    }
+  };
+
+  useAnimatedReaction(
+    () => open,
+    (value, prevValue) => {
+      if (prevValue === null || value === prevValue) return;
+      progress.value = withTiming(
+        value ? 1 : 0,
+        { duration: ANIMATION_DURATION },
+        (finished) => {
+          if (!finished) return;
+          onAnimationEnd(value);
+        }
+      );
+    }
+  );
+
+  useBackHandler(id, handleDismiss);
+
+  const animatedStyle = useAnimatedStyle(() => {
+    return {
+      opacity: progress.value,
+      transform: [
+        {
+          scale: ZOOM_INITIAL_SCALE + progress.value * (1 - ZOOM_INITIAL_SCALE),
+        },
+      ],
+    };
+  });
+
+  if (!rendered) {
+    return null;
+  }
+
+  return (
+    <Animated.View
+      style={[styles.container, contentContainerStyle, animatedStyle]}
+    >
+      {children}
+    </Animated.View>
+  );
+});
+
+CustomModalAdapter.displayName = 'CustomModalAdapter';
+
+const styles = StyleSheet.create({
+  container: {
+    ...StyleSheet.absoluteFillObject,
+    justifyContent: 'center',
+    alignItems: 'center',
+  },
+});

package/src/adapters/custom-modal/index.ts

@@ -0,0 +1,7 @@
+export {
+  CustomModalAdapter,
+  type ModalAdapterProps,
+} from './CustomModalAdapter';
+
+/** @deprecated Use `CustomModalAdapter` instead. */
+export { CustomModalAdapter as ModalAdapter } from './CustomModalAdapter';