@yahoo/uds 3.114.0-beta.2 → 3.114.0

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

@@ -0,0 +1,31 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { useBottomSheetStoreInternal } from "./useBottomSheetStoreInternal.js";
+import { useStoreState } from "@ariakit/react";
+
+//#region src/components/client/BottomSheet/useBottomSheetStore.ts
+/** @internal */
+const BOTTOM_SHEET_INTERNAL_STORE_KEY = "__bottomSheetInternal";
+/** @internal */
+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;
+}
+const useBottomSheetStore = ({ animated = true, defaultOpen = false, open: openProp } = {}) => {
+	const bottomSheetInternal = useBottomSheetStoreInternal({
+		animated,
+		open: openProp,
+		defaultOpen
+	});
+	const isOpen = useStoreState(bottomSheetInternal, (state) => state.open);
+	return {
+		open: bottomSheetInternal.show,
+		close: bottomSheetInternal.hide,
+		isOpen,
+		[BOTTOM_SHEET_INTERNAL_STORE_KEY]: bottomSheetInternal
+	};
+};
+
+//#endregion
+export { getBottomSheetInternal, useBottomSheetStore };

package/dist/components/client/BottomSheet/useBottomSheetStoreInternal.cjs

@@ -0,0 +1,17 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+let _ariakit_react = require("@ariakit/react");
+
+//#region src/components/client/BottomSheet/useBottomSheetStoreInternal.ts
+const useBottomSheetStoreInternal = ({ animated = true, defaultOpen = false, open } = {}) => {
+	return (0, _ariakit_react.useDialogStore)({
+		animated,
+		open,
+		defaultOpen
+	});
+};
+
+//#endregion
+exports.useBottomSheetStoreInternal = useBottomSheetStoreInternal;

package/dist/components/client/BottomSheet/useBottomSheetStoreInternal.d.cts

@@ -0,0 +1,13 @@
+
+import * as _ariakit_react0 from "@ariakit/react";
+import { DialogStoreProps } from "@ariakit/react";
+
+//#region src/components/client/BottomSheet/useBottomSheetStoreInternal.d.ts
+type UseBottomSheetStoreInternalProps = Pick<DialogStoreProps, 'animated' | 'open' | 'defaultOpen'>;
+declare const useBottomSheetStoreInternal: ({
+  animated,
+  defaultOpen,
+  open
+}?: UseBottomSheetStoreInternalProps) => _ariakit_react0.DialogStore;
+//#endregion
+export { useBottomSheetStoreInternal };

package/dist/components/client/BottomSheet/useBottomSheetStoreInternal.d.ts

@@ -0,0 +1,13 @@
+
+import * as _ariakit_react0 from "@ariakit/react";
+import { DialogStoreProps } from "@ariakit/react";
+
+//#region src/components/client/BottomSheet/useBottomSheetStoreInternal.d.ts
+type UseBottomSheetStoreInternalProps = Pick<DialogStoreProps, 'animated' | 'open' | 'defaultOpen'>;
+declare const useBottomSheetStoreInternal: ({
+  animated,
+  defaultOpen,
+  open
+}?: UseBottomSheetStoreInternalProps) => _ariakit_react0.DialogStore;
+//#endregion
+export { useBottomSheetStoreInternal };

package/dist/components/client/BottomSheet/useBottomSheetStoreInternal.js

@@ -0,0 +1,15 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { useDialogStore } from "@ariakit/react";
+
+//#region src/components/client/BottomSheet/useBottomSheetStoreInternal.ts
+const useBottomSheetStoreInternal = ({ animated = true, defaultOpen = false, open } = {}) => {
+	return useDialogStore({
+		animated,
+		open,
+		defaultOpen
+	});
+};
+
+//#endregion
+export { useBottomSheetStoreInternal };

package/dist/components/client/BottomSheet/useExpansionMargins.cjs

@@ -0,0 +1,89 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS 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/client/BottomSheet/useExpansionMargins.ts
+/**
+* Manages the `fullWidthAtMaxSnap` feature: animates configured CSS margins to 0
+* as the sheet expands from the second-to-last snap point to the max snap point.
+*
+* Returns a stable `applyExpansionMargins` callback (safe for `useCallback([], [])`)
+* and a `thresholdRef` that the caller must set during render after the snap model
+* resolves pixel snap points
+*/
+function useExpansionMargins({ sheetRef, maxSnapPxRef, fullWidthAtMaxSnap, snapPointsLength, isOpen, forceZeroRef }) {
+	const thresholdRef = (0, react.useRef)(null);
+	const marginsRef = (0, react.useRef)(null);
+	const applyExpansionMargins = (0, react.useCallback)((el, currentTranslatePx) => {
+		if (forceZeroRef.current) {
+			el.style.marginLeft = "0px";
+			el.style.marginRight = "0px";
+			el.style.marginBottom = "0px";
+			return;
+		}
+		const threshold = thresholdRef.current;
+		if (threshold == null) return;
+		let margins = marginsRef.current;
+		if (!margins) {
+			el.style.removeProperty("margin-left");
+			el.style.removeProperty("margin-right");
+			el.style.removeProperty("margin-bottom");
+			const computed = getComputedStyle(el);
+			const left = parseFloat(computed.marginLeft) || 0;
+			const right = parseFloat(computed.marginRight) || 0;
+			const bottom = parseFloat(computed.marginBottom) || 0;
+			if (left === 0 && right === 0 && bottom === 0) return;
+			margins = {
+				left,
+				right,
+				bottom
+			};
+			marginsRef.current = margins;
+		}
+		const maxSnap = maxSnapPxRef.current;
+		const range = maxSnap - threshold;
+		if (range <= 0) return;
+		const rawProgress = (maxSnap - currentTranslatePx - threshold) / range;
+		const progress = Math.max(0, Math.min(1, rawProgress));
+		if (progress <= 0) {
+			marginsRef.current = null;
+			el.style.removeProperty("margin-left");
+			el.style.removeProperty("margin-right");
+			el.style.removeProperty("margin-bottom");
+			return;
+		}
+		el.style.marginLeft = `${margins.left * (1 - progress)}px`;
+		el.style.marginRight = `${margins.right * (1 - progress)}px`;
+		el.style.marginBottom = `${margins.bottom * (1 - progress)}px`;
+	}, [
+		forceZeroRef,
+		maxSnapPxRef,
+		thresholdRef,
+		marginsRef
+	]);
+	(0, react.useEffect)(() => {
+		if (isOpen && fullWidthAtMaxSnap && snapPointsLength >= 2) return;
+		marginsRef.current = null;
+		const el = sheetRef.current;
+		if (el) {
+			el.style.removeProperty("margin-left");
+			el.style.removeProperty("margin-right");
+			el.style.removeProperty("margin-bottom");
+			if (!isOpen) el.style.removeProperty("height");
+		}
+	}, [
+		isOpen,
+		fullWidthAtMaxSnap,
+		snapPointsLength,
+		sheetRef
+	]);
+	return {
+		applyExpansionMargins,
+		thresholdRef
+	};
+}
+
+//#endregion
+exports.useExpansionMargins = useExpansionMargins;

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

@@ -0,0 +1,34 @@
+
+import React from "react";
+
+//#region src/components/client/BottomSheet/useExpansionMargins.d.ts
+interface UseExpansionMarginsParams {
+  sheetRef: React.RefObject<HTMLElement | null>;
+  maxSnapPxRef: React.RefObject<number>;
+  fullWidthAtMaxSnap: boolean;
+  snapPointsLength: number;
+  isOpen: boolean;
+  /** When true, forces all margins to 0 (e.g. virtual keyboard visible). */
+  forceZeroRef: React.RefObject<boolean>;
+}
+/**
+ * Manages the `fullWidthAtMaxSnap` feature: animates configured CSS margins to 0
+ * as the sheet expands from the second-to-last snap point to the max snap point.
+ *
+ * Returns a stable `applyExpansionMargins` callback (safe for `useCallback([], [])`)
+ * and a `thresholdRef` that the caller must set during render after the snap model
+ * resolves pixel snap points
+ */
+declare function useExpansionMargins({
+  sheetRef,
+  maxSnapPxRef,
+  fullWidthAtMaxSnap,
+  snapPointsLength,
+  isOpen,
+  forceZeroRef
+}: UseExpansionMarginsParams): {
+  applyExpansionMargins: (el: HTMLElement, currentTranslatePx: number) => void;
+  thresholdRef: React.RefObject<number | null>;
+};
+//#endregion
+export { useExpansionMargins };

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

@@ -0,0 +1,34 @@
+
+import React from "react";
+
+//#region src/components/client/BottomSheet/useExpansionMargins.d.ts
+interface UseExpansionMarginsParams {
+  sheetRef: React.RefObject<HTMLElement | null>;
+  maxSnapPxRef: React.RefObject<number>;
+  fullWidthAtMaxSnap: boolean;
+  snapPointsLength: number;
+  isOpen: boolean;
+  /** When true, forces all margins to 0 (e.g. virtual keyboard visible). */
+  forceZeroRef: React.RefObject<boolean>;
+}
+/**
+ * Manages the `fullWidthAtMaxSnap` feature: animates configured CSS margins to 0
+ * as the sheet expands from the second-to-last snap point to the max snap point.
+ *
+ * Returns a stable `applyExpansionMargins` callback (safe for `useCallback([], [])`)
+ * and a `thresholdRef` that the caller must set during render after the snap model
+ * resolves pixel snap points
+ */
+declare function useExpansionMargins({
+  sheetRef,
+  maxSnapPxRef,
+  fullWidthAtMaxSnap,
+  snapPointsLength,
+  isOpen,
+  forceZeroRef
+}: UseExpansionMarginsParams): {
+  applyExpansionMargins: (el: HTMLElement, currentTranslatePx: number) => void;
+  thresholdRef: React.RefObject<number | null>;
+};
+//#endregion
+export { useExpansionMargins };

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

@@ -0,0 +1,87 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { useCallback, useEffect, useRef } from "react";
+
+//#region src/components/client/BottomSheet/useExpansionMargins.ts
+/**
+* Manages the `fullWidthAtMaxSnap` feature: animates configured CSS margins to 0
+* as the sheet expands from the second-to-last snap point to the max snap point.
+*
+* Returns a stable `applyExpansionMargins` callback (safe for `useCallback([], [])`)
+* and a `thresholdRef` that the caller must set during render after the snap model
+* resolves pixel snap points
+*/
+function useExpansionMargins({ sheetRef, maxSnapPxRef, fullWidthAtMaxSnap, snapPointsLength, isOpen, forceZeroRef }) {
+	const thresholdRef = useRef(null);
+	const marginsRef = useRef(null);
+	const applyExpansionMargins = useCallback((el, currentTranslatePx) => {
+		if (forceZeroRef.current) {
+			el.style.marginLeft = "0px";
+			el.style.marginRight = "0px";
+			el.style.marginBottom = "0px";
+			return;
+		}
+		const threshold = thresholdRef.current;
+		if (threshold == null) return;
+		let margins = marginsRef.current;
+		if (!margins) {
+			el.style.removeProperty("margin-left");
+			el.style.removeProperty("margin-right");
+			el.style.removeProperty("margin-bottom");
+			const computed = getComputedStyle(el);
+			const left = parseFloat(computed.marginLeft) || 0;
+			const right = parseFloat(computed.marginRight) || 0;
+			const bottom = parseFloat(computed.marginBottom) || 0;
+			if (left === 0 && right === 0 && bottom === 0) return;
+			margins = {
+				left,
+				right,
+				bottom
+			};
+			marginsRef.current = margins;
+		}
+		const maxSnap = maxSnapPxRef.current;
+		const range = maxSnap - threshold;
+		if (range <= 0) return;
+		const rawProgress = (maxSnap - currentTranslatePx - threshold) / range;
+		const progress = Math.max(0, Math.min(1, rawProgress));
+		if (progress <= 0) {
+			marginsRef.current = null;
+			el.style.removeProperty("margin-left");
+			el.style.removeProperty("margin-right");
+			el.style.removeProperty("margin-bottom");
+			return;
+		}
+		el.style.marginLeft = `${margins.left * (1 - progress)}px`;
+		el.style.marginRight = `${margins.right * (1 - progress)}px`;
+		el.style.marginBottom = `${margins.bottom * (1 - progress)}px`;
+	}, [
+		forceZeroRef,
+		maxSnapPxRef,
+		thresholdRef,
+		marginsRef
+	]);
+	useEffect(() => {
+		if (isOpen && fullWidthAtMaxSnap && snapPointsLength >= 2) return;
+		marginsRef.current = null;
+		const el = sheetRef.current;
+		if (el) {
+			el.style.removeProperty("margin-left");
+			el.style.removeProperty("margin-right");
+			el.style.removeProperty("margin-bottom");
+			if (!isOpen) el.style.removeProperty("height");
+		}
+	}, [
+		isOpen,
+		fullWidthAtMaxSnap,
+		snapPointsLength,
+		sheetRef
+	]);
+	return {
+		applyExpansionMargins,
+		thresholdRef
+	};
+}
+
+//#endregion
+export { useExpansionMargins };

package/dist/components/client/BottomSheet/useViewportHeight.cjs

@@ -0,0 +1,32 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_components_client_BottomSheet_utils = require('./utils.cjs');
+let react = require("react");
+
+//#region src/components/client/BottomSheet/useViewportHeight.ts
+/**
+* Hook to get the viewport height in pixels.
+* @returns The viewport height in pixels.
+*/
+function useViewportHeight() {
+	const [viewportHeightPx, setViewportHeightPx] = (0, react.useState)(require_components_client_BottomSheet_utils.getViewportHeightPx);
+	(0, react.useEffect)(() => {
+		if (typeof window === "undefined") return;
+		function onResize() {
+			setViewportHeightPx(require_components_client_BottomSheet_utils.getViewportHeightPx());
+		}
+		onResize();
+		window.addEventListener("resize", onResize);
+		window.visualViewport?.addEventListener("resize", onResize);
+		return () => {
+			window.removeEventListener("resize", onResize);
+			window.visualViewport?.removeEventListener("resize", onResize);
+		};
+	}, []);
+	return viewportHeightPx;
+}
+
+//#endregion
+exports.useViewportHeight = useViewportHeight;

package/dist/components/client/BottomSheet/useViewportHeight.d.cts

@@ -0,0 +1,9 @@
+
+//#region src/components/client/BottomSheet/useViewportHeight.d.ts
+/**
+ * Hook to get the viewport height in pixels.
+ * @returns The viewport height in pixels.
+ */
+declare function useViewportHeight(): number;
+//#endregion
+export { useViewportHeight };

package/dist/components/client/BottomSheet/useViewportHeight.d.ts

@@ -0,0 +1,9 @@
+
+//#region src/components/client/BottomSheet/useViewportHeight.d.ts
+/**
+ * Hook to get the viewport height in pixels.
+ * @returns The viewport height in pixels.
+ */
+declare function useViewportHeight(): number;
+//#endregion
+export { useViewportHeight };

package/dist/components/client/BottomSheet/useViewportHeight.js

@@ -0,0 +1,30 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { getViewportHeightPx } from "./utils.js";
+import { useEffect, useState } from "react";
+
+//#region src/components/client/BottomSheet/useViewportHeight.ts
+/**
+* Hook to get the viewport height in pixels.
+* @returns The viewport height in pixels.
+*/
+function useViewportHeight() {
+	const [viewportHeightPx, setViewportHeightPx] = useState(getViewportHeightPx);
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		function onResize() {
+			setViewportHeightPx(getViewportHeightPx());
+		}
+		onResize();
+		window.addEventListener("resize", onResize);
+		window.visualViewport?.addEventListener("resize", onResize);
+		return () => {
+			window.removeEventListener("resize", onResize);
+			window.visualViewport?.removeEventListener("resize", onResize);
+		};
+	}, []);
+	return viewportHeightPx;
+}
+
+//#endregion
+export { useViewportHeight };

package/dist/components/client/BottomSheet/useVirtualKeyboard.cjs

@@ -0,0 +1,48 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_components_client_BottomSheet_utils = require('./utils.cjs');
+let react = require("react");
+
+//#region src/components/client/BottomSheet/useVirtualKeyboard.ts
+/**
+* Minimum keyboard height (px) to treat as a real virtual keyboard.
+* Filters out small residual values (e.g. iOS safe area insets) that
+* don't represent an actual keyboard.
+*/
+const MIN_VIRTUAL_KEYBOARD_HEIGHT_PX = 100;
+/**
+* Hook to get the height of the virtual keyboard.
+* @param isEnabled - Whether the virtual keyboard is enabled.
+* @returns The height of the virtual keyboard in pixels, or 0 if below the minimum threshold.
+*/
+function useVirtualKeyboard(isEnabled) {
+	const [keyboardHeightPx, setKeyboardHeightPx] = (0, react.useState)(0);
+	const keyboardIsOpenRef = (0, react.useRef)(false);
+	(0, react.useEffect)(() => {
+		if (!isEnabled) {
+			keyboardIsOpenRef.current = false;
+			setKeyboardHeightPx(0);
+			return;
+		}
+		const vv = window.visualViewport;
+		if (!vv) return;
+		const viewport = vv;
+		function onVisualViewportResize() {
+			const nextKeyboardHeight = Math.max(window.innerHeight - viewport.height, 0);
+			const focused = document.activeElement;
+			const keyboardIsOpen = nextKeyboardHeight > 0 && (require_components_client_BottomSheet_utils.isInputLike(focused) || keyboardIsOpenRef.current);
+			keyboardIsOpenRef.current = keyboardIsOpen;
+			setKeyboardHeightPx(keyboardIsOpen ? nextKeyboardHeight : 0);
+		}
+		onVisualViewportResize();
+		viewport.addEventListener("resize", onVisualViewportResize);
+		return () => viewport.removeEventListener("resize", onVisualViewportResize);
+	}, [isEnabled]);
+	const height = isEnabled ? keyboardHeightPx : 0;
+	return height >= MIN_VIRTUAL_KEYBOARD_HEIGHT_PX ? height : 0;
+}
+
+//#endregion
+exports.useVirtualKeyboard = useVirtualKeyboard;

package/dist/components/client/BottomSheet/useVirtualKeyboard.d.cts

@@ -0,0 +1,10 @@
+
+//#region src/components/client/BottomSheet/useVirtualKeyboard.d.ts
+/**
+ * Hook to get the height of the virtual keyboard.
+ * @param isEnabled - Whether the virtual keyboard is enabled.
+ * @returns The height of the virtual keyboard in pixels, or 0 if below the minimum threshold.
+ */
+declare function useVirtualKeyboard(isEnabled: boolean): number;
+//#endregion
+export { useVirtualKeyboard };

package/dist/components/client/BottomSheet/useVirtualKeyboard.d.ts

@@ -0,0 +1,10 @@
+
+//#region src/components/client/BottomSheet/useVirtualKeyboard.d.ts
+/**
+ * Hook to get the height of the virtual keyboard.
+ * @param isEnabled - Whether the virtual keyboard is enabled.
+ * @returns The height of the virtual keyboard in pixels, or 0 if below the minimum threshold.
+ */
+declare function useVirtualKeyboard(isEnabled: boolean): number;
+//#endregion
+export { useVirtualKeyboard };

package/dist/components/client/BottomSheet/useVirtualKeyboard.js

@@ -0,0 +1,46 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { isInputLike } from "./utils.js";
+import { useEffect, useRef, useState } from "react";
+
+//#region src/components/client/BottomSheet/useVirtualKeyboard.ts
+/**
+* Minimum keyboard height (px) to treat as a real virtual keyboard.
+* Filters out small residual values (e.g. iOS safe area insets) that
+* don't represent an actual keyboard.
+*/
+const MIN_VIRTUAL_KEYBOARD_HEIGHT_PX = 100;
+/**
+* Hook to get the height of the virtual keyboard.
+* @param isEnabled - Whether the virtual keyboard is enabled.
+* @returns The height of the virtual keyboard in pixels, or 0 if below the minimum threshold.
+*/
+function useVirtualKeyboard(isEnabled) {
+	const [keyboardHeightPx, setKeyboardHeightPx] = useState(0);
+	const keyboardIsOpenRef = useRef(false);
+	useEffect(() => {
+		if (!isEnabled) {
+			keyboardIsOpenRef.current = false;
+			setKeyboardHeightPx(0);
+			return;
+		}
+		const vv = window.visualViewport;
+		if (!vv) return;
+		const viewport = vv;
+		function onVisualViewportResize() {
+			const nextKeyboardHeight = Math.max(window.innerHeight - viewport.height, 0);
+			const focused = document.activeElement;
+			const keyboardIsOpen = nextKeyboardHeight > 0 && (isInputLike(focused) || keyboardIsOpenRef.current);
+			keyboardIsOpenRef.current = keyboardIsOpen;
+			setKeyboardHeightPx(keyboardIsOpen ? nextKeyboardHeight : 0);
+		}
+		onVisualViewportResize();
+		viewport.addEventListener("resize", onVisualViewportResize);
+		return () => viewport.removeEventListener("resize", onVisualViewportResize);
+	}, [isEnabled]);
+	const height = isEnabled ? keyboardHeightPx : 0;
+	return height >= MIN_VIRTUAL_KEYBOARD_HEIGHT_PX ? height : 0;
+}
+
+//#endregion
+export { useVirtualKeyboard };

package/dist/components/client/BottomSheet/utils.cjs

@@ -0,0 +1,128 @@
+"use client";
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+let lodash_clamp_js = require("lodash/clamp.js");
+lodash_clamp_js = require_runtime.__toESM(lodash_clamp_js);
+
+//#region src/components/client/BottomSheet/utils.ts
+/**
+* Check if an element is an input-like element.
+* @param el - The element to check.
+* @returns True if the element is an input-like element, false otherwise.
+*/
+function isInputLike(el) {
+	if (!el) return false;
+	const tagName = el.tagName.toLowerCase();
+	if (tagName === "input" || tagName === "textarea" || tagName === "select") return true;
+	if (el instanceof HTMLElement && el.isContentEditable) return true;
+	return false;
+}
+/**
+* Get the viewport height in pixels.
+* @returns The viewport height in pixels.
+*/
+function getViewportHeightPx() {
+	if (typeof window === "undefined") return 0;
+	return window.visualViewport?.height ?? window.innerHeight;
+}
+/**
+* Clamp an index into the valid range for an array-like collection.
+*
+* @param index - The candidate index (may be negative or out of bounds).
+* @param length - The collection length.
+* @returns A valid index in the range [0, length - 1]. Returns 0 if length <= 0.
+*
+* @example
+* clampIndex(12, 10) // 9
+* clampIndex(-3, 10) // 0
+* clampIndex(5, 0)   // 0
+*/
+function clampIndex(index, length) {
+	if (length <= 0) return 0;
+	return (0, lodash_clamp_js.default)(index, 0, length - 1);
+}
+/**
+* Resolve a height value to a pixel value.
+* @param height - The height value to resolve.
+* @param viewportHeightPx - The viewport height in pixels.
+* @returns The resolved height in pixels.
+*/
+function resolveHeightToPx(height, viewportHeightPx) {
+	if (typeof height === "number") return height;
+	const trimmed = height.trim();
+	if (trimmed.endsWith("%")) {
+		const pct = Number.parseFloat(trimmed.slice(0, -1));
+		if (Number.isFinite(pct)) return pct / 100 * viewportHeightPx;
+	}
+	if (trimmed.endsWith("px")) {
+		const px = Number.parseFloat(trimmed.slice(0, -2));
+		if (Number.isFinite(px)) return px;
+	}
+	const fallback = Number.parseFloat(trimmed);
+	return Number.isFinite(fallback) ? fallback : 0;
+}
+/**
+* Check if an element is scrollable.
+* @param el - The element to check.
+* @returns True if the element is scrollable, false otherwise.
+*/
+function isScrollable(el) {
+	return el.scrollHeight > el.clientHeight;
+}
+/**
+* Check if a drag event should be prevented from the target element.
+* @param target - The target element.
+* @returns True if the drag event should be prevented, false otherwise.
+*/
+function shouldPreventDragFromTarget(target) {
+	const element = target instanceof Element ? target : null;
+	if (!element) return false;
+	if (element.tagName.toUpperCase() === "SELECT") return true;
+	return !!element.closest("[data-bottomsheet-no-drag]");
+}
+/**
+* Get the translateY value of an element's transform.
+* @param el - The element to get the translateY value of.
+* @returns The translateY value in pixels.
+*/
+function getTranslateY(el) {
+	if (!el) return 0;
+	const style = window.getComputedStyle(el);
+	const transform = style.getPropertyValue("transform") || style.getPropertyValue("-webkit-transform") || style.getPropertyValue("-moz-transform");
+	if (!transform || transform === "none") return 0;
+	const mat3d = transform.match(/^matrix3d\((.+)\)$/);
+	if (mat3d) {
+		const parts = mat3d[1].split(",").map((p) => p.trim());
+		return Number.parseFloat(parts[13] ?? "0") || 0;
+	}
+	const mat2d = transform.match(/^matrix\((.+)\)$/);
+	if (mat2d) {
+		const parts = mat2d[1].split(",").map((p) => p.trim());
+		return Number.parseFloat(parts[5] ?? "0") || 0;
+	}
+	return 0;
+}
+/**
+* Parse a max snap point ratio from a string.
+* @param rawValue - The raw value to parse.
+* @returns The parsed max snap point ratio.
+*/
+function parseMaxSnapPointRatio(rawValue) {
+	const trimmed = rawValue.trim();
+	if (!trimmed) return 1;
+	const value = trimmed.endsWith("%") ? trimmed.slice(0, -1) : trimmed;
+	const parsed = Number.parseFloat(value);
+	if (!Number.isFinite(parsed)) return 1;
+	return Math.min(Math.max(parsed / 100, 0), 1);
+}
+
+//#endregion
+exports.clampIndex = clampIndex;
+exports.getTranslateY = getTranslateY;
+exports.getViewportHeightPx = getViewportHeightPx;
+exports.isInputLike = isInputLike;
+exports.isScrollable = isScrollable;
+exports.parseMaxSnapPointRatio = parseMaxSnapPointRatio;
+exports.resolveHeightToPx = resolveHeightToPx;
+exports.shouldPreventDragFromTarget = shouldPreventDragFromTarget;