react-simplikit 0.0.52 → 0.1.0

package/dist/mobile/hooks/useVisualViewport/useVisualViewport.cjs

@@ -0,0 +1,77 @@
+"use client";
+const require_isServer = require("../../utils/isServer/isServer.cjs");
+let react = require("react");
+//#region src/mobile/hooks/useVisualViewport/useVisualViewport.ts
+/**
+* @description
+* `useVisualViewport` is a React hook that tracks Visual Viewport changes.
+* It returns the actual visible area in mobile WebView, which changes when
+* the keyboard appears or the user zooms/scrolls.
+*
+* **Important:** `viewport` is `null` on SSR or in browsers that don't support Visual Viewport API.
+* Always check for null before accessing viewport properties.
+*
+* **Tip:** If you only need keyboard height, use `useKeyboardHeight()` instead
+* for a simpler API.
+*
+* @returns {{ viewport: VisualViewportState | null }} An object containing the Visual Viewport state.
+* - viewport `VisualViewportState | null` - Visual Viewport state object, or `null` if not supported (SSR or browsers without the Visual Viewport API);
+* - viewport.width `number` - Viewport width in pixels;
+* - viewport.height `number` - Viewport height in pixels;
+* - viewport.offsetLeft `number` - Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs;
+* - viewport.offsetTop `number` - Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears, so use `-offsetTop` for the keyboard height. Typically remains 0 on Android;
+* - viewport.scale `number` - Pinch-zoom scaling factor. 1.0 means no zoom, greater than 1.0 means zoomed in;
+*
+* @see {@link useKeyboardHeight} - Simpler hook for keyboard height only
+*
+* @example
+* function CustomLayout() {
+*   const { viewport } = useVisualViewport();
+*
+*   // Always check for null first
+*   if (!viewport) {
+*     return <div>Visual Viewport not supported</div>;
+*   }
+*
+*   const { width, height, offsetTop, scale } = viewport;
+*
+*   // Hide floating UI when user zooms in
+*   const showFloatingUI = scale <= 1.3;
+*
+*   return (
+*     <div style={{ height }}>
+*       {showFloatingUI && <FloatingButton />}
+*       Viewport-aware content
+*     </div>
+*   );
+* }
+*/
+function useVisualViewport() {
+	const visualViewport = require_isServer.isServer() ? null : window.visualViewport;
+	const [viewport, setViewport] = (0, react.useState)(() => visualViewport != null ? getVisualViewportState(visualViewport) : null);
+	const updateViewportState = (0, react.useCallback)(() => {
+		(0, react.startTransition)(() => {
+			setViewport(window.visualViewport != null ? getVisualViewportState(window.visualViewport) : null);
+		});
+	}, []);
+	(0, react.useEffect)(function handleVisualViewportChange() {
+		window.visualViewport?.addEventListener("resize", updateViewportState);
+		window.visualViewport?.addEventListener("scroll", updateViewportState);
+		return function cleanup() {
+			window.visualViewport?.removeEventListener("resize", updateViewportState);
+			window.visualViewport?.removeEventListener("scroll", updateViewportState);
+		};
+	}, [updateViewportState]);
+	return { viewport };
+}
+function getVisualViewportState(visualViewport) {
+	return {
+		width: visualViewport.width,
+		height: visualViewport.height,
+		offsetLeft: visualViewport.offsetLeft,
+		offsetTop: visualViewport.offsetTop,
+		scale: visualViewport.scale
+	};
+}
+//#endregion
+exports.useVisualViewport = useVisualViewport;

package/dist/mobile/hooks/useVisualViewport/useVisualViewport.d.cts

@@ -0,0 +1,89 @@
+
+//#region src/mobile/hooks/useVisualViewport/useVisualViewport.d.ts
+type VisualViewportState = {
+  /** Viewport width (px) */
+  width: number;
+  /** Viewport height (px) */
+  height: number;
+  /**
+   * Viewport left offset (px) from the layout viewport
+   *
+   * Typically 0 unless horizontal scrolling or panning occurs
+   */
+  offsetLeft: number;
+  /**
+   * Viewport top offset (px) from the layout viewport
+   *
+   * On iOS: Becomes negative when keyboard appears (e.g., -300px means 300px keyboard height)
+   * On Android: Typically remains 0
+   *
+   * Use `-offsetTop` to get accurate keyboard height on iOS
+   */
+  offsetTop: number;
+  /**
+   * Pinch-zoom scaling factor
+   *
+   * - 1.0 = no zoom (default)
+   * - > 1.0 = zoomed in
+   * - < 1.0 = zoomed out (rare, depends on viewport settings)
+   *
+   * @example
+   * ```tsx
+   * const { viewport } = useVisualViewport();
+   * if (viewport && viewport.scale > 1.3) {
+   *   // Hide floating UI when user zooms in
+   *   setShowFloatingButton(false);
+   * }
+   * ```
+   */
+  scale: number;
+};
+/**
+ * @description
+ * `useVisualViewport` is a React hook that tracks Visual Viewport changes.
+ * It returns the actual visible area in mobile WebView, which changes when
+ * the keyboard appears or the user zooms/scrolls.
+ *
+ * **Important:** `viewport` is `null` on SSR or in browsers that don't support Visual Viewport API.
+ * Always check for null before accessing viewport properties.
+ *
+ * **Tip:** If you only need keyboard height, use `useKeyboardHeight()` instead
+ * for a simpler API.
+ *
+ * @returns {{ viewport: VisualViewportState | null }} An object containing the Visual Viewport state.
+ * - viewport `VisualViewportState | null` - Visual Viewport state object, or `null` if not supported (SSR or browsers without the Visual Viewport API);
+ * - viewport.width `number` - Viewport width in pixels;
+ * - viewport.height `number` - Viewport height in pixels;
+ * - viewport.offsetLeft `number` - Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs;
+ * - viewport.offsetTop `number` - Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears, so use `-offsetTop` for the keyboard height. Typically remains 0 on Android;
+ * - viewport.scale `number` - Pinch-zoom scaling factor. 1.0 means no zoom, greater than 1.0 means zoomed in;
+ *
+ * @see {@link useKeyboardHeight} - Simpler hook for keyboard height only
+ *
+ * @example
+ * function CustomLayout() {
+ *   const { viewport } = useVisualViewport();
+ *
+ *   // Always check for null first
+ *   if (!viewport) {
+ *     return <div>Visual Viewport not supported</div>;
+ *   }
+ *
+ *   const { width, height, offsetTop, scale } = viewport;
+ *
+ *   // Hide floating UI when user zooms in
+ *   const showFloatingUI = scale <= 1.3;
+ *
+ *   return (
+ *     <div style={{ height }}>
+ *       {showFloatingUI && <FloatingButton />}
+ *       Viewport-aware content
+ *     </div>
+ *   );
+ * }
+ */
+declare function useVisualViewport(): {
+  viewport: VisualViewportState | null;
+};
+//#endregion
+export { useVisualViewport };

package/dist/mobile/hooks/useVisualViewport/useVisualViewport.d.mts

@@ -0,0 +1,89 @@
+
+//#region src/mobile/hooks/useVisualViewport/useVisualViewport.d.ts
+type VisualViewportState = {
+  /** Viewport width (px) */
+  width: number;
+  /** Viewport height (px) */
+  height: number;
+  /**
+   * Viewport left offset (px) from the layout viewport
+   *
+   * Typically 0 unless horizontal scrolling or panning occurs
+   */
+  offsetLeft: number;
+  /**
+   * Viewport top offset (px) from the layout viewport
+   *
+   * On iOS: Becomes negative when keyboard appears (e.g., -300px means 300px keyboard height)
+   * On Android: Typically remains 0
+   *
+   * Use `-offsetTop` to get accurate keyboard height on iOS
+   */
+  offsetTop: number;
+  /**
+   * Pinch-zoom scaling factor
+   *
+   * - 1.0 = no zoom (default)
+   * - > 1.0 = zoomed in
+   * - < 1.0 = zoomed out (rare, depends on viewport settings)
+   *
+   * @example
+   * ```tsx
+   * const { viewport } = useVisualViewport();
+   * if (viewport && viewport.scale > 1.3) {
+   *   // Hide floating UI when user zooms in
+   *   setShowFloatingButton(false);
+   * }
+   * ```
+   */
+  scale: number;
+};
+/**
+ * @description
+ * `useVisualViewport` is a React hook that tracks Visual Viewport changes.
+ * It returns the actual visible area in mobile WebView, which changes when
+ * the keyboard appears or the user zooms/scrolls.
+ *
+ * **Important:** `viewport` is `null` on SSR or in browsers that don't support Visual Viewport API.
+ * Always check for null before accessing viewport properties.
+ *
+ * **Tip:** If you only need keyboard height, use `useKeyboardHeight()` instead
+ * for a simpler API.
+ *
+ * @returns {{ viewport: VisualViewportState | null }} An object containing the Visual Viewport state.
+ * - viewport `VisualViewportState | null` - Visual Viewport state object, or `null` if not supported (SSR or browsers without the Visual Viewport API);
+ * - viewport.width `number` - Viewport width in pixels;
+ * - viewport.height `number` - Viewport height in pixels;
+ * - viewport.offsetLeft `number` - Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs;
+ * - viewport.offsetTop `number` - Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears, so use `-offsetTop` for the keyboard height. Typically remains 0 on Android;
+ * - viewport.scale `number` - Pinch-zoom scaling factor. 1.0 means no zoom, greater than 1.0 means zoomed in;
+ *
+ * @see {@link useKeyboardHeight} - Simpler hook for keyboard height only
+ *
+ * @example
+ * function CustomLayout() {
+ *   const { viewport } = useVisualViewport();
+ *
+ *   // Always check for null first
+ *   if (!viewport) {
+ *     return <div>Visual Viewport not supported</div>;
+ *   }
+ *
+ *   const { width, height, offsetTop, scale } = viewport;
+ *
+ *   // Hide floating UI when user zooms in
+ *   const showFloatingUI = scale <= 1.3;
+ *
+ *   return (
+ *     <div style={{ height }}>
+ *       {showFloatingUI && <FloatingButton />}
+ *       Viewport-aware content
+ *     </div>
+ *   );
+ * }
+ */
+declare function useVisualViewport(): {
+  viewport: VisualViewportState | null;
+};
+//#endregion
+export { useVisualViewport };

package/dist/mobile/hooks/useVisualViewport/useVisualViewport.mjs

@@ -0,0 +1,77 @@
+"use client";
+import { isServer } from "../../utils/isServer/isServer.mjs";
+import { startTransition, useCallback, useEffect, useState } from "react";
+//#region src/mobile/hooks/useVisualViewport/useVisualViewport.ts
+/**
+* @description
+* `useVisualViewport` is a React hook that tracks Visual Viewport changes.
+* It returns the actual visible area in mobile WebView, which changes when
+* the keyboard appears or the user zooms/scrolls.
+*
+* **Important:** `viewport` is `null` on SSR or in browsers that don't support Visual Viewport API.
+* Always check for null before accessing viewport properties.
+*
+* **Tip:** If you only need keyboard height, use `useKeyboardHeight()` instead
+* for a simpler API.
+*
+* @returns {{ viewport: VisualViewportState | null }} An object containing the Visual Viewport state.
+* - viewport `VisualViewportState | null` - Visual Viewport state object, or `null` if not supported (SSR or browsers without the Visual Viewport API);
+* - viewport.width `number` - Viewport width in pixels;
+* - viewport.height `number` - Viewport height in pixels;
+* - viewport.offsetLeft `number` - Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs;
+* - viewport.offsetTop `number` - Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears, so use `-offsetTop` for the keyboard height. Typically remains 0 on Android;
+* - viewport.scale `number` - Pinch-zoom scaling factor. 1.0 means no zoom, greater than 1.0 means zoomed in;
+*
+* @see {@link useKeyboardHeight} - Simpler hook for keyboard height only
+*
+* @example
+* function CustomLayout() {
+*   const { viewport } = useVisualViewport();
+*
+*   // Always check for null first
+*   if (!viewport) {
+*     return <div>Visual Viewport not supported</div>;
+*   }
+*
+*   const { width, height, offsetTop, scale } = viewport;
+*
+*   // Hide floating UI when user zooms in
+*   const showFloatingUI = scale <= 1.3;
+*
+*   return (
+*     <div style={{ height }}>
+*       {showFloatingUI && <FloatingButton />}
+*       Viewport-aware content
+*     </div>
+*   );
+* }
+*/
+function useVisualViewport() {
+	const visualViewport = isServer() ? null : window.visualViewport;
+	const [viewport, setViewport] = useState(() => visualViewport != null ? getVisualViewportState(visualViewport) : null);
+	const updateViewportState = useCallback(() => {
+		startTransition(() => {
+			setViewport(window.visualViewport != null ? getVisualViewportState(window.visualViewport) : null);
+		});
+	}, []);
+	useEffect(function handleVisualViewportChange() {
+		window.visualViewport?.addEventListener("resize", updateViewportState);
+		window.visualViewport?.addEventListener("scroll", updateViewportState);
+		return function cleanup() {
+			window.visualViewport?.removeEventListener("resize", updateViewportState);
+			window.visualViewport?.removeEventListener("scroll", updateViewportState);
+		};
+	}, [updateViewportState]);
+	return { viewport };
+}
+function getVisualViewportState(visualViewport) {
+	return {
+		width: visualViewport.width,
+		height: visualViewport.height,
+		offsetLeft: visualViewport.offsetLeft,
+		offsetTop: visualViewport.offsetTop,
+		scale: visualViewport.scale
+	};
+}
+//#endregion
+export { useVisualViewport };

package/dist/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.cjs

@@ -0,0 +1,55 @@
+"use client";
+const require_isServer = require("../isServer/isServer.cjs");
+//#region src/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.ts
+/**
+* Data attribute key for storing scroll position
+*/
+const SCROLL_POSITION_ATTR = "data-simplikit-scroll-y";
+/**
+* @description
+* `disableBodyScrollLock` is a utility function that unlocks the body scroll.
+* It restores the scroll locked by `enableBodyScrollLock` and returns to the saved scroll position.
+*
+* Safe to call in SSR environment (no-op on server).
+* Safe to call even if not locked (no-op).
+*
+* @returns {void}
+*
+* @example
+* // When modal opens
+* enableBodyScrollLock();
+*
+* // When modal closes
+* disableBodyScrollLock();
+*/
+function disableBodyScrollLock() {
+	if (require_isServer.isServer()) return;
+	const savedScrollY = document.body.getAttribute(SCROLL_POSITION_ATTR);
+	if (savedScrollY == null) return;
+	removeScrollLockStyles();
+	restoreScrollPosition(savedScrollY);
+	clearSavedScrollPosition();
+}
+function removeScrollLockStyles() {
+	const { body } = document;
+	body.style.removeProperty("overflow");
+	body.style.removeProperty("position");
+	body.style.removeProperty("top");
+	body.style.removeProperty("left");
+	body.style.removeProperty("right");
+	body.style.removeProperty("bottom");
+}
+function restoreScrollPosition(savedScrollY) {
+	const scrollY = Number(savedScrollY);
+	if (Number.isNaN(scrollY)) {
+		console.warn("[react-simplikit] Invalid scroll position, defaulting to 0");
+		window.scrollTo(0, 0);
+		return;
+	}
+	window.scrollTo(0, scrollY);
+}
+function clearSavedScrollPosition() {
+	document.body.removeAttribute(SCROLL_POSITION_ATTR);
+}
+//#endregion
+exports.disableBodyScrollLock = disableBodyScrollLock;

package/dist/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.d.cts

@@ -0,0 +1,22 @@
+
+//#region src/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.d.ts
+/**
+ * @description
+ * `disableBodyScrollLock` is a utility function that unlocks the body scroll.
+ * It restores the scroll locked by `enableBodyScrollLock` and returns to the saved scroll position.
+ *
+ * Safe to call in SSR environment (no-op on server).
+ * Safe to call even if not locked (no-op).
+ *
+ * @returns {void}
+ *
+ * @example
+ * // When modal opens
+ * enableBodyScrollLock();
+ *
+ * // When modal closes
+ * disableBodyScrollLock();
+ */
+declare function disableBodyScrollLock(): void;
+//#endregion
+export { disableBodyScrollLock };

package/dist/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.d.mts

@@ -0,0 +1,22 @@
+
+//#region src/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.d.ts
+/**
+ * @description
+ * `disableBodyScrollLock` is a utility function that unlocks the body scroll.
+ * It restores the scroll locked by `enableBodyScrollLock` and returns to the saved scroll position.
+ *
+ * Safe to call in SSR environment (no-op on server).
+ * Safe to call even if not locked (no-op).
+ *
+ * @returns {void}
+ *
+ * @example
+ * // When modal opens
+ * enableBodyScrollLock();
+ *
+ * // When modal closes
+ * disableBodyScrollLock();
+ */
+declare function disableBodyScrollLock(): void;
+//#endregion
+export { disableBodyScrollLock };

package/dist/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.mjs

@@ -0,0 +1,55 @@
+"use client";
+import { isServer } from "../isServer/isServer.mjs";
+//#region src/mobile/utils/disableBodyScrollLock/disableBodyScrollLock.ts
+/**
+* Data attribute key for storing scroll position
+*/
+const SCROLL_POSITION_ATTR = "data-simplikit-scroll-y";
+/**
+* @description
+* `disableBodyScrollLock` is a utility function that unlocks the body scroll.
+* It restores the scroll locked by `enableBodyScrollLock` and returns to the saved scroll position.
+*
+* Safe to call in SSR environment (no-op on server).
+* Safe to call even if not locked (no-op).
+*
+* @returns {void}
+*
+* @example
+* // When modal opens
+* enableBodyScrollLock();
+*
+* // When modal closes
+* disableBodyScrollLock();
+*/
+function disableBodyScrollLock() {
+	if (isServer()) return;
+	const savedScrollY = document.body.getAttribute(SCROLL_POSITION_ATTR);
+	if (savedScrollY == null) return;
+	removeScrollLockStyles();
+	restoreScrollPosition(savedScrollY);
+	clearSavedScrollPosition();
+}
+function removeScrollLockStyles() {
+	const { body } = document;
+	body.style.removeProperty("overflow");
+	body.style.removeProperty("position");
+	body.style.removeProperty("top");
+	body.style.removeProperty("left");
+	body.style.removeProperty("right");
+	body.style.removeProperty("bottom");
+}
+function restoreScrollPosition(savedScrollY) {
+	const scrollY = Number(savedScrollY);
+	if (Number.isNaN(scrollY)) {
+		console.warn("[react-simplikit] Invalid scroll position, defaulting to 0");
+		window.scrollTo(0, 0);
+		return;
+	}
+	window.scrollTo(0, scrollY);
+}
+function clearSavedScrollPosition() {
+	document.body.removeAttribute(SCROLL_POSITION_ATTR);
+}
+//#endregion
+export { disableBodyScrollLock };

package/dist/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.cjs

@@ -0,0 +1,49 @@
+"use client";
+const require_isServer = require("../isServer/isServer.cjs");
+//#region src/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.ts
+/**
+* Data attribute key for storing scroll position
+*/
+const SCROLL_POSITION_ATTR = "data-simplikit-scroll-y";
+/**
+* @description
+* `enableBodyScrollLock` is a utility function that locks the body scroll.
+* It prevents the body from scrolling by applying fixed positioning.
+* This is useful when opening modals, drawers, or other overlay components.
+*
+* Safe to call in SSR environment (no-op on server).
+* Calling multiple times has no effect until unlocked.
+*
+* @returns {void}
+*
+* @example
+* // When modal opens
+* enableBodyScrollLock();
+*
+* // When modal closes
+* disableBodyScrollLock();
+*/
+function enableBodyScrollLock() {
+	if (require_isServer.isServer()) return;
+	if (isBodyScrollLocked()) return;
+	const scrollY = window.scrollY;
+	saveScrollPosition(scrollY);
+	applyScrollLockStyles(scrollY);
+}
+function isBodyScrollLocked() {
+	return document.body.getAttribute(SCROLL_POSITION_ATTR) != null;
+}
+function saveScrollPosition(scrollY) {
+	document.body.setAttribute(SCROLL_POSITION_ATTR, scrollY.toString());
+}
+function applyScrollLockStyles(scrollY) {
+	const { body } = document;
+	body.style.overflow = "hidden";
+	body.style.position = "fixed";
+	body.style.top = `-${scrollY}px`;
+	body.style.left = "0px";
+	body.style.right = "0px";
+	body.style.bottom = "0px";
+}
+//#endregion
+exports.enableBodyScrollLock = enableBodyScrollLock;

package/dist/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.d.cts

@@ -0,0 +1,23 @@
+
+//#region src/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.d.ts
+/**
+ * @description
+ * `enableBodyScrollLock` is a utility function that locks the body scroll.
+ * It prevents the body from scrolling by applying fixed positioning.
+ * This is useful when opening modals, drawers, or other overlay components.
+ *
+ * Safe to call in SSR environment (no-op on server).
+ * Calling multiple times has no effect until unlocked.
+ *
+ * @returns {void}
+ *
+ * @example
+ * // When modal opens
+ * enableBodyScrollLock();
+ *
+ * // When modal closes
+ * disableBodyScrollLock();
+ */
+declare function enableBodyScrollLock(): void;
+//#endregion
+export { enableBodyScrollLock };

package/dist/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.d.mts

@@ -0,0 +1,23 @@
+
+//#region src/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.d.ts
+/**
+ * @description
+ * `enableBodyScrollLock` is a utility function that locks the body scroll.
+ * It prevents the body from scrolling by applying fixed positioning.
+ * This is useful when opening modals, drawers, or other overlay components.
+ *
+ * Safe to call in SSR environment (no-op on server).
+ * Calling multiple times has no effect until unlocked.
+ *
+ * @returns {void}
+ *
+ * @example
+ * // When modal opens
+ * enableBodyScrollLock();
+ *
+ * // When modal closes
+ * disableBodyScrollLock();
+ */
+declare function enableBodyScrollLock(): void;
+//#endregion
+export { enableBodyScrollLock };

package/dist/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.mjs

@@ -0,0 +1,49 @@
+"use client";
+import { isServer } from "../isServer/isServer.mjs";
+//#region src/mobile/utils/enableBodyScrollLock/enableBodyScrollLock.ts
+/**
+* Data attribute key for storing scroll position
+*/
+const SCROLL_POSITION_ATTR = "data-simplikit-scroll-y";
+/**
+* @description
+* `enableBodyScrollLock` is a utility function that locks the body scroll.
+* It prevents the body from scrolling by applying fixed positioning.
+* This is useful when opening modals, drawers, or other overlay components.
+*
+* Safe to call in SSR environment (no-op on server).
+* Calling multiple times has no effect until unlocked.
+*
+* @returns {void}
+*
+* @example
+* // When modal opens
+* enableBodyScrollLock();
+*
+* // When modal closes
+* disableBodyScrollLock();
+*/
+function enableBodyScrollLock() {
+	if (isServer()) return;
+	if (isBodyScrollLocked()) return;
+	const scrollY = window.scrollY;
+	saveScrollPosition(scrollY);
+	applyScrollLockStyles(scrollY);
+}
+function isBodyScrollLocked() {
+	return document.body.getAttribute(SCROLL_POSITION_ATTR) != null;
+}
+function saveScrollPosition(scrollY) {
+	document.body.setAttribute(SCROLL_POSITION_ATTR, scrollY.toString());
+}
+function applyScrollLockStyles(scrollY) {
+	const { body } = document;
+	body.style.overflow = "hidden";
+	body.style.position = "fixed";
+	body.style.top = `-${scrollY}px`;
+	body.style.left = "0px";
+	body.style.right = "0px";
+	body.style.bottom = "0px";
+}
+//#endregion
+export { enableBodyScrollLock };

package/dist/mobile/utils/getKeyboardHeight/getKeyboardHeight.cjs

@@ -0,0 +1,35 @@
+"use client";
+const require_isServer = require("../isServer/isServer.cjs");
+//#region src/mobile/utils/getKeyboardHeight/getKeyboardHeight.ts
+/**
+* @description
+* `getKeyboardHeight` is a utility function that returns the current on-screen keyboard height in pixels.
+*
+* This function uses the Visual Viewport API to calculate the keyboard height.
+* It assumes a modern environment where Visual Viewport is supported
+* (Safari / WKWebView 14+, Chrome / Android WebView 80+).
+*
+* The keyboard height is computed as:
+*   `window.innerHeight - visualViewport.height - visualViewport.offsetTop`
+*
+* The subtraction of `offsetTop` is required to correctly handle iOS behavior
+* where the visual viewport may shift vertically when the keyboard appears.
+*
+* @returns {number} The keyboard height in pixels. Returns 0 if the keyboard is not visible.
+*
+* @example
+* const height = getKeyboardHeight();
+*
+* if (height > 0) {
+*   footer.style.paddingBottom = `${height}px`;
+* }
+*/
+function getKeyboardHeight() {
+	if (require_isServer.isServer()) return 0;
+	const visualViewport = window.visualViewport;
+	if (visualViewport == null) return 0;
+	const height = window.innerHeight - visualViewport.height - visualViewport.offsetTop;
+	return Math.max(0, height);
+}
+//#endregion
+exports.getKeyboardHeight = getKeyboardHeight;