react-simplikit 0.0.53 → 0.2.0

package/dist/hooks/useSet/useSet.d.mts

@@ -14,8 +14,17 @@ type UseSetReturn<T> = [Omit<Set<T>, 'add' | 'clear' | 'delete'>, SetActions<T>]
  * A React hook that manages a Set as state.
  * Provides efficient state management and stable action functions.
  *
- * @param {SetOrValues<T>} initialState - Initial Set state (Set object or array of values)
- * @returns {UseSetReturn<T>} A tuple containing the Set state and actions to manipulate it
+ * @template T - The type of the values held in the set.
+ *
+ * @param {SetOrValues<T>} [initialState=new Set()] - Initial Set state (Set object or array of values).
+ *
+ * @returns {UseSetReturn<T>} A tuple containing the Set state and actions to manipulate it.
+ * - [0] `Omit<Set<T>, 'add' | 'clear' | 'delete'>` - The current Set state with mutation methods hidden;
+ * - [1].add `(value: T) => void` - Adds a value to the set;
+ * - [1].remove `(value: T) => void` - Removes a value from the set;
+ * - [1].toggle `(value: T) => void` - Adds the value if absent, removes it if present;
+ * - [1].setAll `(values: Set<T> | T[]) => void` - Replaces all values in the set;
+ * - [1].reset `() => void` - Resets the set to its initial state;
  *
  * @example
  * ```tsx

package/dist/hooks/useSet/useSet.mjs

@@ -8,8 +8,17 @@ import { useMemo, useState } from "react";
 * A React hook that manages a Set as state.
 * Provides efficient state management and stable action functions.
 *
-* @param {SetOrValues<T>} initialState - Initial Set state (Set object or array of values)
-* @returns {UseSetReturn<T>} A tuple containing the Set state and actions to manipulate it
+* @template T - The type of the values held in the set.
+*
+* @param {SetOrValues<T>} [initialState=new Set()] - Initial Set state (Set object or array of values).
+*
+* @returns {UseSetReturn<T>} A tuple containing the Set state and actions to manipulate it.
+* - [0] `Omit<Set<T>, 'add' | 'clear' | 'delete'>` - The current Set state with mutation methods hidden;
+* - [1].add `(value: T) => void` - Adds a value to the set;
+* - [1].remove `(value: T) => void` - Removes a value from the set;
+* - [1].toggle `(value: T) => void` - Adds the value if absent, removes it if present;
+* - [1].setAll `(values: Set<T> | T[]) => void` - Replaces all values in the set;
+* - [1].reset `() => void` - Resets the set to its initial state;
 *
 * @example
 * ```tsx

package/dist/hooks/useStorageState/useStorageState.cjs

@@ -20,6 +20,7 @@ const ensureSerializable = (value) => {
 	return value;
 };
 function useStorageState(key, { storage = require_storage.safeLocalStorage, defaultValue, ...options } = {}) {
+	"use no memo";
 	const serializedDefaultValue = defaultValue;
 	const cache = (0, react.useRef)({
 		data: null,

package/dist/hooks/useStorageState/useStorageState.d.cts

@@ -17,10 +17,6 @@ type StorageStateOptionsWithSerializer<T> = StorageStateOptions<T> & {
 };
 type SerializableGuard<T extends readonly any[]> = T[0] extends any ? T : T[0] extends never ? 'Received a non-serializable value' : T;
 /**
- * @deprecated This hook is deprecated as it depends on browser-specific APIs (localStorage/sessionStorage).
- * react-simplikit is now focused on platform-independent, pure state/logic hooks.
- * This hook will be removed in a future major version.
- *
  * @description
  * `useStorageState` is a React that functions like `useState` but persists the state value in browser storage.
  * The value is retained across page reloads and can be shared between tabs when using `localStorage`.

package/dist/hooks/useStorageState/useStorageState.d.mts

@@ -17,10 +17,6 @@ type StorageStateOptionsWithSerializer<T> = StorageStateOptions<T> & {
 };
 type SerializableGuard<T extends readonly any[]> = T[0] extends any ? T : T[0] extends never ? 'Received a non-serializable value' : T;
 /**
- * @deprecated This hook is deprecated as it depends on browser-specific APIs (localStorage/sessionStorage).
- * react-simplikit is now focused on platform-independent, pure state/logic hooks.
- * This hook will be removed in a future major version.
- *
  * @description
  * `useStorageState` is a React that functions like `useState` but persists the state value in browser storage.
  * The value is retained across page reloads and can be shared between tabs when using `localStorage`.

package/dist/hooks/useStorageState/useStorageState.mjs

@@ -20,6 +20,7 @@ const ensureSerializable = (value) => {
 	return value;
 };
 function useStorageState(key, { storage = safeLocalStorage, defaultValue, ...options } = {}) {
+	"use no memo";
 	const serializedDefaultValue = defaultValue;
 	const cache = useRef({
 		data: null,

package/dist/hooks/useThrottledCallback/useThrottledCallback.cjs

@@ -17,20 +17,27 @@ const NOT_INVOKED = Symbol("NOT_INVOKED");
 * `useThrottledCallback` is a React hook that returns a throttled version of the provided callback function.
 * The throttled callback will only be invoked at most once per specified interval.
 *
+* @template T - The type of the value passed to `onChange`.
 * @param {Object} options - The options object.
-* @param {Function} options.onChange - The callback function to throttle.
+* @param {(newValue: T) => void} options.onChange - The callback to throttle. A call with the same value as the last forwarded one is skipped.
 * @param {number} options.timeThreshold - The number of milliseconds to throttle invocations to.
 * @param {Array<'leading' | 'trailing'>} [options.edges=['leading', 'trailing']] - An optional array specifying whether the function should be invoked on the leading edge, trailing edge, or both.
 *
-* @returns {Function} A throttled function that limits invoking the callback.
+* @returns {(nextValue: T) => void} A throttled function that forwards the value to `onChange` at most once per interval.
 *
 * @example
-* function ScrollTracker() {
-*   const throttledScroll = useThrottledCallback({
-*     onChange: (scrollY: number) => console.log(scrollY),
-*     timeThreshold: 200,
-*   });
-*   return <div onScroll={(e) => throttledScroll(e.currentTarget.scrollTop)} />;
+* import { useThrottledCallback } from 'react-simplikit';
+* import { useState } from 'react';
+*
+* function ScrollPosition() {
+*   const [scrollTop, setScrollTop] = useState(0);
+*   const setScrollTopThrottled = useThrottledCallback({ onChange: setScrollTop, timeThreshold: 200 });
+*
+*   return (
+*     <div onScroll={e => setScrollTopThrottled(e.currentTarget.scrollTop)}>
+*       <p>Scrolled {scrollTop}px</p>
+*     </div>
+*   );
 * }
 */
 function useThrottledCallback({ onChange, timeThreshold, edges = ["leading", "trailing"] }) {
@@ -47,12 +54,12 @@ function useThrottledCallback({ onChange, timeThreshold, edges = ["leading", "tr
 	}, []);
 	const preservedEdges = require_usePreservedReference.usePreservedReference(edges);
 	return (0, react.useCallback)((nextValue) => {
+		ref.current.clearPreviousThrottle();
 		if (nextValue === ref.current.value) return;
 		const throttled = require_throttle.throttle(() => {
 			handleChange(nextValue);
 			ref.current.value = nextValue;
 		}, timeThreshold, { edges: preservedEdges });
-		ref.current.clearPreviousThrottle();
 		throttled();
 		ref.current.clearPreviousThrottle = throttled.cancel;
 	}, [

package/dist/hooks/useThrottledCallback/useThrottledCallback.d.cts

@@ -8,25 +8,32 @@ type ThrottleOptions = {
  * `useThrottledCallback` is a React hook that returns a throttled version of the provided callback function.
  * The throttled callback will only be invoked at most once per specified interval.
  *
+ * @template T - The type of the value passed to `onChange`.
  * @param {Object} options - The options object.
- * @param {Function} options.onChange - The callback function to throttle.
+ * @param {(newValue: T) => void} options.onChange - The callback to throttle. A call with the same value as the last forwarded one is skipped.
  * @param {number} options.timeThreshold - The number of milliseconds to throttle invocations to.
  * @param {Array<'leading' | 'trailing'>} [options.edges=['leading', 'trailing']] - An optional array specifying whether the function should be invoked on the leading edge, trailing edge, or both.
  *
- * @returns {Function} A throttled function that limits invoking the callback.
+ * @returns {(nextValue: T) => void} A throttled function that forwards the value to `onChange` at most once per interval.
  *
  * @example
- * function ScrollTracker() {
- *   const throttledScroll = useThrottledCallback({
- *     onChange: (scrollY: number) => console.log(scrollY),
- *     timeThreshold: 200,
- *   });
- *   return <div onScroll={(e) => throttledScroll(e.currentTarget.scrollTop)} />;
+ * import { useThrottledCallback } from 'react-simplikit';
+ * import { useState } from 'react';
+ *
+ * function ScrollPosition() {
+ *   const [scrollTop, setScrollTop] = useState(0);
+ *   const setScrollTopThrottled = useThrottledCallback({ onChange: setScrollTop, timeThreshold: 200 });
+ *
+ *   return (
+ *     <div onScroll={e => setScrollTopThrottled(e.currentTarget.scrollTop)}>
+ *       <p>Scrolled {scrollTop}px</p>
+ *     </div>
+ *   );
  * }
  */
-declare function useThrottledCallback({ onChange, timeThreshold, edges }: ThrottleOptions & {
-  onChange: (newValue: boolean) => void;
+declare function useThrottledCallback<T>({ onChange, timeThreshold, edges }: ThrottleOptions & {
+  onChange: (newValue: T) => void;
   timeThreshold: number;
-}): (nextValue: boolean) => void;
+}): (nextValue: T) => void;
 //#endregion
 export { useThrottledCallback };

package/dist/hooks/useThrottledCallback/useThrottledCallback.d.mts

@@ -8,25 +8,32 @@ type ThrottleOptions = {
  * `useThrottledCallback` is a React hook that returns a throttled version of the provided callback function.
  * The throttled callback will only be invoked at most once per specified interval.
  *
+ * @template T - The type of the value passed to `onChange`.
  * @param {Object} options - The options object.
- * @param {Function} options.onChange - The callback function to throttle.
+ * @param {(newValue: T) => void} options.onChange - The callback to throttle. A call with the same value as the last forwarded one is skipped.
  * @param {number} options.timeThreshold - The number of milliseconds to throttle invocations to.
  * @param {Array<'leading' | 'trailing'>} [options.edges=['leading', 'trailing']] - An optional array specifying whether the function should be invoked on the leading edge, trailing edge, or both.
  *
- * @returns {Function} A throttled function that limits invoking the callback.
+ * @returns {(nextValue: T) => void} A throttled function that forwards the value to `onChange` at most once per interval.
  *
  * @example
- * function ScrollTracker() {
- *   const throttledScroll = useThrottledCallback({
- *     onChange: (scrollY: number) => console.log(scrollY),
- *     timeThreshold: 200,
- *   });
- *   return <div onScroll={(e) => throttledScroll(e.currentTarget.scrollTop)} />;
+ * import { useThrottledCallback } from 'react-simplikit';
+ * import { useState } from 'react';
+ *
+ * function ScrollPosition() {
+ *   const [scrollTop, setScrollTop] = useState(0);
+ *   const setScrollTopThrottled = useThrottledCallback({ onChange: setScrollTop, timeThreshold: 200 });
+ *
+ *   return (
+ *     <div onScroll={e => setScrollTopThrottled(e.currentTarget.scrollTop)}>
+ *       <p>Scrolled {scrollTop}px</p>
+ *     </div>
+ *   );
  * }
  */
-declare function useThrottledCallback({ onChange, timeThreshold, edges }: ThrottleOptions & {
-  onChange: (newValue: boolean) => void;
+declare function useThrottledCallback<T>({ onChange, timeThreshold, edges }: ThrottleOptions & {
+  onChange: (newValue: T) => void;
   timeThreshold: number;
-}): (nextValue: boolean) => void;
+}): (nextValue: T) => void;
 //#endregion
 export { useThrottledCallback };

package/dist/hooks/useThrottledCallback/useThrottledCallback.mjs

@@ -17,20 +17,27 @@ const NOT_INVOKED = Symbol("NOT_INVOKED");
 * `useThrottledCallback` is a React hook that returns a throttled version of the provided callback function.
 * The throttled callback will only be invoked at most once per specified interval.
 *
+* @template T - The type of the value passed to `onChange`.
 * @param {Object} options - The options object.
-* @param {Function} options.onChange - The callback function to throttle.
+* @param {(newValue: T) => void} options.onChange - The callback to throttle. A call with the same value as the last forwarded one is skipped.
 * @param {number} options.timeThreshold - The number of milliseconds to throttle invocations to.
 * @param {Array<'leading' | 'trailing'>} [options.edges=['leading', 'trailing']] - An optional array specifying whether the function should be invoked on the leading edge, trailing edge, or both.
 *
-* @returns {Function} A throttled function that limits invoking the callback.
+* @returns {(nextValue: T) => void} A throttled function that forwards the value to `onChange` at most once per interval.
 *
 * @example
-* function ScrollTracker() {
-*   const throttledScroll = useThrottledCallback({
-*     onChange: (scrollY: number) => console.log(scrollY),
-*     timeThreshold: 200,
-*   });
-*   return <div onScroll={(e) => throttledScroll(e.currentTarget.scrollTop)} />;
+* import { useThrottledCallback } from 'react-simplikit';
+* import { useState } from 'react';
+*
+* function ScrollPosition() {
+*   const [scrollTop, setScrollTop] = useState(0);
+*   const setScrollTopThrottled = useThrottledCallback({ onChange: setScrollTop, timeThreshold: 200 });
+*
+*   return (
+*     <div onScroll={e => setScrollTopThrottled(e.currentTarget.scrollTop)}>
+*       <p>Scrolled {scrollTop}px</p>
+*     </div>
+*   );
 * }
 */
 function useThrottledCallback({ onChange, timeThreshold, edges = ["leading", "trailing"] }) {
@@ -47,12 +54,12 @@ function useThrottledCallback({ onChange, timeThreshold, edges = ["leading", "tr
 	}, []);
 	const preservedEdges = usePreservedReference(edges);
 	return useCallback((nextValue) => {
+		ref.current.clearPreviousThrottle();
 		if (nextValue === ref.current.value) return;
 		const throttled = throttle(() => {
 			handleChange(nextValue);
 			ref.current.value = nextValue;
 		}, timeThreshold, { edges: preservedEdges });
-		ref.current.clearPreviousThrottle();
 		throttled();
 		ref.current.clearPreviousThrottle = throttled.cancel;
 	}, [

package/dist/hooks/useVisibilityEvent/useVisibilityEvent.cjs

@@ -2,13 +2,11 @@
 let react = require("react");
 //#region src/hooks/useVisibilityEvent/useVisibilityEvent.ts
 /**
-* @deprecated This hook is deprecated as it depends on browser-specific APIs (document.visibilityState).
-* react-simplikit is now focused on platform-independent, pure state/logic hooks.
-* This hook will be removed in a future major version.
-*
 * @description
 * `useVisibilityEvent` is a React hook that listens to changes in the document's visibility state and triggers a callback.
 *
+* @see `usePageVisibility` returns the visibility as state instead of running a callback.
+*
 * @param {(visibilityState: 'visible' | 'hidden') => void} callback - A function to be called
 * when the visibility state changes. It receives the current visibility state ('visible' or 'hidden') as an argument.
 * @param {object} [options] - Optional configuration for the hook.

package/dist/hooks/useVisibilityEvent/useVisibilityEvent.d.cts

@@ -4,13 +4,11 @@ type Options = {
   immediate?: boolean;
 };
 /**
- * @deprecated This hook is deprecated as it depends on browser-specific APIs (document.visibilityState).
- * react-simplikit is now focused on platform-independent, pure state/logic hooks.
- * This hook will be removed in a future major version.
- *
  * @description
  * `useVisibilityEvent` is a React hook that listens to changes in the document's visibility state and triggers a callback.
  *
+ * @see `usePageVisibility` returns the visibility as state instead of running a callback.
+ *
  * @param {(visibilityState: 'visible' | 'hidden') => void} callback - A function to be called
  * when the visibility state changes. It receives the current visibility state ('visible' or 'hidden') as an argument.
  * @param {object} [options] - Optional configuration for the hook.

package/dist/hooks/useVisibilityEvent/useVisibilityEvent.d.mts

@@ -4,13 +4,11 @@ type Options = {
   immediate?: boolean;
 };
 /**
- * @deprecated This hook is deprecated as it depends on browser-specific APIs (document.visibilityState).
- * react-simplikit is now focused on platform-independent, pure state/logic hooks.
- * This hook will be removed in a future major version.
- *
  * @description
  * `useVisibilityEvent` is a React hook that listens to changes in the document's visibility state and triggers a callback.
  *
+ * @see `usePageVisibility` returns the visibility as state instead of running a callback.
+ *
  * @param {(visibilityState: 'visible' | 'hidden') => void} callback - A function to be called
  * when the visibility state changes. It receives the current visibility state ('visible' or 'hidden') as an argument.
  * @param {object} [options] - Optional configuration for the hook.

package/dist/hooks/useVisibilityEvent/useVisibilityEvent.mjs

@@ -2,13 +2,11 @@
 import { useCallback, useEffect } from "react";
 //#region src/hooks/useVisibilityEvent/useVisibilityEvent.ts
 /**
-* @deprecated This hook is deprecated as it depends on browser-specific APIs (document.visibilityState).
-* react-simplikit is now focused on platform-independent, pure state/logic hooks.
-* This hook will be removed in a future major version.
-*
 * @description
 * `useVisibilityEvent` is a React hook that listens to changes in the document's visibility state and triggers a callback.
 *
+* @see `usePageVisibility` returns the visibility as state instead of running a callback.
+*
 * @param {(visibilityState: 'visible' | 'hidden') => void} callback - A function to be called
 * when the visibility state changes. It receives the current visibility state ('visible' or 'hidden') as an argument.
 * @param {object} [options] - Optional configuration for the hook.

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 { SafeAreaInset, 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, type SafeAreaInset, 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 { SafeAreaInset, 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, type SafeAreaInset, 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;