npm - preact-missing-hooks - Versions diffs - 1.1.0 → 1.2.0 - Mend

preact-missing-hooks 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/.github/workflows/test-hooks.yml +4 -1
package/Readme.md +50 -20
package/dist/index.d.ts +1 -0
package/dist/index.js +1 -1
package/dist/index.js.map +1 -1
package/dist/index.module.js +1 -1
package/dist/index.module.js.map +1 -1
package/dist/index.umd.js +1 -1
package/dist/index.umd.js.map +1 -1
package/dist/useRageClick.d.ts +37 -0
package/package.json +67 -64
package/src/index.ts +8 -7
package/src/useRageClick.ts +103 -0
package/tests/useRageClick.test.tsx +145 -0

package/.github/workflows/test-hooks.yml CHANGED Viewed

@@ -26,5 +26,8 @@ jobs:
       - name: Type Check
         run: npm run type-check
-      - name: Run Tests
+      - name: Build
+        run: npm run build
+      - name: Run Tests (all hooks)
         run: npm run test

package/Readme.md CHANGED Viewed

@@ -4,9 +4,6 @@
   <a href="https://www.npmjs.com/package/preact-missing-hooks">
     <img src="https://img.shields.io/npm/v/preact-missing-hooks?color=crimson&label=npm%20version" alt="npm version" />
   </a>
-  <a href="https://www.npmjs.com/package/preact-missing-hooks">
-    <img src="https://img.shields.io/npm/dm/preact-missing-hooks?label=monthly%20downloads" alt="monthly downloads" />
-  </a>
   <a href="https://www.npmjs.com/package/preact-missing-hooks">
     <img src="https://img.shields.io/npm/dt/preact-missing-hooks?label=total%20downloads" alt="total downloads" />
   </a>
@@ -16,26 +13,29 @@
   </a>
 </p>
-A lightweight, extendable collection of React-like hooks for Preact, including utilities for transitions, DOM mutation observation, global event buses, theme detection, network status, and clipboard access.
+If this package helps you, please consider dropping a star on the [GitHub repo](https://github.com/prakhardubey2002/Preact-Missing-Hooks).
+A lightweight, extendable collection of React-like hooks for Preact, including utilities for transitions, DOM mutation observation, global event buses, theme detection, network status, clipboard access, and rage-click detection (e.g. for Sentry).
 ---
-## ✨ Features
+## Features
-- **🔄 `useTransition`** — Defers state updates to yield a smoother UI experience.
-- **🔍 `useMutationObserver`** — Reactively observes DOM changes with a familiar hook API.
-- **📡 `useEventBus`** — A simple publish/subscribe system, eliminating props drilling or overuse of context.
-- **🎁 `useWrappedChildren`** — Injects props into child components with flexible merging strategies.
-- **🌓 `usePreferredTheme`** — Detects the user's preferred color scheme (light/dark) from system preferences.
-- **📶 `useNetworkState`** — Tracks online/offline status and connection details (type, downlink, RTT, save-data).
-- **📋 `useClipboard`** — Copy and paste text with the Clipboard API, with copied/error state.
-- ✅ Fully TypeScript compatible
-- 📦 Bundled with Microbundle
-- ⚡ Zero dependencies (except `preact`)
+- **`useTransition`** — Defers state updates to yield a smoother UI experience.
+- **`useMutationObserver`** — Reactively observes DOM changes with a familiar hook API.
+- **`useEventBus`** — A simple publish/subscribe system, eliminating props drilling or overuse of context.
+- **`useWrappedChildren`** — Injects props into child components with flexible merging strategies.
+- **`usePreferredTheme`** — Detects the user's preferred color scheme (light/dark) from system preferences.
+- **`useNetworkState`** — Tracks online/offline status and connection details (type, downlink, RTT, save-data).
+- **`useClipboard`** — Copy and paste text with the Clipboard API, with copied/error state.
+- **`useRageClick`** — Detects rage clicks (repeated rapid clicks in the same spot). Use with Sentry or similar to detect and fix rage-click issues and lower rage-click-related support.
+- Fully TypeScript compatible
+- Bundled with Microbundle
+- Zero dependencies (except `preact`)
 ---
-## 📦 Installation
+## Installation
 ```bash
 npm install preact-missing-hooks
@@ -43,7 +43,7 @@ npm install preact-missing-hooks
 ---
-## 🔧 Usage Examples
+## Usage Examples
 ### `useTransition`
@@ -242,7 +242,37 @@ function PasteInput() {
 ---
-## 🛠 Built With
+### `useRageClick`
+Detects rage clicks (multiple rapid clicks in the same area), e.g. when the UI is unresponsive. Report them to [Sentry](https://docs.sentry.io/product/issues/issue-details/replay-issues/rage-clicks/) or your error tracker to surface rage-click issues and lower rage-click-related support.
+```tsx
+import { useRef } from 'preact/hooks'
+import { useRageClick } from 'preact-missing-hooks'
+function SubmitButton() {
+  const ref = useRef<HTMLButtonElement>(null)
+  useRageClick(ref, {
+    onRageClick: ({ count, event }) => {
+      // Report to Sentry (or your error tracker) to create rage-click issues
+      Sentry.captureMessage('Rage click detected', {
+        level: 'warning',
+        extra: { count, target: event.target, tag: 'rage_click' },
+      })
+    },
+    threshold: 5, // min clicks (default 5, Sentry-style)
+    timeWindow: 1000, // ms (default 1000)
+    distanceThreshold: 30, // px (default 30)
+  })
+  return <button ref={ref}>Submit</button>
+}
+```
+---
+## Built With
 - [Preact](https://preactjs.com)
 - [Microbundle](https://github.com/developit/microbundle)
@@ -251,12 +281,12 @@ function PasteInput() {
 ---
-## 📝 License
+## License
 MIT © [Prakhar Dubey](https://github.com/prakhardubey2002)
 ---
-## 📬 Contributing
+## Contributing
 Contributions are welcome! Please open issues or submit PRs with new hooks or improvements.

package/dist/index.d.ts CHANGED Viewed

@@ -5,3 +5,4 @@ export * from './useWrappedChildren';
 export * from './usePreferredTheme';
 export * from './useNetworkState';
 export * from './useClipboard';
+export * from './useRageClick';

package/dist/index.js CHANGED Viewed

@@ -1,2 +1,2 @@
-var e=require("preact/hooks"),r=require("preact"),n=new Map;function t(){return t=Object.assign?Object.assign.bind():function(e){for(var r=1;r<arguments.length;r++){var n=arguments[r];for(var t in n)({}).hasOwnProperty.call(n,t)&&(e[t]=n[t])}return e},t.apply(null,arguments)}function o(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},r=navigator.connection;return r&&(void 0!==r.effectiveType&&(e.effectiveType=r.effectiveType),void 0!==r.downlink&&(e.downlink=r.downlink),void 0!==r.rtt&&(e.rtt=r.rtt),void 0!==r.saveData&&(e.saveData=r.saveData),void 0!==r.type&&(e.connectionType=r.type)),e}function i(e,r){try{var n=e()}catch(e){return r(e)}return n&&n.then?n.then(void 0,r):n}exports.useClipboard=function(r){void 0===r&&(r={});var n=r.resetDelay,t=void 0===n?2e3:n,o=e.useState(!1),a=o[0],u=o[1],c=e.useState(null),s=c[0],f=c[1],v=e.useCallback(function(){u(!1),f(null)},[]);return{copy:e.useCallback(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var r=new Error("Clipboard API is not available");return f(r),Promise.resolve(!1)}return Promise.resolve(i(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return u(!0),t>0&&setTimeout(function(){return u(!1)},t),!0})},function(e){var r=e instanceof Error?e:new Error(String(e));return f(r),!1}))}catch(e){return Promise.reject(e)}},[t]),paste:e.useCallback(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(i(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var r=e instanceof Error?e:new Error(String(e));return f(r),""}))}catch(e){return Promise.reject(e)}},[]),copied:a,error:s,reset:v}},exports.useEventBus=function(){return{emit:e.useCallback(function(e){var r=arguments,t=n.get(e);t&&t.forEach(function(e){return e.apply(void 0,[].slice.call(r,1))})},[]),on:e.useCallback(function(e,r){var t=n.get(e);return t||(t=new Set,n.set(e,t)),t.add(r),function(){t.delete(r),0===t.size&&n.delete(e)}},[])}},exports.useMutationObserver=function(r,n,t){e.useEffect(function(){var e=r.current;if(e){var o=new MutationObserver(n);return o.observe(e,t),function(){return o.disconnect()}}},[r,n,t])},exports.useNetworkState=function(){var r=e.useState(o),n=r[0],t=r[1];return e.useEffect(function(){if("undefined"!=typeof window){var e=function(){return t(o())};window.addEventListener("online",e),window.addEventListener("offline",e);var r=navigator.connection;return null!=r&&r.addEventListener&&r.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=r&&r.removeEventListener&&r.removeEventListener("change",e)}}},[]),n},exports.usePreferredTheme=function(){var r=e.useState(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),r=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":r.matches?"light":"no-preference"}),n=r[0],t=r[1];return e.useEffect(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),r=function(e){t(e.matches?"dark":"light")},n=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),r=window.matchMedia("(prefers-color-scheme: light)");t(e.matches?"dark":r.matches?"light":"no-preference")};e.addEventListener("change",r);var o=window.matchMedia("(prefers-color-scheme: light)");return o.addEventListener("change",n),function(){e.removeEventListener("change",r),o.removeEventListener("change",n)}}},[]),n},exports.useTransition=function(){var r=e.useState(!1),n=r[0],t=r[1];return[e.useCallback(function(e){t(!0),Promise.resolve().then(function(){e(),t(!1)})},[]),n]},exports.useWrappedChildren=function(n,o,i){return void 0===i&&(i="preserve"),e.useMemo(function(){if(!n)return n;var e=function(e){if(!r.isValidElement(e))return e;var n,a=e.props||{};n="override"===i?t({},a,o):t({},o,a);var u=null==a?void 0:a.style,c=null==o?void 0:o.style;return u&&c&&"object"==typeof u&&"object"==typeof c&&(n.style="override"===i?t({},u,c):t({},c,u)),r.cloneElement(e,n)};return Array.isArray(n)?n.map(e):e(n)},[n,o,i])};
+var e=require("preact/hooks"),n=require("preact"),r=new Map;function t(){return t=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)({}).hasOwnProperty.call(r,t)&&(e[t]=r[t])}return e},t.apply(null,arguments)}function i(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},n=navigator.connection;return n&&(void 0!==n.effectiveType&&(e.effectiveType=n.effectiveType),void 0!==n.downlink&&(e.downlink=n.downlink),void 0!==n.rtt&&(e.rtt=n.rtt),void 0!==n.saveData&&(e.saveData=n.saveData),void 0!==n.type&&(e.connectionType=n.type)),e}function o(e,n){try{var r=e()}catch(e){return n(e)}return r&&r.then?r.then(void 0,n):r}exports.useClipboard=function(n){void 0===n&&(n={});var r=n.resetDelay,t=void 0===r?2e3:r,i=e.useState(!1),a=i[0],u=i[1],c=e.useState(null),s=c[0],f=c[1],v=e.useCallback(function(){u(!1),f(null)},[]);return{copy:e.useCallback(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var n=new Error("Clipboard API is not available");return f(n),Promise.resolve(!1)}return Promise.resolve(o(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return u(!0),t>0&&setTimeout(function(){return u(!1)},t),!0})},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),!1}))}catch(e){return Promise.reject(e)}},[t]),paste:e.useCallback(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(o(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),""}))}catch(e){return Promise.reject(e)}},[]),copied:a,error:s,reset:v}},exports.useEventBus=function(){return{emit:e.useCallback(function(e){var n=arguments,t=r.get(e);t&&t.forEach(function(e){return e.apply(void 0,[].slice.call(n,1))})},[]),on:e.useCallback(function(e,n){var t=r.get(e);return t||(t=new Set,r.set(e,t)),t.add(n),function(){t.delete(n),0===t.size&&r.delete(e)}},[])}},exports.useMutationObserver=function(n,r,t){e.useEffect(function(){var e=n.current;if(e){var i=new MutationObserver(r);return i.observe(e,t),function(){return i.disconnect()}}},[n,r,t])},exports.useNetworkState=function(){var n=e.useState(i),r=n[0],t=n[1];return e.useEffect(function(){if("undefined"!=typeof window){var e=function(){return t(i())};window.addEventListener("online",e),window.addEventListener("offline",e);var n=navigator.connection;return null!=n&&n.addEventListener&&n.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=n&&n.removeEventListener&&n.removeEventListener("change",e)}}},[]),r},exports.usePreferredTheme=function(){var n=e.useState(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":n.matches?"light":"no-preference"}),r=n[0],t=n[1];return e.useEffect(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(e){t(e.matches?"dark":"light")},r=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");t(e.matches?"dark":n.matches?"light":"no-preference")};e.addEventListener("change",n);var i=window.matchMedia("(prefers-color-scheme: light)");return i.addEventListener("change",r),function(){e.removeEventListener("change",n),i.removeEventListener("change",r)}}},[]),r},exports.useRageClick=function(n,r){var t=r.onRageClick,i=r.threshold,o=void 0===i?5:i,a=r.timeWindow,u=void 0===a?1e3:a,c=r.distanceThreshold,s=void 0===c?30:c,f=e.useRef(t);f.current=t;var v=e.useRef([]);e.useEffect(function(){var e=n.current;if(e){var r=function(e){var n=Date.now(),r={time:n,x:e.clientX,y:e.clientY},t=n-u,i=v.current.filter(function(e){return e.time>=t});if(i.push(r),Infinity!==s){var a=i.filter(function(e){return n=e,t=r,Math.hypot(t.x-n.x,t.y-n.y)<=s;var n,t});if(a.length>=o)return f.current({count:a.length,event:e}),void(v.current=[])}else if(i.length>=o)return f.current({count:i.length,event:e}),void(v.current=[]);v.current=i};return e.addEventListener("click",r),function(){return e.removeEventListener("click",r)}}},[n,o,u,s])},exports.useTransition=function(){var n=e.useState(!1),r=n[0],t=n[1];return[e.useCallback(function(e){t(!0),Promise.resolve().then(function(){e(),t(!1)})},[]),r]},exports.useWrappedChildren=function(r,i,o){return void 0===o&&(o="preserve"),e.useMemo(function(){if(!r)return r;var e=function(e){if(!n.isValidElement(e))return e;var r,a=e.props||{};r="override"===o?t({},a,i):t({},i,a);var u=null==a?void 0:a.style,c=null==i?void 0:i.style;return u&&c&&"object"==typeof u&&"object"==typeof c&&(r.style="override"===o?t({},u,c):t({},c,u)),n.cloneElement(e,r)};return Array.isArray(r)?r.map(e):e(r)},[r,i,o])};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sources":["../src/useEventBus.ts","../src/useNetworkState.ts","../src/useClipboard.ts","../src/useMutationObserver.ts","../src/usePreferredTheme.ts","../src/useTransition.ts","../src/useWrappedChildren.ts"],"sourcesContent":["import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/*\r\n A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n /\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/* Network Information API (not in all browsers) /\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/* Effective connection type from Network Information API /\r\nexport type EffectiveConnectionType = 'slow-2g' \| '2g' \| '3g' \| '4g';\r\n\r\n/* Network connection type (e.g., wifi, cellular) /\r\nexport type ConnectionType =\r\n \| 'bluetooth'\r\n \| 'cellular'\r\n \| 'ethernet'\r\n \| 'mixed'\r\n \| 'none'\r\n \| 'other'\r\n \| 'unknown'\r\n \| 'wifi';\r\n\r\nexport interface NetworkState {\r\n /* Whether the browser is online /\r\n online: boolean;\r\n /* Effective connection type (when supported) /\r\n effectiveType?: EffectiveConnectionType;\r\n /* Estimated downlink speed in Mbps (when supported) /\r\n downlink?: number;\r\n /* Estimated round-trip time in ms (when supported) /\r\n rtt?: number;\r\n /* Whether the user has requested reduced data usage (when supported) /\r\n saveData?: boolean;\r\n /* Connection type (when supported) /\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/\r\n A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n \r\n @returns The current network state object\r\n \r\n @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /* Duration in ms to keep `copied` true before resetting. Default: 2000 /\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /* Copy text to the clipboard. Returns true on success. /\r\n copy: (text: string) => Promise<boolean>;\r\n /* Read text from the clipboard. Returns empty string if denied or unavailable. /\r\n paste: () => Promise<string>;\r\n /* Whether the last copy operation succeeded (resets after resetDelay) /\r\n copied: boolean;\r\n /* Error from the last failed operation, or null /\r\n error: Error \| null;\r\n /* Manually reset copied and error state /\r\n reset: () => void;\r\n}\r\n\r\n/\r\n A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n \r\n @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n \r\n @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error \| null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/\r\n A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n /\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' \| 'dark' \| 'no-preference';\r\n\r\n/\r\n A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n \r\n @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n \r\n @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import { useState, useCallback } from 'preact/hooks';\r\n\r\n/\r\n Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n /\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/\r\n A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' \| 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n */\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' \| 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props \|\| {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}"],"names":["listeners","Map","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","options","_options$resetDelay","resetDelay","_useState","useState","copied","setCopied","_useState2","error","setError","reset","useCallback","copy","text","clipboard","err","Error","Promise","resolve","_catch","writeText","then","setTimeout","e","String","reject","paste","readText","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","targetRef","callback","useEffect","node","current","observer","MutationObserver","observe","disconnect","setState","window","updateState","addEventListener","removeEventListener","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","updateTheme","isPending","setIsPending","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map"],"mappings":"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"}
1	+ {"version":3,"file":"index.js","sources":["../src/useEventBus.ts","../src/useNetworkState.ts","../src/useClipboard.ts","../src/useMutationObserver.ts","../src/usePreferredTheme.ts","../src/useRageClick.ts","../src/useTransition.ts","../src/useWrappedChildren.ts"],"sourcesContent":["import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/*\r\n A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n /\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/* Network Information API (not in all browsers) /\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/* Effective connection type from Network Information API /\r\nexport type EffectiveConnectionType = 'slow-2g' \| '2g' \| '3g' \| '4g';\r\n\r\n/* Network connection type (e.g., wifi, cellular) /\r\nexport type ConnectionType =\r\n \| 'bluetooth'\r\n \| 'cellular'\r\n \| 'ethernet'\r\n \| 'mixed'\r\n \| 'none'\r\n \| 'other'\r\n \| 'unknown'\r\n \| 'wifi';\r\n\r\nexport interface NetworkState {\r\n /* Whether the browser is online /\r\n online: boolean;\r\n /* Effective connection type (when supported) /\r\n effectiveType?: EffectiveConnectionType;\r\n /* Estimated downlink speed in Mbps (when supported) /\r\n downlink?: number;\r\n /* Estimated round-trip time in ms (when supported) /\r\n rtt?: number;\r\n /* Whether the user has requested reduced data usage (when supported) /\r\n saveData?: boolean;\r\n /* Connection type (when supported) /\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/\r\n A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n \r\n @returns The current network state object\r\n \r\n @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /* Duration in ms to keep `copied` true before resetting. Default: 2000 /\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /* Copy text to the clipboard. Returns true on success. /\r\n copy: (text: string) => Promise<boolean>;\r\n /* Read text from the clipboard. Returns empty string if denied or unavailable. /\r\n paste: () => Promise<string>;\r\n /* Whether the last copy operation succeeded (resets after resetDelay) /\r\n copied: boolean;\r\n /* Error from the last failed operation, or null /\r\n error: Error \| null;\r\n /* Manually reset copied and error state /\r\n reset: () => void;\r\n}\r\n\r\n/\r\n A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n \r\n @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n \r\n @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error \| null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/\r\n A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n /\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' \| 'dark' \| 'no-preference';\r\n\r\n/\r\n A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n \r\n @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n \r\n @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import type { RefObject } from 'preact'\r\nimport { useEffect, useRef } from 'preact/hooks'\r\n\r\nexport interface RageClickPayload {\r\n /* Number of clicks that triggered the rage click /\r\n count: number\r\n /* Last click event (e.g. for Sentry context) /\r\n event: MouseEvent\r\n}\r\n\r\nexport interface UseRageClickOptions {\r\n /* Called when a rage click is detected. Use this to report to Sentry or your error tracker. /\r\n onRageClick: (payload: RageClickPayload) => void\r\n /* Minimum number of clicks in the time window to count as rage click. Default: 5 (Sentry-style). /\r\n threshold?: number\r\n /* Time window in ms. Default: 1000. /\r\n timeWindow?: number\r\n /* Max distance in px between clicks to count as same spot. Default: 30. Set to Infinity to ignore distance. /\r\n distanceThreshold?: number\r\n}\r\n\r\ninterface ClickRecord {\r\n time: number\r\n x: number\r\n y: number\r\n}\r\n\r\nfunction distance(a: ClickRecord, b: ClickRecord): number {\r\n return Math.hypot(b.x - a.x, b.y - a.y)\r\n}\r\n\r\n/\r\n Detects \"rage clicks\" (repeated rapid clicks in the same area), e.g. when the UI\r\n * is unresponsive. Use the callback to report to Sentry or similar tools to surface\r\n * rage click issues and lower rage-click-related support.\r\n \r\n @param targetRef - Ref of the element to monitor (e.g. a button or card).\r\n * @param options - onRageClick callback and optional threshold, timeWindow, distanceThreshold.\r\n \r\n @example\r\n * ```tsx\r\n * const ref = useRef<HTMLButtonElement>(null)\r\n * useRageClick(ref, {\r\n * onRageClick: ({ count, event }) => {\r\n * Sentry.captureMessage('Rage click detected', { extra: { count, target: event.target } })\r\n * },\r\n * })\r\n * return <button ref={ref}>Submit</button>\r\n * ```\r\n /\r\nexport function useRageClick(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n options: UseRageClickOptions\r\n) {\r\n const {\r\n onRageClick,\r\n threshold = 5,\r\n timeWindow = 1000,\r\n distanceThreshold = 30,\r\n } = options\r\n\r\n const onRageClickRef = useRef(onRageClick)\r\n onRageClickRef.current = onRageClick\r\n\r\n const clicksRef = useRef<ClickRecord[]>([])\r\n\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const handleClick = (e: MouseEvent) => {\r\n const now = Date.now()\r\n const record: ClickRecord = { time: now, x: e.clientX, y: e.clientY }\r\n\r\n const clicks = clicksRef.current\r\n const cutoff = now - timeWindow\r\n const recent = clicks.filter((c) => c.time >= cutoff)\r\n recent.push(record)\r\n\r\n if (distanceThreshold !== Infinity) {\r\n const inRange = recent.filter(\r\n (c) => distance(c, record) <= distanceThreshold\r\n )\r\n if (inRange.length >= threshold) {\r\n onRageClickRef.current({ count: inRange.length, event: e })\r\n clicksRef.current = []\r\n return\r\n }\r\n } else {\r\n if (recent.length >= threshold) {\r\n onRageClickRef.current({ count: recent.length, event: e })\r\n clicksRef.current = []\r\n return\r\n }\r\n }\r\n\r\n clicksRef.current = recent\r\n }\r\n\r\n node.addEventListener('click', handleClick)\r\n return () => node.removeEventListener('click', handleClick)\r\n }, [targetRef, threshold, timeWindow, distanceThreshold])\r\n}\r\n","import { useState, useCallback } from 'preact/hooks';\r\n\r\n/\r\n Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n /\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/\r\n A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' \| 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n */\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' \| 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props \|\| {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}"],"names":["listeners","Map","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","options","_options$resetDelay","resetDelay","_useState","useState","copied","setCopied","_useState2","error","setError","reset","useCallback","copy","text","clipboard","err","Error","Promise","resolve","_catch","writeText","then","setTimeout","e","String","reject","paste","readText","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","targetRef","callback","useEffect","node","current","observer","MutationObserver","observe","disconnect","setState","window","updateState","addEventListener","removeEventListener","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","updateTheme","onRageClick","_options$threshold","threshold","_options$timeWindow","timeWindow","_options$distanceThre","distanceThreshold","onRageClickRef","useRef","clicksRef","handleClick","now","Date","record","time","x","clientX","y","clientY","cutoff","recent","filter","c","push","Infinity","inRange","a","b","Math","hypot","length","count","isPending","setIsPending","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map"],"mappings":"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"}

package/dist/index.module.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{useState as e,useCallback as n,useEffect as r,useMemo as t}from"preact/hooks";import{isValidElement as o,cloneElement as i}from"preact";function a(){var r=e(!1),t=r[0],o=r[1];return[n(function(e){o(!0),Promise.resolve().then(function(){e(),o(!1)})},[]),t]}function c(e,n,t){r(function(){var r=e.current;if(r){var o=new MutationObserver(n);return o.observe(r,t),function(){return o.disconnect()}}},[e,n,t])}var u=new Map;function v(){var e=n(function(e){var n=arguments,r=u.get(e);r&&r.forEach(function(e){return e.apply(void 0,[].slice.call(n,1))})},[]);return{emit:e,on:n(function(e,n){var r=u.get(e);return r||(r=new Set,u.set(e,r)),r.add(n),function(){r.delete(n),0===r.size&&u.delete(e)}},[])}}function f(){return f=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)({}).hasOwnProperty.call(r,t)&&(e[t]=r[t])}return e},f.apply(null,arguments)}function d(e,n,r){return void 0===r&&(r="preserve"),t(function(){if(!e)return e;var t=function(e){if(!o(e))return e;var t,a=e.props||{};t="override"===r?f({},a,n):f({},n,a);var c=null==a?void 0:a.style,u=null==n?void 0:n.style;return c&&u&&"object"==typeof c&&"object"==typeof u&&(t.style="override"===r?f({},c,u):f({},u,c)),i(e,t)};return Array.isArray(e)?e.map(t):t(e)},[e,n,r])}function s(){var n=e(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":n.matches?"light":"no-preference"}),t=n[0],o=n[1];return r(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(e){o(e.matches?"dark":"light")},r=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");o(e.matches?"dark":n.matches?"light":"no-preference")};e.addEventListener("change",n);var t=window.matchMedia("(prefers-color-scheme: light)");return t.addEventListener("change",r),function(){e.removeEventListener("change",n),t.removeEventListener("change",r)}}},[]),t}function l(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},n=navigator.connection;return n&&(void 0!==n.effectiveType&&(e.effectiveType=n.effectiveType),void 0!==n.downlink&&(e.downlink=n.downlink),void 0!==n.rtt&&(e.rtt=n.rtt),void 0!==n.saveData&&(e.saveData=n.saveData),void 0!==n.type&&(e.connectionType=n.type)),e}function p(){var n=e(l),t=n[0],o=n[1];return r(function(){if("undefined"!=typeof window){var e=function(){return o(l())};window.addEventListener("online",e),window.addEventListener("offline",e);var n=navigator.connection;return null!=n&&n.addEventListener&&n.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=n&&n.removeEventListener&&n.removeEventListener("change",e)}}},[]),t}function h(e,n){try{var r=e()}catch(e){return n(e)}return r&&r.then?r.then(void 0,n):r}function m(r){void 0===r&&(r={});var t=r.resetDelay,o=void 0===t?2e3:t,i=e(!1),a=i[0],c=i[1],u=e(null),v=u[0],f=u[1],d=n(function(){c(!1),f(null)},[]);return{copy:n(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var n=new Error("Clipboard API is not available");return f(n),Promise.resolve(!1)}return Promise.resolve(h(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return c(!0),o>0&&setTimeout(function(){return c(!1)},o),!0})},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),!1}))}catch(e){return Promise.reject(e)}},[o]),paste:n(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(h(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),""}))}catch(e){return Promise.reject(e)}},[]),copied:a,error:v,reset:d}}export{m as useClipboard,v as useEventBus,c as useMutationObserver,p as useNetworkState,s as usePreferredTheme,a as useTransition,d as useWrappedChildren};
+import{useState as e,useCallback as n,useEffect as r,useMemo as t,useRef as i}from"preact/hooks";import{isValidElement as o,cloneElement as a}from"preact";function c(){var r=e(!1),t=r[0],i=r[1];return[n(function(e){i(!0),Promise.resolve().then(function(){e(),i(!1)})},[]),t]}function u(e,n,t){r(function(){var r=e.current;if(r){var i=new MutationObserver(n);return i.observe(r,t),function(){return i.disconnect()}}},[e,n,t])}var v=new Map;function f(){var e=n(function(e){var n=arguments,r=v.get(e);r&&r.forEach(function(e){return e.apply(void 0,[].slice.call(n,1))})},[]);return{emit:e,on:n(function(e,n){var r=v.get(e);return r||(r=new Set,v.set(e,r)),r.add(n),function(){r.delete(n),0===r.size&&v.delete(e)}},[])}}function d(){return d=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)({}).hasOwnProperty.call(r,t)&&(e[t]=r[t])}return e},d.apply(null,arguments)}function l(e,n,r){return void 0===r&&(r="preserve"),t(function(){if(!e)return e;var t=function(e){if(!o(e))return e;var t,i=e.props||{};t="override"===r?d({},i,n):d({},n,i);var c=null==i?void 0:i.style,u=null==n?void 0:n.style;return c&&u&&"object"==typeof c&&"object"==typeof u&&(t.style="override"===r?d({},c,u):d({},u,c)),a(e,t)};return Array.isArray(e)?e.map(t):t(e)},[e,n,r])}function s(){var n=e(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":n.matches?"light":"no-preference"}),t=n[0],i=n[1];return r(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(e){i(e.matches?"dark":"light")},r=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");i(e.matches?"dark":n.matches?"light":"no-preference")};e.addEventListener("change",n);var t=window.matchMedia("(prefers-color-scheme: light)");return t.addEventListener("change",r),function(){e.removeEventListener("change",n),t.removeEventListener("change",r)}}},[]),t}function h(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},n=navigator.connection;return n&&(void 0!==n.effectiveType&&(e.effectiveType=n.effectiveType),void 0!==n.downlink&&(e.downlink=n.downlink),void 0!==n.rtt&&(e.rtt=n.rtt),void 0!==n.saveData&&(e.saveData=n.saveData),void 0!==n.type&&(e.connectionType=n.type)),e}function p(){var n=e(h),t=n[0],i=n[1];return r(function(){if("undefined"!=typeof window){var e=function(){return i(h())};window.addEventListener("online",e),window.addEventListener("offline",e);var n=navigator.connection;return null!=n&&n.addEventListener&&n.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=n&&n.removeEventListener&&n.removeEventListener("change",e)}}},[]),t}function m(e,n){try{var r=e()}catch(e){return n(e)}return r&&r.then?r.then(void 0,n):r}function w(r){void 0===r&&(r={});var t=r.resetDelay,i=void 0===t?2e3:t,o=e(!1),a=o[0],c=o[1],u=e(null),v=u[0],f=u[1],d=n(function(){c(!1),f(null)},[]);return{copy:n(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var n=new Error("Clipboard API is not available");return f(n),Promise.resolve(!1)}return Promise.resolve(m(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return c(!0),i>0&&setTimeout(function(){return c(!1)},i),!0})},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),!1}))}catch(e){return Promise.reject(e)}},[i]),paste:n(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(m(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),""}))}catch(e){return Promise.reject(e)}},[]),copied:a,error:v,reset:d}}function g(e,n){var t=n.onRageClick,o=n.threshold,a=void 0===o?5:o,c=n.timeWindow,u=void 0===c?1e3:c,v=n.distanceThreshold,f=void 0===v?30:v,d=i(t);d.current=t;var l=i([]);r(function(){var n=e.current;if(n){var r=function(e){var n=Date.now(),r={time:n,x:e.clientX,y:e.clientY},t=n-u,i=l.current.filter(function(e){return e.time>=t});if(i.push(r),Infinity!==f){var o=i.filter(function(e){return n=e,t=r,Math.hypot(t.x-n.x,t.y-n.y)<=f;var n,t});if(o.length>=a)return d.current({count:o.length,event:e}),void(l.current=[])}else if(i.length>=a)return d.current({count:i.length,event:e}),void(l.current=[]);l.current=i};return n.addEventListener("click",r),function(){return n.removeEventListener("click",r)}}},[e,a,u,f])}export{w as useClipboard,f as useEventBus,u as useMutationObserver,p as useNetworkState,s as usePreferredTheme,g as useRageClick,c as useTransition,l as useWrappedChildren};
 //# sourceMappingURL=index.module.js.map

package/dist/index.module.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.module.js","sources":["../src/useTransition.ts","../src/useMutationObserver.ts","../src/useEventBus.ts","../src/useWrappedChildren.ts","../src/usePreferredTheme.ts","../src/useNetworkState.ts","../src/useClipboard.ts"],"sourcesContent":["import { useState, useCallback } from 'preact/hooks';\r\n\r\n/*\r\n Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n /\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/\r\n A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n /\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/\r\n A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n /\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/\r\n A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' \| 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n /\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' \| 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props \|\| {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' \| 'dark' \| 'no-preference';\r\n\r\n/\r\n A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n \r\n @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n \r\n @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/* Network Information API (not in all browsers) /\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/* Effective connection type from Network Information API /\r\nexport type EffectiveConnectionType = 'slow-2g' \| '2g' \| '3g' \| '4g';\r\n\r\n/* Network connection type (e.g., wifi, cellular) /\r\nexport type ConnectionType =\r\n \| 'bluetooth'\r\n \| 'cellular'\r\n \| 'ethernet'\r\n \| 'mixed'\r\n \| 'none'\r\n \| 'other'\r\n \| 'unknown'\r\n \| 'wifi';\r\n\r\nexport interface NetworkState {\r\n /* Whether the browser is online /\r\n online: boolean;\r\n /* Effective connection type (when supported) /\r\n effectiveType?: EffectiveConnectionType;\r\n /* Estimated downlink speed in Mbps (when supported) /\r\n downlink?: number;\r\n /* Estimated round-trip time in ms (when supported) /\r\n rtt?: number;\r\n /* Whether the user has requested reduced data usage (when supported) /\r\n saveData?: boolean;\r\n /* Connection type (when supported) /\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/\r\n A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n \r\n @returns The current network state object\r\n \r\n @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /* Duration in ms to keep `copied` true before resetting. Default: 2000 /\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /* Copy text to the clipboard. Returns true on success. /\r\n copy: (text: string) => Promise<boolean>;\r\n /* Read text from the clipboard. Returns empty string if denied or unavailable. /\r\n paste: () => Promise<string>;\r\n /* Whether the last copy operation succeeded (resets after resetDelay) /\r\n copied: boolean;\r\n /* Error from the last failed operation, or null /\r\n error: Error \| null;\r\n /* Manually reset copied and error state /\r\n reset: () => void;\r\n}\r\n\r\n/\r\n A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n \r\n @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n \r\n @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error \| null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n"],"names":["useTransition","_useState","useState","isPending","setIsPending","useCallback","callback","Promise","resolve","then","useMutationObserver","targetRef","options","useEffect","node","current","observer","MutationObserver","observe","disconnect","listeners","Map","useEventBus","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","useWrappedChildren","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map","usePreferredTheme","window","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","e","updateTheme","addEventListener","removeEventListener","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","useNetworkState","setState","updateState","useClipboard","_options$resetDelay","resetDelay","copied","setCopied","_useState2","error","setError","reset","copy","text","clipboard","err","Error","_catch","writeText","setTimeout","String","reject","paste","readText"],"mappings":"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"}
1	+ {"version":3,"file":"index.module.js","sources":["../src/useTransition.ts","../src/useMutationObserver.ts","../src/useEventBus.ts","../src/useWrappedChildren.ts","../src/usePreferredTheme.ts","../src/useNetworkState.ts","../src/useClipboard.ts","../src/useRageClick.ts"],"sourcesContent":["import { useState, useCallback } from 'preact/hooks';\r\n\r\n/*\r\n Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n /\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/\r\n A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n /\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/\r\n A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n /\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/\r\n A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' \| 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n /\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' \| 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props \|\| {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' \| 'dark' \| 'no-preference';\r\n\r\n/\r\n A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n \r\n @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n \r\n @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/* Network Information API (not in all browsers) /\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/* Effective connection type from Network Information API /\r\nexport type EffectiveConnectionType = 'slow-2g' \| '2g' \| '3g' \| '4g';\r\n\r\n/* Network connection type (e.g., wifi, cellular) /\r\nexport type ConnectionType =\r\n \| 'bluetooth'\r\n \| 'cellular'\r\n \| 'ethernet'\r\n \| 'mixed'\r\n \| 'none'\r\n \| 'other'\r\n \| 'unknown'\r\n \| 'wifi';\r\n\r\nexport interface NetworkState {\r\n /* Whether the browser is online /\r\n online: boolean;\r\n /* Effective connection type (when supported) /\r\n effectiveType?: EffectiveConnectionType;\r\n /* Estimated downlink speed in Mbps (when supported) /\r\n downlink?: number;\r\n /* Estimated round-trip time in ms (when supported) /\r\n rtt?: number;\r\n /* Whether the user has requested reduced data usage (when supported) /\r\n saveData?: boolean;\r\n /* Connection type (when supported) /\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/\r\n A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n \r\n @returns The current network state object\r\n \r\n @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /* Duration in ms to keep `copied` true before resetting. Default: 2000 /\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /* Copy text to the clipboard. Returns true on success. /\r\n copy: (text: string) => Promise<boolean>;\r\n /* Read text from the clipboard. Returns empty string if denied or unavailable. /\r\n paste: () => Promise<string>;\r\n /* Whether the last copy operation succeeded (resets after resetDelay) /\r\n copied: boolean;\r\n /* Error from the last failed operation, or null /\r\n error: Error \| null;\r\n /* Manually reset copied and error state /\r\n reset: () => void;\r\n}\r\n\r\n/\r\n A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n \r\n @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n \r\n @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error \| null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n","import type { RefObject } from 'preact'\r\nimport { useEffect, useRef } from 'preact/hooks'\r\n\r\nexport interface RageClickPayload {\r\n /* Number of clicks that triggered the rage click /\r\n count: number\r\n /* Last click event (e.g. for Sentry context) /\r\n event: MouseEvent\r\n}\r\n\r\nexport interface UseRageClickOptions {\r\n /* Called when a rage click is detected. Use this to report to Sentry or your error tracker. /\r\n onRageClick: (payload: RageClickPayload) => void\r\n /* Minimum number of clicks in the time window to count as rage click. Default: 5 (Sentry-style). /\r\n threshold?: number\r\n /* Time window in ms. Default: 1000. /\r\n timeWindow?: number\r\n /* Max distance in px between clicks to count as same spot. Default: 30. Set to Infinity to ignore distance. /\r\n distanceThreshold?: number\r\n}\r\n\r\ninterface ClickRecord {\r\n time: number\r\n x: number\r\n y: number\r\n}\r\n\r\nfunction distance(a: ClickRecord, b: ClickRecord): number {\r\n return Math.hypot(b.x - a.x, b.y - a.y)\r\n}\r\n\r\n/\r\n Detects \"rage clicks\" (repeated rapid clicks in the same area), e.g. when the UI\r\n * is unresponsive. Use the callback to report to Sentry or similar tools to surface\r\n * rage click issues and lower rage-click-related support.\r\n \r\n @param targetRef - Ref of the element to monitor (e.g. a button or card).\r\n * @param options - onRageClick callback and optional threshold, timeWindow, distanceThreshold.\r\n \r\n @example\r\n * ```tsx\r\n * const ref = useRef<HTMLButtonElement>(null)\r\n * useRageClick(ref, {\r\n * onRageClick: ({ count, event }) => {\r\n * Sentry.captureMessage('Rage click detected', { extra: { count, target: event.target } })\r\n * },\r\n * })\r\n * return <button ref={ref}>Submit</button>\r\n * ```\r\n */\r\nexport function useRageClick(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n options: UseRageClickOptions\r\n) {\r\n const {\r\n onRageClick,\r\n threshold = 5,\r\n timeWindow = 1000,\r\n distanceThreshold = 30,\r\n } = options\r\n\r\n const onRageClickRef = useRef(onRageClick)\r\n onRageClickRef.current = onRageClick\r\n\r\n const clicksRef = useRef<ClickRecord[]>([])\r\n\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const handleClick = (e: MouseEvent) => {\r\n const now = Date.now()\r\n const record: ClickRecord = { time: now, x: e.clientX, y: e.clientY }\r\n\r\n const clicks = clicksRef.current\r\n const cutoff = now - timeWindow\r\n const recent = clicks.filter((c) => c.time >= cutoff)\r\n recent.push(record)\r\n\r\n if (distanceThreshold !== Infinity) {\r\n const inRange = recent.filter(\r\n (c) => distance(c, record) <= distanceThreshold\r\n )\r\n if (inRange.length >= threshold) {\r\n onRageClickRef.current({ count: inRange.length, event: e })\r\n clicksRef.current = []\r\n return\r\n }\r\n } else {\r\n if (recent.length >= threshold) {\r\n onRageClickRef.current({ count: recent.length, event: e })\r\n clicksRef.current = []\r\n return\r\n }\r\n }\r\n\r\n clicksRef.current = recent\r\n }\r\n\r\n node.addEventListener('click', handleClick)\r\n return () => node.removeEventListener('click', handleClick)\r\n }, [targetRef, threshold, timeWindow, distanceThreshold])\r\n}\r\n"],"names":["useTransition","_useState","useState","isPending","setIsPending","useCallback","callback","Promise","resolve","then","useMutationObserver","targetRef","options","useEffect","node","current","observer","MutationObserver","observe","disconnect","listeners","Map","useEventBus","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","useWrappedChildren","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map","usePreferredTheme","window","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","e","updateTheme","addEventListener","removeEventListener","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","useNetworkState","setState","updateState","useClipboard","_options$resetDelay","resetDelay","copied","setCopied","_useState2","error","setError","reset","copy","text","clipboard","err","Error","_catch","writeText","setTimeout","String","reject","paste","readText","useRageClick","onRageClick","_options$threshold","threshold","_options$timeWindow","timeWindow","_options$distanceThre","distanceThreshold","onRageClickRef","useRef","clicksRef","handleClick","now","Date","record","time","x","clientX","y","clientY","cutoff","recent","filter","c","push","Infinity","inRange","a","b","Math","hypot","length","count"],"mappings":"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"}

package/dist/index.umd.js CHANGED Viewed

@@ -1,2 +1,2 @@
-!function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports,require("preact/hooks"),require("preact")):"function"==typeof define&&define.amd?define(["exports","preact/hooks","preact"],n):n((e||self).preactMissingHooks={},e.hooks,e.preact)}(this,function(e,n,r){var t=new Map;function o(){return o=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)({}).hasOwnProperty.call(r,t)&&(e[t]=r[t])}return e},o.apply(null,arguments)}function i(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},n=navigator.connection;return n&&(void 0!==n.effectiveType&&(e.effectiveType=n.effectiveType),void 0!==n.downlink&&(e.downlink=n.downlink),void 0!==n.rtt&&(e.rtt=n.rtt),void 0!==n.saveData&&(e.saveData=n.saveData),void 0!==n.type&&(e.connectionType=n.type)),e}function a(e,n){try{var r=e()}catch(e){return n(e)}return r&&r.then?r.then(void 0,n):r}e.useClipboard=function(e){void 0===e&&(e={});var r=e.resetDelay,t=void 0===r?2e3:r,o=n.useState(!1),i=o[0],c=o[1],u=n.useState(null),s=u[0],f=u[1],d=n.useCallback(function(){c(!1),f(null)},[]);return{copy:n.useCallback(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var n=new Error("Clipboard API is not available");return f(n),Promise.resolve(!1)}return Promise.resolve(a(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return c(!0),t>0&&setTimeout(function(){return c(!1)},t),!0})},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),!1}))}catch(e){return Promise.reject(e)}},[t]),paste:n.useCallback(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(a(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),""}))}catch(e){return Promise.reject(e)}},[]),copied:i,error:s,reset:d}},e.useEventBus=function(){var e=n.useCallback(function(e){var n=arguments,r=t.get(e);r&&r.forEach(function(e){return e.apply(void 0,[].slice.call(n,1))})},[]);return{emit:e,on:n.useCallback(function(e,n){var r=t.get(e);return r||(r=new Set,t.set(e,r)),r.add(n),function(){r.delete(n),0===r.size&&t.delete(e)}},[])}},e.useMutationObserver=function(e,r,t){n.useEffect(function(){var n=e.current;if(n){var o=new MutationObserver(r);return o.observe(n,t),function(){return o.disconnect()}}},[e,r,t])},e.useNetworkState=function(){var e=n.useState(i),r=e[0],t=e[1];return n.useEffect(function(){if("undefined"!=typeof window){var e=function(){return t(i())};window.addEventListener("online",e),window.addEventListener("offline",e);var n=navigator.connection;return null!=n&&n.addEventListener&&n.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=n&&n.removeEventListener&&n.removeEventListener("change",e)}}},[]),r},e.usePreferredTheme=function(){var e=n.useState(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":n.matches?"light":"no-preference"}),r=e[0],t=e[1];return n.useEffect(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(e){t(e.matches?"dark":"light")},r=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");t(e.matches?"dark":n.matches?"light":"no-preference")};e.addEventListener("change",n);var o=window.matchMedia("(prefers-color-scheme: light)");return o.addEventListener("change",r),function(){e.removeEventListener("change",n),o.removeEventListener("change",r)}}},[]),r},e.useTransition=function(){var e=n.useState(!1),r=e[0],t=e[1];return[n.useCallback(function(e){t(!0),Promise.resolve().then(function(){e(),t(!1)})},[]),r]},e.useWrappedChildren=function(e,t,i){return void 0===i&&(i="preserve"),n.useMemo(function(){if(!e)return e;var n=function(e){if(!r.isValidElement(e))return e;var n,a=e.props||{};n="override"===i?o({},a,t):o({},t,a);var c=null==a?void 0:a.style,u=null==t?void 0:t.style;return c&&u&&"object"==typeof c&&"object"==typeof u&&(n.style="override"===i?o({},c,u):o({},u,c)),r.cloneElement(e,n)};return Array.isArray(e)?e.map(n):n(e)},[e,t,i])}});
+!function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports,require("preact/hooks"),require("preact")):"function"==typeof define&&define.amd?define(["exports","preact/hooks","preact"],n):n((e||self).preactMissingHooks={},e.hooks,e.preact)}(this,function(e,n,r){var t=new Map;function i(){return i=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)({}).hasOwnProperty.call(r,t)&&(e[t]=r[t])}return e},i.apply(null,arguments)}function o(){if("undefined"==typeof navigator)return{online:!0};var e={online:navigator.onLine},n=navigator.connection;return n&&(void 0!==n.effectiveType&&(e.effectiveType=n.effectiveType),void 0!==n.downlink&&(e.downlink=n.downlink),void 0!==n.rtt&&(e.rtt=n.rtt),void 0!==n.saveData&&(e.saveData=n.saveData),void 0!==n.type&&(e.connectionType=n.type)),e}function a(e,n){try{var r=e()}catch(e){return n(e)}return r&&r.then?r.then(void 0,n):r}e.useClipboard=function(e){void 0===e&&(e={});var r=e.resetDelay,t=void 0===r?2e3:r,i=n.useState(!1),o=i[0],c=i[1],u=n.useState(null),s=u[0],f=u[1],l=n.useCallback(function(){c(!1),f(null)},[]);return{copy:n.useCallback(function(e){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var n=new Error("Clipboard API is not available");return f(n),Promise.resolve(!1)}return Promise.resolve(a(function(){return Promise.resolve(navigator.clipboard.writeText(e)).then(function(){return c(!0),t>0&&setTimeout(function(){return c(!1)},t),!0})},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),!1}))}catch(e){return Promise.reject(e)}},[t]),paste:n.useCallback(function(){try{if(f(null),"undefined"==typeof navigator||!navigator.clipboard){var e=new Error("Clipboard API is not available");return f(e),Promise.resolve("")}return Promise.resolve(a(function(){return Promise.resolve(navigator.clipboard.readText())},function(e){var n=e instanceof Error?e:new Error(String(e));return f(n),""}))}catch(e){return Promise.reject(e)}},[]),copied:o,error:s,reset:l}},e.useEventBus=function(){var e=n.useCallback(function(e){var n=arguments,r=t.get(e);r&&r.forEach(function(e){return e.apply(void 0,[].slice.call(n,1))})},[]);return{emit:e,on:n.useCallback(function(e,n){var r=t.get(e);return r||(r=new Set,t.set(e,r)),r.add(n),function(){r.delete(n),0===r.size&&t.delete(e)}},[])}},e.useMutationObserver=function(e,r,t){n.useEffect(function(){var n=e.current;if(n){var i=new MutationObserver(r);return i.observe(n,t),function(){return i.disconnect()}}},[e,r,t])},e.useNetworkState=function(){var e=n.useState(o),r=e[0],t=e[1];return n.useEffect(function(){if("undefined"!=typeof window){var e=function(){return t(o())};window.addEventListener("online",e),window.addEventListener("offline",e);var n=navigator.connection;return null!=n&&n.addEventListener&&n.addEventListener("change",e),function(){window.removeEventListener("online",e),window.removeEventListener("offline",e),null!=n&&n.removeEventListener&&n.removeEventListener("change",e)}}},[]),r},e.usePreferredTheme=function(){var e=n.useState(function(){if("undefined"==typeof window)return"no-preference";var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");return e.matches?"dark":n.matches?"light":"no-preference"}),r=e[0],t=e[1];return n.useEffect(function(){if("undefined"!=typeof window){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=function(e){t(e.matches?"dark":"light")},r=function(){var e=window.matchMedia("(prefers-color-scheme: dark)"),n=window.matchMedia("(prefers-color-scheme: light)");t(e.matches?"dark":n.matches?"light":"no-preference")};e.addEventListener("change",n);var i=window.matchMedia("(prefers-color-scheme: light)");return i.addEventListener("change",r),function(){e.removeEventListener("change",n),i.removeEventListener("change",r)}}},[]),r},e.useRageClick=function(e,r){var t=r.onRageClick,i=r.threshold,o=void 0===i?5:i,a=r.timeWindow,c=void 0===a?1e3:a,u=r.distanceThreshold,s=void 0===u?30:u,f=n.useRef(t);f.current=t;var l=n.useRef([]);n.useEffect(function(){var n=e.current;if(n){var r=function(e){var n=Date.now(),r={time:n,x:e.clientX,y:e.clientY},t=n-c,i=l.current.filter(function(e){return e.time>=t});if(i.push(r),Infinity!==s){var a=i.filter(function(e){return n=e,t=r,Math.hypot(t.x-n.x,t.y-n.y)<=s;var n,t});if(a.length>=o)return f.current({count:a.length,event:e}),void(l.current=[])}else if(i.length>=o)return f.current({count:i.length,event:e}),void(l.current=[]);l.current=i};return n.addEventListener("click",r),function(){return n.removeEventListener("click",r)}}},[e,o,c,s])},e.useTransition=function(){var e=n.useState(!1),r=e[0],t=e[1];return[n.useCallback(function(e){t(!0),Promise.resolve().then(function(){e(),t(!1)})},[]),r]},e.useWrappedChildren=function(e,t,o){return void 0===o&&(o="preserve"),n.useMemo(function(){if(!e)return e;var n=function(e){if(!r.isValidElement(e))return e;var n,a=e.props||{};n="override"===o?i({},a,t):i({},t,a);var c=null==a?void 0:a.style,u=null==t?void 0:t.style;return c&&u&&"object"==typeof c&&"object"==typeof u&&(n.style="override"===o?i({},c,u):i({},u,c)),r.cloneElement(e,n)};return Array.isArray(e)?e.map(n):n(e)},[e,t,o])}});
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.umd.js","sources":["../src/useEventBus.ts","../src/useNetworkState.ts","../src/useClipboard.ts","../src/useMutationObserver.ts","../src/usePreferredTheme.ts","../src/useTransition.ts","../src/useWrappedChildren.ts"],"sourcesContent":["import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/*\r\n A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n /\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/* Network Information API (not in all browsers) /\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/* Effective connection type from Network Information API /\r\nexport type EffectiveConnectionType = 'slow-2g' \| '2g' \| '3g' \| '4g';\r\n\r\n/* Network connection type (e.g., wifi, cellular) /\r\nexport type ConnectionType =\r\n \| 'bluetooth'\r\n \| 'cellular'\r\n \| 'ethernet'\r\n \| 'mixed'\r\n \| 'none'\r\n \| 'other'\r\n \| 'unknown'\r\n \| 'wifi';\r\n\r\nexport interface NetworkState {\r\n /* Whether the browser is online /\r\n online: boolean;\r\n /* Effective connection type (when supported) /\r\n effectiveType?: EffectiveConnectionType;\r\n /* Estimated downlink speed in Mbps (when supported) /\r\n downlink?: number;\r\n /* Estimated round-trip time in ms (when supported) /\r\n rtt?: number;\r\n /* Whether the user has requested reduced data usage (when supported) /\r\n saveData?: boolean;\r\n /* Connection type (when supported) /\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/\r\n A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n \r\n @returns The current network state object\r\n \r\n @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /* Duration in ms to keep `copied` true before resetting. Default: 2000 /\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /* Copy text to the clipboard. Returns true on success. /\r\n copy: (text: string) => Promise<boolean>;\r\n /* Read text from the clipboard. Returns empty string if denied or unavailable. /\r\n paste: () => Promise<string>;\r\n /* Whether the last copy operation succeeded (resets after resetDelay) /\r\n copied: boolean;\r\n /* Error from the last failed operation, or null /\r\n error: Error \| null;\r\n /* Manually reset copied and error state /\r\n reset: () => void;\r\n}\r\n\r\n/\r\n A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n \r\n @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n \r\n @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error \| null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/\r\n A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n /\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' \| 'dark' \| 'no-preference';\r\n\r\n/\r\n A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n \r\n @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n \r\n @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import { useState, useCallback } from 'preact/hooks';\r\n\r\n/\r\n Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n /\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/\r\n A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' \| 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n */\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' \| 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props \|\| {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}"],"names":["listeners","Map","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","options","_options$resetDelay","resetDelay","_useState","useState","copied","setCopied","_useState2","error","setError","reset","useCallback","copy","text","clipboard","err","Error","Promise","resolve","_catch","writeText","then","setTimeout","e","String","reject","paste","readText","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","targetRef","callback","useEffect","node","current","observer","MutationObserver","observe","disconnect","setState","window","updateState","addEventListener","removeEventListener","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","updateTheme","isPending","setIsPending","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map"],"mappings":"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"}
1	+ {"version":3,"file":"index.umd.js","sources":["../src/useEventBus.ts","../src/useNetworkState.ts","../src/useClipboard.ts","../src/useMutationObserver.ts","../src/usePreferredTheme.ts","../src/useRageClick.ts","../src/useTransition.ts","../src/useWrappedChildren.ts"],"sourcesContent":["import { useCallback, useEffect } from 'preact/hooks';\r\n\r\ntype EventMap = Record<string, (...args: any[]) => void>;\r\n\r\nconst listeners = new Map<string, Set<(...args: any[]) => void>>();\r\n\r\n/*\r\n A Preact hook to publish and subscribe to custom events across components.\r\n * @returns An object with `emit` and `on` methods.\r\n /\r\nexport function useEventBus<T extends EventMap>() {\r\n const emit = useCallback(<K extends keyof T>(event: K, ...args: Parameters<T[K]>) => {\r\n const handlers = listeners.get(event as string);\r\n if (handlers) {\r\n handlers.forEach((handler) => handler(...args));\r\n }\r\n }, []);\r\n\r\n const on = useCallback(<K extends keyof T>(event: K, handler: T[K]) => {\r\n let handlers = listeners.get(event as string);\r\n if (!handlers) {\r\n handlers = new Set();\r\n listeners.set(event as string, handlers);\r\n }\r\n handlers.add(handler);\r\n\r\n return () => {\r\n handlers!.delete(handler);\r\n if (handlers!.size === 0) {\r\n listeners.delete(event as string);\r\n }\r\n };\r\n }, []);\r\n\r\n return { emit, on };\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\n/* Network Information API (not in all browsers) /\r\ninterface NetworkInformation extends EventTarget {\r\n effectiveType?: string;\r\n downlink?: number;\r\n rtt?: number;\r\n saveData?: boolean;\r\n type?: string;\r\n}\r\n\r\n/* Effective connection type from Network Information API /\r\nexport type EffectiveConnectionType = 'slow-2g' \| '2g' \| '3g' \| '4g';\r\n\r\n/* Network connection type (e.g., wifi, cellular) /\r\nexport type ConnectionType =\r\n \| 'bluetooth'\r\n \| 'cellular'\r\n \| 'ethernet'\r\n \| 'mixed'\r\n \| 'none'\r\n \| 'other'\r\n \| 'unknown'\r\n \| 'wifi';\r\n\r\nexport interface NetworkState {\r\n /* Whether the browser is online /\r\n online: boolean;\r\n /* Effective connection type (when supported) /\r\n effectiveType?: EffectiveConnectionType;\r\n /* Estimated downlink speed in Mbps (when supported) /\r\n downlink?: number;\r\n /* Estimated round-trip time in ms (when supported) /\r\n rtt?: number;\r\n /* Whether the user has requested reduced data usage (when supported) /\r\n saveData?: boolean;\r\n /* Connection type (when supported) /\r\n connectionType?: ConnectionType;\r\n}\r\n\r\nfunction getNetworkState(): NetworkState {\r\n if (typeof navigator === 'undefined') {\r\n return { online: true };\r\n }\r\n\r\n const state: NetworkState = {\r\n online: navigator.onLine,\r\n };\r\n\r\n const connection =\r\n (navigator as Navigator & { connection?: NetworkInformation }).connection;\r\n\r\n if (connection) {\r\n if (connection.effectiveType !== undefined) {\r\n state.effectiveType = connection.effectiveType as EffectiveConnectionType;\r\n }\r\n if (connection.downlink !== undefined) {\r\n state.downlink = connection.downlink;\r\n }\r\n if (connection.rtt !== undefined) {\r\n state.rtt = connection.rtt;\r\n }\r\n if (connection.saveData !== undefined) {\r\n state.saveData = connection.saveData;\r\n }\r\n if (connection.type !== undefined) {\r\n state.connectionType = connection.type as ConnectionType;\r\n }\r\n }\r\n\r\n return state;\r\n}\r\n\r\n/\r\n A Preact hook that returns the current network state, including online/offline\r\n * status and (when supported) connection type, downlink, RTT, and save-data preference.\r\n * Updates reactively when the network state changes.\r\n \r\n @returns The current network state object\r\n \r\n @example\r\n * ```tsx\r\n * function NetworkStatus() {\r\n * const { online, effectiveType, saveData } = useNetworkState();\r\n * return (\r\n * <div>\r\n * Status: {online ? 'Online' : 'Offline'}\r\n * {effectiveType && ` (${effectiveType})`}\r\n * {saveData && ' - Reduced data mode'}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useNetworkState(): NetworkState {\r\n const [state, setState] = useState<NetworkState>(getNetworkState);\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const updateState = () => setState(getNetworkState());\r\n\r\n window.addEventListener('online', updateState);\r\n window.addEventListener('offline', updateState);\r\n\r\n const connection = (navigator as Navigator & { connection?: NetworkInformation })\r\n .connection;\r\n if (connection?.addEventListener) {\r\n connection.addEventListener('change', updateState);\r\n }\r\n\r\n return () => {\r\n window.removeEventListener('online', updateState);\r\n window.removeEventListener('offline', updateState);\r\n if (connection?.removeEventListener) {\r\n connection.removeEventListener('change', updateState);\r\n }\r\n };\r\n }, []);\r\n\r\n return state;\r\n}\r\n","import { useCallback, useState } from 'preact/hooks';\r\n\r\nexport interface UseClipboardOptions {\r\n /* Duration in ms to keep `copied` true before resetting. Default: 2000 /\r\n resetDelay?: number;\r\n}\r\n\r\nexport interface UseClipboardReturn {\r\n /* Copy text to the clipboard. Returns true on success. /\r\n copy: (text: string) => Promise<boolean>;\r\n /* Read text from the clipboard. Returns empty string if denied or unavailable. /\r\n paste: () => Promise<string>;\r\n /* Whether the last copy operation succeeded (resets after resetDelay) /\r\n copied: boolean;\r\n /* Error from the last failed operation, or null /\r\n error: Error \| null;\r\n /* Manually reset copied and error state /\r\n reset: () => void;\r\n}\r\n\r\n/\r\n A Preact hook for reading and writing the clipboard. Uses the async\r\n * Clipboard API when available (requires secure context and user gesture).\r\n \r\n @param options - Optional configuration (e.g., resetDelay for copied state)\r\n * @returns Object with copy, paste, copied, error, and reset\r\n \r\n @example\r\n * ```tsx\r\n * function CopyButton() {\r\n * const { copy, copied, error } = useClipboard();\r\n * return (\r\n * <button onClick={() => copy('Hello!')}>\r\n * {copied ? 'Copied!' : 'Copy'}\r\n * </button>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\r\n const { resetDelay = 2000 } = options;\r\n\r\n const [copied, setCopied] = useState(false);\r\n const [error, setError] = useState<Error \| null>(null);\r\n\r\n const reset = useCallback(() => {\r\n setCopied(false);\r\n setError(null);\r\n }, []);\r\n\r\n const copy = useCallback(\r\n async (text: string): Promise<boolean> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return false;\r\n }\r\n\r\n try {\r\n await navigator.clipboard.writeText(text);\r\n setCopied(true);\r\n if (resetDelay > 0) {\r\n setTimeout(() => setCopied(false), resetDelay);\r\n }\r\n return true;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return false;\r\n }\r\n },\r\n [resetDelay]\r\n );\r\n\r\n const paste = useCallback(async (): Promise<string> => {\r\n setError(null);\r\n\r\n if (typeof navigator === 'undefined' \|\| !navigator.clipboard) {\r\n const err = new Error('Clipboard API is not available');\r\n setError(err);\r\n return '';\r\n }\r\n\r\n try {\r\n const text = await navigator.clipboard.readText();\r\n return text;\r\n } catch (e) {\r\n const err = e instanceof Error ? e : new Error(String(e));\r\n setError(err);\r\n return '';\r\n }\r\n }, []);\r\n\r\n return { copy, paste, copied, error, reset };\r\n}\r\n","import { RefObject } from 'preact'\r\nimport { useEffect } from 'preact/hooks'\r\n\r\nexport type UseMutationObserverOptions = MutationObserverInit\r\n\r\n/\r\n A Preact hook to observe DOM mutations using MutationObserver.\r\n * @param target - The element to observe.\r\n * @param callback - Function to call on mutation.\r\n * @param options - MutationObserver options.\r\n /\r\nexport function useMutationObserver(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n callback: MutationCallback,\r\n options: MutationObserverInit\r\n) {\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const observer = new MutationObserver(callback)\r\n observer.observe(node, options)\r\n\r\n return () => observer.disconnect()\r\n }, [targetRef, callback, options])\r\n}\r\n","import { useEffect, useState } from 'preact/hooks';\r\n\r\nexport type PreferredTheme = 'light' \| 'dark' \| 'no-preference';\r\n\r\n/\r\n A Preact hook that returns the user's preferred color scheme based on the\r\n * `prefers-color-scheme` media query. Updates reactively when the user changes\r\n * their system or browser theme preference.\r\n \r\n @returns The preferred theme: 'light', 'dark', or 'no-preference'\r\n \r\n @example\r\n * ```tsx\r\n * function ThemeAwareComponent() {\r\n * const theme = usePreferredTheme();\r\n * return (\r\n * <div data-theme={theme}>\r\n * Current preference: {theme}\r\n * </div>\r\n * );\r\n * }\r\n * ```\r\n /\r\nexport function usePreferredTheme(): PreferredTheme {\r\n const [theme, setTheme] = useState<PreferredTheme>(() => {\r\n if (typeof window === 'undefined') return 'no-preference';\r\n\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) return 'dark';\r\n if (lightQuery.matches) return 'light';\r\n return 'no-preference';\r\n });\r\n\r\n useEffect(() => {\r\n if (typeof window === 'undefined') return;\r\n\r\n const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n\r\n const handleChange = (e: MediaQueryListEvent) => {\r\n setTheme(e.matches ? 'dark' : 'light');\r\n };\r\n\r\n // Re-check in case of no-preference (some browsers don't support light query)\r\n const updateTheme = () => {\r\n const darkQuery = window.matchMedia('(prefers-color-scheme: dark)');\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n\r\n if (darkQuery.matches) setTheme('dark');\r\n else if (lightQuery.matches) setTheme('light');\r\n else setTheme('no-preference');\r\n };\r\n\r\n mediaQuery.addEventListener('change', handleChange);\r\n\r\n // Fallback: some environments may not fire change, so we also listen for light\r\n const lightQuery = window.matchMedia('(prefers-color-scheme: light)');\r\n lightQuery.addEventListener('change', updateTheme);\r\n\r\n return () => {\r\n mediaQuery.removeEventListener('change', handleChange);\r\n lightQuery.removeEventListener('change', updateTheme);\r\n };\r\n }, []);\r\n\r\n return theme;\r\n}\r\n","import type { RefObject } from 'preact'\r\nimport { useEffect, useRef } from 'preact/hooks'\r\n\r\nexport interface RageClickPayload {\r\n /* Number of clicks that triggered the rage click /\r\n count: number\r\n /* Last click event (e.g. for Sentry context) /\r\n event: MouseEvent\r\n}\r\n\r\nexport interface UseRageClickOptions {\r\n /* Called when a rage click is detected. Use this to report to Sentry or your error tracker. /\r\n onRageClick: (payload: RageClickPayload) => void\r\n /* Minimum number of clicks in the time window to count as rage click. Default: 5 (Sentry-style). /\r\n threshold?: number\r\n /* Time window in ms. Default: 1000. /\r\n timeWindow?: number\r\n /* Max distance in px between clicks to count as same spot. Default: 30. Set to Infinity to ignore distance. /\r\n distanceThreshold?: number\r\n}\r\n\r\ninterface ClickRecord {\r\n time: number\r\n x: number\r\n y: number\r\n}\r\n\r\nfunction distance(a: ClickRecord, b: ClickRecord): number {\r\n return Math.hypot(b.x - a.x, b.y - a.y)\r\n}\r\n\r\n/\r\n Detects \"rage clicks\" (repeated rapid clicks in the same area), e.g. when the UI\r\n * is unresponsive. Use the callback to report to Sentry or similar tools to surface\r\n * rage click issues and lower rage-click-related support.\r\n \r\n @param targetRef - Ref of the element to monitor (e.g. a button or card).\r\n * @param options - onRageClick callback and optional threshold, timeWindow, distanceThreshold.\r\n \r\n @example\r\n * ```tsx\r\n * const ref = useRef<HTMLButtonElement>(null)\r\n * useRageClick(ref, {\r\n * onRageClick: ({ count, event }) => {\r\n * Sentry.captureMessage('Rage click detected', { extra: { count, target: event.target } })\r\n * },\r\n * })\r\n * return <button ref={ref}>Submit</button>\r\n * ```\r\n /\r\nexport function useRageClick(\r\n targetRef: RefObject<HTMLElement \| null>,\r\n options: UseRageClickOptions\r\n) {\r\n const {\r\n onRageClick,\r\n threshold = 5,\r\n timeWindow = 1000,\r\n distanceThreshold = 30,\r\n } = options\r\n\r\n const onRageClickRef = useRef(onRageClick)\r\n onRageClickRef.current = onRageClick\r\n\r\n const clicksRef = useRef<ClickRecord[]>([])\r\n\r\n useEffect(() => {\r\n const node = targetRef.current\r\n if (!node) return\r\n\r\n const handleClick = (e: MouseEvent) => {\r\n const now = Date.now()\r\n const record: ClickRecord = { time: now, x: e.clientX, y: e.clientY }\r\n\r\n const clicks = clicksRef.current\r\n const cutoff = now - timeWindow\r\n const recent = clicks.filter((c) => c.time >= cutoff)\r\n recent.push(record)\r\n\r\n if (distanceThreshold !== Infinity) {\r\n const inRange = recent.filter(\r\n (c) => distance(c, record) <= distanceThreshold\r\n )\r\n if (inRange.length >= threshold) {\r\n onRageClickRef.current({ count: inRange.length, event: e })\r\n clicksRef.current = []\r\n return\r\n }\r\n } else {\r\n if (recent.length >= threshold) {\r\n onRageClickRef.current({ count: recent.length, event: e })\r\n clicksRef.current = []\r\n return\r\n }\r\n }\r\n\r\n clicksRef.current = recent\r\n }\r\n\r\n node.addEventListener('click', handleClick)\r\n return () => node.removeEventListener('click', handleClick)\r\n }, [targetRef, threshold, timeWindow, distanceThreshold])\r\n}\r\n","import { useState, useCallback } from 'preact/hooks';\r\n\r\n/\r\n Mimics React's useTransition hook in Preact.\r\n * @returns [startTransition, isPending]\r\n /\r\nexport function useTransition(): [startTransition: (callback: () => void) => void, isPending: boolean] {\r\n const [isPending, setIsPending] = useState(false);\r\n\r\n const startTransition = useCallback((callback: () => void) => {\r\n setIsPending(true);\r\n Promise.resolve().then(() => {\r\n callback();\r\n setIsPending(false);\r\n });\r\n }, []);\r\n\r\n return [startTransition, isPending];\r\n}\r\n","import { ComponentChildren, cloneElement, isValidElement } from 'preact'\r\nimport { useMemo } from 'preact/hooks'\r\n\r\nexport type InjectableProps = Record<string, any>\r\n\r\n/\r\n A Preact hook to wrap children components and inject additional props into them.\r\n * @param children - The children to wrap and enhance with props.\r\n * @param injectProps - The props to inject into each child component.\r\n * @param mergeStrategy - How to handle prop conflicts ('override' \| 'preserve'). Defaults to 'preserve'.\r\n * @returns Enhanced children with injected props.\r\n */\r\nexport function useWrappedChildren(\r\n children: ComponentChildren,\r\n injectProps: InjectableProps,\r\n mergeStrategy: 'override' \| 'preserve' = 'preserve'\r\n): ComponentChildren {\r\n return useMemo(() => {\r\n if (!children) return children\r\n\r\n const enhanceChild = (child: any): any => {\r\n if (!isValidElement(child)) return child\r\n\r\n const existingProps = child.props \|\| {}\r\n \r\n let mergedProps: InjectableProps\r\n \r\n if (mergeStrategy === 'override') {\r\n // Injected props override existing ones\r\n mergedProps = { ...existingProps, ...injectProps }\r\n } else {\r\n // Existing props are preserved, injected props are added only if not present\r\n mergedProps = { ...injectProps, ...existingProps }\r\n }\r\n\r\n // Special handling for style prop to merge style objects properly\r\n const existingStyle = (existingProps as any)?.style\r\n const injectStyle = (injectProps as any)?.style\r\n \r\n if (existingStyle && injectStyle && \r\n typeof existingStyle === 'object' && typeof injectStyle === 'object') {\r\n if (mergeStrategy === 'override') {\r\n (mergedProps as any).style = { ...existingStyle, ...injectStyle }\r\n } else {\r\n (mergedProps as any).style = { ...injectStyle, ...existingStyle }\r\n }\r\n }\r\n\r\n return cloneElement(child, mergedProps)\r\n }\r\n\r\n if (Array.isArray(children)) {\r\n return children.map(enhanceChild)\r\n }\r\n\r\n return enhanceChild(children)\r\n }, [children, injectProps, mergeStrategy])\r\n}"],"names":["listeners","Map","getNetworkState","navigator","online","state","onLine","connection","undefined","effectiveType","downlink","rtt","saveData","type","connectionType","options","_options$resetDelay","resetDelay","_useState","useState","copied","setCopied","_useState2","error","setError","reset","useCallback","copy","text","clipboard","err","Error","Promise","resolve","_catch","writeText","then","setTimeout","e","String","reject","paste","readText","emit","event","_arguments","arguments","handlers","get","forEach","handler","apply","slice","call","on","Set","set","add","size","targetRef","callback","useEffect","node","current","observer","MutationObserver","observe","disconnect","setState","window","updateState","addEventListener","removeEventListener","darkQuery","matchMedia","lightQuery","matches","theme","setTheme","mediaQuery","handleChange","updateTheme","onRageClick","_options$threshold","threshold","_options$timeWindow","timeWindow","_options$distanceThre","distanceThreshold","onRageClickRef","useRef","clicksRef","handleClick","now","Date","record","time","x","clientX","y","clientY","cutoff","recent","filter","c","push","Infinity","inRange","a","b","Math","hypot","length","count","isPending","setIsPending","children","injectProps","mergeStrategy","useMemo","enhanceChild","child","isValidElement","mergedProps","existingProps","props","_extends","existingStyle","style","injectStyle","cloneElement","Array","isArray","map"],"mappings":"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"}

package/dist/useRageClick.d.ts ADDED Viewed

@@ -0,0 +1,37 @@
+import type { RefObject } from 'preact';
+export interface RageClickPayload {
+    /** Number of clicks that triggered the rage click */
+    count: number;
+    /** Last click event (e.g. for Sentry context) */
+    event: MouseEvent;
+}
+export interface UseRageClickOptions {
+    /** Called when a rage click is detected. Use this to report to Sentry or your error tracker. */
+    onRageClick: (payload: RageClickPayload) => void;
+    /** Minimum number of clicks in the time window to count as rage click. Default: 5 (Sentry-style). */
+    threshold?: number;
+    /** Time window in ms. Default: 1000. */
+    timeWindow?: number;
+    /** Max distance in px between clicks to count as same spot. Default: 30. Set to Infinity to ignore distance. */
+    distanceThreshold?: number;
+}
+/**
+ * Detects "rage clicks" (repeated rapid clicks in the same area), e.g. when the UI
+ * is unresponsive. Use the callback to report to Sentry or similar tools to surface
+ * rage click issues and lower rage-click-related support.
+ *
+ * @param targetRef - Ref of the element to monitor (e.g. a button or card).
+ * @param options - onRageClick callback and optional threshold, timeWindow, distanceThreshold.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<HTMLButtonElement>(null)
+ * useRageClick(ref, {
+ *   onRageClick: ({ count, event }) => {
+ *     Sentry.captureMessage('Rage click detected', { extra: { count, target: event.target } })
+ *   },
+ * })
+ * return <button ref={ref}>Submit</button>
+ * ```
+ */
+export declare function useRageClick(targetRef: RefObject<HTMLElement | null>, options: UseRageClickOptions): void;

package/package.json CHANGED Viewed

@@ -1,64 +1,67 @@
-{
-  "name": "preact-missing-hooks",
-  "version": "1.1.0",
-  "description": "A lightweight, extendable collection of missing React-like hooks for Preact — plus fresh, powerful new ones designed specifically for modern Preact apps.",
-  "author": "Prakhar Dubey",
-  "license": "MIT",
-  "main": "dist/index.js",
-  "module": "dist/index.module.js",
-  "types": "dist/index.d.ts",
-  "source": "src/index.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.module.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./useTransition": {
-      "import": "./dist/useTransition.module.js",
-      "require": "./dist/useTransition.js",
-      "types": "./dist/useTransition.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "microbundle",
-    "dev": "microbundle watch",
-    "prepublishOnly": "npm run build",
-    "test": "vitest run",
-    "type-check": "tsc --noEmit"
-  },
-  "keywords": [
-    "preact",
-    "hooks",
-    "usetransition",
-    "useMutationObserver",
-    "useEventBus",
-    "useWrappedChildren",
-    "usePreferredTheme",
-    "useNetworkState",
-    "useClipboard",
-    "react-hooks",
-    "microbundle",
-    "typescript",
-    "preact-hooks"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/prakhardubey2002/Preact-Missing-Hooks"
-  },
-  "dependencies": {
-    "preact": ">=10.0.0"
-  },
-  "devDependencies": {
-    "@testing-library/jest-dom": "^6.6.3",
-    "@testing-library/preact": "^3.2.4",
-    "@types/jest": "^29.5.14",
-    "jsdom": "^26.1.0",
-    "microbundle": "^0.15.1",
-    "typescript": "^5.8.3",
-    "vitest": "^3.1.4"
-  },
-  "peerDependencies": {
-    "preact": ">=10.0.0"
-  }
-}
+{
+  "name": "preact-missing-hooks",
+  "version": "1.2.0",
+  "description": "A lightweight, extendable collection of missing React-like hooks for Preact — plus fresh, powerful new ones designed specifically for modern Preact apps.",
+  "author": "Prakhar Dubey",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.module.js",
+  "types": "dist/index.d.ts",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.module.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./useTransition": {
+      "import": "./dist/useTransition.module.js",
+      "require": "./dist/useTransition.js",
+      "types": "./dist/useTransition.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "microbundle",
+    "dev": "microbundle watch",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [
+    "preact",
+    "hooks",
+    "usetransition",
+    "useMutationObserver",
+    "useEventBus",
+    "useWrappedChildren",
+    "usePreferredTheme",
+    "useNetworkState",
+    "useClipboard",
+    "useRageClick",
+    "rage click",
+    "sentry",
+    "react-hooks",
+    "microbundle",
+    "typescript",
+    "preact-hooks"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prakhardubey2002/Preact-Missing-Hooks"
+  },
+  "dependencies": {
+    "preact": ">=10.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/preact": "^3.2.4",
+    "@types/jest": "^29.5.14",
+    "jsdom": "^26.1.0",
+    "microbundle": "^0.15.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  },
+  "peerDependencies": {
+    "preact": ">=10.0.0"
+  }
+}

package/src/index.ts CHANGED Viewed

@@ -1,7 +1,8 @@
-export * from './useTransition'
-export * from './useMutationObserver'
-export * from './useEventBus'
-export * from './useWrappedChildren'
-export * from './usePreferredTheme'
-export * from './useNetworkState'
-export * from './useClipboard'
+export * from './useTransition'
+export * from './useMutationObserver'
+export * from './useEventBus'
+export * from './useWrappedChildren'
+export * from './usePreferredTheme'
+export * from './useNetworkState'
+export * from './useClipboard'
+export * from './useRageClick'

package/src/useRageClick.ts ADDED Viewed

@@ -0,0 +1,103 @@
+import type { RefObject } from 'preact'
+import { useEffect, useRef } from 'preact/hooks'
+export interface RageClickPayload {
+  /** Number of clicks that triggered the rage click */
+  count: number
+  /** Last click event (e.g. for Sentry context) */
+  event: MouseEvent
+}
+export interface UseRageClickOptions {
+  /** Called when a rage click is detected. Use this to report to Sentry or your error tracker. */
+  onRageClick: (payload: RageClickPayload) => void
+  /** Minimum number of clicks in the time window to count as rage click. Default: 5 (Sentry-style). */
+  threshold?: number
+  /** Time window in ms. Default: 1000. */
+  timeWindow?: number
+  /** Max distance in px between clicks to count as same spot. Default: 30. Set to Infinity to ignore distance. */
+  distanceThreshold?: number
+}
+interface ClickRecord {
+  time: number
+  x: number
+  y: number
+}
+function distance(a: ClickRecord, b: ClickRecord): number {
+  return Math.hypot(b.x - a.x, b.y - a.y)
+}
+/**
+ * Detects "rage clicks" (repeated rapid clicks in the same area), e.g. when the UI
+ * is unresponsive. Use the callback to report to Sentry or similar tools to surface
+ * rage click issues and lower rage-click-related support.
+ *
+ * @param targetRef - Ref of the element to monitor (e.g. a button or card).
+ * @param options - onRageClick callback and optional threshold, timeWindow, distanceThreshold.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<HTMLButtonElement>(null)
+ * useRageClick(ref, {
+ *   onRageClick: ({ count, event }) => {
+ *     Sentry.captureMessage('Rage click detected', { extra: { count, target: event.target } })
+ *   },
+ * })
+ * return <button ref={ref}>Submit</button>
+ * ```
+ */
+export function useRageClick(
+  targetRef: RefObject<HTMLElement | null>,
+  options: UseRageClickOptions
+) {
+  const {
+    onRageClick,
+    threshold = 5,
+    timeWindow = 1000,
+    distanceThreshold = 30,
+  } = options
+  const onRageClickRef = useRef(onRageClick)
+  onRageClickRef.current = onRageClick
+  const clicksRef = useRef<ClickRecord[]>([])
+  useEffect(() => {
+    const node = targetRef.current
+    if (!node) return
+    const handleClick = (e: MouseEvent) => {
+      const now = Date.now()
+      const record: ClickRecord = { time: now, x: e.clientX, y: e.clientY }
+      const clicks = clicksRef.current
+      const cutoff = now - timeWindow
+      const recent = clicks.filter((c) => c.time >= cutoff)
+      recent.push(record)
+      if (distanceThreshold !== Infinity) {
+        const inRange = recent.filter(
+          (c) => distance(c, record) <= distanceThreshold
+        )
+        if (inRange.length >= threshold) {
+          onRageClickRef.current({ count: inRange.length, event: e })
+          clicksRef.current = []
+          return
+        }
+      } else {
+        if (recent.length >= threshold) {
+          onRageClickRef.current({ count: recent.length, event: e })
+          clicksRef.current = []
+          return
+        }
+      }
+      clicksRef.current = recent
+    }
+    node.addEventListener('click', handleClick)
+    return () => node.removeEventListener('click', handleClick)
+  }, [targetRef, threshold, timeWindow, distanceThreshold])
+}

package/tests/useRageClick.test.tsx ADDED Viewed

@@ -0,0 +1,145 @@
+/** @jsx h */
+import { h } from 'preact'
+import { useRef } from 'preact/hooks'
+import { render, fireEvent, waitFor } from '@testing-library/preact'
+import { useRageClick } from '../src/useRageClick'
+import { vi } from 'vitest'
+describe('useRageClick', () => {
+  it('does not call onRageClick when clicks are below threshold', () => {
+    const onRageClick = vi.fn()
+    function TestComponent() {
+      const ref = useRef<HTMLButtonElement>(null)
+      useRageClick(ref, { onRageClick, threshold: 5, timeWindow: 1000 })
+      return <button ref={ref}>Click</button>
+    }
+    const { getByText } = render(<TestComponent />)
+    const btn = getByText('Click')
+    fireEvent.click(btn)
+    fireEvent.click(btn)
+    fireEvent.click(btn)
+    fireEvent.click(btn)
+    expect(onRageClick).not.toHaveBeenCalled()
+  })
+  it('calls onRageClick when clicks meet threshold in same area', async () => {
+    const onRageClick = vi.fn()
+    function TestComponent() {
+      const ref = useRef<HTMLButtonElement>(null)
+      useRageClick(ref, { onRageClick, threshold: 5, timeWindow: 1000 })
+      return <button ref={ref}>Click</button>
+    }
+    const { getByText } = render(<TestComponent />)
+    const btn = getByText('Click')
+    for (let i = 0; i < 5; i++) {
+      fireEvent.click(btn, { clientX: 10, clientY: 10 })
+    }
+    await waitFor(() => {
+      expect(onRageClick).toHaveBeenCalledTimes(1)
+      expect(onRageClick).toHaveBeenCalledWith(
+        expect.objectContaining({ count: 5 })
+      )
+      expect(onRageClick.mock.calls[0][0].event).toBeDefined()
+    })
+  })
+  it('respects custom threshold', async () => {
+    const onRageClick = vi.fn()
+    function TestComponent() {
+      const ref = useRef<HTMLButtonElement>(null)
+      useRageClick(ref, { onRageClick, threshold: 3, timeWindow: 1000 })
+      return <button ref={ref}>Click</button>
+    }
+    const { getByText } = render(<TestComponent />)
+    const btn = getByText('Click')
+    fireEvent.click(btn, { clientX: 0, clientY: 0 })
+    fireEvent.click(btn, { clientX: 1, clientY: 1 })
+    fireEvent.click(btn, { clientX: 2, clientY: 2 })
+    await waitFor(() => {
+      expect(onRageClick).toHaveBeenCalledTimes(1)
+      expect(onRageClick).toHaveBeenCalledWith(
+        expect.objectContaining({ count: 3 })
+      )
+    })
+  })
+  it('does not fire when clicks are far apart (distanceThreshold)', async () => {
+    const onRageClick = vi.fn()
+    function TestComponent() {
+      const ref = useRef<HTMLDivElement>(null)
+      useRageClick(ref, {
+        onRageClick,
+        threshold: 5,
+        timeWindow: 1000,
+        distanceThreshold: 20,
+      })
+      return <div ref={ref} data-testid="area">Area</div>
+    }
+    const { getByTestId } = render(<TestComponent />)
+    const el = getByTestId('area')
+    for (let i = 0; i < 5; i++) {
+      fireEvent.click(el, { clientX: i * 100, clientY: i * 100 })
+    }
+    expect(onRageClick).not.toHaveBeenCalled()
+  })
+  it('fires when clicks are within distanceThreshold', async () => {
+    const onRageClick = vi.fn()
+    function TestComponent() {
+      const ref = useRef<HTMLDivElement>(null)
+      useRageClick(ref, {
+        onRageClick,
+        threshold: 5,
+        timeWindow: 1000,
+        distanceThreshold: 50,
+      })
+      return <div ref={ref} data-testid="area">Area</div>
+    }
+    const { getByTestId } = render(<TestComponent />)
+    const el = getByTestId('area')
+    for (let i = 0; i < 5; i++) {
+      fireEvent.click(el, { clientX: 10 + i * 5, clientY: 10 + i * 5 })
+    }
+    await waitFor(() => {
+      expect(onRageClick).toHaveBeenCalledTimes(1)
+      expect(onRageClick.mock.calls[0][0].count).toBe(5)
+    })
+  })
+  it('cleans up listener on unmount', () => {
+    const onRageClick = vi.fn()
+    function TestComponent() {
+      const ref = useRef<HTMLButtonElement>(null)
+      useRageClick(ref, { onRageClick, threshold: 5 })
+      return <button ref={ref}>Click</button>
+    }
+    const { getByText, unmount } = render(<TestComponent />)
+    const btn = getByText('Click')
+    unmount()
+    fireEvent.click(btn)
+    fireEvent.click(btn)
+    expect(onRageClick).not.toHaveBeenCalled()
+  })
+})