@niibase/bottom-sheet-manager 1.2.0 → 1.4.0

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 {
 }
@@ -17,6 +18,39 @@ export interface SheetDefinition<Payload = never, ReturnValue = never> {
     payload: Payload;
     returnValue: ReturnValue;
 }
+/**
+ * Defines how sheets behave when a new sheet is opened.
+ *
+ * - `switch`: Closes current sheet and shows new one. Previous sheet is
+ *   restored when new one closes.
+ *
+ * - `replace`: Closes current sheet and opens new one. Previous sheet is
+ *   removed from stack (not restored on close).
+ *
+ * - `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.
@@ -64,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" | "animatedIndex" | "topInset"> & {
+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`.
      */
@@ -79,48 +113,45 @@ 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?: any) => any;
+    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?: any) => 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
      */
     opacity?: number;
     /**
-     * Defines the stack behavior when modal mounts. (experimental)
+     * Defines the stack behavior when sheets are opened.
+     *
+     * - `switch`: (default) Dismisses the current sheet before showing the new one.
+     * - `replace`: Swaps the current sheet's content with smooth crossfade animation.
+     * - `push`: Pushes new sheet on top, creating a navigable stack.
+     *
      * @default "switch"
      */
-    stackBehavior?: "push" | "replace" | "switch";
-    /**
-     * Whether the bottom sheet edge to edge.
-     * @default false
-     */
-    fullScreen?: boolean;
+    stackBehavior?: StackBehavior;
     /**
-     * Whether the bottom sheet is an iOS modal sheet type of animation.
+     * Whether the bottom sheet is an iOS 18 modal sheet type of animation.
+     * When enabled at snap point 90%, the content behind the sheet scales down and gets a
+     * border radius, similar to iOS 18 system sheets.
      * @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.2.0",
+  "version": "1.4.0",
   "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",
@@ -49,13 +50,13 @@
     "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 +68,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 +98,4 @@
       "typescript"
     ]
   }
-}
+}

package/src/events.ts

@@ -1,40 +1,131 @@
-import {
-    DeviceEventEmitter,
-    NativeAppEventEmitter,
-    NativeEventEmitter,
-    Platform,
-} from "react-native";
-
-/* eslint-disable curly */
-export type EventHandler = (...args: any[]) => void;
-export type EventHandlerSubscription = {
-    unsubscribe: () => void;
+/**
+ * High-performance event manager using Maps for O(1) lookups.
+ * Replaces React Native's EventEmitter which has significant overhead.
+ */
+
+export type EventHandler<T extends unknown[] = unknown[]> = (...args: T) => void;
+
+export interface EventSubscription {
+    readonly unsubscribe: () => void;
+}
+
+type HandlerEntry = {
+    handler: EventHandler;
+    id: number;
 };
 
-export default class EventManager {
-    _registry?: NativeEventEmitter;
-    constructor() {
-        this._registry = Platform.select({
-            ios: NativeAppEventEmitter,
-            android: DeviceEventEmitter,
-        });
+class EventManager {
+    private _handlers = new Map<string, HandlerEntry[]>();
+    private _nextId = 0;
+
+    /**
+     * Subscribe to an event with a handler function.
+     * Returns a subscription object with an unsubscribe method.
+     */
+    subscribe<T extends unknown[] = unknown[]>(
+        name: string,
+        handler: EventHandler<T>,
+    ): EventSubscription {
+        if (!name || typeof handler !== "function") {
+            throw new Error("Event name and handler function are required.");
+        }
+
+        const id = this._nextId++;
+        const entry: HandlerEntry = { handler: handler as EventHandler, id };
+
+        const handlers = this._handlers.get(name);
+        if (handlers) {
+            handlers.push(entry);
+        } else {
+            this._handlers.set(name, [entry]);
+        }
+
+        return {
+            unsubscribe: () => {
+                const currentHandlers = this._handlers.get(name);
+                if (currentHandlers) {
+                    const index = currentHandlers.findIndex((h) => h.id === id);
+                    if (index !== -1) {
+                        currentHandlers.splice(index, 1);
+                        if (currentHandlers.length === 0) {
+                            this._handlers.delete(name);
+                        }
+                    }
+                }
+            },
+        };
     }
 
-    subscribe(name: string, handler: EventHandler) {
-        if (!name || !handler) throw new Error("name and handler are required.");
-        const event = this._registry?.addListener(name, handler);
-        return { unsubscribe: () => event?.remove() };
+    /**
+     * Publish an event with optional arguments.
+     * All subscribed handlers will be called synchronously.
+     */
+    publish<T extends unknown[] = unknown[]>(name: string, ...args: T): void {
+        const handlers = this._handlers.get(name);
+        if (!handlers || handlers.length === 0) return;
+
+        // Create a copy to avoid issues if handlers modify the list during iteration
+        const handlersSnapshot = handlers.slice();
+        for (let i = 0; i < handlersSnapshot.length; i++) {
+            handlersSnapshot[i].handler(...args);
+        }
+    }
+
+    /**
+     * Publish an event asynchronously using microtasks for better performance.
+     * Useful when you don't need immediate execution.
+     */
+    publishAsync<T extends unknown[] = unknown[]>(name: string, ...args: T): void {
+        queueMicrotask(() => this.publish(name, ...args));
     }
 
-    publish(name: string, ...args: any[]) {
-        this._registry?.emit(name, ...args);
+    /**
+     * Check if an event has any subscribers.
+     */
+    hasSubscribers(name: string): boolean {
+        const handlers = this._handlers.get(name);
+        return !!handlers && handlers.length > 0;
     }
 
-    remove(...names: string[]) {
-        for (const eventType of names) {
-            this._registry?.removeAllListeners(eventType);
+    /**
+     * Get the number of subscribers for an event.
+     */
+    subscriberCount(name: string): number {
+        return this._handlers.get(name)?.length ?? 0;
+    }
+
+    /**
+     * Remove all listeners for the specified event names.
+     */
+    remove(...names: string[]): void {
+        for (const name of names) {
+            this._handlers.delete(name);
         }
     }
+
+    /**
+     * Remove all event listeners.
+     */
+    clear(): void {
+        this._handlers.clear();
+    }
+
+    /**
+     * Subscribe to an event that will only fire once.
+     */
+    once<T extends unknown[] = unknown[]>(
+        name: string,
+        handler: EventHandler<T>,
+    ): EventSubscription {
+        const subscription = this.subscribe<T>(name, (...args) => {
+            subscription.unsubscribe();
+            handler(...args);
+        });
+        return subscription;
+    }
 }
 
+// Singleton instance for global event management
 export const eventManager = new EventManager();
+
+export default EventManager;

package/src/index.ts

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