@yahoo/uds-mobile 2.3.3 → 2.4.0

package/dist/components/BottomSheet/useBottomSheetDrag.cjs

@@ -0,0 +1,191 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_components_BottomSheet_utils = require('./utils.cjs');
+let react = require("react");
+let react_native = require("react-native");
+let react_native_reanimated = require("react-native-reanimated");
+let react_native_gesture_handler = require("react-native-gesture-handler");
+
+//#region src/components/BottomSheet/useBottomSheetDrag.ts
+/**
+* Velocity threshold (px/s) above which a downward fling dismisses the sheet.
+*/
+const DRAG_DISMISS_VELOCITY = 500;
+/**
+* Duration (ms) after opening during which drag is blocked to prevent
+* accidentally stealing scroll intent.
+*/
+const OPEN_LOCK_TIMEOUT_MS = 250;
+/**
+* Horizontal movement (px) that causes the pan gesture to fail,
+* handing control to horizontal scrolling or other gestures.
+*/
+const HORIZONTAL_FAIL_THRESHOLD = 20;
+/**
+* Minimum vertical movement (px) required before deciding whether to
+* activate the pan gesture or let the scroll view handle the touch.
+*/
+const VERTICAL_ACTIVATION_THRESHOLD = 10;
+/**
+* Approximate height (px) of the header area (paddingTop + handle + header row).
+* Touches above this threshold always activate the pan for sheet collapse.
+* Touches below it may defer to the scroll view on Android.
+*/
+const HEADER_AREA_HEIGHT = 64;
+/** How much drag past max snap is visible (0–1). Lower = more resistance. */
+const RUBBER_BAND_FACTOR = .2;
+/** Max enableOverstretch distance (px) past the max snap point. */
+const MAX_OVERSTRETCH_PX = 30;
+/**
+* Builds the pan gesture that drives sheet dragging.
+*
+* Handles:
+* - Drag-to-snap (nearest or velocity-based)
+* - Drag-to-dismiss (past lowest snap threshold or fast fling)
+* - Fresh-open lock (prevents accidental drag right after opening)
+* - Scroll coordination (gates between sheet drag and content scroll)
+*
+* Scroll is only unlocked at the max snap point. At non-max snaps, dragging
+* anywhere on the sheet expands or collapses it. At max snap, content is
+* scrollable; dragging down from scroll-top collapses the sheet.
+*
+* All gesture callbacks run on the UI thread via Reanimated worklets.
+*/
+function useBottomSheetDrag({ enableDrag, dismissible, enableOverstretch, resolvedSnapPoints, containerHeight, bottomInsetPx, translateY, activeSnapIndex, isAnimating, animateToSnapWorklet, animateToCloseWorklet, onDismiss, scrollLocked, scrollOffsetY, getTranslateYForSnap }) {
+	const isDragActive = (0, react_native_reanimated.useSharedValue)(false);
+	const touchStartX = (0, react_native_reanimated.useSharedValue)(0);
+	const touchStartY = (0, react_native_reanimated.useSharedValue)(0);
+	const dragStartTranslateY = (0, react_native_reanimated.useSharedValue)(0);
+	const dragStartIndex = (0, react_native_reanimated.useSharedValue)(0);
+	const openTimeSV = (0, react_native_reanimated.useSharedValue)(0);
+	const panGestureRef = (0, react.useRef)(void 0);
+	const snapCount = resolvedSnapPoints.length;
+	const maxSnapIndex = snapCount - 1;
+	/** Compute all snap translateY positions — worklet. */
+	const getSnapTranslateYs = (0, react.useCallback)(() => {
+		"worklet";
+		const result = [];
+		for (let i = 0; i < snapCount; i++) result.push(getTranslateYForSnap(i));
+		return result;
+	}, [snapCount, getTranslateYForSnap]);
+	/** Dismiss threshold: 25% of the lowest snap height. */
+	const getDismissThreshold = (0, react.useCallback)(() => {
+		"worklet";
+		if (snapCount === 0) return 50;
+		return require_components_BottomSheet_utils.resolveHeightToPx(resolvedSnapPoints[0], containerHeight.value) * .25;
+	}, [
+		resolvedSnapPoints,
+		snapCount,
+		containerHeight
+	]);
+	const handleDismissJS = (0, react.useCallback)(() => {
+		onDismiss();
+	}, [onDismiss]);
+	return {
+		panGesture: react_native_gesture_handler.Gesture.Pan().withRef(panGestureRef).manualActivation(true).onTouchesDown((e, _stateManager) => {
+			"worklet";
+			const touch = e.allTouches[0];
+			if (touch) {
+				touchStartX.value = touch.absoluteX;
+				touchStartY.value = touch.absoluteY;
+			}
+		}).onTouchesMove((e, stateManager) => {
+			"worklet";
+			const touch = e.allTouches[0];
+			if (!touch) return;
+			const dx = touch.absoluteX - touchStartX.value;
+			const dy = touch.absoluteY - touchStartY.value;
+			if (Math.abs(dx) > HORIZONTAL_FAIL_THRESHOLD) {
+				stateManager.fail();
+				return;
+			}
+			if (Math.abs(dy) < VERTICAL_ACTIVATION_THRESHOLD) return;
+			const now = Date.now();
+			if (openTimeSV.value > 0 && now - openTimeSV.value < OPEN_LOCK_TIMEOUT_MS) {
+				stateManager.fail();
+				return;
+			}
+			if (isAnimating.value) {
+				stateManager.fail();
+				return;
+			}
+			if (activeSnapIndex.value === maxSnapIndex) {
+				if (dy < 0) {
+					if (!enableOverstretch) {
+						stateManager.fail();
+						return;
+					}
+					if (touchStartY.value - translateY.value > HEADER_AREA_HEIGHT && (react_native.Platform.OS === "android" || scrollOffsetY.value > 1)) {
+						stateManager.fail();
+						return;
+					}
+				} else if (react_native.Platform.OS === "android" && scrollOffsetY.value > 1) {
+					if (touchStartY.value - translateY.value > HEADER_AREA_HEIGHT) {
+						stateManager.fail();
+						return;
+					}
+				}
+			}
+			stateManager.activate();
+		}).onStart(() => {
+			"worklet";
+			isDragActive.value = true;
+			dragStartTranslateY.value = translateY.value;
+			dragStartIndex.value = activeSnapIndex.value;
+			scrollLocked.value = true;
+		}).onUpdate((event) => {
+			"worklet";
+			if (!isDragActive.value) return;
+			const maxSnapTranslateY = snapCount > 0 ? getTranslateYForSnap(snapCount - 1) : 0;
+			const closedTranslateY = containerHeight.value + bottomInsetPx;
+			const nextY = dragStartTranslateY.value + event.translationY;
+			if (enableOverstretch && nextY < maxSnapTranslateY) {
+				const overflow = maxSnapTranslateY - nextY;
+				translateY.value = maxSnapTranslateY - Math.min(overflow * RUBBER_BAND_FACTOR, MAX_OVERSTRETCH_PX);
+			} else translateY.value = require_components_BottomSheet_utils.clamp(nextY, maxSnapTranslateY, closedTranslateY);
+		}).onEnd((event) => {
+			"worklet";
+			if (!isDragActive.value) return;
+			isDragActive.value = false;
+			const currentY = translateY.value;
+			const startIndex = dragStartIndex.value;
+			const snapTranslateYs = getSnapTranslateYs();
+			const startSnapY = snapTranslateYs[startIndex] ?? containerHeight.value;
+			const draggedDistance = dragStartTranslateY.value - currentY;
+			const draggedDown = draggedDistance < 0;
+			const draggedUp = draggedDistance > 0;
+			const velocityPxPerSec = Math.abs(event.velocityY);
+			const isAtLowestSnap = startIndex === 0;
+			const dismissThreshold = getDismissThreshold();
+			const draggedDownAmount = currentY - startSnapY;
+			if (dismissible && isAtLowestSnap && draggedDown && (velocityPxPerSec >= DRAG_DISMISS_VELOCITY || draggedDownAmount >= dismissThreshold)) {
+				scrollLocked.value = true;
+				animateToCloseWorklet();
+				(0, react_native_reanimated.runOnJS)(handleDismissJS)();
+				return;
+			}
+			if (velocityPxPerSec >= DRAG_DISMISS_VELOCITY && (draggedUp || draggedDown)) {
+				const nextIndex = require_components_BottomSheet_utils.clampIndex(startIndex + (draggedUp ? 1 : -1), snapCount);
+				scrollLocked.value = nextIndex !== maxSnapIndex;
+				animateToSnapWorklet(nextIndex);
+				return;
+			}
+			const nextIndexInDirection = draggedUp ? Math.min(startIndex + 1, maxSnapIndex) : Math.max(startIndex - 1, 0);
+			const nextSnapY = snapTranslateYs[nextIndexInDirection] ?? startSnapY;
+			const distBetweenSnaps = Math.abs(nextSnapY - startSnapY);
+			const dragDist = Math.abs(currentY - startSnapY);
+			const targetIndex = distBetweenSnaps > 0 && dragDist > distBetweenSnaps * .25 ? nextIndexInDirection : startIndex;
+			scrollLocked.value = targetIndex !== maxSnapIndex;
+			animateToSnapWorklet(targetIndex);
+		}).onFinalize(() => {
+			"worklet";
+			if (isDragActive.value) isDragActive.value = false;
+		}).enabled(enableDrag),
+		panGestureRef,
+		openTimeSV
+	};
+}
+
+//#endregion
+exports.useBottomSheetDrag = useBottomSheetDrag;

package/dist/components/BottomSheet/useBottomSheetDrag.d.cts

@@ -0,0 +1,69 @@
+
+import { BottomSheetHeight } from "./types.cjs";
+import { GestureType } from "react-native-gesture-handler";
+import { SharedValue } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useBottomSheetDrag.d.ts
+interface UseBottomSheetDragParams {
+  enableDrag: boolean;
+  dismissible: boolean;
+  enableOverstretch: boolean;
+  resolvedSnapPoints: BottomSheetHeight[];
+  containerHeight: SharedValue<number>;
+  bottomInsetPx: number;
+  translateY: SharedValue<number>;
+  activeSnapIndex: SharedValue<number>;
+  isAnimating: SharedValue<boolean>;
+  animateToSnapWorklet: (index: number) => void;
+  animateToCloseWorklet: () => void;
+  onDismiss: () => void;
+  /** Scroll lock — written here, read by BottomSheetContent. */
+  scrollLocked: SharedValue<boolean>;
+  /** Current content scroll offset (UI-thread shared value). */
+  scrollOffsetY: SharedValue<number>;
+  /** Compute translateY for a given snap index (worklet). Provided by the snap model. */
+  getTranslateYForSnap: (index: number) => number;
+}
+interface UseBottomSheetDragResult {
+  /** The pan gesture to attach to GestureDetector. */
+  panGesture: GestureType;
+  /** Ref to the pan gesture — for simultaneousWithExternalGesture in scroll. */
+  panGestureRef: React.RefObject<GestureType | undefined>;
+  /** Shared value — set to Date.now() when sheet opens, for fresh-open lock. */
+  openTimeSV: SharedValue<number>;
+}
+/**
+ * Builds the pan gesture that drives sheet dragging.
+ *
+ * Handles:
+ * - Drag-to-snap (nearest or velocity-based)
+ * - Drag-to-dismiss (past lowest snap threshold or fast fling)
+ * - Fresh-open lock (prevents accidental drag right after opening)
+ * - Scroll coordination (gates between sheet drag and content scroll)
+ *
+ * Scroll is only unlocked at the max snap point. At non-max snaps, dragging
+ * anywhere on the sheet expands or collapses it. At max snap, content is
+ * scrollable; dragging down from scroll-top collapses the sheet.
+ *
+ * All gesture callbacks run on the UI thread via Reanimated worklets.
+ */
+declare function useBottomSheetDrag({
+  enableDrag,
+  dismissible,
+  enableOverstretch,
+  resolvedSnapPoints,
+  containerHeight,
+  bottomInsetPx,
+  translateY,
+  activeSnapIndex,
+  isAnimating,
+  animateToSnapWorklet,
+  animateToCloseWorklet,
+  onDismiss,
+  scrollLocked,
+  scrollOffsetY,
+  getTranslateYForSnap
+}: UseBottomSheetDragParams): UseBottomSheetDragResult;
+//#endregion
+export { useBottomSheetDrag };
+//# sourceMappingURL=useBottomSheetDrag.d.cts.map

package/dist/components/BottomSheet/useBottomSheetDrag.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetDrag.d.cts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetDrag.ts"],"mappings":";;;;;;UA8CU,wBAAA;EACR,UAAA;EACA,WAAA;EACA,iBAAA;EACA,kBAAA,EAAoB,iBAAA;EACpB,eAAA,EAAiB,WAAA;EACjB,aAAA;EACA,UAAA,EAAY,WAAA;EACZ,eAAA,EAAiB,WAAA;EACjB,WAAA,EAAa,WAAA;EACb,oBAAA,GAAuB,KAAA;EACvB,qBAAA;EACA,SAAA;EAI0B;EAF1B,YAAA,EAAc,WAAA;EAZd;EAcA,aAAA,EAAe,WAAA;EAZf;EAcA,oBAAA,GAAuB,KAAA;AAAA;AAAA,UAGf,wBAAA;EAfR;EAiBA,UAAA,EAAY,WAAA;EAhBA;EAkBZ,aAAA,EAAe,KAAA,CAAM,SAAA,CAAU,WAAA;EAjBd;EAmBjB,UAAA,EAAY,WAAA;AAAA;;;;;;;;;;;;;AATwB;;;iBA2B7B,kBAAA,CAAA;EACP,UAAA;EACA,WAAA;EACA,iBAAA;EACA,kBAAA;EACA,eAAA;EACA,aAAA;EACA,UAAA;EACA,eAAA;EACA,WAAA;EACA,oBAAA;EACA,qBAAA;EACA,SAAA;EACA,YAAA;EACA,aAAA;EACA;AAAA,GACC,wBAAA,GAA2B,wBAAA"}

package/dist/components/BottomSheet/useBottomSheetDrag.d.ts

@@ -0,0 +1,69 @@
+
+import { BottomSheetHeight } from "./types.js";
+import { SharedValue } from "react-native-reanimated";
+import { GestureType } from "react-native-gesture-handler";
+
+//#region src/components/BottomSheet/useBottomSheetDrag.d.ts
+interface UseBottomSheetDragParams {
+  enableDrag: boolean;
+  dismissible: boolean;
+  enableOverstretch: boolean;
+  resolvedSnapPoints: BottomSheetHeight[];
+  containerHeight: SharedValue<number>;
+  bottomInsetPx: number;
+  translateY: SharedValue<number>;
+  activeSnapIndex: SharedValue<number>;
+  isAnimating: SharedValue<boolean>;
+  animateToSnapWorklet: (index: number) => void;
+  animateToCloseWorklet: () => void;
+  onDismiss: () => void;
+  /** Scroll lock — written here, read by BottomSheetContent. */
+  scrollLocked: SharedValue<boolean>;
+  /** Current content scroll offset (UI-thread shared value). */
+  scrollOffsetY: SharedValue<number>;
+  /** Compute translateY for a given snap index (worklet). Provided by the snap model. */
+  getTranslateYForSnap: (index: number) => number;
+}
+interface UseBottomSheetDragResult {
+  /** The pan gesture to attach to GestureDetector. */
+  panGesture: GestureType;
+  /** Ref to the pan gesture — for simultaneousWithExternalGesture in scroll. */
+  panGestureRef: React.RefObject<GestureType | undefined>;
+  /** Shared value — set to Date.now() when sheet opens, for fresh-open lock. */
+  openTimeSV: SharedValue<number>;
+}
+/**
+ * Builds the pan gesture that drives sheet dragging.
+ *
+ * Handles:
+ * - Drag-to-snap (nearest or velocity-based)
+ * - Drag-to-dismiss (past lowest snap threshold or fast fling)
+ * - Fresh-open lock (prevents accidental drag right after opening)
+ * - Scroll coordination (gates between sheet drag and content scroll)
+ *
+ * Scroll is only unlocked at the max snap point. At non-max snaps, dragging
+ * anywhere on the sheet expands or collapses it. At max snap, content is
+ * scrollable; dragging down from scroll-top collapses the sheet.
+ *
+ * All gesture callbacks run on the UI thread via Reanimated worklets.
+ */
+declare function useBottomSheetDrag({
+  enableDrag,
+  dismissible,
+  enableOverstretch,
+  resolvedSnapPoints,
+  containerHeight,
+  bottomInsetPx,
+  translateY,
+  activeSnapIndex,
+  isAnimating,
+  animateToSnapWorklet,
+  animateToCloseWorklet,
+  onDismiss,
+  scrollLocked,
+  scrollOffsetY,
+  getTranslateYForSnap
+}: UseBottomSheetDragParams): UseBottomSheetDragResult;
+//#endregion
+export { useBottomSheetDrag };
+//# sourceMappingURL=useBottomSheetDrag.d.ts.map

package/dist/components/BottomSheet/useBottomSheetDrag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetDrag.d.ts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetDrag.ts"],"mappings":";;;;;;UA8CU,wBAAA;EACR,UAAA;EACA,WAAA;EACA,iBAAA;EACA,kBAAA,EAAoB,iBAAA;EACpB,eAAA,EAAiB,WAAA;EACjB,aAAA;EACA,UAAA,EAAY,WAAA;EACZ,eAAA,EAAiB,WAAA;EACjB,WAAA,EAAa,WAAA;EACb,oBAAA,GAAuB,KAAA;EACvB,qBAAA;EACA,SAAA;EAI0B;EAF1B,YAAA,EAAc,WAAA;EAZd;EAcA,aAAA,EAAe,WAAA;EAZf;EAcA,oBAAA,GAAuB,KAAA;AAAA;AAAA,UAGf,wBAAA;EAfR;EAiBA,UAAA,EAAY,WAAA;EAhBA;EAkBZ,aAAA,EAAe,KAAA,CAAM,SAAA,CAAU,WAAA;EAjBd;EAmBjB,UAAA,EAAY,WAAA;AAAA;;;;;;;;;;;;;AATwB;;;iBA2B7B,kBAAA,CAAA;EACP,UAAA;EACA,WAAA;EACA,iBAAA;EACA,kBAAA;EACA,eAAA;EACA,aAAA;EACA,UAAA;EACA,eAAA;EACA,WAAA;EACA,oBAAA;EACA,qBAAA;EACA,SAAA;EACA,YAAA;EACA,aAAA;EACA;AAAA,GACC,wBAAA,GAA2B,wBAAA"}

package/dist/components/BottomSheet/useBottomSheetDrag.js

@@ -0,0 +1,190 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { clamp, clampIndex, resolveHeightToPx } from "./utils.js";
+import { useCallback, useRef } from "react";
+import { Platform } from "react-native";
+import { runOnJS, useSharedValue } from "react-native-reanimated";
+import { Gesture } from "react-native-gesture-handler";
+
+//#region src/components/BottomSheet/useBottomSheetDrag.ts
+/**
+* Velocity threshold (px/s) above which a downward fling dismisses the sheet.
+*/
+const DRAG_DISMISS_VELOCITY = 500;
+/**
+* Duration (ms) after opening during which drag is blocked to prevent
+* accidentally stealing scroll intent.
+*/
+const OPEN_LOCK_TIMEOUT_MS = 250;
+/**
+* Horizontal movement (px) that causes the pan gesture to fail,
+* handing control to horizontal scrolling or other gestures.
+*/
+const HORIZONTAL_FAIL_THRESHOLD = 20;
+/**
+* Minimum vertical movement (px) required before deciding whether to
+* activate the pan gesture or let the scroll view handle the touch.
+*/
+const VERTICAL_ACTIVATION_THRESHOLD = 10;
+/**
+* Approximate height (px) of the header area (paddingTop + handle + header row).
+* Touches above this threshold always activate the pan for sheet collapse.
+* Touches below it may defer to the scroll view on Android.
+*/
+const HEADER_AREA_HEIGHT = 64;
+/** How much drag past max snap is visible (0–1). Lower = more resistance. */
+const RUBBER_BAND_FACTOR = .2;
+/** Max enableOverstretch distance (px) past the max snap point. */
+const MAX_OVERSTRETCH_PX = 30;
+/**
+* Builds the pan gesture that drives sheet dragging.
+*
+* Handles:
+* - Drag-to-snap (nearest or velocity-based)
+* - Drag-to-dismiss (past lowest snap threshold or fast fling)
+* - Fresh-open lock (prevents accidental drag right after opening)
+* - Scroll coordination (gates between sheet drag and content scroll)
+*
+* Scroll is only unlocked at the max snap point. At non-max snaps, dragging
+* anywhere on the sheet expands or collapses it. At max snap, content is
+* scrollable; dragging down from scroll-top collapses the sheet.
+*
+* All gesture callbacks run on the UI thread via Reanimated worklets.
+*/
+function useBottomSheetDrag({ enableDrag, dismissible, enableOverstretch, resolvedSnapPoints, containerHeight, bottomInsetPx, translateY, activeSnapIndex, isAnimating, animateToSnapWorklet, animateToCloseWorklet, onDismiss, scrollLocked, scrollOffsetY, getTranslateYForSnap }) {
+	const isDragActive = useSharedValue(false);
+	const touchStartX = useSharedValue(0);
+	const touchStartY = useSharedValue(0);
+	const dragStartTranslateY = useSharedValue(0);
+	const dragStartIndex = useSharedValue(0);
+	const openTimeSV = useSharedValue(0);
+	const panGestureRef = useRef(void 0);
+	const snapCount = resolvedSnapPoints.length;
+	const maxSnapIndex = snapCount - 1;
+	/** Compute all snap translateY positions — worklet. */
+	const getSnapTranslateYs = useCallback(() => {
+		"worklet";
+		const result = [];
+		for (let i = 0; i < snapCount; i++) result.push(getTranslateYForSnap(i));
+		return result;
+	}, [snapCount, getTranslateYForSnap]);
+	/** Dismiss threshold: 25% of the lowest snap height. */
+	const getDismissThreshold = useCallback(() => {
+		"worklet";
+		if (snapCount === 0) return 50;
+		return resolveHeightToPx(resolvedSnapPoints[0], containerHeight.value) * .25;
+	}, [
+		resolvedSnapPoints,
+		snapCount,
+		containerHeight
+	]);
+	const handleDismissJS = useCallback(() => {
+		onDismiss();
+	}, [onDismiss]);
+	return {
+		panGesture: Gesture.Pan().withRef(panGestureRef).manualActivation(true).onTouchesDown((e, _stateManager) => {
+			"worklet";
+			const touch = e.allTouches[0];
+			if (touch) {
+				touchStartX.value = touch.absoluteX;
+				touchStartY.value = touch.absoluteY;
+			}
+		}).onTouchesMove((e, stateManager) => {
+			"worklet";
+			const touch = e.allTouches[0];
+			if (!touch) return;
+			const dx = touch.absoluteX - touchStartX.value;
+			const dy = touch.absoluteY - touchStartY.value;
+			if (Math.abs(dx) > HORIZONTAL_FAIL_THRESHOLD) {
+				stateManager.fail();
+				return;
+			}
+			if (Math.abs(dy) < VERTICAL_ACTIVATION_THRESHOLD) return;
+			const now = Date.now();
+			if (openTimeSV.value > 0 && now - openTimeSV.value < OPEN_LOCK_TIMEOUT_MS) {
+				stateManager.fail();
+				return;
+			}
+			if (isAnimating.value) {
+				stateManager.fail();
+				return;
+			}
+			if (activeSnapIndex.value === maxSnapIndex) {
+				if (dy < 0) {
+					if (!enableOverstretch) {
+						stateManager.fail();
+						return;
+					}
+					if (touchStartY.value - translateY.value > HEADER_AREA_HEIGHT && (Platform.OS === "android" || scrollOffsetY.value > 1)) {
+						stateManager.fail();
+						return;
+					}
+				} else if (Platform.OS === "android" && scrollOffsetY.value > 1) {
+					if (touchStartY.value - translateY.value > HEADER_AREA_HEIGHT) {
+						stateManager.fail();
+						return;
+					}
+				}
+			}
+			stateManager.activate();
+		}).onStart(() => {
+			"worklet";
+			isDragActive.value = true;
+			dragStartTranslateY.value = translateY.value;
+			dragStartIndex.value = activeSnapIndex.value;
+			scrollLocked.value = true;
+		}).onUpdate((event) => {
+			"worklet";
+			if (!isDragActive.value) return;
+			const maxSnapTranslateY = snapCount > 0 ? getTranslateYForSnap(snapCount - 1) : 0;
+			const closedTranslateY = containerHeight.value + bottomInsetPx;
+			const nextY = dragStartTranslateY.value + event.translationY;
+			if (enableOverstretch && nextY < maxSnapTranslateY) {
+				const overflow = maxSnapTranslateY - nextY;
+				translateY.value = maxSnapTranslateY - Math.min(overflow * RUBBER_BAND_FACTOR, MAX_OVERSTRETCH_PX);
+			} else translateY.value = clamp(nextY, maxSnapTranslateY, closedTranslateY);
+		}).onEnd((event) => {
+			"worklet";
+			if (!isDragActive.value) return;
+			isDragActive.value = false;
+			const currentY = translateY.value;
+			const startIndex = dragStartIndex.value;
+			const snapTranslateYs = getSnapTranslateYs();
+			const startSnapY = snapTranslateYs[startIndex] ?? containerHeight.value;
+			const draggedDistance = dragStartTranslateY.value - currentY;
+			const draggedDown = draggedDistance < 0;
+			const draggedUp = draggedDistance > 0;
+			const velocityPxPerSec = Math.abs(event.velocityY);
+			const isAtLowestSnap = startIndex === 0;
+			const dismissThreshold = getDismissThreshold();
+			const draggedDownAmount = currentY - startSnapY;
+			if (dismissible && isAtLowestSnap && draggedDown && (velocityPxPerSec >= DRAG_DISMISS_VELOCITY || draggedDownAmount >= dismissThreshold)) {
+				scrollLocked.value = true;
+				animateToCloseWorklet();
+				runOnJS(handleDismissJS)();
+				return;
+			}
+			if (velocityPxPerSec >= DRAG_DISMISS_VELOCITY && (draggedUp || draggedDown)) {
+				const nextIndex = clampIndex(startIndex + (draggedUp ? 1 : -1), snapCount);
+				scrollLocked.value = nextIndex !== maxSnapIndex;
+				animateToSnapWorklet(nextIndex);
+				return;
+			}
+			const nextIndexInDirection = draggedUp ? Math.min(startIndex + 1, maxSnapIndex) : Math.max(startIndex - 1, 0);
+			const nextSnapY = snapTranslateYs[nextIndexInDirection] ?? startSnapY;
+			const distBetweenSnaps = Math.abs(nextSnapY - startSnapY);
+			const dragDist = Math.abs(currentY - startSnapY);
+			const targetIndex = distBetweenSnaps > 0 && dragDist > distBetweenSnaps * .25 ? nextIndexInDirection : startIndex;
+			scrollLocked.value = targetIndex !== maxSnapIndex;
+			animateToSnapWorklet(targetIndex);
+		}).onFinalize(() => {
+			"worklet";
+			if (isDragActive.value) isDragActive.value = false;
+		}).enabled(enableDrag),
+		panGestureRef,
+		openTimeSV
+	};
+}
+
+//#endregion
+export { useBottomSheetDrag };
+//# sourceMappingURL=useBottomSheetDrag.js.map

package/dist/components/BottomSheet/useBottomSheetDrag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetDrag.js","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetDrag.ts"],"sourcesContent":["import { useCallback, useRef } from 'react';\nimport { Platform } from 'react-native';\nimport type { GestureType } from 'react-native-gesture-handler';\nimport { Gesture } from 'react-native-gesture-handler';\nimport type { SharedValue } from 'react-native-reanimated';\nimport { runOnJS, useSharedValue } from 'react-native-reanimated';\n\nimport type { BottomSheetHeight } from './types';\nimport { clamp, clampIndex, resolveHeightToPx } from './utils';\n\n/**\n * Velocity threshold (px/s) above which a downward fling dismisses the sheet.\n */\nconst DRAG_DISMISS_VELOCITY = 500;\n\n/**\n * Duration (ms) after opening during which drag is blocked to prevent\n * accidentally stealing scroll intent.\n */\nconst OPEN_LOCK_TIMEOUT_MS = 250;\n\n/**\n * Horizontal movement (px) that causes the pan gesture to fail,\n * handing control to horizontal scrolling or other gestures.\n */\nconst HORIZONTAL_FAIL_THRESHOLD = 20;\n\n/**\n * Minimum vertical movement (px) required before deciding whether to\n * activate the pan gesture or let the scroll view handle the touch.\n */\nconst VERTICAL_ACTIVATION_THRESHOLD = 10;\n\n/**\n * Approximate height (px) of the header area (paddingTop + handle + header row).\n * Touches above this threshold always activate the pan for sheet collapse.\n * Touches below it may defer to the scroll view on Android.\n */\nconst HEADER_AREA_HEIGHT = 64;\n\n/** How much drag past max snap is visible (0–1). Lower = more resistance. */\nconst RUBBER_BAND_FACTOR = 0.2;\n\n/** Max enableOverstretch distance (px) past the max snap point. */\nconst MAX_OVERSTRETCH_PX = 30;\n\ninterface UseBottomSheetDragParams {\n  enableDrag: boolean;\n  dismissible: boolean;\n  enableOverstretch: boolean;\n  resolvedSnapPoints: BottomSheetHeight[];\n  containerHeight: SharedValue<number>;\n  bottomInsetPx: number;\n  translateY: SharedValue<number>;\n  activeSnapIndex: SharedValue<number>;\n  isAnimating: SharedValue<boolean>;\n  animateToSnapWorklet: (index: number) => void;\n  animateToCloseWorklet: () => void;\n  onDismiss: () => void;\n  /** Scroll lock — written here, read by BottomSheetContent. */\n  scrollLocked: SharedValue<boolean>;\n  /** Current content scroll offset (UI-thread shared value). */\n  scrollOffsetY: SharedValue<number>;\n  /** Compute translateY for a given snap index (worklet). Provided by the snap model. */\n  getTranslateYForSnap: (index: number) => number;\n}\n\ninterface UseBottomSheetDragResult {\n  /** The pan gesture to attach to GestureDetector. */\n  panGesture: GestureType;\n  /** Ref to the pan gesture — for simultaneousWithExternalGesture in scroll. */\n  panGestureRef: React.RefObject<GestureType | undefined>;\n  /** Shared value — set to Date.now() when sheet opens, for fresh-open lock. */\n  openTimeSV: SharedValue<number>;\n}\n\n/**\n * Builds the pan gesture that drives sheet dragging.\n *\n * Handles:\n * - Drag-to-snap (nearest or velocity-based)\n * - Drag-to-dismiss (past lowest snap threshold or fast fling)\n * - Fresh-open lock (prevents accidental drag right after opening)\n * - Scroll coordination (gates between sheet drag and content scroll)\n *\n * Scroll is only unlocked at the max snap point. At non-max snaps, dragging\n * anywhere on the sheet expands or collapses it. At max snap, content is\n * scrollable; dragging down from scroll-top collapses the sheet.\n *\n * All gesture callbacks run on the UI thread via Reanimated worklets.\n */\nfunction useBottomSheetDrag({\n  enableDrag,\n  dismissible,\n  enableOverstretch,\n  resolvedSnapPoints,\n  containerHeight,\n  bottomInsetPx,\n  translateY,\n  activeSnapIndex,\n  isAnimating,\n  animateToSnapWorklet,\n  animateToCloseWorklet,\n  onDismiss,\n  scrollLocked,\n  scrollOffsetY,\n  getTranslateYForSnap,\n}: UseBottomSheetDragParams): UseBottomSheetDragResult {\n  // Shared values for drag state (UI thread).\n  const isDragActive = useSharedValue(false);\n  const touchStartX = useSharedValue(0);\n  const touchStartY = useSharedValue(0);\n  const dragStartTranslateY = useSharedValue(0);\n  const dragStartIndex = useSharedValue(0);\n  const openTimeSV = useSharedValue(0);\n\n  // Ref for the pan gesture — passed to BottomSheetContent for gesture composition.\n  const panGestureRef = useRef<GestureType | undefined>(undefined);\n\n  const snapCount = resolvedSnapPoints.length;\n  const maxSnapIndex = snapCount - 1;\n\n  /** Compute all snap translateY positions — worklet. */\n  const getSnapTranslateYs = useCallback((): number[] => {\n    'worklet';\n    const result: number[] = [];\n    for (let i = 0; i < snapCount; i++) {\n      result.push(getTranslateYForSnap(i));\n    }\n    return result;\n  }, [snapCount, getTranslateYForSnap]);\n\n  /** Dismiss threshold: 25% of the lowest snap height. */\n  const getDismissThreshold = useCallback((): number => {\n    'worklet';\n    if (snapCount === 0) {\n      return 50;\n    }\n    const lowestSnapHeight = resolveHeightToPx(resolvedSnapPoints[0]!, containerHeight.value);\n    return lowestSnapHeight * 0.25;\n  }, [resolvedSnapPoints, snapCount, containerHeight]);\n\n  const handleDismissJS = useCallback(() => {\n    onDismiss();\n  }, [onDismiss]);\n\n  const panGesture = Gesture.Pan()\n    .withRef(panGestureRef)\n    .manualActivation(true)\n    .onTouchesDown((e, _stateManager) => {\n      'worklet';\n      const touch = e.allTouches[0];\n      if (touch) {\n        touchStartX.value = touch.absoluteX;\n        touchStartY.value = touch.absoluteY;\n      }\n    })\n    .onTouchesMove((e, stateManager) => {\n      'worklet';\n      const touch = e.allTouches[0];\n      if (!touch) {\n        return;\n      }\n\n      const dx = touch.absoluteX - touchStartX.value;\n      const dy = touch.absoluteY - touchStartY.value;\n\n      // Fail on horizontal movement (replaces failOffsetX).\n      if (Math.abs(dx) > HORIZONTAL_FAIL_THRESHOLD) {\n        stateManager.fail();\n        return;\n      }\n\n      // Wait for sufficient vertical movement (replaces activeOffsetY).\n      if (Math.abs(dy) < VERTICAL_ACTIVATION_THRESHOLD) {\n        return;\n      }\n\n      // Fresh-open lock.\n      const now = Date.now();\n      if (openTimeSV.value > 0 && now - openTimeSV.value < OPEN_LOCK_TIMEOUT_MS) {\n        stateManager.fail();\n        return;\n      }\n\n      // Don't activate during animation.\n      if (isAnimating.value) {\n        stateManager.fail();\n        return;\n      }\n\n      const isAtMaxSnap = activeSnapIndex.value === maxSnapIndex;\n\n      if (isAtMaxSnap) {\n        if (dy < 0) {\n          if (!enableOverstretch) {\n            // No enableOverstretch — let the scroll view handle all upward drags.\n            stateManager.fail();\n            return;\n          }\n          // Header/handle: allow rubber-band enableOverstretch.\n          // Content area: defer to scroll view (always on Android,\n          // only when scrolled on iOS).\n          const localY = touchStartY.value - translateY.value;\n          const isInContentArea = localY > HEADER_AREA_HEIGHT;\n          if (isInContentArea && (Platform.OS === 'android' || scrollOffsetY.value > 1)) {\n            stateManager.fail();\n            return;\n          }\n        } else {\n          // Dragging down on Android: defer to scroll view in content\n          // area when scrolled. Header drags always collapse.\n          if (Platform.OS === 'android' && scrollOffsetY.value > 1) {\n            const localY = touchStartY.value - translateY.value;\n            if (localY > HEADER_AREA_HEIGHT) {\n              stateManager.fail();\n              return;\n            }\n          }\n        }\n      }\n\n      stateManager.activate();\n    })\n    .onStart(() => {\n      'worklet';\n      isDragActive.value = true;\n      dragStartTranslateY.value = translateY.value;\n      dragStartIndex.value = activeSnapIndex.value;\n      scrollLocked.value = true;\n    })\n    .onUpdate((event) => {\n      'worklet';\n      if (!isDragActive.value) {\n        return;\n      }\n\n      const maxSnapTranslateY = snapCount > 0 ? getTranslateYForSnap(snapCount - 1) : 0;\n      const closedTranslateY = containerHeight.value + bottomInsetPx;\n\n      const nextY = dragStartTranslateY.value + event.translationY;\n\n      if (enableOverstretch && nextY < maxSnapTranslateY) {\n        // Rubber-band enableOverstretch past max snap.\n        const overflow = maxSnapTranslateY - nextY;\n        const dampedOverflow = Math.min(overflow * RUBBER_BAND_FACTOR, MAX_OVERSTRETCH_PX);\n        translateY.value = maxSnapTranslateY - dampedOverflow;\n      } else {\n        translateY.value = clamp(nextY, maxSnapTranslateY, closedTranslateY);\n      }\n    })\n    .onEnd((event) => {\n      'worklet';\n      if (!isDragActive.value) {\n        return;\n      }\n      isDragActive.value = false;\n\n      const currentY = translateY.value;\n      const startIndex = dragStartIndex.value;\n      const snapTranslateYs = getSnapTranslateYs();\n\n      // Compute drag metrics.\n      const startSnapY = snapTranslateYs[startIndex] ?? containerHeight.value;\n      const draggedDistance = dragStartTranslateY.value - currentY;\n      const draggedDown = draggedDistance < 0;\n      const draggedUp = draggedDistance > 0;\n      const velocityPxPerSec = Math.abs(event.velocityY);\n\n      // 1. Dismiss check: at lowest snap, dragged down, meets threshold.\n      const isAtLowestSnap = startIndex === 0;\n      const dismissThreshold = getDismissThreshold();\n      const draggedDownAmount = currentY - startSnapY;\n\n      if (\n        dismissible &&\n        isAtLowestSnap &&\n        draggedDown &&\n        (velocityPxPerSec >= DRAG_DISMISS_VELOCITY || draggedDownAmount >= dismissThreshold)\n      ) {\n        scrollLocked.value = true;\n        animateToCloseWorklet();\n        runOnJS(handleDismissJS)();\n        return;\n      }\n\n      // 2. Velocity snap: fast enough → move one snap in drag direction.\n      if (velocityPxPerSec >= DRAG_DISMISS_VELOCITY && (draggedUp || draggedDown)) {\n        const direction = draggedUp ? 1 : -1;\n        const nextIndex = clampIndex(startIndex + direction, snapCount);\n        scrollLocked.value = nextIndex !== maxSnapIndex;\n        animateToSnapWorklet(nextIndex);\n        return;\n      }\n\n      // 3. Direction-aware snap: if the user dragged past 25% of the distance\n      //    to the next snap in their drag direction, move to that snap.\n      //    Otherwise snap back to the starting snap.\n      const nextIndexInDirection = draggedUp\n        ? Math.min(startIndex + 1, maxSnapIndex)\n        : Math.max(startIndex - 1, 0);\n      const nextSnapY = snapTranslateYs[nextIndexInDirection] ?? startSnapY;\n      const distBetweenSnaps = Math.abs(nextSnapY - startSnapY);\n      const dragDist = Math.abs(currentY - startSnapY);\n\n      const targetIndex =\n        distBetweenSnaps > 0 && dragDist > distBetweenSnaps * 0.25\n          ? nextIndexInDirection\n          : startIndex;\n\n      scrollLocked.value = targetIndex !== maxSnapIndex;\n      animateToSnapWorklet(targetIndex);\n    })\n    .onFinalize(() => {\n      'worklet';\n      if (isDragActive.value) {\n        isDragActive.value = false;\n      }\n    })\n    .enabled(enableDrag);\n\n  return {\n    panGesture,\n    panGestureRef,\n    openTimeSV,\n  };\n}\n\nexport { useBottomSheetDrag };\n"],"mappings":"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"}

package/dist/components/BottomSheet/useBottomSheetScroll.cjs

@@ -0,0 +1,61 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_components_BottomSheet_BottomSheetInternalProvider = require('./BottomSheetInternalProvider.cjs');
+let react_native_reanimated = require("react-native-reanimated");
+let react_native_gesture_handler = require("react-native-gesture-handler");
+
+//#region src/components/BottomSheet/useBottomSheetScroll.ts
+/**
+* Low-level hook for consumers who need a custom scrollable (e.g. `FlatList`,
+* `SectionList`) instead of `<BottomSheetContent>`.
+*
+* Returns all the props needed to wire a scrollable into the sheet's
+* scroll-lock coordination (scrollEnabled toggle, offset tracking, gesture composition).
+*
+* Must be rendered inside a `<BottomSheet>`.
+*
+* @throws If used outside a `<BottomSheet>` component tree.
+*
+* @returns `{ scrollHandler, scrollableRef, nativeGesture, animatedProps }`
+*
+* @example
+* ```tsx
+* const { scrollHandler, scrollableRef, nativeGesture, animatedProps } = useBottomSheetScroll();
+*
+* <GestureDetector gesture={nativeGesture}>
+*   <Animated.FlatList
+*     ref={scrollableRef}
+*     onScroll={scrollHandler}
+*     scrollEventThrottle={16}
+*     animatedProps={animatedProps}
+*     bounces={false}
+*     overScrollMode="never"
+*     {...otherProps}
+*   />
+* </GestureDetector>
+* ```
+*/
+function useBottomSheetScroll() {
+	const internalCtx = require_components_BottomSheet_BottomSheetInternalProvider.useBottomSheetInternalContext();
+	const scrollableRef = (0, react_native_reanimated.useAnimatedRef)();
+	const animatedProps = (0, react_native_reanimated.useAnimatedProps)(() => ({
+		scrollEnabled: !internalCtx?.scrollLocked.value,
+		decelerationRate: internalCtx?.scrollLocked.value ? 0 : .998
+	}));
+	const scrollHandler = (0, react_native_reanimated.useAnimatedScrollHandler)({ onScroll: (event) => {
+		if (!internalCtx) return;
+		internalCtx.scrollOffsetY.value = event.contentOffset.y;
+	} });
+	if (!internalCtx) throw new Error("useBottomSheetScroll must be used inside a BottomSheet component.");
+	const { panGestureRef } = internalCtx;
+	return {
+		scrollHandler,
+		scrollableRef,
+		nativeGesture: react_native_gesture_handler.Gesture.Native().simultaneousWithExternalGesture(panGestureRef),
+		animatedProps
+	};
+}
+
+//#endregion
+exports.useBottomSheetScroll = useBottomSheetScroll;

package/dist/components/BottomSheet/useBottomSheetScroll.d.cts

@@ -0,0 +1,48 @@
+
+import * as react_native_reanimated0 from "react-native-reanimated";
+import Animated from "react-native-reanimated";
+import * as react_native_gesture_handler_lib_typescript_handlers_gestures_nativeGesture0 from "react-native-gesture-handler/lib/typescript/handlers/gestures/nativeGesture";
+
+//#region src/components/BottomSheet/useBottomSheetScroll.d.ts
+/**
+ * Low-level hook for consumers who need a custom scrollable (e.g. `FlatList`,
+ * `SectionList`) instead of `<BottomSheetContent>`.
+ *
+ * Returns all the props needed to wire a scrollable into the sheet's
+ * scroll-lock coordination (scrollEnabled toggle, offset tracking, gesture composition).
+ *
+ * Must be rendered inside a `<BottomSheet>`.
+ *
+ * @throws If used outside a `<BottomSheet>` component tree.
+ *
+ * @returns `{ scrollHandler, scrollableRef, nativeGesture, animatedProps }`
+ *
+ * @example
+ * ```tsx
+ * const { scrollHandler, scrollableRef, nativeGesture, animatedProps } = useBottomSheetScroll();
+ *
+ * <GestureDetector gesture={nativeGesture}>
+ *   <Animated.FlatList
+ *     ref={scrollableRef}
+ *     onScroll={scrollHandler}
+ *     scrollEventThrottle={16}
+ *     animatedProps={animatedProps}
+ *     bounces={false}
+ *     overScrollMode="never"
+ *     {...otherProps}
+ *   />
+ * </GestureDetector>
+ * ```
+ */
+declare function useBottomSheetScroll(): {
+  scrollHandler: react_native_reanimated0.ScrollHandlerProcessed<Record<string, unknown>>;
+  scrollableRef: react_native_reanimated0.AnimatedRef<Animated.ScrollView>;
+  nativeGesture: react_native_gesture_handler_lib_typescript_handlers_gestures_nativeGesture0.NativeGesture;
+  animatedProps: Partial<{
+    scrollEnabled: boolean;
+    decelerationRate: number;
+  }>;
+};
+//#endregion
+export { useBottomSheetScroll };
+//# sourceMappingURL=useBottomSheetScroll.d.cts.map