react-hook-toolkit 4.0.0 → 5.0.0

package/README.md

@@ -1,36 +1,289 @@
-
-**react-hook-toolkit** package offers a comprehensive set of hooks to simplify React development. It includes hooks for managing state, handling API requests, optimizing performance, and improving user interactions. Key features include data fetching, form handling, local storage management, debouncing/throttling, window size tracking, event listeners, and more. These hooks are designed to enhance productivity by providing reusable, easy-to-use solutions for common tasks.
-
-**Note : This lightweight and type-safe package is written in TypeScript and offers full support for all hooks across all modern browsers.**
-
-### Installation
-
-Install the package:
-
-```bash
-npm install react-hook-toolkit
-# or
-pnpm add react-hook-toolkit
-```
-
-### **Authors**
-
-![NPM](https://img.shields.io/badge/Author-React_Developers-red)   ![npm](https://img.shields.io/npm/v/react-hook-toolkit?color=1C939D)   ![npm](https://img.shields.io/npm/dt/react-hook-toolkit)   ![NPM](https://img.shields.io/npm/l/react-hook-toolkit)   ![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/react-hook-toolkit)
-
-### **Browser Support**  
-
-| ![Firefox](https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox_48x48.png) | ![Chrome](https://raw.githubusercontent.com/alrra/browser-logos/main/src/chrome/chrome_48x48.png)  | ![Safari](https://raw.githubusercontent.com/alrra/browser-logos/main/src/safari/safari_48x48.png) | ![Opera](https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera_48x48.png) | ![Edge](https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge_48x48.png)
-| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| Latest ✔                                                                                          | Latest ✔                                                                                             | Latest ✔                                                                                          | Latest ✔                                                                                       | Latest ✔                                                                                    | 
-
-
-### **Documentation**
-
-Comprehensive documentation with step-by-step guides, practical examples, and easy-to-follow explanations to help you quickly understand and use all custom hooks effectively.
-
-👉 https://react-hook-toolkit.netlify.app
-
-
-  **License** 
-
-[MIT](https://docs.npmjs.com/policies/npm-license) © (2022-2024)
+
+**react-hook-toolkit** package offers a comprehensive set of hooks to simplify React development. It includes hooks for managing state, handling API requests, optimizing performance, and improving user interactions. Key features include data fetching, form handling, local storage management, debouncing/throttling, window size tracking, event listeners, and more. These hooks are designed to enhance productivity by providing reusable, easy-to-use solutions for common tasks.
+
+**Note : This lightweight and type-safe package is written in TypeScript and offers full support for all hooks across all modern browsers.**
+
+### Installation
+
+Install the package:
+
+```bash
+npm install react-hook-toolkit
+# or
+pnpm add react-hook-toolkit
+```
+
+### **Authors**
+
+![NPM](https://img.shields.io/badge/Author-React_Developers-red)   ![npm](https://img.shields.io/npm/v/react-hook-toolkit?color=1C939D)   ![npm](https://img.shields.io/npm/dt/react-hook-toolkit)   ![NPM](https://img.shields.io/npm/l/react-hook-toolkit)   ![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/react-hook-toolkit)
+
+### **Browser Support**
+
+| ![Firefox](https://raw.githubusercontent.com/alrra/browser-logos/main/src/firefox/firefox_48x48.png) | ![Chrome](https://raw.githubusercontent.com/alrra/browser-logos/main/src/chrome/chrome_48x48.png)  | ![Safari](https://raw.githubusercontent.com/alrra/browser-logos/main/src/safari/safari_48x48.png) | ![Opera](https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera_48x48.png) | ![Edge](https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge_48x48.png)
+| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| Latest ✔                                                                                          | Latest ✔                                                                                             | Latest ✔                                                                                          | Latest ✔                                                                                       | Latest ✔                                                                                    |
+
+
+### **Documentation**
+
+Comprehensive documentation with step-by-step guides, practical examples, and easy-to-follow explanations to help you quickly understand and use all custom hooks effectively.
+
+👉 https://react-hook-toolkit.netlify.app
+
+
+---
+
+## Available Hooks
+
+### 🔄 State & Data Management
+
+| Hook | Description |
+|------|-------------|
+| `useToggle` | Boolean toggle with a stable flip function |
+| `useBoolean` | Boolean with explicit `setTrue` / `setFalse` / `toggle` / `set` |
+| `usePrevious` | Returns the value from the previous render |
+| `useArray` | Array state with push, removeByIndex, clear helpers |
+| `useList` | Array state with rich set/push/removeAt/insertAt/updateAt/clear actions |
+| `useCounter` | Numeric counter with min/max/step bounds and increment/decrement/reset/set |
+| `useMap` | Map data structure as React state with get/set/delete/clear |
+| `useSet` | Set data structure as React state with add/delete/toggle/clear |
+| `useQueue` | FIFO queue with enqueue/dequeue/peek/clear |
+| `useStack` | LIFO stack with push/pop/peek/clear |
+| `useUndo` | Simple undo/redo state stack |
+| `useHistoryState` | Full undo/redo history with past, present, and future arrays |
+| `useHistory` | push/replace/goBack/goForward wrappers around the History API |
+| `useStateWithCallback` | setState that fires a callback after the update is applied |
+| `useMergeState` | Object state with partial merge (like class component setState) |
+| `useResetState` | useState augmented with a reset() that restores the initial value |
+| `useSyncedState` | State synced across browser tabs/windows via BroadcastChannel |
+| `useDerivedState` | Memoized value computed from a source with explicit transform |
+| `usePatch` | Object state with a patch() method for one-level deep partial updates |
+| `usePersistedState` | useState synced to localStorage |
+| `useSafeState` | Suppresses state updates after component unmount |
+| `useRafState` | Batches state updates via requestAnimationFrame |
+| `useForceUpdate` | Returns a function that forces a component re-render |
+| `useGenericReducer` | Factory for creating typed reducers |
+
+### 🌐 Fetching & API
+
+| Hook | Description |
+|------|-------------|
+| `useAsync` | Runs an async function on mount, tracks status/value/error |
+| `useAsyncCallback` | Imperative async wrapper — isPending/data/error/reset; does not auto-run |
+| `useRequest` | Fetches JSON from a URL, returns `{ data, loading, error }` |
+| `useRequestRetry` | Like `useRequest` with automatic retry on failure |
+| `useAbortFetch` | Fetch with AbortController — auto-cancels on unmount or URL change |
+| `useLazyFetch` | Fetch triggered manually (not on mount) |
+| `usePolling` | Repeatedly calls an async fetcher on a fixed interval |
+| `useOptimisticUpdate` | Applies an optimistic value immediately, rolls back on error |
+| `useInfiniteScroll` | Loads paginated data as the user scrolls to the bottom |
+| `useWebSocket` | Connects to a WebSocket and exposes data/send/isConnected |
+
+### ⏱ Timing & Async
+
+| Hook | Description |
+|------|-------------|
+| `useDebounce` | Debounced copy of a value |
+| `useDebouncedValue` | Alias for `useDebounce` |
+| `useDebouncedCallback` | Debounced callback function |
+| `useDebouncedState` | State that only updates after the setter hasn't been called for N ms |
+| `useThrottle` | Throttled copy of a value |
+| `useDelay` | Delays propagation of a value by a fixed time |
+| `useInterval` | Runs a callback on a repeating interval |
+| `useTimeout` | Runs a callback once after a delay |
+| `useTimer` | Countdown timer that decrements every second |
+| `useCountUp` | Animates a number from 0 up to a target |
+| `useCountDown` | Animates a number from a start value down to 0 |
+| `useClock` | Returns a live `Date` updated every N milliseconds |
+| `useStopwatch` | Start/stop/reset/lap elapsed-time stopwatch in milliseconds |
+| `useAnimationFrame` | Calls a callback on every rAF frame; returns start/stop/isRunning |
+| `useIdleCallback` | Schedules a callback with requestIdleCallback (setTimeout fallback) |
+| `useAsyncEffect` | useEffect wrapper that accepts an async function with cancellation guard |
+
+### 💾 Browser Storage
+
+| Hook | Description |
+|------|-------------|
+| `useLocalStorage` | Reads/writes a localStorage key as state |
+| `useSessionStorage` | Reads/writes a sessionStorage key as state |
+| `useCookie` | Reads, writes, and deletes a browser cookie |
+| `useIndexedDB` | Reads all records from an IndexedDB object store |
+| `usePersistedForm` | Form state that auto-saves to localStorage |
+| `usePersistedState` | Generic state synced to localStorage |
+
+### 📐 DOM & Layout
+
+| Hook | Description |
+|------|-------------|
+| `useWindowSize` | Reactive window width and height |
+| `useResizeObserver` | Observes size changes on a ref'd element |
+| `useMeasure` | Full bounding rect of a ref'd element, updates on resize |
+| `useRect` | Reactive bounding DOMRect via ResizeObserver + scroll — returns `[ref, rect]` |
+| `useScrollPosition` | Current page scroll X/Y |
+| `useScrollDirection` | Whether the user is scrolling `'up'` or `'down'` |
+| `useScrollLock` | Locks/unlocks `document.body` overflow |
+| `useLockBodyScroll` | Locks body scroll and compensates for scrollbar width |
+| `useScrollToTop` | Returns `[isVisible, scrollToTop]` — shows button after threshold |
+| `useScrollIntoView` | Returns ref + function that scrolls the element into the viewport |
+| `useScrollThreshold` | Returns true when page (or element) has scrolled past a pixel offset |
+| `useMousePosition` | Current mouse X/Y relative to the viewport |
+| `useIntersectionObserver` | Tracks whether a ref'd element is visible in the viewport |
+| `useInView` | Convenience `[ref, inView]` wrapper over IntersectionObserver; supports `once` |
+| `useMutationObserver` | Observes DOM mutations on a ref'd element |
+| `useGridLayout` | Tracks CSS grid column and row count of a ref'd element |
+| `useVirtualList` | Windowed (virtual) list — only renders visible items |
+| `useFocusTrap` | Traps keyboard Tab focus within a container (for modals/dialogs) |
+| `useEventListener` | Attaches a single event listener to an element or window |
+| `useEventListeners` | Attaches an event listener with a stable handler ref |
+| `useScript` | Dynamically loads an external script and reports its status |
+| `useCss` | Injects a CSS string into the document head |
+| `useImageLoader` | Tracks loaded/error state of an image src |
+| `useTitle` | Reactively sets `document.title`; optionally restores it on unmount |
+| `useFavicon` | Dynamically updates the page favicon href |
+
+### 🎨 UI & Interaction
+
+| Hook | Description |
+|------|-------------|
+| `useDarkMode` | Tracks and toggles dark mode preference |
+| `useTheme` | light/dark/system theme with localStorage persistence and `data-theme` attribute |
+| `useBreakpoint` | Named breakpoint (`xs`/`sm`/`md`/`lg`/`xl`/`2xl`) from window width |
+| `useMediaQuery` | Returns true when a CSS media query matches |
+| `useReducedMotion` | Returns true when the user prefers reduced motion |
+| `useRipple` | Material-style ripple effect — returns ripple entries and onMouseDown handler |
+| `useToast` | Toast notification state manager with auto-dismiss |
+| `useModal` | Modal open/close state with body scroll lock |
+| `useContextMenu` | Right-click context menu position state |
+| `useHover` | Tracks hover via mouseenter/mouseleave, returns `[ref, isHovered]` |
+| `useHoverDirty` | Tracks hover via mouseover/mouseout on a ref'd element |
+| `useFocus` | Tracks focus state of a ref'd element with programmatic focus/blur |
+| `useClickAway` | Calls a handler when a click occurs outside a ref'd element |
+| `useLongPress` | Fires a callback after a sustained press (mouse or touch) |
+| `useTouch` | Tracks touchstart/touchmove/touchend coordinates on an element |
+| `useSwiping` | Detects swipe gestures (left/right/up/down) with directional callbacks |
+| `usePointers` | Handles all pointer events and tracks active pointers by pointerId |
+| `useDragAndDrop` | Container + draggable item props with `onDrop(from, to)` callback |
+| `useDragReorder` | Drag-and-drop list reordering |
+| `useFileDropArea` | File drag-drop + input handling with type/size validation |
+| `useSelection` | Returns currently selected text and its bounding DOMRect |
+
+### ⌨️ Input & Forms
+
+| Hook | Description |
+|------|-------------|
+| `useInput` | Controlled input state with value/onChange/reset and spread-ready `bind` |
+| `useCheckbox` | Controlled checkbox state with toggle and spread-ready `bind` |
+| `useForm` | Basic form values + per-field validation |
+| `useSmartForm` | Form with auto-save to localStorage and dirty tracking |
+| `useFormSubmit` | Wraps an async submit handler with isSubmitting/submitError |
+| `useFormWizard` | Multi-step form wizard with per-step validation |
+| `useFieldArray` | Dynamic field arrays with append/remove/update |
+| `useCrossFieldValidation` | Cross-field validation returning per-field errors |
+| `useValidation` | Standalone field validation with an array of validator functions |
+| `useSearch` | Search query state with filtered results and optional debounce |
+| `useFilter` | Filters an array by a predicate function |
+| `useSort` | Sorts an array by key with direction toggling |
+| `useAutocomplete` | Suggestions list with keyboard navigation (Up/Down/Enter/Escape) |
+
+### 🧭 Navigation & Routing
+
+| Hook | Description |
+|------|-------------|
+| `useRouter` | Minimal client-side router with pathname, searchParams, and navigate |
+| `useNavigationState` | Tracks pathname/search/state from pushState/popstate |
+| `useHistoryState` | Undo/redo state with full history (past/present/future) |
+| `useMenuNavigation` | Flattens nested menu data and handles path-based selection |
+| `useHash` | Reads and writes the URL hash fragment as state |
+| `useQueryParams` | Reads and writes URL search parameters reactively |
+| `useParams` | Extracts named dynamic route parameters from the current URL path |
+| `usePagination` | Client-side pagination: page, pageSize, totalPages, offset, next/prev/goTo |
+
+### 🔐 Auth & Permissions
+
+| Hook | Description |
+|------|-------------|
+| `usePermission` | Queries the Permissions API for a descriptor |
+
+### 📡 Browser & Device
+
+| Hook | Description |
+|------|-------------|
+| `useBattery` | Battery level, charging state, and charge/discharge times |
+| `useGeoLocation` | Current geolocation position |
+| `useOnlineStatus` | Whether the browser is online |
+| `useNetwork` | Network info: effectiveType, downlink, rtt, saveData |
+| `useNetworkState` | Full NetworkInformation API with `since` timestamp |
+| `useOrientation` | Device screen orientation type/angle with isPortrait/isLandscape |
+| `usePreferredLanguage` | Navigator language and languages list |
+| `useIdle` | Detects user inactivity after a configurable timeout |
+| `usePageVisibility` | Returns true when the current browser tab is visible |
+| `useBrowser` | Full browser controls: navigate, reload, fullscreen, clipboard, share, and more |
+| `useFullscreen` | Fullscreen API for a ref'd element with enter/exit/toggle |
+| `useMediaDevices` | getUserMedia access + device enumeration for camera and microphone |
+| `useAudioAnalyser` | Real-time audio frequency and time-domain data via AnalyserNode |
+| `useScreenCapture` | Screen/window/tab capture via getDisplayMedia |
+| `useGamepad` | Polls Gamepad API state on every rAF frame |
+| `useNotification` | Web Notifications API — request permission and show notifications |
+| `useVibration` | Vibration API — trigger device vibration with a pattern |
+| `useWakeLock` | Screen Wake Lock API — prevents screen from sleeping |
+| `useShareSheet` | Web Share API — triggers the native OS share sheet |
+| `useMotion` | Device motion sensor (acceleration, rotation rate) |
+| `useWorker` | Runs a function in a Web Worker background thread |
+
+### 🗣 Speech & Audio
+
+| Hook | Description |
+|------|-------------|
+| `useSpeech` | Text-to-speech via the SpeechSynthesis API (declarative) |
+| `useSpeak` | Text-to-speech with imperative speak/stop/pause/resume controls |
+| `useVoice` | Speech recognition with command matching, history, wake word, and shortcuts |
+| `useSound` | HTML audio player with play/pause/stop/setVolume controls |
+
+### 🔁 Lifecycle & Utilities
+
+| Hook | Description |
+|------|-------------|
+| `useIsMounted` | Returns true after the component mounts |
+| `useIsFirstRender` | Returns true only on the very first render |
+| `useUnmountedRef` | Ref that becomes true after the component unmounts |
+| `useUpdateEffect` | Like useEffect but skips the first (mount) run |
+| `useIsomorphicEffect` | useLayoutEffect on the browser, useEffect on the server (SSR-safe) |
+| `useBeforeUnload` | Prompts the user before leaving the page |
+| `usePageLeave` | Fires a callback when the mouse leaves the page |
+| `useVisibilityChange` | Returns true when the browser tab is visible |
+| `useLatest` | Ref that always holds the most recent value — avoids stale closures |
+| `useEventCallback` | Stable callback ref — safe for event listeners without re-subscribing |
+| `useStableCallback` | Semantic alias for useEventCallback |
+| `useConstant` | Evaluates an initializer once and never recomputes it |
+| `useComputed` | Memoized derived value — semantic alias for useMemo |
+| `useDeepCompareEffect` | useEffect with deep equality dep comparison |
+| `useDeepCompareMemo` | useMemo with deep equality dep comparison |
+| `useShallowEqual` | Returns the previous (stable) reference when value is shallowly equal |
+| `useStepper` | Step wizard with next/back/reset/goto and isFirstStep/isLastStep |
+| `useRecentSearch` | Persists and manages a recent-searches list in localStorage |
+| `useEventEmitter` | In-component pub/sub: on/off/emit/once/clear |
+| `useClipboard` | Copy text to the clipboard with a copied state |
+| `useScrollIntoView` | Returns ref + scrollIntoView() function |
+
+### 🛠 Context & Optimization
+
+| Hook | Description |
+|------|-------------|
+| `createOptimizedContext` | Creates a context with a selector-based hook to avoid unnecessary re-renders |
+| `useDrawer` | Consumes the DrawerContext (open/close/state) |
+
+### 🐛 Developer Tools
+
+| Hook | Description |
+|------|-------------|
+| `useWhyDidYouUpdate` | Logs which props/state changed to trigger the last render (dev only) |
+| `useLogger` | Logs a label and values on every render (dev only) |
+| `useRenderCount` | Returns the number of times the component has rendered |
+| `useErrorBoundary` | Imperative showBoundary(error) to surface errors to the nearest ErrorBoundary |
+| `useReducerLogger` | Wraps useReducer to log every action and state change (dev only) |
+
+---
+
+  **License**
+
+[MIT](https://docs.npmjs.com/policies/npm-license) © (2022-2024)

package/dist/chunk1516/chunk1617.d.ts

@@ -0,0 +1,190 @@
+import { MutableRefObject } from 'react';
+interface UseCounterOptions {
+    min?: number;
+    max?: number;
+    step?: number;
+}
+interface UseCounterReturn {
+    count: number;
+    increment: () => void;
+    decrement: () => void;
+    reset: () => void;
+    set: (value: number) => void;
+}
+/**
+ * Manages a numeric counter with optional min/max bounds and a configurable step.
+ */
+export declare function useCounter(initialValue?: number, options?: UseCounterOptions): UseCounterReturn;
+interface UseMapReturn<K, V> {
+    map: Map<K, V>;
+    set: (key: K, value: V) => void;
+    get: (key: K) => V | undefined;
+    has: (key: K) => boolean;
+    delete: (key: K) => void;
+    clear: () => void;
+    size: number;
+}
+/**
+ * Manages a Map data structure as React state with stable action methods.
+ */
+export declare function useMap<K, V>(initialEntries?: Iterable<[K, V]>): UseMapReturn<K, V>;
+interface UseSetReturn<T> {
+    set: Set<T>;
+    add: (value: T) => void;
+    has: (value: T) => boolean;
+    delete: (value: T) => void;
+    toggle: (value: T) => void;
+    clear: () => void;
+    size: number;
+}
+/**
+ * Manages a Set data structure as React state with stable action methods.
+ */
+export declare function useSet<T>(initialValues?: Iterable<T>): UseSetReturn<T>;
+interface UseQueueReturn<T> {
+    queue: T[];
+    enqueue: (item: T) => void;
+    dequeue: () => T | undefined;
+    peek: () => T | undefined;
+    clear: () => void;
+    size: number;
+    isEmpty: boolean;
+}
+/**
+ * Manages a FIFO queue as React state.
+ */
+export declare function useQueue<T>(initialItems?: T[]): UseQueueReturn<T>;
+interface UseStackReturn<T> {
+    stack: T[];
+    push: (item: T) => void;
+    pop: () => T | undefined;
+    peek: () => T | undefined;
+    clear: () => void;
+    size: number;
+    isEmpty: boolean;
+}
+/**
+ * Manages a LIFO stack as React state.
+ */
+export declare function useStack<T>(initialItems?: T[]): UseStackReturn<T>;
+interface UseFocusReturn {
+    ref: MutableRefObject<HTMLElement | null>;
+    isFocused: boolean;
+    focus: () => void;
+    blur: () => void;
+}
+/**
+ * Tracks focus state of a DOM element via a ref.
+ */
+export declare function useFocus(): UseFocusReturn;
+/**
+ * Tracks whether a DOM element is being hovered via a ref.
+ * Returns a [ref, isHovered] tuple.
+ */
+export declare function useHover<T extends HTMLElement = HTMLElement>(): [MutableRefObject<T | null>, boolean];
+interface UseIntersectionObserverOptions extends IntersectionObserverInit {
+    freezeOnceVisible?: boolean;
+}
+/**
+ * Observes whether a ref'd element is intersecting the viewport (or a given root).
+ * When freezeOnceVisible is true the entry is frozen after first intersection.
+ */
+export declare function useIntersectionObserver(elementRef: MutableRefObject<Element | null>, options?: UseIntersectionObserverOptions): IntersectionObserverEntry | undefined;
+interface DOMRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+interface UseMeasureReturn {
+    ref: MutableRefObject<HTMLElement | null>;
+    rect: DOMRect;
+}
+/**
+ * Measures the bounding rect of a DOM element, updating on resize.
+ */
+export declare function useMeasure(): UseMeasureReturn;
+interface NetworkState {
+    isOnline: boolean;
+    effectiveType: string | null;
+    downlink: number | null;
+    rtt: number | null;
+    saveData: boolean | null;
+    type: string | null;
+}
+/**
+ * Returns detailed network connection information including online status,
+ * effective connection type, downlink speed, and RTT.
+ */
+export declare function useNetwork(): NetworkState;
+/**
+ * Reads and writes the URL hash (fragment) as state.
+ * Returns [hash, setHash] where hash does not include the leading '#'.
+ */
+export declare function useHash(): [string, (hash: string) => void];
+/**
+ * Returns a ref that always holds the most recent value.
+ * Useful for reading the latest prop/state inside a callback without
+ * adding it to the dependency array.
+ */
+export declare function useLatest<T>(value: T): MutableRefObject<T>;
+/**
+ * Returns a stable callback reference that always delegates to the latest
+ * version of the provided function. Safe to pass to event listeners without
+ * causing unnecessary re-subscriptions.
+ */
+export declare function useEventCallback<T extends (...args: any[]) => any>(fn: T): T;
+/**
+ * A drop-in replacement for useState that suppresses state updates after the
+ * component has unmounted, preventing "Can't perform a React state update on an
+ * unmounted component" warnings.
+ */
+export declare function useSafeState<T>(initialState: T | (() => T)): [T, React.Dispatch<React.SetStateAction<T>>];
+/**
+ * Identical to useState but batches updates via requestAnimationFrame,
+ * reducing the number of renders for rapidly changing values (e.g. mouse
+ * position, scroll events).
+ */
+export declare function useRafState<T>(initialState: T | (() => T)): [T, React.Dispatch<React.SetStateAction<T>>];
+interface UseTitleOptions {
+    restoreOnUnmount?: boolean;
+}
+/**
+ * Sets the document title reactively. Optionally restores the previous title
+ * on unmount.
+ */
+export declare function useTitle(title: string, options?: UseTitleOptions): void;
+/**
+ * Dynamically updates the page favicon by href. Useful for notifications or
+ * theme changes (e.g. switching between light/dark favicon).
+ */
+export declare function useFavicon(href: string): void;
+/**
+ * Debug hook that logs which prop/state changes triggered the last render.
+ * Only active in development; no-ops in production.
+ * Pass a label and the component's props/state object.
+ */
+export declare function useWhyDidYouUpdate(name: string, props: Record<string, any>): void;
+interface UseFullscreenReturn {
+    ref: MutableRefObject<HTMLElement | null>;
+    isFullscreen: boolean;
+    enter: () => Promise<void>;
+    exit: () => Promise<void>;
+    toggle: () => Promise<void>;
+    isSupported: boolean;
+}
+/**
+ * Manages the Fullscreen API for a specific element (or the whole document when
+ * no ref target is provided). Tracks fullscreen state reactively.
+ */
+export declare function useFullscreen(): UseFullscreenReturn;
+/**
+ * Logs the component name and any values passed on every render.
+ * Only logs in development mode.
+ */
+export declare function useLogger(name: string, ...values: any[]): void;
+export {};