@akbeniwal/react-native-hooks 1.0.0

package/dist/hooks/useDeviceOrientation.js

@@ -0,0 +1,33 @@
+import { useEffect, useState, useRef } from 'react';
+import { Dimensions } from 'react-native';
+/**
+ * A custom React Native hook that monitors and returns the device orientation dynamically.
+ * Updates on device rotation or dimension changes, and optionally fires an onChange callback.
+ *
+ * @param onChange Optional callback triggered when the orientation changes, receiving the new orientation
+ * @returns The current orientation status ('PORTRAIT' | 'LANDSCAPE')
+ */
+export function useDeviceOrientation(onChange) {
+    const checkLandscape = () => {
+        const { width, height } = Dimensions.get('window');
+        return width > height;
+    };
+    const [orientation, setOrientation] = useState(checkLandscape() ? 'LANDSCAPE' : 'PORTRAIT');
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+    useEffect(() => {
+        const handleDimensionsChange = () => {
+            const nextOrientation = checkLandscape() ? 'LANDSCAPE' : 'PORTRAIT';
+            setOrientation(nextOrientation);
+            if (onChangeRef.current) {
+                onChangeRef.current(nextOrientation);
+            }
+        };
+        const subscription = Dimensions.addEventListener('change', handleDimensionsChange);
+        return () => {
+            subscription.remove();
+        };
+    }, []);
+    return orientation;
+}
+//# sourceMappingURL=useDeviceOrientation.js.map

package/dist/hooks/useDeviceOrientation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeviceOrientation.js","sourceRoot":"","sources":["../../src/hooks/useDeviceOrientation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA6C;IAE7C,MAAM,cAAc,GAAG,GAAY,EAAE;QACnC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,KAAK,GAAG,MAAM,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAC5C,cAAc,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAC5C,CAAC;IAEF,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,sBAAsB,GAAG,GAAG,EAAE;YAClC,MAAM,eAAe,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;YACpE,cAAc,CAAC,eAAe,CAAC,CAAC;YAChC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;QAEnF,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/hooks/useDoubleTapToExit.d.ts

@@ -0,0 +1,17 @@
+export interface UseDoubleTapToExitOptions {
+    /** The confirmation message to display in the Toast (defaults to "Press back again to exit") */
+    message?: string;
+    /** The maximum time window in milliseconds between the two back taps (defaults to 2000ms) */
+    delayMs?: number;
+    /** Callback triggered on the first back button press (replaces standard Toast alert if provided) */
+    onFirstTap?: () => void;
+}
+/**
+ * A custom React Native hook specifically for Android that exits the application
+ * only when the user taps the hardware back button twice within a specified delay window.
+ * Supports custom action/UI callbacks on the first tap.
+ *
+ * @param options Configuration options including message, delay window, and a first-tap callback
+ */
+export declare function useDoubleTapToExit(options?: UseDoubleTapToExitOptions): void;
+//# sourceMappingURL=useDoubleTapToExit.d.ts.map

package/dist/hooks/useDoubleTapToExit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDoubleTapToExit.d.ts","sourceRoot":"","sources":["../../src/hooks/useDoubleTapToExit.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,yBAAyB;IACxC,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAiC5E"}

package/dist/hooks/useDoubleTapToExit.js

@@ -0,0 +1,40 @@
+import { useRef, useEffect } from 'react';
+import { BackHandler, ToastAndroid, Platform } from 'react-native';
+/**
+ * A custom React Native hook specifically for Android that exits the application
+ * only when the user taps the hardware back button twice within a specified delay window.
+ * Supports custom action/UI callbacks on the first tap.
+ *
+ * @param options Configuration options including message, delay window, and a first-tap callback
+ */
+export function useDoubleTapToExit(options) {
+    const lastPressRef = useRef(0);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    useEffect(() => {
+        if (Platform.OS !== 'android')
+            return;
+        const delayMs = optionsRef.current?.delayMs ?? 2000;
+        const message = optionsRef.current?.message ?? 'Press back again to exit';
+        const onBackPress = () => {
+            const now = Date.now();
+            if (lastPressRef.current && now - lastPressRef.current < delayMs) {
+                BackHandler.exitApp();
+                return true;
+            }
+            lastPressRef.current = now;
+            if (optionsRef.current?.onFirstTap) {
+                optionsRef.current.onFirstTap();
+            }
+            else {
+                ToastAndroid.show(message, ToastAndroid.SHORT);
+            }
+            return true;
+        };
+        const subscription = BackHandler.addEventListener('hardwareBackPress', onBackPress);
+        return () => {
+            subscription.remove();
+        };
+    }, []);
+}
+//# sourceMappingURL=useDoubleTapToExit.js.map

package/dist/hooks/useDoubleTapToExit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDoubleTapToExit.js","sourceRoot":"","sources":["../../src/hooks/useDoubleTapToExit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAWnE;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAmC;IACpE,MAAM,YAAY,GAAG,MAAM,CAAS,CAAC,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS;YAAE,OAAO;QAEtC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;QACpD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,IAAI,0BAA0B,CAAC;QAE1E,MAAM,WAAW,GAAG,GAAY,EAAE;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,YAAY,CAAC,OAAO,IAAI,GAAG,GAAG,YAAY,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;gBACjE,WAAW,CAAC,OAAO,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,YAAY,CAAC,OAAO,GAAG,GAAG,CAAC;YAE3B,IAAI,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;gBACnC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;QAEpF,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/hooks/useInterval.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A declarative React hook wrapper for `setInterval`.
+ * Automatically clears the interval on unmount, safely handles dynamically changing callback references,
+ * and allows pausing the interval by passing `null` as the delay.
+ *
+ * @param callback The function to execute on each interval tick
+ * @param delay The interval timing in milliseconds. Pass `null` to pause/stop the interval.
+ */
+export declare function useInterval(callback: () => void, delay: number | null): void;
+//# sourceMappingURL=useInterval.d.ts.map

package/dist/hooks/useInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.d.ts","sourceRoot":"","sources":["../../src/hooks/useInterval.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAmB5E"}

package/dist/hooks/useInterval.js

@@ -0,0 +1,27 @@
+import { useEffect, useRef } from 'react';
+/**
+ * A declarative React hook wrapper for `setInterval`.
+ * Automatically clears the interval on unmount, safely handles dynamically changing callback references,
+ * and allows pausing the interval by passing `null` as the delay.
+ *
+ * @param callback The function to execute on each interval tick
+ * @param delay The interval timing in milliseconds. Pass `null` to pause/stop the interval.
+ */
+export function useInterval(callback, delay) {
+    const savedCallback = useRef(callback);
+    // Keep track of the latest callback.
+    useEffect(() => {
+        savedCallback.current = callback;
+    }, [callback]);
+    // Set up the interval.
+    useEffect(() => {
+        if (delay === null)
+            return;
+        const tick = () => {
+            savedCallback.current();
+        };
+        const id = setInterval(tick, delay);
+        return () => clearInterval(id);
+    }, [delay]);
+}
+//# sourceMappingURL=useInterval.js.map

package/dist/hooks/useInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.js","sourceRoot":"","sources":["../../src/hooks/useInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,QAAoB,EAAE,KAAoB;IACpE,MAAM,aAAa,GAAG,MAAM,CAAa,QAAQ,CAAC,CAAC;IAEnD,qCAAqC;IACrC,SAAS,CAAC,GAAG,EAAE;QACb,aAAa,CAAC,OAAO,GAAG,QAAQ,CAAC;IACnC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,uBAAuB;IACvB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QAE3B,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;QAEF,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACd,CAAC"}

package/dist/hooks/useKeyboard.d.ts

@@ -0,0 +1,23 @@
+export interface KeyboardState {
+    /** True if the virtual keyboard is currently visible on the screen */
+    keyboardShown: boolean;
+    /** The height of the virtual keyboard in screen points */
+    keyboardHeight: number;
+}
+export interface UseKeyboardOptions {
+    /** Callback triggered when the keyboard is shown, receiving the keyboard height */
+    onShow?: (height: number) => void;
+    /** Callback triggered when the keyboard is hidden */
+    onHide?: () => void;
+    /** Callback triggered when keyboard visibility changes, receiving the new visibility status and height */
+    onChange?: (keyboardShown: boolean, keyboardHeight: number) => void;
+}
+/**
+ * A custom React Native hook to monitor keyboard visibility and height.
+ * Handles platform differences (willShow/willHide on iOS for smoother transitions, didShow/didHide on Android).
+ *
+ * @param options Optional callbacks for keyboard events
+ * @returns An object containing `keyboardShown` and `keyboardHeight`
+ */
+export declare function useKeyboard(options?: UseKeyboardOptions): KeyboardState;
+//# sourceMappingURL=useKeyboard.d.ts.map

package/dist/hooks/useKeyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useKeyboard.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,aAAa,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACrE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,aAAa,CA0CvE"}

package/dist/hooks/useKeyboard.js

@@ -0,0 +1,46 @@
+import { useEffect, useState, useRef } from 'react';
+import { Keyboard, Platform } from 'react-native';
+/**
+ * A custom React Native hook to monitor keyboard visibility and height.
+ * Handles platform differences (willShow/willHide on iOS for smoother transitions, didShow/didHide on Android).
+ *
+ * @param options Optional callbacks for keyboard events
+ * @returns An object containing `keyboardShown` and `keyboardHeight`
+ */
+export function useKeyboard(options) {
+    const [keyboardState, setKeyboardState] = useState({
+        keyboardShown: false,
+        keyboardHeight: 0,
+    });
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    useEffect(() => {
+        const handleKeyboardShow = (e) => {
+            const height = e.endCoordinates.height;
+            setKeyboardState({
+                keyboardShown: true,
+                keyboardHeight: height,
+            });
+            optionsRef.current?.onShow?.(height);
+            optionsRef.current?.onChange?.(true, height);
+        };
+        const handleKeyboardHide = () => {
+            setKeyboardState({
+                keyboardShown: false,
+                keyboardHeight: 0,
+            });
+            optionsRef.current?.onHide?.();
+            optionsRef.current?.onChange?.(false, 0);
+        };
+        const showEvent = Platform.OS === 'ios' ? 'keyboardWillShow' : 'keyboardDidShow';
+        const hideEvent = Platform.OS === 'ios' ? 'keyboardWillHide' : 'keyboardDidHide';
+        const showSubscription = Keyboard.addListener(showEvent, handleKeyboardShow);
+        const hideSubscription = Keyboard.addListener(hideEvent, handleKeyboardHide);
+        return () => {
+            showSubscription.remove();
+            hideSubscription.remove();
+        };
+    }, []);
+    return keyboardState;
+}
+//# sourceMappingURL=useKeyboard.js.map

package/dist/hooks/useKeyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboard.js","sourceRoot":"","sources":["../../src/hooks/useKeyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAC;AAkBjE;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAA4B;IACtD,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAgB;QAChE,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,CAAC;KAClB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,kBAAkB,GAAG,CAAC,CAAgB,EAAQ,EAAE;YACpD,MAAM,MAAM,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC;YACvC,gBAAgB,CAAC;gBACf,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,MAAM;aACvB,CAAC,CAAC;YACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;YACrC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC;QAEF,MAAM,kBAAkB,GAAG,GAAS,EAAE;YACpC,gBAAgB,CAAC;gBACf,aAAa,EAAE,KAAK;gBACpB,cAAc,EAAE,CAAC;aAClB,CAAC,CAAC;YACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YAC/B,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;QACjF,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAEjF,MAAM,gBAAgB,GAAG,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAC7E,MAAM,gBAAgB,GAAG,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAE7E,OAAO,GAAG,EAAE;YACV,gBAAgB,CAAC,MAAM,EAAE,CAAC;YAC1B,gBAAgB,CAAC,MAAM,EAAE,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/hooks/useLayout.d.ts

@@ -0,0 +1,19 @@
+import { LayoutChangeEvent, LayoutRectangle } from 'react-native';
+export interface UseLayoutOptions {
+    /** Callback triggered when the view dimensions or positions change */
+    onChange?: (layout: LayoutRectangle) => void;
+}
+/**
+ * A custom React Native hook to dynamically measure the size and position of a view.
+ * Useful for building custom alignments, dropdown positioning, and layouts.
+ *
+ * @param options Optional configuration, including an onChange callback
+ * @returns A read-only tuple containing:
+ *  - `layout`: The current layout rectangle metrics (`x`, `y`, `width`, `height`)
+ *  - `onLayout`: The event callback function to pass to the target component's `onLayout` prop
+ */
+export declare function useLayout(options?: UseLayoutOptions): readonly [
+    LayoutRectangle,
+    (e: LayoutChangeEvent) => void
+];
+//# sourceMappingURL=useLayout.d.ts.map

package/dist/hooks/useLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayout.d.ts","sourceRoot":"","sources":["../../src/hooks/useLayout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS;IAC9D,eAAe;IACf,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI;CAC/B,CAoBA"}

package/dist/hooks/useLayout.js

@@ -0,0 +1,29 @@
+import { useState, useCallback, useRef } from 'react';
+/**
+ * A custom React Native hook to dynamically measure the size and position of a view.
+ * Useful for building custom alignments, dropdown positioning, and layouts.
+ *
+ * @param options Optional configuration, including an onChange callback
+ * @returns A read-only tuple containing:
+ *  - `layout`: The current layout rectangle metrics (`x`, `y`, `width`, `height`)
+ *  - `onLayout`: The event callback function to pass to the target component's `onLayout` prop
+ */
+export function useLayout(options) {
+    const [layout, setLayout] = useState({
+        x: 0,
+        y: 0,
+        width: 0,
+        height: 0,
+    });
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const onLayout = useCallback((e) => {
+        const nextLayout = e.nativeEvent.layout;
+        setLayout(nextLayout);
+        if (optionsRef.current?.onChange) {
+            optionsRef.current.onChange(nextLayout);
+        }
+    }, []);
+    return [layout, onLayout];
+}
+//# sourceMappingURL=useLayout.js.map

package/dist/hooks/useLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayout.js","sourceRoot":"","sources":["../../src/hooks/useLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAQtD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,OAA0B;IAIlD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAkB;QACpD,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;KACV,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAoB,EAAQ,EAAE;QAC1D,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;QACxC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;YACjC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;AACrC,CAAC"}

package/dist/hooks/useNetworkStatus.d.ts

@@ -0,0 +1,45 @@
+export interface NetworkStatus {
+    /** True if the network check succeeded, false if it failed or timed out */
+    isConnected: boolean | null;
+    /** True if internet reachability check succeeded */
+    isInternetReachable: boolean | null;
+    /** Round-trip ping latency in milliseconds */
+    latencyMs: number | null;
+    /** Connection quality based on latency ('poor' | 'good' | 'excellent') */
+    connectionQuality: 'poor' | 'good' | 'excellent' | null;
+    /** Estimated internet download speed in Mbps (automatically measured when online) */
+    internetSpeed: number | null;
+    /** True if a speed test is currently running */
+    isTestingSpeed: boolean;
+    /** Triggers a download speed test manually to measure speed in Mbps */
+    runSpeedTest: () => Promise<number | null>;
+}
+export interface UseNetworkStatusOptions {
+    /** The URL to ping to verify internet reachability (defaults to google connection test) */
+    pingUrl?: string;
+    /** The interval in milliseconds to poll the connection (defaults to 30000ms, set to 0 to disable polling) */
+    pingIntervalMs?: number;
+    /** The fetch timeout in milliseconds (defaults to 5000ms) */
+    timeoutMs?: number;
+    /** Custom URL to download for the speed test (defaults to a reliable jQuery CDN asset) */
+    speedTestUrl?: string;
+    /** File size of the speed test URL in bytes (defaults to 90000 bytes for jQuery) */
+    speedTestFileSizeInBytes?: number;
+    /** If true, disables the automatic speed test on mount/online transitions (defaults to false) */
+    disableAutoSpeedTest?: boolean;
+    /** Callback triggered when any network status updates */
+    onChange?: (status: NetworkStatus) => void;
+    /** Callback triggered when the device comes online */
+    onOnline?: () => void;
+    /** Callback triggered when the device goes offline */
+    onOffline?: () => void;
+}
+/**
+ * A custom React Native hook to monitor network connectivity status, latency, and speed.
+ * Uses lightweight network fetches combined with React Native's AppState transitions and web browser event listeners.
+ *
+ * @param options Configuration options for ping URL, timeout, polling interval, and speed test setup
+ * @returns The current NetworkStatus object containing status, speed, and triggers
+ */
+export declare function useNetworkStatus(options?: UseNetworkStatusOptions): NetworkStatus;
+//# sourceMappingURL=useNetworkStatus.d.ts.map

package/dist/hooks/useNetworkStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNetworkStatus.d.ts","sourceRoot":"","sources":["../../src/hooks/useNetworkStatus.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,oDAAoD;IACpD,mBAAmB,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACxD,qFAAqF;IACrF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,uBAAuB;IACtC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6GAA6G;IAC7G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iGAAiG;IACjG,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAqMjF"}

package/dist/hooks/useNetworkStatus.js

@@ -0,0 +1,184 @@
+import { useEffect, useState, useCallback, useRef } from 'react';
+import { AppState } from 'react-native';
+import { usePrevious } from './usePrevious';
+/**
+ * A custom React Native hook to monitor network connectivity status, latency, and speed.
+ * Uses lightweight network fetches combined with React Native's AppState transitions and web browser event listeners.
+ *
+ * @param options Configuration options for ping URL, timeout, polling interval, and speed test setup
+ * @returns The current NetworkStatus object containing status, speed, and triggers
+ */
+export function useNetworkStatus(options) {
+    const pingUrl = options?.pingUrl ?? 'https://clients3.google.com/generate_204';
+    const pingIntervalMs = options?.pingIntervalMs ?? 30000;
+    const timeoutMs = options?.timeoutMs ?? 5000;
+    const speedTestUrl = options?.speedTestUrl ?? 'https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js';
+    const speedTestFileSizeInBytes = options?.speedTestFileSizeInBytes ?? 90000;
+    const disableAutoSpeedTest = options?.disableAutoSpeedTest ?? false;
+    const [status, setStatus] = useState({
+        isConnected: null,
+        isInternetReachable: null,
+        latencyMs: null,
+        connectionQuality: null,
+    });
+    const [isTestingSpeed, setIsTestingSpeed] = useState(false);
+    const [downloadSpeedMbps, setDownloadSpeedMbps] = useState(null);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const getConnectionQuality = (latency) => {
+        if (latency === null)
+            return null;
+        if (latency < 150)
+            return 'excellent';
+        if (latency < 400)
+            return 'good';
+        return 'poor';
+    };
+    const runSpeedTest = useCallback(async () => {
+        setIsTestingSpeed(true);
+        try {
+            const startTime = Date.now();
+            const response = await fetch(speedTestUrl, {
+                method: 'GET',
+                headers: { 'Cache-Control': 'no-cache' },
+            });
+            if (!response.ok)
+                throw new Error('Speed test fetch failed');
+            // Consume the body to calculate complete download duration
+            await response.text();
+            const durationSec = (Date.now() - startTime) / 1000;
+            if (durationSec <= 0)
+                return null;
+            const fileSizeBits = speedTestFileSizeInBytes * 8;
+            const speedMbps = fileSizeBits / durationSec / 1000000;
+            const roundedSpeed = Math.round(speedMbps * 100) / 100;
+            setDownloadSpeedMbps(roundedSpeed);
+            return roundedSpeed;
+        }
+        catch (error) {
+            console.warn('Network speed test failed:', error);
+            return null;
+        }
+        finally {
+            setIsTestingSpeed(false);
+        }
+    }, [speedTestUrl, speedTestFileSizeInBytes]);
+    const returnedStatus = {
+        ...status,
+        internetSpeed: downloadSpeedMbps,
+        isTestingSpeed,
+        runSpeedTest,
+    };
+    // Run speed test automatically on initial online transition
+    useEffect(() => {
+        if (status.isInternetReachable &&
+            downloadSpeedMbps === null &&
+            !isTestingSpeed &&
+            !disableAutoSpeedTest) {
+            runSpeedTest();
+        }
+    }, [status.isInternetReachable, downloadSpeedMbps, isTestingSpeed, runSpeedTest, disableAutoSpeedTest]);
+    // Handle callback triggers on network status change
+    const prevIsInternetReachable = usePrevious(status.isInternetReachable);
+    useEffect(() => {
+        if (status.isConnected === null)
+            return;
+        optionsRef.current?.onChange?.(returnedStatus);
+        if (status.isInternetReachable === true && prevIsInternetReachable === false) {
+            optionsRef.current?.onOnline?.();
+        }
+        else if (status.isInternetReachable === false && prevIsInternetReachable === true) {
+            optionsRef.current?.onOffline?.();
+        }
+    }, [
+        status.isConnected,
+        status.isInternetReachable,
+        status.latencyMs,
+        status.connectionQuality,
+        downloadSpeedMbps,
+        isTestingSpeed,
+        prevIsInternetReachable,
+    ]);
+    useEffect(() => {
+        let isMounted = true;
+        let intervalId = null;
+        const checkConnectivity = async () => {
+            const startTime = Date.now();
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+                // Perform a HEAD request to save bandwidth
+                const response = await fetch(pingUrl, {
+                    method: 'HEAD',
+                    signal: controller.signal,
+                    headers: { 'Cache-Control': 'no-cache' },
+                });
+                clearTimeout(timeoutId);
+                const isReachable = response.ok || response.status < 400;
+                const latencyMs = Date.now() - startTime;
+                return { isReachable, latencyMs };
+            }
+            catch {
+                return { isReachable: false, latencyMs: null };
+            }
+        };
+        const performCheck = async () => {
+            const { isReachable, latencyMs } = await checkConnectivity();
+            if (isMounted) {
+                setStatus({
+                    isConnected: isReachable,
+                    isInternetReachable: isReachable,
+                    latencyMs,
+                    connectionQuality: getConnectionQuality(latencyMs),
+                });
+            }
+        };
+        // Initial check on mount
+        performCheck();
+        // Periodic polling to catch silent connectivity drops
+        if (pingIntervalMs > 0) {
+            intervalId = setInterval(performCheck, pingIntervalMs);
+        }
+        // Trigger check immediately when app transitions to active foreground state
+        const appStateSubscription = AppState.addEventListener('change', (nextAppState) => {
+            if (nextAppState === 'active') {
+                performCheck();
+            }
+        });
+        // Support for React Native Web online/offline window listeners
+        const handleWebOnline = () => {
+            if (isMounted) {
+                setStatus((prev) => ({ ...prev, isConnected: true, isInternetReachable: true }));
+                performCheck();
+            }
+        };
+        const handleWebOffline = () => {
+            if (isMounted) {
+                setStatus({
+                    isConnected: false,
+                    isInternetReachable: false,
+                    latencyMs: null,
+                    connectionQuality: null,
+                });
+            }
+        };
+        const hasWindowListeners = typeof window !== 'undefined' && typeof window.addEventListener === 'function';
+        if (hasWindowListeners) {
+            window.addEventListener('online', handleWebOnline);
+            window.addEventListener('offline', handleWebOffline);
+        }
+        return () => {
+            isMounted = false;
+            if (intervalId) {
+                clearInterval(intervalId);
+            }
+            appStateSubscription.remove();
+            if (hasWindowListeners) {
+                window.removeEventListener('online', handleWebOnline);
+                window.removeEventListener('offline', handleWebOffline);
+            }
+        };
+    }, [pingUrl, pingIntervalMs, timeoutMs]);
+    return returnedStatus;
+}
+//# sourceMappingURL=useNetworkStatus.js.map

package/dist/hooks/useNetworkStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNetworkStatus.js","sourceRoot":"","sources":["../../src/hooks/useNetworkStatus.ts"],"names":[],"mappings":"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"}

package/dist/hooks/usePrevious.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A custom React hook to track the previous value of a state or prop.
+ *
+ * @template T The type of the value to track
+ * @param value The current value
+ * @returns The value from the previous render, or `undefined` on the initial render
+ */
+export declare function usePrevious<T>(value: T): T | undefined;
+//# sourceMappingURL=usePrevious.d.ts.map

package/dist/hooks/usePrevious.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrevious.d.ts","sourceRoot":"","sources":["../../src/hooks/usePrevious.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAQtD"}

package/dist/hooks/usePrevious.js

@@ -0,0 +1,16 @@
+import { useEffect, useRef } from 'react';
+/**
+ * A custom React hook to track the previous value of a state or prop.
+ *
+ * @template T The type of the value to track
+ * @param value The current value
+ * @returns The value from the previous render, or `undefined` on the initial render
+ */
+export function usePrevious(value) {
+    const ref = useRef(undefined);
+    useEffect(() => {
+        ref.current = value;
+    }, [value]);
+    return ref.current;
+}
+//# sourceMappingURL=usePrevious.js.map

package/dist/hooks/usePrevious.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrevious.js","sourceRoot":"","sources":["../../src/hooks/usePrevious.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAI,KAAQ;IACrC,MAAM,GAAG,GAAG,MAAM,CAAgB,SAAS,CAAC,CAAC;IAE7C,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}

package/dist/hooks/useThrottle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A custom React hook to throttle updates to a state value.
+ * Useful for limiting performance-heavy operations triggered by frequent updates (e.g. dimensions, scroll events).
+ *
+ * @template T The type of the value to throttle
+ * @param value The value to throttle
+ * @param limit The throttle cooldown limit in milliseconds
+ * @param onChange Optional callback triggered when the throttled value changes
+ * @returns The throttled value
+ */
+export declare function useThrottle<T>(value: T, limit: number, onChange?: (value: T) => void): T;
+//# sourceMappingURL=useThrottle.d.ts.map

package/dist/hooks/useThrottle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThrottle.d.ts","sourceRoot":"","sources":["../../src/hooks/useThrottle.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC5B,CAAC,CAwCH"}

package/dist/hooks/useThrottle.js

@@ -0,0 +1,47 @@
+import { useEffect, useRef, useState } from 'react';
+/**
+ * A custom React hook to throttle updates to a state value.
+ * Useful for limiting performance-heavy operations triggered by frequent updates (e.g. dimensions, scroll events).
+ *
+ * @template T The type of the value to throttle
+ * @param value The value to throttle
+ * @param limit The throttle cooldown limit in milliseconds
+ * @param onChange Optional callback triggered when the throttled value changes
+ * @returns The throttled value
+ */
+export function useThrottle(value, limit, onChange) {
+    const [throttledValue, setThrottledValue] = useState(value);
+    const lastRan = useRef(0);
+    const timeoutRef = useRef(null);
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+    useEffect(() => {
+        const now = Date.now();
+        const timeRemaining = limit - (now - lastRan.current);
+        const updateValue = (val) => {
+            setThrottledValue(val);
+            lastRan.current = Date.now();
+            if (onChangeRef.current) {
+                onChangeRef.current(val);
+            }
+        };
+        if (timeRemaining <= 0) {
+            updateValue(value);
+        }
+        else {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+            timeoutRef.current = setTimeout(() => {
+                updateValue(value);
+            }, timeRemaining);
+        }
+        return () => {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+            }
+        };
+    }, [value, limit]);
+    return throttledValue;
+}
+//# sourceMappingURL=useThrottle.js.map