@zentauri-ui/zentauri-components 1.9.2 → 2.1.0

package/dist/hooks/useCookie.mjs

@@ -0,0 +1,74 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useState, useCallback, useEffect } from 'react';
+
+function readCookie(name) {
+  if (typeof document === "undefined") {
+    return null;
+  }
+  const prefix = `${encodeURIComponent(name)}=`;
+  const match = document.cookie.split("; ").find((row) => row.startsWith(prefix));
+  if (!match) {
+    return null;
+  }
+  try {
+    return decodeURIComponent(match.slice(prefix.length));
+  } catch {
+    return null;
+  }
+}
+function serializeCookie(name, value, options) {
+  const { maxAgeSeconds, expires, path = "/", domain, sameSite } = options;
+  const secure = options.secure || sameSite === "none";
+  let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}; path=${path}`;
+  if (maxAgeSeconds != null) {
+    cookie += `; max-age=${maxAgeSeconds}`;
+  }
+  if (expires) {
+    cookie += `; expires=${expires.toUTCString()}`;
+  }
+  if (domain) {
+    cookie += `; domain=${domain}`;
+  }
+  if (secure) {
+    cookie += "; secure";
+  }
+  if (sameSite) {
+    cookie += `; samesite=${sameSite}`;
+  }
+  return cookie;
+}
+function useCookie(name, initialValue) {
+  const [value, setValueState] = useState(initialValue ?? null);
+  const setCookie = useCallback(
+    (value2, options = {}) => {
+      if (typeof document === "undefined") {
+        return;
+      }
+      document.cookie = serializeCookie(name, value2, options);
+      setValueState(value2);
+    },
+    [name]
+  );
+  const removeCookie = useCallback(
+    (options = {}) => {
+      if (typeof document === "undefined") {
+        return;
+      }
+      document.cookie = serializeCookie(name, "", {
+        ...options,
+        maxAgeSeconds: 0
+      });
+      setValueState(null);
+    },
+    [name]
+  );
+  useEffect(() => {
+    setValueState(readCookie(name) ?? initialValue ?? null);
+  }, [name]);
+  return [value, setCookie, removeCookie];
+}
+
+export { useCookie };
+//# sourceMappingURL=useCookie.mjs.map
+//# sourceMappingURL=useCookie.mjs.map

package/dist/hooks/useCookie.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useCookie/useCookie.ts"],"names":["value"],"mappings":"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","file":"useCookie.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useState } from \"react\";\n\nexport type CookieOptions = {\n  /** Lifetime in seconds (sets `max-age`). Omit for a session cookie. */\n  maxAgeSeconds?: number;\n  /** Absolute expiry (sets `expires`). */\n  expires?: Date;\n  /** Cookie path (default `\"/\"`). */\n  path?: string;\n  /** Cookie domain. */\n  domain?: string;\n  /** Restrict to HTTPS. */\n  secure?: boolean;\n  /** SameSite attribute. `\"none\"` automatically forces `secure` per browser requirements. */\n  sameSite?: \"strict\" | \"lax\" | \"none\";\n};\n\nexport type UseCookieResult = [\n  string | null,\n  (value: string, options?: CookieOptions) => void,\n  (options?: Pick<CookieOptions, \"path\" | \"domain\">) => void,\n];\n\nfunction readCookie(name: string): string | null {\n  if (typeof document === \"undefined\") {\n    return null;\n  }\n  const prefix = `${encodeURIComponent(name)}=`;\n  const match = document.cookie\n    .split(\"; \")\n    .find((row) => row.startsWith(prefix));\n  if (!match) {\n    return null;\n  }\n  try {\n    return decodeURIComponent(match.slice(prefix.length));\n  } catch {\n    // Malformed cookie value — return null rather than crashing.\n    return null;\n  }\n}\n\nfunction serializeCookie(\n  name: string,\n  value: string,\n  options: CookieOptions,\n): string {\n  const { maxAgeSeconds, expires, path = \"/\", domain, sameSite } = options;\n  // SameSite=None requires Secure; enforce it automatically.\n  const secure = options.secure || sameSite === \"none\";\n  let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}; path=${path}`;\n  if (maxAgeSeconds != null) {\n    cookie += `; max-age=${maxAgeSeconds}`;\n  }\n  if (expires) {\n    cookie += `; expires=${expires.toUTCString()}`;\n  }\n  if (domain) {\n    cookie += `; domain=${domain}`;\n  }\n  if (secure) {\n    cookie += \"; secure\";\n  }\n  if (sameSite) {\n    cookie += `; samesite=${sameSite}`;\n  }\n  return cookie;\n}\n\n/**\n * Reads and writes a single cookie with React state that stays in sync with your updates.\n *\n * - Initial state is `initialValue` (or `null`) to avoid SSR hydration mismatches; the actual\n *   cookie value is read on mount via a `useEffect`.\n * - `setCookie` writes `document.cookie` (URI-encoded) and updates state in the same call.\n * - `removeCookie` expires the cookie via `max-age=0`; pass the same `path` / `domain` used when setting.\n * - Reactivity covers writes made through this hook instance; cookies changed elsewhere are\n *   re-read only when `name` changes (the browser offers no cookie change event in wide support).\n * - `SameSite=\"none\"` automatically forces the `Secure` flag per browser requirements.\n *\n * @param name - Cookie name.\n * @param initialValue - Fallback when the cookie is absent (and during SSR).\n * @returns `[value, setCookie, removeCookie]`.\n */\nexport function useCookie(\n  name: string,\n  initialValue?: string,\n): UseCookieResult {\n  // Initialize to initialValue (not readCookie) to avoid SSR hydration mismatches.\n  // The effect below syncs the actual cookie value after mount.\n  const [value, setValueState] = useState<string | null>(initialValue ?? null);\n\n  const setCookie = useCallback(\n    (value: string, options: CookieOptions = {}) => {\n      if (typeof document === \"undefined\") {\n        return;\n      }\n      document.cookie = serializeCookie(name, value, options);\n      setValueState(value);\n    },\n    [name],\n  );\n\n  const removeCookie = useCallback(\n    (options: Pick<CookieOptions, \"path\" | \"domain\"> = {}) => {\n      if (typeof document === \"undefined\") {\n        return;\n      }\n      document.cookie = serializeCookie(name, \"\", {\n        ...options,\n        maxAgeSeconds: 0,\n      });\n      setValueState(null);\n    },\n    [name],\n  );\n\n  useEffect(() => {\n    setValueState(readCookie(name) ?? initialValue ?? null);\n    // Intentionally keyed by name only: initialValue is a fallback, not a data source.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [name]);\n\n  return [value, setCookie, removeCookie];\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCountdown/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/hooks/useCountdown/useCountdown.d.ts

@@ -0,0 +1,40 @@
+export type UseCountdownParams = {
+    /** Value the countdown starts from. */
+    countStart: number;
+    /** Value the countdown stops at (default `0`). */
+    countStop?: number;
+    /** Milliseconds between ticks (default `1000`). */
+    intervalMs?: number;
+    /** Start counting immediately on mount (default `false`). */
+    autoStart?: boolean;
+    /** Called once when the countdown reaches `countStop`. */
+    onComplete?: () => void;
+};
+export type UseCountdownResult = {
+    /** Current count value. */
+    count: number;
+    /** Whether the countdown is actively ticking. */
+    isRunning: boolean;
+    /** Whether the countdown has reached `countStop`. */
+    isComplete: boolean;
+    /** Reset to `countStart` and begin ticking. */
+    start: () => void;
+    /** Stop ticking, keeping the current count. */
+    pause: () => void;
+    /** Continue ticking from the current count. No-op if the countdown is complete. */
+    resume: () => void;
+    /** Stop ticking and reset the count to `countStart`. */
+    reset: () => void;
+};
+/**
+ * Countdown timer decrementing by one each tick, with start, pause, resume, and reset controls.
+ *
+ * - Counts from `countStart` down to `countStop` (default `0`) every `intervalMs` (default 1s).
+ * - `onComplete` fires once when the count reaches `countStop`; the timer stops automatically.
+ * - `resume` on a completed countdown is a no-op; call `start` or `reset` to run it again.
+ *
+ * @param params - {@link UseCountdownParams}
+ * @returns {@link UseCountdownResult}
+ */
+export declare function useCountdown({ countStart, countStop, intervalMs, autoStart, onComplete, }: UseCountdownParams): UseCountdownResult;
+//# sourceMappingURL=useCountdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCountdown.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCountdown/useCountdown.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,mFAAmF;IACnF,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,UAAU,EACV,SAAa,EACb,UAAiB,EACjB,SAAiB,EACjB,UAAU,GACX,EAAE,kBAAkB,GAAG,kBAAkB,CAuDzC"}

package/dist/hooks/useCountdown.js

@@ -0,0 +1,60 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function useCountdown({
+  countStart,
+  countStop = 0,
+  intervalMs = 1e3,
+  autoStart = false,
+  onComplete
+}) {
+  const [count, setCount] = react.useState(countStart);
+  const [isRunning, setIsRunning] = react.useState(autoStart);
+  const onCompleteRef = react.useRef(onComplete);
+  react.useEffect(() => {
+    onCompleteRef.current = onComplete;
+  }, [onComplete]);
+  const isComplete = count <= countStop;
+  react.useEffect(() => {
+    if (!isRunning) {
+      return;
+    }
+    const id = window.setInterval(() => {
+      setCount((previous) => Math.max(countStop, previous - 1));
+    }, intervalMs);
+    return () => {
+      window.clearInterval(id);
+    };
+  }, [countStop, intervalMs, isRunning]);
+  react.useEffect(() => {
+    if (isRunning && count <= countStop) {
+      setIsRunning(false);
+      onCompleteRef.current?.();
+    }
+  }, [count, countStop, isRunning]);
+  const start = react.useCallback(() => {
+    setCount(countStart);
+    setIsRunning(true);
+  }, [countStart]);
+  const pause = react.useCallback(() => {
+    setIsRunning(false);
+  }, []);
+  const resume = react.useCallback(() => {
+    if (isComplete) {
+      return;
+    }
+    setIsRunning(true);
+  }, [isComplete]);
+  const reset = react.useCallback(() => {
+    setIsRunning(false);
+    setCount(countStart);
+  }, [countStart]);
+  return { count, isRunning, isComplete, start, pause, resume, reset };
+}
+
+exports.useCountdown = useCountdown;
+//# sourceMappingURL=useCountdown.js.map
+//# sourceMappingURL=useCountdown.js.map

package/dist/hooks/useCountdown.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useCountdown/useCountdown.ts"],"names":["useState","useRef","useEffect","useCallback"],"mappings":";;;;;AA4CO,SAAS,YAAA,CAAa;AAAA,EAC3B,UAAA;AAAA,EACA,SAAA,GAAY,CAAA;AAAA,EACZ,UAAA,GAAa,GAAA;AAAA,EACb,SAAA,GAAY,KAAA;AAAA,EACZ;AACF,CAAA,EAA2C;AACzC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAS,UAAU,CAAA;AAC7C,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIA,eAAS,SAAS,CAAA;AACpD,EAAA,MAAM,aAAA,GAAgBC,aAAO,UAAU,CAAA;AAEvC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,aAAA,CAAc,OAAA,GAAU,UAAA;AAAA,EAC1B,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,MAAM,aAAa,KAAA,IAAS,SAAA;AAI5B,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA;AAAA,IACF;AACA,IAAA,MAAM,EAAA,GAAK,MAAA,CAAO,WAAA,CAAY,MAAM;AAClC,MAAA,QAAA,CAAS,CAAC,QAAA,KAAa,IAAA,CAAK,IAAI,SAAA,EAAW,QAAA,GAAW,CAAC,CAAC,CAAA;AAAA,IAC1D,GAAG,UAAU,CAAA;AACb,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,cAAc,EAAE,CAAA;AAAA,IACzB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAA,EAAW,UAAA,EAAY,SAAS,CAAC,CAAA;AAErC,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,IAAa,SAAS,SAAA,EAAW;AACnC,MAAA,YAAA,CAAa,KAAK,CAAA;AAClB,MAAA,aAAA,CAAc,OAAA,IAAU;AAAA,IAC1B;AAAA,EACF,CAAA,EAAG,CAAC,KAAA,EAAO,SAAA,EAAW,SAAS,CAAC,CAAA;AAEhC,EAAA,MAAM,KAAA,GAAQC,kBAAY,MAAM;AAC9B,IAAA,QAAA,CAAS,UAAU,CAAA;AACnB,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,MAAM,KAAA,GAAQA,kBAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAAA,EACpB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,MAAA,GAASA,kBAAY,MAAM;AAE/B,IAAA,IAAI,UAAA,EAAY;AACd,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,MAAM,KAAA,GAAQA,kBAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAClB,IAAA,QAAA,CAAS,UAAU,CAAA;AAAA,EACrB,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,OAAO,EAAE,KAAA,EAAO,SAAA,EAAW,YAAY,KAAA,EAAO,KAAA,EAAO,QAAQ,KAAA,EAAM;AACrE","file":"useCountdown.js","sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport type UseCountdownParams = {\n  /** Value the countdown starts from. */\n  countStart: number;\n  /** Value the countdown stops at (default `0`). */\n  countStop?: number;\n  /** Milliseconds between ticks (default `1000`). */\n  intervalMs?: number;\n  /** Start counting immediately on mount (default `false`). */\n  autoStart?: boolean;\n  /** Called once when the countdown reaches `countStop`. */\n  onComplete?: () => void;\n};\n\nexport type UseCountdownResult = {\n  /** Current count value. */\n  count: number;\n  /** Whether the countdown is actively ticking. */\n  isRunning: boolean;\n  /** Whether the countdown has reached `countStop`. */\n  isComplete: boolean;\n  /** Reset to `countStart` and begin ticking. */\n  start: () => void;\n  /** Stop ticking, keeping the current count. */\n  pause: () => void;\n  /** Continue ticking from the current count. No-op if the countdown is complete. */\n  resume: () => void;\n  /** Stop ticking and reset the count to `countStart`. */\n  reset: () => void;\n};\n\n/**\n * Countdown timer decrementing by one each tick, with start, pause, resume, and reset controls.\n *\n * - Counts from `countStart` down to `countStop` (default `0`) every `intervalMs` (default 1s).\n * - `onComplete` fires once when the count reaches `countStop`; the timer stops automatically.\n * - `resume` on a completed countdown is a no-op; call `start` or `reset` to run it again.\n *\n * @param params - {@link UseCountdownParams}\n * @returns {@link UseCountdownResult}\n */\nexport function useCountdown({\n  countStart,\n  countStop = 0,\n  intervalMs = 1000,\n  autoStart = false,\n  onComplete,\n}: UseCountdownParams): UseCountdownResult {\n  const [count, setCount] = useState(countStart);\n  const [isRunning, setIsRunning] = useState(autoStart);\n  const onCompleteRef = useRef(onComplete);\n\n  useEffect(() => {\n    onCompleteRef.current = onComplete;\n  }, [onComplete]);\n\n  const isComplete = count <= countStop;\n\n  // Interval effect: does NOT include `count` in deps so the timer is not recreated on every tick.\n  // Completion is handled by the separate effect below.\n  useEffect(() => {\n    if (!isRunning) {\n      return;\n    }\n    const id = window.setInterval(() => {\n      setCount((previous) => Math.max(countStop, previous - 1));\n    }, intervalMs);\n    return () => {\n      window.clearInterval(id);\n    };\n  }, [countStop, intervalMs, isRunning]);\n\n  useEffect(() => {\n    if (isRunning && count <= countStop) {\n      setIsRunning(false);\n      onCompleteRef.current?.();\n    }\n  }, [count, countStop, isRunning]);\n\n  const start = useCallback(() => {\n    setCount(countStart);\n    setIsRunning(true);\n  }, [countStart]);\n\n  const pause = useCallback(() => {\n    setIsRunning(false);\n  }, []);\n\n  const resume = useCallback(() => {\n    // No-op when the countdown has already reached countStop to prevent retriggering onComplete.\n    if (isComplete) {\n      return;\n    }\n    setIsRunning(true);\n  }, [isComplete]);\n\n  const reset = useCallback(() => {\n    setIsRunning(false);\n    setCount(countStart);\n  }, [countStart]);\n\n  return { count, isRunning, isComplete, start, pause, resume, reset };\n}\n"]}

package/dist/hooks/useCountdown.mjs

@@ -0,0 +1,58 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useState, useRef, useEffect, useCallback } from 'react';
+
+function useCountdown({
+  countStart,
+  countStop = 0,
+  intervalMs = 1e3,
+  autoStart = false,
+  onComplete
+}) {
+  const [count, setCount] = useState(countStart);
+  const [isRunning, setIsRunning] = useState(autoStart);
+  const onCompleteRef = useRef(onComplete);
+  useEffect(() => {
+    onCompleteRef.current = onComplete;
+  }, [onComplete]);
+  const isComplete = count <= countStop;
+  useEffect(() => {
+    if (!isRunning) {
+      return;
+    }
+    const id = window.setInterval(() => {
+      setCount((previous) => Math.max(countStop, previous - 1));
+    }, intervalMs);
+    return () => {
+      window.clearInterval(id);
+    };
+  }, [countStop, intervalMs, isRunning]);
+  useEffect(() => {
+    if (isRunning && count <= countStop) {
+      setIsRunning(false);
+      onCompleteRef.current?.();
+    }
+  }, [count, countStop, isRunning]);
+  const start = useCallback(() => {
+    setCount(countStart);
+    setIsRunning(true);
+  }, [countStart]);
+  const pause = useCallback(() => {
+    setIsRunning(false);
+  }, []);
+  const resume = useCallback(() => {
+    if (isComplete) {
+      return;
+    }
+    setIsRunning(true);
+  }, [isComplete]);
+  const reset = useCallback(() => {
+    setIsRunning(false);
+    setCount(countStart);
+  }, [countStart]);
+  return { count, isRunning, isComplete, start, pause, resume, reset };
+}
+
+export { useCountdown };
+//# sourceMappingURL=useCountdown.mjs.map
+//# sourceMappingURL=useCountdown.mjs.map

package/dist/hooks/useCountdown.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useCountdown/useCountdown.ts"],"names":[],"mappings":";;;AA4CO,SAAS,YAAA,CAAa;AAAA,EAC3B,UAAA;AAAA,EACA,SAAA,GAAY,CAAA;AAAA,EACZ,UAAA,GAAa,GAAA;AAAA,EACb,SAAA,GAAY,KAAA;AAAA,EACZ;AACF,CAAA,EAA2C;AACzC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAS,UAAU,CAAA;AAC7C,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAI,SAAS,SAAS,CAAA;AACpD,EAAA,MAAM,aAAA,GAAgB,OAAO,UAAU,CAAA;AAEvC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,aAAA,CAAc,OAAA,GAAU,UAAA;AAAA,EAC1B,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,MAAM,aAAa,KAAA,IAAS,SAAA;AAI5B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA;AAAA,IACF;AACA,IAAA,MAAM,EAAA,GAAK,MAAA,CAAO,WAAA,CAAY,MAAM;AAClC,MAAA,QAAA,CAAS,CAAC,QAAA,KAAa,IAAA,CAAK,IAAI,SAAA,EAAW,QAAA,GAAW,CAAC,CAAC,CAAA;AAAA,IAC1D,GAAG,UAAU,CAAA;AACb,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,cAAc,EAAE,CAAA;AAAA,IACzB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAA,EAAW,UAAA,EAAY,SAAS,CAAC,CAAA;AAErC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,IAAa,SAAS,SAAA,EAAW;AACnC,MAAA,YAAA,CAAa,KAAK,CAAA;AAClB,MAAA,aAAA,CAAc,OAAA,IAAU;AAAA,IAC1B;AAAA,EACF,CAAA,EAAG,CAAC,KAAA,EAAO,SAAA,EAAW,SAAS,CAAC,CAAA;AAEhC,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,QAAA,CAAS,UAAU,CAAA;AACnB,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAAA,EACpB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,MAAA,GAAS,YAAY,MAAM;AAE/B,IAAA,IAAI,UAAA,EAAY;AACd,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAClB,IAAA,QAAA,CAAS,UAAU,CAAA;AAAA,EACrB,CAAA,EAAG,CAAC,UAAU,CAAC,CAAA;AAEf,EAAA,OAAO,EAAE,KAAA,EAAO,SAAA,EAAW,YAAY,KAAA,EAAO,KAAA,EAAO,QAAQ,KAAA,EAAM;AACrE","file":"useCountdown.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport type UseCountdownParams = {\n  /** Value the countdown starts from. */\n  countStart: number;\n  /** Value the countdown stops at (default `0`). */\n  countStop?: number;\n  /** Milliseconds between ticks (default `1000`). */\n  intervalMs?: number;\n  /** Start counting immediately on mount (default `false`). */\n  autoStart?: boolean;\n  /** Called once when the countdown reaches `countStop`. */\n  onComplete?: () => void;\n};\n\nexport type UseCountdownResult = {\n  /** Current count value. */\n  count: number;\n  /** Whether the countdown is actively ticking. */\n  isRunning: boolean;\n  /** Whether the countdown has reached `countStop`. */\n  isComplete: boolean;\n  /** Reset to `countStart` and begin ticking. */\n  start: () => void;\n  /** Stop ticking, keeping the current count. */\n  pause: () => void;\n  /** Continue ticking from the current count. No-op if the countdown is complete. */\n  resume: () => void;\n  /** Stop ticking and reset the count to `countStart`. */\n  reset: () => void;\n};\n\n/**\n * Countdown timer decrementing by one each tick, with start, pause, resume, and reset controls.\n *\n * - Counts from `countStart` down to `countStop` (default `0`) every `intervalMs` (default 1s).\n * - `onComplete` fires once when the count reaches `countStop`; the timer stops automatically.\n * - `resume` on a completed countdown is a no-op; call `start` or `reset` to run it again.\n *\n * @param params - {@link UseCountdownParams}\n * @returns {@link UseCountdownResult}\n */\nexport function useCountdown({\n  countStart,\n  countStop = 0,\n  intervalMs = 1000,\n  autoStart = false,\n  onComplete,\n}: UseCountdownParams): UseCountdownResult {\n  const [count, setCount] = useState(countStart);\n  const [isRunning, setIsRunning] = useState(autoStart);\n  const onCompleteRef = useRef(onComplete);\n\n  useEffect(() => {\n    onCompleteRef.current = onComplete;\n  }, [onComplete]);\n\n  const isComplete = count <= countStop;\n\n  // Interval effect: does NOT include `count` in deps so the timer is not recreated on every tick.\n  // Completion is handled by the separate effect below.\n  useEffect(() => {\n    if (!isRunning) {\n      return;\n    }\n    const id = window.setInterval(() => {\n      setCount((previous) => Math.max(countStop, previous - 1));\n    }, intervalMs);\n    return () => {\n      window.clearInterval(id);\n    };\n  }, [countStop, intervalMs, isRunning]);\n\n  useEffect(() => {\n    if (isRunning && count <= countStop) {\n      setIsRunning(false);\n      onCompleteRef.current?.();\n    }\n  }, [count, countStop, isRunning]);\n\n  const start = useCallback(() => {\n    setCount(countStart);\n    setIsRunning(true);\n  }, [countStart]);\n\n  const pause = useCallback(() => {\n    setIsRunning(false);\n  }, []);\n\n  const resume = useCallback(() => {\n    // No-op when the countdown has already reached countStop to prevent retriggering onComplete.\n    if (isComplete) {\n      return;\n    }\n    setIsRunning(true);\n  }, [isComplete]);\n\n  const reset = useCallback(() => {\n    setIsRunning(false);\n    setCount(countStart);\n  }, [countStart]);\n\n  return { count, isRunning, isComplete, start, pause, resume, reset };\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useEventListener/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC"}

package/dist/hooks/useEventListener/useEventListener.d.ts

@@ -0,0 +1,22 @@
+import type { RefObject } from "react";
+export type UseEventListenerTarget = EventTarget | RefObject<EventTarget | null> | null;
+/**
+ * Attaches a DOM event listener with automatic cleanup and a stable wrapper around the latest handler.
+ *
+ * - Defaults to `window`; pass an element, `document`, or a React ref object as `target`.
+ * - Pass explicit `null` as `target` to skip attaching (useful for conditional subscriptions).
+ * - The handler is kept in a ref, so passing a new inline function each render does not re-subscribe.
+ * - Ref targets are resolved when the effect runs (after mount); if the ref is retargeted later,
+ *   re-render with a state-backed node (or key the component) to re-subscribe.
+ * - Pass `options` as individual booleans or a stable object reference to avoid re-subscribing on
+ *   every render. Internally, `capture`, `passive`, and `once` are compared individually.
+ *
+ * @param eventName - DOM event name (typed against `WindowEventMap` / `DocumentEventMap` / `HTMLElementEventMap`).
+ * @param handler - Listener invoked with the native event.
+ * @param target - Event target, React ref to one, `undefined` for `window`, or `null` to skip.
+ * @param options - Standard `addEventListener` options.
+ */
+export declare function useEventListener<K extends keyof WindowEventMap>(eventName: K, handler: (event: WindowEventMap[K]) => void, target?: Window | null, options?: boolean | AddEventListenerOptions): void;
+export declare function useEventListener<K extends keyof DocumentEventMap>(eventName: K, handler: (event: DocumentEventMap[K]) => void, target: Document | RefObject<Document | null>, options?: boolean | AddEventListenerOptions): void;
+export declare function useEventListener<K extends keyof HTMLElementEventMap, T extends HTMLElement = HTMLElement>(eventName: K, handler: (event: HTMLElementEventMap[K]) => void, target: T | RefObject<T | null> | null, options?: boolean | AddEventListenerOptions): void;
+//# sourceMappingURL=useEventListener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEventListener.d.ts","sourceRoot":"","sources":["../../../src/hooks/useEventListener/useEventListener.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAC7B,IAAI,CAAC;AAmBT;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7D,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,EAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;AACR,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC/D,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7C,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EAC7C,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;AACR,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,MAAM,mBAAmB,EACnC,CAAC,SAAS,WAAW,GAAG,WAAW,EAEnC,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAChD,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,EACtC,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC"}

package/dist/hooks/useEventListener.js

@@ -0,0 +1,45 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function resolveTarget(target) {
+  if (target === void 0) {
+    return typeof window === "undefined" ? null : window;
+  }
+  if (target === null) {
+    return null;
+  }
+  if (target instanceof EventTarget) {
+    return target;
+  }
+  return target.current;
+}
+function useEventListener(eventName, handler, target, options) {
+  const handlerRef = react.useRef(handler);
+  react.useEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+  const capture = typeof options === "boolean" ? options : options?.capture ?? false;
+  const passive = typeof options === "object" ? options?.passive ?? false : false;
+  const once = typeof options === "object" ? options?.once ?? false : false;
+  react.useEffect(() => {
+    const node = resolveTarget(target);
+    if (node == null) {
+      return;
+    }
+    const listenerOptions = { capture, passive, once };
+    const listener = (event) => {
+      handlerRef.current(event);
+    };
+    node.addEventListener(eventName, listener, listenerOptions);
+    return () => {
+      node.removeEventListener(eventName, listener, listenerOptions);
+    };
+  }, [eventName, target, capture, passive, once]);
+}
+
+exports.useEventListener = useEventListener;
+//# sourceMappingURL=useEventListener.js.map
+//# sourceMappingURL=useEventListener.js.map

package/dist/hooks/useEventListener.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useEventListener/useEventListener.ts"],"names":["useRef","useEffect"],"mappings":";;;;;AAUA,SAAS,cACP,MAAA,EACoB;AACpB,EAAA,IAAI,WAAW,MAAA,EAAW;AAExB,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,IAAA,GAAO,MAAA;AAAA,EAChD;AACA,EAAA,IAAI,WAAW,IAAA,EAAM;AAEnB,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,kBAAkB,WAAA,EAAa;AACjC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,OAAA;AAChB;AAuCO,SAAS,gBAAA,CACd,SAAA,EACA,OAAA,EACA,MAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,UAAA,GAAaA,aAAO,OAAO,CAAA;AAEjC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AAAA,EACvB,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAIZ,EAAA,MAAM,UACJ,OAAO,OAAA,KAAY,SAAA,GAAY,OAAA,GAAW,SAAS,OAAA,IAAW,KAAA;AAChE,EAAA,MAAM,UACJ,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,WAAW,KAAA,GAAS,KAAA;AAC9D,EAAA,MAAM,OAAO,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,QAAQ,KAAA,GAAS,KAAA;AAEtE,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,IAAA,GAAO,cAAc,MAAM,CAAA;AACjC,IAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,eAAA,GAAkB,EAAE,OAAA,EAAS,OAAA,EAAS,IAAA,EAAK;AACjD,IAAA,MAAM,QAAA,GAAW,CAAC,KAAA,KAAiB;AACjC,MAAA,UAAA,CAAW,QAAQ,KAAK,CAAA;AAAA,IAC1B,CAAA;AACA,IAAA,IAAA,CAAK,gBAAA,CAAiB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAC1D,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,mBAAA,CAAoB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAAA,IAC/D,CAAA;AAAA,EACF,GAAG,CAAC,SAAA,EAAW,QAAQ,OAAA,EAAS,OAAA,EAAS,IAAI,CAAC,CAAA;AAChD","file":"useEventListener.js","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\n\nexport type UseEventListenerTarget =\n  | EventTarget\n  | RefObject<EventTarget | null>\n  | null;\n\nfunction resolveTarget(\n  target: UseEventListenerTarget | undefined,\n): EventTarget | null {\n  if (target === undefined) {\n    // No target specified — default to window.\n    return typeof window === \"undefined\" ? null : window;\n  }\n  if (target === null) {\n    // Explicit null — caller opts out; do not attach any listener.\n    return null;\n  }\n  if (target instanceof EventTarget) {\n    return target;\n  }\n  return target.current;\n}\n\n/**\n * Attaches a DOM event listener with automatic cleanup and a stable wrapper around the latest handler.\n *\n * - Defaults to `window`; pass an element, `document`, or a React ref object as `target`.\n * - Pass explicit `null` as `target` to skip attaching (useful for conditional subscriptions).\n * - The handler is kept in a ref, so passing a new inline function each render does not re-subscribe.\n * - Ref targets are resolved when the effect runs (after mount); if the ref is retargeted later,\n *   re-render with a state-backed node (or key the component) to re-subscribe.\n * - Pass `options` as individual booleans or a stable object reference to avoid re-subscribing on\n *   every render. Internally, `capture`, `passive`, and `once` are compared individually.\n *\n * @param eventName - DOM event name (typed against `WindowEventMap` / `DocumentEventMap` / `HTMLElementEventMap`).\n * @param handler - Listener invoked with the native event.\n * @param target - Event target, React ref to one, `undefined` for `window`, or `null` to skip.\n * @param options - Standard `addEventListener` options.\n */\nexport function useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  target?: Window | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  target: Document | RefObject<Document | null>,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<\n  K extends keyof HTMLElementEventMap,\n  T extends HTMLElement = HTMLElement,\n>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  target: T | RefObject<T | null> | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener(\n  eventName: string,\n  handler: (event: Event) => void,\n  target?: UseEventListenerTarget,\n  options?: boolean | AddEventListenerOptions,\n): void {\n  const handlerRef = useRef(handler);\n\n  useEffect(() => {\n    handlerRef.current = handler;\n  }, [handler]);\n\n  // Destructure options to stable primitives so an inline `{ passive: true }` object literal\n  // passed by callers does not cause the listener to be removed and re-added on every render.\n  const capture =\n    typeof options === \"boolean\" ? options : (options?.capture ?? false);\n  const passive =\n    typeof options === \"object\" ? (options?.passive ?? false) : false;\n  const once = typeof options === \"object\" ? (options?.once ?? false) : false;\n\n  useEffect(() => {\n    const node = resolveTarget(target);\n    if (node == null) {\n      return;\n    }\n    const listenerOptions = { capture, passive, once };\n    const listener = (event: Event) => {\n      handlerRef.current(event);\n    };\n    node.addEventListener(eventName, listener, listenerOptions);\n    return () => {\n      node.removeEventListener(eventName, listener, listenerOptions);\n    };\n  }, [eventName, target, capture, passive, once]);\n}\n"]}

package/dist/hooks/useEventListener.mjs

@@ -0,0 +1,43 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useRef, useEffect } from 'react';
+
+function resolveTarget(target) {
+  if (target === void 0) {
+    return typeof window === "undefined" ? null : window;
+  }
+  if (target === null) {
+    return null;
+  }
+  if (target instanceof EventTarget) {
+    return target;
+  }
+  return target.current;
+}
+function useEventListener(eventName, handler, target, options) {
+  const handlerRef = useRef(handler);
+  useEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+  const capture = typeof options === "boolean" ? options : options?.capture ?? false;
+  const passive = typeof options === "object" ? options?.passive ?? false : false;
+  const once = typeof options === "object" ? options?.once ?? false : false;
+  useEffect(() => {
+    const node = resolveTarget(target);
+    if (node == null) {
+      return;
+    }
+    const listenerOptions = { capture, passive, once };
+    const listener = (event) => {
+      handlerRef.current(event);
+    };
+    node.addEventListener(eventName, listener, listenerOptions);
+    return () => {
+      node.removeEventListener(eventName, listener, listenerOptions);
+    };
+  }, [eventName, target, capture, passive, once]);
+}
+
+export { useEventListener };
+//# sourceMappingURL=useEventListener.mjs.map
+//# sourceMappingURL=useEventListener.mjs.map

package/dist/hooks/useEventListener.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useEventListener/useEventListener.ts"],"names":[],"mappings":";;;AAUA,SAAS,cACP,MAAA,EACoB;AACpB,EAAA,IAAI,WAAW,MAAA,EAAW;AAExB,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,IAAA,GAAO,MAAA;AAAA,EAChD;AACA,EAAA,IAAI,WAAW,IAAA,EAAM;AAEnB,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,kBAAkB,WAAA,EAAa;AACjC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,OAAA;AAChB;AAuCO,SAAS,gBAAA,CACd,SAAA,EACA,OAAA,EACA,MAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,UAAA,GAAa,OAAO,OAAO,CAAA;AAEjC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AAAA,EACvB,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAIZ,EAAA,MAAM,UACJ,OAAO,OAAA,KAAY,SAAA,GAAY,OAAA,GAAW,SAAS,OAAA,IAAW,KAAA;AAChE,EAAA,MAAM,UACJ,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,WAAW,KAAA,GAAS,KAAA;AAC9D,EAAA,MAAM,OAAO,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,QAAQ,KAAA,GAAS,KAAA;AAEtE,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,IAAA,GAAO,cAAc,MAAM,CAAA;AACjC,IAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,eAAA,GAAkB,EAAE,OAAA,EAAS,OAAA,EAAS,IAAA,EAAK;AACjD,IAAA,MAAM,QAAA,GAAW,CAAC,KAAA,KAAiB;AACjC,MAAA,UAAA,CAAW,QAAQ,KAAK,CAAA;AAAA,IAC1B,CAAA;AACA,IAAA,IAAA,CAAK,gBAAA,CAAiB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAC1D,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,mBAAA,CAAoB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAAA,IAC/D,CAAA;AAAA,EACF,GAAG,CAAC,SAAA,EAAW,QAAQ,OAAA,EAAS,OAAA,EAAS,IAAI,CAAC,CAAA;AAChD","file":"useEventListener.mjs","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\n\nexport type UseEventListenerTarget =\n  | EventTarget\n  | RefObject<EventTarget | null>\n  | null;\n\nfunction resolveTarget(\n  target: UseEventListenerTarget | undefined,\n): EventTarget | null {\n  if (target === undefined) {\n    // No target specified — default to window.\n    return typeof window === \"undefined\" ? null : window;\n  }\n  if (target === null) {\n    // Explicit null — caller opts out; do not attach any listener.\n    return null;\n  }\n  if (target instanceof EventTarget) {\n    return target;\n  }\n  return target.current;\n}\n\n/**\n * Attaches a DOM event listener with automatic cleanup and a stable wrapper around the latest handler.\n *\n * - Defaults to `window`; pass an element, `document`, or a React ref object as `target`.\n * - Pass explicit `null` as `target` to skip attaching (useful for conditional subscriptions).\n * - The handler is kept in a ref, so passing a new inline function each render does not re-subscribe.\n * - Ref targets are resolved when the effect runs (after mount); if the ref is retargeted later,\n *   re-render with a state-backed node (or key the component) to re-subscribe.\n * - Pass `options` as individual booleans or a stable object reference to avoid re-subscribing on\n *   every render. Internally, `capture`, `passive`, and `once` are compared individually.\n *\n * @param eventName - DOM event name (typed against `WindowEventMap` / `DocumentEventMap` / `HTMLElementEventMap`).\n * @param handler - Listener invoked with the native event.\n * @param target - Event target, React ref to one, `undefined` for `window`, or `null` to skip.\n * @param options - Standard `addEventListener` options.\n */\nexport function useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  target?: Window | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  target: Document | RefObject<Document | null>,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<\n  K extends keyof HTMLElementEventMap,\n  T extends HTMLElement = HTMLElement,\n>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  target: T | RefObject<T | null> | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener(\n  eventName: string,\n  handler: (event: Event) => void,\n  target?: UseEventListenerTarget,\n  options?: boolean | AddEventListenerOptions,\n): void {\n  const handlerRef = useRef(handler);\n\n  useEffect(() => {\n    handlerRef.current = handler;\n  }, [handler]);\n\n  // Destructure options to stable primitives so an inline `{ passive: true }` object literal\n  // passed by callers does not cause the listener to be removed and re-added on every render.\n  const capture =\n    typeof options === \"boolean\" ? options : (options?.capture ?? false);\n  const passive =\n    typeof options === \"object\" ? (options?.passive ?? false) : false;\n  const once = typeof options === \"object\" ? (options?.once ?? false) : false;\n\n  useEffect(() => {\n    const node = resolveTarget(target);\n    if (node == null) {\n      return;\n    }\n    const listenerOptions = { capture, passive, once };\n    const listener = (event: Event) => {\n      handlerRef.current(event);\n    };\n    node.addEventListener(eventName, listener, listenerOptions);\n    return () => {\n      node.removeEventListener(eventName, listener, listenerOptions);\n    };\n  }, [eventName, target, capture, passive, once]);\n}\n"]}

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

@@ -0,0 +1,2 @@
+export { useGeolocation, type GeolocationCoordinatesSnapshot, type UseGeolocationParams, type UseGeolocationResult, } from "./useGeolocation";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/hooks/useGeolocation/useGeolocation.d.ts

@@ -0,0 +1,48 @@
+export type GeolocationCoordinatesSnapshot = {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    altitude: number | null;
+    altitudeAccuracy: number | null;
+    heading: number | null;
+    speed: number | null;
+    timestamp: number;
+};
+export type UseGeolocationParams = {
+    /** Start requesting the position (default `true`). Set `false` to defer the permission prompt. */
+    enabled?: boolean;
+    /** Keep watching for position updates instead of a one-shot read (default `true`). */
+    watch?: boolean;
+    /** `PositionOptions.enableHighAccuracy`. */
+    enableHighAccuracy?: boolean;
+    /** `PositionOptions.maximumAge` in milliseconds. */
+    maximumAge?: number;
+    /** `PositionOptions.timeout` in milliseconds. */
+    timeout?: number;
+};
+export type UseGeolocationResult = {
+    /** Whether `navigator.geolocation` exists in this browser. */
+    isSupported: boolean;
+    /** True while enabled and no position or error has arrived yet. */
+    loading: boolean;
+    /** Permission state from the Permissions API (`"unknown"` where unsupported or before resolution). */
+    permission: PermissionState | "unknown";
+    /** Latest position snapshot, or `null` before the first fix. */
+    position: GeolocationCoordinatesSnapshot | null;
+    /** Latest geolocation error, cleared when a new fix succeeds. */
+    error: GeolocationPositionError | null;
+};
+/**
+ * Browser geolocation with loading, error, and Permissions API state.
+ *
+ * - Requesting the position triggers the browser permission prompt; pass `enabled: false`
+ *   and flip it from a user gesture to avoid prompting on mount.
+ * - `watch: true` (default) uses `watchPosition` for live updates; `false` reads once.
+ * - `permission` mirrors `navigator.permissions.query({ name: "geolocation" })` including
+ *   change events, independent of whether a request is active.
+ *
+ * @param params - {@link UseGeolocationParams}
+ * @returns {@link UseGeolocationResult}
+ */
+export declare function useGeolocation(params?: UseGeolocationParams): UseGeolocationResult;
+//# sourceMappingURL=useGeolocation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGeolocation.d.ts","sourceRoot":"","sources":["../../../src/hooks/useGeolocation/useGeolocation.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,sGAAsG;IACtG,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,gEAAgE;IAChE,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAChD,iEAAiE;IACjE,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACxC,CAAC;AAkBF;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,oBAAyB,GAChC,oBAAoB,CAuGtB"}

package/dist/hooks/useGeolocation.js

@@ -0,0 +1,111 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('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] = react.useState(
+    "unknown"
+  );
+  const [position, setPosition] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [settled, setSettled] = react.useState(false);
+  react.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);
+    };
+  }, []);
+  react.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
+  };
+}
+
+exports.useGeolocation = useGeolocation;
+//# sourceMappingURL=useGeolocation.js.map
+//# sourceMappingURL=useGeolocation.js.map

package/dist/hooks/useGeolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useGeolocation/useGeolocation.ts"],"names":["useState","useEffect"],"mappings":"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","file":"useGeolocation.js","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"]}