@yahoo/uds-mobile 2.3.4 → 2.4.0

package/dist/components/BottomSheet/useBottomSheetStore.cjs

@@ -0,0 +1,79 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let react = require("react");
+
+//#region src/components/BottomSheet/useBottomSheetStore.ts
+/**
+* Creates a lightweight external store for bottom-sheet open/close state.
+* Uses the `subscribe` / `getSnapshot` pattern for {@link useSyncExternalStore}.
+*
+* @param initialOpen - Initial open state.
+* @returns Store with `subscribe`, `getSnapshot`, and `setOpen`.
+* @internal
+*/
+function createBottomSheetStore(initialOpen) {
+	let isOpen = initialOpen;
+	const listeners = /* @__PURE__ */ new Set();
+	function subscribe(listener) {
+		listeners.add(listener);
+		return () => {
+			listeners.delete(listener);
+		};
+	}
+	function getSnapshot() {
+		return isOpen;
+	}
+	function setOpen(next) {
+		if (next === isOpen) return;
+		isOpen = next;
+		for (const listener of listeners) listener();
+	}
+	return {
+		subscribe,
+		getSnapshot,
+		setOpen
+	};
+}
+/** @internal */
+const BOTTOM_SHEET_INTERNAL_STORE_KEY = "__bottomSheetInternal";
+/** @internal — retrieve the internal store from a controller. */
+function getBottomSheetInternal(controller) {
+	const internal = controller[BOTTOM_SHEET_INTERNAL_STORE_KEY];
+	if (!internal) throw new Error("Invalid BottomSheet controller. Use `useBottomSheetStore()` to create one.");
+	return internal;
+}
+/**
+* Creates a {@link BottomSheetController} that manages open/close state.
+*
+* Supports both uncontrolled (`defaultOpen`) and controlled (`open`) modes.
+* The returned controller can be passed to `<BottomSheetProvider controller={...}>`
+* or `<BottomSheet controller={...}>`.
+*
+* @param props - Optional `defaultOpen` and/or controlled `open` value.
+* @returns A stable {@link BottomSheetController} with `open()`, `close()`, and `isOpen`.
+*
+* @example
+* ```tsx
+* const store = useBottomSheetStore();
+* // ...
+* <Button onPress={() => store.open()}>Open</Button>
+* ```
+*/
+function useBottomSheetStore({ defaultOpen = false, open: openProp } = {}) {
+	const [store] = (0, react.useState)(() => createBottomSheetStore(openProp ?? defaultOpen));
+	(0, react.useEffect)(() => {
+		if (openProp !== void 0) store.setOpen(openProp);
+	}, [openProp, store]);
+	const isOpen = (0, react.useSyncExternalStore)(store.subscribe, store.getSnapshot);
+	return {
+		open: (0, react.useCallback)(() => store.setOpen(true), [store]),
+		close: (0, react.useCallback)(() => store.setOpen(false), [store]),
+		isOpen,
+		[BOTTOM_SHEET_INTERNAL_STORE_KEY]: store
+	};
+}
+
+//#endregion
+exports.getBottomSheetInternal = getBottomSheetInternal;
+exports.useBottomSheetStore = useBottomSheetStore;

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

@@ -0,0 +1,45 @@
+
+import { BottomSheetController, UseBottomSheetStoreProps } from "./types.cjs";
+
+//#region src/components/BottomSheet/useBottomSheetStore.d.ts
+type Listener = () => void;
+/**
+ * Creates a lightweight external store for bottom-sheet open/close state.
+ * Uses the `subscribe` / `getSnapshot` pattern for {@link useSyncExternalStore}.
+ *
+ * @param initialOpen - Initial open state.
+ * @returns Store with `subscribe`, `getSnapshot`, and `setOpen`.
+ * @internal
+ */
+declare function createBottomSheetStore(initialOpen: boolean): {
+  subscribe: (listener: Listener) => () => void;
+  getSnapshot: () => boolean;
+  setOpen: (next: boolean) => void;
+};
+type InternalStore = ReturnType<typeof createBottomSheetStore>;
+/** @internal — retrieve the internal store from a controller. */
+declare function getBottomSheetInternal(controller: BottomSheetController): InternalStore;
+/**
+ * Creates a {@link BottomSheetController} that manages open/close state.
+ *
+ * Supports both uncontrolled (`defaultOpen`) and controlled (`open`) modes.
+ * The returned controller can be passed to `<BottomSheetProvider controller={...}>`
+ * or `<BottomSheet controller={...}>`.
+ *
+ * @param props - Optional `defaultOpen` and/or controlled `open` value.
+ * @returns A stable {@link BottomSheetController} with `open()`, `close()`, and `isOpen`.
+ *
+ * @example
+ * ```tsx
+ * const store = useBottomSheetStore();
+ * // ...
+ * <Button onPress={() => store.open()}>Open</Button>
+ * ```
+ */
+declare function useBottomSheetStore({
+  defaultOpen,
+  open: openProp
+}?: UseBottomSheetStoreProps): BottomSheetController;
+//#endregion
+export { getBottomSheetInternal, useBottomSheetStore };
+//# sourceMappingURL=useBottomSheetStore.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetStore.d.cts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetStore.ts"],"mappings":";;;;KAIK,QAAA;;AAF0E;;;;;AAElE;;iBAUJ,sBAAA,CAAuB,WAAA;wBAID,QAAA;;;;KA2B1B,aAAA,GAAgB,UAAA,QAAkB,sBAAA;;iBAO9B,sBAAA,CAAuB,UAAA,EAAY,qBAAA,GAAwB,aAAA;;;;AAvBpC;;;;;AAgB6B;;;;;;;;;iBAkCpD,mBAAA,CAAA;EACP,WAAA;EACA,IAAA,EAAM;AAAA,IACL,wBAAA,GAAgC,qBAAA"}

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

@@ -0,0 +1,45 @@
+
+import { BottomSheetController, UseBottomSheetStoreProps } from "./types.js";
+
+//#region src/components/BottomSheet/useBottomSheetStore.d.ts
+type Listener = () => void;
+/**
+ * Creates a lightweight external store for bottom-sheet open/close state.
+ * Uses the `subscribe` / `getSnapshot` pattern for {@link useSyncExternalStore}.
+ *
+ * @param initialOpen - Initial open state.
+ * @returns Store with `subscribe`, `getSnapshot`, and `setOpen`.
+ * @internal
+ */
+declare function createBottomSheetStore(initialOpen: boolean): {
+  subscribe: (listener: Listener) => () => void;
+  getSnapshot: () => boolean;
+  setOpen: (next: boolean) => void;
+};
+type InternalStore = ReturnType<typeof createBottomSheetStore>;
+/** @internal — retrieve the internal store from a controller. */
+declare function getBottomSheetInternal(controller: BottomSheetController): InternalStore;
+/**
+ * Creates a {@link BottomSheetController} that manages open/close state.
+ *
+ * Supports both uncontrolled (`defaultOpen`) and controlled (`open`) modes.
+ * The returned controller can be passed to `<BottomSheetProvider controller={...}>`
+ * or `<BottomSheet controller={...}>`.
+ *
+ * @param props - Optional `defaultOpen` and/or controlled `open` value.
+ * @returns A stable {@link BottomSheetController} with `open()`, `close()`, and `isOpen`.
+ *
+ * @example
+ * ```tsx
+ * const store = useBottomSheetStore();
+ * // ...
+ * <Button onPress={() => store.open()}>Open</Button>
+ * ```
+ */
+declare function useBottomSheetStore({
+  defaultOpen,
+  open: openProp
+}?: UseBottomSheetStoreProps): BottomSheetController;
+//#endregion
+export { getBottomSheetInternal, useBottomSheetStore };
+//# sourceMappingURL=useBottomSheetStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetStore.d.ts","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetStore.ts"],"mappings":";;;;KAIK,QAAA;;AAF0E;;;;;AAElE;;iBAUJ,sBAAA,CAAuB,WAAA;wBAID,QAAA;;;;KA2B1B,aAAA,GAAgB,UAAA,QAAkB,sBAAA;;iBAO9B,sBAAA,CAAuB,UAAA,EAAY,qBAAA,GAAwB,aAAA;;;;AAvBpC;;;;;AAgB6B;;;;;;;;;iBAkCpD,mBAAA,CAAA;EACP,WAAA;EACA,IAAA,EAAM;AAAA,IACL,wBAAA,GAAgC,qBAAA"}

package/dist/components/BottomSheet/useBottomSheetStore.js

@@ -0,0 +1,77 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { useCallback, useEffect, useState, useSyncExternalStore } from "react";
+
+//#region src/components/BottomSheet/useBottomSheetStore.ts
+/**
+* Creates a lightweight external store for bottom-sheet open/close state.
+* Uses the `subscribe` / `getSnapshot` pattern for {@link useSyncExternalStore}.
+*
+* @param initialOpen - Initial open state.
+* @returns Store with `subscribe`, `getSnapshot`, and `setOpen`.
+* @internal
+*/
+function createBottomSheetStore(initialOpen) {
+	let isOpen = initialOpen;
+	const listeners = /* @__PURE__ */ new Set();
+	function subscribe(listener) {
+		listeners.add(listener);
+		return () => {
+			listeners.delete(listener);
+		};
+	}
+	function getSnapshot() {
+		return isOpen;
+	}
+	function setOpen(next) {
+		if (next === isOpen) return;
+		isOpen = next;
+		for (const listener of listeners) listener();
+	}
+	return {
+		subscribe,
+		getSnapshot,
+		setOpen
+	};
+}
+/** @internal */
+const BOTTOM_SHEET_INTERNAL_STORE_KEY = "__bottomSheetInternal";
+/** @internal — retrieve the internal store from a controller. */
+function getBottomSheetInternal(controller) {
+	const internal = controller[BOTTOM_SHEET_INTERNAL_STORE_KEY];
+	if (!internal) throw new Error("Invalid BottomSheet controller. Use `useBottomSheetStore()` to create one.");
+	return internal;
+}
+/**
+* Creates a {@link BottomSheetController} that manages open/close state.
+*
+* Supports both uncontrolled (`defaultOpen`) and controlled (`open`) modes.
+* The returned controller can be passed to `<BottomSheetProvider controller={...}>`
+* or `<BottomSheet controller={...}>`.
+*
+* @param props - Optional `defaultOpen` and/or controlled `open` value.
+* @returns A stable {@link BottomSheetController} with `open()`, `close()`, and `isOpen`.
+*
+* @example
+* ```tsx
+* const store = useBottomSheetStore();
+* // ...
+* <Button onPress={() => store.open()}>Open</Button>
+* ```
+*/
+function useBottomSheetStore({ defaultOpen = false, open: openProp } = {}) {
+	const [store] = useState(() => createBottomSheetStore(openProp ?? defaultOpen));
+	useEffect(() => {
+		if (openProp !== void 0) store.setOpen(openProp);
+	}, [openProp, store]);
+	const isOpen = useSyncExternalStore(store.subscribe, store.getSnapshot);
+	return {
+		open: useCallback(() => store.setOpen(true), [store]),
+		close: useCallback(() => store.setOpen(false), [store]),
+		isOpen,
+		[BOTTOM_SHEET_INTERNAL_STORE_KEY]: store
+	};
+}
+
+//#endregion
+export { getBottomSheetInternal, useBottomSheetStore };
+//# sourceMappingURL=useBottomSheetStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBottomSheetStore.js","names":[],"sources":["../../../src/components/BottomSheet/useBottomSheetStore.ts"],"sourcesContent":["import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';\n\nimport type { BottomSheetController, UseBottomSheetStoreProps } from './types';\n\ntype Listener = () => void;\n\n/**\n * Creates a lightweight external store for bottom-sheet open/close state.\n * Uses the `subscribe` / `getSnapshot` pattern for {@link useSyncExternalStore}.\n *\n * @param initialOpen - Initial open state.\n * @returns Store with `subscribe`, `getSnapshot`, and `setOpen`.\n * @internal\n */\nfunction createBottomSheetStore(initialOpen: boolean) {\n  let isOpen = initialOpen;\n  const listeners = new Set<Listener>();\n\n  function subscribe(listener: Listener) {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  }\n\n  function getSnapshot() {\n    return isOpen;\n  }\n\n  function setOpen(next: boolean) {\n    if (next === isOpen) {\n      return;\n    }\n    isOpen = next;\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  return { subscribe, getSnapshot, setOpen };\n}\n\n/** @internal */\nconst BOTTOM_SHEET_INTERNAL_STORE_KEY = '__bottomSheetInternal';\n\ntype InternalStore = ReturnType<typeof createBottomSheetStore>;\n\ntype BottomSheetControllerWithInternal = BottomSheetController & {\n  [BOTTOM_SHEET_INTERNAL_STORE_KEY]: InternalStore;\n};\n\n/** @internal — retrieve the internal store from a controller. */\nfunction getBottomSheetInternal(controller: BottomSheetController): InternalStore {\n  const internal = (controller as BottomSheetControllerWithInternal)[\n    BOTTOM_SHEET_INTERNAL_STORE_KEY\n  ];\n  if (!internal) {\n    throw new Error('Invalid BottomSheet controller. Use `useBottomSheetStore()` to create one.');\n  }\n  return internal;\n}\n\n/**\n * Creates a {@link BottomSheetController} that manages open/close state.\n *\n * Supports both uncontrolled (`defaultOpen`) and controlled (`open`) modes.\n * The returned controller can be passed to `<BottomSheetProvider controller={...}>`\n * or `<BottomSheet controller={...}>`.\n *\n * @param props - Optional `defaultOpen` and/or controlled `open` value.\n * @returns A stable {@link BottomSheetController} with `open()`, `close()`, and `isOpen`.\n *\n * @example\n * ```tsx\n * const store = useBottomSheetStore();\n * // ...\n * <Button onPress={() => store.open()}>Open</Button>\n * ```\n */\nfunction useBottomSheetStore({\n  defaultOpen = false,\n  open: openProp,\n}: UseBottomSheetStoreProps = {}): BottomSheetController {\n  // Use useState with lazy initializer to create the store once.\n  const [store] = useState(() => createBottomSheetStore(openProp ?? defaultOpen));\n\n  // Sync controlled `open` prop into store via effect.\n  useEffect(() => {\n    if (openProp !== undefined) {\n      store.setOpen(openProp);\n    }\n  }, [openProp, store]);\n\n  const isOpen = useSyncExternalStore(store.subscribe, store.getSnapshot);\n\n  const open = useCallback(() => store.setOpen(true), [store]);\n  const close = useCallback(() => store.setOpen(false), [store]);\n\n  return {\n    open,\n    close,\n    isOpen,\n    [BOTTOM_SHEET_INTERNAL_STORE_KEY]: store,\n  } as BottomSheetController;\n}\n\nexport { getBottomSheetInternal, useBottomSheetStore };\n"],"mappings":";;;;;;;;;;;;AAcA,SAAS,uBAAuB,aAAsB;CACpD,IAAI,SAAS;CACb,MAAM,4BAAY,IAAI,KAAe;CAErC,SAAS,UAAU,UAAoB;AACrC,YAAU,IAAI,SAAS;AACvB,eAAa;AACX,aAAU,OAAO,SAAS;;;CAI9B,SAAS,cAAc;AACrB,SAAO;;CAGT,SAAS,QAAQ,MAAe;AAC9B,MAAI,SAAS,OACX;AAEF,WAAS;AACT,OAAK,MAAM,YAAY,UACrB,WAAU;;AAId,QAAO;EAAE;EAAW;EAAa;EAAS;;;AAI5C,MAAM,kCAAkC;;AASxC,SAAS,uBAAuB,YAAkD;CAChF,MAAM,WAAY,WAChB;AAEF,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,6EAA6E;AAE/F,QAAO;;;;;;;;;;;;;;;;;;;AAoBT,SAAS,oBAAoB,EAC3B,cAAc,OACd,MAAM,aACsB,EAAE,EAAyB;CAEvD,MAAM,CAAC,SAAS,eAAe,uBAAuB,YAAY,YAAY,CAAC;AAG/E,iBAAgB;AACd,MAAI,aAAa,OACf,OAAM,QAAQ,SAAS;IAExB,CAAC,UAAU,MAAM,CAAC;CAErB,MAAM,SAAS,qBAAqB,MAAM,WAAW,MAAM,YAAY;AAKvE,QAAO;EACL,MAJW,kBAAkB,MAAM,QAAQ,KAAK,EAAE,CAAC,MAAM,CAAC;EAK1D,OAJY,kBAAkB,MAAM,QAAQ,MAAM,EAAE,CAAC,MAAM,CAAC;EAK5D;GACC,kCAAkC;EACpC"}

package/dist/components/BottomSheet/useExpansionMargins.cjs

@@ -0,0 +1,57 @@
+/*! © 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_reanimated = require("react-native-reanimated");
+
+//#region src/components/BottomSheet/useExpansionMargins.ts
+/**
+* Animates sheet margins from their base values to `0` as the sheet expands
+* from the second-highest snap point to the max snap point.
+*
+* Also returns the interpolation thresholds (`maxSnapTranslateY` and
+* `thresholdTranslateY`) so the caller can animate other properties
+* (e.g. the height constraint's effective bottom inset) in sync.
+*
+* @returns An animated margin style and the expansion interpolation thresholds.
+*/
+function useExpansionMargins({ enabled, baseMarginHorizontal, baseMarginBottom, resolvedSnapPoints, containerHeight, bottomInsetPx, expandedBottomInsetPx, translateY }) {
+	const { maxSnapTranslateY, thresholdTranslateY } = (0, react.useMemo)(() => {
+		if (!enabled || resolvedSnapPoints.length === 0) return {
+			maxSnapTranslateY: 0,
+			thresholdTranslateY: 0
+		};
+		const h = containerHeight.value;
+		const maxIdx = resolvedSnapPoints.length - 1;
+		const maxHeight = require_components_BottomSheet_utils.resolveHeightToPx(resolvedSnapPoints[maxIdx], h);
+		const maxTransY = h - Math.min(maxHeight, h - expandedBottomInsetPx) - expandedBottomInsetPx;
+		const thresholdHeight = require_components_BottomSheet_utils.resolveHeightToPx(resolvedSnapPoints[require_components_BottomSheet_utils.clampIndex(maxIdx - 1, resolvedSnapPoints.length)], h);
+		return {
+			maxSnapTranslateY: maxTransY,
+			thresholdTranslateY: h - Math.min(thresholdHeight, h - bottomInsetPx) - bottomInsetPx
+		};
+	}, [
+		enabled,
+		resolvedSnapPoints,
+		containerHeight.value,
+		bottomInsetPx,
+		expandedBottomInsetPx
+	]);
+	return {
+		animatedMarginStyle: (0, react_native_reanimated.useAnimatedStyle)(() => {
+			if (!enabled) return {};
+			const mh = (0, react_native_reanimated.interpolate)(translateY.value, [maxSnapTranslateY, thresholdTranslateY], [0, baseMarginHorizontal], "clamp");
+			return {
+				marginLeft: mh,
+				marginRight: mh,
+				marginBottom: (0, react_native_reanimated.interpolate)(translateY.value, [maxSnapTranslateY, thresholdTranslateY], [0, baseMarginBottom], "clamp")
+			};
+		}),
+		maxSnapTranslateY,
+		thresholdTranslateY
+	};
+}
+
+//#endregion
+exports.useExpansionMargins = useExpansionMargins;

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

@@ -0,0 +1,59 @@
+
+import { BottomSheetHeight } from "./types.cjs";
+import { SharedValue } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useExpansionMargins.d.ts
+/** @internal */
+interface UseExpansionMarginsParams {
+  /** Whether `fullWidthAtMaxSnap` is enabled on the sheet. */
+  enabled: boolean;
+  /** Base horizontal margin from configurator tokens (px). */
+  baseMarginHorizontal: number;
+  /** Base bottom margin from configurator tokens (px). */
+  baseMarginBottom: number;
+  /** Resolved snap points array. */
+  resolvedSnapPoints: BottomSheetHeight[];
+  /** Container height (UI-thread shared value). */
+  containerHeight: SharedValue<number>;
+  /** Bottom inset in px (margin + safe area). */
+  bottomInsetPx: number;
+  /** Bottom inset at max snap when expanded (safe area only, no margin). */
+  expandedBottomInsetPx: number;
+  /** The sheet's animated translateY shared value. */
+  translateY: SharedValue<number>;
+}
+/**
+ * Animates sheet margins from their base values to `0` as the sheet expands
+ * from the second-highest snap point to the max snap point.
+ *
+ * Also returns the interpolation thresholds (`maxSnapTranslateY` and
+ * `thresholdTranslateY`) so the caller can animate other properties
+ * (e.g. the height constraint's effective bottom inset) in sync.
+ *
+ * @returns An animated margin style and the expansion interpolation thresholds.
+ */
+declare function useExpansionMargins({
+  enabled,
+  baseMarginHorizontal,
+  baseMarginBottom,
+  resolvedSnapPoints,
+  containerHeight,
+  bottomInsetPx,
+  expandedBottomInsetPx,
+  translateY
+}: UseExpansionMarginsParams): {
+  animatedMarginStyle: {
+    marginLeft?: undefined;
+    marginRight?: undefined;
+    marginBottom?: undefined;
+  } | {
+    marginLeft: number;
+    marginRight: number;
+    marginBottom: number;
+  };
+  maxSnapTranslateY: number;
+  thresholdTranslateY: number;
+};
+//#endregion
+export { useExpansionMargins };
+//# sourceMappingURL=useExpansionMargins.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useExpansionMargins.d.cts","names":[],"sources":["../../../src/components/BottomSheet/useExpansionMargins.ts"],"mappings":";;;;;;UAQU,yBAAA;EAAA;EAER,OAAA;;EAEA,oBAAA;EAMiB;EAJjB,gBAAA;EAUuB;EARvB,kBAAA,EAAoB,iBAAA;EANpB;EAQA,eAAA,EAAiB,WAAA;EAJjB;EAMA,aAAA;EAJoB;EAMpB,qBAAA;EAJiB;EAMjB,UAAA,EAAY,WAAA;AAAA;;;;;AAAW;;;;;;iBAahB,mBAAA,CAAA;EACP,OAAA;EACA,oBAAA;EACA,gBAAA;EACA,kBAAA;EACA,eAAA;EACA,aAAA;EACA,qBAAA;EACA;AAAA,GACC,yBAAA"}

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

@@ -0,0 +1,59 @@
+
+import { BottomSheetHeight } from "./types.js";
+import { SharedValue } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useExpansionMargins.d.ts
+/** @internal */
+interface UseExpansionMarginsParams {
+  /** Whether `fullWidthAtMaxSnap` is enabled on the sheet. */
+  enabled: boolean;
+  /** Base horizontal margin from configurator tokens (px). */
+  baseMarginHorizontal: number;
+  /** Base bottom margin from configurator tokens (px). */
+  baseMarginBottom: number;
+  /** Resolved snap points array. */
+  resolvedSnapPoints: BottomSheetHeight[];
+  /** Container height (UI-thread shared value). */
+  containerHeight: SharedValue<number>;
+  /** Bottom inset in px (margin + safe area). */
+  bottomInsetPx: number;
+  /** Bottom inset at max snap when expanded (safe area only, no margin). */
+  expandedBottomInsetPx: number;
+  /** The sheet's animated translateY shared value. */
+  translateY: SharedValue<number>;
+}
+/**
+ * Animates sheet margins from their base values to `0` as the sheet expands
+ * from the second-highest snap point to the max snap point.
+ *
+ * Also returns the interpolation thresholds (`maxSnapTranslateY` and
+ * `thresholdTranslateY`) so the caller can animate other properties
+ * (e.g. the height constraint's effective bottom inset) in sync.
+ *
+ * @returns An animated margin style and the expansion interpolation thresholds.
+ */
+declare function useExpansionMargins({
+  enabled,
+  baseMarginHorizontal,
+  baseMarginBottom,
+  resolvedSnapPoints,
+  containerHeight,
+  bottomInsetPx,
+  expandedBottomInsetPx,
+  translateY
+}: UseExpansionMarginsParams): {
+  animatedMarginStyle: {
+    marginLeft?: undefined;
+    marginRight?: undefined;
+    marginBottom?: undefined;
+  } | {
+    marginLeft: number;
+    marginRight: number;
+    marginBottom: number;
+  };
+  maxSnapTranslateY: number;
+  thresholdTranslateY: number;
+};
+//#endregion
+export { useExpansionMargins };
+//# sourceMappingURL=useExpansionMargins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useExpansionMargins.d.ts","names":[],"sources":["../../../src/components/BottomSheet/useExpansionMargins.ts"],"mappings":";;;;;;UAQU,yBAAA;EAAA;EAER,OAAA;;EAEA,oBAAA;EAMiB;EAJjB,gBAAA;EAUuB;EARvB,kBAAA,EAAoB,iBAAA;EANpB;EAQA,eAAA,EAAiB,WAAA;EAJjB;EAMA,aAAA;EAJoB;EAMpB,qBAAA;EAJiB;EAMjB,UAAA,EAAY,WAAA;AAAA;;;;;AAAW;;;;;;iBAahB,mBAAA,CAAA;EACP,OAAA;EACA,oBAAA;EACA,gBAAA;EACA,kBAAA;EACA,eAAA;EACA,aAAA;EACA,qBAAA;EACA;AAAA,GACC,yBAAA"}

package/dist/components/BottomSheet/useExpansionMargins.js

@@ -0,0 +1,56 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+import { clampIndex, resolveHeightToPx } from "./utils.js";
+import { useMemo } from "react";
+import { interpolate, useAnimatedStyle } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useExpansionMargins.ts
+/**
+* Animates sheet margins from their base values to `0` as the sheet expands
+* from the second-highest snap point to the max snap point.
+*
+* Also returns the interpolation thresholds (`maxSnapTranslateY` and
+* `thresholdTranslateY`) so the caller can animate other properties
+* (e.g. the height constraint's effective bottom inset) in sync.
+*
+* @returns An animated margin style and the expansion interpolation thresholds.
+*/
+function useExpansionMargins({ enabled, baseMarginHorizontal, baseMarginBottom, resolvedSnapPoints, containerHeight, bottomInsetPx, expandedBottomInsetPx, translateY }) {
+	const { maxSnapTranslateY, thresholdTranslateY } = useMemo(() => {
+		if (!enabled || resolvedSnapPoints.length === 0) return {
+			maxSnapTranslateY: 0,
+			thresholdTranslateY: 0
+		};
+		const h = containerHeight.value;
+		const maxIdx = resolvedSnapPoints.length - 1;
+		const maxHeight = resolveHeightToPx(resolvedSnapPoints[maxIdx], h);
+		const maxTransY = h - Math.min(maxHeight, h - expandedBottomInsetPx) - expandedBottomInsetPx;
+		const thresholdHeight = resolveHeightToPx(resolvedSnapPoints[clampIndex(maxIdx - 1, resolvedSnapPoints.length)], h);
+		return {
+			maxSnapTranslateY: maxTransY,
+			thresholdTranslateY: h - Math.min(thresholdHeight, h - bottomInsetPx) - bottomInsetPx
+		};
+	}, [
+		enabled,
+		resolvedSnapPoints,
+		containerHeight.value,
+		bottomInsetPx,
+		expandedBottomInsetPx
+	]);
+	return {
+		animatedMarginStyle: useAnimatedStyle(() => {
+			if (!enabled) return {};
+			const mh = interpolate(translateY.value, [maxSnapTranslateY, thresholdTranslateY], [0, baseMarginHorizontal], "clamp");
+			return {
+				marginLeft: mh,
+				marginRight: mh,
+				marginBottom: interpolate(translateY.value, [maxSnapTranslateY, thresholdTranslateY], [0, baseMarginBottom], "clamp")
+			};
+		}),
+		maxSnapTranslateY,
+		thresholdTranslateY
+	};
+}
+
+//#endregion
+export { useExpansionMargins };
+//# sourceMappingURL=useExpansionMargins.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useExpansionMargins.js","names":[],"sources":["../../../src/components/BottomSheet/useExpansionMargins.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport type { SharedValue } from 'react-native-reanimated';\nimport { interpolate, useAnimatedStyle } from 'react-native-reanimated';\n\nimport type { BottomSheetHeight } from './types';\nimport { clampIndex, resolveHeightToPx } from './utils';\n\n/** @internal */\ninterface UseExpansionMarginsParams {\n  /** Whether `fullWidthAtMaxSnap` is enabled on the sheet. */\n  enabled: boolean;\n  /** Base horizontal margin from configurator tokens (px). */\n  baseMarginHorizontal: number;\n  /** Base bottom margin from configurator tokens (px). */\n  baseMarginBottom: number;\n  /** Resolved snap points array. */\n  resolvedSnapPoints: BottomSheetHeight[];\n  /** Container height (UI-thread shared value). */\n  containerHeight: SharedValue<number>;\n  /** Bottom inset in px (margin + safe area). */\n  bottomInsetPx: number;\n  /** Bottom inset at max snap when expanded (safe area only, no margin). */\n  expandedBottomInsetPx: number;\n  /** The sheet's animated translateY shared value. */\n  translateY: SharedValue<number>;\n}\n\n/**\n * Animates sheet margins from their base values to `0` as the sheet expands\n * from the second-highest snap point to the max snap point.\n *\n * Also returns the interpolation thresholds (`maxSnapTranslateY` and\n * `thresholdTranslateY`) so the caller can animate other properties\n * (e.g. the height constraint's effective bottom inset) in sync.\n *\n * @returns An animated margin style and the expansion interpolation thresholds.\n */\nfunction useExpansionMargins({\n  enabled,\n  baseMarginHorizontal,\n  baseMarginBottom,\n  resolvedSnapPoints,\n  containerHeight,\n  bottomInsetPx,\n  expandedBottomInsetPx,\n  translateY,\n}: UseExpansionMarginsParams) {\n  // Compute threshold and max snap translateY positions.\n  // Max snap uses expandedBottomInsetPx (margins collapsed), threshold uses bottomInsetPx.\n  const { maxSnapTranslateY, thresholdTranslateY } = useMemo(() => {\n    if (!enabled || resolvedSnapPoints.length === 0) {\n      return { maxSnapTranslateY: 0, thresholdTranslateY: 0 };\n    }\n\n    const h = containerHeight.value;\n    const maxIdx = resolvedSnapPoints.length - 1;\n    const maxHeight = resolveHeightToPx(resolvedSnapPoints[maxIdx]!, h);\n    const clampedMax = Math.min(maxHeight, h - expandedBottomInsetPx);\n    const maxTransY = h - clampedMax - expandedBottomInsetPx;\n\n    // Threshold is the second-highest snap, or the max snap if only one exists.\n    const thresholdIdx = clampIndex(maxIdx - 1, resolvedSnapPoints.length);\n    const thresholdHeight = resolveHeightToPx(resolvedSnapPoints[thresholdIdx]!, h);\n    const clampedThreshold = Math.min(thresholdHeight, h - bottomInsetPx);\n    const thresholdTransY = h - clampedThreshold - bottomInsetPx;\n\n    return { maxSnapTranslateY: maxTransY, thresholdTranslateY: thresholdTransY };\n  }, [enabled, resolvedSnapPoints, containerHeight.value, bottomInsetPx, expandedBottomInsetPx]);\n\n  const animatedMarginStyle = useAnimatedStyle(() => {\n    if (!enabled) {\n      return {};\n    }\n\n    // When translateY moves from thresholdTranslateY to maxSnapTranslateY\n    // (sheet expanding), margins go from base values to 0.\n    const mh = interpolate(\n      translateY.value,\n      [maxSnapTranslateY, thresholdTranslateY],\n      [0, baseMarginHorizontal],\n      'clamp',\n    );\n    const mb = interpolate(\n      translateY.value,\n      [maxSnapTranslateY, thresholdTranslateY],\n      [0, baseMarginBottom],\n      'clamp',\n    );\n\n    return {\n      marginLeft: mh,\n      marginRight: mh,\n      marginBottom: mb,\n    };\n  });\n\n  return { animatedMarginStyle, maxSnapTranslateY, thresholdTranslateY };\n}\n\nexport { useExpansionMargins };\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,SAAS,oBAAoB,EAC3B,SACA,sBACA,kBACA,oBACA,iBACA,eACA,uBACA,cAC4B;CAG5B,MAAM,EAAE,mBAAmB,wBAAwB,cAAc;AAC/D,MAAI,CAAC,WAAW,mBAAmB,WAAW,EAC5C,QAAO;GAAE,mBAAmB;GAAG,qBAAqB;GAAG;EAGzD,MAAM,IAAI,gBAAgB;EAC1B,MAAM,SAAS,mBAAmB,SAAS;EAC3C,MAAM,YAAY,kBAAkB,mBAAmB,SAAU,EAAE;EAEnE,MAAM,YAAY,IADC,KAAK,IAAI,WAAW,IAAI,sBAAsB,GAC9B;EAInC,MAAM,kBAAkB,kBAAkB,mBADrB,WAAW,SAAS,GAAG,mBAAmB,OAAO,GACO,EAAE;AAI/E,SAAO;GAAE,mBAAmB;GAAW,qBAFf,IADC,KAAK,IAAI,iBAAiB,IAAI,cAAc,GACtB;GAE8B;IAC5E;EAAC;EAAS;EAAoB,gBAAgB;EAAO;EAAe;EAAsB,CAAC;AA6B9F,QAAO;EAAE,qBA3BmB,uBAAuB;AACjD,OAAI,CAAC,QACH,QAAO,EAAE;GAKX,MAAM,KAAK,YACT,WAAW,OACX,CAAC,mBAAmB,oBAAoB,EACxC,CAAC,GAAG,qBAAqB,EACzB,QACD;AAQD,UAAO;IACL,YAAY;IACZ,aAAa;IACb,cAVS,YACT,WAAW,OACX,CAAC,mBAAmB,oBAAoB,EACxC,CAAC,GAAG,iBAAiB,EACrB,QACD;IAMA;IACD;EAE4B;EAAmB;EAAqB"}

package/dist/components/BottomSheet/useKeyboardAvoidance.cjs

@@ -0,0 +1,53 @@
+/*! © 2026 Yahoo, Inc. UDS Mobile v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let react = require("react");
+let react_native = require("react-native");
+let react_native_reanimated = require("react-native-reanimated");
+
+//#region src/components/BottomSheet/useKeyboardAvoidance.ts
+/** Duration (ms) for the keyboard offset animation. */
+const KEYBOARD_ANIMATION_DURATION = 250;
+/**
+* Offsets the sheet's `translateY` when the software keyboard opens or closes.
+*
+* - **iOS**: Listens to `keyboardWillShow` / `keyboardWillHide` for smoother,
+*   synchronous animation with the keyboard.
+* - **Android**: Listens to `keyboardDidShow` / `keyboardDidHide` (will-events
+*   are not available on Android).
+*
+* Captures `translateY` before the offset and restores it when the keyboard hides.
+*/
+function useKeyboardAvoidance({ isOpen, translateY, isAnimating }) {
+	(0, react.useEffect)(() => {
+		if (!isOpen) return;
+		let preKeyboardTranslateY = null;
+		const showEvent = react_native.Platform.OS === "ios" ? "keyboardWillShow" : "keyboardDidShow";
+		const hideEvent = react_native.Platform.OS === "ios" ? "keyboardWillHide" : "keyboardDidHide";
+		const showSub = react_native.Keyboard.addListener(showEvent, (event) => {
+			const keyboardHeight = event.endCoordinates.height;
+			if (keyboardHeight <= 0) return;
+			if (preKeyboardTranslateY === null) preKeyboardTranslateY = translateY.value;
+			isAnimating.value = false;
+			const target = preKeyboardTranslateY - keyboardHeight;
+			translateY.value = (0, react_native_reanimated.withTiming)(Math.max(0, target), { duration: KEYBOARD_ANIMATION_DURATION });
+		});
+		const hideSub = react_native.Keyboard.addListener(hideEvent, () => {
+			if (preKeyboardTranslateY !== null) {
+				translateY.value = (0, react_native_reanimated.withTiming)(preKeyboardTranslateY, { duration: KEYBOARD_ANIMATION_DURATION });
+				preKeyboardTranslateY = null;
+			}
+		});
+		return () => {
+			showSub.remove();
+			hideSub.remove();
+		};
+	}, [
+		isOpen,
+		translateY,
+		isAnimating
+	]);
+}
+
+//#endregion
+exports.useKeyboardAvoidance = useKeyboardAvoidance;

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

@@ -0,0 +1,31 @@
+
+import { SharedValue } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useKeyboardAvoidance.d.ts
+/** @internal */
+interface UseKeyboardAvoidanceParams {
+  /** Whether the sheet is currently open. */
+  isOpen: boolean;
+  /** The sheet's animated translateY shared value. */
+  translateY: SharedValue<number>;
+  /** Whether the sheet is currently animating (snap/close spring). */
+  isAnimating: SharedValue<boolean>;
+}
+/**
+ * Offsets the sheet's `translateY` when the software keyboard opens or closes.
+ *
+ * - **iOS**: Listens to `keyboardWillShow` / `keyboardWillHide` for smoother,
+ *   synchronous animation with the keyboard.
+ * - **Android**: Listens to `keyboardDidShow` / `keyboardDidHide` (will-events
+ *   are not available on Android).
+ *
+ * Captures `translateY` before the offset and restores it when the keyboard hides.
+ */
+declare function useKeyboardAvoidance({
+  isOpen,
+  translateY,
+  isAnimating
+}: UseKeyboardAvoidanceParams): void;
+//#endregion
+export { useKeyboardAvoidance };
+//# sourceMappingURL=useKeyboardAvoidance.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardAvoidance.d.cts","names":[],"sources":["../../../src/components/BottomSheet/useKeyboardAvoidance.ts"],"mappings":";;;;;UASU,0BAAA;EAAA;EAER,MAAA;;EAEA,UAAA,EAAY,WAAA;EAFZ;EAIA,WAAA,EAAa,WAAA;AAAA;;;;;AAAW;;;;;;iBAajB,oBAAA,CAAA;EAAuB,MAAA;EAAQ,UAAA;EAAY;AAAA,GAAe,0BAAA"}

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

@@ -0,0 +1,31 @@
+
+import { SharedValue } from "react-native-reanimated";
+
+//#region src/components/BottomSheet/useKeyboardAvoidance.d.ts
+/** @internal */
+interface UseKeyboardAvoidanceParams {
+  /** Whether the sheet is currently open. */
+  isOpen: boolean;
+  /** The sheet's animated translateY shared value. */
+  translateY: SharedValue<number>;
+  /** Whether the sheet is currently animating (snap/close spring). */
+  isAnimating: SharedValue<boolean>;
+}
+/**
+ * Offsets the sheet's `translateY` when the software keyboard opens or closes.
+ *
+ * - **iOS**: Listens to `keyboardWillShow` / `keyboardWillHide` for smoother,
+ *   synchronous animation with the keyboard.
+ * - **Android**: Listens to `keyboardDidShow` / `keyboardDidHide` (will-events
+ *   are not available on Android).
+ *
+ * Captures `translateY` before the offset and restores it when the keyboard hides.
+ */
+declare function useKeyboardAvoidance({
+  isOpen,
+  translateY,
+  isAnimating
+}: UseKeyboardAvoidanceParams): void;
+//#endregion
+export { useKeyboardAvoidance };
+//# sourceMappingURL=useKeyboardAvoidance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardAvoidance.d.ts","names":[],"sources":["../../../src/components/BottomSheet/useKeyboardAvoidance.ts"],"mappings":";;;;;UASU,0BAAA;EAAA;EAER,MAAA;;EAEA,UAAA,EAAY,WAAA;EAFZ;EAIA,WAAA,EAAa,WAAA;AAAA;;;;;AAAW;;;;;;iBAajB,oBAAA,CAAA;EAAuB,MAAA;EAAQ,UAAA;EAAY;AAAA,GAAe,0BAAA"}