@zentauri-ui/zentauri-components 1.9.2 → 2.1.0

package/dist/hooks/useGeolocation.mjs

@@ -0,0 +1,109 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useState, useEffect } from 'react';
+
+function toSnapshot(position) {
+  const { coords } = position;
+  return {
+    latitude: coords.latitude,
+    longitude: coords.longitude,
+    accuracy: coords.accuracy,
+    altitude: coords.altitude,
+    altitudeAccuracy: coords.altitudeAccuracy,
+    heading: coords.heading,
+    speed: coords.speed,
+    timestamp: position.timestamp
+  };
+}
+function useGeolocation(params = {}) {
+  const {
+    enabled = true,
+    watch = true,
+    enableHighAccuracy,
+    maximumAge,
+    timeout
+  } = params;
+  const isSupported = typeof navigator !== "undefined" && "geolocation" in navigator;
+  const [permission, setPermission] = useState(
+    "unknown"
+  );
+  const [position, setPosition] = useState(null);
+  const [error, setError] = useState(null);
+  const [settled, setSettled] = useState(false);
+  useEffect(() => {
+    if (typeof navigator === "undefined" || navigator.permissions?.query == null) {
+      return;
+    }
+    let active = true;
+    let status;
+    const onChange = () => {
+      if (active && status) {
+        setPermission(status.state);
+      }
+    };
+    navigator.permissions.query({ name: "geolocation" }).then((result) => {
+      if (!active) {
+        return;
+      }
+      status = result;
+      setPermission(result.state);
+      result.addEventListener("change", onChange);
+    }).catch(() => {
+    });
+    return () => {
+      active = false;
+      status?.removeEventListener("change", onChange);
+    };
+  }, []);
+  useEffect(() => {
+    if (!enabled || !isSupported) {
+      return;
+    }
+    const geolocation = navigator.geolocation;
+    let active = true;
+    setSettled(false);
+    const onSuccess = (next) => {
+      if (!active) {
+        return;
+      }
+      setPosition(toSnapshot(next));
+      setError(null);
+      setSettled(true);
+    };
+    const onError = (nextError) => {
+      if (!active) {
+        return;
+      }
+      setError(nextError);
+      setSettled(true);
+    };
+    const options = {
+      enableHighAccuracy,
+      maximumAge,
+      timeout
+    };
+    let watchId;
+    if (watch) {
+      watchId = geolocation.watchPosition(onSuccess, onError, options);
+    } else {
+      geolocation.getCurrentPosition(onSuccess, onError, options);
+    }
+    return () => {
+      active = false;
+      if (watchId !== void 0) {
+        geolocation.clearWatch(watchId);
+      }
+    };
+  }, [enableHighAccuracy, enabled, isSupported, maximumAge, timeout, watch]);
+  return {
+    isSupported,
+    loading: enabled && isSupported && !settled,
+    permission,
+    position,
+    error
+  };
+}
+
+export { useGeolocation };
+//# sourceMappingURL=useGeolocation.mjs.map
+//# sourceMappingURL=useGeolocation.mjs.map

package/dist/hooks/useGeolocation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useGeolocation/useGeolocation.ts"],"names":[],"mappings":"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","file":"useGeolocation.mjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\nexport type GeolocationCoordinatesSnapshot = {\n  latitude: number;\n  longitude: number;\n  accuracy: number;\n  altitude: number | null;\n  altitudeAccuracy: number | null;\n  heading: number | null;\n  speed: number | null;\n  timestamp: number;\n};\n\nexport type UseGeolocationParams = {\n  /** Start requesting the position (default `true`). Set `false` to defer the permission prompt. */\n  enabled?: boolean;\n  /** Keep watching for position updates instead of a one-shot read (default `true`). */\n  watch?: boolean;\n  /** `PositionOptions.enableHighAccuracy`. */\n  enableHighAccuracy?: boolean;\n  /** `PositionOptions.maximumAge` in milliseconds. */\n  maximumAge?: number;\n  /** `PositionOptions.timeout` in milliseconds. */\n  timeout?: number;\n};\n\nexport type UseGeolocationResult = {\n  /** Whether `navigator.geolocation` exists in this browser. */\n  isSupported: boolean;\n  /** True while enabled and no position or error has arrived yet. */\n  loading: boolean;\n  /** Permission state from the Permissions API (`\"unknown\"` where unsupported or before resolution). */\n  permission: PermissionState | \"unknown\";\n  /** Latest position snapshot, or `null` before the first fix. */\n  position: GeolocationCoordinatesSnapshot | null;\n  /** Latest geolocation error, cleared when a new fix succeeds. */\n  error: GeolocationPositionError | null;\n};\n\nfunction toSnapshot(\n  position: GeolocationPosition,\n): GeolocationCoordinatesSnapshot {\n  const { coords } = position;\n  return {\n    latitude: coords.latitude,\n    longitude: coords.longitude,\n    accuracy: coords.accuracy,\n    altitude: coords.altitude,\n    altitudeAccuracy: coords.altitudeAccuracy,\n    heading: coords.heading,\n    speed: coords.speed,\n    timestamp: position.timestamp,\n  };\n}\n\n/**\n * Browser geolocation with loading, error, and Permissions API state.\n *\n * - Requesting the position triggers the browser permission prompt; pass `enabled: false`\n *   and flip it from a user gesture to avoid prompting on mount.\n * - `watch: true` (default) uses `watchPosition` for live updates; `false` reads once.\n * - `permission` mirrors `navigator.permissions.query({ name: \"geolocation\" })` including\n *   change events, independent of whether a request is active.\n *\n * @param params - {@link UseGeolocationParams}\n * @returns {@link UseGeolocationResult}\n */\nexport function useGeolocation(\n  params: UseGeolocationParams = {},\n): UseGeolocationResult {\n  const {\n    enabled = true,\n    watch = true,\n    enableHighAccuracy,\n    maximumAge,\n    timeout,\n  } = params;\n\n  const isSupported =\n    typeof navigator !== \"undefined\" && \"geolocation\" in navigator;\n\n  const [permission, setPermission] = useState<PermissionState | \"unknown\">(\n    \"unknown\",\n  );\n  const [position, setPosition] =\n    useState<GeolocationCoordinatesSnapshot | null>(null);\n  const [error, setError] = useState<GeolocationPositionError | null>(null);\n  const [settled, setSettled] = useState(false);\n\n  useEffect(() => {\n    if (\n      typeof navigator === \"undefined\" ||\n      navigator.permissions?.query == null\n    ) {\n      return;\n    }\n    let active = true;\n    let status: PermissionStatus | undefined;\n    const onChange = () => {\n      if (active && status) {\n        setPermission(status.state);\n      }\n    };\n    navigator.permissions\n      .query({ name: \"geolocation\" })\n      .then((result) => {\n        // Guard against the component unmounting before this promise resolves,\n        // which would otherwise attach a listener that can never be cleaned up.\n        if (!active) {\n          return;\n        }\n        status = result;\n        setPermission(result.state);\n        result.addEventListener(\"change\", onChange);\n      })\n      .catch(() => {\n        /* permissions API may reject for geolocation in some browsers */\n      });\n    return () => {\n      active = false;\n      status?.removeEventListener(\"change\", onChange);\n    };\n  }, []);\n\n  useEffect(() => {\n    if (!enabled || !isSupported) {\n      return;\n    }\n    const geolocation = navigator.geolocation;\n    let active = true;\n    setSettled(false);\n    const onSuccess = (next: GeolocationPosition) => {\n      if (!active) {\n        return;\n      }\n      setPosition(toSnapshot(next));\n      setError(null);\n      setSettled(true);\n    };\n    const onError = (nextError: GeolocationPositionError) => {\n      if (!active) {\n        return;\n      }\n      setError(nextError);\n      setSettled(true);\n    };\n    const options: PositionOptions = {\n      enableHighAccuracy,\n      maximumAge,\n      timeout,\n    };\n    let watchId: number | undefined;\n    if (watch) {\n      watchId = geolocation.watchPosition(onSuccess, onError, options);\n    } else {\n      geolocation.getCurrentPosition(onSuccess, onError, options);\n    }\n    return () => {\n      active = false;\n      if (watchId !== undefined) {\n        geolocation.clearWatch(watchId);\n      }\n    };\n  }, [enableHighAccuracy, enabled, isSupported, maximumAge, timeout, watch]);\n\n  return {\n    isSupported,\n    loading: enabled && isSupported && !settled,\n    permission,\n    position,\n    error,\n  };\n}\n"]}

package/dist/hooks/useHotkeys/index.d.ts

@@ -0,0 +1,2 @@
+export { useHotkeys, type HotkeyHandler, type UseHotkeysOptions, } from "./useHotkeys";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useHotkeys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useHotkeys/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC"}

package/dist/hooks/useHotkeys/useHotkeys.d.ts

@@ -0,0 +1,24 @@
+export type HotkeyHandler = (event: KeyboardEvent) => void;
+export type UseHotkeysOptions = {
+    /** Disable all bindings without unmounting (default `true`). */
+    enabled?: boolean;
+    /** Call `event.preventDefault()` on a match (default `true`). */
+    preventDefault?: boolean;
+    /** Fire even when typing in inputs, textareas, selects, or contentEditable (default `false`). */
+    allowInInputs?: boolean;
+};
+/**
+ * Binds keyboard shortcut combos (e.g. `"mod+k"`, `"ctrl+shift+p"`, `"escape"`) to handlers on `window`.
+ *
+ * - Combo syntax: modifier tokens (`ctrl`/`control`, `meta`/`cmd`/`command`, `alt`/`option`, `shift`,
+ *   `mod`) joined with `+` around a final key matched against `event.key` (use `space` for the spacebar).
+ * - `mod` matches Cmd on macOS *or* Ctrl elsewhere (it accepts either modifier).
+ * - Bindings are read from a ref on every keydown, so inline objects and closures stay fresh
+ *   without re-subscribing.
+ * - Shortcuts are suppressed while typing in form fields or contentEditable unless `allowInInputs`.
+ *
+ * @param bindings - Map of combo string → handler. The first matching combo wins per event.
+ * @param options - {@link UseHotkeysOptions}
+ */
+export declare function useHotkeys(bindings: Record<string, HotkeyHandler>, options?: UseHotkeysOptions): void;
+//# sourceMappingURL=useHotkeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useHotkeys.d.ts","sourceRoot":"","sources":["../../../src/hooks/useHotkeys/useHotkeys.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iGAAiG;IACjG,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAiEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,OAAO,GAAE,iBAAsB,GAC9B,IAAI,CAmCN"}

package/dist/hooks/useHotkeys.js

@@ -0,0 +1,90 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function parseHotkey(combo) {
+  const parsed = {
+    key: "",
+    ctrl: false,
+    meta: false,
+    alt: false,
+    shift: false,
+    mod: false
+  };
+  for (const raw of combo.split("+")) {
+    const token = raw.trim().toLowerCase();
+    if (token === "ctrl" || token === "control") {
+      parsed.ctrl = true;
+    } else if (token === "meta" || token === "cmd" || token === "command") {
+      parsed.meta = true;
+    } else if (token === "alt" || token === "option") {
+      parsed.alt = true;
+    } else if (token === "shift") {
+      parsed.shift = true;
+    } else if (token === "mod") {
+      parsed.mod = true;
+    } else {
+      parsed.key = token === "space" ? " " : token;
+    }
+  }
+  return parsed;
+}
+function matchesHotkey(event, hotkey) {
+  if (hotkey.key !== event.key.toLowerCase()) {
+    return false;
+  }
+  if (hotkey.mod) {
+    if (!event.ctrlKey && !event.metaKey) {
+      return false;
+    }
+  } else if (hotkey.ctrl !== event.ctrlKey || hotkey.meta !== event.metaKey) {
+    return false;
+  }
+  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;
+}
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) {
+    return false;
+  }
+  return target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT" || target.isContentEditable;
+}
+function useHotkeys(bindings, options = {}) {
+  const {
+    enabled = true,
+    preventDefault = true,
+    allowInInputs = false
+  } = options;
+  const bindingsRef = react.useRef(bindings);
+  react.useEffect(() => {
+    bindingsRef.current = bindings;
+  }, [bindings]);
+  react.useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    const onKeyDown = (event) => {
+      if (!allowInInputs && isEditableTarget(event.target)) {
+        return;
+      }
+      for (const [combo, handler] of Object.entries(bindingsRef.current)) {
+        if (matchesHotkey(event, parseHotkey(combo))) {
+          if (preventDefault) {
+            event.preventDefault();
+          }
+          handler(event);
+          return;
+        }
+      }
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => {
+      window.removeEventListener("keydown", onKeyDown);
+    };
+  }, [allowInInputs, enabled, preventDefault]);
+}
+
+exports.useHotkeys = useHotkeys;
+//# sourceMappingURL=useHotkeys.js.map
+//# sourceMappingURL=useHotkeys.js.map

package/dist/hooks/useHotkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useHotkeys/useHotkeys.ts"],"names":["useRef","useEffect"],"mappings":";;;;;AAwBA,SAAS,YAAY,KAAA,EAA6B;AAChD,EAAA,MAAM,MAAA,GAAuB;AAAA,IAC3B,GAAA,EAAK,EAAA;AAAA,IACL,IAAA,EAAM,KAAA;AAAA,IACN,IAAA,EAAM,KAAA;AAAA,IACN,GAAA,EAAK,KAAA;AAAA,IACL,KAAA,EAAO,KAAA;AAAA,IACP,GAAA,EAAK;AAAA,GACP;AACA,EAAA,KAAA,MAAW,GAAA,IAAO,KAAA,CAAM,KAAA,CAAM,GAAG,CAAA,EAAG;AAClC,IAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,IAAA,EAAK,CAAE,WAAA,EAAY;AACrC,IAAA,IAAI,KAAA,KAAU,MAAA,IAAU,KAAA,KAAU,SAAA,EAAW;AAC3C,MAAA,MAAA,CAAO,IAAA,GAAO,IAAA;AAAA,IAChB,WAAW,KAAA,KAAU,MAAA,IAAU,KAAA,KAAU,KAAA,IAAS,UAAU,SAAA,EAAW;AACrE,MAAA,MAAA,CAAO,IAAA,GAAO,IAAA;AAAA,IAChB,CAAA,MAAA,IAAW,KAAA,KAAU,KAAA,IAAS,KAAA,KAAU,QAAA,EAAU;AAChD,MAAA,MAAA,CAAO,GAAA,GAAM,IAAA;AAAA,IACf,CAAA,MAAA,IAAW,UAAU,OAAA,EAAS;AAC5B,MAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AAAA,IACjB,CAAA,MAAA,IAAW,UAAU,KAAA,EAAO;AAC1B,MAAA,MAAA,CAAO,GAAA,GAAM,IAAA;AAAA,IACf,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,GAAA,GAAM,KAAA,KAAU,OAAA,GAAU,GAAA,GAAM,KAAA;AAAA,IACzC;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,aAAA,CAAc,OAAsB,MAAA,EAA+B;AAC1E,EAAA,IAAI,MAAA,CAAO,GAAA,KAAQ,KAAA,CAAM,GAAA,CAAI,aAAY,EAAG;AAC1C,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAO,GAAA,EAAK;AACd,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,IAAW,CAAC,MAAM,OAAA,EAAS;AACpC,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF,CAAA,MAAA,IAAW,OAAO,IAAA,KAAS,KAAA,CAAM,WAAW,MAAA,CAAO,IAAA,KAAS,MAAM,OAAA,EAAS;AACzE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,OAAO,GAAA,KAAQ,KAAA,CAAM,MAAA,IAAU,MAAA,CAAO,UAAU,KAAA,CAAM,QAAA;AAC/D;AAEA,SAAS,iBAAiB,MAAA,EAAqC;AAC7D,EAAA,IAAI,EAAE,kBAAkB,WAAA,CAAA,EAAc;AACpC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OACE,MAAA,CAAO,YAAY,OAAA,IACnB,MAAA,CAAO,YAAY,UAAA,IACnB,MAAA,CAAO,OAAA,KAAY,QAAA,IACnB,MAAA,CAAO,iBAAA;AAEX;AAeO,SAAS,UAAA,CACd,QAAA,EACA,OAAA,GAA6B,EAAC,EACxB;AACN,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,IAAA;AAAA,IACV,cAAA,GAAiB,IAAA;AAAA,IACjB,aAAA,GAAgB;AAAA,GAClB,GAAI,OAAA;AACJ,EAAA,MAAM,WAAA,GAAcA,aAAO,QAAQ,CAAA;AAEnC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAAA,EACxB,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAA,GAAY,CAAC,KAAA,KAAyB;AAC1C,MAAA,IAAI,CAAC,aAAA,IAAiB,gBAAA,CAAiB,KAAA,CAAM,MAAM,CAAA,EAAG;AACpD,QAAA;AAAA,MACF;AACA,MAAA,KAAA,MAAW,CAAC,OAAO,OAAO,CAAA,IAAK,OAAO,OAAA,CAAQ,WAAA,CAAY,OAAO,CAAA,EAAG;AAClE,QAAA,IAAI,aAAA,CAAc,KAAA,EAAO,WAAA,CAAY,KAAK,CAAC,CAAA,EAAG;AAC5C,UAAA,IAAI,cAAA,EAAgB;AAClB,YAAA,KAAA,CAAM,cAAA,EAAe;AAAA,UACvB;AACA,UAAA,OAAA,CAAQ,KAAK,CAAA;AACb,UAAA;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAA;AACA,IAAA,MAAA,CAAO,gBAAA,CAAiB,WAAW,SAAS,CAAA;AAC5C,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,mBAAA,CAAoB,WAAW,SAAS,CAAA;AAAA,IACjD,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,aAAA,EAAe,OAAA,EAAS,cAAc,CAAC,CAAA;AAC7C","file":"useHotkeys.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\nexport type HotkeyHandler = (event: KeyboardEvent) => void;\n\nexport type UseHotkeysOptions = {\n  /** Disable all bindings without unmounting (default `true`). */\n  enabled?: boolean;\n  /** Call `event.preventDefault()` on a match (default `true`). */\n  preventDefault?: boolean;\n  /** Fire even when typing in inputs, textareas, selects, or contentEditable (default `false`). */\n  allowInInputs?: boolean;\n};\n\ntype ParsedHotkey = {\n  key: string;\n  ctrl: boolean;\n  meta: boolean;\n  alt: boolean;\n  shift: boolean;\n  mod: boolean;\n};\n\nfunction parseHotkey(combo: string): ParsedHotkey {\n  const parsed: ParsedHotkey = {\n    key: \"\",\n    ctrl: false,\n    meta: false,\n    alt: false,\n    shift: false,\n    mod: false,\n  };\n  for (const raw of combo.split(\"+\")) {\n    const token = raw.trim().toLowerCase();\n    if (token === \"ctrl\" || token === \"control\") {\n      parsed.ctrl = true;\n    } else if (token === \"meta\" || token === \"cmd\" || token === \"command\") {\n      parsed.meta = true;\n    } else if (token === \"alt\" || token === \"option\") {\n      parsed.alt = true;\n    } else if (token === \"shift\") {\n      parsed.shift = true;\n    } else if (token === \"mod\") {\n      parsed.mod = true;\n    } else {\n      parsed.key = token === \"space\" ? \" \" : token;\n    }\n  }\n  return parsed;\n}\n\nfunction matchesHotkey(event: KeyboardEvent, hotkey: ParsedHotkey): boolean {\n  if (hotkey.key !== event.key.toLowerCase()) {\n    return false;\n  }\n  if (hotkey.mod) {\n    if (!event.ctrlKey && !event.metaKey) {\n      return false;\n    }\n  } else if (hotkey.ctrl !== event.ctrlKey || hotkey.meta !== event.metaKey) {\n    return false;\n  }\n  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;\n}\n\nfunction isEditableTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) {\n    return false;\n  }\n  return (\n    target.tagName === \"INPUT\" ||\n    target.tagName === \"TEXTAREA\" ||\n    target.tagName === \"SELECT\" ||\n    target.isContentEditable\n  );\n}\n\n/**\n * Binds keyboard shortcut combos (e.g. `\"mod+k\"`, `\"ctrl+shift+p\"`, `\"escape\"`) to handlers on `window`.\n *\n * - Combo syntax: modifier tokens (`ctrl`/`control`, `meta`/`cmd`/`command`, `alt`/`option`, `shift`,\n *   `mod`) joined with `+` around a final key matched against `event.key` (use `space` for the spacebar).\n * - `mod` matches Cmd on macOS *or* Ctrl elsewhere (it accepts either modifier).\n * - Bindings are read from a ref on every keydown, so inline objects and closures stay fresh\n *   without re-subscribing.\n * - Shortcuts are suppressed while typing in form fields or contentEditable unless `allowInInputs`.\n *\n * @param bindings - Map of combo string → handler. The first matching combo wins per event.\n * @param options - {@link UseHotkeysOptions}\n */\nexport function useHotkeys(\n  bindings: Record<string, HotkeyHandler>,\n  options: UseHotkeysOptions = {},\n): void {\n  const {\n    enabled = true,\n    preventDefault = true,\n    allowInInputs = false,\n  } = options;\n  const bindingsRef = useRef(bindings);\n\n  useEffect(() => {\n    bindingsRef.current = bindings;\n  }, [bindings]);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (!allowInInputs && isEditableTarget(event.target)) {\n        return;\n      }\n      for (const [combo, handler] of Object.entries(bindingsRef.current)) {\n        if (matchesHotkey(event, parseHotkey(combo))) {\n          if (preventDefault) {\n            event.preventDefault();\n          }\n          handler(event);\n          return;\n        }\n      }\n    };\n    window.addEventListener(\"keydown\", onKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", onKeyDown);\n    };\n  }, [allowInInputs, enabled, preventDefault]);\n}\n"]}

package/dist/hooks/useHotkeys.mjs

@@ -0,0 +1,88 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useRef, useEffect } from 'react';
+
+function parseHotkey(combo) {
+  const parsed = {
+    key: "",
+    ctrl: false,
+    meta: false,
+    alt: false,
+    shift: false,
+    mod: false
+  };
+  for (const raw of combo.split("+")) {
+    const token = raw.trim().toLowerCase();
+    if (token === "ctrl" || token === "control") {
+      parsed.ctrl = true;
+    } else if (token === "meta" || token === "cmd" || token === "command") {
+      parsed.meta = true;
+    } else if (token === "alt" || token === "option") {
+      parsed.alt = true;
+    } else if (token === "shift") {
+      parsed.shift = true;
+    } else if (token === "mod") {
+      parsed.mod = true;
+    } else {
+      parsed.key = token === "space" ? " " : token;
+    }
+  }
+  return parsed;
+}
+function matchesHotkey(event, hotkey) {
+  if (hotkey.key !== event.key.toLowerCase()) {
+    return false;
+  }
+  if (hotkey.mod) {
+    if (!event.ctrlKey && !event.metaKey) {
+      return false;
+    }
+  } else if (hotkey.ctrl !== event.ctrlKey || hotkey.meta !== event.metaKey) {
+    return false;
+  }
+  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;
+}
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) {
+    return false;
+  }
+  return target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT" || target.isContentEditable;
+}
+function useHotkeys(bindings, options = {}) {
+  const {
+    enabled = true,
+    preventDefault = true,
+    allowInInputs = false
+  } = options;
+  const bindingsRef = useRef(bindings);
+  useEffect(() => {
+    bindingsRef.current = bindings;
+  }, [bindings]);
+  useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    const onKeyDown = (event) => {
+      if (!allowInInputs && isEditableTarget(event.target)) {
+        return;
+      }
+      for (const [combo, handler] of Object.entries(bindingsRef.current)) {
+        if (matchesHotkey(event, parseHotkey(combo))) {
+          if (preventDefault) {
+            event.preventDefault();
+          }
+          handler(event);
+          return;
+        }
+      }
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => {
+      window.removeEventListener("keydown", onKeyDown);
+    };
+  }, [allowInInputs, enabled, preventDefault]);
+}
+
+export { useHotkeys };
+//# sourceMappingURL=useHotkeys.mjs.map
+//# sourceMappingURL=useHotkeys.mjs.map

package/dist/hooks/useHotkeys.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useHotkeys/useHotkeys.ts"],"names":[],"mappings":"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","file":"useHotkeys.mjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\nexport type HotkeyHandler = (event: KeyboardEvent) => void;\n\nexport type UseHotkeysOptions = {\n  /** Disable all bindings without unmounting (default `true`). */\n  enabled?: boolean;\n  /** Call `event.preventDefault()` on a match (default `true`). */\n  preventDefault?: boolean;\n  /** Fire even when typing in inputs, textareas, selects, or contentEditable (default `false`). */\n  allowInInputs?: boolean;\n};\n\ntype ParsedHotkey = {\n  key: string;\n  ctrl: boolean;\n  meta: boolean;\n  alt: boolean;\n  shift: boolean;\n  mod: boolean;\n};\n\nfunction parseHotkey(combo: string): ParsedHotkey {\n  const parsed: ParsedHotkey = {\n    key: \"\",\n    ctrl: false,\n    meta: false,\n    alt: false,\n    shift: false,\n    mod: false,\n  };\n  for (const raw of combo.split(\"+\")) {\n    const token = raw.trim().toLowerCase();\n    if (token === \"ctrl\" || token === \"control\") {\n      parsed.ctrl = true;\n    } else if (token === \"meta\" || token === \"cmd\" || token === \"command\") {\n      parsed.meta = true;\n    } else if (token === \"alt\" || token === \"option\") {\n      parsed.alt = true;\n    } else if (token === \"shift\") {\n      parsed.shift = true;\n    } else if (token === \"mod\") {\n      parsed.mod = true;\n    } else {\n      parsed.key = token === \"space\" ? \" \" : token;\n    }\n  }\n  return parsed;\n}\n\nfunction matchesHotkey(event: KeyboardEvent, hotkey: ParsedHotkey): boolean {\n  if (hotkey.key !== event.key.toLowerCase()) {\n    return false;\n  }\n  if (hotkey.mod) {\n    if (!event.ctrlKey && !event.metaKey) {\n      return false;\n    }\n  } else if (hotkey.ctrl !== event.ctrlKey || hotkey.meta !== event.metaKey) {\n    return false;\n  }\n  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;\n}\n\nfunction isEditableTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) {\n    return false;\n  }\n  return (\n    target.tagName === \"INPUT\" ||\n    target.tagName === \"TEXTAREA\" ||\n    target.tagName === \"SELECT\" ||\n    target.isContentEditable\n  );\n}\n\n/**\n * Binds keyboard shortcut combos (e.g. `\"mod+k\"`, `\"ctrl+shift+p\"`, `\"escape\"`) to handlers on `window`.\n *\n * - Combo syntax: modifier tokens (`ctrl`/`control`, `meta`/`cmd`/`command`, `alt`/`option`, `shift`,\n *   `mod`) joined with `+` around a final key matched against `event.key` (use `space` for the spacebar).\n * - `mod` matches Cmd on macOS *or* Ctrl elsewhere (it accepts either modifier).\n * - Bindings are read from a ref on every keydown, so inline objects and closures stay fresh\n *   without re-subscribing.\n * - Shortcuts are suppressed while typing in form fields or contentEditable unless `allowInInputs`.\n *\n * @param bindings - Map of combo string → handler. The first matching combo wins per event.\n * @param options - {@link UseHotkeysOptions}\n */\nexport function useHotkeys(\n  bindings: Record<string, HotkeyHandler>,\n  options: UseHotkeysOptions = {},\n): void {\n  const {\n    enabled = true,\n    preventDefault = true,\n    allowInInputs = false,\n  } = options;\n  const bindingsRef = useRef(bindings);\n\n  useEffect(() => {\n    bindingsRef.current = bindings;\n  }, [bindings]);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (!allowInInputs && isEditableTarget(event.target)) {\n        return;\n      }\n      for (const [combo, handler] of Object.entries(bindingsRef.current)) {\n        if (matchesHotkey(event, parseHotkey(combo))) {\n          if (preventDefault) {\n            event.preventDefault();\n          }\n          handler(event);\n          return;\n        }\n      }\n    };\n    window.addEventListener(\"keydown\", onKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", onKeyDown);\n    };\n  }, [allowInInputs, enabled, preventDefault]);\n}\n"]}

package/dist/hooks/useIdleTimeout/index.d.ts

@@ -0,0 +1,2 @@
+export { useIdleTimeout, type UseIdleTimeoutParams, type UseIdleTimeoutResult, } from "./useIdleTimeout";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useIdleTimeout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useIdleTimeout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC"}

package/dist/hooks/useIdleTimeout/useIdleTimeout.d.ts

@@ -0,0 +1,31 @@
+export type UseIdleTimeoutParams = {
+    /** Inactivity duration in milliseconds before the user counts as idle. */
+    timeoutMs: number;
+    /** Window events treated as activity (default: pointer, key, wheel, touch, scroll). */
+    events?: readonly string[];
+    /** Start in the idle state (default `false`). */
+    initiallyIdle?: boolean;
+    /** Called when the user becomes idle. */
+    onIdle?: () => void;
+    /** Called when activity resumes after being idle. */
+    onActive?: () => void;
+};
+export type UseIdleTimeoutResult = {
+    /** Whether the user is currently idle. */
+    isIdle: boolean;
+    /** Mark the user active and restart the inactivity timer (e.g. after programmatic activity). */
+    reset: () => void;
+};
+/**
+ * Detects user inactivity: `isIdle` flips to `true` after `timeoutMs` without any of the
+ * activity events on `window`, and back to `false` on the next activity.
+ *
+ * - `onIdle` / `onActive` fire on transitions only (not on mount), and are read from refs
+ *   so inline callbacks stay fresh.
+ * - Useful for session expiry warnings, pausing media or polling, and presence indicators.
+ *
+ * @param params - {@link UseIdleTimeoutParams}
+ * @returns {@link UseIdleTimeoutResult}
+ */
+export declare function useIdleTimeout({ timeoutMs, events, initiallyIdle, onIdle, onActive, }: UseIdleTimeoutParams): UseIdleTimeoutResult;
+//# sourceMappingURL=useIdleTimeout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useIdleTimeout.d.ts","sourceRoot":"","sources":["../../../src/hooks/useIdleTimeout/useIdleTimeout.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,oBAAoB,GAAG;IACjC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,gGAAgG;IAChG,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,MAAM,EACN,aAAqB,EACrB,MAAM,EACN,QAAQ,GACT,EAAE,oBAAoB,GAAG,oBAAoB,CA4D7C"}

package/dist/hooks/useIdleTimeout.js

@@ -0,0 +1,77 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+var DEFAULT_ACTIVITY_EVENTS = [
+  "pointerdown",
+  "pointermove",
+  "keydown",
+  "wheel",
+  "touchstart",
+  "scroll"
+];
+function useIdleTimeout({
+  timeoutMs,
+  events,
+  initiallyIdle = false,
+  onIdle,
+  onActive
+}) {
+  const [isIdle, setIsIdle] = react.useState(initiallyIdle);
+  const onIdleRef = react.useRef(onIdle);
+  const onActiveRef = react.useRef(onActive);
+  const restartRef = react.useRef(() => {
+  });
+  const firstRunRef = react.useRef(true);
+  react.useEffect(() => {
+    onIdleRef.current = onIdle;
+    onActiveRef.current = onActive;
+  }, [onActive, onIdle]);
+  react.useEffect(() => {
+    if (firstRunRef.current) {
+      firstRunRef.current = false;
+      return;
+    }
+    if (isIdle) {
+      onIdleRef.current?.();
+    } else {
+      onActiveRef.current?.();
+    }
+  }, [isIdle]);
+  const eventsKey = (events ?? DEFAULT_ACTIVITY_EVENTS).join(" ");
+  react.useEffect(() => {
+    const eventNames = eventsKey.split(" ").filter(Boolean);
+    let timeoutId;
+    const startTimer = () => {
+      window.clearTimeout(timeoutId);
+      timeoutId = window.setTimeout(() => {
+        setIsIdle(true);
+      }, timeoutMs);
+    };
+    const onActivity = () => {
+      setIsIdle(false);
+      startTimer();
+    };
+    restartRef.current = onActivity;
+    startTimer();
+    for (const name of eventNames) {
+      window.addEventListener(name, onActivity, { passive: true });
+    }
+    return () => {
+      window.clearTimeout(timeoutId);
+      for (const name of eventNames) {
+        window.removeEventListener(name, onActivity);
+      }
+    };
+  }, [eventsKey, timeoutMs]);
+  const reset = react.useCallback(() => {
+    restartRef.current();
+  }, []);
+  return { isIdle, reset };
+}
+
+exports.useIdleTimeout = useIdleTimeout;
+//# sourceMappingURL=useIdleTimeout.js.map
+//# sourceMappingURL=useIdleTimeout.js.map

package/dist/hooks/useIdleTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useIdleTimeout/useIdleTimeout.ts"],"names":["useState","useRef","useEffect","useCallback"],"mappings":";;;;;AAIA,IAAM,uBAAA,GAA0B;AAAA,EAC9B,aAAA;AAAA,EACA,aAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF,CAAA;AAiCO,SAAS,cAAA,CAAe;AAAA,EAC7B,SAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA,GAAgB,KAAA;AAAA,EAChB,MAAA;AAAA,EACA;AACF,CAAA,EAA+C;AAC7C,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIA,eAAS,aAAa,CAAA;AAClD,EAAA,MAAM,SAAA,GAAYC,aAAO,MAAM,CAAA;AAC/B,EAAA,MAAM,WAAA,GAAcA,aAAO,QAAQ,CAAA;AACnC,EAAA,MAAM,UAAA,GAAaA,aAAmB,MAAM;AAAA,EAAC,CAAC,CAAA;AAC9C,EAAA,MAAM,WAAA,GAAcA,aAAO,IAAI,CAAA;AAE/B,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,SAAA,CAAU,OAAA,GAAU,MAAA;AACpB,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAAA,EACxB,CAAA,EAAG,CAAC,QAAA,EAAU,MAAM,CAAC,CAAA;AAErB,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,YAAY,OAAA,EAAS;AACvB,MAAA,WAAA,CAAY,OAAA,GAAU,KAAA;AACtB,MAAA;AAAA,IACF;AACA,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,SAAA,CAAU,OAAA,IAAU;AAAA,IACtB,CAAA,MAAO;AACL,MAAA,WAAA,CAAY,OAAA,IAAU;AAAA,IACxB;AAAA,EACF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,SAAA,GAAA,CAAa,MAAA,IAAU,uBAAA,EAAyB,IAAA,CAAK,GAAG,CAAA;AAE9D,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,aAAa,SAAA,CAAU,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AACtD,IAAA,IAAI,SAAA;AAEJ,IAAA,MAAM,aAAa,MAAM;AACvB,MAAA,MAAA,CAAO,aAAa,SAAS,CAAA;AAC7B,MAAA,SAAA,GAAY,MAAA,CAAO,WAAW,MAAM;AAClC,QAAA,SAAA,CAAU,IAAI,CAAA;AAAA,MAChB,GAAG,SAAS,CAAA;AAAA,IACd,CAAA;AAEA,IAAA,MAAM,aAAa,MAAM;AACvB,MAAA,SAAA,CAAU,KAAK,CAAA;AACf,MAAA,UAAA,EAAW;AAAA,IACb,CAAA;AAEA,IAAA,UAAA,CAAW,OAAA,GAAU,UAAA;AACrB,IAAA,UAAA,EAAW;AACX,IAAA,KAAA,MAAW,QAAQ,UAAA,EAAY;AAC7B,MAAA,MAAA,CAAO,iBAAiB,IAAA,EAAM,UAAA,EAAY,EAAE,OAAA,EAAS,MAAM,CAAA;AAAA,IAC7D;AACA,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,aAAa,SAAS,CAAA;AAC7B,MAAA,KAAA,MAAW,QAAQ,UAAA,EAAY;AAC7B,QAAA,MAAA,CAAO,mBAAA,CAAoB,MAAM,UAAU,CAAA;AAAA,MAC7C;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAA,EAAW,SAAS,CAAC,CAAA;AAEzB,EAAA,MAAM,KAAA,GAAQC,kBAAY,MAAM;AAC9B,IAAA,UAAA,CAAW,OAAA,EAAQ;AAAA,EACrB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,QAAQ,KAAA,EAAM;AACzB","file":"useIdleTimeout.js","sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nconst DEFAULT_ACTIVITY_EVENTS = [\n  \"pointerdown\",\n  \"pointermove\",\n  \"keydown\",\n  \"wheel\",\n  \"touchstart\",\n  \"scroll\",\n] as const;\n\nexport type UseIdleTimeoutParams = {\n  /** Inactivity duration in milliseconds before the user counts as idle. */\n  timeoutMs: number;\n  /** Window events treated as activity (default: pointer, key, wheel, touch, scroll). */\n  events?: readonly string[];\n  /** Start in the idle state (default `false`). */\n  initiallyIdle?: boolean;\n  /** Called when the user becomes idle. */\n  onIdle?: () => void;\n  /** Called when activity resumes after being idle. */\n  onActive?: () => void;\n};\n\nexport type UseIdleTimeoutResult = {\n  /** Whether the user is currently idle. */\n  isIdle: boolean;\n  /** Mark the user active and restart the inactivity timer (e.g. after programmatic activity). */\n  reset: () => void;\n};\n\n/**\n * Detects user inactivity: `isIdle` flips to `true` after `timeoutMs` without any of the\n * activity events on `window`, and back to `false` on the next activity.\n *\n * - `onIdle` / `onActive` fire on transitions only (not on mount), and are read from refs\n *   so inline callbacks stay fresh.\n * - Useful for session expiry warnings, pausing media or polling, and presence indicators.\n *\n * @param params - {@link UseIdleTimeoutParams}\n * @returns {@link UseIdleTimeoutResult}\n */\nexport function useIdleTimeout({\n  timeoutMs,\n  events,\n  initiallyIdle = false,\n  onIdle,\n  onActive,\n}: UseIdleTimeoutParams): UseIdleTimeoutResult {\n  const [isIdle, setIsIdle] = useState(initiallyIdle);\n  const onIdleRef = useRef(onIdle);\n  const onActiveRef = useRef(onActive);\n  const restartRef = useRef<() => void>(() => {});\n  const firstRunRef = useRef(true);\n\n  useEffect(() => {\n    onIdleRef.current = onIdle;\n    onActiveRef.current = onActive;\n  }, [onActive, onIdle]);\n\n  useEffect(() => {\n    if (firstRunRef.current) {\n      firstRunRef.current = false;\n      return;\n    }\n    if (isIdle) {\n      onIdleRef.current?.();\n    } else {\n      onActiveRef.current?.();\n    }\n  }, [isIdle]);\n\n  const eventsKey = (events ?? DEFAULT_ACTIVITY_EVENTS).join(\" \");\n\n  useEffect(() => {\n    const eventNames = eventsKey.split(\" \").filter(Boolean);\n    let timeoutId: number | undefined;\n\n    const startTimer = () => {\n      window.clearTimeout(timeoutId);\n      timeoutId = window.setTimeout(() => {\n        setIsIdle(true);\n      }, timeoutMs);\n    };\n\n    const onActivity = () => {\n      setIsIdle(false);\n      startTimer();\n    };\n\n    restartRef.current = onActivity;\n    startTimer();\n    for (const name of eventNames) {\n      window.addEventListener(name, onActivity, { passive: true });\n    }\n    return () => {\n      window.clearTimeout(timeoutId);\n      for (const name of eventNames) {\n        window.removeEventListener(name, onActivity);\n      }\n    };\n  }, [eventsKey, timeoutMs]);\n\n  const reset = useCallback(() => {\n    restartRef.current();\n  }, []);\n\n  return { isIdle, reset };\n}\n"]}

package/dist/hooks/useIdleTimeout.mjs

@@ -0,0 +1,75 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useState, useRef, useEffect, useCallback } from 'react';
+
+var DEFAULT_ACTIVITY_EVENTS = [
+  "pointerdown",
+  "pointermove",
+  "keydown",
+  "wheel",
+  "touchstart",
+  "scroll"
+];
+function useIdleTimeout({
+  timeoutMs,
+  events,
+  initiallyIdle = false,
+  onIdle,
+  onActive
+}) {
+  const [isIdle, setIsIdle] = useState(initiallyIdle);
+  const onIdleRef = useRef(onIdle);
+  const onActiveRef = useRef(onActive);
+  const restartRef = useRef(() => {
+  });
+  const firstRunRef = useRef(true);
+  useEffect(() => {
+    onIdleRef.current = onIdle;
+    onActiveRef.current = onActive;
+  }, [onActive, onIdle]);
+  useEffect(() => {
+    if (firstRunRef.current) {
+      firstRunRef.current = false;
+      return;
+    }
+    if (isIdle) {
+      onIdleRef.current?.();
+    } else {
+      onActiveRef.current?.();
+    }
+  }, [isIdle]);
+  const eventsKey = (events ?? DEFAULT_ACTIVITY_EVENTS).join(" ");
+  useEffect(() => {
+    const eventNames = eventsKey.split(" ").filter(Boolean);
+    let timeoutId;
+    const startTimer = () => {
+      window.clearTimeout(timeoutId);
+      timeoutId = window.setTimeout(() => {
+        setIsIdle(true);
+      }, timeoutMs);
+    };
+    const onActivity = () => {
+      setIsIdle(false);
+      startTimer();
+    };
+    restartRef.current = onActivity;
+    startTimer();
+    for (const name of eventNames) {
+      window.addEventListener(name, onActivity, { passive: true });
+    }
+    return () => {
+      window.clearTimeout(timeoutId);
+      for (const name of eventNames) {
+        window.removeEventListener(name, onActivity);
+      }
+    };
+  }, [eventsKey, timeoutMs]);
+  const reset = useCallback(() => {
+    restartRef.current();
+  }, []);
+  return { isIdle, reset };
+}
+
+export { useIdleTimeout };
+//# sourceMappingURL=useIdleTimeout.mjs.map
+//# sourceMappingURL=useIdleTimeout.mjs.map

package/dist/hooks/useIdleTimeout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useIdleTimeout/useIdleTimeout.ts"],"names":[],"mappings":";;;AAIA,IAAM,uBAAA,GAA0B;AAAA,EAC9B,aAAA;AAAA,EACA,aAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF,CAAA;AAiCO,SAAS,cAAA,CAAe;AAAA,EAC7B,SAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA,GAAgB,KAAA;AAAA,EAChB,MAAA;AAAA,EACA;AACF,CAAA,EAA+C;AAC7C,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,SAAS,aAAa,CAAA;AAClD,EAAA,MAAM,SAAA,GAAY,OAAO,MAAM,CAAA;AAC/B,EAAA,MAAM,WAAA,GAAc,OAAO,QAAQ,CAAA;AACnC,EAAA,MAAM,UAAA,GAAa,OAAmB,MAAM;AAAA,EAAC,CAAC,CAAA;AAC9C,EAAA,MAAM,WAAA,GAAc,OAAO,IAAI,CAAA;AAE/B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,SAAA,CAAU,OAAA,GAAU,MAAA;AACpB,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAAA,EACxB,CAAA,EAAG,CAAC,QAAA,EAAU,MAAM,CAAC,CAAA;AAErB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,YAAY,OAAA,EAAS;AACvB,MAAA,WAAA,CAAY,OAAA,GAAU,KAAA;AACtB,MAAA;AAAA,IACF;AACA,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,SAAA,CAAU,OAAA,IAAU;AAAA,IACtB,CAAA,MAAO;AACL,MAAA,WAAA,CAAY,OAAA,IAAU;AAAA,IACxB;AAAA,EACF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,SAAA,GAAA,CAAa,MAAA,IAAU,uBAAA,EAAyB,IAAA,CAAK,GAAG,CAAA;AAE9D,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,aAAa,SAAA,CAAU,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AACtD,IAAA,IAAI,SAAA;AAEJ,IAAA,MAAM,aAAa,MAAM;AACvB,MAAA,MAAA,CAAO,aAAa,SAAS,CAAA;AAC7B,MAAA,SAAA,GAAY,MAAA,CAAO,WAAW,MAAM;AAClC,QAAA,SAAA,CAAU,IAAI,CAAA;AAAA,MAChB,GAAG,SAAS,CAAA;AAAA,IACd,CAAA;AAEA,IAAA,MAAM,aAAa,MAAM;AACvB,MAAA,SAAA,CAAU,KAAK,CAAA;AACf,MAAA,UAAA,EAAW;AAAA,IACb,CAAA;AAEA,IAAA,UAAA,CAAW,OAAA,GAAU,UAAA;AACrB,IAAA,UAAA,EAAW;AACX,IAAA,KAAA,MAAW,QAAQ,UAAA,EAAY;AAC7B,MAAA,MAAA,CAAO,iBAAiB,IAAA,EAAM,UAAA,EAAY,EAAE,OAAA,EAAS,MAAM,CAAA;AAAA,IAC7D;AACA,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,aAAa,SAAS,CAAA;AAC7B,MAAA,KAAA,MAAW,QAAQ,UAAA,EAAY;AAC7B,QAAA,MAAA,CAAO,mBAAA,CAAoB,MAAM,UAAU,CAAA;AAAA,MAC7C;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAA,EAAW,SAAS,CAAC,CAAA;AAEzB,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,UAAA,CAAW,OAAA,EAAQ;AAAA,EACrB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,QAAQ,KAAA,EAAM;AACzB","file":"useIdleTimeout.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nconst DEFAULT_ACTIVITY_EVENTS = [\n  \"pointerdown\",\n  \"pointermove\",\n  \"keydown\",\n  \"wheel\",\n  \"touchstart\",\n  \"scroll\",\n] as const;\n\nexport type UseIdleTimeoutParams = {\n  /** Inactivity duration in milliseconds before the user counts as idle. */\n  timeoutMs: number;\n  /** Window events treated as activity (default: pointer, key, wheel, touch, scroll). */\n  events?: readonly string[];\n  /** Start in the idle state (default `false`). */\n  initiallyIdle?: boolean;\n  /** Called when the user becomes idle. */\n  onIdle?: () => void;\n  /** Called when activity resumes after being idle. */\n  onActive?: () => void;\n};\n\nexport type UseIdleTimeoutResult = {\n  /** Whether the user is currently idle. */\n  isIdle: boolean;\n  /** Mark the user active and restart the inactivity timer (e.g. after programmatic activity). */\n  reset: () => void;\n};\n\n/**\n * Detects user inactivity: `isIdle` flips to `true` after `timeoutMs` without any of the\n * activity events on `window`, and back to `false` on the next activity.\n *\n * - `onIdle` / `onActive` fire on transitions only (not on mount), and are read from refs\n *   so inline callbacks stay fresh.\n * - Useful for session expiry warnings, pausing media or polling, and presence indicators.\n *\n * @param params - {@link UseIdleTimeoutParams}\n * @returns {@link UseIdleTimeoutResult}\n */\nexport function useIdleTimeout({\n  timeoutMs,\n  events,\n  initiallyIdle = false,\n  onIdle,\n  onActive,\n}: UseIdleTimeoutParams): UseIdleTimeoutResult {\n  const [isIdle, setIsIdle] = useState(initiallyIdle);\n  const onIdleRef = useRef(onIdle);\n  const onActiveRef = useRef(onActive);\n  const restartRef = useRef<() => void>(() => {});\n  const firstRunRef = useRef(true);\n\n  useEffect(() => {\n    onIdleRef.current = onIdle;\n    onActiveRef.current = onActive;\n  }, [onActive, onIdle]);\n\n  useEffect(() => {\n    if (firstRunRef.current) {\n      firstRunRef.current = false;\n      return;\n    }\n    if (isIdle) {\n      onIdleRef.current?.();\n    } else {\n      onActiveRef.current?.();\n    }\n  }, [isIdle]);\n\n  const eventsKey = (events ?? DEFAULT_ACTIVITY_EVENTS).join(\" \");\n\n  useEffect(() => {\n    const eventNames = eventsKey.split(\" \").filter(Boolean);\n    let timeoutId: number | undefined;\n\n    const startTimer = () => {\n      window.clearTimeout(timeoutId);\n      timeoutId = window.setTimeout(() => {\n        setIsIdle(true);\n      }, timeoutMs);\n    };\n\n    const onActivity = () => {\n      setIsIdle(false);\n      startTimer();\n    };\n\n    restartRef.current = onActivity;\n    startTimer();\n    for (const name of eventNames) {\n      window.addEventListener(name, onActivity, { passive: true });\n    }\n    return () => {\n      window.clearTimeout(timeoutId);\n      for (const name of eventNames) {\n        window.removeEventListener(name, onActivity);\n      }\n    };\n  }, [eventsKey, timeoutMs]);\n\n  const reset = useCallback(() => {\n    restartRef.current();\n  }, []);\n\n  return { isIdle, reset };\n}\n"]}

package/dist/hooks/useInterval/index.d.ts

@@ -0,0 +1,2 @@
+export { useInterval } from "./useInterval";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useInterval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useInterval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/hooks/useInterval/useInterval.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Declarative `setInterval`: runs `callback` every `delayMs` milliseconds with automatic cleanup.
+ *
+ * - The latest callback is kept in a ref, so a new inline function each render does not restart the timer.
+ * - Pass `null` as the delay to pause the interval; pass a number again to resume.
+ * - Changing `delayMs` clears the previous interval and starts a fresh one.
+ *
+ * @param callback - Function invoked on every tick.
+ * @param delayMs - Interval in milliseconds, or `null` to pause.
+ */
+export declare function useInterval(callback: () => void, delayMs: number | null): void;
+//# sourceMappingURL=useInterval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.d.ts","sourceRoot":"","sources":["../../../src/hooks/useInterval/useInterval.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,IAAI,CAkBN"}

package/dist/hooks/useInterval.js

@@ -0,0 +1,27 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function useInterval(callback, delayMs) {
+  const callbackRef = react.useRef(callback);
+  react.useEffect(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+  react.useEffect(() => {
+    if (delayMs == null) {
+      return;
+    }
+    const id = window.setInterval(() => {
+      callbackRef.current();
+    }, delayMs);
+    return () => {
+      window.clearInterval(id);
+    };
+  }, [delayMs]);
+}
+
+exports.useInterval = useInterval;
+//# sourceMappingURL=useInterval.js.map
+//# sourceMappingURL=useInterval.js.map