@hanzogui/sheet 8.3.0 → 8.3.2

package/dist/esm/useKeyboardControllerSheet.js

@@ -0,0 +1,121 @@
+/**
+ * Web implementation of the keyboard controller sheet hook.
+ *
+ * Mobile browsers don't expose a keyboard API, but they do resize the
+ * VisualViewport when the soft keyboard opens. We use the viewport shrink
+ * (`clientHeight - visualViewport.height`) to detect the keyboard, then feed the
+ * bottom layout inset (`clientHeight - (offsetTop + height)`) into
+ * SheetImplementationCustom. The bottom inset accounts for iOS Safari panning
+ * the visual viewport during focus, so the sheet doesn't over-lift.
+ *
+ * Without this, a bottom sheet on mobile web stays pinned behind the keyboard:
+ * react-native-web's Dimensions tracks the (shrinking) VisualViewport, so any
+ * content sized off window dimensions collapses while the sheet's bottom stays
+ * occluded. See SheetImplementationCustom's activePositions / keyboardOccludedHeight.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { isWeb } from '@hanzogui/constants';
+import { getWebKeyboardBottomInset, getWebKeyboardResizeHeight, isEditableElement, MIN_KEYBOARD_HEIGHT, } from './webViewport.js';
+export function useKeyboardControllerSheet(options) {
+    const { enabled } = options;
+    // initialize from the CURRENT viewport, not blindly from 0/false. when the
+    // sheet opens with the soft keyboard already up (e.g. it was raised by a field
+    // on the page behind, or by an autofocus whose keyboard wins the race against
+    // the first layout), a false initial value makes the sheet's very first render
+    // believe the keyboard is down — it captures a keyboard-free baseline from a
+    // keyboard-shrunk layout and the anchor/seed machinery has to recover. reading
+    // the viewport synchronously here removes that first-render race: the sheet
+    // knows the keyboard is up on render 1 and takes the seed path deterministically.
+    const [keyboardHeight, setKeyboardHeight] = useState(() => isWeb && enabled && typeof window !== 'undefined' && window.visualViewport
+        ? (() => {
+            const resizeHeight = getWebKeyboardResizeHeight();
+            return resizeHeight >= MIN_KEYBOARD_HEIGHT &&
+                isEditableElement(document.activeElement)
+                ? getWebKeyboardBottomInset()
+                : 0;
+        })()
+        : 0);
+    const [isKeyboardVisible, setIsKeyboardVisible] = useState(() => keyboardHeight > 0);
+    // action-sheet pattern: pause keyboard hide events during drag so the sheet
+    // position doesn't revert mid-gesture when a TextInput blurs.
+    const pauseKeyboardHandler = useRef(false);
+    const pendingHide = useRef(false);
+    // live mirror of isKeyboardVisible so the listener can read it without
+    // re-subscribing on every toggle.
+    const isVisibleRef = useRef(false);
+    isVisibleRef.current = isKeyboardVisible;
+    const dismissKeyboard = useCallback(() => {
+        if (typeof document === 'undefined')
+            return;
+        const active = document.activeElement;
+        if (isEditableElement(active)) {
+            active?.blur?.();
+        }
+    }, []);
+    const flushPendingHide = useCallback(() => {
+        if (pendingHide.current) {
+            pendingHide.current = false;
+            setIsKeyboardVisible(false);
+            setKeyboardHeight(0);
+        }
+    }, []);
+    useEffect(() => {
+        if (!isWeb || !enabled)
+            return;
+        if (typeof window === 'undefined')
+            return;
+        const vv = window.visualViewport;
+        if (!vv)
+            return;
+        const update = () => {
+            const resizeHeight = getWebKeyboardResizeHeight();
+            const height = getWebKeyboardBottomInset();
+            const tall = resizeHeight >= MIN_KEYBOARD_HEIGHT;
+            // require an editable element focused to *show* — this rules out URL-bar
+            // collapse and other viewport changes that aren't a keyboard. but stay
+            // visible while the viewport remains shrunk even if focus momentarily
+            // moves to a non-editable element (e.g. tapping between two inputs fires
+            // focusout→focusin), so the sheet doesn't flicker mid-transition.
+            const editableFocused = isEditableElement(document.activeElement);
+            const visible = tall && (editableFocused || isVisibleRef.current);
+            if (!visible) {
+                // suppress hide during an active drag so positions stay frozen; the
+                // drag-end flush reconciles the real state.
+                if (pauseKeyboardHandler.current && isVisibleRef.current) {
+                    pendingHide.current = true;
+                    return;
+                }
+                setIsKeyboardVisible(false);
+                setKeyboardHeight(0);
+                return;
+            }
+            pendingHide.current = false;
+            setIsKeyboardVisible(true);
+            setKeyboardHeight((prev) => (prev === height ? prev : height));
+        };
+        // resize tracks keyboard open/close. scroll tracks iOS Safari's focus pan:
+        // visualViewport.offsetTop can change after the height has settled, and the
+        // sheet cap must move in that same layout coordinate space.
+        vv.addEventListener('resize', update);
+        vv.addEventListener('scroll', update);
+        // focus changes flip editable state without necessarily resizing the viewport
+        window.addEventListener('focusin', update);
+        window.addEventListener('focusout', update);
+        update();
+        return () => {
+            vv.removeEventListener('resize', update);
+            vv.removeEventListener('scroll', update);
+            window.removeEventListener('focusin', update);
+            window.removeEventListener('focusout', update);
+        };
+    }, [enabled]);
+    return {
+        keyboardControllerEnabled: false,
+        keyboardHeight,
+        isKeyboardVisible,
+        dismissKeyboard,
+        pauseKeyboardHandler,
+        flushPendingHide,
+    };
+}
+//# sourceMappingURL=useKeyboardControllerSheet.js.map

package/dist/esm/useKeyboardControllerSheet.js.map

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

package/dist/esm/useSafeAreaInsets.js

@@ -0,0 +1,11 @@
+import * as React from 'react';
+// web uses CSS env(safe-area-inset-*) for safe areas, so there is no native
+// safe-area context to read here — the keyboard-avoidance path uses the visual
+// viewport offset instead. this stub keeps the import resolvable on web (where
+// react-native-safe-area-context isn't a dependency) and is the canonical type
+// source for both platform variants.
+export const SafeAreaInsetsContext = React.createContext(null);
+export function useSafeAreaInsets() {
+    return null;
+}
+//# sourceMappingURL=useSafeAreaInsets.js.map

package/dist/esm/useSafeAreaInsets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSafeAreaInsets.js","sourceRoot":"","sources":["../../src/useSafeAreaInsets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAS9B,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,qCAAqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,aAAa,CAAwB,IAAI,CAAC,CAAA;AAErF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/esm/useSheet.js

@@ -0,0 +1,3 @@
+import { useSheetContext } from './SheetContext.js';
+export const useSheet = () => useSheetContext('', undefined);
+//# sourceMappingURL=useSheet.js.map

package/dist/esm/useSheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSheet.js","sourceRoot":"","sources":["../../src/useSheet.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAoB,CAAA;AAEpD,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA"}

package/dist/esm/useSheetController.js

@@ -0,0 +1,14 @@
+import React from 'react';
+export const useSheetController = () => {
+    const controller = React.useContext(SheetControllerContext);
+    const isHidden = controller?.hidden;
+    const isShowingNonSheet = isHidden && controller?.open;
+    return {
+        controller,
+        isHidden,
+        isShowingNonSheet,
+        disableDrag: controller?.disableDrag,
+    };
+};
+export const SheetControllerContext = React.createContext(null);
+//# sourceMappingURL=useSheetController.js.map

package/dist/esm/useSheetController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSheetController.js","sourceRoot":"","sources":["../../src/useSheetController.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAA;IAC3D,MAAM,QAAQ,GAAG,UAAU,EAAE,MAAM,CAAA;IACnC,MAAM,iBAAiB,GAAG,QAAQ,IAAI,UAAU,EAAE,IAAI,CAAA;IACtD,OAAO;QACL,UAAU;QACV,QAAQ;QACR,iBAAiB;QACjB,WAAW,EAAE,UAAU,EAAE,WAAW;KACrC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GACjC,KAAK,CAAC,aAAa,CAAqC,IAAI,CAAC,CAAA"}

package/dist/esm/useSheetOffscreenSize.js

@@ -0,0 +1,36 @@
+export const useSheetOffscreenSize = ({ snapPoints, position, screenSize, frameSize, snapPointsMode, }) => {
+    if (snapPointsMode === 'fit') {
+        return 0;
+    }
+    if (snapPointsMode === 'constant') {
+        const maxSize = Number(snapPoints[0]);
+        const currentSize = Number(snapPoints[position] ?? 0);
+        const offscreenSize = maxSize - currentSize;
+        return offscreenSize;
+    }
+    if (snapPointsMode === 'percent') {
+        const maxPercentOpened = Number(snapPoints[0]) / 100;
+        const percentOpened = Number(snapPoints[position] ?? 0) / 100;
+        const percentHidden = maxPercentOpened - percentOpened;
+        const offscreenSize = percentHidden * screenSize;
+        return offscreenSize;
+    }
+    // mixed:
+    const maxSnapPoint = snapPoints[0];
+    if (maxSnapPoint === 'fit') {
+        return 0;
+    }
+    const maxSize = typeof maxSnapPoint === 'string'
+        ? (Number(maxSnapPoint.slice(0, -1)) / 100) * screenSize
+        : maxSnapPoint;
+    const currentSnapPoint = snapPoints[position] ?? 0;
+    const currentSize = typeof currentSnapPoint === 'string'
+        ? (Number(currentSnapPoint.slice(0, -1)) / 100) * screenSize
+        : currentSnapPoint;
+    const offscreenSize = maxSize - currentSize;
+    if (Number.isNaN(offscreenSize)) {
+        return 0;
+    }
+    return offscreenSize;
+};
+//# sourceMappingURL=useSheetOffscreenSize.js.map

package/dist/esm/useSheetOffscreenSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSheetOffscreenSize.js","sourceRoot":"","sources":["../../src/useSheetOffscreenSize.tsx"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EACpC,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,cAAc,GACI,EAAE,EAAE;IACtB,IAAI,cAAc,KAAK,KAAK,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;QACrD,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,CAAA;QAC3C,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;QACpD,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAA;QAC7D,MAAM,aAAa,GAAG,gBAAgB,GAAG,aAAa,CAAA;QACtD,MAAM,aAAa,GAAG,aAAa,GAAG,UAAU,CAAA;QAChD,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,SAAS;IACT,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAClC,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,OAAO,GACX,OAAO,YAAY,KAAK,QAAQ;QAC9B,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,UAAU;QACxD,CAAC,CAAC,YAAY,CAAA;IAClB,MAAM,gBAAgB,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAClD,MAAM,WAAW,GACf,OAAO,gBAAgB,KAAK,QAAQ;QAClC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,UAAU;QAC5D,CAAC,CAAC,gBAAgB,CAAA;IACtB,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,CAAA;IAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,aAAa,CAAA;AACtB,CAAC,CAAA"}

package/dist/esm/useSheetOpenState.js

@@ -0,0 +1,25 @@
+import { useControllableState } from '@hanzogui/use-controllable-state';
+import { useSheetController } from './useSheetController.js';
+export const useSheetOpenState = (props) => {
+    const { isHidden, controller } = useSheetController();
+    const onOpenChangeInternal = (val) => {
+        controller?.onOpenChange?.(val);
+        props.onOpenChange?.(val);
+    };
+    const propVal = props.preferAdaptParentOpenState
+        ? (controller?.open ?? props.open)
+        : (props.open ?? controller?.open);
+    const [open, setOpen] = useControllableState({
+        prop: propVal,
+        defaultProp: props.defaultOpen ?? false,
+        onChange: onOpenChangeInternal,
+        strategy: 'most-recent-wins',
+    });
+    return {
+        open,
+        setOpen,
+        isHidden,
+        controller,
+    };
+};
+//# sourceMappingURL=useSheetOpenState.js.map

package/dist/esm/useSheetOpenState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSheetOpenState.js","sourceRoot":"","sources":["../../src/useSheetOpenState.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAGvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAA0B,CAAA;AAE7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAiB,EAAE,EAAE;IACrD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,kBAAkB,EAAE,CAAA;IAErD,MAAM,oBAAoB,GAAG,CAAC,GAAY,EAAE,EAAE;QAC5C,UAAU,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAA;QAC/B,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,0BAA0B;QAC9C,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;QAClC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,UAAU,EAAE,IAAI,CAAC,CAAA;IAEpC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAAC;QAC3C,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK;QACvC,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ,EAAE,kBAAkB;KAC7B,CAAC,CAAA;IAEF,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,UAAU;KACX,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/useSheetProviderProps.js

@@ -0,0 +1,165 @@
+import React from 'react';
+import { useConfiguration } from '@hanzogui/core';
+import { useConstant } from '@hanzogui/use-constant';
+import { useControllableState } from '@hanzogui/use-controllable-state';
+export function useSheetProviderProps(props, state, options = {}) {
+    const handleRef = React.useRef(null);
+    const contentRef = React.useRef(null);
+    const [frameSize, setFrameSize] = React.useState(0);
+    const [maxContentSize, setMaxContentSize] = React.useState(0);
+    const snapPointsMode = props.snapPointsMode ?? 'percent';
+    const snapPointsProp = props.snapPoints ??
+        (snapPointsMode === 'percent'
+            ? [80]
+            : snapPointsMode === 'constant'
+                ? [256]
+                : ['fit']);
+    const hasFit = snapPointsProp[0] === 'fit';
+    const snapPoints = React.useMemo(() => (props.dismissOnSnapToBottom ? [...snapPointsProp, 0] : snapPointsProp), [JSON.stringify(snapPointsProp), props.dismissOnSnapToBottom]);
+    // lets set -1 to be always the "open = false" position
+    const [position_, setPositionImmediate] = useControllableState({
+        prop: props.position,
+        defaultProp: props.defaultPosition || (state.open ? 0 : -1),
+        onChange: props.onPositionChange,
+        strategy: 'most-recent-wins',
+    });
+    const position = state.open === false ? -1 : position_;
+    const { open } = state;
+    const setPosition = React.useCallback((next) => {
+        // close on dismissOnSnapToBottom (and set position so it animates)
+        if (props.dismissOnSnapToBottom && next === snapPoints.length - 1) {
+            state.setOpen(false);
+        }
+        else {
+            setPositionImmediate(next);
+        }
+    }, [props.dismissOnSnapToBottom, snapPoints.length, setPositionImmediate, state.setOpen]);
+    if (process.env.NODE_ENV === 'development') {
+        if (snapPointsMode === 'mixed' &&
+            snapPoints.some((p) => {
+                if (typeof p === 'string') {
+                    if (p === 'fit') {
+                        return false;
+                    }
+                    if (p.endsWith('%')) {
+                        const n = Number(p.slice(0, -1));
+                        return n < 0 || n > 100;
+                    }
+                    return true;
+                }
+                return typeof p !== 'number' || p < 0;
+            })) {
+            console.warn('⚠️ Invalid snapPoint given, snapPoints must be positive numeric values, string percentages between 0-100%, or "fit" when snapPointsMode is mixed');
+        }
+        if (snapPointsMode === 'mixed' && snapPoints.indexOf('fit') > 0) {
+            console.warn('⚠️ Invalid snapPoint given, "fit" must be the first/largest snap point when snapPointsMode is mixed');
+        }
+        if (snapPointsMode === 'fit' &&
+            (snapPoints.length !== (props.dismissOnSnapToBottom ? 2 : 1) ||
+                snapPoints[0] !== 'fit')) {
+            console.warn('⚠️ Invalid snapPoint given, there are no snap points when snapPointsMode is fit');
+        }
+        if (snapPointsMode === 'constant' &&
+            snapPoints.some((p) => typeof p !== 'number' || p < 0)) {
+            console.warn('⚠️ Invalid snapPoint given, snapPoints must be positive numeric values when snapPointsMode is constant');
+        }
+        if (snapPointsMode === 'percent' &&
+            snapPoints.some((p) => typeof p !== 'number' || p < 0 || p > 100)) {
+            console.warn('⚠️ Invalid snapPoint given, snapPoints must be numeric values between 0 and 100 when snapPointsMode is percent');
+        }
+    }
+    // reset position to fully open on re-open after dismissOnSnapToBottom
+    if (open && props.dismissOnSnapToBottom && position === snapPoints.length - 1) {
+        setPositionImmediate(0);
+    }
+    // open must set position
+    const shouldSetPositionOpen = open && position < 0;
+    React.useEffect(() => {
+        if (shouldSetPositionOpen) {
+            setPosition(0);
+        }
+    }, [setPosition, shouldSetPositionOpen]);
+    const { animationDriver } = useConfiguration();
+    if (!animationDriver) {
+        throw new Error(process.env.NODE_ENV === 'production'
+            ? `❌ 008`
+            : 'Must set animations in hanzogui.config.ts');
+    }
+    const scrollBridge = useConstant(() => {
+        const parentDragListeners = new Set();
+        const bridge = {
+            hasScrollableContent: false,
+            enabled: false,
+            y: 0,
+            paneY: 0,
+            paneMinY: 0,
+            scrollStartY: -1,
+            drag: () => { },
+            release: () => { },
+            scrollLock: false,
+            isParentDragging: false,
+            onParentDragging: (cb) => {
+                parentDragListeners.add(cb);
+                return () => {
+                    parentDragListeners.delete(cb);
+                };
+            },
+            setParentDragging: (val) => {
+                if (val !== bridge.isParentDragging) {
+                    bridge.isParentDragging = val;
+                    parentDragListeners.forEach((cb) => cb(val));
+                }
+            },
+        };
+        return bridge;
+    });
+    // Handle both new disableRemoveScroll and deprecated forceRemoveScrollEnabled
+    let disableRemoveScroll;
+    if (props.disableRemoveScroll !== undefined) {
+        // New prop: disableRemoveScroll={true} means RemoveScroll is disabled
+        disableRemoveScroll = props.disableRemoveScroll || !open || !props.modal;
+    }
+    else if (props.forceRemoveScrollEnabled !== undefined) {
+        // Deprecated prop: forceRemoveScrollEnabled can override the default
+        if (process.env.NODE_ENV === 'development') {
+            console.warn('[Sheet] forceRemoveScrollEnabled is deprecated. Use disableRemoveScroll instead.');
+        }
+        disableRemoveScroll = !props.forceRemoveScrollEnabled;
+    }
+    else {
+        // Default: disabled when not open or not modal
+        disableRemoveScroll = !open || !props.modal;
+    }
+    const maxSnapPoint = snapPoints[0];
+    const screenSize = snapPointsMode === 'percent'
+        ? frameSize / ((typeof maxSnapPoint === 'number' ? maxSnapPoint : 100) / 100)
+        : maxContentSize;
+    const providerProps = {
+        screenSize,
+        maxSnapPoint,
+        disableRemoveScroll,
+        scrollBridge,
+        modal: !!props.modal,
+        open: state.open,
+        setOpen: state.setOpen,
+        hidden: !!state.isHidden,
+        contentRef,
+        handleRef,
+        frameSize,
+        setFrameSize,
+        dismissOnOverlayPress: props.dismissOnOverlayPress ?? true,
+        dismissOnSnapToBottom: props.dismissOnSnapToBottom ?? false,
+        onOverlayComponent: options.onOverlayComponent,
+        scope: props.__scopeSheet,
+        hasFit,
+        position,
+        snapPoints,
+        snapPointsMode,
+        setMaxContentSize,
+        setPosition,
+        setPositionImmediate,
+        onlyShowFrame: false,
+    };
+    return providerProps;
+}
+//# sourceMappingURL=useSheetProviderProps.js.map

package/dist/esm/useSheetProviderProps.js.map

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

package/dist/esm/useSheetScrollViewGestures.js

@@ -0,0 +1,192 @@
+import { useEffect, useRef } from 'react';
+export function useSheetScrollViewGestures({ scrollRef, scrollBridge, hasScrollableContent, onManualScroll, }) {
+    const state = useRef({
+        startY: 0,
+        lastY: 0,
+        owner: 'none',
+        hadPanOwner: false,
+        panDragOffset: 0,
+        dys: [],
+        scrollYAtGestureStart: 0,
+    });
+    const onManualScrollRef = useRef(onManualScroll);
+    useEffect(() => {
+        onManualScrollRef.current = onManualScroll;
+    }, [onManualScroll]);
+    useEffect(() => {
+        if (!scrollRef.current)
+            return;
+        const controller = new AbortController();
+        const node = scrollRef.current?.getScrollableNode();
+        if (!node)
+            return;
+        node.style.overscrollBehavior = 'contain';
+        // track original overflow to restore later
+        let originalOverflow = '';
+        const disableScroll = () => {
+            if (node.style.overflowY !== 'hidden') {
+                originalOverflow = node.style.overflowY;
+                node.style.overflowY = 'hidden';
+            }
+        };
+        const enableScroll = () => {
+            node.style.overflowY = originalOverflow;
+        };
+        const setScrollTop = (nextScrollY) => {
+            if (node.scrollTop === nextScrollY)
+                return;
+            node.scrollTop = nextScrollY;
+            onManualScrollRef.current?.(node, nextScrollY);
+        };
+        const handleTouchStart = (e) => {
+            const touch = e.touches[0];
+            if (!touch)
+                return;
+            const currentScrollY = node.scrollTop;
+            state.current = {
+                startY: touch.pageY,
+                lastY: touch.pageY,
+                owner: 'none',
+                hadPanOwner: false,
+                panDragOffset: 0,
+                dys: [],
+                scrollYAtGestureStart: currentScrollY,
+            };
+            scrollBridge.scrollStartY = touch.pageY;
+            // claim this touch for the scroll-view gesture hook so the PanResponder
+            // (which also negotiates this touch via RNW's responder system) defers
+            // and doesn't double-drive the sheet position. cleared on touchend.
+            scrollBridge.scrollNodeTouched = true;
+        };
+        const handleTouchMove = (e) => {
+            const touch = e.touches[0];
+            if (!touch)
+                return;
+            const { current: s } = state;
+            const pageY = touch.pageY;
+            const dy = pageY - s.lastY;
+            s.lastY = pageY;
+            if (dy === 0)
+                return;
+            const isDraggingDown = dy > 0;
+            const currentScrollY = node.scrollTop;
+            const isPaneAtTop = scrollBridge.isAtTop ?? scrollBridge.paneY <= scrollBridge.paneMinY + 5;
+            scrollBridge.y = currentScrollY;
+            // simple ownership rules:
+            // - pan owns when: sheet not at top, OR (sheet at top AND scrollY=0 AND dragging down)
+            // - scroll owns otherwise
+            let shouldPanOwn = false;
+            if (!isPaneAtTop) {
+                // sheet not at top - pan always owns
+                shouldPanOwn = true;
+            }
+            else if (currentScrollY <= 0 && isDraggingDown) {
+                // at top, scroll at 0, dragging down - pan owns (pull sheet down)
+                shouldPanOwn = true;
+            }
+            const newOwner = shouldPanOwn ? 'pan' : 'scroll';
+            // handle transitions
+            if (newOwner !== s.owner) {
+                if (newOwner === 'pan') {
+                    s.hadPanOwner = true;
+                    s.panDragOffset = 0;
+                    s.dys = [];
+                    // re-baseline the pan origin to the sheet's CURRENT position so the
+                    // offset (reset to 0 here) maps to where it actually is — required for
+                    // a correct scroll→pan handoff now that the PanResponder defers to us.
+                    scrollBridge.startPanDrag?.();
+                    scrollBridge.setParentDragging(true);
+                    disableScroll();
+                }
+                else {
+                    scrollBridge.setParentDragging(false);
+                    scrollBridge.scrollLock = false;
+                    if (s.hadPanOwner) {
+                        disableScroll();
+                    }
+                    else {
+                        enableScroll();
+                    }
+                }
+                s.owner = newOwner;
+            }
+            if (s.owner === 'pan') {
+                if (e.cancelable)
+                    e.preventDefault();
+                s.panDragOffset += dy;
+                scrollBridge.drag(s.panDragOffset);
+                s.dys.push(dy);
+                if (s.dys.length > 100)
+                    s.dys = s.dys.slice(-10);
+            }
+            else if (s.owner === 'scroll' && (!e.isTrusted || s.hadPanOwner)) {
+                // synthetic events don't trigger native overflow scroll, so tests need us
+                // to move scrollTop directly. real mixed gestures need the same direct
+                // path after pan ownership: ios safari may not resume native scrolling
+                // mid-touch after an earlier prevented touchmove. pure real scrolls still
+                // use native scrolling; mixed pan↔scroll gestures keep overflow hidden
+                // and are driven here until touchend.
+                if (e.cancelable)
+                    e.preventDefault();
+                const scrollDelta = -dy;
+                const maxScrollY = node.scrollHeight - node.clientHeight;
+                const newScrollY = Math.max(0, Math.min(maxScrollY, currentScrollY + scrollDelta));
+                if (newScrollY !== currentScrollY) {
+                    setScrollTop(newScrollY);
+                    scrollBridge.y = newScrollY;
+                    if (newScrollY > 0)
+                        scrollBridge.scrollStartY = -1;
+                }
+            }
+        };
+        const handleTouchEnd = () => {
+            const { current: s } = state;
+            if (s.owner === 'pan') {
+                scrollBridge.setParentDragging(false);
+                let vy = 0;
+                if (s.dys.length) {
+                    const recentDys = s.dys.slice(-10);
+                    const dist = recentDys.reduce((a, b) => a + b, 0);
+                    vy = (dist / recentDys.length) * 0.04;
+                }
+                scrollBridge.release({ dragAt: s.panDragOffset, vy });
+            }
+            else if (s.owner === 'scroll') {
+                // gesture ended while scrolling. a pan→scroll handoff only happens once
+                // the pane reached the top, so commit the top snap (index 0) and clear
+                // the dragging state HERE, on touchend — never mid-gesture (that would
+                // fight the live gesture). this replaces the PanResponder's release,
+                // which used to fire on touchend before it deferred to this hook.
+                scrollBridge.snapToPosition?.(0);
+            }
+            enableScroll();
+            s.owner = 'none';
+            s.hadPanOwner = false;
+            s.panDragOffset = 0;
+            s.dys = [];
+            scrollBridge.scrollNodeTouched = false;
+        };
+        node.addEventListener('touchstart', handleTouchStart, {
+            signal: controller.signal,
+            passive: true,
+        });
+        node.addEventListener('touchmove', handleTouchMove, {
+            signal: controller.signal,
+            passive: false,
+        });
+        node.addEventListener('touchend', handleTouchEnd, {
+            signal: controller.signal,
+            passive: true,
+        });
+        node.addEventListener('touchcancel', handleTouchEnd, {
+            signal: controller.signal,
+            passive: true,
+        });
+        return () => {
+            enableScroll();
+            controller.abort();
+        };
+    }, [scrollRef, scrollBridge, hasScrollableContent]);
+    return {};
+}
+//# sourceMappingURL=useSheetScrollViewGestures.js.map

package/dist/esm/useSheetScrollViewGestures.js.map

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