@niibase/bottom-sheet-manager 1.3.0 → 1.4.1

package/lib/typescript/types.d.ts

@@ -1,5 +1,6 @@
 import type { BottomSheetProps as RNBottomSheetProps } from "@gorhom/bottom-sheet";
 import type { WithSpringConfig, WithTimingConfig } from "react-native-reanimated";
+import { StatusBarStyle } from "react-native";
 import React from "react";
 export interface Sheets {
 }
@@ -26,9 +27,30 @@ export interface SheetDefinition<Payload = never, ReturnValue = never> {
  * - `replace`: Closes current sheet and opens new one. Previous sheet is
  *   removed from stack (not restored on close).
  *
- * - `push`: (experimental) Stacks new sheet on top. Previous sheet remains visible underneath.
+ * - `push`: Stacks new sheet on top. Previous sheet remains visible underneath.
  */
 export type StackBehavior = "switch" | "replace" | "push";
+export type SheetProviderProps = React.PropsWithChildren<{
+    context?: string;
+    /** @default default */
+    statusBar?: StatusBarStyle;
+    scaleConfig?: {
+        /** Scale factor when sheet is open (default: 0.92) */
+        scale?: number;
+        /** Vertical translation when sheet is open (default: 5) */
+        translateY?: number;
+        /** Border radius when sheet is open (default: 24) */
+        borderRadius?: number;
+        /** Animation config - timing or spring (default: timing with 300ms duration) */
+        animation?: {
+            type: "timing";
+            config?: WithTimingConfig;
+        } | {
+            type: "spring";
+            config?: WithSpringConfig;
+        };
+    };
+}>;
 export interface BottomSheetInstance<Id extends SheetIds = SheetIds> {
     /**
      * Close the bottom sheet.
@@ -76,11 +98,11 @@ export interface BottomSheetInstance<Id extends SheetIds = SheetIds> {
      */
     readonly snapToPosition: (position: string | number, animationConfigs?: AnimationConfigs) => void;
 }
-export type BottomSheetProps = Omit<RNBottomSheetProps, "children" | "onClose"> & {
+export type BottomSheetProps<Id extends SheetIds = SheetIds> = Omit<RNBottomSheetProps, "children" | "onClose"> & {
     /**
      * ID of the `BottomSheet`.
      */
-    id?: SheetID<SheetIds>;
+    id?: SheetID<Id>;
     /**
      * Content of the `BottomSheet`.
      */
@@ -91,23 +113,23 @@ export type BottomSheetProps = Omit<RNBottomSheetProps, "children" | "onClose">
      */
     hardwareBackPressToClose?: boolean;
     /**
-     * Callback when the sheet close.
+     * Callback when the sheet closes. Return a value to override the close data
+     * forwarded to `SheetManager.show()` callers.
      *
-     * @type () => any;
-     * @returns The data returned by the sheet to be returned when closed.
+     * @returns Optionally return a new value to pass back to the caller.
      */
-    onClose?: (data?: unknown) => unknown;
+    onClose?: (data?: SheetReturnValue<Id>) => SheetReturnValue<Id> | void;
     /**
      * Event called before sheets is visible.
      * @param data Payload of the sheet if any.
      * @type () => void;
      */
-    onBeforeShow?: (data?: unknown) => void;
+    onBeforeShow?: (data?: SheetPayload<Id>) => void;
     /**
      * Can click through the sheet to the underlying view.
      * @default false
      */
-    clickThrough?: boolean;
+    passThrough?: boolean;
     /**
      * Opacity of the sheet's overlay.
      * @default 0.45
@@ -118,7 +140,7 @@ export type BottomSheetProps = Omit<RNBottomSheetProps, "children" | "onClose">
      *
      * - `switch`: (default) Dismisses the current sheet before showing the new one.
      * - `replace`: Swaps the current sheet's content with smooth crossfade animation.
-     * - `push`: (experimental) Pushes new sheet on top, creating a navigable stack.
+     * - `push`: Pushes new sheet on top, creating a navigable stack.
      *
      * @default "switch"
      */
@@ -130,11 +152,6 @@ export type BottomSheetProps = Omit<RNBottomSheetProps, "children" | "onClose">
      * @default false
      */
     iosModalSheetTypeOfAnimation?: boolean;
-    className?: string;
-    handleIndicatorClassName?: string;
-    backgroundClassName?: string;
-    containerClassName?: string;
-    handleClassName?: string;
 };
 export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@niibase/bottom-sheet-manager",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "A bottom sheet manager for react-native based on @gorhom/bottom-sheet",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -14,9 +14,10 @@
     "build": "bob build && yarn copy-dts && yarn delete-dts.js",
     "copy-dts": "copyfiles -u 1 \"src/**/*.d.ts\" lib/typescript",
     "delete-dts.js": "find ./lib/commonjs -name '*.d.js*' -delete && find ./lib/module -name '*.d.js*' -delete",
-    "release": "rm -rf lib && yarn build && release-it",
+    "postinstall": "node scripts/postinstall.mjs",
+    "bootstrap": "yarn install && yarn example",
     "example": "yarn --cwd example",
-    "bootstrap": "yarn install && yarn example"
+    "patch": "patch-package"
   },
   "repository": {
     "type": "git",
@@ -46,16 +47,17 @@
   "files": [
     "src",
     "lib",
+    "scripts",
     "LICENSE"
   ],
   "peerDependencies": {
-    "@react-navigation/native": ">=6.0.0 || >=7.0.0-",
+    "@react-navigation/native": ">=7.1.8",
     "@types/react": "*",
     "@types/react-native": "*",
     "react": "*",
     "react-native": "*",
-    "react-native-gesture-handler": ">=2.16.1",
-    "react-native-reanimated": ">=3.16.0 || >=4.0.0-",
+    "react-native-gesture-handler": ">=2.28.0",
+    "react-native-reanimated": ">=3.16.0 || >=4.0.0",
     "react-native-safe-area-context": "*"
   },
   "peerDependenciesMeta": {
@@ -67,27 +69,25 @@
     }
   },
   "dependencies": {
-    "@gorhom/bottom-sheet": "^5.2.6",
+    "@gorhom/bottom-sheet": "^5.2.8",
     "nanoid": "^5.1.6"
   },
   "devDependencies": {
-    "@commitlint/cli": "^19.8.1",
-    "@commitlint/config-conventional": "^19.8.1",
-    "@ianvs/prettier-plugin-sort-imports": "file:patched/prettier-plugin-sort-imports",
-    "@react-navigation/native": "^7.1.9",
-    "@release-it/conventional-changelog": "^10.0.1",
+    "@ianvs/prettier-plugin-sort-imports": "4.7.0",
+    "@react-navigation/native": "^7.1.8",
     "@types/react": "~18.3.12",
     "@types/react-native": "~0.73.0",
     "copyfiles": "^2.4.1",
     "metro-react-native-babel-preset": "^0.77.0",
+    "patch-package": "^8.0.1",
     "prettier": "3.6.2",
     "react": "18.3.1",
     "react-native": "0.76.0",
     "react-native-builder-bob": "^0.23.2",
-    "react-native-gesture-handler": "~2.20.2",
+    "react-native-gesture-handler": "~2.28.0",
     "react-native-reanimated": "~3.19.1",
     "react-native-safe-area-context": "~5.6.0",
-    "release-it": "^19.0.4",
+    "react-native-screens": "~4.16.0",
     "typescript": "^5.8.3"
   },
   "react-native-builder-bob": {
@@ -99,4 +99,4 @@
       "typescript"
     ]
   }
-}
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,36 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get the package root (one level up from scripts/)
+const packageRoot = dirname(__dirname);
+const maybeNodeModules = resolve(packageRoot, "../");
+const isInNodeModules =
+    maybeNodeModules.endsWith("node_modules") ||
+    maybeNodeModules.endsWith("node_modules/@niibase");
+
+if (isInNodeModules) {
+    // Fix keyboard not closing issue: https://github.com/gorhom/react-native-bottom-sheet/pull/2511
+    const gorhamBottomSheet = join(
+        maybeNodeModules,
+        "@gorhom/bottom-sheet/src/components/bottomSheet/BottomSheet.tsx",
+    );
+
+    try {
+        const content = readFileSync(gorhamBottomSheet, "utf-8");
+        const updated = content.replace(
+            /index\s*=\s*highestDetentPosition\s*\?\?\s*DEFAULT_KEYBOARD_INDEX\s*;/g,
+            "index = detents?.indexOf(highestDetentPosition ?? 0) ?? DEFAULT_KEYBOARD_INDEX;",
+        );
+        writeFileSync(gorhamBottomSheet, updated, "utf-8");
+        console.log("Applied patch for @gorhom/bottom-sheet");
+    } catch (error) {
+        console.error("Error updating @gorhom/bottom-sheet:", error.message);
+    }
+} else {
+    execSync("yarn run patch", { stdio: "inherit" });
+}

package/src/index.ts

@@ -1,12 +1,12 @@
 export { default as BottomSheet } from "./sheet";
-export { SheetManager } from "./manager";
+export { SheetManager, PrivateManager } from "./manager";
 export * from "./router";
 export * from "./types";
 export {
-  SheetProvider,
-  useSheetPayload,
-  useSheetRef,
-  useOnSheet,
-  useStackBehaviorContext,
-  registerSheet,
+    SheetProvider,
+    useSheetPayload,
+    useSheetRef,
+    useOnSheet,
+    useStackBehaviorContext as useSheetStackBehavior,
+    registerSheet,
 } from "./provider";

package/src/manager.ts

@@ -25,16 +25,26 @@ export const PrivateManager = {
     context(options?: { context?: string; id?: string }) {
         if (!options) options = {};
         if (!options?.context) {
-            // If no context is provided, use the current top-most context
-            // to render the sheet.
-            for (const context of providerRegistryStack.slice().reverse()) {
-                // We only automatically select nested sheet providers.
-                if (
-                    context.startsWith("$$-auto") &&
-                    !context.includes(options?.id as string)
-                ) {
-                    options.context = context;
-                    break;
+            // First try to find a context where this sheet is registered
+            if (options?.id) {
+                for (const context of providerRegistryStack.slice().reverse()) {
+                    if (sheetsRegistry[context]?.[options.id]) {
+                        options.context = context;
+                        break;
+                    }
+                }
+            }
+
+            // Fall back to the top-most auto-generated nested context
+            if (!options.context) {
+                for (const context of providerRegistryStack.slice().reverse()) {
+                    if (
+                        context.startsWith("$$-auto") &&
+                        !context.includes(options?.id as string)
+                    ) {
+                        options.context = context;
+                        break;
+                    }
                 }
             }
         }
@@ -130,6 +140,16 @@ export const PrivateManager = {
     clearHistory: () => {
         PrivateManager.history = [];
     },
+
+    /**
+     * Reset all internal state. Useful for testing or HMR.
+     */
+    reset: () => {
+        ids.length = 0;
+        keys.length = 0;
+        for (const key in refs) delete refs[key];
+        PrivateManager.history = [];
+    },
 };
 
 class _SheetManager {
@@ -185,18 +205,21 @@ class _SheetManager {
 
             const sub = eventManager.subscribe(`onclose_${id}`, handler);
 
-            // Handle existing sheets based on stack behavior
-            const currentStack = PrivateManager.stack();
-            if (currentStack.length > 0) {
-                currentStack.forEach(({ id: sheetId, context }) => {
-                    eventManager.publish(
-                        `hide_${sheetId}`,
-                        undefined,
-                        context,
-                        true,
-                        behavior,
-                    );
-                });
+            // Handle existing sheets based on stack behavior.
+            // For "push" we do NOT hide existing sheets — they stay underneath.
+            if (behavior !== "push") {
+                const currentStack = PrivateManager.stack();
+                if (currentStack.length > 0) {
+                    currentStack.forEach(({ id: sheetId, context }) => {
+                        eventManager.publish(
+                            `hide_${sheetId}`,
+                            undefined,
+                            context,
+                            true,
+                            behavior,
+                        );
+                    });
+                }
             }
 
             // Check if the sheet is registered with any `SheetProviders`.
@@ -306,6 +329,7 @@ class _SheetManager {
     /**
      * Push a new sheet on top of the current one, creating a stack.
      * This is a convenience method for show() with stackBehavior: 'push'.
+     *
      */
     async push<SheetId extends keyof Sheets>(
         id: SheetId | (string & {}),
@@ -329,6 +353,19 @@ class _SheetManager {
         }
     }
 
+    /**
+     * Get the internal ref of a sheet instance.
+     *
+     * @param id Id of the sheet
+     * @param context Optional context of the SheetProvider
+     */
+    get<SheetId extends keyof Sheets>(
+        id: SheetId | (string & {}),
+        context?: string,
+    ): BottomSheetInstance<SheetId> | undefined {
+        return PrivateManager.get(id, context)?.current ?? undefined;
+    }
+
     /**
      * Check if a specific sheet is currently visible.
      */
@@ -338,6 +375,13 @@ class _SheetManager {
     ): boolean {
         return PrivateManager.isSheetVisible(id, context);
     }
+
+    /**
+     * Reset all internal state. Useful for testing environments.
+     */
+    reset(): void {
+        PrivateManager.reset();
+    }
 }
 
 /**

package/src/provider.tsx

@@ -7,13 +7,20 @@ import Animated, {
   useAnimatedStyle,
   useSharedValue,
   withSpring,
+  withTiming,
 } from "react-native-reanimated";
 import { useSafeAreaInsets } from "react-native-safe-area-context";
 import { BottomSheetModalProvider } from "@gorhom/bottom-sheet";
 import { StatusBar } from "react-native";
 import React from "react";
 
-import { BottomSheetInstance, SheetPayload, Sheets, StackBehavior } from "./types";
+import {
+  BottomSheetInstance,
+  SheetPayload,
+  SheetProviderProps,
+  Sheets,
+  StackBehavior,
+} from "./types";
 import { eventManager } from "./events";
 
 export const providerRegistryStack: string[] = [];
@@ -45,47 +52,33 @@ export function registerSheet<SheetId extends keyof Sheets = never>(
       ? (sheetsRegistry[context] = {})
       : sheetsRegistry[context];
     registry[id as string] = Sheet;
-    eventManager.publish(`${context}-on-register`);
+    eventManager.publishAsync(`${context}-on-register`);
   }
 }
 
-/**
- * Animation configuration for iOS modal sheet style animations.
- * @deprecated Use duration prop directly instead
- */
-export interface ModalSheetAnimationConfig {
-  /** Duration of the animation in milliseconds */
-  duration: number;
-}
-
 /**
  * The SheetProvider makes available the sheets in a given context. The default context is
  * `global`. However if you want to render a Sheet within another sheet or if you want to render
  * Sheets in a modal. You can use a separate Provider with a custom context value.
  *
- * For example
+ * > **Note:** Context names must be unique across all `SheetProvider` instances.
+ *
+ * @example
  * ```ts
  * // Define your SheetProvider in the component/modal where
  * // you want to show some Sheets.
  * <SheetProvider context="local-context" />
  *
- * // Then register your sheet when for example the
- * // Modal component renders.
- *
- * registerSheet('local-sheet', LocalSheet,'local-context');
- *
+ * // Then register your sheet at module level (outside JSX):
+ * registerSheet('local-sheet', LocalSheet, 'local-context');
  * ```
  */
 export function SheetProvider({
-  iosModalSheetTypeOfAnimation = false,
   context = "global",
-  duration = 150,
+  statusBar,
+  scaleConfig,
   children,
-}: React.PropsWithChildren<{
-  context?: string;
-  duration?: number;
-  iosModalSheetTypeOfAnimation?: boolean;
-}>) {
+}: SheetProviderProps) {
   const { top } = useSafeAreaInsets();
   const [, forceUpdate] = React.useReducer((x) => x + 1, 0);
   const sheetIds = Object.keys(sheetsRegistry[context] || sheetsRegistry["global"] || {});
@@ -94,33 +87,58 @@ export function SheetProvider({
   const isFullScreen = useSharedValue(-1);
   const colorStyle = useAnimatedStyle(() => ({
     flex: 1,
-    backgroundColor: withSpring(
-      interpolateColor(isFullScreen.value, [0, 1], ["transparent", "#000"]),
-      { duration },
+    backgroundColor: interpolateColor(
+      isFullScreen.value,
+      [0, 1],
+      ["transparent", "#000"],
     ),
   }));
-  const animatedStyle = useAnimatedStyle(
-    () => ({
+  const animatedStyle = useAnimatedStyle(() => {
+    const radius = interpolate(
+      isFullScreen.value,
+      [0, 0.3],
+      [0, scaleConfig?.borderRadius ?? 24],
+      "clamp",
+    );
+    const scale = interpolate(
+      isFullScreen.value,
+      [0.5, 0.8],
+      [1, scaleConfig?.scale ?? 0.92],
+      "clamp",
+    );
+    const translateY = interpolate(
+      isFullScreen.value,
+      [0.5, 0.7],
+      [0, top + (scaleConfig?.translateY ?? 5)],
+      "clamp",
+    );
+
+    return {
       flex: 1,
       overflow: "hidden",
-      borderRadius: interpolate(isFullScreen.value, [0, 0.8, 1], [0, 20, 24], "clamp"),
+      borderRadius:
+        scaleConfig?.animation?.type === "spring"
+          ? withSpring(radius, scaleConfig.animation.config)
+          : withTiming(radius, scaleConfig?.animation?.config ?? { duration: 200 }),
       transform: [
         {
-          scaleX: withSpring(
-            interpolate(isFullScreen.value, [0, 0.8], [1, 0.92], "clamp"),
-            { duration },
-          ),
+          scaleX:
+            scaleConfig?.animation?.type === "spring"
+              ? withSpring(scale, scaleConfig.animation.config)
+              : withTiming(scale, scaleConfig?.animation?.config ?? { duration: 200 }),
         },
         {
-          translateY: withSpring(
-            interpolate(isFullScreen.value, [0, 0.8, 1], [0, top, top + 5], "clamp"),
-            { duration, dampingRatio: 1.5 },
-          ),
+          translateY:
+            scaleConfig?.animation?.type === "spring"
+              ? withSpring(translateY, scaleConfig.animation.config)
+              : withTiming(
+                  translateY,
+                  scaleConfig?.animation?.config ?? { duration: 200 },
+                ),
         },
       ],
-    }),
-    [duration],
-  );
+    };
+  }, [top, scaleConfig]);
 
   // Since background color is white, we need to set status bar to light
   const setStatusBar = StatusBar.setBarStyle;
@@ -128,8 +146,11 @@ export function SheetProvider({
     () => isFullScreen.value,
     (currentValue) => {
       "worklet";
-      if (currentValue > -1) {
-        runOnJS(setStatusBar)(currentValue >= 0.5 ? "light-content" : "default");
+      if (currentValue >= 0) {
+        runOnJS(setStatusBar)(
+          currentValue >= 0.5 ? "light-content" : (statusBar ?? "default"),
+          true,
+        );
       }
     },
     [],
@@ -147,9 +168,7 @@ export function SheetProvider({
   }, [context, forceUpdate]);
 
   return (
-    <SheetAnimationContext.Provider
-      value={{ isFullScreen, iosModalSheetTypeOfAnimation, duration }}
-    >
+    <SheetSharedContext.Provider value={{ isFullScreen, topInset: top }}>
       <Animated.View style={colorStyle}>
         <Animated.View style={animatedStyle}>{children}</Animated.View>
       </Animated.View>
@@ -158,19 +177,18 @@ export function SheetProvider({
           <RenderSheet key={id} id={id} context={context} />
         ))}
       </BottomSheetModalProvider>
-    </SheetAnimationContext.Provider>
+    </SheetSharedContext.Provider>
   );
 }
+
 const ProviderContext = React.createContext("global");
 const SheetIDContext = React.createContext<string | undefined>(undefined);
-const SheetAnimationContext = React.createContext<{
-  iosModalSheetTypeOfAnimation: boolean;
+const SheetSharedContext = React.createContext<{
   isFullScreen: SharedValue<number>;
-  duration: number;
+  topInset: number;
 }>({
   isFullScreen: { value: 0 } as SharedValue<number>,
-  iosModalSheetTypeOfAnimation: false,
-  duration: 300,
+  topInset: 0,
 });
 
 export const SheetRefContext = React.createContext<
@@ -203,13 +221,14 @@ export const useSheetIDContext = () => React.useContext(SheetIDContext);
 /**
  * Get the current sheet animation context.
  */
-export const useSheetAnimationContext = () => React.useContext(SheetAnimationContext);
+export const useSheetSharedContext = () => React.useContext(SheetSharedContext);
 /**
  * Get stack behavior context for the current sheet.
  */
 export const useStackBehaviorContext = () => React.useContext(StackBehaviorContext);
 /**
  * Get the current Sheet's internal ref.
+ * Note: `current` may be null before the sheet is fully mounted.
  */
 export const useSheetRef = <
   SheetId extends keyof Sheets = never,