@yahoo/uds-mobile 2.3.3 → 2.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetScroll.d.cts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetScroll.ts"],"mappings":";;;;;;;;;;AACoD;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuC3C,oBAAA,CAAA"}

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

@@ -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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetScroll.d.ts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetScroll.ts"],"mappings":";;;;;;;;;;AACoD;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuC3C,oBAAA,CAAA"}

package/dist/components/BottomSheet/useBottomSheetScroll.js

@@ -0,0 +1,60 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { useBottomSheetInternalContext } from "./BottomSheetInternalProvider.js";
+import { useAnimatedProps, useAnimatedRef, useAnimatedScrollHandler } from "react-native-reanimated";
+import { Gesture } from "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 = useBottomSheetInternalContext();
+	const scrollableRef = useAnimatedRef();
+	const animatedProps = useAnimatedProps(() => ({
+		scrollEnabled: !internalCtx?.scrollLocked.value,
+		decelerationRate: internalCtx?.scrollLocked.value ? 0 : .998
+	}));
+	const scrollHandler = 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: Gesture.Native().simultaneousWithExternalGesture(panGestureRef),
+		animatedProps
+	};
+}
+
+//#endregion
+export { useBottomSheetScroll };
+//# sourceMappingURL=useBottomSheetScroll.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetScroll.js","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetScroll.ts"],"sourcesContent":["import { Gesture } from 'react-native-gesture-handler';\nimport type Animated from 'react-native-reanimated';\nimport {\n  useAnimatedProps,\n  useAnimatedRef,\n  useAnimatedScrollHandler,\n} from 'react-native-reanimated';\n\nimport { useBottomSheetInternalContext } from './BottomSheetInternalProvider';\n\n/**\n * Low-level hook for consumers who need a custom scrollable (e.g. `FlatList`,\n * `SectionList`) instead of `<BottomSheetContent>`.\n *\n * Returns all the props needed to wire a scrollable into the sheet's\n * scroll-lock coordination (scrollEnabled toggle, offset tracking, gesture composition).\n *\n * Must be rendered inside a `<BottomSheet>`.\n *\n * @throws If used outside a `<BottomSheet>` component tree.\n *\n * @returns `{ scrollHandler, scrollableRef, nativeGesture, animatedProps }`\n *\n * @example\n * ```tsx\n * const { scrollHandler, scrollableRef, nativeGesture, animatedProps } = useBottomSheetScroll();\n *\n * <GestureDetector gesture={nativeGesture}>\n *   <Animated.FlatList\n *     ref={scrollableRef}\n *     onScroll={scrollHandler}\n *     scrollEventThrottle={16}\n *     animatedProps={animatedProps}\n *     bounces={false}\n *     overScrollMode=\"never\"\n *     {...otherProps}\n *   />\n * </GestureDetector>\n * ```\n */\nfunction useBottomSheetScroll() {\n  const internalCtx = useBottomSheetInternalContext();\n  const scrollableRef = useAnimatedRef<Animated.ScrollView>();\n\n  const animatedProps = useAnimatedProps(() => ({\n    scrollEnabled: !internalCtx?.scrollLocked.value,\n    decelerationRate: internalCtx?.scrollLocked.value ? 0 : 0.998,\n  }));\n\n  const scrollHandler = useAnimatedScrollHandler({\n    onScroll: (event) => {\n      if (!internalCtx) {\n        return;\n      }\n      internalCtx.scrollOffsetY.value = event.contentOffset.y;\n    },\n  });\n\n  if (!internalCtx) {\n    throw new Error('useBottomSheetScroll must be used inside a BottomSheet component.');\n  }\n\n  const { panGestureRef } = internalCtx;\n\n  const nativeGesture = Gesture.Native().simultaneousWithExternalGesture(panGestureRef);\n\n  return {\n    scrollHandler,\n    scrollableRef,\n    nativeGesture,\n    animatedProps,\n  };\n}\n\nexport { useBottomSheetScroll };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAS,uBAAuB;CAC9B,MAAM,cAAc,+BAA+B;CACnD,MAAM,gBAAgB,gBAAqC;CAE3D,MAAM,gBAAgB,wBAAwB;EAC5C,eAAe,CAAC,aAAa,aAAa;EAC1C,kBAAkB,aAAa,aAAa,QAAQ,IAAI;EACzD,EAAE;CAEH,MAAM,gBAAgB,yBAAyB,EAC7C,WAAW,UAAU;AACnB,MAAI,CAAC,YACH;AAEF,cAAY,cAAc,QAAQ,MAAM,cAAc;IAEzD,CAAC;AAEF,KAAI,CAAC,YACH,OAAM,IAAI,MAAM,oEAAoE;CAGtF,MAAM,EAAE,kBAAkB;AAI1B,QAAO;EACL;EACA;EACA,eALoB,QAAQ,QAAQ,CAAC,gCAAgC,cAAc;EAMnF;EACD"}

package/dist/components/BottomSheet/useBottomSheetSnapModel.cjs

@@ -0,0 +1,142 @@
+/*! © 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_motion = require('../../motion.cjs');
+const require_components_BottomSheet_utils = require('./utils.cjs');
+let react = require("react");
+let react_native_reanimated = require("react-native-reanimated");
+
+//#region src/components/BottomSheet/useBottomSheetSnapModel.ts
+/**
+* Spring configuration for sheet snap/close animations.
+* Uses the UDS `smooth['3']` motion preset.
+*/
+const SHEET_SPRING_CONFIG = {
+	damping: require_motion.MOTION_CONFIG.smooth["3"].damping,
+	stiffness: require_motion.MOTION_CONFIG.smooth["3"].stiffness,
+	mass: 1
+};
+/**
+* Manages the snap-point position model for the bottom sheet.
+*
+* Resolves snap point strings to pixel positions, provides spring-animated
+* `animateToSnap` / `animateToClose` functions for both JS and UI threads,
+* and exposes shared values for `translateY`, `activeSnapIndex`, and `isAnimating`.
+*
+* Position model: `translateY = containerHeight - snapHeightPx - bottomInsetPx`
+*/
+function useBottomSheetSnapModel({ snapPointsProp, height, defaultSnapPointIndex, snapPointIndexProp, onSnapPointChange, containerHeight, bottomInsetPx, topInsetPx, fullWidthAtMaxSnap, expandedBottomInsetPx }) {
+	const resolvedSnapPoints = (0, react.useMemo)(() => {
+		if (snapPointsProp?.length) return snapPointsProp;
+		if (height !== void 0) return [height];
+		return [require_components_BottomSheet_utils.DEFAULT_SNAP_POINT];
+	}, [height, snapPointsProp]);
+	const translateY = (0, react_native_reanimated.useSharedValue)(9999);
+	const activeSnapIndex = (0, react_native_reanimated.useSharedValue)(require_components_BottomSheet_utils.clampIndex(snapPointIndexProp ?? defaultSnapPointIndex, resolvedSnapPoints.length));
+	const isAnimating = (0, react_native_reanimated.useSharedValue)(false);
+	/**
+	* Compute translateY for a snap index.
+	* Position model: translateY = containerHeight - snapHeightPx - bottomInsetPx
+	*/
+	const getTranslateYForSnap = (0, react.useCallback)((index) => {
+		"worklet";
+		const clamped = require_components_BottomSheet_utils.clampIndex(index, resolvedSnapPoints.length);
+		const sp = resolvedSnapPoints[clamped];
+		const heightPx = require_components_BottomSheet_utils.resolveHeightToPx(sp, containerHeight.value);
+		const effectiveBottomInset = fullWidthAtMaxSnap && clamped === resolvedSnapPoints.length - 1 ? expandedBottomInsetPx : bottomInsetPx;
+		const maxHeight = containerHeight.value - effectiveBottomInset - topInsetPx;
+		const clampedHeight = Math.max(0, Math.min(heightPx, maxHeight));
+		return containerHeight.value - clampedHeight - effectiveBottomInset;
+	}, [
+		resolvedSnapPoints,
+		containerHeight,
+		bottomInsetPx,
+		topInsetPx,
+		fullWidthAtMaxSnap,
+		expandedBottomInsetPx
+	]);
+	/** Compute the closed (off-screen) translateY. */
+	const getClosedTranslateY = (0, react.useCallback)(() => {
+		"worklet";
+		return containerHeight.value + bottomInsetPx;
+	}, [containerHeight, bottomInsetPx]);
+	/** Emit snap point change callback on the JS thread. */
+	const emitSnapChange = (0, react.useCallback)((index) => {
+		onSnapPointChange?.(index, resolvedSnapPoints[index]);
+	}, [onSnapPointChange, resolvedSnapPoints]);
+	return {
+		resolvedSnapPoints,
+		translateY,
+		activeSnapIndex,
+		isAnimating,
+		getTranslateYForSnap,
+		getClosedTranslateY,
+		animateToSnap: (0, react.useCallback)((index) => {
+			const clamped = require_components_BottomSheet_utils.clampIndex(index, resolvedSnapPoints.length);
+			const targetY = getTranslateYForSnap(clamped);
+			isAnimating.value = true;
+			activeSnapIndex.value = clamped;
+			translateY.value = (0, react_native_reanimated.withSpring)(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				"worklet";
+				if (finished) isAnimating.value = false;
+			});
+			emitSnapChange(clamped);
+		}, [
+			resolvedSnapPoints,
+			getTranslateYForSnap,
+			isAnimating,
+			activeSnapIndex,
+			translateY,
+			emitSnapChange
+		]),
+		animateToClose: (0, react.useCallback)((onComplete) => {
+			const targetY = getClosedTranslateY();
+			isAnimating.value = true;
+			translateY.value = (0, react_native_reanimated.withSpring)(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				"worklet";
+				if (finished) {
+					isAnimating.value = false;
+					if (onComplete) (0, react_native_reanimated.runOnJS)(onComplete)();
+				}
+			});
+		}, [
+			getClosedTranslateY,
+			isAnimating,
+			translateY
+		]),
+		animateToSnapWorklet: (0, react.useCallback)((index) => {
+			"worklet";
+			const clamped = require_components_BottomSheet_utils.clampIndex(index, resolvedSnapPoints.length);
+			const targetY = getTranslateYForSnap(clamped);
+			isAnimating.value = true;
+			activeSnapIndex.value = clamped;
+			translateY.value = (0, react_native_reanimated.withSpring)(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				if (finished) isAnimating.value = false;
+			});
+			(0, react_native_reanimated.runOnJS)(emitSnapChange)(clamped);
+		}, [
+			resolvedSnapPoints,
+			getTranslateYForSnap,
+			isAnimating,
+			activeSnapIndex,
+			translateY,
+			emitSnapChange
+		]),
+		animateToCloseWorklet: (0, react.useCallback)(() => {
+			"worklet";
+			const targetY = getClosedTranslateY();
+			isAnimating.value = true;
+			translateY.value = (0, react_native_reanimated.withSpring)(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				if (finished) isAnimating.value = false;
+			});
+		}, [
+			getClosedTranslateY,
+			isAnimating,
+			translateY
+		])
+	};
+}
+
+//#endregion
+exports.SHEET_SPRING_CONFIG = SHEET_SPRING_CONFIG;
+exports.useBottomSheetSnapModel = useBottomSheetSnapModel;

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

@@ -0,0 +1,79 @@
+
+import { BottomSheetHeight } from "./types.cjs";
+import { SharedValue } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useBottomSheetSnapModel.d.ts
+/**
+ * Spring configuration for sheet snap/close animations.
+ * Uses the UDS `smooth['3']` motion preset.
+ */
+declare const SHEET_SPRING_CONFIG: {
+  readonly damping: number;
+  readonly stiffness: number;
+  readonly mass: 1;
+};
+/** @internal */
+interface UseBottomSheetSnapModelParams {
+  snapPointsProp?: BottomSheetHeight[];
+  height?: BottomSheetHeight;
+  defaultSnapPointIndex: number;
+  snapPointIndexProp?: number;
+  onSnapPointChange?: (index: number, height: BottomSheetHeight) => void;
+  containerHeight: SharedValue<number>;
+  /** Bottom inset in px (margin + safe area). */
+  bottomInsetPx: number;
+  /** Top safe-area inset in px — limits maximum sheet height. */
+  topInsetPx: number;
+  /** Horizontal margin in px (currently informational, not used in snap math). */
+  sideInsetPx: number;
+  /** Whether margins collapse at the max snap point. */
+  fullWidthAtMaxSnap: boolean;
+  /** Bottom inset at max snap when fullWidthAtMaxSnap (safe area only, no margin). */
+  expandedBottomInsetPx: number;
+}
+interface UseBottomSheetSnapModelResult {
+  /** The resolved snap points array. */
+  resolvedSnapPoints: BottomSheetHeight[];
+  /** Animated translateY position of the sheet. */
+  translateY: SharedValue<number>;
+  /** Current active snap index. */
+  activeSnapIndex: SharedValue<number>;
+  /** Whether the sheet is currently animating. */
+  isAnimating: SharedValue<boolean>;
+  /** Compute translateY for a given snap index (worklet). */
+  getTranslateYForSnap: (index: number) => number;
+  /** Compute the closed translateY position (worklet). */
+  getClosedTranslateY: () => number;
+  /** Animate to a specific snap index. */
+  animateToSnap: (index: number) => void;
+  /** Animate to the closed position. Optional callback fires on JS thread when complete. */
+  animateToClose: (onComplete?: () => void) => void;
+  /** Animate to a specific snap index from within a worklet. */
+  animateToSnapWorklet: (index: number) => void;
+  /** Animate to the closed position from within a worklet. */
+  animateToCloseWorklet: () => void;
+}
+/**
+ * Manages the snap-point position model for the bottom sheet.
+ *
+ * Resolves snap point strings to pixel positions, provides spring-animated
+ * `animateToSnap` / `animateToClose` functions for both JS and UI threads,
+ * and exposes shared values for `translateY`, `activeSnapIndex`, and `isAnimating`.
+ *
+ * Position model: `translateY = containerHeight - snapHeightPx - bottomInsetPx`
+ */
+declare function useBottomSheetSnapModel({
+  snapPointsProp,
+  height,
+  defaultSnapPointIndex,
+  snapPointIndexProp,
+  onSnapPointChange,
+  containerHeight,
+  bottomInsetPx,
+  topInsetPx,
+  fullWidthAtMaxSnap,
+  expandedBottomInsetPx
+}: UseBottomSheetSnapModelParams): UseBottomSheetSnapModelResult;
+//#endregion
+export { SHEET_SPRING_CONFIG, useBottomSheetSnapModel };
+//# sourceMappingURL=useBottomSheetSnapModel.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetSnapModel.d.cts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetSnapModel.ts"],"mappings":";;;;;;;AAKiD;;cAO3C,mBAAA;EAAA;;;;;UAOI,6BAAA;EACR,cAAA,GAAiB,iBAAA;EACjB,MAAA,GAAS,iBAAA;EACT,qBAAA;EACA,kBAAA;EACA,iBAAA,IAAqB,KAAA,UAAe,MAAA,EAAQ,iBAAA;EAC5C,eAAA,EAAiB,WAAA;EAAA;EAEjB,aAAA;EAF4B;EAI5B,UAAA;EATiB;EAWjB,WAAA;EAVS;EAYT,kBAAA;EAVA;EAYA,qBAAA;AAAA;AAAA,UAGQ,6BAAA;EAd4B;EAgBpC,kBAAA,EAAoB,iBAAA;EAfH;EAiBjB,UAAA,EAAY,WAAA;EAbZ;EAeA,eAAA,EAAiB,WAAA;EAXjB;EAaA,WAAA,EAAa,WAAA;EAXQ;EAarB,oBAAA,GAAuB,KAAA;EAVf;EAYR,mBAAA;;EAEA,aAAA,GAAgB,KAAA;EAVJ;EAYZ,cAAA,GAAiB,UAAA;EARJ;EAUb,oBAAA,GAAuB,KAAA;EAVC;EAYxB,qBAAA;AAAA;;;;;;;;;;iBAYO,uBAAA,CAAA;EACP,cAAA;EACA,MAAA;EACA,qBAAA;EACA,kBAAA;EACA,iBAAA;EACA,eAAA;EACA,aAAA;EACA,UAAA;EACA,kBAAA;EACA;AAAA,GACC,6BAAA,GAAgC,6BAAA"}

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

@@ -0,0 +1,79 @@
+
+import { BottomSheetHeight } from "./types.js";
+import { SharedValue } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useBottomSheetSnapModel.d.ts
+/**
+ * Spring configuration for sheet snap/close animations.
+ * Uses the UDS `smooth['3']` motion preset.
+ */
+declare const SHEET_SPRING_CONFIG: {
+  readonly damping: number;
+  readonly stiffness: number;
+  readonly mass: 1;
+};
+/** @internal */
+interface UseBottomSheetSnapModelParams {
+  snapPointsProp?: BottomSheetHeight[];
+  height?: BottomSheetHeight;
+  defaultSnapPointIndex: number;
+  snapPointIndexProp?: number;
+  onSnapPointChange?: (index: number, height: BottomSheetHeight) => void;
+  containerHeight: SharedValue<number>;
+  /** Bottom inset in px (margin + safe area). */
+  bottomInsetPx: number;
+  /** Top safe-area inset in px — limits maximum sheet height. */
+  topInsetPx: number;
+  /** Horizontal margin in px (currently informational, not used in snap math). */
+  sideInsetPx: number;
+  /** Whether margins collapse at the max snap point. */
+  fullWidthAtMaxSnap: boolean;
+  /** Bottom inset at max snap when fullWidthAtMaxSnap (safe area only, no margin). */
+  expandedBottomInsetPx: number;
+}
+interface UseBottomSheetSnapModelResult {
+  /** The resolved snap points array. */
+  resolvedSnapPoints: BottomSheetHeight[];
+  /** Animated translateY position of the sheet. */
+  translateY: SharedValue<number>;
+  /** Current active snap index. */
+  activeSnapIndex: SharedValue<number>;
+  /** Whether the sheet is currently animating. */
+  isAnimating: SharedValue<boolean>;
+  /** Compute translateY for a given snap index (worklet). */
+  getTranslateYForSnap: (index: number) => number;
+  /** Compute the closed translateY position (worklet). */
+  getClosedTranslateY: () => number;
+  /** Animate to a specific snap index. */
+  animateToSnap: (index: number) => void;
+  /** Animate to the closed position. Optional callback fires on JS thread when complete. */
+  animateToClose: (onComplete?: () => void) => void;
+  /** Animate to a specific snap index from within a worklet. */
+  animateToSnapWorklet: (index: number) => void;
+  /** Animate to the closed position from within a worklet. */
+  animateToCloseWorklet: () => void;
+}
+/**
+ * Manages the snap-point position model for the bottom sheet.
+ *
+ * Resolves snap point strings to pixel positions, provides spring-animated
+ * `animateToSnap` / `animateToClose` functions for both JS and UI threads,
+ * and exposes shared values for `translateY`, `activeSnapIndex`, and `isAnimating`.
+ *
+ * Position model: `translateY = containerHeight - snapHeightPx - bottomInsetPx`
+ */
+declare function useBottomSheetSnapModel({
+  snapPointsProp,
+  height,
+  defaultSnapPointIndex,
+  snapPointIndexProp,
+  onSnapPointChange,
+  containerHeight,
+  bottomInsetPx,
+  topInsetPx,
+  fullWidthAtMaxSnap,
+  expandedBottomInsetPx
+}: UseBottomSheetSnapModelParams): UseBottomSheetSnapModelResult;
+//#endregion
+export { SHEET_SPRING_CONFIG, useBottomSheetSnapModel };
+//# sourceMappingURL=useBottomSheetSnapModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetSnapModel.d.ts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetSnapModel.ts"],"mappings":";;;;;;;AAKiD;;cAO3C,mBAAA;EAAA;;;;;UAOI,6BAAA;EACR,cAAA,GAAiB,iBAAA;EACjB,MAAA,GAAS,iBAAA;EACT,qBAAA;EACA,kBAAA;EACA,iBAAA,IAAqB,KAAA,UAAe,MAAA,EAAQ,iBAAA;EAC5C,eAAA,EAAiB,WAAA;EAAA;EAEjB,aAAA;EAF4B;EAI5B,UAAA;EATiB;EAWjB,WAAA;EAVS;EAYT,kBAAA;EAVA;EAYA,qBAAA;AAAA;AAAA,UAGQ,6BAAA;EAd4B;EAgBpC,kBAAA,EAAoB,iBAAA;EAfH;EAiBjB,UAAA,EAAY,WAAA;EAbZ;EAeA,eAAA,EAAiB,WAAA;EAXjB;EAaA,WAAA,EAAa,WAAA;EAXQ;EAarB,oBAAA,GAAuB,KAAA;EAVf;EAYR,mBAAA;;EAEA,aAAA,GAAgB,KAAA;EAVJ;EAYZ,cAAA,GAAiB,UAAA;EARJ;EAUb,oBAAA,GAAuB,KAAA;EAVC;EAYxB,qBAAA;AAAA;;;;;;;;;;iBAYO,uBAAA,CAAA;EACP,cAAA;EACA,MAAA;EACA,qBAAA;EACA,kBAAA;EACA,iBAAA;EACA,eAAA;EACA,aAAA;EACA,UAAA;EACA,kBAAA;EACA;AAAA,GACC,6BAAA,GAAgC,6BAAA"}

package/dist/components/BottomSheet/useBottomSheetSnapModel.js

@@ -0,0 +1,140 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { MOTION_CONFIG } from "../../motion.js";
+import { DEFAULT_SNAP_POINT, clampIndex, resolveHeightToPx } from "./utils.js";
+import { useCallback, useMemo } from "react";
+import { runOnJS, useSharedValue, withSpring } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useBottomSheetSnapModel.ts
+/**
+* Spring configuration for sheet snap/close animations.
+* Uses the UDS `smooth['3']` motion preset.
+*/
+const SHEET_SPRING_CONFIG = {
+	damping: MOTION_CONFIG.smooth["3"].damping,
+	stiffness: MOTION_CONFIG.smooth["3"].stiffness,
+	mass: 1
+};
+/**
+* Manages the snap-point position model for the bottom sheet.
+*
+* Resolves snap point strings to pixel positions, provides spring-animated
+* `animateToSnap` / `animateToClose` functions for both JS and UI threads,
+* and exposes shared values for `translateY`, `activeSnapIndex`, and `isAnimating`.
+*
+* Position model: `translateY = containerHeight - snapHeightPx - bottomInsetPx`
+*/
+function useBottomSheetSnapModel({ snapPointsProp, height, defaultSnapPointIndex, snapPointIndexProp, onSnapPointChange, containerHeight, bottomInsetPx, topInsetPx, fullWidthAtMaxSnap, expandedBottomInsetPx }) {
+	const resolvedSnapPoints = useMemo(() => {
+		if (snapPointsProp?.length) return snapPointsProp;
+		if (height !== void 0) return [height];
+		return [DEFAULT_SNAP_POINT];
+	}, [height, snapPointsProp]);
+	const translateY = useSharedValue(9999);
+	const activeSnapIndex = useSharedValue(clampIndex(snapPointIndexProp ?? defaultSnapPointIndex, resolvedSnapPoints.length));
+	const isAnimating = useSharedValue(false);
+	/**
+	* Compute translateY for a snap index.
+	* Position model: translateY = containerHeight - snapHeightPx - bottomInsetPx
+	*/
+	const getTranslateYForSnap = useCallback((index) => {
+		"worklet";
+		const clamped = clampIndex(index, resolvedSnapPoints.length);
+		const sp = resolvedSnapPoints[clamped];
+		const heightPx = resolveHeightToPx(sp, containerHeight.value);
+		const effectiveBottomInset = fullWidthAtMaxSnap && clamped === resolvedSnapPoints.length - 1 ? expandedBottomInsetPx : bottomInsetPx;
+		const maxHeight = containerHeight.value - effectiveBottomInset - topInsetPx;
+		const clampedHeight = Math.max(0, Math.min(heightPx, maxHeight));
+		return containerHeight.value - clampedHeight - effectiveBottomInset;
+	}, [
+		resolvedSnapPoints,
+		containerHeight,
+		bottomInsetPx,
+		topInsetPx,
+		fullWidthAtMaxSnap,
+		expandedBottomInsetPx
+	]);
+	/** Compute the closed (off-screen) translateY. */
+	const getClosedTranslateY = useCallback(() => {
+		"worklet";
+		return containerHeight.value + bottomInsetPx;
+	}, [containerHeight, bottomInsetPx]);
+	/** Emit snap point change callback on the JS thread. */
+	const emitSnapChange = useCallback((index) => {
+		onSnapPointChange?.(index, resolvedSnapPoints[index]);
+	}, [onSnapPointChange, resolvedSnapPoints]);
+	return {
+		resolvedSnapPoints,
+		translateY,
+		activeSnapIndex,
+		isAnimating,
+		getTranslateYForSnap,
+		getClosedTranslateY,
+		animateToSnap: useCallback((index) => {
+			const clamped = clampIndex(index, resolvedSnapPoints.length);
+			const targetY = getTranslateYForSnap(clamped);
+			isAnimating.value = true;
+			activeSnapIndex.value = clamped;
+			translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				"worklet";
+				if (finished) isAnimating.value = false;
+			});
+			emitSnapChange(clamped);
+		}, [
+			resolvedSnapPoints,
+			getTranslateYForSnap,
+			isAnimating,
+			activeSnapIndex,
+			translateY,
+			emitSnapChange
+		]),
+		animateToClose: useCallback((onComplete) => {
+			const targetY = getClosedTranslateY();
+			isAnimating.value = true;
+			translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				"worklet";
+				if (finished) {
+					isAnimating.value = false;
+					if (onComplete) runOnJS(onComplete)();
+				}
+			});
+		}, [
+			getClosedTranslateY,
+			isAnimating,
+			translateY
+		]),
+		animateToSnapWorklet: useCallback((index) => {
+			"worklet";
+			const clamped = clampIndex(index, resolvedSnapPoints.length);
+			const targetY = getTranslateYForSnap(clamped);
+			isAnimating.value = true;
+			activeSnapIndex.value = clamped;
+			translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				if (finished) isAnimating.value = false;
+			});
+			runOnJS(emitSnapChange)(clamped);
+		}, [
+			resolvedSnapPoints,
+			getTranslateYForSnap,
+			isAnimating,
+			activeSnapIndex,
+			translateY,
+			emitSnapChange
+		]),
+		animateToCloseWorklet: useCallback(() => {
+			"worklet";
+			const targetY = getClosedTranslateY();
+			isAnimating.value = true;
+			translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {
+				if (finished) isAnimating.value = false;
+			});
+		}, [
+			getClosedTranslateY,
+			isAnimating,
+			translateY
+		])
+	};
+}
+
+//#endregion
+export { SHEET_SPRING_CONFIG, useBottomSheetSnapModel };
+//# sourceMappingURL=useBottomSheetSnapModel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetSnapModel.js","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetSnapModel.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport type { SharedValue } from 'react-native-reanimated';\nimport { runOnJS, useSharedValue, withSpring } from 'react-native-reanimated';\n\nimport { MOTION_CONFIG } from '../../motion';\nimport type { BottomSheetHeight } from './types';\nimport { clampIndex, DEFAULT_SNAP_POINT, resolveHeightToPx } from './utils';\n\n/**\n * Spring configuration for sheet snap/close animations.\n * Uses the UDS `smooth['3']` motion preset.\n */\nconst SHEET_SPRING_CONFIG = {\n  damping: MOTION_CONFIG.smooth['3'].damping,\n  stiffness: MOTION_CONFIG.smooth['3'].stiffness,\n  mass: 1,\n} as const;\n\n/** @internal */\ninterface UseBottomSheetSnapModelParams {\n  snapPointsProp?: BottomSheetHeight[];\n  height?: BottomSheetHeight;\n  defaultSnapPointIndex: number;\n  snapPointIndexProp?: number;\n  onSnapPointChange?: (index: number, height: BottomSheetHeight) => void;\n  containerHeight: SharedValue<number>;\n  /** Bottom inset in px (margin + safe area). */\n  bottomInsetPx: number;\n  /** Top safe-area inset in px — limits maximum sheet height. */\n  topInsetPx: number;\n  /** Horizontal margin in px (currently informational, not used in snap math). */\n  sideInsetPx: number;\n  /** Whether margins collapse at the max snap point. */\n  fullWidthAtMaxSnap: boolean;\n  /** Bottom inset at max snap when fullWidthAtMaxSnap (safe area only, no margin). */\n  expandedBottomInsetPx: number;\n}\n\ninterface UseBottomSheetSnapModelResult {\n  /** The resolved snap points array. */\n  resolvedSnapPoints: BottomSheetHeight[];\n  /** Animated translateY position of the sheet. */\n  translateY: SharedValue<number>;\n  /** Current active snap index. */\n  activeSnapIndex: SharedValue<number>;\n  /** Whether the sheet is currently animating. */\n  isAnimating: SharedValue<boolean>;\n  /** Compute translateY for a given snap index (worklet). */\n  getTranslateYForSnap: (index: number) => number;\n  /** Compute the closed translateY position (worklet). */\n  getClosedTranslateY: () => number;\n  /** Animate to a specific snap index. */\n  animateToSnap: (index: number) => void;\n  /** Animate to the closed position. Optional callback fires on JS thread when complete. */\n  animateToClose: (onComplete?: () => void) => void;\n  /** Animate to a specific snap index from within a worklet. */\n  animateToSnapWorklet: (index: number) => void;\n  /** Animate to the closed position from within a worklet. */\n  animateToCloseWorklet: () => void;\n}\n\n/**\n * Manages the snap-point position model for the bottom sheet.\n *\n * Resolves snap point strings to pixel positions, provides spring-animated\n * `animateToSnap` / `animateToClose` functions for both JS and UI threads,\n * and exposes shared values for `translateY`, `activeSnapIndex`, and `isAnimating`.\n *\n * Position model: `translateY = containerHeight - snapHeightPx - bottomInsetPx`\n */\nfunction useBottomSheetSnapModel({\n  snapPointsProp,\n  height,\n  defaultSnapPointIndex,\n  snapPointIndexProp,\n  onSnapPointChange,\n  containerHeight,\n  bottomInsetPx,\n  topInsetPx,\n  fullWidthAtMaxSnap,\n  expandedBottomInsetPx,\n}: UseBottomSheetSnapModelParams): UseBottomSheetSnapModelResult {\n  const resolvedSnapPoints = useMemo<BottomSheetHeight[]>(() => {\n    if (snapPointsProp?.length) {\n      return snapPointsProp;\n    }\n    if (height !== undefined) {\n      return [height];\n    }\n    return [DEFAULT_SNAP_POINT];\n  }, [height, snapPointsProp]);\n\n  // Start off-screen (will be set to closed position on first layout).\n  const translateY = useSharedValue(9999);\n  const activeSnapIndex = useSharedValue(\n    clampIndex(snapPointIndexProp ?? defaultSnapPointIndex, resolvedSnapPoints.length),\n  );\n  const isAnimating = useSharedValue(false);\n\n  /**\n   * Compute translateY for a snap index.\n   * Position model: translateY = containerHeight - snapHeightPx - bottomInsetPx\n   */\n  const getTranslateYForSnap = useCallback(\n    (index: number): number => {\n      'worklet';\n      const clamped = clampIndex(index, resolvedSnapPoints.length);\n      const sp = resolvedSnapPoints[clamped]!;\n      const heightPx = resolveHeightToPx(sp, containerHeight.value);\n      // At max snap with fullWidthAtMaxSnap, margins collapse so use reduced bottom inset.\n      const isExpandedMaxSnap = fullWidthAtMaxSnap && clamped === resolvedSnapPoints.length - 1;\n      const effectiveBottomInset = isExpandedMaxSnap ? expandedBottomInsetPx : bottomInsetPx;\n      const maxHeight = containerHeight.value - effectiveBottomInset - topInsetPx;\n      const clampedHeight = Math.max(0, Math.min(heightPx, maxHeight));\n      return containerHeight.value - clampedHeight - effectiveBottomInset;\n    },\n    [\n      resolvedSnapPoints,\n      containerHeight,\n      bottomInsetPx,\n      topInsetPx,\n      fullWidthAtMaxSnap,\n      expandedBottomInsetPx,\n    ],\n  );\n\n  /** Compute the closed (off-screen) translateY. */\n  const getClosedTranslateY = useCallback((): number => {\n    'worklet';\n    return containerHeight.value + bottomInsetPx;\n  }, [containerHeight, bottomInsetPx]);\n\n  /** Emit snap point change callback on the JS thread. */\n  const emitSnapChange = useCallback(\n    (index: number) => {\n      onSnapPointChange?.(index, resolvedSnapPoints[index]!);\n    },\n    [onSnapPointChange, resolvedSnapPoints],\n  );\n\n  /** Animate to snap index — call from JS thread. */\n  const animateToSnap = useCallback(\n    (index: number) => {\n      const clamped = clampIndex(index, resolvedSnapPoints.length);\n      const targetY = getTranslateYForSnap(clamped);\n\n      isAnimating.value = true;\n      activeSnapIndex.value = clamped;\n      translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {\n        'worklet';\n        if (finished) {\n          isAnimating.value = false;\n        }\n      });\n\n      emitSnapChange(clamped);\n    },\n    [\n      resolvedSnapPoints,\n      getTranslateYForSnap,\n      isAnimating,\n      activeSnapIndex,\n      translateY,\n      emitSnapChange,\n    ],\n  );\n\n  /** Animate to closed position — call from JS thread. */\n  const animateToClose = useCallback(\n    (onComplete?: () => void) => {\n      const targetY = getClosedTranslateY();\n      isAnimating.value = true;\n      translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {\n        'worklet';\n        if (finished) {\n          isAnimating.value = false;\n          if (onComplete) {\n            runOnJS(onComplete)();\n          }\n        }\n      });\n    },\n    [getClosedTranslateY, isAnimating, translateY],\n  );\n\n  /** Animate to snap — safe to call from a worklet (onEnd handler). */\n  const animateToSnapWorklet = useCallback(\n    (index: number) => {\n      'worklet';\n      const clamped = clampIndex(index, resolvedSnapPoints.length);\n      const targetY = getTranslateYForSnap(clamped);\n\n      isAnimating.value = true;\n      activeSnapIndex.value = clamped;\n      translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {\n        if (finished) {\n          isAnimating.value = false;\n        }\n      });\n\n      runOnJS(emitSnapChange)(clamped);\n    },\n    [\n      resolvedSnapPoints,\n      getTranslateYForSnap,\n      isAnimating,\n      activeSnapIndex,\n      translateY,\n      emitSnapChange,\n    ],\n  );\n\n  /** Animate to closed — safe to call from a worklet. */\n  const animateToCloseWorklet = useCallback(() => {\n    'worklet';\n    const targetY = getClosedTranslateY();\n    isAnimating.value = true;\n    translateY.value = withSpring(targetY, SHEET_SPRING_CONFIG, (finished) => {\n      if (finished) {\n        isAnimating.value = false;\n      }\n    });\n  }, [getClosedTranslateY, isAnimating, translateY]);\n\n  return {\n    resolvedSnapPoints,\n    translateY,\n    activeSnapIndex,\n    isAnimating,\n    getTranslateYForSnap,\n    getClosedTranslateY,\n    animateToSnap,\n    animateToClose,\n    animateToSnapWorklet,\n    animateToCloseWorklet,\n  };\n}\n\nexport { SHEET_SPRING_CONFIG, useBottomSheetSnapModel };\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,sBAAsB;CAC1B,SAAS,cAAc,OAAO,KAAK;CACnC,WAAW,cAAc,OAAO,KAAK;CACrC,MAAM;CACP;;;;;;;;;;AAsDD,SAAS,wBAAwB,EAC/B,gBACA,QACA,uBACA,oBACA,mBACA,iBACA,eACA,YACA,oBACA,yBAC+D;CAC/D,MAAM,qBAAqB,cAAmC;AAC5D,MAAI,gBAAgB,OAClB,QAAO;AAET,MAAI,WAAW,OACb,QAAO,CAAC,OAAO;AAEjB,SAAO,CAAC,mBAAmB;IAC1B,CAAC,QAAQ,eAAe,CAAC;CAG5B,MAAM,aAAa,eAAe,KAAK;CACvC,MAAM,kBAAkB,eACtB,WAAW,sBAAsB,uBAAuB,mBAAmB,OAAO,CACnF;CACD,MAAM,cAAc,eAAe,MAAM;;;;;CAMzC,MAAM,uBAAuB,aAC1B,UAA0B;AACzB;EACA,MAAM,UAAU,WAAW,OAAO,mBAAmB,OAAO;EAC5D,MAAM,KAAK,mBAAmB;EAC9B,MAAM,WAAW,kBAAkB,IAAI,gBAAgB,MAAM;EAG7D,MAAM,uBADoB,sBAAsB,YAAY,mBAAmB,SAAS,IACvC,wBAAwB;EACzE,MAAM,YAAY,gBAAgB,QAAQ,uBAAuB;EACjE,MAAM,gBAAgB,KAAK,IAAI,GAAG,KAAK,IAAI,UAAU,UAAU,CAAC;AAChE,SAAO,gBAAgB,QAAQ,gBAAgB;IAEjD;EACE;EACA;EACA;EACA;EACA;EACA;EACD,CACF;;CAGD,MAAM,sBAAsB,kBAA0B;AACpD;AACA,SAAO,gBAAgB,QAAQ;IAC9B,CAAC,iBAAiB,cAAc,CAAC;;CAGpC,MAAM,iBAAiB,aACpB,UAAkB;AACjB,sBAAoB,OAAO,mBAAmB,OAAQ;IAExD,CAAC,mBAAmB,mBAAmB,CACxC;AAsFD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA,eA1FoB,aACnB,UAAkB;GACjB,MAAM,UAAU,WAAW,OAAO,mBAAmB,OAAO;GAC5D,MAAM,UAAU,qBAAqB,QAAQ;AAE7C,eAAY,QAAQ;AACpB,mBAAgB,QAAQ;AACxB,cAAW,QAAQ,WAAW,SAAS,sBAAsB,aAAa;AACxE;AACA,QAAI,SACF,aAAY,QAAQ;KAEtB;AAEF,kBAAe,QAAQ;KAEzB;GACE;GACA;GACA;GACA;GACA;GACA;GACD,CACF;EAmEC,gBAhEqB,aACpB,eAA4B;GAC3B,MAAM,UAAU,qBAAqB;AACrC,eAAY,QAAQ;AACpB,cAAW,QAAQ,WAAW,SAAS,sBAAsB,aAAa;AACxE;AACA,QAAI,UAAU;AACZ,iBAAY,QAAQ;AACpB,SAAI,WACF,SAAQ,WAAW,EAAE;;KAGzB;KAEJ;GAAC;GAAqB;GAAa;GAAW,CAC/C;EAkDC,sBA/C2B,aAC1B,UAAkB;AACjB;GACA,MAAM,UAAU,WAAW,OAAO,mBAAmB,OAAO;GAC5D,MAAM,UAAU,qBAAqB,QAAQ;AAE7C,eAAY,QAAQ;AACpB,mBAAgB,QAAQ;AACxB,cAAW,QAAQ,WAAW,SAAS,sBAAsB,aAAa;AACxE,QAAI,SACF,aAAY,QAAQ;KAEtB;AAEF,WAAQ,eAAe,CAAC,QAAQ;KAElC;GACE;GACA;GACA;GACA;GACA;GACA;GACD,CACF;EAwBC,uBArB4B,kBAAkB;AAC9C;GACA,MAAM,UAAU,qBAAqB;AACrC,eAAY,QAAQ;AACpB,cAAW,QAAQ,WAAW,SAAS,sBAAsB,aAAa;AACxE,QAAI,SACF,aAAY,QAAQ;KAEtB;KACD;GAAC;GAAqB;GAAa;GAAW,CAAC;EAajD"}