@zentauri-ui/zentauri-components 1.9.1 → 2.0.0

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCookie/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}

package/dist/hooks/useCookie/useCookie.d.ts

@@ -0,0 +1,36 @@
+export type CookieOptions = {
+    /** Lifetime in seconds (sets `max-age`). Omit for a session cookie. */
+    maxAgeSeconds?: number;
+    /** Absolute expiry (sets `expires`). */
+    expires?: Date;
+    /** Cookie path (default `"/"`). */
+    path?: string;
+    /** Cookie domain. */
+    domain?: string;
+    /** Restrict to HTTPS. */
+    secure?: boolean;
+    /** SameSite attribute. `"none"` automatically forces `secure` per browser requirements. */
+    sameSite?: "strict" | "lax" | "none";
+};
+export type UseCookieResult = [
+    string | null,
+    (value: string, options?: CookieOptions) => void,
+    (options?: Pick<CookieOptions, "path" | "domain">) => void
+];
+/**
+ * Reads and writes a single cookie with React state that stays in sync with your updates.
+ *
+ * - Initial state is `initialValue` (or `null`) to avoid SSR hydration mismatches; the actual
+ *   cookie value is read on mount via a `useEffect`.
+ * - `setCookie` writes `document.cookie` (URI-encoded) and updates state in the same call.
+ * - `removeCookie` expires the cookie via `max-age=0`; pass the same `path` / `domain` used when setting.
+ * - Reactivity covers writes made through this hook instance; cookies changed elsewhere are
+ *   re-read only when `name` changes (the browser offers no cookie change event in wide support).
+ * - `SameSite="none"` automatically forces the `Secure` flag per browser requirements.
+ *
+ * @param name - Cookie name.
+ * @param initialValue - Fallback when the cookie is absent (and during SSR).
+ * @returns `[value, setCookie, removeCookie]`.
+ */
+export declare function useCookie(name: string, initialValue?: string): UseCookieResult;
+//# sourceMappingURL=useCookie.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCookie.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCookie/useCookie.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG;IAC1B,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,GAAG,IAAI;IACb,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,IAAI;IAChD,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,KAAK,IAAI;CAC3D,CAAC;AAsDF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,eAAe,CAqCjB"}

package/dist/hooks/useCookie.js

@@ -0,0 +1,82 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('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] = react.useState(initialValue ?? null);
+  const setCookie = react.useCallback(
+    (value2, options = {}) => {
+      if (typeof document === "undefined") {
+        return;
+      }
+      document.cookie = serializeCookie(name, value2, options);
+      setValueState(value2);
+    },
+    [name]
+  );
+  const removeCookie = react.useCallback(
+    (options = {}) => {
+      if (typeof document === "undefined") {
+        return;
+      }
+      document.cookie = serializeCookie(name, "", {
+        ...options,
+        maxAgeSeconds: 0
+      });
+      setValueState(null);
+    },
+    [name]
+  );
+  react.useEffect(() => {
+    setValueState(readCookie(name) ?? initialValue ?? null);
+  }, [name]);
+  return [value, setCookie, removeCookie];
+}
+
+exports.useCookie = useCookie;
+//# sourceMappingURL=useCookie.js.map
+//# sourceMappingURL=useCookie.js.map

package/dist/hooks/useCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useCookie/useCookie.ts"],"names":["useState","useCallback","value","useEffect"],"mappings":"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","file":"useCookie.js","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 {\n    maxAgeSeconds,\n    expires,\n    path = \"/\",\n    domain,\n    sameSite,\n  } = 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/useCookie.mjs

@@ -0,0 +1,80 @@
+"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":";;;AAyBA,SAAS,WAAW,IAAA,EAA6B;AAC/C,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAA,GAAS,CAAA,EAAG,kBAAA,CAAmB,IAAI,CAAC,CAAA,CAAA,CAAA;AAC1C,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,MAAA,CACpB,KAAA,CAAM,IAAI,CAAA,CACV,IAAA,CAAK,CAAC,GAAA,KAAQ,GAAA,CAAI,UAAA,CAAW,MAAM,CAAC,CAAA;AACvC,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,OAAO,kBAAA,CAAmB,KAAA,CAAM,KAAA,CAAM,MAAA,CAAO,MAAM,CAAC,CAAA;AAAA,EACtD,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAEA,SAAS,eAAA,CACP,IAAA,EACA,KAAA,EACA,OAAA,EACQ;AACR,EAAA,MAAM;AAAA,IACJ,aAAA;AAAA,IACA,OAAA;AAAA,IACA,IAAA,GAAO,GAAA;AAAA,IACP,MAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,QAAA,KAAa,MAAA;AAC9C,EAAA,IAAI,MAAA,GAAS,CAAA,EAAG,kBAAA,CAAmB,IAAI,CAAC,IAAI,kBAAA,CAAmB,KAAK,CAAC,CAAA,OAAA,EAAU,IAAI,CAAA,CAAA;AACnF,EAAA,IAAI,iBAAiB,IAAA,EAAM;AACzB,IAAA,MAAA,IAAU,aAAa,aAAa,CAAA,CAAA;AAAA,EACtC;AACA,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,MAAA,IAAU,CAAA,UAAA,EAAa,OAAA,CAAQ,WAAA,EAAa,CAAA,CAAA;AAAA,EAC9C;AACA,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,MAAA,IAAU,YAAY,MAAM,CAAA,CAAA;AAAA,EAC9B;AACA,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,MAAA,IAAU,UAAA;AAAA,EACZ;AACA,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,MAAA,IAAU,cAAc,QAAQ,CAAA,CAAA;AAAA,EAClC;AACA,EAAA,OAAO,MAAA;AACT;AAiBO,SAAS,SAAA,CACd,MACA,YAAA,EACiB;AAGjB,EAAA,MAAM,CAAC,KAAA,EAAO,aAAa,CAAA,GAAI,QAAA,CAAwB,gBAAgB,IAAI,CAAA;AAE3E,EAAA,MAAM,SAAA,GAAY,WAAA;AAAA,IAChB,CAACA,MAAAA,EAAe,OAAA,GAAyB,EAAC,KAAM;AAC9C,MAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,QAAA;AAAA,MACF;AACA,MAAA,QAAA,CAAS,MAAA,GAAS,eAAA,CAAgB,IAAA,EAAMA,MAAAA,EAAO,OAAO,CAAA;AACtD,MAAA,aAAA,CAAcA,MAAK,CAAA;AAAA,IACrB,CAAA;AAAA,IACA,CAAC,IAAI;AAAA,GACP;AAEA,EAAA,MAAM,YAAA,GAAe,WAAA;AAAA,IACnB,CAAC,OAAA,GAAkD,EAAC,KAAM;AACxD,MAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,QAAA;AAAA,MACF;AACA,MAAA,QAAA,CAAS,MAAA,GAAS,eAAA,CAAgB,IAAA,EAAM,EAAA,EAAI;AAAA,QAC1C,GAAG,OAAA;AAAA,QACH,aAAA,EAAe;AAAA,OAChB,CAAA;AACD,MAAA,aAAA,CAAc,IAAI,CAAA;AAAA,IACpB,CAAA;AAAA,IACA,CAAC,IAAI;AAAA,GACP;AAEA,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,aAAA,CAAc,UAAA,CAAW,IAAI,CAAA,IAAK,YAAA,IAAgB,IAAI,CAAA;AAAA,EAGxD,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA;AAET,EAAA,OAAO,CAAC,KAAA,EAAO,SAAA,EAAW,YAAY,CAAA;AACxC","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 {\n    maxAgeSeconds,\n    expires,\n    path = \"/\",\n    domain,\n    sameSite,\n  } = 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/useDebouncedValue.js

@@ -1,9 +1,9 @@
 "use client";
 'use strict';
 
+require('../chunk-PZ5AY32C.js');
 var react = require('react');
 
-// src/hooks/useDebouncedValue/useDebouncedValue.ts
 function useDebouncedValue(value, delayMs) {
   const [debounced, setDebounced] = react.useState(value);
   react.useEffect(() => {

package/dist/hooks/useDebouncedValue.mjs

@@ -1,7 +1,7 @@
 "use client";
+import '../chunk-J5LGTIGS.mjs';
 import { useState, useEffect } from 'react';
 
-// src/hooks/useDebouncedValue/useDebouncedValue.ts
 function useDebouncedValue(value, delayMs) {
   const [debounced, setDebounced] = useState(value);
   useEffect(() => {

package/dist/hooks/useDisclosure.js

@@ -3,6 +3,7 @@
 
 require('../chunk-RGOMHX4G.js');
 var chunkHPN7H5ZM_js = require('../chunk-HPN7H5ZM.js');
+require('../chunk-PZ5AY32C.js');
 var react = require('react');
 
 function useDisclosure({

package/dist/hooks/useDisclosure.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/useDisclosure/useDisclosure.ts"],"names":["useControllableState","useCallback","open"],"mappings":";;;;;;AA8BO,SAAS,aAAA,CAAc;AAAA,EAC5B,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,GAAc,KAAA;AAAA,EACd;AACF,CAAA,GAAyB,EAAC,EAAwB;AAChD,EAAA,MAAM,CAAC,MAAA,EAAQ,YAAY,CAAA,GAAIA,qCAAA,CAAqB;AAAA,IAClD,KAAA,EAAO,QAAA;AAAA,IACP,YAAA,EAAc,WAAA;AAAA,IACd,QAAA,EAAU;AAAA,GACX,CAAA;AAED,EAAA,MAAM,OAAA,GAAUC,iBAAA;AAAA,IACd,CAACC,KAAAA,KAAkB;AACjB,MAAA,YAAA,CAAaA,KAAI,CAAA;AAAA,IACnB,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,IAAA,GAAOD,kBAAY,MAAM;AAC7B,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,KAAA,GAAQA,kBAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAAA,EACpB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,MAAA,GAASA,kBAAY,MAAM;AAC/B,IAAA,YAAA,CAAa,CAAC,MAAM,CAAA;AAAA,EACtB,CAAA,EAAG,CAAC,MAAA,EAAQ,YAAY,CAAC,CAAA;AAEzB,EAAA,OAAO,EAAE,MAAA,EAAQ,IAAA,EAAM,KAAA,EAAO,QAAQ,OAAA,EAAQ;AAChD","file":"useDisclosure.js","sourcesContent":["\"use client\";\n\nimport { useCallback } from \"react\";\n\nimport { useControllableState } from \"../useControllableState\";\n\nexport type UseDisclosureParams = {\n  /** Controlled open flag; omit for uncontrolled usage with `defaultOpen`. */\n  open?: boolean;\n  /** Initial open state when uncontrolled. */\n  defaultOpen?: boolean;\n  /** Fired whenever open state changes from user-driven `setOpen` / `open` / `close` / `toggle`. */\n  onOpenChange?: (open: boolean) => void;\n};\n\nexport type UseDisclosureResult = {\n  isOpen: boolean;\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n  setOpen: (open: boolean) => void;\n};\n\n/**\n * Boolean open/close state for overlays (dialogs, menus, collapsible regions) with optional control from the parent.\n * Built on {@link useControllableState}; semantics match common headless UI libraries.\n *\n * @param params - Optional `open`, `defaultOpen`, and `onOpenChange`.\n * @returns Helpers `open`, `close`, `toggle`, `setOpen`, and the current `isOpen` flag.\n */\nexport function useDisclosure({\n  open: openProp,\n  defaultOpen = false,\n  onOpenChange,\n}: UseDisclosureParams = {}): UseDisclosureResult {\n  const [isOpen, setOpenState] = useControllableState({\n    value: openProp,\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n  });\n\n  const setOpen = useCallback(\n    (open: boolean) => {\n      setOpenState(open);\n    },\n    [setOpenState],\n  );\n\n  const open = useCallback(() => {\n    setOpenState(true);\n  }, [setOpenState]);\n\n  const close = useCallback(() => {\n    setOpenState(false);\n  }, [setOpenState]);\n\n  const toggle = useCallback(() => {\n    setOpenState(!isOpen);\n  }, [isOpen, setOpenState]);\n\n  return { isOpen, open, close, toggle, setOpen };\n}\n"]}
+{"version":3,"sources":["../../src/hooks/useDisclosure/useDisclosure.ts"],"names":["useControllableState","useCallback","open"],"mappings":";;;;;;;AA8BO,SAAS,aAAA,CAAc;AAAA,EAC5B,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,GAAc,KAAA;AAAA,EACd;AACF,CAAA,GAAyB,EAAC,EAAwB;AAChD,EAAA,MAAM,CAAC,MAAA,EAAQ,YAAY,CAAA,GAAIA,qCAAA,CAAqB;AAAA,IAClD,KAAA,EAAO,QAAA;AAAA,IACP,YAAA,EAAc,WAAA;AAAA,IACd,QAAA,EAAU;AAAA,GACX,CAAA;AAED,EAAA,MAAM,OAAA,GAAUC,iBAAA;AAAA,IACd,CAACC,KAAAA,KAAkB;AACjB,MAAA,YAAA,CAAaA,KAAI,CAAA;AAAA,IACnB,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,IAAA,GAAOD,kBAAY,MAAM;AAC7B,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,KAAA,GAAQA,kBAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAAA,EACpB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,MAAA,GAASA,kBAAY,MAAM;AAC/B,IAAA,YAAA,CAAa,CAAC,MAAM,CAAA;AAAA,EACtB,CAAA,EAAG,CAAC,MAAA,EAAQ,YAAY,CAAC,CAAA;AAEzB,EAAA,OAAO,EAAE,MAAA,EAAQ,IAAA,EAAM,KAAA,EAAO,QAAQ,OAAA,EAAQ;AAChD","file":"useDisclosure.js","sourcesContent":["\"use client\";\n\nimport { useCallback } from \"react\";\n\nimport { useControllableState } from \"../useControllableState\";\n\nexport type UseDisclosureParams = {\n  /** Controlled open flag; omit for uncontrolled usage with `defaultOpen`. */\n  open?: boolean;\n  /** Initial open state when uncontrolled. */\n  defaultOpen?: boolean;\n  /** Fired whenever open state changes from user-driven `setOpen` / `open` / `close` / `toggle`. */\n  onOpenChange?: (open: boolean) => void;\n};\n\nexport type UseDisclosureResult = {\n  isOpen: boolean;\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n  setOpen: (open: boolean) => void;\n};\n\n/**\n * Boolean open/close state for overlays (dialogs, menus, collapsible regions) with optional control from the parent.\n * Built on {@link useControllableState}; semantics match common headless UI libraries.\n *\n * @param params - Optional `open`, `defaultOpen`, and `onOpenChange`.\n * @returns Helpers `open`, `close`, `toggle`, `setOpen`, and the current `isOpen` flag.\n */\nexport function useDisclosure({\n  open: openProp,\n  defaultOpen = false,\n  onOpenChange,\n}: UseDisclosureParams = {}): UseDisclosureResult {\n  const [isOpen, setOpenState] = useControllableState({\n    value: openProp,\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n  });\n\n  const setOpen = useCallback(\n    (open: boolean) => {\n      setOpenState(open);\n    },\n    [setOpenState],\n  );\n\n  const open = useCallback(() => {\n    setOpenState(true);\n  }, [setOpenState]);\n\n  const close = useCallback(() => {\n    setOpenState(false);\n  }, [setOpenState]);\n\n  const toggle = useCallback(() => {\n    setOpenState(!isOpen);\n  }, [isOpen, setOpenState]);\n\n  return { isOpen, open, close, toggle, setOpen };\n}\n"]}

package/dist/hooks/useDisclosure.mjs

@@ -1,6 +1,7 @@
 "use client";
 import '../chunk-N6B35KWW.mjs';
 import { useControllableState } from '../chunk-NWOE2TZN.mjs';
+import '../chunk-J5LGTIGS.mjs';
 import { useCallback } from 'react';
 
 function useDisclosure({

package/dist/hooks/useDisclosure.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/useDisclosure/useDisclosure.ts"],"names":["open"],"mappings":";;;;AA8BO,SAAS,aAAA,CAAc;AAAA,EAC5B,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,GAAc,KAAA;AAAA,EACd;AACF,CAAA,GAAyB,EAAC,EAAwB;AAChD,EAAA,MAAM,CAAC,MAAA,EAAQ,YAAY,CAAA,GAAI,oBAAA,CAAqB;AAAA,IAClD,KAAA,EAAO,QAAA;AAAA,IACP,YAAA,EAAc,WAAA;AAAA,IACd,QAAA,EAAU;AAAA,GACX,CAAA;AAED,EAAA,MAAM,OAAA,GAAU,WAAA;AAAA,IACd,CAACA,KAAAA,KAAkB;AACjB,MAAA,YAAA,CAAaA,KAAI,CAAA;AAAA,IACnB,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,IAAA,GAAO,YAAY,MAAM;AAC7B,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAAA,EACpB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,MAAA,GAAS,YAAY,MAAM;AAC/B,IAAA,YAAA,CAAa,CAAC,MAAM,CAAA;AAAA,EACtB,CAAA,EAAG,CAAC,MAAA,EAAQ,YAAY,CAAC,CAAA;AAEzB,EAAA,OAAO,EAAE,MAAA,EAAQ,IAAA,EAAM,KAAA,EAAO,QAAQ,OAAA,EAAQ;AAChD","file":"useDisclosure.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback } from \"react\";\n\nimport { useControllableState } from \"../useControllableState\";\n\nexport type UseDisclosureParams = {\n  /** Controlled open flag; omit for uncontrolled usage with `defaultOpen`. */\n  open?: boolean;\n  /** Initial open state when uncontrolled. */\n  defaultOpen?: boolean;\n  /** Fired whenever open state changes from user-driven `setOpen` / `open` / `close` / `toggle`. */\n  onOpenChange?: (open: boolean) => void;\n};\n\nexport type UseDisclosureResult = {\n  isOpen: boolean;\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n  setOpen: (open: boolean) => void;\n};\n\n/**\n * Boolean open/close state for overlays (dialogs, menus, collapsible regions) with optional control from the parent.\n * Built on {@link useControllableState}; semantics match common headless UI libraries.\n *\n * @param params - Optional `open`, `defaultOpen`, and `onOpenChange`.\n * @returns Helpers `open`, `close`, `toggle`, `setOpen`, and the current `isOpen` flag.\n */\nexport function useDisclosure({\n  open: openProp,\n  defaultOpen = false,\n  onOpenChange,\n}: UseDisclosureParams = {}): UseDisclosureResult {\n  const [isOpen, setOpenState] = useControllableState({\n    value: openProp,\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n  });\n\n  const setOpen = useCallback(\n    (open: boolean) => {\n      setOpenState(open);\n    },\n    [setOpenState],\n  );\n\n  const open = useCallback(() => {\n    setOpenState(true);\n  }, [setOpenState]);\n\n  const close = useCallback(() => {\n    setOpenState(false);\n  }, [setOpenState]);\n\n  const toggle = useCallback(() => {\n    setOpenState(!isOpen);\n  }, [isOpen, setOpenState]);\n\n  return { isOpen, open, close, toggle, setOpen };\n}\n"]}
+{"version":3,"sources":["../../src/hooks/useDisclosure/useDisclosure.ts"],"names":["open"],"mappings":";;;;;AA8BO,SAAS,aAAA,CAAc;AAAA,EAC5B,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,GAAc,KAAA;AAAA,EACd;AACF,CAAA,GAAyB,EAAC,EAAwB;AAChD,EAAA,MAAM,CAAC,MAAA,EAAQ,YAAY,CAAA,GAAI,oBAAA,CAAqB;AAAA,IAClD,KAAA,EAAO,QAAA;AAAA,IACP,YAAA,EAAc,WAAA;AAAA,IACd,QAAA,EAAU;AAAA,GACX,CAAA;AAED,EAAA,MAAM,OAAA,GAAU,WAAA;AAAA,IACd,CAACA,KAAAA,KAAkB;AACjB,MAAA,YAAA,CAAaA,KAAI,CAAA;AAAA,IACnB,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,IAAA,GAAO,YAAY,MAAM;AAC7B,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,YAAA,CAAa,KAAK,CAAA;AAAA,EACpB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,MAAM,MAAA,GAAS,YAAY,MAAM;AAC/B,IAAA,YAAA,CAAa,CAAC,MAAM,CAAA;AAAA,EACtB,CAAA,EAAG,CAAC,MAAA,EAAQ,YAAY,CAAC,CAAA;AAEzB,EAAA,OAAO,EAAE,MAAA,EAAQ,IAAA,EAAM,KAAA,EAAO,QAAQ,OAAA,EAAQ;AAChD","file":"useDisclosure.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback } from \"react\";\n\nimport { useControllableState } from \"../useControllableState\";\n\nexport type UseDisclosureParams = {\n  /** Controlled open flag; omit for uncontrolled usage with `defaultOpen`. */\n  open?: boolean;\n  /** Initial open state when uncontrolled. */\n  defaultOpen?: boolean;\n  /** Fired whenever open state changes from user-driven `setOpen` / `open` / `close` / `toggle`. */\n  onOpenChange?: (open: boolean) => void;\n};\n\nexport type UseDisclosureResult = {\n  isOpen: boolean;\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n  setOpen: (open: boolean) => void;\n};\n\n/**\n * Boolean open/close state for overlays (dialogs, menus, collapsible regions) with optional control from the parent.\n * Built on {@link useControllableState}; semantics match common headless UI libraries.\n *\n * @param params - Optional `open`, `defaultOpen`, and `onOpenChange`.\n * @returns Helpers `open`, `close`, `toggle`, `setOpen`, and the current `isOpen` flag.\n */\nexport function useDisclosure({\n  open: openProp,\n  defaultOpen = false,\n  onOpenChange,\n}: UseDisclosureParams = {}): UseDisclosureResult {\n  const [isOpen, setOpenState] = useControllableState({\n    value: openProp,\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n  });\n\n  const setOpen = useCallback(\n    (open: boolean) => {\n      setOpenState(open);\n    },\n    [setOpenState],\n  );\n\n  const open = useCallback(() => {\n    setOpenState(true);\n  }, [setOpenState]);\n\n  const close = useCallback(() => {\n    setOpenState(false);\n  }, [setOpenState]);\n\n  const toggle = useCallback(() => {\n    setOpenState(!isOpen);\n  }, [isOpen, setOpenState]);\n\n  return { isOpen, open, close, toggle, setOpen };\n}\n"]}

package/dist/hooks/useDocumentTitle.js

@@ -1,9 +1,9 @@
 "use client";
 'use strict';
 
+require('../chunk-PZ5AY32C.js');
 var react = require('react');
 
-// src/hooks/useDocumentTitle/useDocumentTitle.ts
 function useDocumentTitle({
   title,
   restoreOnUnmount = true

package/dist/hooks/useDocumentTitle.mjs

@@ -1,7 +1,7 @@
 "use client";
+import '../chunk-J5LGTIGS.mjs';
 import { useRef, useEffect } from 'react';
 
-// src/hooks/useDocumentTitle/useDocumentTitle.ts
 function useDocumentTitle({
   title,
   restoreOnUnmount = true

package/dist/hooks/useDynamicStepper.js

@@ -3,6 +3,7 @@
 
 var chunkVMCOX3Z2_js = require('../chunk-VMCOX3Z2.js');
 require('../chunk-HPN7H5ZM.js');
+require('../chunk-PZ5AY32C.js');
 
 
 

package/dist/hooks/useDynamicStepper.mjs

@@ -1,5 +1,6 @@
 "use client";
 export { useDynamicStepper } from '../chunk-4MPNRGUA.mjs';
 import '../chunk-NWOE2TZN.mjs';
+import '../chunk-J5LGTIGS.mjs';
 //# sourceMappingURL=useDynamicStepper.mjs.map
 //# sourceMappingURL=useDynamicStepper.mjs.map

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