@malconlobo/react-utility-hooks 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# react-utility-hooks
+
+A collection of robust, type-safe utility React hooks.
+
+## Installation
+
+```bash
+npm install react-utility-hooks
+```
+
+## Hooks Available
+
+- `useDebounce`: Delays updating a value.
+- `useThrottle`: Limits how often a value updates.
+- `usePrevious`: Tracks the previous state or prop value.
+- `useLocalStorage`: Syncs state with local storage.
+- `useMediaQuery`: Tracks the state of a CSS media query.
+- `useAsync`: Handles asynchronous operations and exposes status/error.
+- `useIntersectionObserver`: Tracks element visibility in the viewport.
+- `useInfiniteScroll`: Triggers callbacks when scrolling near the bottom of a container.
+
+## Usage Examples
+
+### `useDebounce`
+```tsx
+import { useState } from 'react';
+import { useDebounce } from 'react-utility-hooks';
+
+function App() {
+  const [searchTerm, setSearchTerm] = useState('');
+  const debouncedSearchTerm = useDebounce(searchTerm, 500);
+
+  return (
+    <input 
+      value={searchTerm} 
+      onChange={(e) => setSearchTerm(e.target.value)} 
+    />
+  );
+}
+```
+
+### `useLocalStorage`
+```tsx
+import { useLocalStorage } from 'react-utility-hooks';
+
+function App() {
+  const [theme, setTheme] = useLocalStorage('theme', 'light');
+
+  return (
+    <button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>
+      Toggle Theme
+    </button>
+  );
+}
+```
+
+## License
+MIT

package/dist/index.d.mts

@@ -0,0 +1,82 @@
+import * as react from 'react';
+import { RefObject } from 'react';
+
+/**
+ * Delays updating the value until after `delay` milliseconds have elapsed.
+ *
+ * @param value The value to debounce.
+ * @param delay The delay in milliseconds.
+ * @returns The debounced value.
+ */
+declare function useDebounce<T>(value: T, delay: number): T;
+
+/**
+ * Returns a throttled version of the value that only updates at most once every `delay` milliseconds.
+ *
+ * @param value The value to throttle.
+ * @param delay The throttle limit in milliseconds.
+ * @returns The throttled value.
+ */
+declare function useThrottle<T>(value: T, delay: number): T;
+
+/**
+ * Stores the previous state or prop value.
+ *
+ * @param value The value to track.
+ * @returns The previous value.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+/**
+ * Syncs state to local storage so that it persists through a page refresh.
+ *
+ * @param key The local storage key.
+ * @param initialValue The initial value.
+ * @returns A tuple containing the state value and the setter function.
+ */
+declare function useLocalStorage<T>(key: string, initialValue: T): readonly [T, (value: T | ((val: T) => T)) => void];
+
+/**
+ * Tracks the state of a CSS media query.
+ *
+ * @param query The media query to track.
+ * @returns True if the media query matches, false otherwise.
+ */
+declare function useMediaQuery(query: string): boolean;
+
+/**
+ * Handles asynchronous operations (promises) providing state.
+ *
+ * @param asyncFunction The async function to execute.
+ * @param immediate Whether to execute the function immediately.
+ * @returns The state and execute function.
+ */
+declare function useAsync<T>(asyncFunction: () => Promise<T>, immediate?: boolean): {
+    execute: () => Promise<void | T>;
+    status: "idle" | "pending" | "success" | "error";
+    value: T | null;
+    error: Error | null;
+};
+
+interface Args extends IntersectionObserverInit {
+    freezeOnceVisible?: boolean;
+}
+/**
+ * Tracks the intersection of a target element with an ancestor element or with a top-level document's viewport.
+ *
+ * @param elementRef The ref of the element to observe.
+ * @param options Observer options and freezeOnceVisible.
+ * @returns The IntersectionObserverEntry.
+ */
+declare function useIntersectionObserver(elementRef: RefObject<Element>, { threshold, root, rootMargin, freezeOnceVisible }: Args): IntersectionObserverEntry | undefined;
+
+/**
+ * Uses useIntersectionObserver to trigger a callback when the user scrolls near the bottom of a container.
+ *
+ * @param callback The callback to execute when intersecting.
+ * @param options Intersection options.
+ * @returns A ref to attach to the target element.
+ */
+declare function useInfiniteScroll<T extends HTMLElement>(callback: () => void, options?: IntersectionObserverInit): react.MutableRefObject<T | null>;
+
+export { useAsync, useDebounce, useInfiniteScroll, useIntersectionObserver, useLocalStorage, useMediaQuery, usePrevious, useThrottle };

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+import * as react from 'react';
+import { RefObject } from 'react';
+
+/**
+ * Delays updating the value until after `delay` milliseconds have elapsed.
+ *
+ * @param value The value to debounce.
+ * @param delay The delay in milliseconds.
+ * @returns The debounced value.
+ */
+declare function useDebounce<T>(value: T, delay: number): T;
+
+/**
+ * Returns a throttled version of the value that only updates at most once every `delay` milliseconds.
+ *
+ * @param value The value to throttle.
+ * @param delay The throttle limit in milliseconds.
+ * @returns The throttled value.
+ */
+declare function useThrottle<T>(value: T, delay: number): T;
+
+/**
+ * Stores the previous state or prop value.
+ *
+ * @param value The value to track.
+ * @returns The previous value.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+/**
+ * Syncs state to local storage so that it persists through a page refresh.
+ *
+ * @param key The local storage key.
+ * @param initialValue The initial value.
+ * @returns A tuple containing the state value and the setter function.
+ */
+declare function useLocalStorage<T>(key: string, initialValue: T): readonly [T, (value: T | ((val: T) => T)) => void];
+
+/**
+ * Tracks the state of a CSS media query.
+ *
+ * @param query The media query to track.
+ * @returns True if the media query matches, false otherwise.
+ */
+declare function useMediaQuery(query: string): boolean;
+
+/**
+ * Handles asynchronous operations (promises) providing state.
+ *
+ * @param asyncFunction The async function to execute.
+ * @param immediate Whether to execute the function immediately.
+ * @returns The state and execute function.
+ */
+declare function useAsync<T>(asyncFunction: () => Promise<T>, immediate?: boolean): {
+    execute: () => Promise<void | T>;
+    status: "idle" | "pending" | "success" | "error";
+    value: T | null;
+    error: Error | null;
+};
+
+interface Args extends IntersectionObserverInit {
+    freezeOnceVisible?: boolean;
+}
+/**
+ * Tracks the intersection of a target element with an ancestor element or with a top-level document's viewport.
+ *
+ * @param elementRef The ref of the element to observe.
+ * @param options Observer options and freezeOnceVisible.
+ * @returns The IntersectionObserverEntry.
+ */
+declare function useIntersectionObserver(elementRef: RefObject<Element>, { threshold, root, rootMargin, freezeOnceVisible }: Args): IntersectionObserverEntry | undefined;
+
+/**
+ * Uses useIntersectionObserver to trigger a callback when the user scrolls near the bottom of a container.
+ *
+ * @param callback The callback to execute when intersecting.
+ * @param options Intersection options.
+ * @returns A ref to attach to the target element.
+ */
+declare function useInfiniteScroll<T extends HTMLElement>(callback: () => void, options?: IntersectionObserverInit): react.MutableRefObject<T | null>;
+
+export { useAsync, useDebounce, useInfiniteScroll, useIntersectionObserver, useLocalStorage, useMediaQuery, usePrevious, useThrottle };

package/dist/index.js

@@ -0,0 +1,225 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  useAsync: () => useAsync,
+  useDebounce: () => useDebounce,
+  useInfiniteScroll: () => useInfiniteScroll,
+  useIntersectionObserver: () => useIntersectionObserver,
+  useLocalStorage: () => useLocalStorage,
+  useMediaQuery: () => useMediaQuery,
+  usePrevious: () => usePrevious,
+  useThrottle: () => useThrottle
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/hooks/useDebounce.ts
+var import_react = require("react");
+function useDebounce(value, delay) {
+  const [debouncedValue, setDebouncedValue] = (0, import_react.useState)(value);
+  (0, import_react.useEffect)(() => {
+    const handler = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      clearTimeout(handler);
+    };
+  }, [value, delay]);
+  return debouncedValue;
+}
+
+// src/hooks/useThrottle.ts
+var import_react2 = require("react");
+function useThrottle(value, delay) {
+  const [throttledValue, setThrottledValue] = (0, import_react2.useState)(value);
+  const lastExecuted = (0, import_react2.useRef)(Date.now());
+  (0, import_react2.useEffect)(() => {
+    const timeSinceLastExecution = Date.now() - lastExecuted.current;
+    if (timeSinceLastExecution >= delay) {
+      setThrottledValue(value);
+      lastExecuted.current = Date.now();
+    } else {
+      const timerId = setTimeout(() => {
+        setThrottledValue(value);
+        lastExecuted.current = Date.now();
+      }, delay - timeSinceLastExecution);
+      return () => clearTimeout(timerId);
+    }
+  }, [value, delay]);
+  return throttledValue;
+}
+
+// src/hooks/usePrevious.ts
+var import_react3 = require("react");
+function usePrevious(value) {
+  const ref = (0, import_react3.useRef)();
+  (0, import_react3.useEffect)(() => {
+    ref.current = value;
+  }, [value]);
+  return ref.current;
+}
+
+// src/hooks/useLocalStorage.ts
+var import_react4 = require("react");
+function useLocalStorage(key, initialValue) {
+  const [storedValue, setStoredValue] = (0, import_react4.useState)(() => {
+    try {
+      if (typeof window === "undefined") {
+        return initialValue;
+      }
+      const item = window.localStorage.getItem(key);
+      return item ? JSON.parse(item) : initialValue;
+    } catch (error) {
+      console.warn(`Error reading localStorage key "${key}":`, error);
+      return initialValue;
+    }
+  });
+  const setValue = (value) => {
+    try {
+      const valueToStore = value instanceof Function ? value(storedValue) : value;
+      setStoredValue(valueToStore);
+      if (typeof window !== "undefined") {
+        window.localStorage.setItem(key, JSON.stringify(valueToStore));
+      }
+    } catch (error) {
+      console.warn(`Error setting localStorage key "${key}":`, error);
+    }
+  };
+  return [storedValue, setValue];
+}
+
+// src/hooks/useMediaQuery.ts
+var import_react5 = require("react");
+function useMediaQuery(query) {
+  const getMatches = (query2) => {
+    if (typeof window !== "undefined") {
+      return window.matchMedia(query2).matches;
+    }
+    return false;
+  };
+  const [matches, setMatches] = (0, import_react5.useState)(() => getMatches(query));
+  (0, import_react5.useEffect)(() => {
+    function handleChange() {
+      setMatches(getMatches(query));
+    }
+    const matchMedia = window.matchMedia(query);
+    handleChange();
+    if (matchMedia.addListener) {
+      matchMedia.addListener(handleChange);
+    } else {
+      matchMedia.addEventListener("change", handleChange);
+    }
+    return () => {
+      if (matchMedia.removeListener) {
+        matchMedia.removeListener(handleChange);
+      } else {
+        matchMedia.removeEventListener("change", handleChange);
+      }
+    };
+  }, [query]);
+  return matches;
+}
+
+// src/hooks/useAsync.ts
+var import_react6 = require("react");
+function useAsync(asyncFunction, immediate = true) {
+  const [state, setState] = (0, import_react6.useState)({
+    status: "idle",
+    value: null,
+    error: null
+  });
+  const execute = (0, import_react6.useCallback)(() => {
+    setState({ status: "pending", value: null, error: null });
+    return asyncFunction().then((response) => {
+      setState({ status: "success", value: response, error: null });
+      return response;
+    }).catch((error) => {
+      setState({ status: "error", value: null, error });
+    });
+  }, [asyncFunction]);
+  (0, import_react6.useEffect)(() => {
+    if (immediate) {
+      execute();
+    }
+  }, [execute, immediate]);
+  return { ...state, execute };
+}
+
+// src/hooks/useIntersectionObserver.ts
+var import_react7 = require("react");
+function useIntersectionObserver(elementRef, { threshold = 0, root = null, rootMargin = "0%", freezeOnceVisible = false }) {
+  const [entry, setEntry] = (0, import_react7.useState)();
+  const frozen = entry?.isIntersecting && freezeOnceVisible;
+  const updateEntry = ([entry2]) => {
+    setEntry(entry2);
+  };
+  (0, import_react7.useEffect)(() => {
+    const node = elementRef?.current;
+    const hasIOSupport = !!window.IntersectionObserver;
+    if (!hasIOSupport || frozen || !node)
+      return;
+    const observerParams = { threshold, root, rootMargin };
+    const observer = new IntersectionObserver(updateEntry, observerParams);
+    observer.observe(node);
+    return () => observer.disconnect();
+  }, [elementRef, threshold, root, rootMargin, frozen]);
+  return entry;
+}
+
+// src/hooks/useInfiniteScroll.ts
+var import_react8 = require("react");
+function useInfiniteScroll(callback, options = { rootMargin: "100px" }) {
+  const observerRef = (0, import_react8.useRef)(null);
+  const targetRef = (0, import_react8.useRef)(null);
+  const handleIntersect = (0, import_react8.useCallback)(
+    (entries) => {
+      const [entry] = entries;
+      if (entry.isIntersecting) {
+        callback();
+      }
+    },
+    [callback]
+  );
+  (0, import_react8.useEffect)(() => {
+    if (!targetRef.current)
+      return;
+    observerRef.current = new IntersectionObserver(handleIntersect, options);
+    observerRef.current.observe(targetRef.current);
+    return () => {
+      if (observerRef.current) {
+        observerRef.current.disconnect();
+      }
+    };
+  }, [handleIntersect, options.root, options.rootMargin, options.threshold]);
+  return targetRef;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useAsync,
+  useDebounce,
+  useInfiniteScroll,
+  useIntersectionObserver,
+  useLocalStorage,
+  useMediaQuery,
+  usePrevious,
+  useThrottle
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/hooks/useDebounce.ts","../src/hooks/useThrottle.ts","../src/hooks/usePrevious.ts","../src/hooks/useLocalStorage.ts","../src/hooks/useMediaQuery.ts","../src/hooks/useAsync.ts","../src/hooks/useIntersectionObserver.ts","../src/hooks/useInfiniteScroll.ts"],"sourcesContent":["export * from './hooks/useDebounce';\nexport * from './hooks/useThrottle';\nexport * from './hooks/usePrevious';\nexport * from './hooks/useLocalStorage';\nexport * from './hooks/useMediaQuery';\nexport * from './hooks/useAsync';\nexport * from './hooks/useIntersectionObserver';\nexport * from './hooks/useInfiniteScroll';\n","import { useState, useEffect } from 'react';\n\n/**\n * Delays updating the value until after `delay` milliseconds have elapsed.\n *\n * @param value The value to debounce.\n * @param delay The delay in milliseconds.\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value);\n    }, delay);\n\n    return () => {\n      clearTimeout(handler);\n    };\n  }, [value, delay]);\n\n  return debouncedValue;\n}\n","import { useState, useEffect, useRef } from 'react';\n\n/**\n * Returns a throttled version of the value that only updates at most once every `delay` milliseconds.\n *\n * @param value The value to throttle.\n * @param delay The throttle limit in milliseconds.\n * @returns The throttled value.\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n  const [throttledValue, setThrottledValue] = useState<T>(value);\n  const lastExecuted = useRef<number>(Date.now());\n\n  useEffect(() => {\n    const timeSinceLastExecution = Date.now() - lastExecuted.current;\n\n    if (timeSinceLastExecution >= delay) {\n      setThrottledValue(value);\n      lastExecuted.current = Date.now();\n    } else {\n      const timerId = setTimeout(() => {\n        setThrottledValue(value);\n        lastExecuted.current = Date.now();\n      }, delay - timeSinceLastExecution);\n\n      return () => clearTimeout(timerId);\n    }\n  }, [value, delay]);\n\n  return throttledValue;\n}\n","import { useRef, useEffect } from 'react';\n\n/**\n * Stores the previous state or prop value.\n *\n * @param value The value to track.\n * @returns The previous value.\n */\nexport function usePrevious<T>(value: T): T | undefined {\n  const ref = useRef<T>();\n\n  useEffect(() => {\n    ref.current = value;\n  }, [value]);\n\n  return ref.current;\n}\n","import { useState } from 'react';\n\n/**\n * Syncs state to local storage so that it persists through a page refresh.\n *\n * @param key The local storage key.\n * @param initialValue The initial value.\n * @returns A tuple containing the state value and the setter function.\n */\nexport function useLocalStorage<T>(key: string, initialValue: T) {\n  const [storedValue, setStoredValue] = useState<T>(() => {\n    try {\n      if (typeof window === 'undefined') {\n        return initialValue;\n      }\n      const item = window.localStorage.getItem(key);\n      return item ? JSON.parse(item) : initialValue;\n    } catch (error) {\n      console.warn(`Error reading localStorage key \"${key}\":`, error);\n      return initialValue;\n    }\n  });\n\n  const setValue = (value: T | ((val: T) => T)) => {\n    try {\n      const valueToStore = value instanceof Function ? value(storedValue) : value;\n      setStoredValue(valueToStore);\n      if (typeof window !== 'undefined') {\n        window.localStorage.setItem(key, JSON.stringify(valueToStore));\n      }\n    } catch (error) {\n      console.warn(`Error setting localStorage key \"${key}\":`, error);\n    }\n  };\n\n  return [storedValue, setValue] as const;\n}\n","import { useState, useEffect } from 'react';\n\n/**\n * Tracks the state of a CSS media query.\n *\n * @param query The media query to track.\n * @returns True if the media query matches, false otherwise.\n */\nexport function useMediaQuery(query: string): boolean {\n  const getMatches = (query: string): boolean => {\n    if (typeof window !== 'undefined') {\n      return window.matchMedia(query).matches;\n    }\n    return false;\n  };\n\n  const [matches, setMatches] = useState<boolean>(() => getMatches(query));\n\n  useEffect(() => {\n    function handleChange() {\n      setMatches(getMatches(query));\n    }\n\n    const matchMedia = window.matchMedia(query);\n    handleChange();\n\n    if (matchMedia.addListener) {\n      matchMedia.addListener(handleChange);\n    } else {\n      matchMedia.addEventListener('change', handleChange);\n    }\n\n    return () => {\n      if (matchMedia.removeListener) {\n        matchMedia.removeListener(handleChange);\n      } else {\n        matchMedia.removeEventListener('change', handleChange);\n      }\n    };\n  }, [query]);\n\n  return matches;\n}\n","import { useState, useCallback, useEffect } from 'react';\n\ntype AsyncState<T> = {\n  status: 'idle' | 'pending' | 'success' | 'error';\n  value: T | null;\n  error: Error | null;\n};\n\n/**\n * Handles asynchronous operations (promises) providing state.\n *\n * @param asyncFunction The async function to execute.\n * @param immediate Whether to execute the function immediately.\n * @returns The state and execute function.\n */\nexport function useAsync<T>(\n  asyncFunction: () => Promise<T>,\n  immediate = true\n) {\n  const [state, setState] = useState<AsyncState<T>>({\n    status: 'idle',\n    value: null,\n    error: null,\n  });\n\n  const execute = useCallback(() => {\n    setState({ status: 'pending', value: null, error: null });\n\n    return asyncFunction()\n      .then((response) => {\n        setState({ status: 'success', value: response, error: null });\n        return response;\n      })\n      .catch((error) => {\n        setState({ status: 'error', value: null, error });\n      });\n  }, [asyncFunction]);\n\n  useEffect(() => {\n    if (immediate) {\n      execute();\n    }\n  }, [execute, immediate]);\n\n  return { ...state, execute };\n}\n","import { useEffect, useState, RefObject } from 'react';\n\ninterface Args extends IntersectionObserverInit {\n  freezeOnceVisible?: boolean;\n}\n\n/**\n * Tracks the intersection of a target element with an ancestor element or with a top-level document's viewport.\n *\n * @param elementRef The ref of the element to observe.\n * @param options Observer options and freezeOnceVisible.\n * @returns The IntersectionObserverEntry.\n */\nexport function useIntersectionObserver(\n  elementRef: RefObject<Element>,\n  { threshold = 0, root = null, rootMargin = '0%', freezeOnceVisible = false }: Args\n): IntersectionObserverEntry | undefined {\n  const [entry, setEntry] = useState<IntersectionObserverEntry>();\n\n  const frozen = entry?.isIntersecting && freezeOnceVisible;\n\n  const updateEntry = ([entry]: IntersectionObserverEntry[]): void => {\n    setEntry(entry);\n  };\n\n  useEffect(() => {\n    const node = elementRef?.current;\n    const hasIOSupport = !!window.IntersectionObserver;\n\n    if (!hasIOSupport || frozen || !node) return;\n\n    const observerParams = { threshold, root, rootMargin };\n    const observer = new IntersectionObserver(updateEntry, observerParams);\n\n    observer.observe(node);\n\n    return () => observer.disconnect();\n  }, [elementRef, threshold, root, rootMargin, frozen]);\n\n  return entry;\n}\n","import { useEffect, useRef, useCallback } from 'react';\n\n/**\n * Uses useIntersectionObserver to trigger a callback when the user scrolls near the bottom of a container.\n *\n * @param callback The callback to execute when intersecting.\n * @param options Intersection options.\n * @returns A ref to attach to the target element.\n */\nexport function useInfiniteScroll<T extends HTMLElement>(\n  callback: () => void,\n  options: IntersectionObserverInit = { rootMargin: '100px' }\n) {\n  const observerRef = useRef<IntersectionObserver | null>(null);\n  const targetRef = useRef<T | null>(null);\n\n  const handleIntersect = useCallback(\n    (entries: IntersectionObserverEntry[]) => {\n      const [entry] = entries;\n      if (entry.isIntersecting) {\n        callback();\n      }\n    },\n    [callback]\n  );\n\n  useEffect(() => {\n    if (!targetRef.current) return;\n\n    observerRef.current = new IntersectionObserver(handleIntersect, options);\n    observerRef.current.observe(targetRef.current);\n\n    return () => {\n      if (observerRef.current) {\n        observerRef.current.disconnect();\n      }\n    };\n  }, [handleIntersect, options.root, options.rootMargin, options.threshold]);\n\n  return targetRef;\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_react","query","import_react","import_react","entry","import_react"]}

package/dist/index.mjs

@@ -0,0 +1,191 @@
+// src/hooks/useDebounce.ts
+import { useState, useEffect } from "react";
+function useDebounce(value, delay) {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+  useEffect(() => {
+    const handler = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      clearTimeout(handler);
+    };
+  }, [value, delay]);
+  return debouncedValue;
+}
+
+// src/hooks/useThrottle.ts
+import { useState as useState2, useEffect as useEffect2, useRef } from "react";
+function useThrottle(value, delay) {
+  const [throttledValue, setThrottledValue] = useState2(value);
+  const lastExecuted = useRef(Date.now());
+  useEffect2(() => {
+    const timeSinceLastExecution = Date.now() - lastExecuted.current;
+    if (timeSinceLastExecution >= delay) {
+      setThrottledValue(value);
+      lastExecuted.current = Date.now();
+    } else {
+      const timerId = setTimeout(() => {
+        setThrottledValue(value);
+        lastExecuted.current = Date.now();
+      }, delay - timeSinceLastExecution);
+      return () => clearTimeout(timerId);
+    }
+  }, [value, delay]);
+  return throttledValue;
+}
+
+// src/hooks/usePrevious.ts
+import { useRef as useRef2, useEffect as useEffect3 } from "react";
+function usePrevious(value) {
+  const ref = useRef2();
+  useEffect3(() => {
+    ref.current = value;
+  }, [value]);
+  return ref.current;
+}
+
+// src/hooks/useLocalStorage.ts
+import { useState as useState3 } from "react";
+function useLocalStorage(key, initialValue) {
+  const [storedValue, setStoredValue] = useState3(() => {
+    try {
+      if (typeof window === "undefined") {
+        return initialValue;
+      }
+      const item = window.localStorage.getItem(key);
+      return item ? JSON.parse(item) : initialValue;
+    } catch (error) {
+      console.warn(`Error reading localStorage key "${key}":`, error);
+      return initialValue;
+    }
+  });
+  const setValue = (value) => {
+    try {
+      const valueToStore = value instanceof Function ? value(storedValue) : value;
+      setStoredValue(valueToStore);
+      if (typeof window !== "undefined") {
+        window.localStorage.setItem(key, JSON.stringify(valueToStore));
+      }
+    } catch (error) {
+      console.warn(`Error setting localStorage key "${key}":`, error);
+    }
+  };
+  return [storedValue, setValue];
+}
+
+// src/hooks/useMediaQuery.ts
+import { useState as useState4, useEffect as useEffect4 } from "react";
+function useMediaQuery(query) {
+  const getMatches = (query2) => {
+    if (typeof window !== "undefined") {
+      return window.matchMedia(query2).matches;
+    }
+    return false;
+  };
+  const [matches, setMatches] = useState4(() => getMatches(query));
+  useEffect4(() => {
+    function handleChange() {
+      setMatches(getMatches(query));
+    }
+    const matchMedia = window.matchMedia(query);
+    handleChange();
+    if (matchMedia.addListener) {
+      matchMedia.addListener(handleChange);
+    } else {
+      matchMedia.addEventListener("change", handleChange);
+    }
+    return () => {
+      if (matchMedia.removeListener) {
+        matchMedia.removeListener(handleChange);
+      } else {
+        matchMedia.removeEventListener("change", handleChange);
+      }
+    };
+  }, [query]);
+  return matches;
+}
+
+// src/hooks/useAsync.ts
+import { useState as useState5, useCallback, useEffect as useEffect5 } from "react";
+function useAsync(asyncFunction, immediate = true) {
+  const [state, setState] = useState5({
+    status: "idle",
+    value: null,
+    error: null
+  });
+  const execute = useCallback(() => {
+    setState({ status: "pending", value: null, error: null });
+    return asyncFunction().then((response) => {
+      setState({ status: "success", value: response, error: null });
+      return response;
+    }).catch((error) => {
+      setState({ status: "error", value: null, error });
+    });
+  }, [asyncFunction]);
+  useEffect5(() => {
+    if (immediate) {
+      execute();
+    }
+  }, [execute, immediate]);
+  return { ...state, execute };
+}
+
+// src/hooks/useIntersectionObserver.ts
+import { useEffect as useEffect6, useState as useState6 } from "react";
+function useIntersectionObserver(elementRef, { threshold = 0, root = null, rootMargin = "0%", freezeOnceVisible = false }) {
+  const [entry, setEntry] = useState6();
+  const frozen = entry?.isIntersecting && freezeOnceVisible;
+  const updateEntry = ([entry2]) => {
+    setEntry(entry2);
+  };
+  useEffect6(() => {
+    const node = elementRef?.current;
+    const hasIOSupport = !!window.IntersectionObserver;
+    if (!hasIOSupport || frozen || !node)
+      return;
+    const observerParams = { threshold, root, rootMargin };
+    const observer = new IntersectionObserver(updateEntry, observerParams);
+    observer.observe(node);
+    return () => observer.disconnect();
+  }, [elementRef, threshold, root, rootMargin, frozen]);
+  return entry;
+}
+
+// src/hooks/useInfiniteScroll.ts
+import { useEffect as useEffect7, useRef as useRef3, useCallback as useCallback2 } from "react";
+function useInfiniteScroll(callback, options = { rootMargin: "100px" }) {
+  const observerRef = useRef3(null);
+  const targetRef = useRef3(null);
+  const handleIntersect = useCallback2(
+    (entries) => {
+      const [entry] = entries;
+      if (entry.isIntersecting) {
+        callback();
+      }
+    },
+    [callback]
+  );
+  useEffect7(() => {
+    if (!targetRef.current)
+      return;
+    observerRef.current = new IntersectionObserver(handleIntersect, options);
+    observerRef.current.observe(targetRef.current);
+    return () => {
+      if (observerRef.current) {
+        observerRef.current.disconnect();
+      }
+    };
+  }, [handleIntersect, options.root, options.rootMargin, options.threshold]);
+  return targetRef;
+}
+export {
+  useAsync,
+  useDebounce,
+  useInfiniteScroll,
+  useIntersectionObserver,
+  useLocalStorage,
+  useMediaQuery,
+  usePrevious,
+  useThrottle
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useDebounce.ts","../src/hooks/useThrottle.ts","../src/hooks/usePrevious.ts","../src/hooks/useLocalStorage.ts","../src/hooks/useMediaQuery.ts","../src/hooks/useAsync.ts","../src/hooks/useIntersectionObserver.ts","../src/hooks/useInfiniteScroll.ts"],"sourcesContent":["import { useState, useEffect } from 'react';\n\n/**\n * Delays updating the value until after `delay` milliseconds have elapsed.\n *\n * @param value The value to debounce.\n * @param delay The delay in milliseconds.\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value);\n    }, delay);\n\n    return () => {\n      clearTimeout(handler);\n    };\n  }, [value, delay]);\n\n  return debouncedValue;\n}\n","import { useState, useEffect, useRef } from 'react';\n\n/**\n * Returns a throttled version of the value that only updates at most once every `delay` milliseconds.\n *\n * @param value The value to throttle.\n * @param delay The throttle limit in milliseconds.\n * @returns The throttled value.\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n  const [throttledValue, setThrottledValue] = useState<T>(value);\n  const lastExecuted = useRef<number>(Date.now());\n\n  useEffect(() => {\n    const timeSinceLastExecution = Date.now() - lastExecuted.current;\n\n    if (timeSinceLastExecution >= delay) {\n      setThrottledValue(value);\n      lastExecuted.current = Date.now();\n    } else {\n      const timerId = setTimeout(() => {\n        setThrottledValue(value);\n        lastExecuted.current = Date.now();\n      }, delay - timeSinceLastExecution);\n\n      return () => clearTimeout(timerId);\n    }\n  }, [value, delay]);\n\n  return throttledValue;\n}\n","import { useRef, useEffect } from 'react';\n\n/**\n * Stores the previous state or prop value.\n *\n * @param value The value to track.\n * @returns The previous value.\n */\nexport function usePrevious<T>(value: T): T | undefined {\n  const ref = useRef<T>();\n\n  useEffect(() => {\n    ref.current = value;\n  }, [value]);\n\n  return ref.current;\n}\n","import { useState } from 'react';\n\n/**\n * Syncs state to local storage so that it persists through a page refresh.\n *\n * @param key The local storage key.\n * @param initialValue The initial value.\n * @returns A tuple containing the state value and the setter function.\n */\nexport function useLocalStorage<T>(key: string, initialValue: T) {\n  const [storedValue, setStoredValue] = useState<T>(() => {\n    try {\n      if (typeof window === 'undefined') {\n        return initialValue;\n      }\n      const item = window.localStorage.getItem(key);\n      return item ? JSON.parse(item) : initialValue;\n    } catch (error) {\n      console.warn(`Error reading localStorage key \"${key}\":`, error);\n      return initialValue;\n    }\n  });\n\n  const setValue = (value: T | ((val: T) => T)) => {\n    try {\n      const valueToStore = value instanceof Function ? value(storedValue) : value;\n      setStoredValue(valueToStore);\n      if (typeof window !== 'undefined') {\n        window.localStorage.setItem(key, JSON.stringify(valueToStore));\n      }\n    } catch (error) {\n      console.warn(`Error setting localStorage key \"${key}\":`, error);\n    }\n  };\n\n  return [storedValue, setValue] as const;\n}\n","import { useState, useEffect } from 'react';\n\n/**\n * Tracks the state of a CSS media query.\n *\n * @param query The media query to track.\n * @returns True if the media query matches, false otherwise.\n */\nexport function useMediaQuery(query: string): boolean {\n  const getMatches = (query: string): boolean => {\n    if (typeof window !== 'undefined') {\n      return window.matchMedia(query).matches;\n    }\n    return false;\n  };\n\n  const [matches, setMatches] = useState<boolean>(() => getMatches(query));\n\n  useEffect(() => {\n    function handleChange() {\n      setMatches(getMatches(query));\n    }\n\n    const matchMedia = window.matchMedia(query);\n    handleChange();\n\n    if (matchMedia.addListener) {\n      matchMedia.addListener(handleChange);\n    } else {\n      matchMedia.addEventListener('change', handleChange);\n    }\n\n    return () => {\n      if (matchMedia.removeListener) {\n        matchMedia.removeListener(handleChange);\n      } else {\n        matchMedia.removeEventListener('change', handleChange);\n      }\n    };\n  }, [query]);\n\n  return matches;\n}\n","import { useState, useCallback, useEffect } from 'react';\n\ntype AsyncState<T> = {\n  status: 'idle' | 'pending' | 'success' | 'error';\n  value: T | null;\n  error: Error | null;\n};\n\n/**\n * Handles asynchronous operations (promises) providing state.\n *\n * @param asyncFunction The async function to execute.\n * @param immediate Whether to execute the function immediately.\n * @returns The state and execute function.\n */\nexport function useAsync<T>(\n  asyncFunction: () => Promise<T>,\n  immediate = true\n) {\n  const [state, setState] = useState<AsyncState<T>>({\n    status: 'idle',\n    value: null,\n    error: null,\n  });\n\n  const execute = useCallback(() => {\n    setState({ status: 'pending', value: null, error: null });\n\n    return asyncFunction()\n      .then((response) => {\n        setState({ status: 'success', value: response, error: null });\n        return response;\n      })\n      .catch((error) => {\n        setState({ status: 'error', value: null, error });\n      });\n  }, [asyncFunction]);\n\n  useEffect(() => {\n    if (immediate) {\n      execute();\n    }\n  }, [execute, immediate]);\n\n  return { ...state, execute };\n}\n","import { useEffect, useState, RefObject } from 'react';\n\ninterface Args extends IntersectionObserverInit {\n  freezeOnceVisible?: boolean;\n}\n\n/**\n * Tracks the intersection of a target element with an ancestor element or with a top-level document's viewport.\n *\n * @param elementRef The ref of the element to observe.\n * @param options Observer options and freezeOnceVisible.\n * @returns The IntersectionObserverEntry.\n */\nexport function useIntersectionObserver(\n  elementRef: RefObject<Element>,\n  { threshold = 0, root = null, rootMargin = '0%', freezeOnceVisible = false }: Args\n): IntersectionObserverEntry | undefined {\n  const [entry, setEntry] = useState<IntersectionObserverEntry>();\n\n  const frozen = entry?.isIntersecting && freezeOnceVisible;\n\n  const updateEntry = ([entry]: IntersectionObserverEntry[]): void => {\n    setEntry(entry);\n  };\n\n  useEffect(() => {\n    const node = elementRef?.current;\n    const hasIOSupport = !!window.IntersectionObserver;\n\n    if (!hasIOSupport || frozen || !node) return;\n\n    const observerParams = { threshold, root, rootMargin };\n    const observer = new IntersectionObserver(updateEntry, observerParams);\n\n    observer.observe(node);\n\n    return () => observer.disconnect();\n  }, [elementRef, threshold, root, rootMargin, frozen]);\n\n  return entry;\n}\n","import { useEffect, useRef, useCallback } from 'react';\n\n/**\n * Uses useIntersectionObserver to trigger a callback when the user scrolls near the bottom of a container.\n *\n * @param callback The callback to execute when intersecting.\n * @param options Intersection options.\n * @returns A ref to attach to the target element.\n */\nexport function useInfiniteScroll<T extends HTMLElement>(\n  callback: () => void,\n  options: IntersectionObserverInit = { rootMargin: '100px' }\n) {\n  const observerRef = useRef<IntersectionObserver | null>(null);\n  const targetRef = useRef<T | null>(null);\n\n  const handleIntersect = useCallback(\n    (entries: IntersectionObserverEntry[]) => {\n      const [entry] = entries;\n      if (entry.isIntersecting) {\n        callback();\n      }\n    },\n    [callback]\n  );\n\n  useEffect(() => {\n    if (!targetRef.current) return;\n\n    observerRef.current = new IntersectionObserver(handleIntersect, options);\n    observerRef.current.observe(targetRef.current);\n\n    return () => {\n      if (observerRef.current) {\n        observerRef.current.disconnect();\n      }\n    };\n  }, [handleIntersect, options.root, options.rootMargin, options.threshold]);\n\n  return targetRef;\n}\n"],"mappings":"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","names":["useState","useEffect","useRef","useEffect","useState","useState","useEffect","query","useState","useEffect","useEffect","useState","entry","useEffect","useRef","useCallback"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@malconlobo/react-utility-hooks",
+  "version": "1.0.0",
+  "description": "A collection of utility React hooks.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "react",
+    "hooks",
+    "utility",
+    "useDebounce",
+    "useThrottle",
+    "usePrevious",
+    "useLocalStorage",
+    "useMediaQuery",
+    "useAsync",
+    "useInfiniteScroll",
+    "useIntersectionObserver"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/malconlobo/react-utility-hooks.git"
+  },
+  "bugs": {
+    "url": "https://github.com/malconlobo/react-utility-hooks/issues"
+  },
+  "homepage": "https://github.com/malconlobo/react-utility-hooks#readme",
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0 || ^18.0.0",
+    "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^14.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "eslint": "^8.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-react": "^7.33.0",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "jsdom": "^22.0.0",
+    "prettier": "^3.0.0",
+    "tsup": "^7.2.0",
+    "typescript": "^5.2.0",
+    "vitest": "^0.34.0"
+  }
+}