@akbeniwal/react-native-hooks 1.0.0

package/README.md

@@ -0,0 +1,235 @@
+# react-native-hooks ⚡
+
+A high-performance, lightweight, and type-safe collection of **16 custom React Native hooks** optimized for performance, memory-leak prevention, and smooth 60fps UX. 
+
+---
+
+## Key Features 🌟
+
+*   **Zero-Dependency `useNetworkStatus`**: Monitor internet reachability, ping latency, connection quality, and measure download speed in Mbps without bloating your bundle size.
+*   **Android-Specific Back Button Hooks**: Custom hooks for back-press events and standard "Double-Tap to Exit" Toast notifications.
+*   **Optimized Performance**: Internal callbacks are isolated inside `useRef` to prevent system listeners (keyboard, dimensions, back-handlers, app-states) from registering and tearing down repeatedly.
+*   **TypeScript Ready**: Fully typed out-of-the-box with auto-generated declaration maps.
+*   **Cross-Platform**: Support for Android, iOS, and React Native Web.
+
+---
+
+## Installation 📦
+
+```bash
+npm install react-native-hooks
+# or
+yarn add react-native-hooks
+```
+
+---
+
+## Table of Hooks 📚
+
+| Hook | Purpose | Platform |
+| :--- | :--- | :--- |
+| [`useAppState`](#useappstate) | Tracks active/inactive/background app focus states with callbacks. | iOS, Android, Web |
+| [`useBackHandler`](#usebackhandler) | Android physical/virtual hardware back button press. | Android |
+| [`useClipboard`](#useclipboard) | Reads & writes to the system clipboard with copied feedback callback. | iOS, Android, Web |
+| [`useCountdown`](#usecountdown) | Full-featured countdown timer with pause, reset, and tick callbacks. | iOS, Android, Web |
+| [`useDebounce`](#usedebounce) | Debounces state values with optional change triggers. | iOS, Android, Web |
+| [`useKeyboard`](#usekeyboard) | Tracks virtual keyboard display status and dynamic height. | iOS, Android |
+| [`useNetworkStatus`](#usenetworkstatus) | Monitors internet connection, latency, speed test in Mbps, and offline alerts. | iOS, Android, Web |
+| [`usePrevious`](#useprevious) | Accesses the value of a state/prop from the previous render. | iOS, Android, Web |
+| [`useThrottle`](#usethrottle) | Throttles state update changes. | iOS, Android, Web |
+| [`useToggle`](#usetoggle) | Simple state toggle with `onChange`, `onTrue`, and `onFalse` callbacks. | iOS, Android, Web |
+| [`useAfterInteractions`](#useafterinteractions) | Defers execution of tasks until layout transition animations finish. | iOS, Android |
+| [`useLayout`](#uselayout) | Measures dynamic sizing and screen positions of views. | iOS, Android, Web |
+| [`useDoubleTapToExit`](#usedoubletaptoexit) | Prompts and exits app only on double-pressing Android back button. | Android |
+| [`useDeviceOrientation`](#usedeviceorientation) | Tracks rotation and current orientation status (`PORTRAIT` / `LANDSCAPE`). | iOS, Android, Web |
+| [`useInterval`](#useinterval) | Declarative version of `setInterval` (prevents stale state closures). | iOS, Android, Web |
+| [`useTimeout`](#usetimeout) | Declarative version of `setTimeout` (cleans up automatically on unmount). | iOS, Android, Web |
+
+---
+
+## Quick Usage Reference 💡
+
+### useAppState
+```tsx
+import { useAppState } from 'react-native-hooks';
+
+const appState = useAppState({
+  onForeground: () => console.log('App entered foreground!'),
+  onBackground: () => console.log('App entered background!'),
+});
+```
+
+### useBackHandler
+```tsx
+import { useBackHandler } from 'react-native-hooks';
+
+useBackHandler(() => {
+  // Return true to prevent default back action
+  if (hasUnsavedChanges) {
+    showExitAlert();
+    return true; 
+  }
+  return false;
+});
+```
+
+### useClipboard
+```tsx
+import { useClipboard } from 'react-native-hooks';
+
+const [clipboardData, setString] = useClipboard({
+  onCopy: (text) => console.log(`Copied "${text}" to clipboard!`),
+});
+```
+
+### useCountdown
+```tsx
+import { useCountdown } from 'react-native-hooks';
+
+const { seconds, isActive, start, pause, reset } = useCountdown({
+  initialSeconds: 60,
+  onExpire: () => alert('OTP expired!'),
+  onTick: (secs) => console.log(`${secs} seconds remaining`),
+});
+```
+
+### useDebounce
+```tsx
+import { useDebounce } from 'react-native-hooks';
+
+const [searchQuery, setSearchQuery] = useState('');
+const debouncedQuery = useDebounce(searchQuery, 500, (value) => {
+  fetchSearchResults(value);
+});
+```
+
+### useKeyboard
+```tsx
+import { useKeyboard } from 'react-native-hooks';
+
+const { keyboardShown, keyboardHeight } = useKeyboard({
+  onShow: (height) => console.log(`Keyboard visible with height: ${height}`),
+  onHide: () => console.log('Keyboard hidden'),
+});
+```
+
+### useNetworkStatus
+```tsx
+import { useNetworkStatus } from 'react-native-hooks';
+
+const { 
+  isConnected, 
+  isInternetReachable, 
+  latencyMs, 
+  connectionQuality, 
+  internetSpeed, 
+  isTestingSpeed, 
+  runSpeedTest 
+} = useNetworkStatus({
+  pingIntervalMs: 30000, // Ping Google every 30 seconds
+  onOnline: () => console.log('Back online! syncing database...'),
+  onOffline: () => console.log('Network connection lost!'),
+});
+```
+
+### usePrevious
+```tsx
+import { usePrevious } from 'react-native-hooks';
+
+const [count, setCount] = useState(0);
+const prevCount = usePrevious(count); // returns count from previous render
+```
+
+### useThrottle
+```tsx
+import { useThrottle } from 'react-native-hooks';
+
+const throttledScrollY = useThrottle(scrollY, 100);
+```
+
+### useToggle
+```tsx
+import { useToggle } from 'react-native-hooks';
+
+const [isModalOpen, toggleModal] = useToggle(false, {
+  onTrue: () => console.log('Modal Opened'),
+  onFalse: () => console.log('Modal Closed'),
+});
+```
+
+### useAfterInteractions
+```tsx
+import { useAfterInteractions } from 'react-native-hooks';
+
+const interactionsFinished = useAfterInteractions(() => {
+  loadExpensiveChartData();
+});
+```
+
+### useLayout
+```tsx
+import { useLayout } from 'react-native-hooks';
+import { View } from 'react-native';
+
+const [layout, onLayout] = useLayout({
+  onChange: (metrics) => console.log('New layout:', metrics),
+});
+
+return <View onLayout={onLayout} />;
+```
+
+### useDoubleTapToExit
+```tsx
+import { useDoubleTapToExit } from 'react-native-hooks';
+
+// Setup on Android
+useDoubleTapToExit('Press back button again to exit the app.');
+```
+
+### useDeviceOrientation
+```tsx
+import { useDeviceOrientation } from 'react-native-hooks';
+
+const orientation = useDeviceOrientation((currentOrientation) => {
+  console.log('Orientation changed to:', currentOrientation);
+});
+```
+
+### useInterval
+```tsx
+import { useInterval } from 'react-native-hooks';
+
+useInterval(() => {
+  // Increments or processes state safely without stale closures
+  tickCounter();
+}, isPaused ? null : 1000);
+```
+
+### useTimeout
+```tsx
+import { useTimeout } from 'react-native-hooks';
+
+useTimeout(() => {
+  dismissBanner();
+}, 5000);
+```
+
+---
+
+## Development & Building 🛠️
+
+```bash
+# Build the typescript files into JavaScript and TypeScript Definitions (under /dist)
+yarn build
+```
+
+## Author 👤
+
+**Abhishek Beniwal**
+- GitHub: [@AKBeniwal1700](https://github.com/AKBeniwal1700)
+
+---
+
+## License 📄
+
+This project is licensed under the MIT License.

package/dist/hooks/useAfterInteractions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A custom React Native hook that defers execution of intensive tasks or rendering
+ * until after navigation transitions or animations have completed.
+ * Helps in achieving 60fps / lag-free screen navigation transitions.
+ *
+ * @param callback Optional callback triggered immediately when transitions/animations complete
+ * @returns A boolean indicating if transition interactions have completed
+ */
+export declare function useAfterInteractions(callback?: () => void): boolean;
+//# sourceMappingURL=useAfterInteractions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAfterInteractions.d.ts","sourceRoot":"","sources":["../../src/hooks/useAfterInteractions.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAoBnE"}

package/dist/hooks/useAfterInteractions.js

@@ -0,0 +1,28 @@
+import { useEffect, useState, useRef } from 'react';
+import { InteractionManager } from 'react-native';
+/**
+ * A custom React Native hook that defers execution of intensive tasks or rendering
+ * until after navigation transitions or animations have completed.
+ * Helps in achieving 60fps / lag-free screen navigation transitions.
+ *
+ * @param callback Optional callback triggered immediately when transitions/animations complete
+ * @returns A boolean indicating if transition interactions have completed
+ */
+export function useAfterInteractions(callback) {
+    const [areInteractionsComplete, setComplete] = useState(false);
+    const callbackRef = useRef(callback);
+    callbackRef.current = callback;
+    useEffect(() => {
+        const task = InteractionManager.runAfterInteractions(() => {
+            setComplete(true);
+            if (callbackRef.current) {
+                callbackRef.current();
+            }
+        });
+        return () => {
+            task.cancel();
+        };
+    }, []);
+    return areInteractionsComplete;
+}
+//# sourceMappingURL=useAfterInteractions.js.map

package/dist/hooks/useAfterInteractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAfterInteractions.js","sourceRoot":"","sources":["../../src/hooks/useAfterInteractions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAqB;IACxD,MAAM,CAAC,uBAAuB,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IAExE,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,GAAG,EAAE;YACxD,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,uBAAuB,CAAC;AACjC,CAAC"}

package/dist/hooks/useAppState.d.ts

@@ -0,0 +1,17 @@
+import { AppStateStatus } from 'react-native';
+export interface UseAppStateOptions {
+    /** Callback triggered whenever the AppState changes */
+    onChange?: (status: AppStateStatus) => void;
+    /** Callback triggered when the application enters the foreground (active) */
+    onForeground?: () => void;
+    /** Callback triggered when the application enters the background or becomes inactive */
+    onBackground?: () => void;
+}
+/**
+ * A custom React Native hook to track the application's current AppState.
+ *
+ * @param options Callback options for AppState transitions
+ * @returns The current AppStateStatus ('active' | 'background' | 'inactive')
+ */
+export declare function useAppState(options?: UseAppStateOptions): AppStateStatus;
+//# sourceMappingURL=useAppState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAppState.d.ts","sourceRoot":"","sources":["../../src/hooks/useAppState.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,cAAc,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5C,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAkCxE"}

package/dist/hooks/useAppState.js

@@ -0,0 +1,36 @@
+import { useEffect, useState, useRef } from 'react';
+import { AppState } from 'react-native';
+/**
+ * A custom React Native hook to track the application's current AppState.
+ *
+ * @param options Callback options for AppState transitions
+ * @returns The current AppStateStatus ('active' | 'background' | 'inactive')
+ */
+export function useAppState(options) {
+    const [appState, setAppState] = useState(AppState.currentState);
+    // Store options in refs to prevent unnecessary re-subscriptions on options reference changes.
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    useEffect(() => {
+        const subscription = AppState.addEventListener('change', (nextAppState) => {
+            const currentOptions = optionsRef.current;
+            const prevAppState = appState;
+            setAppState(nextAppState);
+            if (currentOptions?.onChange) {
+                currentOptions.onChange(nextAppState);
+            }
+            if (nextAppState === 'active' && prevAppState !== 'active') {
+                currentOptions?.onForeground?.();
+            }
+            else if ((nextAppState === 'background' || nextAppState === 'inactive') &&
+                prevAppState === 'active') {
+                currentOptions?.onBackground?.();
+            }
+        });
+        return () => {
+            subscription.remove();
+        };
+    }, [appState]);
+    return appState;
+}
+//# sourceMappingURL=useAppState.js.map

package/dist/hooks/useAppState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppState.js","sourceRoot":"","sources":["../../src/hooks/useAppState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAkB,MAAM,cAAc,CAAC;AAWxD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA4B;IACtD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAiB,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEhF,8FAA8F;IAC9F,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,EAAE;YACxE,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;YAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC;YAE9B,WAAW,CAAC,YAAY,CAAC,CAAC;YAE1B,IAAI,cAAc,EAAE,QAAQ,EAAE,CAAC;gBAC7B,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACxC,CAAC;YAED,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC3D,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC;YACnC,CAAC;iBAAM,IACL,CAAC,YAAY,KAAK,YAAY,IAAI,YAAY,KAAK,UAAU,CAAC;gBAC9D,YAAY,KAAK,QAAQ,EACzB,CAAC;gBACD,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/hooks/useBackHandler.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A custom React Native hook to handle Android hardware back button presses.
+ *
+ * @param handler Callback function. Returning `true` from this handler prevents the default back button behavior (e.g., exiting the app). Returning `false` allows the default behavior to proceed.
+ */
+export declare function useBackHandler(handler: () => boolean): void;
+//# sourceMappingURL=useBackHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBackHandler.d.ts","sourceRoot":"","sources":["../../src/hooks/useBackHandler.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAe3D"}

package/dist/hooks/useBackHandler.js

@@ -0,0 +1,21 @@
+import { useEffect, useRef } from 'react';
+import { BackHandler } from 'react-native';
+/**
+ * A custom React Native hook to handle Android hardware back button presses.
+ *
+ * @param handler Callback function. Returning `true` from this handler prevents the default back button behavior (e.g., exiting the app). Returning `false` allows the default behavior to proceed.
+ */
+export function useBackHandler(handler) {
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        const onBackPress = () => {
+            return handlerRef.current();
+        };
+        const subscription = BackHandler.addEventListener('hardwareBackPress', onBackPress);
+        return () => {
+            subscription.remove();
+        };
+    }, []);
+}
+//# sourceMappingURL=useBackHandler.js.map

package/dist/hooks/useBackHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackHandler.js","sourceRoot":"","sources":["../../src/hooks/useBackHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,OAAO,UAAU,CAAC,OAAO,EAAE,CAAC;QAC9B,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/useClipboard.d.ts

@@ -0,0 +1,19 @@
+export interface UseClipboardOptions {
+    /** Callback triggered when text is successfully copied to the system clipboard via setString */
+    onCopy?: (text: string) => void;
+}
+/**
+ * A custom React Native hook to interact with the system clipboard.
+ *
+ * @param options Configurable options, including an onCopy callback
+ * @returns A read-only tuple containing:
+ *  - `clipboardData`: The current string content of the clipboard.
+ *  - `setString`: A memoized function to write content to the clipboard.
+ *  - `getString`: A memoized function to manually refresh and fetch content from the clipboard.
+ */
+export declare function useClipboard(options?: UseClipboardOptions): readonly [
+    string,
+    (text: string) => void,
+    () => Promise<string>
+];
+//# sourceMappingURL=useClipboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useClipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useClipboard.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS;IACpE,MAAM;IACN,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IACtB,MAAM,OAAO,CAAC,MAAM,CAAC;CACtB,CAkCA"}

package/dist/hooks/useClipboard.js

@@ -0,0 +1,44 @@
+import { useState, useCallback, useEffect, useRef } from 'react';
+import Clipboard from '@react-native-clipboard/clipboard';
+/**
+ * A custom React Native hook to interact with the system clipboard.
+ *
+ * @param options Configurable options, including an onCopy callback
+ * @returns A read-only tuple containing:
+ *  - `clipboardData`: The current string content of the clipboard.
+ *  - `setString`: A memoized function to write content to the clipboard.
+ *  - `getString`: A memoized function to manually refresh and fetch content from the clipboard.
+ */
+export function useClipboard(options) {
+    const [clipboardData, setClipboardData] = useState('');
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const getString = useCallback(async () => {
+        try {
+            const text = await Clipboard.getString();
+            setClipboardData(text);
+            return text;
+        }
+        catch (error) {
+            console.warn('Failed to retrieve content from system clipboard:', error);
+            return '';
+        }
+    }, []);
+    const setString = useCallback((text) => {
+        try {
+            Clipboard.setString(text);
+            setClipboardData(text);
+            if (optionsRef.current?.onCopy) {
+                optionsRef.current.onCopy(text);
+            }
+        }
+        catch (error) {
+            console.warn('Failed to set content to system clipboard:', error);
+        }
+    }, []);
+    useEffect(() => {
+        getString();
+    }, [getString]);
+    return [clipboardData, setString, getString];
+}
+//# sourceMappingURL=useClipboard.js.map

package/dist/hooks/useClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClipboard.js","sourceRoot":"","sources":["../../src/hooks/useClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,SAAS,MAAM,mCAAmC,CAAC;AAO1D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAA6B;IAKxD,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAqB,EAAE;QACxD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;YACzC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,mDAAmD,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,IAAY,EAAQ,EAAE;QACnD,IAAI,CAAC;YACH,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1B,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC/B,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,EAAE,CAAC;IACd,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AACxD,CAAC"}

package/dist/hooks/useCountdown.d.ts

@@ -0,0 +1,24 @@
+export interface UseCountdownOptions {
+    /** The starting countdown time in seconds */
+    initialSeconds: number;
+    /** The countdown tick interval in milliseconds (defaults to 1000ms) */
+    intervalMs?: number;
+    /** Callback triggered when the countdown reaches 0 */
+    onExpire?: () => void;
+    /** Callback triggered on every tick, receiving the seconds remaining */
+    onTick?: (secondsRemaining: number) => void;
+}
+/**
+ * A custom React Native hook to manage a countdown timer.
+ *
+ * @param options Countdown configuration options
+ * @returns Object containing countdown state and control functions
+ */
+export declare function useCountdown({ initialSeconds, intervalMs, onExpire, onTick, }: UseCountdownOptions): {
+    seconds: number;
+    isActive: boolean;
+    start: () => void;
+    pause: () => void;
+    reset: (newInitialSeconds?: number) => void;
+};
+//# sourceMappingURL=useCountdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCountdown.d.ts","sourceRoot":"","sources":["../../src/hooks/useCountdown.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,cAAc,EACd,UAAiB,EACjB,QAAQ,EACR,MAAM,GACP,EAAE,mBAAmB;;;iBAWU,IAAI;iBAIJ,IAAI;gCASX,MAAM,KAAG,IAAI;EA6CrC"}

package/dist/hooks/useCountdown.js

@@ -0,0 +1,67 @@
+import { useState, useEffect, useRef, useCallback } from 'react';
+/**
+ * A custom React Native hook to manage a countdown timer.
+ *
+ * @param options Countdown configuration options
+ * @returns Object containing countdown state and control functions
+ */
+export function useCountdown({ initialSeconds, intervalMs = 1000, onExpire, onTick, }) {
+    const [seconds, setSeconds] = useState(initialSeconds);
+    const [isActive, setIsActive] = useState(false);
+    const timerRef = useRef(null);
+    // Store callbacks in refs to prevent timer re-creation when callbacks change.
+    const onExpireRef = useRef(onExpire);
+    const onTickRef = useRef(onTick);
+    onExpireRef.current = onExpire;
+    onTickRef.current = onTick;
+    const start = useCallback(() => {
+        setIsActive(true);
+    }, []);
+    const pause = useCallback(() => {
+        setIsActive(false);
+        if (timerRef.current) {
+            clearInterval(timerRef.current);
+            timerRef.current = null;
+        }
+    }, []);
+    const reset = useCallback((newInitialSeconds) => {
+        setIsActive(false);
+        if (timerRef.current) {
+            clearInterval(timerRef.current);
+            timerRef.current = null;
+        }
+        setSeconds(newInitialSeconds !== undefined ? newInitialSeconds : initialSeconds);
+    }, [initialSeconds]);
+    useEffect(() => {
+        if (!isActive)
+            return;
+        timerRef.current = setInterval(() => {
+            setSeconds((prev) => {
+                if (prev <= 1) {
+                    setIsActive(false);
+                    if (timerRef.current) {
+                        clearInterval(timerRef.current);
+                        timerRef.current = null;
+                    }
+                    if (onExpireRef.current) {
+                        onExpireRef.current();
+                    }
+                    return 0;
+                }
+                const nextVal = prev - 1;
+                if (onTickRef.current) {
+                    onTickRef.current(nextVal);
+                }
+                return nextVal;
+            });
+        }, intervalMs);
+        return () => {
+            if (timerRef.current) {
+                clearInterval(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+    }, [isActive, intervalMs]);
+    return { seconds, isActive, start, pause, reset };
+}
+//# sourceMappingURL=useCountdown.js.map

package/dist/hooks/useCountdown.js.map

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

package/dist/hooks/useDebounce.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A custom React Native hook to debounce a state value change.
+ * Optionally triggers an onChange callback when the debounced value updates.
+ *
+ * @template T The type of the value to debounce
+ * @param value The value to be debounced
+ * @param delay The delay in milliseconds
+ * @param onChange Optional callback triggered with the new debounced value
+ * @returns The debounced value
+ */
+export declare function useDebounce<T>(value: T, delay: number, onChange?: (value: T) => void): T;
+//# sourceMappingURL=useDebounce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebounce.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,CAoBH"}

package/dist/hooks/useDebounce.js

@@ -0,0 +1,29 @@
+import { useState, useEffect, useRef } from 'react';
+/**
+ * A custom React Native hook to debounce a state value change.
+ * Optionally triggers an onChange callback when the debounced value updates.
+ *
+ * @template T The type of the value to debounce
+ * @param value The value to be debounced
+ * @param delay The delay in milliseconds
+ * @param onChange Optional callback triggered with the new debounced value
+ * @returns The debounced value
+ */
+export function useDebounce(value, delay, onChange) {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+    useEffect(() => {
+        const handler = setTimeout(() => {
+            setDebouncedValue(value);
+            if (onChangeRef.current) {
+                onChangeRef.current(value);
+            }
+        }, delay);
+        return () => {
+            clearTimeout(handler);
+        };
+    }, [value, delay]);
+    return debouncedValue;
+}
+//# sourceMappingURL=useDebounce.js.map

package/dist/hooks/useDebounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.js","sourceRoot":"","sources":["../../src/hooks/useDebounce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,KAAQ,EACR,KAAa,EACb,QAA6B;IAE7B,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAI,KAAK,CAAC,CAAC;IAE/D,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnB,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/hooks/useDeviceOrientation.d.ts

@@ -0,0 +1,10 @@
+export type Orientation = 'PORTRAIT' | 'LANDSCAPE';
+/**
+ * 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 declare function useDeviceOrientation(onChange?: (orientation: Orientation) => void): Orientation;
+//# sourceMappingURL=useDeviceOrientation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDeviceOrientation.d.ts","sourceRoot":"","sources":["../../src/hooks/useDeviceOrientation.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GAC5C,WAAW,CA8Bb"}