react-simplikit 0.0.52 → 0.1.0

package/dist/index.cjs

@@ -36,15 +36,43 @@ const require_useThrottle = require("./hooks/useThrottle/useThrottle.cjs");
 const require_useThrottledCallback = require("./hooks/useThrottledCallback/useThrottledCallback.cjs");
 const require_useTimeout = require("./hooks/useTimeout/useTimeout.cjs");
 const require_useToggle = require("./hooks/useToggle/useToggle.cjs");
+const require_isServer = require("./mobile/utils/isServer/isServer.cjs");
+const require_getKeyboardHeight = require("./mobile/utils/getKeyboardHeight/getKeyboardHeight.cjs");
+const require_subscribeKeyboardHeight = require("./mobile/utils/subscribeKeyboardHeight/subscribeKeyboardHeight.cjs");
+const require_useKeyboardHeight = require("./mobile/hooks/useKeyboardHeight/useKeyboardHeight.cjs");
+const require_useAvoidKeyboard = require("./mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.cjs");
+const require_disableBodyScrollLock = require("./mobile/utils/disableBodyScrollLock/disableBodyScrollLock.cjs");
+const require_enableBodyScrollLock = require("./mobile/utils/enableBodyScrollLock/enableBodyScrollLock.cjs");
+const require_useBodyScrollLock = require("./mobile/hooks/useBodyScrollLock/useBodyScrollLock.cjs");
+const require_useNetworkStatus = require("./mobile/hooks/useNetworkStatus/useNetworkStatus.cjs");
+const require_usePageVisibility = require("./mobile/hooks/usePageVisibility/usePageVisibility.cjs");
+const require_getSafeAreaInset = require("./mobile/utils/getSafeAreaInset/getSafeAreaInset.cjs");
+const require_useSafeAreaInset = require("./mobile/hooks/useSafeAreaInset/useSafeAreaInset.cjs");
+const require_useScrollDirection = require("./mobile/hooks/useScrollDirection/useScrollDirection.cjs");
+const require_useVisualViewport = require("./mobile/hooks/useVisualViewport/useVisualViewport.cjs");
+const require_isAndroid = require("./mobile/utils/isAndroid/isAndroid.cjs");
+const require_isIOS = require("./mobile/utils/isIOS/isIOS.cjs");
+const require_isKeyboardVisible = require("./mobile/utils/isKeyboardVisible/isKeyboardVisible.cjs");
 const require_buildContext = require("./utils/buildContext/buildContext.cjs");
 const require_mergeProps = require("./utils/mergeProps/mergeProps.cjs");
 exports.ImpressionArea = require_ImpressionArea.ImpressionArea;
 exports.Separated = require_Separated.Separated;
 exports.SwitchCase = require_SwitchCase.SwitchCase;
 exports.buildContext = require_buildContext.buildContext;
+exports.disableBodyScrollLock = require_disableBodyScrollLock.disableBodyScrollLock;
+exports.enableBodyScrollLock = require_enableBodyScrollLock.enableBodyScrollLock;
+exports.getKeyboardHeight = require_getKeyboardHeight.getKeyboardHeight;
+exports.getSafeAreaInset = require_getSafeAreaInset.getSafeAreaInset;
+exports.isAndroid = require_isAndroid.isAndroid;
+exports.isIOS = require_isIOS.isIOS;
+exports.isKeyboardVisible = require_isKeyboardVisible.isKeyboardVisible;
+exports.isServer = require_isServer.isServer;
 exports.mergeProps = require_mergeProps.mergeProps;
 exports.mergeRefs = require_mergeRefs.mergeRefs;
+exports.subscribeKeyboardHeight = require_subscribeKeyboardHeight.subscribeKeyboardHeight;
 exports.useAsyncEffect = require_useAsyncEffect.useAsyncEffect;
+exports.useAvoidKeyboard = require_useAvoidKeyboard.useAvoidKeyboard;
+exports.useBodyScrollLock = require_useBodyScrollLock.useBodyScrollLock;
 exports.useBooleanState = require_useBooleanState.useBooleanState;
 exports.useCallbackOncePerRender = require_useCallbackOncePerRender.useCallbackOncePerRender;
 exports.useConditionalEffect = require_useConditionalEffect.useConditionalEffect;
@@ -60,15 +88,20 @@ exports.useIntersectionObserver = require_useIntersectionObserver.useIntersectio
 exports.useInterval = require_useInterval.useInterval;
 exports.useIsClient = require_useIsClient.useIsClient;
 exports.useIsomorphicLayoutEffect = require_useIsomorphicLayoutEffect.useIsomorphicLayoutEffect;
+exports.useKeyboardHeight = require_useKeyboardHeight.useKeyboardHeight;
 exports.useList = require_useList.useList;
 exports.useLoading = require_useLoading.useLoading;
 exports.useLongPress = require_useLongPress.useLongPress;
 exports.useMap = require_useMap.useMap;
+exports.useNetworkStatus = require_useNetworkStatus.useNetworkStatus;
 exports.useOutsideClickEffect = require_useOutsideClickEffect.useOutsideClickEffect;
+exports.usePageVisibility = require_usePageVisibility.usePageVisibility;
 exports.usePreservedCallback = require_usePreservedCallback.usePreservedCallback;
 exports.usePreservedReference = require_usePreservedReference.usePreservedReference;
 exports.usePrevious = require_usePrevious.usePrevious;
 exports.useRefEffect = require_useRefEffect.useRefEffect;
+exports.useSafeAreaInset = require_useSafeAreaInset.useSafeAreaInset;
+exports.useScrollDirection = require_useScrollDirection.useScrollDirection;
 exports.useSet = require_useSet.useSet;
 exports.useStorageState = require_useStorageState.useStorageState;
 exports.useThrottle = require_useThrottle.useThrottle;
@@ -76,3 +109,4 @@ exports.useThrottledCallback = require_useThrottledCallback.useThrottledCallback
 exports.useTimeout = require_useTimeout.useTimeout;
 exports.useToggle = require_useToggle.useToggle;
 exports.useVisibilityEvent = require_useVisibilityEvent.useVisibilityEvent;
+exports.useVisualViewport = require_useVisualViewport.useVisualViewport;

package/dist/index.d.cts

@@ -47,10 +47,28 @@ import { useThrottledCallback } from "./hooks/useThrottledCallback/useThrottledC
 import { useTimeout } from "./hooks/useTimeout/useTimeout.cjs";
 import { useToggle } from "./hooks/useToggle/useToggle.cjs";
 import { useVisibilityEvent } from "./hooks/useVisibilityEvent/useVisibilityEvent.cjs";
+import { useAvoidKeyboard } from "./mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.cjs";
+import "./mobile/hooks/useAvoidKeyboard/index.cjs";
+import { useBodyScrollLock } from "./mobile/hooks/useBodyScrollLock/useBodyScrollLock.cjs";
+import { useKeyboardHeight } from "./mobile/hooks/useKeyboardHeight/useKeyboardHeight.cjs";
+import { ConnectionType, EffectiveConnectionType, NetworkStatus, useNetworkStatus } from "./mobile/hooks/useNetworkStatus/useNetworkStatus.cjs";
+import { PageVisibility, VisibilityState, usePageVisibility } from "./mobile/hooks/usePageVisibility/usePageVisibility.cjs";
+import { getSafeAreaInset } from "./mobile/utils/getSafeAreaInset/getSafeAreaInset.cjs";
+import { useSafeAreaInset } from "./mobile/hooks/useSafeAreaInset/useSafeAreaInset.cjs";
+import { useScrollDirection } from "./mobile/hooks/useScrollDirection/useScrollDirection.cjs";
+import { useVisualViewport } from "./mobile/hooks/useVisualViewport/useVisualViewport.cjs";
+import { disableBodyScrollLock } from "./mobile/utils/disableBodyScrollLock/disableBodyScrollLock.cjs";
+import { enableBodyScrollLock } from "./mobile/utils/enableBodyScrollLock/enableBodyScrollLock.cjs";
+import { getKeyboardHeight } from "./mobile/utils/getKeyboardHeight/getKeyboardHeight.cjs";
+import { isAndroid } from "./mobile/utils/isAndroid/isAndroid.cjs";
+import { isIOS } from "./mobile/utils/isIOS/isIOS.cjs";
+import { isKeyboardVisible } from "./mobile/utils/isKeyboardVisible/isKeyboardVisible.cjs";
+import { isServer } from "./mobile/utils/isServer/isServer.cjs";
+import { subscribeKeyboardHeight } from "./mobile/utils/subscribeKeyboardHeight/subscribeKeyboardHeight.cjs";
 import { buildContext } from "./utils/buildContext/buildContext.cjs";
 import "./utils/buildContext/index.cjs";
 import { mergeProps } from "./utils/mergeProps/mergeProps.cjs";
 import "./utils/mergeProps/index.cjs";
 import { mergeRefs } from "./utils/mergeRefs/mergeRefs.cjs";
 import "./utils/mergeRefs/index.cjs";
-export { ImpressionArea, Separated, SwitchCase, buildContext, mergeProps, mergeRefs, useAsyncEffect, useBooleanState, useCallbackOncePerRender, useConditionalEffect, useControlledState, useCounter, useDebounce, useDebouncedCallback, useDoubleClick, useGeolocation, useImpressionRef, useInputState, useIntersectionObserver, useInterval, useIsClient, useIsomorphicLayoutEffect, useList, useLoading, useLongPress, useMap, useOutsideClickEffect, usePreservedCallback, usePreservedReference, usePrevious, useRefEffect, useSet, useStorageState, useThrottle, useThrottledCallback, useTimeout, useToggle, useVisibilityEvent };
+export { type ConnectionType, type EffectiveConnectionType, ImpressionArea, type NetworkStatus, type PageVisibility, Separated, SwitchCase, type VisibilityState, buildContext, disableBodyScrollLock, enableBodyScrollLock, getKeyboardHeight, getSafeAreaInset, isAndroid, isIOS, isKeyboardVisible, isServer, mergeProps, mergeRefs, subscribeKeyboardHeight, useAsyncEffect, useAvoidKeyboard, useBodyScrollLock, useBooleanState, useCallbackOncePerRender, useConditionalEffect, useControlledState, useCounter, useDebounce, useDebouncedCallback, useDoubleClick, useGeolocation, useImpressionRef, useInputState, useIntersectionObserver, useInterval, useIsClient, useIsomorphicLayoutEffect, useKeyboardHeight, useList, useLoading, useLongPress, useMap, useNetworkStatus, useOutsideClickEffect, usePageVisibility, usePreservedCallback, usePreservedReference, usePrevious, useRefEffect, useSafeAreaInset, useScrollDirection, useSet, useStorageState, useThrottle, useThrottledCallback, useTimeout, useToggle, useVisibilityEvent, useVisualViewport };

package/dist/index.d.mts

@@ -47,10 +47,28 @@ import { useThrottledCallback } from "./hooks/useThrottledCallback/useThrottledC
 import { useTimeout } from "./hooks/useTimeout/useTimeout.mjs";
 import { useToggle } from "./hooks/useToggle/useToggle.mjs";
 import { useVisibilityEvent } from "./hooks/useVisibilityEvent/useVisibilityEvent.mjs";
+import { useAvoidKeyboard } from "./mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.mjs";
+import "./mobile/hooks/useAvoidKeyboard/index.mjs";
+import { useBodyScrollLock } from "./mobile/hooks/useBodyScrollLock/useBodyScrollLock.mjs";
+import { useKeyboardHeight } from "./mobile/hooks/useKeyboardHeight/useKeyboardHeight.mjs";
+import { ConnectionType, EffectiveConnectionType, NetworkStatus, useNetworkStatus } from "./mobile/hooks/useNetworkStatus/useNetworkStatus.mjs";
+import { PageVisibility, VisibilityState, usePageVisibility } from "./mobile/hooks/usePageVisibility/usePageVisibility.mjs";
+import { getSafeAreaInset } from "./mobile/utils/getSafeAreaInset/getSafeAreaInset.mjs";
+import { useSafeAreaInset } from "./mobile/hooks/useSafeAreaInset/useSafeAreaInset.mjs";
+import { useScrollDirection } from "./mobile/hooks/useScrollDirection/useScrollDirection.mjs";
+import { useVisualViewport } from "./mobile/hooks/useVisualViewport/useVisualViewport.mjs";
+import { disableBodyScrollLock } from "./mobile/utils/disableBodyScrollLock/disableBodyScrollLock.mjs";
+import { enableBodyScrollLock } from "./mobile/utils/enableBodyScrollLock/enableBodyScrollLock.mjs";
+import { getKeyboardHeight } from "./mobile/utils/getKeyboardHeight/getKeyboardHeight.mjs";
+import { isAndroid } from "./mobile/utils/isAndroid/isAndroid.mjs";
+import { isIOS } from "./mobile/utils/isIOS/isIOS.mjs";
+import { isKeyboardVisible } from "./mobile/utils/isKeyboardVisible/isKeyboardVisible.mjs";
+import { isServer } from "./mobile/utils/isServer/isServer.mjs";
+import { subscribeKeyboardHeight } from "./mobile/utils/subscribeKeyboardHeight/subscribeKeyboardHeight.mjs";
 import { buildContext } from "./utils/buildContext/buildContext.mjs";
 import "./utils/buildContext/index.mjs";
 import { mergeProps } from "./utils/mergeProps/mergeProps.mjs";
 import "./utils/mergeProps/index.mjs";
 import { mergeRefs } from "./utils/mergeRefs/mergeRefs.mjs";
 import "./utils/mergeRefs/index.mjs";
-export { ImpressionArea, Separated, SwitchCase, buildContext, mergeProps, mergeRefs, useAsyncEffect, useBooleanState, useCallbackOncePerRender, useConditionalEffect, useControlledState, useCounter, useDebounce, useDebouncedCallback, useDoubleClick, useGeolocation, useImpressionRef, useInputState, useIntersectionObserver, useInterval, useIsClient, useIsomorphicLayoutEffect, useList, useLoading, useLongPress, useMap, useOutsideClickEffect, usePreservedCallback, usePreservedReference, usePrevious, useRefEffect, useSet, useStorageState, useThrottle, useThrottledCallback, useTimeout, useToggle, useVisibilityEvent };
+export { type ConnectionType, type EffectiveConnectionType, ImpressionArea, type NetworkStatus, type PageVisibility, Separated, SwitchCase, type VisibilityState, buildContext, disableBodyScrollLock, enableBodyScrollLock, getKeyboardHeight, getSafeAreaInset, isAndroid, isIOS, isKeyboardVisible, isServer, mergeProps, mergeRefs, subscribeKeyboardHeight, useAsyncEffect, useAvoidKeyboard, useBodyScrollLock, useBooleanState, useCallbackOncePerRender, useConditionalEffect, useControlledState, useCounter, useDebounce, useDebouncedCallback, useDoubleClick, useGeolocation, useImpressionRef, useInputState, useIntersectionObserver, useInterval, useIsClient, useIsomorphicLayoutEffect, useKeyboardHeight, useList, useLoading, useLongPress, useMap, useNetworkStatus, useOutsideClickEffect, usePageVisibility, usePreservedCallback, usePreservedReference, usePrevious, useRefEffect, useSafeAreaInset, useScrollDirection, useSet, useStorageState, useThrottle, useThrottledCallback, useTimeout, useToggle, useVisibilityEvent, useVisualViewport };

package/dist/index.mjs

@@ -35,6 +35,23 @@ import { useThrottle } from "./hooks/useThrottle/useThrottle.mjs";
 import { useThrottledCallback } from "./hooks/useThrottledCallback/useThrottledCallback.mjs";
 import { useTimeout } from "./hooks/useTimeout/useTimeout.mjs";
 import { useToggle } from "./hooks/useToggle/useToggle.mjs";
+import { isServer } from "./mobile/utils/isServer/isServer.mjs";
+import { getKeyboardHeight } from "./mobile/utils/getKeyboardHeight/getKeyboardHeight.mjs";
+import { subscribeKeyboardHeight } from "./mobile/utils/subscribeKeyboardHeight/subscribeKeyboardHeight.mjs";
+import { useKeyboardHeight } from "./mobile/hooks/useKeyboardHeight/useKeyboardHeight.mjs";
+import { useAvoidKeyboard } from "./mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.mjs";
+import { disableBodyScrollLock } from "./mobile/utils/disableBodyScrollLock/disableBodyScrollLock.mjs";
+import { enableBodyScrollLock } from "./mobile/utils/enableBodyScrollLock/enableBodyScrollLock.mjs";
+import { useBodyScrollLock } from "./mobile/hooks/useBodyScrollLock/useBodyScrollLock.mjs";
+import { useNetworkStatus } from "./mobile/hooks/useNetworkStatus/useNetworkStatus.mjs";
+import { usePageVisibility } from "./mobile/hooks/usePageVisibility/usePageVisibility.mjs";
+import { getSafeAreaInset } from "./mobile/utils/getSafeAreaInset/getSafeAreaInset.mjs";
+import { useSafeAreaInset } from "./mobile/hooks/useSafeAreaInset/useSafeAreaInset.mjs";
+import { useScrollDirection } from "./mobile/hooks/useScrollDirection/useScrollDirection.mjs";
+import { useVisualViewport } from "./mobile/hooks/useVisualViewport/useVisualViewport.mjs";
+import { isAndroid } from "./mobile/utils/isAndroid/isAndroid.mjs";
+import { isIOS } from "./mobile/utils/isIOS/isIOS.mjs";
+import { isKeyboardVisible } from "./mobile/utils/isKeyboardVisible/isKeyboardVisible.mjs";
 import { buildContext } from "./utils/buildContext/buildContext.mjs";
 import { mergeProps } from "./utils/mergeProps/mergeProps.mjs";
-export { ImpressionArea, Separated, SwitchCase, buildContext, mergeProps, mergeRefs, useAsyncEffect, useBooleanState, useCallbackOncePerRender, useConditionalEffect, useControlledState, useCounter, useDebounce, useDebouncedCallback, useDoubleClick, useGeolocation, useImpressionRef, useInputState, useIntersectionObserver, useInterval, useIsClient, useIsomorphicLayoutEffect, useList, useLoading, useLongPress, useMap, useOutsideClickEffect, usePreservedCallback, usePreservedReference, usePrevious, useRefEffect, useSet, useStorageState, useThrottle, useThrottledCallback, useTimeout, useToggle, useVisibilityEvent };
+export { ImpressionArea, Separated, SwitchCase, buildContext, disableBodyScrollLock, enableBodyScrollLock, getKeyboardHeight, getSafeAreaInset, isAndroid, isIOS, isKeyboardVisible, isServer, mergeProps, mergeRefs, subscribeKeyboardHeight, useAsyncEffect, useAvoidKeyboard, useBodyScrollLock, useBooleanState, useCallbackOncePerRender, useConditionalEffect, useControlledState, useCounter, useDebounce, useDebouncedCallback, useDoubleClick, useGeolocation, useImpressionRef, useInputState, useIntersectionObserver, useInterval, useIsClient, useIsomorphicLayoutEffect, useKeyboardHeight, useList, useLoading, useLongPress, useMap, useNetworkStatus, useOutsideClickEffect, usePageVisibility, usePreservedCallback, usePreservedReference, usePrevious, useRefEffect, useSafeAreaInset, useScrollDirection, useSet, useStorageState, useThrottle, useThrottledCallback, useTimeout, useToggle, useVisibilityEvent, useVisualViewport };

package/dist/mobile/hooks/useAvoidKeyboard/index.d.cts

@@ -0,0 +1,3 @@
+
+import { useAvoidKeyboard } from "./useAvoidKeyboard.cjs";
+export { useAvoidKeyboard };

package/dist/mobile/hooks/useAvoidKeyboard/index.d.mts

@@ -0,0 +1,3 @@
+
+import { useAvoidKeyboard } from "./useAvoidKeyboard.mjs";
+export { useAvoidKeyboard };

package/dist/mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.cjs

@@ -0,0 +1,75 @@
+"use client";
+const require_useKeyboardHeight = require("../useKeyboardHeight/useKeyboardHeight.cjs");
+let react = require("react");
+//#region src/mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.ts
+/**
+* @description
+* `useAvoidKeyboard` is a React hook that helps fixed-bottom elements avoid the on-screen keyboard.
+* It returns a CSS style that can be applied to `position: fixed` elements
+* to smoothly move them above the keyboard when it appears.
+*
+* @param {UseAvoidKeyboardOptions} [options] - Configuration options.
+* @param {number} [options.safeAreaBottom=0] - Base bottom offset in pixels when the keyboard is hidden. Useful for accounting for the iPhone home indicator area.
+* @param {number} [options.transitionDuration=200] - Transition duration in milliseconds for smooth animation.
+* @param {CSSProperties['transitionTimingFunction']} [options.transitionTimingFunction='ease-out'] - Transition timing function for the animation.
+* @param {boolean} [options.immediate=true] - If true, gets the initial keyboard height on mount.
+*
+* @returns {UseAvoidKeyboardResult} An object containing the CSS style for keyboard avoidance.
+* - style `CSSProperties` - CSS style object to apply to the fixed bottom element. Contains `transform` and `transition` properties;
+*
+* @example
+* function FixedBottomCTA() {
+*   const { style } = useAvoidKeyboard();
+*
+*   return (
+*     <div
+*       style={{
+*         position: 'fixed',
+*         bottom: 0,
+*         left: 0,
+*         right: 0,
+*         ...style,
+*       }}
+*     >
+*       <button>Submit</button>
+*     </div>
+*   );
+* }
+*
+* @example
+* // With safe area bottom offset (e.g., for iPhone home indicator)
+* function FixedBottomCTA() {
+*   const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+*
+*   return (
+*     <div
+*       style={{
+*         position: 'fixed',
+*         bottom: 0,
+*         left: 0,
+*         right: 0,
+*         ...style,
+*       }}
+*     >
+*       <button>Submit</button>
+*     </div>
+*   );
+* }
+*/
+function useAvoidKeyboard(options = {}) {
+	const { safeAreaBottom = 0, transitionDuration = 200, transitionTimingFunction = "ease-out", immediate = true } = options;
+	const { keyboardHeight } = require_useKeyboardHeight.useKeyboardHeight({ immediate });
+	return { style: (0, react.useMemo)(() => {
+		return {
+			transform: `translateY(${keyboardHeight > 0 ? -(keyboardHeight + safeAreaBottom) : 0}px)`,
+			transition: `transform ${transitionDuration}ms ${transitionTimingFunction}`
+		};
+	}, [
+		keyboardHeight,
+		safeAreaBottom,
+		transitionDuration,
+		transitionTimingFunction
+	]) };
+}
+//#endregion
+exports.useAvoidKeyboard = useAvoidKeyboard;

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

@@ -0,0 +1,89 @@
+
+import { CSSProperties } from "react";
+//#region src/mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.d.ts
+type UseAvoidKeyboardOptions = {
+  /**
+   * Base bottom offset in pixels when keyboard is hidden.
+   * @default 0
+   */
+  safeAreaBottom?: number;
+  /**
+   * Transition duration in milliseconds for smooth animation.
+   * @default 200
+   */
+  transitionDuration?: number;
+  /**
+   * Transition timing function for the animation.
+   * @default 'ease-out'
+   */
+  transitionTimingFunction?: CSSProperties['transitionTimingFunction'];
+  /**
+   * If true, the hook will get the initial keyboard height on mount.
+   * @default true
+   */
+  immediate?: boolean;
+};
+type UseAvoidKeyboardResult = {
+  /**
+   * CSS style object to apply to the fixed bottom element.
+   * Contains transform and transition properties.
+   */
+  style: CSSProperties;
+};
+/**
+ * @description
+ * `useAvoidKeyboard` is a React hook that helps fixed-bottom elements avoid the on-screen keyboard.
+ * It returns a CSS style that can be applied to `position: fixed` elements
+ * to smoothly move them above the keyboard when it appears.
+ *
+ * @param {UseAvoidKeyboardOptions} [options] - Configuration options.
+ * @param {number} [options.safeAreaBottom=0] - Base bottom offset in pixels when the keyboard is hidden. Useful for accounting for the iPhone home indicator area.
+ * @param {number} [options.transitionDuration=200] - Transition duration in milliseconds for smooth animation.
+ * @param {CSSProperties['transitionTimingFunction']} [options.transitionTimingFunction='ease-out'] - Transition timing function for the animation.
+ * @param {boolean} [options.immediate=true] - If true, gets the initial keyboard height on mount.
+ *
+ * @returns {UseAvoidKeyboardResult} An object containing the CSS style for keyboard avoidance.
+ * - style `CSSProperties` - CSS style object to apply to the fixed bottom element. Contains `transform` and `transition` properties;
+ *
+ * @example
+ * function FixedBottomCTA() {
+ *   const { style } = useAvoidKeyboard();
+ *
+ *   return (
+ *     <div
+ *       style={{
+ *         position: 'fixed',
+ *         bottom: 0,
+ *         left: 0,
+ *         right: 0,
+ *         ...style,
+ *       }}
+ *     >
+ *       <button>Submit</button>
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // With safe area bottom offset (e.g., for iPhone home indicator)
+ * function FixedBottomCTA() {
+ *   const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+ *
+ *   return (
+ *     <div
+ *       style={{
+ *         position: 'fixed',
+ *         bottom: 0,
+ *         left: 0,
+ *         right: 0,
+ *         ...style,
+ *       }}
+ *     >
+ *       <button>Submit</button>
+ *     </div>
+ *   );
+ * }
+ */
+declare function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): UseAvoidKeyboardResult;
+//#endregion
+export { useAvoidKeyboard };

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

@@ -0,0 +1,89 @@
+
+import { CSSProperties } from "react";
+//#region src/mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.d.ts
+type UseAvoidKeyboardOptions = {
+  /**
+   * Base bottom offset in pixels when keyboard is hidden.
+   * @default 0
+   */
+  safeAreaBottom?: number;
+  /**
+   * Transition duration in milliseconds for smooth animation.
+   * @default 200
+   */
+  transitionDuration?: number;
+  /**
+   * Transition timing function for the animation.
+   * @default 'ease-out'
+   */
+  transitionTimingFunction?: CSSProperties['transitionTimingFunction'];
+  /**
+   * If true, the hook will get the initial keyboard height on mount.
+   * @default true
+   */
+  immediate?: boolean;
+};
+type UseAvoidKeyboardResult = {
+  /**
+   * CSS style object to apply to the fixed bottom element.
+   * Contains transform and transition properties.
+   */
+  style: CSSProperties;
+};
+/**
+ * @description
+ * `useAvoidKeyboard` is a React hook that helps fixed-bottom elements avoid the on-screen keyboard.
+ * It returns a CSS style that can be applied to `position: fixed` elements
+ * to smoothly move them above the keyboard when it appears.
+ *
+ * @param {UseAvoidKeyboardOptions} [options] - Configuration options.
+ * @param {number} [options.safeAreaBottom=0] - Base bottom offset in pixels when the keyboard is hidden. Useful for accounting for the iPhone home indicator area.
+ * @param {number} [options.transitionDuration=200] - Transition duration in milliseconds for smooth animation.
+ * @param {CSSProperties['transitionTimingFunction']} [options.transitionTimingFunction='ease-out'] - Transition timing function for the animation.
+ * @param {boolean} [options.immediate=true] - If true, gets the initial keyboard height on mount.
+ *
+ * @returns {UseAvoidKeyboardResult} An object containing the CSS style for keyboard avoidance.
+ * - style `CSSProperties` - CSS style object to apply to the fixed bottom element. Contains `transform` and `transition` properties;
+ *
+ * @example
+ * function FixedBottomCTA() {
+ *   const { style } = useAvoidKeyboard();
+ *
+ *   return (
+ *     <div
+ *       style={{
+ *         position: 'fixed',
+ *         bottom: 0,
+ *         left: 0,
+ *         right: 0,
+ *         ...style,
+ *       }}
+ *     >
+ *       <button>Submit</button>
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // With safe area bottom offset (e.g., for iPhone home indicator)
+ * function FixedBottomCTA() {
+ *   const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+ *
+ *   return (
+ *     <div
+ *       style={{
+ *         position: 'fixed',
+ *         bottom: 0,
+ *         left: 0,
+ *         right: 0,
+ *         ...style,
+ *       }}
+ *     >
+ *       <button>Submit</button>
+ *     </div>
+ *   );
+ * }
+ */
+declare function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): UseAvoidKeyboardResult;
+//#endregion
+export { useAvoidKeyboard };

package/dist/mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.mjs

@@ -0,0 +1,75 @@
+"use client";
+import { useKeyboardHeight } from "../useKeyboardHeight/useKeyboardHeight.mjs";
+import { useMemo } from "react";
+//#region src/mobile/hooks/useAvoidKeyboard/useAvoidKeyboard.ts
+/**
+* @description
+* `useAvoidKeyboard` is a React hook that helps fixed-bottom elements avoid the on-screen keyboard.
+* It returns a CSS style that can be applied to `position: fixed` elements
+* to smoothly move them above the keyboard when it appears.
+*
+* @param {UseAvoidKeyboardOptions} [options] - Configuration options.
+* @param {number} [options.safeAreaBottom=0] - Base bottom offset in pixels when the keyboard is hidden. Useful for accounting for the iPhone home indicator area.
+* @param {number} [options.transitionDuration=200] - Transition duration in milliseconds for smooth animation.
+* @param {CSSProperties['transitionTimingFunction']} [options.transitionTimingFunction='ease-out'] - Transition timing function for the animation.
+* @param {boolean} [options.immediate=true] - If true, gets the initial keyboard height on mount.
+*
+* @returns {UseAvoidKeyboardResult} An object containing the CSS style for keyboard avoidance.
+* - style `CSSProperties` - CSS style object to apply to the fixed bottom element. Contains `transform` and `transition` properties;
+*
+* @example
+* function FixedBottomCTA() {
+*   const { style } = useAvoidKeyboard();
+*
+*   return (
+*     <div
+*       style={{
+*         position: 'fixed',
+*         bottom: 0,
+*         left: 0,
+*         right: 0,
+*         ...style,
+*       }}
+*     >
+*       <button>Submit</button>
+*     </div>
+*   );
+* }
+*
+* @example
+* // With safe area bottom offset (e.g., for iPhone home indicator)
+* function FixedBottomCTA() {
+*   const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+*
+*   return (
+*     <div
+*       style={{
+*         position: 'fixed',
+*         bottom: 0,
+*         left: 0,
+*         right: 0,
+*         ...style,
+*       }}
+*     >
+*       <button>Submit</button>
+*     </div>
+*   );
+* }
+*/
+function useAvoidKeyboard(options = {}) {
+	const { safeAreaBottom = 0, transitionDuration = 200, transitionTimingFunction = "ease-out", immediate = true } = options;
+	const { keyboardHeight } = useKeyboardHeight({ immediate });
+	return { style: useMemo(() => {
+		return {
+			transform: `translateY(${keyboardHeight > 0 ? -(keyboardHeight + safeAreaBottom) : 0}px)`,
+			transition: `transform ${transitionDuration}ms ${transitionTimingFunction}`
+		};
+	}, [
+		keyboardHeight,
+		safeAreaBottom,
+		transitionDuration,
+		transitionTimingFunction
+	]) };
+}
+//#endregion
+export { useAvoidKeyboard };

package/dist/mobile/hooks/useBodyScrollLock/useBodyScrollLock.cjs

@@ -0,0 +1,47 @@
+"use client";
+const require_disableBodyScrollLock = require("../../utils/disableBodyScrollLock/disableBodyScrollLock.cjs");
+const require_enableBodyScrollLock = require("../../utils/enableBodyScrollLock/enableBodyScrollLock.cjs");
+let react = require("react");
+//#region src/mobile/hooks/useBodyScrollLock/useBodyScrollLock.ts
+/**
+* @description
+* `useBodyScrollLock` is a React hook that locks body scroll while the component is mounted.
+* It automatically locks on mount and unlocks on unmount.
+*
+* **Note:** For multiple overlapping modals, use a single lock at the parent level.
+*
+* @example
+* function Modal() {
+*   useBodyScrollLock();
+*   return <div className="modal">Modal content</div>;
+* }
+*
+* @example
+* // Multiple modals - single lock pattern
+* function BodyScrollLock() {
+*   useBodyScrollLock();
+*   return null;
+* }
+*
+* function App() {
+*   const hasModal = showModal1 || showModal2;
+*
+*   return (
+*     <>
+*       {hasModal && <BodyScrollLock />}
+*       {showModal1 && <Modal1 />}
+*       {showModal2 && <Modal2 />}
+*     </>
+*   );
+* }
+*/
+function useBodyScrollLock() {
+	(0, react.useEffect)(() => {
+		require_enableBodyScrollLock.enableBodyScrollLock();
+		return () => {
+			require_disableBodyScrollLock.disableBodyScrollLock();
+		};
+	}, []);
+}
+//#endregion
+exports.useBodyScrollLock = useBodyScrollLock;

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

@@ -0,0 +1,37 @@
+
+//#region src/mobile/hooks/useBodyScrollLock/useBodyScrollLock.d.ts
+/**
+ * @description
+ * `useBodyScrollLock` is a React hook that locks body scroll while the component is mounted.
+ * It automatically locks on mount and unlocks on unmount.
+ *
+ * **Note:** For multiple overlapping modals, use a single lock at the parent level.
+ *
+ * @example
+ * function Modal() {
+ *   useBodyScrollLock();
+ *   return <div className="modal">Modal content</div>;
+ * }
+ *
+ * @example
+ * // Multiple modals - single lock pattern
+ * function BodyScrollLock() {
+ *   useBodyScrollLock();
+ *   return null;
+ * }
+ *
+ * function App() {
+ *   const hasModal = showModal1 || showModal2;
+ *
+ *   return (
+ *     <>
+ *       {hasModal && <BodyScrollLock />}
+ *       {showModal1 && <Modal1 />}
+ *       {showModal2 && <Modal2 />}
+ *     </>
+ *   );
+ * }
+ */
+declare function useBodyScrollLock(): void;
+//#endregion
+export { useBodyScrollLock };

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

@@ -0,0 +1,37 @@
+
+//#region src/mobile/hooks/useBodyScrollLock/useBodyScrollLock.d.ts
+/**
+ * @description
+ * `useBodyScrollLock` is a React hook that locks body scroll while the component is mounted.
+ * It automatically locks on mount and unlocks on unmount.
+ *
+ * **Note:** For multiple overlapping modals, use a single lock at the parent level.
+ *
+ * @example
+ * function Modal() {
+ *   useBodyScrollLock();
+ *   return <div className="modal">Modal content</div>;
+ * }
+ *
+ * @example
+ * // Multiple modals - single lock pattern
+ * function BodyScrollLock() {
+ *   useBodyScrollLock();
+ *   return null;
+ * }
+ *
+ * function App() {
+ *   const hasModal = showModal1 || showModal2;
+ *
+ *   return (
+ *     <>
+ *       {hasModal && <BodyScrollLock />}
+ *       {showModal1 && <Modal1 />}
+ *       {showModal2 && <Modal2 />}
+ *     </>
+ *   );
+ * }
+ */
+declare function useBodyScrollLock(): void;
+//#endregion
+export { useBodyScrollLock };