react-visibility-hooks 1.0.13 → 3.0.0

package/README.md

@@ -1,23 +1,28 @@
 # react-visibility-hooks
 
-> Tiny, SSR-safe React hooks for page visibility, idle detection, smart polling and auto-pause video
+> Tiny, SSR-safe React hooks for page visibility, idle detection, smart polling, network awareness, wake lock, battery status and more
 
 [![npm version](https://img.shields.io/npm/v/react-visibility-hooks.svg)](https://www.npmjs.com/package/react-visibility-hooks)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Bundle Size](https://img.shields.io/bundlephobia/minzip/react-visibility-hooks)](https://bundlephobia.com/package/react-visibility-hooks)
 [![CI](https://github.com/exewhyz/react-visibility-hooks/actions/workflows/ci.yml/badge.svg)](https://github.com/exewhyz/react-visibility-hooks/actions/workflows/ci.yml)
 
-A collection of lightweight React hooks that help you build performance-conscious applications by detecting page visibility, user idle state, auto-pausing video, and managing smart polling strategies.
+A collection of lightweight React hooks that help you build performance-conscious, resource-aware applications. Detect page visibility, user idle state, network conditions, battery status, and more — with zero dependencies.
 
 ## Features
 
-- 🪶 **Lightweight** - ~822 B brotlied, zero dependencies
-- 🔒 **SSR-safe** - Works seamlessly with Next.js (App Router & Pages Router), Remix, and other SSR frameworks
-- 📦 **Tree-shakeable** - Import only what you need
-- 🎯 **TypeScript** - Fully typed with exported interfaces
-- ⚡ **Performance-focused** - Pause expensive operations when users aren't looking
-- 🎬 **Auto-pause video** - Pause/resume `<video>` elements on tab visibility
-- 🔄 **Smart polling** - Visibility-aware data fetching with dedup
+- 🪶 **Lightweight** — Zero dependencies, tree-shakeable
+- 🔒 **SSR-safe** — Works with Next.js (App & Pages Router), Remix, Gatsby, and all SSR frameworks
+- 📦 **Tree-shakeable** — Import only what you need
+- 🎯 **TypeScript** — Fully typed with exported interfaces
+- ⚡ **Performance-focused** — Pause expensive operations when users aren't looking
+- 🎬 **Auto-pause video** — Pause/resume `<video>` elements on tab visibility
+- 🔄 **Smart polling** — Visibility-aware data fetching with dedup
+- 🌐 **Network-aware** — Adapt to online/offline state and connection quality
+- 🔋 **Battery-aware** — React to device battery level and charging state
+- 📱 **Wake Lock** — Prevent screen dimming during critical tasks
+- ⏱️ **Inactivity timeout** — Session management with warning countdowns
+- 🔀 **Focus transitions** — Declarative callbacks on tab show/hide
 
 ## Installation
 
@@ -25,17 +30,32 @@ A collection of lightweight React hooks that help you build performance-consciou
 npm install react-visibility-hooks
 ```
 
+```bash
+yarn add react-visibility-hooks
+```
+
+```bash
+pnpm add react-visibility-hooks
+```
+
+## Quick Start
+
+```tsx
+import {
+  useDocVisible,
+  useSmartPolling,
+  useNetworkAwarePolling,
+  usePageFocusEffect,
+} from 'react-visibility-hooks';
+```
+
 ## Hooks
 
 ### `useDocVisible`
 
 Detect when the browser tab is visible or hidden using the [Page Visibility API](https://developer.mozilla.org/en-US/docs/Web/API/Page_Visibility_API).
 
-**Use cases:**
-
-- Pause animations when tab is hidden
-- Stop fetching data when user isn't viewing the page
-- Save battery and resources
+**Use cases:** Pause animations, stop background fetches, save battery.
 
 ```tsx
 import { useDocVisible } from 'react-visibility-hooks';
@@ -43,29 +63,23 @@ import { useDocVisible } from 'react-visibility-hooks';
 function MyComponent() {
   const isVisible = useDocVisible();
 
-  return (
-    <div>
-      Tab is currently: {isVisible ? 'visible' : 'hidden'}
-    </div>
-  );
+  return <div>Tab is currently: {isVisible ? 'visible' : 'hidden'}</div>;
 }
 ```
 
+---
+
 ### `useIdleVisibility`
 
 Detect when the user is idle (no mouse, keyboard, pointer, scroll, or touch activity) combined with page visibility state.
 
-**Use cases:**
-
-- Show "Are you still there?" prompts
-- Auto-pause media after inactivity
-- Reduce background activity when user is away
+**Use cases:** "Are you still there?" prompts, auto-pause media, reduce background activity.
 
 ```tsx
 import { useIdleVisibility } from 'react-visibility-hooks';
 
 function MyComponent() {
-  const { visible, idle } = useIdleVisibility(60000); // 60 seconds timeout
+  const { visible, idle } = useIdleVisibility(60_000); // 60 seconds
 
   return (
     <div>
@@ -76,19 +90,17 @@ function MyComponent() {
 }
 ```
 
-**Parameters:**
+| Parameter | Type     | Default  | Description                                   |
+| --------- | -------- | -------- | --------------------------------------------- |
+| `timeout` | `number` | `60_000` | Ms of inactivity before the user is idle      |
 
-- `timeout` (optional): Milliseconds of inactivity before user is considered idle (default: 60000)
+---
 
 ### `useAutoPauseVideo`
 
-Automatically pause and resume videos based on page visibility. Only resumes playback if the video was actually playing before the tab was hidden — it won't override a user's manual pause.
-
-**Use cases:**
+Automatically pause and resume `<video>` elements on tab visibility. Only resumes if the video was playing before the tab was hidden — never overrides a user's manual pause.
 
-- Auto-pause videos when user switches tabs
-- Better UX for video-heavy applications
-- Save bandwidth and resources
+**Use cases:** Auto-pause videos, save bandwidth, better UX for video-heavy apps.
 
 ```tsx
 import { useRef } from 'react';
@@ -98,36 +110,29 @@ function VideoPlayer() {
   const videoRef = useRef<HTMLVideoElement>(null);
   useAutoPauseVideo(videoRef);
 
-  return (
-    <video ref={videoRef} src="video.mp4" controls />
-  );
+  return <video ref={videoRef} src="video.mp4" controls />;
 }
 ```
 
-### `useSmartPolling`
+---
 
-Visibility-aware polling built with plain React — no external dependencies. Automatically pauses when the tab is hidden, resumes when visible, and skips re-renders when data hasn't changed.
+### `useSmartPolling`
 
-**Use cases:**
+Visibility-aware data polling. Automatically pauses when the tab is hidden, resumes when visible, and skips re-renders when data hasn't changed.
 
-- Real-time dashboards
-- Live notifications
-- Auto-refresh data feeds
+**Use cases:** Real-time dashboards, live notifications, auto-refresh feeds.
 
 ```tsx
 import { useSmartPolling } from 'react-visibility-hooks';
 
 function Dashboard() {
   const { data, isLoading, isError, error, refetch } = useSmartPolling(
-    async () => {
-      const response = await fetch('/api/stats');
-      return response.json();
-    },
-    { interval: 3000 }
+    () => fetch('/api/stats').then((r) => r.json()),
+    { interval: 3000 },
   );
 
-  if (isLoading) return <div>Loading...</div>;
-  if (isError) return <div>Error: {error?.message}</div>;
+  if (isLoading) return <p>Loading…</p>;
+  if (isError) return <p>Error: {error?.message}</p>;
 
   return (
     <div>
@@ -138,48 +143,309 @@ function Dashboard() {
 }
 ```
 
-**Options:**
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `interval` | `number` | `5000` | Polling interval in milliseconds |
-| `enabled` | `boolean` | `true` | Enable/disable polling |
+**Options (`SmartPollingOptions`):**
+
+| Option     | Type      | Default | Description               |
+| ---------- | --------- | ------- | ------------------------- |
+| `interval` | `number`  | `5000`  | Polling interval in ms    |
+| `enabled`  | `boolean` | `true`  | Enable / disable polling  |
+
+**Returns (`SmartPollingResult<T>`):**
+
+| Property    | Type                  | Description                           |
+| ----------- | --------------------- | ------------------------------------- |
+| `data`      | `T \| undefined`      | The latest fetched data               |
+| `isLoading` | `boolean`             | `true` until the first fetch completes|
+| `isError`   | `boolean`             | `true` if the last fetch threw        |
+| `error`     | `Error \| undefined`  | The error object, if any              |
+| `refetch`   | `() => Promise<void>` | Manually trigger a fetch              |
+
+---
+
+### `usePageFocusEffect` ✨ <sup>NEW</sup>
+
+Run side-effect callbacks on visibility **transitions** — not on every render. Think of it as `useEffect` for tab show/hide.
+
+**Use cases:** Refetch stale data on tab return, save state on tab leave, track visibility analytics.
+
+```tsx
+import { usePageFocusEffect } from 'react-visibility-hooks';
+
+function MyComponent() {
+  usePageFocusEffect({
+    onVisible: () => {
+      console.log('Welcome back! Refetching…');
+      refetchData();
+      return () => console.log('cleanup on next transition');
+    },
+    onHidden: () => {
+      saveScrollPosition();
+    },
+  });
+}
+```
+
+**Options (`PageFocusEffectOptions`):**
+
+| Option      | Type                             | Description                                                      |
+| ----------- | -------------------------------- | ---------------------------------------------------------------- |
+| `onVisible` | `() => void \| (() => void)`    | Fires on hidden → visible. May return a cleanup function.        |
+| `onHidden`  | `() => void`                     | Fires on visible → hidden.                                       |
+
+> The initial render is **not** treated as a transition. Callbacks only fire on actual visibility changes.
+
+---
+
+### `useNetworkAwarePolling` ✨ <sup>NEW</sup>
+
+Extends `useSmartPolling` with network awareness. Pauses when offline and adapts the polling interval on slow connections (2g / slow-2g).
+
+**Use cases:** Mobile-first apps, offline-resilient dashboards, bandwidth-conscious polling.
+
+```tsx
+import { useNetworkAwarePolling } from 'react-visibility-hooks';
+
+function LiveFeed() {
+  const { data, isOnline, effectiveInterval } = useNetworkAwarePolling(
+    () => fetch('/api/feed').then((r) => r.json()),
+    { interval: 5000, slowMultiplier: 3 },
+  );
+
+  return (
+    <div>
+      <p>Status: {isOnline ? '🟢 Online' : '🔴 Offline'}</p>
+      <p>Polling every {effectiveInterval / 1000}s</p>
+      <pre>{JSON.stringify(data, null, 2)}</pre>
+    </div>
+  );
+}
+```
+
+**Options (`NetworkAwarePollingOptions`):**
+
+| Option            | Type      | Default | Description                                     |
+| ----------------- | --------- | ------- | ----------------------------------------------- |
+| `interval`        | `number`  | `5000`  | Base polling interval in ms                     |
+| `enabled`         | `boolean` | `true`  | Enable / disable polling                        |
+| `slowMultiplier`  | `number`  | `3`     | Multiplier applied on 2g/slow-2g connections    |
+| `pauseOffline`    | `boolean` | `true`  | Pause polling when offline                      |
 
-**Returns:**
-| Property | Type | Description |
-|----------|------|-------------|
-| `data` | `T \| undefined` | The latest fetched data |
-| `isLoading` | `boolean` | `true` until the first fetch completes |
-| `isError` | `boolean` | `true` if the last fetch threw |
-| `error` | `Error \| undefined` | The error object, if any |
-| `refetch` | `() => Promise<void>` | Manually trigger a fetch |
+**Returns (`NetworkAwarePollingResult<T>`):**
 
-**Optimizations:**
+Inherits all of `SmartPollingResult<T>` plus:
 
-- Skips re-renders when polled data is identical to the previous result
-- Prevents concurrent fetches from overlapping
-- Polling pauses automatically when the tab is hidden and resumes when visible
+| Property            | Type      | Description                                        |
+| ------------------- | --------- | -------------------------------------------------- |
+| `isOnline`          | `boolean` | `true` when the browser reports being online       |
+| `effectiveInterval` | `number`  | Actual polling interval after network adjustment   |
+
+---
+
+### `useInactivityTimeout` ✨ <sup>NEW</sup>
+
+Countdown-based session/inactivity manager with a warning phase. Built on `useIdleVisibility`.
+
+**Use cases:** Auto-logout, session expiry warnings, "still there?" modals.
+
+```tsx
+import { useInactivityTimeout } from 'react-visibility-hooks';
+
+function SessionManager() {
+  const { isWarning, isTimedOut, remainingSeconds, resetTimer } =
+    useInactivityTimeout({
+      timeout: 300_000,       // 5 minutes total
+      warningBefore: 60_000,  // warn 1 minute before
+      onWarning: () => showWarningToast(),
+      onTimeout: () => logout(),
+    });
+
+  if (isTimedOut) return <p>Session expired.</p>;
+
+  if (isWarning) {
+    return (
+      <div>
+        <p>Session expires in {remainingSeconds}s</p>
+        <button onClick={resetTimer}>Stay logged in</button>
+      </div>
+    );
+  }
+
+  return null;
+}
+```
+
+**Options (`InactivityTimeoutOptions`):**
+
+| Option          | Type         | Default   | Description                                       |
+| --------------- | ------------ | --------- | ------------------------------------------------- |
+| `timeout`       | `number`     | `300_000` | Total inactivity before timeout (ms)              |
+| `warningBefore` | `number`     | `60_000`  | How long before timeout to start warning (ms)     |
+| `onTimeout`     | `() => void` | —         | Called when the full timeout elapses              |
+| `onWarning`     | `() => void` | —         | Called when entering the warning phase            |
+
+**Returns (`InactivityTimeoutResult`):**
+
+| Property           | Type         | Description                                        |
+| ------------------ | ------------ | -------------------------------------------------- |
+| `idle`             | `boolean`    | `true` when the user is idle                       |
+| `visible`          | `boolean`    | Current page-visibility state                      |
+| `isWarning`        | `boolean`    | `true` during the warning countdown                |
+| `isTimedOut`       | `boolean`    | `true` after the full timeout has elapsed          |
+| `remainingSeconds` | `number`     | Seconds until timeout (`-1` when not idle)         |
+| `resetTimer`       | `() => void` | Manually reset the timer                           |
+
+---
+
+### `useWakeLock` ✨ <sup>NEW</sup>
+
+Manage the [Screen Wake Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Wake_Lock_API) to prevent the screen from dimming or locking.
+
+**Use cases:** Video calls, presentations, recipe/reading apps, kiosk mode.
+
+```tsx
+import { useWakeLock } from 'react-visibility-hooks';
+
+function PresentationMode() {
+  const { isActive, isSupported, request, release } = useWakeLock();
+
+  if (!isSupported) return <p>Wake Lock not supported</p>;
+
+  return (
+    <div>
+      <p>Screen lock prevention: {isActive ? 'ON' : 'OFF'}</p>
+      <button onClick={isActive ? release : request}>
+        {isActive ? 'Allow screen lock' : 'Keep screen on'}
+      </button>
+    </div>
+  );
+}
+```
+
+**Parameters:**
+
+| Parameter       | Type      | Default | Description                                         |
+| --------------- | --------- | ------- | --------------------------------------------------- |
+| `autoReacquire` | `boolean` | `true`  | Re-request lock when the tab becomes visible again   |
+
+**Returns (`WakeLockResult`):**
+
+| Property      | Type                  | Description                              |
+| ------------- | --------------------- | ---------------------------------------- |
+| `isActive`    | `boolean`             | `true` while a Wake Lock is held         |
+| `request`     | `() => Promise<void>` | Request the screen Wake Lock             |
+| `release`     | `() => Promise<void>` | Release the current Wake Lock            |
+| `isSupported` | `boolean`             | `true` if the API is available           |
+
+---
+
+### `useBatteryAware` ✨ <sup>NEW</sup>
+
+Expose device battery status via the [Battery Status API](https://developer.mozilla.org/en-US/docs/Web/API/Battery_Status_API).
+
+**Use cases:** Reduce polling on low battery, disable animations, show battery indicators.
+
+```tsx
+import { useBatteryAware } from 'react-visibility-hooks';
+
+function BatteryIndicator() {
+  const { charging, level, isLowBattery, isSupported } = useBatteryAware(0.15);
+
+  if (!isSupported) return null;
+
+  return (
+    <div>
+      <p>🔋 {Math.round(level * 100)}%{charging ? ' ⚡ Charging' : ''}</p>
+      {isLowBattery && <p>⚠️ Low battery — reducing activity</p>}
+    </div>
+  );
+}
+```
+
+**Parameters:**
+
+| Parameter      | Type     | Default | Description                                             |
+| -------------- | -------- | ------- | ------------------------------------------------------- |
+| `lowThreshold` | `number` | `0.15`  | Level (0–1) below which `isLowBattery` is `true`        |
+
+**Returns (`BatteryState`):**
+
+| Property       | Type      | Description                                          |
+| -------------- | --------- | ---------------------------------------------------- |
+| `charging`     | `boolean` | `true` when the device is plugged in                 |
+| `level`        | `number`  | Battery level between 0 and 1                        |
+| `isLowBattery` | `boolean` | `true` when not charging and below threshold         |
+| `isSupported`  | `boolean` | `true` when the Battery Status API is available      |
+
+---
+
+## Combining Hooks
+
+The real power comes from composing hooks together:
+
+```tsx
+import {
+  useNetworkAwarePolling,
+  useBatteryAware,
+  useInactivityTimeout,
+} from 'react-visibility-hooks';
+
+function SmartDashboard() {
+  const { isLowBattery } = useBatteryAware();
+  const { isTimedOut } = useInactivityTimeout({ timeout: 300_000 });
+
+  const { data } = useNetworkAwarePolling(
+    () => fetch('/api/metrics').then((r) => r.json()),
+    {
+      interval: isLowBattery ? 30_000 : 5_000,
+      enabled: !isTimedOut,
+    },
+  );
+
+  return <pre>{JSON.stringify(data, null, 2)}</pre>;
+}
+```
 
 ## SSR Support
 
-All hooks are SSR-safe and will work correctly with:
+All hooks are SSR-safe and work correctly with:
 
-- Next.js (App Router & Pages Router)
-- Remix
-- Gatsby
+- **Next.js** (App Router & Pages Router)
+- **Remix**
+- **Gatsby**
 - Any other React SSR framework
 
-The hooks check for `document` availability and gracefully handle server-side rendering.
+The hooks check for `document`/`window`/`navigator` availability and return sensible defaults on the server (e.g., `visible = true`, `online = true`, `charging = true`).
 
 ## TypeScript
 
-This package is written in TypeScript and includes type definitions out of the box. All hooks are fully typed for the best developer experience.
+Written in TypeScript with full type definitions. All interfaces are exported:
+
+```tsx
+import type {
+  IdleVisibilityResult,
+  SmartPollingOptions,
+  SmartPollingResult,
+  PageFocusEffectOptions,
+  NetworkAwarePollingOptions,
+  NetworkAwarePollingResult,
+  InactivityTimeoutOptions,
+  InactivityTimeoutResult,
+  WakeLockResult,
+  BatteryState,
+} from 'react-visibility-hooks';
+```
 
 ## Browser Support
 
-Works in all modern browsers that support:
+| Feature                | API                     | Support                                                                 |
+| ---------------------- | ----------------------- | ----------------------------------------------------------------------- |
+| Visibility detection   | Page Visibility API     | [All modern browsers](https://caniuse.com/pagevisibility)               |
+| Network detection      | `navigator.onLine`      | [All modern browsers](https://caniuse.com/online-status)                |
+| Connection quality     | Network Information API | [Chrome, Edge, Opera](https://caniuse.com/netinfo)                      |
+| Wake Lock              | Screen Wake Lock API    | [Chrome, Edge, Opera](https://caniuse.com/wake-lock)                    |
+| Battery status         | Battery Status API      | [Chrome, Edge, Opera](https://caniuse.com/battery-status)               |
 
-- [Page Visibility API](https://caniuse.com/pagevisibility)
-- React >=16.8.0 (hooks)
+> All hooks degrade gracefully — `isSupported` flags let you build progressive UIs.
 
 ## Examples
 
@@ -193,38 +459,61 @@ function ExpensiveComponent() {
   const isVisible = useDocVisible();
 
   useEffect(() => {
-    if (!isVisible) return; // Skip when hidden
+    if (!isVisible) return;
 
     const interval = setInterval(() => {
-      // Expensive operation
       performCalculation();
     }, 1000);
 
     return () => clearInterval(interval);
   }, [isVisible]);
 
-  return <div>...</div>;
+  return <div>…</div>;
 }
 ```
 
-### Show idle warning
+### Session timeout with warning modal
 
 ```tsx
-import { useIdleVisibility } from 'react-visibility-hooks';
-
-function IdleWarning() {
-  const { idle } = useIdleVisibility(300000); // 5 minutes
+import { useInactivityTimeout } from 'react-visibility-hooks';
 
-  if (!idle) return null;
+function App() {
+  const { isWarning, remainingSeconds, resetTimer, isTimedOut } =
+    useInactivityTimeout({
+      timeout: 600_000,
+      warningBefore: 120_000,
+      onTimeout: () => window.location.href = '/login',
+    });
 
   return (
-    <div className="warning">
-      Are you still there? Your session will expire soon.
-    </div>
+    <>
+      <MainContent />
+      {isWarning && (
+        <Modal>
+          <p>Session expires in {remainingSeconds}s</p>
+          <button onClick={resetTimer}>I'm still here</button>
+        </Modal>
+      )}
+    </>
   );
 }
 ```
 
+### Battery-aware polling
+
+```tsx
+import { useSmartPolling, useBatteryAware } from 'react-visibility-hooks';
+
+function Feed() {
+  const { isLowBattery } = useBatteryAware();
+  const { data } = useSmartPolling(fetchFeed, {
+    interval: isLowBattery ? 30_000 : 5_000,
+  });
+
+  return <FeedList items={data} />;
+}
+```
+
 ## Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a Pull Request.

package/dist/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var react=require('react');function u(){let[r,e]=react.useState(()=>typeof document=="undefined"?true:document.visibilityState==="visible"),t=react.useCallback(()=>{e(document.visibilityState==="visible");},[]);return react.useEffect(()=>{if(typeof document!="undefined")return t(),document.addEventListener("visibilitychange",t),()=>document.removeEventListener("visibilitychange",t)},[t]),r}function O(r=6e4){let e=u(),[t,n]=react.useState(false),s=react.useRef(void 0),o=react.useCallback(()=>{n(false),clearTimeout(s.current),s.current=setTimeout(()=>n(true),r);},[r]);return react.useEffect(()=>{if(typeof window=="undefined")return;let m=["mousemove","keydown","pointerdown","scroll","touchstart"];return m.forEach(f=>window.addEventListener(f,o,{passive:true})),o(),()=>{m.forEach(f=>window.removeEventListener(f,o)),clearTimeout(s.current);}},[o]),react.useEffect(()=>{e&&o();},[e,o]),{visible:e,idle:t}}function j(r){let e=u(),t=react.useRef(false);react.useEffect(()=>{let n=r.current;n&&(!e&&!n.paused?(n.pause(),t.current=true):e&&t.current&&(n.play().catch(()=>{}),t.current=false));},[e,r]);}function M(r,e){let{interval:t=5e3,enabled:n=true}=e!=null?e:{},s=u(),[o,m]=react.useState(void 0),[f,h]=react.useState(true),[y,R]=react.useState(void 0),E=react.useRef(r),a=react.useRef(void 0),b=react.useRef(false),g=react.useRef(void 0),d=react.useRef(true);E.current=r,react.useEffect(()=>(d.current=true,()=>{d.current=false;}),[]);let l=react.useCallback(async()=>{if(!b.current){b.current=true;try{let i=await E.current();if(!d.current)return;let V=JSON.stringify(i);V!==g.current&&(g.current=V,m(i)),R(x=>x!==void 0?void 0:x);}catch(i){if(!d.current)return;R(i instanceof Error?i:new Error(String(i)));}finally{b.current=false,d.current&&h(i=>i&&false);}}},[]),S=react.useRef(false);return react.useEffect(()=>{S.current||(S.current=true,l());},[l]),react.useEffect(()=>{if(!n||!s){clearInterval(a.current),a.current=void 0;return}return l(),a.current=setInterval(l,t),()=>{clearInterval(a.current),a.current=void 0;}},[s,n,t,l]),{data:o,isLoading:f,isError:y!==void 0,error:y,refetch:l}}exports.useAutoPauseVideo=j;exports.useDocVisible=u;exports.useIdleVisibility=O;exports.useSmartPolling=M;//# sourceMappingURL=index.cjs.map
+'use strict';var react=require('react');function m(){let[i,n]=react.useState(()=>typeof document=="undefined"?true:document.visibilityState==="visible"),t=react.useCallback(()=>{n(document.visibilityState==="visible");},[]);return react.useEffect(()=>{if(typeof document!="undefined")return t(),document.addEventListener("visibilitychange",t),()=>document.removeEventListener("visibilitychange",t)},[t]),i}function T(i=6e4){let n=m(),[t,r]=react.useState(false),e=react.useRef(void 0),o=react.useCallback(()=>{r(false),clearTimeout(e.current),e.current=setTimeout(()=>r(true),i);},[i]);return react.useEffect(()=>{if(typeof window=="undefined")return;let s=["mousemove","keydown","pointerdown","scroll","touchstart"];return s.forEach(u=>window.addEventListener(u,o,{passive:true})),o(),()=>{s.forEach(u=>window.removeEventListener(u,o)),clearTimeout(e.current);}},[o]),react.useEffect(()=>{n&&o();},[n,o]),{visible:n,idle:t}}function Q(i){let n=m(),t=react.useRef(false);react.useEffect(()=>{let r=i.current;r&&(!n&&!r.paused?(r.pause(),t.current=true):n&&t.current&&(r.play().catch(()=>{}),t.current=false));},[n,i]);}function I(i,n){let{interval:t=5e3,enabled:r=true}=n!=null?n:{},e=m(),[o,s]=react.useState(void 0),[u,l]=react.useState(true),[c,b]=react.useState(void 0),g=react.useRef(i),p=react.useRef(void 0),f=react.useRef(false),w=react.useRef(void 0),v=react.useRef(true);g.current=i,react.useEffect(()=>(v.current=true,()=>{v.current=false;}),[]);let d=react.useCallback(async()=>{if(!f.current){f.current=true;try{let a=await g.current();if(!v.current)return;let x=JSON.stringify(a);x!==w.current&&(w.current=x,s(a)),b(k=>k!==void 0?void 0:k);}catch(a){if(!v.current)return;b(a instanceof Error?a:new Error(String(a)));}finally{f.current=false,v.current&&l(a=>a&&false);}}},[]),y=react.useRef(false);return react.useEffect(()=>{y.current||(y.current=true,d());},[d]),react.useEffect(()=>{if(!r||!e){clearInterval(p.current),p.current=void 0;return}return d(),p.current=setInterval(d,t),()=>{clearInterval(p.current),p.current=void 0;}},[e,r,t,d]),{data:o,isLoading:u,isError:c!==void 0,error:c,refetch:d}}function Y(i){let n=m(),t=react.useRef(void 0),r=react.useRef(void 0),e=react.useRef(i.onVisible),o=react.useRef(i.onHidden);e.current=i.onVisible,o.current=i.onHidden,react.useEffect(()=>{var s,u,l;if(t.current===void 0){t.current=n;return}if(n&&!t.current){(s=r.current)==null||s.call(r),r.current=void 0;let c=(u=e.current)==null?void 0:u.call(e);typeof c=="function"&&(r.current=c);}else !n&&t.current&&((l=o.current)==null||l.call(o));t.current=n;},[n]),react.useEffect(()=>()=>{var s;(s=r.current)==null||s.call(r);},[]);}function ee(i,n){let{interval:t=5e3,enabled:r=true,slowMultiplier:e=3,pauseOffline:o=true,...s}=n!=null?n:{},u=te(),l=ne(t,e);return {...I(i,{...s,interval:l,enabled:o?r&&u:r}),isOnline:u,effectiveInterval:l}}function te(){let[i,n]=react.useState(()=>typeof navigator=="undefined"?true:navigator.onLine),t=react.useCallback(()=>n(true),[]),r=react.useCallback(()=>n(false),[]);return react.useEffect(()=>{if(typeof window!="undefined")return window.addEventListener("online",t),window.addEventListener("offline",r),()=>{window.removeEventListener("online",t),window.removeEventListener("offline",r);}},[t,r]),i}function ne(i,n){if(typeof navigator=="undefined")return i;let t=navigator.connection;return (t==null?void 0:t.effectiveType)==="2g"||(t==null?void 0:t.effectiveType)==="slow-2g"?i*n:i}function oe(i){let{timeout:n=3e5,warningBefore:t=6e4,onTimeout:r,onWarning:e}=i!=null?i:{},o=Math.min(t,n),s=n-o,{idle:u,visible:l}=T(s),[c,b]=react.useState(-1),[g,p]=react.useState(false),f=react.useRef(void 0),w=react.useRef(void 0),v=react.useRef(false),d=react.useRef(r),y=react.useRef(e);d.current=r,y.current=e;let a=react.useCallback(()=>{clearInterval(f.current),f.current=void 0,w.current=void 0,v.current=false,b(-1),p(false);},[]);react.useEffect(()=>{var L;if(!u||g){u||a();return}w.current=Date.now(),v.current||(v.current=true,(L=y.current)==null||L.call(y));let k=o;return f.current=setInterval(()=>{var B,V;let H=Date.now()-((B=w.current)!=null?B:Date.now()),O=Math.max(0,Math.ceil((k-H)/1e3));b(O),O<=0&&(clearInterval(f.current),f.current=void 0,p(true),(V=d.current)==null||V.call(d));},1e3),()=>{clearInterval(f.current),f.current=void 0;}},[u,g,o,a]);let x=u&&!g&&c>=0;return {idle:u||g,visible:l,isWarning:x,isTimedOut:g,remainingSeconds:c,resetTimer:a}}function se(i=true){let n=m(),[t,r]=react.useState(false),e=react.useRef(void 0),o=react.useRef(false),s=typeof navigator!="undefined"&&navigator.wakeLock!=null,u=react.useCallback(async()=>{if(s&&!(e.current&&!e.current.released))try{let c=await navigator.wakeLock.request("screen");e.current=c,o.current=!0,r(!0),c.addEventListener("release",()=>{r(!1),e.current=void 0;});}catch{}},[s]),l=react.useCallback(async()=>{o.current=false,e.current&&!e.current.released&&await e.current.release();},[]);return react.useEffect(()=>{i&&n&&o.current&&!e.current&&u();},[n,i,u]),react.useEffect(()=>()=>{e.current&&!e.current.released&&e.current.release().catch(()=>{});},[]),{isActive:t,request:u,release:l,isSupported:s}}function fe(i=.15){let[n,t]=react.useState({charging:true,level:1,isLowBattery:false,isSupported:false}),r=react.useCallback(e=>{t({charging:e.charging,level:e.level,isLowBattery:!e.charging&&e.level<i,isSupported:true});},[i]);return react.useEffect(()=>{if(typeof navigator=="undefined"||typeof navigator.getBattery!="function")return;let e,o=false,s=()=>{e&&!o&&r(e);};return navigator.getBattery().then(u=>{o||(e=u,r(u),u.addEventListener("chargingchange",s),u.addEventListener("levelchange",s));}).catch(()=>{}),()=>{o=true,e&&(e.removeEventListener("chargingchange",s),e.removeEventListener("levelchange",s));}},[r]),n}exports.useAutoPauseVideo=Q;exports.useBatteryAware=fe;exports.useDocVisible=m;exports.useIdleVisibility=T;exports.useInactivityTimeout=oe;exports.useNetworkAwarePolling=ee;exports.usePageFocusEffect=Y;exports.useSmartPolling=I;exports.useWakeLock=se;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts"],"names":["useDocVisible","visible","setVisible","useState","handler","useCallback","useEffect","useIdleVisibility","timeout","idle","setIdle","timerRef","useRef","reset","events","e","useAutoPauseVideo","ref","wasPausedByUs","video","useSmartPolling","fetchFn","options","interval","enabled","data","setData","isLoading","setIsLoading","error","setError","fetchRef","isFetchingRef","lastJsonRef","mountedRef","execute","result","json","prev","err","hasFetchedRef"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * Returns `true` when the page is visible, `false` when hidden.\n * SSR-safe — defaults to `true` on the server.\n */\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(() =>\n    typeof document === \"undefined\" ? true : document.visibilityState === \"visible\",\n  );\n\n  const handler = useCallback(() => {\n    setVisible(document.visibilityState === \"visible\");\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n\n    // Sync in case value changed between SSR hydration and effect\n    handler();\n\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, [handler]);\n\n  return visible;\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface IdleVisibilityResult {\n  /** Whether the page is visible */\n  visible: boolean;\n  /** Whether the user is idle (no interaction for `timeout` ms) */\n  idle: boolean;\n}\n\n/**\n * Combines page-visibility with idle detection.\n *\n * @param timeout - Milliseconds of inactivity before the user is\n *                  considered idle (default `60_000`).\n */\nexport function useIdleVisibility(timeout = 60_000): IdleVisibilityResult {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  const reset = useCallback(() => {\n    setIdle(false);\n    clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => setIdle(true), timeout);\n  }, [timeout]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const events: Array<keyof WindowEventMap> = [\n      \"mousemove\",\n      \"keydown\",\n      \"pointerdown\",\n      \"scroll\",\n      \"touchstart\",\n    ];\n\n    events.forEach((e) => window.addEventListener(e, reset, { passive: true }));\n    reset();\n\n    return () => {\n      events.forEach((e) => window.removeEventListener(e, reset));\n      clearTimeout(timerRef.current);\n    };\n  }, [reset]);\n\n  // Reset idle timer when tab becomes visible again\n  useEffect(() => {\n    if (visible) reset();\n  }, [visible, reset]);\n\n  return { visible, idle };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\n/**\n * Automatically pauses a `<video>` when the page becomes hidden\n * and resumes playback when the page becomes visible again.\n *\n * Only resumes if the video was playing before it was paused by this hook.\n */\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void {\n  const visible = useDocVisible();\n  const wasPausedByUs = useRef(false);\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible && !video.paused) {\n      video.pause();\n      wasPausedByUs.current = true;\n    } else if (visible && wasPausedByUs.current) {\n      video.play().catch(() => {\n        /* autoplay may be blocked */\n      });\n      wasPausedByUs.current = false;\n    }\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface SmartPollingOptions {\n  /** Polling interval in ms (default `5000`) */\n  interval?: number;\n  /** Enable / disable polling (default `true`). The initial fetch always fires. */\n  enabled?: boolean;\n}\n\nexport interface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  /** Manually trigger a fetch */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Visibility-aware polling hook.\n *\n * - Pauses when the tab is hidden.\n * - Skips re-renders when data hasn't changed (shallow JSON comparison).\n * - Prevents overlapping fetches.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useSmartPolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n  const mountedRef = useRef(true);\n\n  // Always keep the latest fetchFn\n  fetchRef.current = fetchFn;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(async () => {\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n      if (!mountedRef.current) return;\n\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      if (!mountedRef.current) return;\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      if (mountedRef.current) {\n        setIsLoading((prev) => (prev ? false : prev));\n      }\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible AND enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n      return;\n    }\n\n    // Immediately fetch when re-enabled / tab returns\n    execute();\n\n    timerRef.current = setInterval(execute, interval);\n    return () => {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n    };\n  }, [visible, enabled, interval, execute]);\n\n  return {\n    data,\n    isLoading,\n    isError: error !== undefined,\n    error,\n    refetch: execute,\n  };\n}\n"]}
+{"version":3,"sources":["../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts","../src/usePageFocusEffect.ts","../src/useNetworkAwarePolling.ts","../src/useInactivityTimeout.ts","../src/useWakeLock.ts","../src/useBatteryAware.ts"],"names":["useDocVisible","visible","setVisible","useState","handler","useCallback","useEffect","useIdleVisibility","timeout","idle","setIdle","timerRef","useRef","reset","events","e","useAutoPauseVideo","ref","wasPausedByUs","video","useSmartPolling","fetchFn","options","interval","enabled","data","setData","isLoading","setIsLoading","error","setError","fetchRef","isFetchingRef","lastJsonRef","mountedRef","execute","result","json","prev","err","hasFetchedRef","usePageFocusEffect","prevRef","cleanupRef","onVisibleRef","onHiddenRef","_a","_b","_c","useNetworkAwarePolling","slowMultiplier","pauseOffline","rest","online","useOnline","effectiveInterval","getEffectiveInterval","setOnline","handleOnline","handleOffline","base","multiplier","conn","useInactivityTimeout","warningBefore","onTimeout","onWarning","clampedWarning","idleThreshold","remaining","setRemaining","timedOut","setTimedOut","intervalRef","startRef","warnedRef","onTimeoutRef","onWarningRef","clear","warningMs","elapsed","left","isWarning","useWakeLock","autoReacquire","isActive","setIsActive","sentinelRef","wantedRef","isSupported","request","sentinel","release","useBatteryAware","lowThreshold","state","setState","update","battery","cancelled","onChange","b"],"mappings":"wCAMO,SAASA,CAAAA,EAAyB,CACvC,GAAM,CAACC,CAAAA,CAASC,CAAU,CAAA,CAAIC,cAAAA,CAAS,IACrC,OAAO,QAAA,EAAa,WAAA,CAAc,IAAA,CAAO,SAAS,eAAA,GAAoB,SACxE,CAAA,CAEMC,CAAAA,CAAUC,kBAAY,IAAM,CAChCH,CAAAA,CAAW,QAAA,CAAS,kBAAoB,SAAS,EACnD,EAAG,EAAE,EAEL,OAAAI,eAAAA,CAAU,IAAM,CACd,GAAI,OAAO,QAAA,EAAa,WAAA,CAGxB,OAAAF,GAAQ,CAER,QAAA,CAAS,gBAAA,CAAiB,kBAAA,CAAoBA,CAAO,CAAA,CAC9C,IAAM,SAAS,mBAAA,CAAoB,kBAAA,CAAoBA,CAAO,CACvE,CAAA,CAAG,CAACA,CAAO,CAAC,CAAA,CAELH,CACT,CCVO,SAASM,CAAAA,CAAkBC,CAAAA,CAAU,IAA8B,CACxE,IAAMP,CAAAA,CAAUD,CAAAA,GACV,CAACS,CAAAA,CAAMC,CAAO,CAAA,CAAIP,eAAS,KAAK,CAAA,CAChCQ,CAAAA,CAAWC,YAAAA,CAAkD,MAAS,CAAA,CAEtEC,CAAAA,CAAQR,kBAAY,IAAM,CAC9BK,EAAQ,KAAK,CAAA,CACb,YAAA,CAAaC,CAAAA,CAAS,OAAO,CAAA,CAC7BA,CAAAA,CAAS,OAAA,CAAU,UAAA,CAAW,IAAMD,CAAAA,CAAQ,IAAI,CAAA,CAAGF,CAAO,EAC5D,CAAA,CAAG,CAACA,CAAO,CAAC,CAAA,CAEZ,OAAAF,eAAAA,CAAU,IAAM,CACd,GAAI,OAAO,MAAA,EAAW,WAAA,CAAa,OAEnC,IAAMQ,EAAsC,CAC1C,WAAA,CACA,SAAA,CACA,aAAA,CACA,SACA,YACF,CAAA,CAEA,OAAAA,CAAAA,CAAO,OAAA,CAASC,GAAM,MAAA,CAAO,gBAAA,CAAiBA,CAAAA,CAAGF,CAAAA,CAAO,CAAE,OAAA,CAAS,IAAK,CAAC,CAAC,CAAA,CAC1EA,GAAM,CAEC,IAAM,CACXC,CAAAA,CAAO,QAASC,CAAAA,EAAM,MAAA,CAAO,oBAAoBA,CAAAA,CAAGF,CAAK,CAAC,CAAA,CAC1D,YAAA,CAAaF,CAAAA,CAAS,OAAO,EAC/B,CACF,CAAA,CAAG,CAACE,CAAK,CAAC,CAAA,CAGVP,eAAAA,CAAU,IAAM,CACVL,GAASY,CAAAA,GACf,EAAG,CAACZ,CAAAA,CAASY,CAAK,CAAC,CAAA,CAEZ,CAAE,OAAA,CAAAZ,EAAS,IAAA,CAAAQ,CAAK,CACzB,CC5CO,SAASO,CAAAA,CAAkBC,EAAqD,CACrF,IAAMhB,EAAUD,CAAAA,EAAc,CACxBkB,CAAAA,CAAgBN,YAAAA,CAAO,KAAK,CAAA,CAElCN,eAAAA,CAAU,IAAM,CACd,IAAMa,CAAAA,CAAQF,CAAAA,CAAI,OAAA,CACbE,CAAAA,GAED,CAAClB,CAAAA,EAAW,CAACkB,EAAM,MAAA,EACrBA,CAAAA,CAAM,OAAM,CACZD,CAAAA,CAAc,OAAA,CAAU,IAAA,EACfjB,GAAWiB,CAAAA,CAAc,OAAA,GAClCC,EAAM,IAAA,EAAK,CAAE,MAAM,IAAM,CAEzB,CAAC,CAAA,CACDD,EAAc,OAAA,CAAU,KAAA,CAAA,EAE5B,EAAG,CAACjB,CAAAA,CAASgB,CAAG,CAAC,EACnB,CCEO,SAASG,EACdC,CAAAA,CACAC,CAAAA,CACuB,CACvB,GAAM,CAAE,SAAAC,CAAAA,CAAW,GAAA,CAAM,OAAA,CAAAC,CAAAA,CAAU,IAAK,CAAA,CAAIF,CAAAA,EAAA,KAAAA,CAAAA,CAAW,GACjDrB,CAAAA,CAAUD,CAAAA,EAAc,CAExB,CAACyB,EAAMC,CAAO,CAAA,CAAIvB,eAAwB,MAAS,CAAA,CACnD,CAACwB,CAAAA,CAAWC,CAAY,CAAA,CAAIzB,cAAAA,CAAS,IAAI,CAAA,CACzC,CAAC0B,CAAAA,CAAOC,CAAQ,EAAI3B,cAAAA,CAA4B,MAAS,CAAA,CAEzD4B,CAAAA,CAAWnB,aAAOS,CAAO,CAAA,CACzBV,EAAWC,YAAAA,CAAmD,MAAS,EACvEoB,CAAAA,CAAgBpB,YAAAA,CAAO,KAAK,CAAA,CAC5BqB,EAAcrB,YAAAA,CAA2B,MAAS,EAClDsB,CAAAA,CAAatB,YAAAA,CAAO,IAAI,CAAA,CAG9BmB,CAAAA,CAAS,OAAA,CAAUV,CAAAA,CAEnBf,gBAAU,KACR4B,CAAAA,CAAW,QAAU,IAAA,CACd,IAAM,CACXA,CAAAA,CAAW,OAAA,CAAU,MACvB,CAAA,CAAA,CACC,EAAE,CAAA,CAEL,IAAMC,CAAAA,CAAU9B,kBAAY,SAAY,CACtC,GAAI,CAAA2B,EAAc,OAAA,CAClB,CAAAA,EAAc,OAAA,CAAU,IAAA,CAExB,GAAI,CACF,IAAMI,CAAAA,CAAS,MAAML,EAAS,OAAA,EAAQ,CACtC,GAAI,CAACG,EAAW,OAAA,CAAS,OAEzB,IAAMG,CAAAA,CAAO,KAAK,SAAA,CAAUD,CAAM,EAC9BC,CAAAA,GAASJ,CAAAA,CAAY,UACvBA,CAAAA,CAAY,OAAA,CAAUI,CAAAA,CACtBX,CAAAA,CAAQU,CAAM,CAAA,CAAA,CAEhBN,CAAAA,CAAUQ,CAAAA,EAAUA,CAAAA,GAAS,OAAY,KAAA,CAAA,CAAYA,CAAK,EAC5D,CAAA,MAASC,EAAK,CACZ,GAAI,CAACL,CAAAA,CAAW,OAAA,CAAS,OACzBJ,CAAAA,CAASS,CAAAA,YAAe,KAAA,CAAQA,CAAAA,CAAM,IAAI,KAAA,CAAM,MAAA,CAAOA,CAAG,CAAC,CAAC,EAC9D,CAAA,OAAE,CACAP,CAAAA,CAAc,OAAA,CAAU,MACpBE,CAAAA,CAAW,OAAA,EACbN,EAAcU,CAAAA,EAAUA,CAAAA,EAAO,KAAa,EAEhD,CAAA,CACF,CAAA,CAAG,EAAE,CAAA,CAGCE,CAAAA,CAAgB5B,YAAAA,CAAO,KAAK,EAClC,OAAAN,eAAAA,CAAU,IAAM,CACVkC,EAAc,OAAA,GAClBA,CAAAA,CAAc,QAAU,IAAA,CACxBL,CAAAA,IACF,CAAA,CAAG,CAACA,CAAO,CAAC,EAGZ7B,eAAAA,CAAU,IAAM,CACd,GAAI,CAACkB,GAAW,CAACvB,CAAAA,CAAS,CACxB,aAAA,CAAcU,EAAS,OAAO,CAAA,CAC9BA,EAAS,OAAA,CAAU,MAAA,CACnB,MACF,CAGA,OAAAwB,CAAAA,EAAQ,CAERxB,EAAS,OAAA,CAAU,WAAA,CAAYwB,CAAAA,CAASZ,CAAQ,EACzC,IAAM,CACX,aAAA,CAAcZ,CAAAA,CAAS,OAAO,CAAA,CAC9BA,CAAAA,CAAS,QAAU,OACrB,CACF,EAAG,CAACV,CAAAA,CAASuB,CAAAA,CAASD,CAAAA,CAAUY,CAAO,CAAC,CAAA,CAEjC,CACL,IAAA,CAAAV,CAAAA,CACA,UAAAE,CAAAA,CACA,OAAA,CAASE,CAAAA,GAAU,MAAA,CACnB,MAAAA,CAAAA,CACA,OAAA,CAASM,CACX,CACF,CCrFO,SAASM,CAAAA,CAAmBnB,CAAAA,CAAuC,CACxE,IAAMrB,CAAAA,CAAUD,CAAAA,EAAc,CACxB0C,CAAAA,CAAU9B,aAA4B,MAAS,CAAA,CAC/C+B,EAAa/B,YAAAA,CAAiC,MAAS,EAGvDgC,CAAAA,CAAehC,YAAAA,CAAOU,CAAAA,CAAQ,SAAS,EACvCuB,CAAAA,CAAcjC,YAAAA,CAAOU,CAAAA,CAAQ,QAAQ,EAC3CsB,CAAAA,CAAa,OAAA,CAAUtB,CAAAA,CAAQ,SAAA,CAC/BuB,EAAY,OAAA,CAAUvB,CAAAA,CAAQ,SAE9BhB,eAAAA,CAAU,IAAM,CAxClB,IAAAwC,CAAAA,CAAAC,CAAAA,CAAAC,CAAAA,CA0CI,GAAIN,CAAAA,CAAQ,OAAA,GAAY,MAAA,CAAW,CACjCA,EAAQ,OAAA,CAAUzC,CAAAA,CAClB,MACF,CAEA,GAAIA,CAAAA,EAAW,CAACyC,EAAQ,OAAA,CAAS,CAAA,CAE/BI,EAAAH,CAAAA,CAAW,OAAA,GAAX,IAAA,EAAAG,CAAAA,CAAA,KAAAH,CAAAA,CAAAA,CACAA,CAAAA,CAAW,QAAU,MAAA,CACrB,IAAMP,GAASW,CAAAA,CAAAH,CAAAA,CAAa,OAAA,GAAb,IAAA,CAAA,MAAA,CAAAG,EAAA,IAAA,CAAAH,CAAAA,CAAAA,CACX,OAAOR,CAAAA,EAAW,UAAA,GACpBO,EAAW,OAAA,CAAUP,CAAAA,EAEzB,CAAA,KAAW,CAACnC,GAAWyC,CAAAA,CAAQ,OAAA,GAAA,CAE7BM,CAAAA,CAAAH,CAAAA,CAAY,UAAZ,IAAA,EAAAG,CAAAA,CAAA,IAAA,CAAAH,CAAAA,CAAAA,CAAAA,CAGFH,EAAQ,OAAA,CAAUzC,EACpB,EAAG,CAACA,CAAO,CAAC,CAAA,CAGZK,eAAAA,CAAU,IACD,IAAM,CAjEjB,IAAAwC,CAAAA,CAAAA,CAkEMA,EAAAH,CAAAA,CAAW,OAAA,GAAX,MAAAG,CAAAA,CAAA,IAAA,CAAAH,CAAAA,EACF,CAAA,CACC,EAAE,EACP,CCvCO,SAASM,EAAAA,CACd5B,CAAAA,CACAC,CAAAA,CAC8B,CAC9B,GAAM,CACJ,QAAA,CAAAC,CAAAA,CAAW,IACX,OAAA,CAAAC,CAAAA,CAAU,KACV,cAAA,CAAA0B,CAAAA,CAAiB,EACjB,YAAA,CAAAC,CAAAA,CAAe,IAAA,CACf,GAAGC,CACL,CAAA,CAAI9B,CAAAA,EAAA,KAAAA,CAAAA,CAAW,GAET+B,CAAAA,CAASC,EAAAA,EAAU,CACnBC,CAAAA,CAAoBC,GAAqBjC,CAAAA,CAAU2B,CAAc,EAUvE,OAAO,CAAE,GANM9B,CAAAA,CAAgBC,CAAAA,CAAS,CACtC,GAAG+B,EACH,QAAA,CAAUG,CAAAA,CACV,OAAA,CALiBJ,CAAAA,CAAe3B,GAAW6B,CAAAA,CAAS7B,CAMtD,CAAC,CAAA,CAEmB,SAAU6B,CAAAA,CAAQ,iBAAA,CAAAE,CAAkB,CAC1D,CAOA,SAASD,EAAAA,EAAqB,CAC5B,GAAM,CAACD,EAAQI,CAAS,CAAA,CAAItD,cAAAA,CAAS,IACnC,OAAO,SAAA,EAAc,WAAA,CAAc,IAAA,CAAO,SAAA,CAAU,MACtD,CAAA,CAEMuD,CAAAA,CAAerD,kBAAY,IAAMoD,CAAAA,CAAU,IAAI,CAAA,CAAG,EAAE,CAAA,CACpDE,EAAgBtD,iBAAAA,CAAY,IAAMoD,CAAAA,CAAU,KAAK,EAAG,EAAE,CAAA,CAE5D,OAAAnD,gBAAU,IAAM,CACd,GAAI,OAAO,MAAA,EAAW,YAEtB,OAAA,MAAA,CAAO,gBAAA,CAAiB,QAAA,CAAUoD,CAAY,EAC9C,MAAA,CAAO,gBAAA,CAAiB,UAAWC,CAAa,CAAA,CACzC,IAAM,CACX,MAAA,CAAO,mBAAA,CAAoB,QAAA,CAAUD,CAAY,CAAA,CACjD,MAAA,CAAO,oBAAoB,SAAA,CAAWC,CAAa,EACrD,CACF,CAAA,CAAG,CAACD,CAAAA,CAAcC,CAAa,CAAC,CAAA,CAEzBN,CACT,CAGA,SAASG,EAAAA,CAAqBI,CAAAA,CAAcC,CAAAA,CAA4B,CACtE,GAAI,OAAO,SAAA,EAAc,YAAa,OAAOD,CAAAA,CAE7C,IAAME,CAAAA,CACJ,SAAA,CAGA,UAAA,CAEF,OAAA,CAAIA,GAAA,IAAA,CAAA,MAAA,CAAAA,CAAAA,CAAM,aAAA,IAAkB,IAAA,EAAA,CAAQA,GAAA,IAAA,CAAA,MAAA,CAAAA,CAAAA,CAAM,aAAA,IAAkB,SAAA,CACnDF,EAAOC,CAAAA,CAETD,CACT,CCnDO,SAASG,EAAAA,CACdzC,EACyB,CACzB,GAAM,CACJ,OAAA,CAAAd,EAAU,GAAA,CACV,aAAA,CAAAwD,EAAgB,GAAA,CAChB,SAAA,CAAAC,EACA,SAAA,CAAAC,CACF,CAAA,CAAI5C,CAAAA,EAAA,KAAAA,CAAAA,CAAW,GAGT6C,CAAAA,CAAiB,IAAA,CAAK,IAAIH,CAAAA,CAAexD,CAAO,CAAA,CAChD4D,CAAAA,CAAgB5D,EAAU2D,CAAAA,CAE1B,CAAE,KAAA1D,CAAAA,CAAM,OAAA,CAAAR,CAAQ,CAAA,CAAIM,CAAAA,CAAkB6D,CAAa,CAAA,CAEnD,CAACC,CAAAA,CAAWC,CAAY,CAAA,CAAInE,cAAAA,CAAS,EAAE,CAAA,CACvC,CAACoE,CAAAA,CAAUC,CAAW,EAAIrE,cAAAA,CAAS,KAAK,EACxCsE,CAAAA,CAAc7D,YAAAA,CAAmD,MAAS,CAAA,CAC1E8D,CAAAA,CAAW9D,YAAAA,CAA2B,MAAS,EAC/C+D,CAAAA,CAAY/D,YAAAA,CAAO,KAAK,CAAA,CAGxBgE,EAAehE,YAAAA,CAAOqD,CAAS,CAAA,CAC/BY,CAAAA,CAAejE,aAAOsD,CAAS,CAAA,CACrCU,EAAa,OAAA,CAAUX,CAAAA,CACvBY,EAAa,OAAA,CAAUX,CAAAA,CAEvB,IAAMY,CAAAA,CAAQzE,kBAAY,IAAM,CAC9B,aAAA,CAAcoE,CAAAA,CAAY,OAAO,CAAA,CACjCA,CAAAA,CAAY,OAAA,CAAU,MAAA,CACtBC,EAAS,OAAA,CAAU,MAAA,CACnBC,EAAU,OAAA,CAAU,KAAA,CACpBL,EAAa,EAAE,CAAA,CACfE,CAAAA,CAAY,KAAK,EACnB,CAAA,CAAG,EAAE,CAAA,CAELlE,eAAAA,CAAU,IAAM,CAnFlB,IAAAwC,CAAAA,CAoFI,GAAI,CAACrC,CAAAA,EAAQ8D,CAAAA,CAAU,CAChB9D,CAAAA,EAAMqE,CAAAA,GACX,MACF,CAEAJ,CAAAA,CAAS,OAAA,CAAU,KAAK,GAAA,EAAI,CAGvBC,CAAAA,CAAU,OAAA,GACbA,EAAU,OAAA,CAAU,IAAA,CAAA,CACpB7B,CAAAA,CAAA+B,CAAAA,CAAa,UAAb,IAAA,EAAA/B,CAAAA,CAAA,KAAA+B,CAAAA,CAAAA,CAAAA,CAGF,IAAME,EAAYZ,CAAAA,CAElB,OAAAM,CAAAA,CAAY,OAAA,CAAU,YAAY,IAAM,CAnG5C,IAAA3B,CAAAA,CAAAC,CAAAA,CAoGM,IAAMiC,CAAAA,CAAU,IAAA,CAAK,GAAA,EAAI,EAAA,CAAKlC,EAAA4B,CAAAA,CAAS,OAAA,GAAT,KAAA5B,CAAAA,CAAoB,IAAA,CAAK,KAAI,CAAA,CACrDmC,CAAAA,CAAO,IAAA,CAAK,GAAA,CAAI,EAAG,IAAA,CAAK,IAAA,CAAA,CAAMF,CAAAA,CAAYC,CAAAA,EAAW,GAAI,CAAC,CAAA,CAChEV,CAAAA,CAAaW,CAAI,EAEbA,CAAAA,EAAQ,CAAA,GACV,cAAcR,CAAAA,CAAY,OAAO,EACjCA,CAAAA,CAAY,OAAA,CAAU,MAAA,CACtBD,CAAAA,CAAY,IAAI,CAAA,CAAA,CAChBzB,CAAAA,CAAA6B,EAAa,OAAA,GAAb,IAAA,EAAA7B,EAAA,IAAA,CAAA6B,CAAAA,CAAAA,EAEJ,CAAA,CAAG,GAAI,EAEA,IAAM,CACX,cAAcH,CAAAA,CAAY,OAAO,EACjCA,CAAAA,CAAY,OAAA,CAAU,OACxB,CACF,EAAG,CAAChE,CAAAA,CAAM8D,CAAAA,CAAUJ,CAAAA,CAAgBW,CAAK,CAAC,CAAA,CAE1C,IAAMI,CAAAA,CAAYzE,GAAQ,CAAC8D,CAAAA,EAAYF,GAAa,CAAA,CAEpD,OAAO,CACL,IAAA,CAAM5D,CAAAA,EAAQ8D,CAAAA,CACd,OAAA,CAAAtE,EACA,SAAA,CAAAiF,CAAAA,CACA,UAAA,CAAYX,CAAAA,CACZ,iBAAkBF,CAAAA,CAClB,UAAA,CAAYS,CACd,CACF,CCtGO,SAASK,EAAAA,CAAYC,CAAAA,CAAgB,IAAA,CAAsB,CAChE,IAAMnF,CAAAA,CAAUD,CAAAA,EAAc,CACxB,CAACqF,EAAUC,CAAW,CAAA,CAAInF,eAAS,KAAK,CAAA,CACxCoF,EAAc3E,YAAAA,CAAqC,MAAS,CAAA,CAC5D4E,CAAAA,CAAY5E,aAAO,KAAK,CAAA,CAExB6E,EAAc,OAAO,SAAA,EAAc,aAAe,SAAA,CAAU,QAAA,EAAY,IAAA,CAExEC,CAAAA,CAAUrF,kBAAY,SAAY,CACtC,GAAKoF,CAAAA,EAED,EAAAF,EAAY,OAAA,EAAW,CAACA,CAAAA,CAAY,OAAA,CAAQ,UAEhD,GAAI,CACF,IAAMI,CAAAA,CAAW,MAAM,SAAA,CAAU,QAAA,CAAS,OAAA,CAAQ,QAAQ,EAC1DJ,CAAAA,CAAY,OAAA,CAAUI,EACtBH,CAAAA,CAAU,OAAA,CAAU,GACpBF,CAAAA,CAAY,CAAA,CAAI,CAAA,CAEhBK,CAAAA,CAAS,iBAAiB,SAAA,CAAW,IAAM,CACzCL,CAAAA,CAAY,CAAA,CAAK,EACjBC,CAAAA,CAAY,OAAA,CAAU,KAAA,EACxB,CAAC,EACH,CAAA,KAAQ,CAER,CACF,CAAA,CAAG,CAACE,CAAW,CAAC,CAAA,CAEVG,CAAAA,CAAUvF,iBAAAA,CAAY,SAAY,CACtCmF,CAAAA,CAAU,OAAA,CAAU,KAAA,CAChBD,EAAY,OAAA,EAAW,CAACA,CAAAA,CAAY,OAAA,CAAQ,UAC9C,MAAMA,CAAAA,CAAY,QAAQ,OAAA,GAE9B,EAAG,EAAE,CAAA,CAGL,OAAAjF,gBAAU,IAAM,CACV8E,GAAiBnF,CAAAA,EAAWuF,CAAAA,CAAU,SAAW,CAACD,CAAAA,CAAY,OAAA,EAC3DG,CAAAA,GAET,CAAA,CAAG,CAACzF,EAASmF,CAAAA,CAAeM,CAAO,CAAC,CAAA,CAGpCpF,eAAAA,CAAU,IACD,IAAM,CACPiF,CAAAA,CAAY,OAAA,EAAW,CAACA,CAAAA,CAAY,QAAQ,QAAA,EAC9CA,CAAAA,CAAY,OAAA,CAAQ,OAAA,GAAU,KAAA,CAAM,IAAM,CAAC,CAAC,EAEhD,EACC,EAAE,CAAA,CAEE,CAAE,SAAAF,CAAAA,CAAU,OAAA,CAAAK,CAAAA,CAAS,OAAA,CAAAE,EAAS,WAAA,CAAAH,CAAY,CACnD,CC9CO,SAASI,EAAAA,CAAgBC,CAAAA,CAAe,IAAoB,CACjE,GAAM,CAACC,CAAAA,CAAOC,CAAQ,CAAA,CAAI7F,cAAAA,CAAuB,CAC/C,QAAA,CAAU,KACV,KAAA,CAAO,CAAA,CACP,aAAc,KAAA,CACd,WAAA,CAAa,KACf,CAAC,CAAA,CAEK8F,CAAAA,CAAS5F,iBAAAA,CACZ6F,GAA4B,CAC3BF,CAAAA,CAAS,CACP,QAAA,CAAUE,CAAAA,CAAQ,SAClB,KAAA,CAAOA,CAAAA,CAAQ,KAAA,CACf,YAAA,CAAc,CAACA,CAAAA,CAAQ,QAAA,EAAYA,EAAQ,KAAA,CAAQJ,CAAAA,CACnD,YAAa,IACf,CAAC,EACH,CAAA,CACA,CAACA,CAAY,CACf,CAAA,CAEA,OAAAxF,gBAAU,IAAM,CACd,GACE,OAAO,WAAc,WAAA,EACrB,OAAQ,UAAmD,UAAA,EAAe,UAAA,CAE1E,OAGF,IAAI4F,CAAAA,CACAC,CAAAA,CAAY,KAAA,CAEVC,EAAW,IAAM,CACjBF,GAAW,CAACC,CAAAA,EAAWF,EAAOC,CAAO,EAC3C,CAAA,CAEA,OAAC,UACE,UAAA,EAAW,CACX,KAAMG,CAAAA,EAAM,CACPF,IACJD,CAAAA,CAAUG,CAAAA,CACVJ,CAAAA,CAAOI,CAAC,EACRA,CAAAA,CAAE,gBAAA,CAAiB,gBAAA,CAAkBD,CAAQ,EAC7CC,CAAAA,CAAE,gBAAA,CAAiB,aAAA,CAAeD,CAAQ,GAC5C,CAAC,CAAA,CACA,MAAM,IAAM,CAEb,CAAC,CAAA,CAEI,IAAM,CACXD,CAAAA,CAAY,KACRD,CAAAA,GACFA,CAAAA,CAAQ,oBAAoB,gBAAA,CAAkBE,CAAQ,EACtDF,CAAAA,CAAQ,mBAAA,CAAoB,aAAA,CAAeE,CAAQ,GAEvD,CACF,CAAA,CAAG,CAACH,CAAM,CAAC,EAEJF,CACT","file":"index.cjs","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * Returns `true` when the page is visible, `false` when hidden.\n * SSR-safe — defaults to `true` on the server.\n */\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(() =>\n    typeof document === \"undefined\" ? true : document.visibilityState === \"visible\",\n  );\n\n  const handler = useCallback(() => {\n    setVisible(document.visibilityState === \"visible\");\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n\n    // Sync in case value changed between SSR hydration and effect\n    handler();\n\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, [handler]);\n\n  return visible;\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface IdleVisibilityResult {\n  /** Whether the page is visible */\n  visible: boolean;\n  /** Whether the user is idle (no interaction for `timeout` ms) */\n  idle: boolean;\n}\n\n/**\n * Combines page-visibility with idle detection.\n *\n * @param timeout - Milliseconds of inactivity before the user is\n *                  considered idle (default `60_000`).\n */\nexport function useIdleVisibility(timeout = 60_000): IdleVisibilityResult {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  const reset = useCallback(() => {\n    setIdle(false);\n    clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => setIdle(true), timeout);\n  }, [timeout]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const events: Array<keyof WindowEventMap> = [\n      \"mousemove\",\n      \"keydown\",\n      \"pointerdown\",\n      \"scroll\",\n      \"touchstart\",\n    ];\n\n    events.forEach((e) => window.addEventListener(e, reset, { passive: true }));\n    reset();\n\n    return () => {\n      events.forEach((e) => window.removeEventListener(e, reset));\n      clearTimeout(timerRef.current);\n    };\n  }, [reset]);\n\n  // Reset idle timer when tab becomes visible again\n  useEffect(() => {\n    if (visible) reset();\n  }, [visible, reset]);\n\n  return { visible, idle };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\n/**\n * Automatically pauses a `<video>` when the page becomes hidden\n * and resumes playback when the page becomes visible again.\n *\n * Only resumes if the video was playing before it was paused by this hook.\n */\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void {\n  const visible = useDocVisible();\n  const wasPausedByUs = useRef(false);\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible && !video.paused) {\n      video.pause();\n      wasPausedByUs.current = true;\n    } else if (visible && wasPausedByUs.current) {\n      video.play().catch(() => {\n        /* autoplay may be blocked */\n      });\n      wasPausedByUs.current = false;\n    }\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface SmartPollingOptions {\n  /** Polling interval in ms (default `5000`) */\n  interval?: number;\n  /** Enable / disable polling (default `true`). The initial fetch always fires. */\n  enabled?: boolean;\n}\n\nexport interface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  /** Manually trigger a fetch */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Visibility-aware polling hook.\n *\n * - Pauses when the tab is hidden.\n * - Skips re-renders when data hasn't changed (shallow JSON comparison).\n * - Prevents overlapping fetches.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useSmartPolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n  const mountedRef = useRef(true);\n\n  // Always keep the latest fetchFn\n  fetchRef.current = fetchFn;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(async () => {\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n      if (!mountedRef.current) return;\n\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      if (!mountedRef.current) return;\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      if (mountedRef.current) {\n        setIsLoading((prev) => (prev ? false : prev));\n      }\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible AND enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n      return;\n    }\n\n    // Immediately fetch when re-enabled / tab returns\n    execute();\n\n    timerRef.current = setInterval(execute, interval);\n    return () => {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n    };\n  }, [visible, enabled, interval, execute]);\n\n  return {\n    data,\n    isLoading,\n    isError: error !== undefined,\n    error,\n    refetch: execute,\n  };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface PageFocusEffectOptions {\n  /** Callback fired when the page transitions from hidden → visible. May return a cleanup function. */\n  onVisible?: () => void | (() => void);\n  /** Callback fired when the page transitions from visible → hidden. */\n  onHidden?: () => void;\n}\n\n/**\n * Runs side-effect callbacks on visibility **transitions** rather than\n * on every render.\n *\n * - `onVisible` fires when the tab goes from hidden → visible.\n * - `onHidden` fires when the tab goes from visible → hidden.\n * - The very first render is **not** treated as a transition.\n * - `onVisible` may return a cleanup function (like `useEffect`).\n *\n * SSR-safe — no-ops on the server.\n *\n * @example\n * ```tsx\n * usePageFocusEffect({\n *   onVisible: () => { refetchStaleData(); },\n *   onHidden:  () => { saveScrollPosition(); },\n * });\n * ```\n */\nexport function usePageFocusEffect(options: PageFocusEffectOptions): void {\n  const visible = useDocVisible();\n  const prevRef = useRef<boolean | undefined>(undefined);\n  const cleanupRef = useRef<(() => void) | undefined>(undefined);\n\n  // Keep latest callbacks in refs to avoid re-triggering the effect\n  const onVisibleRef = useRef(options.onVisible);\n  const onHiddenRef = useRef(options.onHidden);\n  onVisibleRef.current = options.onVisible;\n  onHiddenRef.current = options.onHidden;\n\n  useEffect(() => {\n    // Skip the initial mount — only fire on actual transitions\n    if (prevRef.current === undefined) {\n      prevRef.current = visible;\n      return;\n    }\n\n    if (visible && !prevRef.current) {\n      // hidden → visible\n      cleanupRef.current?.();\n      cleanupRef.current = undefined;\n      const result = onVisibleRef.current?.();\n      if (typeof result === \"function\") {\n        cleanupRef.current = result;\n      }\n    } else if (!visible && prevRef.current) {\n      // visible → hidden\n      onHiddenRef.current?.();\n    }\n\n    prevRef.current = visible;\n  }, [visible]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      cleanupRef.current?.();\n    };\n  }, []);\n}\n","import { useState, useEffect, useCallback } from \"react\";\nimport { useSmartPolling } from \"./useSmartPolling\";\nimport type { SmartPollingOptions, SmartPollingResult } from \"./useSmartPolling\";\n\nexport interface NetworkAwarePollingOptions extends SmartPollingOptions {\n  /** Multiplier applied to `interval` on slow connections like 2g (default `3`). */\n  slowMultiplier?: number;\n  /** Whether to pause polling when the browser is offline (default `true`). */\n  pauseOffline?: boolean;\n}\n\nexport interface NetworkAwarePollingResult<T> extends SmartPollingResult<T> {\n  /** `true` when the browser reports being online. */\n  isOnline: boolean;\n  /** The effective polling interval after network-quality adjustment. */\n  effectiveInterval: number;\n}\n\n/**\n * Network + visibility-aware polling.\n *\n * Extends `useSmartPolling` with:\n * - Automatic pause when the browser goes offline.\n * - Adaptive interval — polls slower on poor connections (2g / slow-2g).\n *\n * SSR-safe — defaults to online on the server.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useNetworkAwarePolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: NetworkAwarePollingOptions,\n): NetworkAwarePollingResult<T> {\n  const {\n    interval = 5000,\n    enabled = true,\n    slowMultiplier = 3,\n    pauseOffline = true,\n    ...rest\n  } = options ?? {};\n\n  const online = useOnline();\n  const effectiveInterval = getEffectiveInterval(interval, slowMultiplier);\n\n  const shouldPoll = pauseOffline ? enabled && online : enabled;\n\n  const result = useSmartPolling(fetchFn, {\n    ...rest,\n    interval: effectiveInterval,\n    enabled: shouldPoll,\n  });\n\n  return { ...result, isOnline: online, effectiveInterval };\n}\n\n/* ------------------------------------------------------------------ */\n/*  Internal helpers                                                   */\n/* ------------------------------------------------------------------ */\n\n/** SSR-safe hook that tracks `navigator.onLine`. */\nfunction useOnline(): boolean {\n  const [online, setOnline] = useState(() =>\n    typeof navigator === \"undefined\" ? true : navigator.onLine,\n  );\n\n  const handleOnline = useCallback(() => setOnline(true), []);\n  const handleOffline = useCallback(() => setOnline(false), []);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    window.addEventListener(\"online\", handleOnline);\n    window.addEventListener(\"offline\", handleOffline);\n    return () => {\n      window.removeEventListener(\"online\", handleOnline);\n      window.removeEventListener(\"offline\", handleOffline);\n    };\n  }, [handleOnline, handleOffline]);\n\n  return online;\n}\n\n/** Returns a longer interval when the connection is slow. */\nfunction getEffectiveInterval(base: number, multiplier: number): number {\n  if (typeof navigator === \"undefined\") return base;\n\n  const conn = (\n    navigator as Navigator & {\n      connection?: { effectiveType?: string };\n    }\n  ).connection;\n\n  if (conn?.effectiveType === \"2g\" || conn?.effectiveType === \"slow-2g\") {\n    return base * multiplier;\n  }\n  return base;\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useIdleVisibility } from \"./useIdleVisibility\";\n\nexport interface InactivityTimeoutOptions {\n  /** Total inactivity before `onTimeout` fires, in ms (default `300_000` — 5 min). */\n  timeout?: number;\n  /**\n   * How long before the final timeout to enter the \"warning\" phase, in ms\n   * (default `60_000` — 1 min).\n   *\n   * Set to `0` to disable the warning phase.\n   */\n  warningBefore?: number;\n  /** Called once when the full timeout elapses. */\n  onTimeout?: () => void;\n  /** Called when entering the warning phase. */\n  onWarning?: () => void;\n}\n\nexport interface InactivityTimeoutResult {\n  /** `true` once the user has been idle long enough to start counting down. */\n  idle: boolean;\n  /** Current page-visibility state. */\n  visible: boolean;\n  /** `true` during the warning countdown (before final timeout). */\n  isWarning: boolean;\n  /** `true` after the full timeout has elapsed. */\n  isTimedOut: boolean;\n  /** Seconds remaining until timeout (`-1` when the user is not idle). */\n  remainingSeconds: number;\n  /** Manually reset the timer and cancel any pending timeout. */\n  resetTimer: () => void;\n}\n\n/**\n * Countdown-based session/inactivity manager built on top of\n * `useIdleVisibility`.\n *\n * 1. After `timeout - warningBefore` ms of inactivity the hook enters\n *    the **warning** phase and starts a per-second countdown.\n * 2. When the countdown hits zero `onTimeout` fires and `isTimedOut`\n *    becomes `true`.\n * 3. Any user interaction resets the timer.\n *\n * SSR-safe — all timers only run in the browser.\n */\nexport function useInactivityTimeout(\n  options?: InactivityTimeoutOptions,\n): InactivityTimeoutResult {\n  const {\n    timeout = 300_000,\n    warningBefore = 60_000,\n    onTimeout,\n    onWarning,\n  } = options ?? {};\n\n  // Clamp so warningBefore never exceeds timeout\n  const clampedWarning = Math.min(warningBefore, timeout);\n  const idleThreshold = timeout - clampedWarning;\n\n  const { idle, visible } = useIdleVisibility(idleThreshold);\n\n  const [remaining, setRemaining] = useState(-1);\n  const [timedOut, setTimedOut] = useState(false);\n  const intervalRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const startRef = useRef<number | undefined>(undefined);\n  const warnedRef = useRef(false);\n\n  // Keep callback refs stable\n  const onTimeoutRef = useRef(onTimeout);\n  const onWarningRef = useRef(onWarning);\n  onTimeoutRef.current = onTimeout;\n  onWarningRef.current = onWarning;\n\n  const clear = useCallback(() => {\n    clearInterval(intervalRef.current);\n    intervalRef.current = undefined;\n    startRef.current = undefined;\n    warnedRef.current = false;\n    setRemaining(-1);\n    setTimedOut(false);\n  }, []);\n\n  useEffect(() => {\n    if (!idle || timedOut) {\n      if (!idle) clear();\n      return;\n    }\n\n    startRef.current = Date.now();\n\n    // Fire the warning callback once at the start of the countdown\n    if (!warnedRef.current) {\n      warnedRef.current = true;\n      onWarningRef.current?.();\n    }\n\n    const warningMs = clampedWarning;\n\n    intervalRef.current = setInterval(() => {\n      const elapsed = Date.now() - (startRef.current ?? Date.now());\n      const left = Math.max(0, Math.ceil((warningMs - elapsed) / 1000));\n      setRemaining(left);\n\n      if (left <= 0) {\n        clearInterval(intervalRef.current);\n        intervalRef.current = undefined;\n        setTimedOut(true);\n        onTimeoutRef.current?.();\n      }\n    }, 1000);\n\n    return () => {\n      clearInterval(intervalRef.current);\n      intervalRef.current = undefined;\n    };\n  }, [idle, timedOut, clampedWarning, clear]);\n\n  const isWarning = idle && !timedOut && remaining >= 0;\n\n  return {\n    idle: idle || timedOut,\n    visible,\n    isWarning,\n    isTimedOut: timedOut,\n    remainingSeconds: remaining,\n    resetTimer: clear,\n  };\n}\n","import { useState, useCallback, useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface WakeLockResult {\n  /** `true` while a Wake Lock is actively held. */\n  isActive: boolean;\n  /** Request the screen Wake Lock. No-ops if unsupported. */\n  request: () => Promise<void>;\n  /** Release the current Wake Lock. */\n  release: () => Promise<void>;\n  /** `true` when the Screen Wake Lock API is available in this browser. */\n  isSupported: boolean;\n}\n\n/**\n * Manages the [Screen Wake Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Wake_Lock_API)\n * to prevent the screen from dimming or locking.\n *\n * Features:\n * - Automatic re-acquire on tab re-focus when `autoReacquire` is `true`.\n * - Cleans up the Wake Lock on unmount.\n * - SSR-safe — `isSupported` will be `false` on the server.\n *\n * @param autoReacquire - Re-request the lock when the tab becomes visible\n *                        again after being hidden (default `true`).\n */\nexport function useWakeLock(autoReacquire = true): WakeLockResult {\n  const visible = useDocVisible();\n  const [isActive, setIsActive] = useState(false);\n  const sentinelRef = useRef<WakeLockSentinel | undefined>(undefined);\n  const wantedRef = useRef(false);\n\n  const isSupported = typeof navigator !== \"undefined\" && navigator.wakeLock != null;\n\n  const request = useCallback(async () => {\n    if (!isSupported) return;\n    // Already holding a lock — skip\n    if (sentinelRef.current && !sentinelRef.current.released) return;\n\n    try {\n      const sentinel = await navigator.wakeLock.request(\"screen\");\n      sentinelRef.current = sentinel;\n      wantedRef.current = true;\n      setIsActive(true);\n\n      sentinel.addEventListener(\"release\", () => {\n        setIsActive(false);\n        sentinelRef.current = undefined;\n      });\n    } catch {\n      // Permission denied, low battery, or other platform error\n    }\n  }, [isSupported]);\n\n  const release = useCallback(async () => {\n    wantedRef.current = false;\n    if (sentinelRef.current && !sentinelRef.current.released) {\n      await sentinelRef.current.release();\n    }\n  }, []);\n\n  // Re-acquire on tab visibility change\n  useEffect(() => {\n    if (autoReacquire && visible && wantedRef.current && !sentinelRef.current) {\n      void request();\n    }\n  }, [visible, autoReacquire, request]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (sentinelRef.current && !sentinelRef.current.released) {\n        sentinelRef.current.release().catch(() => {});\n      }\n    };\n  }, []);\n\n  return { isActive, request, release, isSupported };\n}\n","import { useState, useEffect, useCallback } from \"react\";\n\nexport interface BatteryState {\n  /** `true` when the device is plugged in. Defaults to `true` (optimistic). */\n  charging: boolean;\n  /** Battery level between 0 and 1. Defaults to `1`. */\n  level: number;\n  /** `true` when the device is **not** charging and `level` is below `lowThreshold`. */\n  isLowBattery: boolean;\n  /** `true` when the Battery Status API is available. */\n  isSupported: boolean;\n}\n\ninterface BatteryManager extends EventTarget {\n  charging: boolean;\n  level: number;\n}\n\n/**\n * Exposes device battery status via the\n * [Battery Status API](https://developer.mozilla.org/en-US/docs/Web/API/Battery_Status_API).\n *\n * Use cases:\n * - Reduce polling frequency on low battery.\n * - Disable animations / heavy computations when the battery is low.\n * - Show a battery-aware UI indicator.\n *\n * SSR-safe — returns optimistic defaults on the server.\n *\n * @param lowThreshold - Level (0–1) below which `isLowBattery` becomes `true`\n *                       when the device is not charging (default `0.15`).\n */\nexport function useBatteryAware(lowThreshold = 0.15): BatteryState {\n  const [state, setState] = useState<BatteryState>({\n    charging: true,\n    level: 1,\n    isLowBattery: false,\n    isSupported: false,\n  });\n\n  const update = useCallback(\n    (battery: BatteryManager) => {\n      setState({\n        charging: battery.charging,\n        level: battery.level,\n        isLowBattery: !battery.charging && battery.level < lowThreshold,\n        isSupported: true,\n      });\n    },\n    [lowThreshold],\n  );\n\n  useEffect(() => {\n    if (\n      typeof navigator === \"undefined\" ||\n      typeof (navigator as Navigator & { getBattery?: unknown }).getBattery !== \"function\"\n    ) {\n      return;\n    }\n\n    let battery: BatteryManager | undefined;\n    let cancelled = false;\n\n    const onChange = () => {\n      if (battery && !cancelled) update(battery);\n    };\n\n    (navigator as Navigator & { getBattery: () => Promise<BatteryManager> })\n      .getBattery()\n      .then((b) => {\n        if (cancelled) return;\n        battery = b;\n        update(b);\n        b.addEventListener(\"chargingchange\", onChange);\n        b.addEventListener(\"levelchange\", onChange);\n      })\n      .catch(() => {\n        // API exists but call failed — leave defaults\n      });\n\n    return () => {\n      cancelled = true;\n      if (battery) {\n        battery.removeEventListener(\"chargingchange\", onChange);\n        battery.removeEventListener(\"levelchange\", onChange);\n      }\n    };\n  }, [update]);\n\n  return state;\n}\n"]}

package/dist/index.d.cts

@@ -52,4 +52,150 @@ interface SmartPollingResult<T> {
  */
 declare function useSmartPolling<T = unknown>(fetchFn: () => Promise<T>, options?: SmartPollingOptions): SmartPollingResult<T>;
 
-export { type IdleVisibilityResult, type SmartPollingOptions, type SmartPollingResult, useAutoPauseVideo, useDocVisible, useIdleVisibility, useSmartPolling };
+interface PageFocusEffectOptions {
+    /** Callback fired when the page transitions from hidden → visible. May return a cleanup function. */
+    onVisible?: () => void | (() => void);
+    /** Callback fired when the page transitions from visible → hidden. */
+    onHidden?: () => void;
+}
+/**
+ * Runs side-effect callbacks on visibility **transitions** rather than
+ * on every render.
+ *
+ * - `onVisible` fires when the tab goes from hidden → visible.
+ * - `onHidden` fires when the tab goes from visible → hidden.
+ * - The very first render is **not** treated as a transition.
+ * - `onVisible` may return a cleanup function (like `useEffect`).
+ *
+ * SSR-safe — no-ops on the server.
+ *
+ * @example
+ * ```tsx
+ * usePageFocusEffect({
+ *   onVisible: () => { refetchStaleData(); },
+ *   onHidden:  () => { saveScrollPosition(); },
+ * });
+ * ```
+ */
+declare function usePageFocusEffect(options: PageFocusEffectOptions): void;
+
+interface NetworkAwarePollingOptions extends SmartPollingOptions {
+    /** Multiplier applied to `interval` on slow connections like 2g (default `3`). */
+    slowMultiplier?: number;
+    /** Whether to pause polling when the browser is offline (default `true`). */
+    pauseOffline?: boolean;
+}
+interface NetworkAwarePollingResult<T> extends SmartPollingResult<T> {
+    /** `true` when the browser reports being online. */
+    isOnline: boolean;
+    /** The effective polling interval after network-quality adjustment. */
+    effectiveInterval: number;
+}
+/**
+ * Network + visibility-aware polling.
+ *
+ * Extends `useSmartPolling` with:
+ * - Automatic pause when the browser goes offline.
+ * - Adaptive interval — polls slower on poor connections (2g / slow-2g).
+ *
+ * SSR-safe — defaults to online on the server.
+ *
+ * @param fetchFn - Async function that returns data.
+ * @param options - Optional configuration.
+ */
+declare function useNetworkAwarePolling<T = unknown>(fetchFn: () => Promise<T>, options?: NetworkAwarePollingOptions): NetworkAwarePollingResult<T>;
+
+interface InactivityTimeoutOptions {
+    /** Total inactivity before `onTimeout` fires, in ms (default `300_000` — 5 min). */
+    timeout?: number;
+    /**
+     * How long before the final timeout to enter the "warning" phase, in ms
+     * (default `60_000` — 1 min).
+     *
+     * Set to `0` to disable the warning phase.
+     */
+    warningBefore?: number;
+    /** Called once when the full timeout elapses. */
+    onTimeout?: () => void;
+    /** Called when entering the warning phase. */
+    onWarning?: () => void;
+}
+interface InactivityTimeoutResult {
+    /** `true` once the user has been idle long enough to start counting down. */
+    idle: boolean;
+    /** Current page-visibility state. */
+    visible: boolean;
+    /** `true` during the warning countdown (before final timeout). */
+    isWarning: boolean;
+    /** `true` after the full timeout has elapsed. */
+    isTimedOut: boolean;
+    /** Seconds remaining until timeout (`-1` when the user is not idle). */
+    remainingSeconds: number;
+    /** Manually reset the timer and cancel any pending timeout. */
+    resetTimer: () => void;
+}
+/**
+ * Countdown-based session/inactivity manager built on top of
+ * `useIdleVisibility`.
+ *
+ * 1. After `timeout - warningBefore` ms of inactivity the hook enters
+ *    the **warning** phase and starts a per-second countdown.
+ * 2. When the countdown hits zero `onTimeout` fires and `isTimedOut`
+ *    becomes `true`.
+ * 3. Any user interaction resets the timer.
+ *
+ * SSR-safe — all timers only run in the browser.
+ */
+declare function useInactivityTimeout(options?: InactivityTimeoutOptions): InactivityTimeoutResult;
+
+interface WakeLockResult {
+    /** `true` while a Wake Lock is actively held. */
+    isActive: boolean;
+    /** Request the screen Wake Lock. No-ops if unsupported. */
+    request: () => Promise<void>;
+    /** Release the current Wake Lock. */
+    release: () => Promise<void>;
+    /** `true` when the Screen Wake Lock API is available in this browser. */
+    isSupported: boolean;
+}
+/**
+ * Manages the [Screen Wake Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Wake_Lock_API)
+ * to prevent the screen from dimming or locking.
+ *
+ * Features:
+ * - Automatic re-acquire on tab re-focus when `autoReacquire` is `true`.
+ * - Cleans up the Wake Lock on unmount.
+ * - SSR-safe — `isSupported` will be `false` on the server.
+ *
+ * @param autoReacquire - Re-request the lock when the tab becomes visible
+ *                        again after being hidden (default `true`).
+ */
+declare function useWakeLock(autoReacquire?: boolean): WakeLockResult;
+
+interface BatteryState {
+    /** `true` when the device is plugged in. Defaults to `true` (optimistic). */
+    charging: boolean;
+    /** Battery level between 0 and 1. Defaults to `1`. */
+    level: number;
+    /** `true` when the device is **not** charging and `level` is below `lowThreshold`. */
+    isLowBattery: boolean;
+    /** `true` when the Battery Status API is available. */
+    isSupported: boolean;
+}
+/**
+ * Exposes device battery status via the
+ * [Battery Status API](https://developer.mozilla.org/en-US/docs/Web/API/Battery_Status_API).
+ *
+ * Use cases:
+ * - Reduce polling frequency on low battery.
+ * - Disable animations / heavy computations when the battery is low.
+ * - Show a battery-aware UI indicator.
+ *
+ * SSR-safe — returns optimistic defaults on the server.
+ *
+ * @param lowThreshold - Level (0–1) below which `isLowBattery` becomes `true`
+ *                       when the device is not charging (default `0.15`).
+ */
+declare function useBatteryAware(lowThreshold?: number): BatteryState;
+
+export { type BatteryState, type IdleVisibilityResult, type InactivityTimeoutOptions, type InactivityTimeoutResult, type NetworkAwarePollingOptions, type NetworkAwarePollingResult, type PageFocusEffectOptions, type SmartPollingOptions, type SmartPollingResult, type WakeLockResult, useAutoPauseVideo, useBatteryAware, useDocVisible, useIdleVisibility, useInactivityTimeout, useNetworkAwarePolling, usePageFocusEffect, useSmartPolling, useWakeLock };

package/dist/index.d.ts

@@ -52,4 +52,150 @@ interface SmartPollingResult<T> {
  */
 declare function useSmartPolling<T = unknown>(fetchFn: () => Promise<T>, options?: SmartPollingOptions): SmartPollingResult<T>;
 
-export { type IdleVisibilityResult, type SmartPollingOptions, type SmartPollingResult, useAutoPauseVideo, useDocVisible, useIdleVisibility, useSmartPolling };
+interface PageFocusEffectOptions {
+    /** Callback fired when the page transitions from hidden → visible. May return a cleanup function. */
+    onVisible?: () => void | (() => void);
+    /** Callback fired when the page transitions from visible → hidden. */
+    onHidden?: () => void;
+}
+/**
+ * Runs side-effect callbacks on visibility **transitions** rather than
+ * on every render.
+ *
+ * - `onVisible` fires when the tab goes from hidden → visible.
+ * - `onHidden` fires when the tab goes from visible → hidden.
+ * - The very first render is **not** treated as a transition.
+ * - `onVisible` may return a cleanup function (like `useEffect`).
+ *
+ * SSR-safe — no-ops on the server.
+ *
+ * @example
+ * ```tsx
+ * usePageFocusEffect({
+ *   onVisible: () => { refetchStaleData(); },
+ *   onHidden:  () => { saveScrollPosition(); },
+ * });
+ * ```
+ */
+declare function usePageFocusEffect(options: PageFocusEffectOptions): void;
+
+interface NetworkAwarePollingOptions extends SmartPollingOptions {
+    /** Multiplier applied to `interval` on slow connections like 2g (default `3`). */
+    slowMultiplier?: number;
+    /** Whether to pause polling when the browser is offline (default `true`). */
+    pauseOffline?: boolean;
+}
+interface NetworkAwarePollingResult<T> extends SmartPollingResult<T> {
+    /** `true` when the browser reports being online. */
+    isOnline: boolean;
+    /** The effective polling interval after network-quality adjustment. */
+    effectiveInterval: number;
+}
+/**
+ * Network + visibility-aware polling.
+ *
+ * Extends `useSmartPolling` with:
+ * - Automatic pause when the browser goes offline.
+ * - Adaptive interval — polls slower on poor connections (2g / slow-2g).
+ *
+ * SSR-safe — defaults to online on the server.
+ *
+ * @param fetchFn - Async function that returns data.
+ * @param options - Optional configuration.
+ */
+declare function useNetworkAwarePolling<T = unknown>(fetchFn: () => Promise<T>, options?: NetworkAwarePollingOptions): NetworkAwarePollingResult<T>;
+
+interface InactivityTimeoutOptions {
+    /** Total inactivity before `onTimeout` fires, in ms (default `300_000` — 5 min). */
+    timeout?: number;
+    /**
+     * How long before the final timeout to enter the "warning" phase, in ms
+     * (default `60_000` — 1 min).
+     *
+     * Set to `0` to disable the warning phase.
+     */
+    warningBefore?: number;
+    /** Called once when the full timeout elapses. */
+    onTimeout?: () => void;
+    /** Called when entering the warning phase. */
+    onWarning?: () => void;
+}
+interface InactivityTimeoutResult {
+    /** `true` once the user has been idle long enough to start counting down. */
+    idle: boolean;
+    /** Current page-visibility state. */
+    visible: boolean;
+    /** `true` during the warning countdown (before final timeout). */
+    isWarning: boolean;
+    /** `true` after the full timeout has elapsed. */
+    isTimedOut: boolean;
+    /** Seconds remaining until timeout (`-1` when the user is not idle). */
+    remainingSeconds: number;
+    /** Manually reset the timer and cancel any pending timeout. */
+    resetTimer: () => void;
+}
+/**
+ * Countdown-based session/inactivity manager built on top of
+ * `useIdleVisibility`.
+ *
+ * 1. After `timeout - warningBefore` ms of inactivity the hook enters
+ *    the **warning** phase and starts a per-second countdown.
+ * 2. When the countdown hits zero `onTimeout` fires and `isTimedOut`
+ *    becomes `true`.
+ * 3. Any user interaction resets the timer.
+ *
+ * SSR-safe — all timers only run in the browser.
+ */
+declare function useInactivityTimeout(options?: InactivityTimeoutOptions): InactivityTimeoutResult;
+
+interface WakeLockResult {
+    /** `true` while a Wake Lock is actively held. */
+    isActive: boolean;
+    /** Request the screen Wake Lock. No-ops if unsupported. */
+    request: () => Promise<void>;
+    /** Release the current Wake Lock. */
+    release: () => Promise<void>;
+    /** `true` when the Screen Wake Lock API is available in this browser. */
+    isSupported: boolean;
+}
+/**
+ * Manages the [Screen Wake Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Wake_Lock_API)
+ * to prevent the screen from dimming or locking.
+ *
+ * Features:
+ * - Automatic re-acquire on tab re-focus when `autoReacquire` is `true`.
+ * - Cleans up the Wake Lock on unmount.
+ * - SSR-safe — `isSupported` will be `false` on the server.
+ *
+ * @param autoReacquire - Re-request the lock when the tab becomes visible
+ *                        again after being hidden (default `true`).
+ */
+declare function useWakeLock(autoReacquire?: boolean): WakeLockResult;
+
+interface BatteryState {
+    /** `true` when the device is plugged in. Defaults to `true` (optimistic). */
+    charging: boolean;
+    /** Battery level between 0 and 1. Defaults to `1`. */
+    level: number;
+    /** `true` when the device is **not** charging and `level` is below `lowThreshold`. */
+    isLowBattery: boolean;
+    /** `true` when the Battery Status API is available. */
+    isSupported: boolean;
+}
+/**
+ * Exposes device battery status via the
+ * [Battery Status API](https://developer.mozilla.org/en-US/docs/Web/API/Battery_Status_API).
+ *
+ * Use cases:
+ * - Reduce polling frequency on low battery.
+ * - Disable animations / heavy computations when the battery is low.
+ * - Show a battery-aware UI indicator.
+ *
+ * SSR-safe — returns optimistic defaults on the server.
+ *
+ * @param lowThreshold - Level (0–1) below which `isLowBattery` becomes `true`
+ *                       when the device is not charging (default `0.15`).
+ */
+declare function useBatteryAware(lowThreshold?: number): BatteryState;
+
+export { type BatteryState, type IdleVisibilityResult, type InactivityTimeoutOptions, type InactivityTimeoutResult, type NetworkAwarePollingOptions, type NetworkAwarePollingResult, type PageFocusEffectOptions, type SmartPollingOptions, type SmartPollingResult, type WakeLockResult, useAutoPauseVideo, useBatteryAware, useDocVisible, useIdleVisibility, useInactivityTimeout, useNetworkAwarePolling, usePageFocusEffect, useSmartPolling, useWakeLock };

package/dist/index.js

@@ -1,2 +1,2 @@
-import {useState,useCallback,useEffect,useRef}from'react';function u(){let[r,e]=useState(()=>typeof document=="undefined"?true:document.visibilityState==="visible"),t=useCallback(()=>{e(document.visibilityState==="visible");},[]);return useEffect(()=>{if(typeof document!="undefined")return t(),document.addEventListener("visibilitychange",t),()=>document.removeEventListener("visibilitychange",t)},[t]),r}function O(r=6e4){let e=u(),[t,n]=useState(false),s=useRef(void 0),o=useCallback(()=>{n(false),clearTimeout(s.current),s.current=setTimeout(()=>n(true),r);},[r]);return useEffect(()=>{if(typeof window=="undefined")return;let m=["mousemove","keydown","pointerdown","scroll","touchstart"];return m.forEach(f=>window.addEventListener(f,o,{passive:true})),o(),()=>{m.forEach(f=>window.removeEventListener(f,o)),clearTimeout(s.current);}},[o]),useEffect(()=>{e&&o();},[e,o]),{visible:e,idle:t}}function j(r){let e=u(),t=useRef(false);useEffect(()=>{let n=r.current;n&&(!e&&!n.paused?(n.pause(),t.current=true):e&&t.current&&(n.play().catch(()=>{}),t.current=false));},[e,r]);}function M(r,e){let{interval:t=5e3,enabled:n=true}=e!=null?e:{},s=u(),[o,m]=useState(void 0),[f,h]=useState(true),[y,R]=useState(void 0),E=useRef(r),a=useRef(void 0),b=useRef(false),g=useRef(void 0),d=useRef(true);E.current=r,useEffect(()=>(d.current=true,()=>{d.current=false;}),[]);let l=useCallback(async()=>{if(!b.current){b.current=true;try{let i=await E.current();if(!d.current)return;let V=JSON.stringify(i);V!==g.current&&(g.current=V,m(i)),R(x=>x!==void 0?void 0:x);}catch(i){if(!d.current)return;R(i instanceof Error?i:new Error(String(i)));}finally{b.current=false,d.current&&h(i=>i&&false);}}},[]),S=useRef(false);return useEffect(()=>{S.current||(S.current=true,l());},[l]),useEffect(()=>{if(!n||!s){clearInterval(a.current),a.current=void 0;return}return l(),a.current=setInterval(l,t),()=>{clearInterval(a.current),a.current=void 0;}},[s,n,t,l]),{data:o,isLoading:f,isError:y!==void 0,error:y,refetch:l}}export{j as useAutoPauseVideo,u as useDocVisible,O as useIdleVisibility,M as useSmartPolling};//# sourceMappingURL=index.js.map
+import {useState,useCallback,useEffect,useRef}from'react';function m(){let[i,n]=useState(()=>typeof document=="undefined"?true:document.visibilityState==="visible"),t=useCallback(()=>{n(document.visibilityState==="visible");},[]);return useEffect(()=>{if(typeof document!="undefined")return t(),document.addEventListener("visibilitychange",t),()=>document.removeEventListener("visibilitychange",t)},[t]),i}function T(i=6e4){let n=m(),[t,r]=useState(false),e=useRef(void 0),o=useCallback(()=>{r(false),clearTimeout(e.current),e.current=setTimeout(()=>r(true),i);},[i]);return useEffect(()=>{if(typeof window=="undefined")return;let s=["mousemove","keydown","pointerdown","scroll","touchstart"];return s.forEach(u=>window.addEventListener(u,o,{passive:true})),o(),()=>{s.forEach(u=>window.removeEventListener(u,o)),clearTimeout(e.current);}},[o]),useEffect(()=>{n&&o();},[n,o]),{visible:n,idle:t}}function Q(i){let n=m(),t=useRef(false);useEffect(()=>{let r=i.current;r&&(!n&&!r.paused?(r.pause(),t.current=true):n&&t.current&&(r.play().catch(()=>{}),t.current=false));},[n,i]);}function I(i,n){let{interval:t=5e3,enabled:r=true}=n!=null?n:{},e=m(),[o,s]=useState(void 0),[u,l]=useState(true),[c,b]=useState(void 0),g=useRef(i),p=useRef(void 0),f=useRef(false),w=useRef(void 0),v=useRef(true);g.current=i,useEffect(()=>(v.current=true,()=>{v.current=false;}),[]);let d=useCallback(async()=>{if(!f.current){f.current=true;try{let a=await g.current();if(!v.current)return;let x=JSON.stringify(a);x!==w.current&&(w.current=x,s(a)),b(k=>k!==void 0?void 0:k);}catch(a){if(!v.current)return;b(a instanceof Error?a:new Error(String(a)));}finally{f.current=false,v.current&&l(a=>a&&false);}}},[]),y=useRef(false);return useEffect(()=>{y.current||(y.current=true,d());},[d]),useEffect(()=>{if(!r||!e){clearInterval(p.current),p.current=void 0;return}return d(),p.current=setInterval(d,t),()=>{clearInterval(p.current),p.current=void 0;}},[e,r,t,d]),{data:o,isLoading:u,isError:c!==void 0,error:c,refetch:d}}function Y(i){let n=m(),t=useRef(void 0),r=useRef(void 0),e=useRef(i.onVisible),o=useRef(i.onHidden);e.current=i.onVisible,o.current=i.onHidden,useEffect(()=>{var s,u,l;if(t.current===void 0){t.current=n;return}if(n&&!t.current){(s=r.current)==null||s.call(r),r.current=void 0;let c=(u=e.current)==null?void 0:u.call(e);typeof c=="function"&&(r.current=c);}else !n&&t.current&&((l=o.current)==null||l.call(o));t.current=n;},[n]),useEffect(()=>()=>{var s;(s=r.current)==null||s.call(r);},[]);}function ee(i,n){let{interval:t=5e3,enabled:r=true,slowMultiplier:e=3,pauseOffline:o=true,...s}=n!=null?n:{},u=te(),l=ne(t,e);return {...I(i,{...s,interval:l,enabled:o?r&&u:r}),isOnline:u,effectiveInterval:l}}function te(){let[i,n]=useState(()=>typeof navigator=="undefined"?true:navigator.onLine),t=useCallback(()=>n(true),[]),r=useCallback(()=>n(false),[]);return useEffect(()=>{if(typeof window!="undefined")return window.addEventListener("online",t),window.addEventListener("offline",r),()=>{window.removeEventListener("online",t),window.removeEventListener("offline",r);}},[t,r]),i}function ne(i,n){if(typeof navigator=="undefined")return i;let t=navigator.connection;return (t==null?void 0:t.effectiveType)==="2g"||(t==null?void 0:t.effectiveType)==="slow-2g"?i*n:i}function oe(i){let{timeout:n=3e5,warningBefore:t=6e4,onTimeout:r,onWarning:e}=i!=null?i:{},o=Math.min(t,n),s=n-o,{idle:u,visible:l}=T(s),[c,b]=useState(-1),[g,p]=useState(false),f=useRef(void 0),w=useRef(void 0),v=useRef(false),d=useRef(r),y=useRef(e);d.current=r,y.current=e;let a=useCallback(()=>{clearInterval(f.current),f.current=void 0,w.current=void 0,v.current=false,b(-1),p(false);},[]);useEffect(()=>{var L;if(!u||g){u||a();return}w.current=Date.now(),v.current||(v.current=true,(L=y.current)==null||L.call(y));let k=o;return f.current=setInterval(()=>{var B,V;let H=Date.now()-((B=w.current)!=null?B:Date.now()),O=Math.max(0,Math.ceil((k-H)/1e3));b(O),O<=0&&(clearInterval(f.current),f.current=void 0,p(true),(V=d.current)==null||V.call(d));},1e3),()=>{clearInterval(f.current),f.current=void 0;}},[u,g,o,a]);let x=u&&!g&&c>=0;return {idle:u||g,visible:l,isWarning:x,isTimedOut:g,remainingSeconds:c,resetTimer:a}}function se(i=true){let n=m(),[t,r]=useState(false),e=useRef(void 0),o=useRef(false),s=typeof navigator!="undefined"&&navigator.wakeLock!=null,u=useCallback(async()=>{if(s&&!(e.current&&!e.current.released))try{let c=await navigator.wakeLock.request("screen");e.current=c,o.current=!0,r(!0),c.addEventListener("release",()=>{r(!1),e.current=void 0;});}catch{}},[s]),l=useCallback(async()=>{o.current=false,e.current&&!e.current.released&&await e.current.release();},[]);return useEffect(()=>{i&&n&&o.current&&!e.current&&u();},[n,i,u]),useEffect(()=>()=>{e.current&&!e.current.released&&e.current.release().catch(()=>{});},[]),{isActive:t,request:u,release:l,isSupported:s}}function fe(i=.15){let[n,t]=useState({charging:true,level:1,isLowBattery:false,isSupported:false}),r=useCallback(e=>{t({charging:e.charging,level:e.level,isLowBattery:!e.charging&&e.level<i,isSupported:true});},[i]);return useEffect(()=>{if(typeof navigator=="undefined"||typeof navigator.getBattery!="function")return;let e,o=false,s=()=>{e&&!o&&r(e);};return navigator.getBattery().then(u=>{o||(e=u,r(u),u.addEventListener("chargingchange",s),u.addEventListener("levelchange",s));}).catch(()=>{}),()=>{o=true,e&&(e.removeEventListener("chargingchange",s),e.removeEventListener("levelchange",s));}},[r]),n}export{Q as useAutoPauseVideo,fe as useBatteryAware,m as useDocVisible,T as useIdleVisibility,oe as useInactivityTimeout,ee as useNetworkAwarePolling,Y as usePageFocusEffect,I as useSmartPolling,se as useWakeLock};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts"],"names":["useDocVisible","visible","setVisible","useState","handler","useCallback","useEffect","useIdleVisibility","timeout","idle","setIdle","timerRef","useRef","reset","events","e","useAutoPauseVideo","ref","wasPausedByUs","video","useSmartPolling","fetchFn","options","interval","enabled","data","setData","isLoading","setIsLoading","error","setError","fetchRef","isFetchingRef","lastJsonRef","mountedRef","execute","result","json","prev","err","hasFetchedRef"],"mappings":"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","file":"index.js","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * Returns `true` when the page is visible, `false` when hidden.\n * SSR-safe — defaults to `true` on the server.\n */\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(() =>\n    typeof document === \"undefined\" ? true : document.visibilityState === \"visible\",\n  );\n\n  const handler = useCallback(() => {\n    setVisible(document.visibilityState === \"visible\");\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n\n    // Sync in case value changed between SSR hydration and effect\n    handler();\n\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, [handler]);\n\n  return visible;\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface IdleVisibilityResult {\n  /** Whether the page is visible */\n  visible: boolean;\n  /** Whether the user is idle (no interaction for `timeout` ms) */\n  idle: boolean;\n}\n\n/**\n * Combines page-visibility with idle detection.\n *\n * @param timeout - Milliseconds of inactivity before the user is\n *                  considered idle (default `60_000`).\n */\nexport function useIdleVisibility(timeout = 60_000): IdleVisibilityResult {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  const reset = useCallback(() => {\n    setIdle(false);\n    clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => setIdle(true), timeout);\n  }, [timeout]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const events: Array<keyof WindowEventMap> = [\n      \"mousemove\",\n      \"keydown\",\n      \"pointerdown\",\n      \"scroll\",\n      \"touchstart\",\n    ];\n\n    events.forEach((e) => window.addEventListener(e, reset, { passive: true }));\n    reset();\n\n    return () => {\n      events.forEach((e) => window.removeEventListener(e, reset));\n      clearTimeout(timerRef.current);\n    };\n  }, [reset]);\n\n  // Reset idle timer when tab becomes visible again\n  useEffect(() => {\n    if (visible) reset();\n  }, [visible, reset]);\n\n  return { visible, idle };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\n/**\n * Automatically pauses a `<video>` when the page becomes hidden\n * and resumes playback when the page becomes visible again.\n *\n * Only resumes if the video was playing before it was paused by this hook.\n */\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void {\n  const visible = useDocVisible();\n  const wasPausedByUs = useRef(false);\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible && !video.paused) {\n      video.pause();\n      wasPausedByUs.current = true;\n    } else if (visible && wasPausedByUs.current) {\n      video.play().catch(() => {\n        /* autoplay may be blocked */\n      });\n      wasPausedByUs.current = false;\n    }\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface SmartPollingOptions {\n  /** Polling interval in ms (default `5000`) */\n  interval?: number;\n  /** Enable / disable polling (default `true`). The initial fetch always fires. */\n  enabled?: boolean;\n}\n\nexport interface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  /** Manually trigger a fetch */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Visibility-aware polling hook.\n *\n * - Pauses when the tab is hidden.\n * - Skips re-renders when data hasn't changed (shallow JSON comparison).\n * - Prevents overlapping fetches.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useSmartPolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n  const mountedRef = useRef(true);\n\n  // Always keep the latest fetchFn\n  fetchRef.current = fetchFn;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(async () => {\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n      if (!mountedRef.current) return;\n\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      if (!mountedRef.current) return;\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      if (mountedRef.current) {\n        setIsLoading((prev) => (prev ? false : prev));\n      }\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible AND enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n      return;\n    }\n\n    // Immediately fetch when re-enabled / tab returns\n    execute();\n\n    timerRef.current = setInterval(execute, interval);\n    return () => {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n    };\n  }, [visible, enabled, interval, execute]);\n\n  return {\n    data,\n    isLoading,\n    isError: error !== undefined,\n    error,\n    refetch: execute,\n  };\n}\n"]}
+{"version":3,"sources":["../src/useDocVisible.ts","../src/useIdleVisibility.ts","../src/useAutoPauseVideo.ts","../src/useSmartPolling.ts","../src/usePageFocusEffect.ts","../src/useNetworkAwarePolling.ts","../src/useInactivityTimeout.ts","../src/useWakeLock.ts","../src/useBatteryAware.ts"],"names":["useDocVisible","visible","setVisible","useState","handler","useCallback","useEffect","useIdleVisibility","timeout","idle","setIdle","timerRef","useRef","reset","events","e","useAutoPauseVideo","ref","wasPausedByUs","video","useSmartPolling","fetchFn","options","interval","enabled","data","setData","isLoading","setIsLoading","error","setError","fetchRef","isFetchingRef","lastJsonRef","mountedRef","execute","result","json","prev","err","hasFetchedRef","usePageFocusEffect","prevRef","cleanupRef","onVisibleRef","onHiddenRef","_a","_b","_c","useNetworkAwarePolling","slowMultiplier","pauseOffline","rest","online","useOnline","effectiveInterval","getEffectiveInterval","setOnline","handleOnline","handleOffline","base","multiplier","conn","useInactivityTimeout","warningBefore","onTimeout","onWarning","clampedWarning","idleThreshold","remaining","setRemaining","timedOut","setTimedOut","intervalRef","startRef","warnedRef","onTimeoutRef","onWarningRef","clear","warningMs","elapsed","left","isWarning","useWakeLock","autoReacquire","isActive","setIsActive","sentinelRef","wantedRef","isSupported","request","sentinel","release","useBatteryAware","lowThreshold","state","setState","update","battery","cancelled","onChange","b"],"mappings":"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","file":"index.js","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * Returns `true` when the page is visible, `false` when hidden.\n * SSR-safe — defaults to `true` on the server.\n */\nexport function useDocVisible(): boolean {\n  const [visible, setVisible] = useState(() =>\n    typeof document === \"undefined\" ? true : document.visibilityState === \"visible\",\n  );\n\n  const handler = useCallback(() => {\n    setVisible(document.visibilityState === \"visible\");\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n\n    // Sync in case value changed between SSR hydration and effect\n    handler();\n\n    document.addEventListener(\"visibilitychange\", handler);\n    return () => document.removeEventListener(\"visibilitychange\", handler);\n  }, [handler]);\n\n  return visible;\n}\n","import { useEffect, useRef, useState, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface IdleVisibilityResult {\n  /** Whether the page is visible */\n  visible: boolean;\n  /** Whether the user is idle (no interaction for `timeout` ms) */\n  idle: boolean;\n}\n\n/**\n * Combines page-visibility with idle detection.\n *\n * @param timeout - Milliseconds of inactivity before the user is\n *                  considered idle (default `60_000`).\n */\nexport function useIdleVisibility(timeout = 60_000): IdleVisibilityResult {\n  const visible = useDocVisible();\n  const [idle, setIdle] = useState(false);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  const reset = useCallback(() => {\n    setIdle(false);\n    clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => setIdle(true), timeout);\n  }, [timeout]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const events: Array<keyof WindowEventMap> = [\n      \"mousemove\",\n      \"keydown\",\n      \"pointerdown\",\n      \"scroll\",\n      \"touchstart\",\n    ];\n\n    events.forEach((e) => window.addEventListener(e, reset, { passive: true }));\n    reset();\n\n    return () => {\n      events.forEach((e) => window.removeEventListener(e, reset));\n      clearTimeout(timerRef.current);\n    };\n  }, [reset]);\n\n  // Reset idle timer when tab becomes visible again\n  useEffect(() => {\n    if (visible) reset();\n  }, [visible, reset]);\n\n  return { visible, idle };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\n/**\n * Automatically pauses a `<video>` when the page becomes hidden\n * and resumes playback when the page becomes visible again.\n *\n * Only resumes if the video was playing before it was paused by this hook.\n */\nexport function useAutoPauseVideo(ref: React.RefObject<HTMLVideoElement | null>): void {\n  const visible = useDocVisible();\n  const wasPausedByUs = useRef(false);\n\n  useEffect(() => {\n    const video = ref.current;\n    if (!video) return;\n\n    if (!visible && !video.paused) {\n      video.pause();\n      wasPausedByUs.current = true;\n    } else if (visible && wasPausedByUs.current) {\n      video.play().catch(() => {\n        /* autoplay may be blocked */\n      });\n      wasPausedByUs.current = false;\n    }\n  }, [visible, ref]);\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface SmartPollingOptions {\n  /** Polling interval in ms (default `5000`) */\n  interval?: number;\n  /** Enable / disable polling (default `true`). The initial fetch always fires. */\n  enabled?: boolean;\n}\n\nexport interface SmartPollingResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  isError: boolean;\n  error: Error | undefined;\n  /** Manually trigger a fetch */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Visibility-aware polling hook.\n *\n * - Pauses when the tab is hidden.\n * - Skips re-renders when data hasn't changed (shallow JSON comparison).\n * - Prevents overlapping fetches.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useSmartPolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: SmartPollingOptions,\n): SmartPollingResult<T> {\n  const { interval = 5000, enabled = true } = options ?? {};\n  const visible = useDocVisible();\n\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | undefined>(undefined);\n\n  const fetchRef = useRef(fetchFn);\n  const timerRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const isFetchingRef = useRef(false);\n  const lastJsonRef = useRef<string | undefined>(undefined);\n  const mountedRef = useRef(true);\n\n  // Always keep the latest fetchFn\n  fetchRef.current = fetchFn;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(async () => {\n    if (isFetchingRef.current) return;\n    isFetchingRef.current = true;\n\n    try {\n      const result = await fetchRef.current();\n      if (!mountedRef.current) return;\n\n      const json = JSON.stringify(result);\n      if (json !== lastJsonRef.current) {\n        lastJsonRef.current = json;\n        setData(result);\n      }\n      setError((prev) => (prev !== undefined ? undefined : prev));\n    } catch (err) {\n      if (!mountedRef.current) return;\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      isFetchingRef.current = false;\n      if (mountedRef.current) {\n        setIsLoading((prev) => (prev ? false : prev));\n      }\n    }\n  }, []);\n\n  // Initial fetch — always runs once regardless of `enabled`\n  const hasFetchedRef = useRef(false);\n  useEffect(() => {\n    if (hasFetchedRef.current) return;\n    hasFetchedRef.current = true;\n    execute();\n  }, [execute]);\n\n  // Polling — only when visible AND enabled\n  useEffect(() => {\n    if (!enabled || !visible) {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n      return;\n    }\n\n    // Immediately fetch when re-enabled / tab returns\n    execute();\n\n    timerRef.current = setInterval(execute, interval);\n    return () => {\n      clearInterval(timerRef.current);\n      timerRef.current = undefined;\n    };\n  }, [visible, enabled, interval, execute]);\n\n  return {\n    data,\n    isLoading,\n    isError: error !== undefined,\n    error,\n    refetch: execute,\n  };\n}\n","import { useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface PageFocusEffectOptions {\n  /** Callback fired when the page transitions from hidden → visible. May return a cleanup function. */\n  onVisible?: () => void | (() => void);\n  /** Callback fired when the page transitions from visible → hidden. */\n  onHidden?: () => void;\n}\n\n/**\n * Runs side-effect callbacks on visibility **transitions** rather than\n * on every render.\n *\n * - `onVisible` fires when the tab goes from hidden → visible.\n * - `onHidden` fires when the tab goes from visible → hidden.\n * - The very first render is **not** treated as a transition.\n * - `onVisible` may return a cleanup function (like `useEffect`).\n *\n * SSR-safe — no-ops on the server.\n *\n * @example\n * ```tsx\n * usePageFocusEffect({\n *   onVisible: () => { refetchStaleData(); },\n *   onHidden:  () => { saveScrollPosition(); },\n * });\n * ```\n */\nexport function usePageFocusEffect(options: PageFocusEffectOptions): void {\n  const visible = useDocVisible();\n  const prevRef = useRef<boolean | undefined>(undefined);\n  const cleanupRef = useRef<(() => void) | undefined>(undefined);\n\n  // Keep latest callbacks in refs to avoid re-triggering the effect\n  const onVisibleRef = useRef(options.onVisible);\n  const onHiddenRef = useRef(options.onHidden);\n  onVisibleRef.current = options.onVisible;\n  onHiddenRef.current = options.onHidden;\n\n  useEffect(() => {\n    // Skip the initial mount — only fire on actual transitions\n    if (prevRef.current === undefined) {\n      prevRef.current = visible;\n      return;\n    }\n\n    if (visible && !prevRef.current) {\n      // hidden → visible\n      cleanupRef.current?.();\n      cleanupRef.current = undefined;\n      const result = onVisibleRef.current?.();\n      if (typeof result === \"function\") {\n        cleanupRef.current = result;\n      }\n    } else if (!visible && prevRef.current) {\n      // visible → hidden\n      onHiddenRef.current?.();\n    }\n\n    prevRef.current = visible;\n  }, [visible]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      cleanupRef.current?.();\n    };\n  }, []);\n}\n","import { useState, useEffect, useCallback } from \"react\";\nimport { useSmartPolling } from \"./useSmartPolling\";\nimport type { SmartPollingOptions, SmartPollingResult } from \"./useSmartPolling\";\n\nexport interface NetworkAwarePollingOptions extends SmartPollingOptions {\n  /** Multiplier applied to `interval` on slow connections like 2g (default `3`). */\n  slowMultiplier?: number;\n  /** Whether to pause polling when the browser is offline (default `true`). */\n  pauseOffline?: boolean;\n}\n\nexport interface NetworkAwarePollingResult<T> extends SmartPollingResult<T> {\n  /** `true` when the browser reports being online. */\n  isOnline: boolean;\n  /** The effective polling interval after network-quality adjustment. */\n  effectiveInterval: number;\n}\n\n/**\n * Network + visibility-aware polling.\n *\n * Extends `useSmartPolling` with:\n * - Automatic pause when the browser goes offline.\n * - Adaptive interval — polls slower on poor connections (2g / slow-2g).\n *\n * SSR-safe — defaults to online on the server.\n *\n * @param fetchFn - Async function that returns data.\n * @param options - Optional configuration.\n */\nexport function useNetworkAwarePolling<T = unknown>(\n  fetchFn: () => Promise<T>,\n  options?: NetworkAwarePollingOptions,\n): NetworkAwarePollingResult<T> {\n  const {\n    interval = 5000,\n    enabled = true,\n    slowMultiplier = 3,\n    pauseOffline = true,\n    ...rest\n  } = options ?? {};\n\n  const online = useOnline();\n  const effectiveInterval = getEffectiveInterval(interval, slowMultiplier);\n\n  const shouldPoll = pauseOffline ? enabled && online : enabled;\n\n  const result = useSmartPolling(fetchFn, {\n    ...rest,\n    interval: effectiveInterval,\n    enabled: shouldPoll,\n  });\n\n  return { ...result, isOnline: online, effectiveInterval };\n}\n\n/* ------------------------------------------------------------------ */\n/*  Internal helpers                                                   */\n/* ------------------------------------------------------------------ */\n\n/** SSR-safe hook that tracks `navigator.onLine`. */\nfunction useOnline(): boolean {\n  const [online, setOnline] = useState(() =>\n    typeof navigator === \"undefined\" ? true : navigator.onLine,\n  );\n\n  const handleOnline = useCallback(() => setOnline(true), []);\n  const handleOffline = useCallback(() => setOnline(false), []);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    window.addEventListener(\"online\", handleOnline);\n    window.addEventListener(\"offline\", handleOffline);\n    return () => {\n      window.removeEventListener(\"online\", handleOnline);\n      window.removeEventListener(\"offline\", handleOffline);\n    };\n  }, [handleOnline, handleOffline]);\n\n  return online;\n}\n\n/** Returns a longer interval when the connection is slow. */\nfunction getEffectiveInterval(base: number, multiplier: number): number {\n  if (typeof navigator === \"undefined\") return base;\n\n  const conn = (\n    navigator as Navigator & {\n      connection?: { effectiveType?: string };\n    }\n  ).connection;\n\n  if (conn?.effectiveType === \"2g\" || conn?.effectiveType === \"slow-2g\") {\n    return base * multiplier;\n  }\n  return base;\n}\n","import { useState, useEffect, useRef, useCallback } from \"react\";\nimport { useIdleVisibility } from \"./useIdleVisibility\";\n\nexport interface InactivityTimeoutOptions {\n  /** Total inactivity before `onTimeout` fires, in ms (default `300_000` — 5 min). */\n  timeout?: number;\n  /**\n   * How long before the final timeout to enter the \"warning\" phase, in ms\n   * (default `60_000` — 1 min).\n   *\n   * Set to `0` to disable the warning phase.\n   */\n  warningBefore?: number;\n  /** Called once when the full timeout elapses. */\n  onTimeout?: () => void;\n  /** Called when entering the warning phase. */\n  onWarning?: () => void;\n}\n\nexport interface InactivityTimeoutResult {\n  /** `true` once the user has been idle long enough to start counting down. */\n  idle: boolean;\n  /** Current page-visibility state. */\n  visible: boolean;\n  /** `true` during the warning countdown (before final timeout). */\n  isWarning: boolean;\n  /** `true` after the full timeout has elapsed. */\n  isTimedOut: boolean;\n  /** Seconds remaining until timeout (`-1` when the user is not idle). */\n  remainingSeconds: number;\n  /** Manually reset the timer and cancel any pending timeout. */\n  resetTimer: () => void;\n}\n\n/**\n * Countdown-based session/inactivity manager built on top of\n * `useIdleVisibility`.\n *\n * 1. After `timeout - warningBefore` ms of inactivity the hook enters\n *    the **warning** phase and starts a per-second countdown.\n * 2. When the countdown hits zero `onTimeout` fires and `isTimedOut`\n *    becomes `true`.\n * 3. Any user interaction resets the timer.\n *\n * SSR-safe — all timers only run in the browser.\n */\nexport function useInactivityTimeout(\n  options?: InactivityTimeoutOptions,\n): InactivityTimeoutResult {\n  const {\n    timeout = 300_000,\n    warningBefore = 60_000,\n    onTimeout,\n    onWarning,\n  } = options ?? {};\n\n  // Clamp so warningBefore never exceeds timeout\n  const clampedWarning = Math.min(warningBefore, timeout);\n  const idleThreshold = timeout - clampedWarning;\n\n  const { idle, visible } = useIdleVisibility(idleThreshold);\n\n  const [remaining, setRemaining] = useState(-1);\n  const [timedOut, setTimedOut] = useState(false);\n  const intervalRef = useRef<ReturnType<typeof setInterval> | undefined>(undefined);\n  const startRef = useRef<number | undefined>(undefined);\n  const warnedRef = useRef(false);\n\n  // Keep callback refs stable\n  const onTimeoutRef = useRef(onTimeout);\n  const onWarningRef = useRef(onWarning);\n  onTimeoutRef.current = onTimeout;\n  onWarningRef.current = onWarning;\n\n  const clear = useCallback(() => {\n    clearInterval(intervalRef.current);\n    intervalRef.current = undefined;\n    startRef.current = undefined;\n    warnedRef.current = false;\n    setRemaining(-1);\n    setTimedOut(false);\n  }, []);\n\n  useEffect(() => {\n    if (!idle || timedOut) {\n      if (!idle) clear();\n      return;\n    }\n\n    startRef.current = Date.now();\n\n    // Fire the warning callback once at the start of the countdown\n    if (!warnedRef.current) {\n      warnedRef.current = true;\n      onWarningRef.current?.();\n    }\n\n    const warningMs = clampedWarning;\n\n    intervalRef.current = setInterval(() => {\n      const elapsed = Date.now() - (startRef.current ?? Date.now());\n      const left = Math.max(0, Math.ceil((warningMs - elapsed) / 1000));\n      setRemaining(left);\n\n      if (left <= 0) {\n        clearInterval(intervalRef.current);\n        intervalRef.current = undefined;\n        setTimedOut(true);\n        onTimeoutRef.current?.();\n      }\n    }, 1000);\n\n    return () => {\n      clearInterval(intervalRef.current);\n      intervalRef.current = undefined;\n    };\n  }, [idle, timedOut, clampedWarning, clear]);\n\n  const isWarning = idle && !timedOut && remaining >= 0;\n\n  return {\n    idle: idle || timedOut,\n    visible,\n    isWarning,\n    isTimedOut: timedOut,\n    remainingSeconds: remaining,\n    resetTimer: clear,\n  };\n}\n","import { useState, useCallback, useEffect, useRef } from \"react\";\nimport { useDocVisible } from \"./useDocVisible\";\n\nexport interface WakeLockResult {\n  /** `true` while a Wake Lock is actively held. */\n  isActive: boolean;\n  /** Request the screen Wake Lock. No-ops if unsupported. */\n  request: () => Promise<void>;\n  /** Release the current Wake Lock. */\n  release: () => Promise<void>;\n  /** `true` when the Screen Wake Lock API is available in this browser. */\n  isSupported: boolean;\n}\n\n/**\n * Manages the [Screen Wake Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Screen_Wake_Lock_API)\n * to prevent the screen from dimming or locking.\n *\n * Features:\n * - Automatic re-acquire on tab re-focus when `autoReacquire` is `true`.\n * - Cleans up the Wake Lock on unmount.\n * - SSR-safe — `isSupported` will be `false` on the server.\n *\n * @param autoReacquire - Re-request the lock when the tab becomes visible\n *                        again after being hidden (default `true`).\n */\nexport function useWakeLock(autoReacquire = true): WakeLockResult {\n  const visible = useDocVisible();\n  const [isActive, setIsActive] = useState(false);\n  const sentinelRef = useRef<WakeLockSentinel | undefined>(undefined);\n  const wantedRef = useRef(false);\n\n  const isSupported = typeof navigator !== \"undefined\" && navigator.wakeLock != null;\n\n  const request = useCallback(async () => {\n    if (!isSupported) return;\n    // Already holding a lock — skip\n    if (sentinelRef.current && !sentinelRef.current.released) return;\n\n    try {\n      const sentinel = await navigator.wakeLock.request(\"screen\");\n      sentinelRef.current = sentinel;\n      wantedRef.current = true;\n      setIsActive(true);\n\n      sentinel.addEventListener(\"release\", () => {\n        setIsActive(false);\n        sentinelRef.current = undefined;\n      });\n    } catch {\n      // Permission denied, low battery, or other platform error\n    }\n  }, [isSupported]);\n\n  const release = useCallback(async () => {\n    wantedRef.current = false;\n    if (sentinelRef.current && !sentinelRef.current.released) {\n      await sentinelRef.current.release();\n    }\n  }, []);\n\n  // Re-acquire on tab visibility change\n  useEffect(() => {\n    if (autoReacquire && visible && wantedRef.current && !sentinelRef.current) {\n      void request();\n    }\n  }, [visible, autoReacquire, request]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      if (sentinelRef.current && !sentinelRef.current.released) {\n        sentinelRef.current.release().catch(() => {});\n      }\n    };\n  }, []);\n\n  return { isActive, request, release, isSupported };\n}\n","import { useState, useEffect, useCallback } from \"react\";\n\nexport interface BatteryState {\n  /** `true` when the device is plugged in. Defaults to `true` (optimistic). */\n  charging: boolean;\n  /** Battery level between 0 and 1. Defaults to `1`. */\n  level: number;\n  /** `true` when the device is **not** charging and `level` is below `lowThreshold`. */\n  isLowBattery: boolean;\n  /** `true` when the Battery Status API is available. */\n  isSupported: boolean;\n}\n\ninterface BatteryManager extends EventTarget {\n  charging: boolean;\n  level: number;\n}\n\n/**\n * Exposes device battery status via the\n * [Battery Status API](https://developer.mozilla.org/en-US/docs/Web/API/Battery_Status_API).\n *\n * Use cases:\n * - Reduce polling frequency on low battery.\n * - Disable animations / heavy computations when the battery is low.\n * - Show a battery-aware UI indicator.\n *\n * SSR-safe — returns optimistic defaults on the server.\n *\n * @param lowThreshold - Level (0–1) below which `isLowBattery` becomes `true`\n *                       when the device is not charging (default `0.15`).\n */\nexport function useBatteryAware(lowThreshold = 0.15): BatteryState {\n  const [state, setState] = useState<BatteryState>({\n    charging: true,\n    level: 1,\n    isLowBattery: false,\n    isSupported: false,\n  });\n\n  const update = useCallback(\n    (battery: BatteryManager) => {\n      setState({\n        charging: battery.charging,\n        level: battery.level,\n        isLowBattery: !battery.charging && battery.level < lowThreshold,\n        isSupported: true,\n      });\n    },\n    [lowThreshold],\n  );\n\n  useEffect(() => {\n    if (\n      typeof navigator === \"undefined\" ||\n      typeof (navigator as Navigator & { getBattery?: unknown }).getBattery !== \"function\"\n    ) {\n      return;\n    }\n\n    let battery: BatteryManager | undefined;\n    let cancelled = false;\n\n    const onChange = () => {\n      if (battery && !cancelled) update(battery);\n    };\n\n    (navigator as Navigator & { getBattery: () => Promise<BatteryManager> })\n      .getBattery()\n      .then((b) => {\n        if (cancelled) return;\n        battery = b;\n        update(b);\n        b.addEventListener(\"chargingchange\", onChange);\n        b.addEventListener(\"levelchange\", onChange);\n      })\n      .catch(() => {\n        // API exists but call failed — leave defaults\n      });\n\n    return () => {\n      cancelled = true;\n      if (battery) {\n        battery.removeEventListener(\"chargingchange\", onChange);\n        battery.removeEventListener(\"levelchange\", onChange);\n      }\n    };\n  }, [update]);\n\n  return state;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-visibility-hooks",
-  "version": "1.0.13",
-  "description": "Tiny, SSR-safe React hooks for page visibility, idle detection, smart polling and auto-pause video",
+  "version": "3.0.0",
+  "description": "Tiny, SSR-safe React hooks for page visibility, idle detection, smart polling, network awareness, wake lock, battery status and more",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -50,7 +50,14 @@
     "ssr",
     "ssr-safe",
     "nextjs",
-    "typescript"
+    "typescript",
+    "wake-lock",
+    "battery",
+    "network-aware",
+    "session-timeout",
+    "focus-effect",
+    "online-offline",
+    "inactivity"
   ],
   "author": "Aniket Raj",
   "license": "MIT",
@@ -92,7 +99,7 @@
   "size-limit": [
     {
       "path": "dist/index.js",
-      "limit": "1.5 kB"
+      "limit": "3 kB"
     }
   ],
   "engines": {