@zentauri-ui/zentauri-components 1.1.1 → 1.2.0

package/dist/hooks/useClipboard.mjs

@@ -0,0 +1,49 @@
+"use client";
+import { useState, useRef, useCallback } from 'react';
+
+// src/hooks/useClipboard/useClipboard.ts
+function useClipboard(resetDelay = 2e3) {
+  const [copied, setCopied] = useState(false);
+  const [error, setError] = useState(void 0);
+  const timeoutRef = useRef(
+    void 0
+  );
+  const reset = useCallback(() => {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = void 0;
+    }
+    setCopied(false);
+    setError(void 0);
+  }, []);
+  const copy = useCallback(
+    async (text) => {
+      reset();
+      if (typeof navigator === "undefined" || !navigator.clipboard?.writeText) {
+        const err = new Error("Clipboard API is not available");
+        setError(err);
+        return false;
+      }
+      try {
+        await navigator.clipboard.writeText(text);
+        setCopied(true);
+        if (resetDelay > 0) {
+          timeoutRef.current = setTimeout(() => {
+            setCopied(false);
+          }, resetDelay);
+        }
+        return true;
+      } catch (cause) {
+        const err = cause instanceof Error ? cause : new Error(String(cause));
+        setError(err);
+        return false;
+      }
+    },
+    [reset, resetDelay]
+  );
+  return { copied, error, copy, reset };
+}
+
+export { useClipboard };
+//# sourceMappingURL=useClipboard.mjs.map
+//# sourceMappingURL=useClipboard.mjs.map

package/dist/hooks/useClipboard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useClipboard/useClipboard.ts"],"names":[],"mappings":";;;AAwBO,SAAS,YAAA,CAAa,aAAa,GAAA,EAA0B;AAClE,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,SAAS,KAAK,CAAA;AAC1C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAA4B,MAAS,CAAA;AAC/D,EAAA,MAAM,UAAA,GAAa,MAAA;AAAA,IACjB;AAAA,GACF;AAEA,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,IAAI,WAAW,OAAA,EAAS;AACtB,MAAA,YAAA,CAAa,WAAW,OAAO,CAAA;AAC/B,MAAA,UAAA,CAAW,OAAA,GAAU,MAAA;AAAA,IACvB;AACA,IAAA,SAAA,CAAU,KAAK,CAAA;AACf,IAAA,QAAA,CAAS,MAAS,CAAA;AAAA,EACpB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,IAAA,GAAO,WAAA;AAAA,IACX,OAAO,IAAA,KAAiB;AACtB,MAAA,KAAA,EAAM;AACN,MAAA,IAAI,OAAO,SAAA,KAAc,WAAA,IAAe,CAAC,SAAA,CAAU,WAAW,SAAA,EAAW;AACvE,QAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,gCAAgC,CAAA;AACtD,QAAA,QAAA,CAAS,GAAG,CAAA;AACZ,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,IAAI;AACF,QAAA,MAAM,SAAA,CAAU,SAAA,CAAU,SAAA,CAAU,IAAI,CAAA;AACxC,QAAA,SAAA,CAAU,IAAI,CAAA;AACd,QAAA,IAAI,aAAa,CAAA,EAAG;AAClB,UAAA,UAAA,CAAW,OAAA,GAAU,WAAW,MAAM;AACpC,YAAA,SAAA,CAAU,KAAK,CAAA;AAAA,UACjB,GAAG,UAAU,CAAA;AAAA,QACf;AACA,QAAA,OAAO,IAAA;AAAA,MACT,SAAS,KAAA,EAAO;AACd,QAAA,MAAM,GAAA,GACJ,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAC1D,QAAA,QAAA,CAAS,GAAG,CAAA;AACZ,QAAA,OAAO,KAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IACA,CAAC,OAAO,UAAU;AAAA,GACpB;AAEA,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,IAAA,EAAM,KAAA,EAAM;AACtC","file":"useClipboard.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useRef, useState } from \"react\";\n\nexport type UseClipboardResult = {\n  /** `true` after a successful `copy` until the reset delay elapses or `reset` is called. */\n  copied: boolean;\n  /** Set when the Clipboard API is missing or `writeText` rejects (e.g. permission denied). */\n  error: Error | undefined;\n  /** Writes `text` via `navigator.clipboard.writeText`; returns whether the write succeeded. */\n  copy: (text: string) => Promise<boolean>;\n  /** Clears `copied`/`error` and cancels any pending auto-reset timeout. */\n  reset: () => void;\n};\n\n/**\n * Wraps the async Clipboard API with React state for UX feedback (“Copied!”) and error surfacing.\n *\n * After a successful copy, `copied` flips to `true` for `resetDelay` ms (or stays true if `resetDelay` is 0).\n * SSR-safe: `copy` resolves `false` with an error when `navigator.clipboard` is unavailable.\n *\n * @param resetDelay - Milliseconds before `copied` auto-clears after success; `0` disables auto-clear.\n * @returns `{ copied, error, copy, reset }` for rendering and handlers.\n */\nexport function useClipboard(resetDelay = 2000): UseClipboardResult {\n  const [copied, setCopied] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const timeoutRef = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n\n  const reset = useCallback(() => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = undefined;\n    }\n    setCopied(false);\n    setError(undefined);\n  }, []);\n\n  const copy = useCallback(\n    async (text: string) => {\n      reset();\n      if (typeof navigator === \"undefined\" || !navigator.clipboard?.writeText) {\n        const err = new Error(\"Clipboard API is not available\");\n        setError(err);\n        return false;\n      }\n      try {\n        await navigator.clipboard.writeText(text);\n        setCopied(true);\n        if (resetDelay > 0) {\n          timeoutRef.current = setTimeout(() => {\n            setCopied(false);\n          }, resetDelay);\n        }\n        return true;\n      } catch (cause) {\n        const err =\n          cause instanceof Error ? cause : new Error(String(cause));\n        setError(err);\n        return false;\n      }\n    },\n    [reset, resetDelay],\n  );\n\n  return { copied, error, copy, reset };\n}\n"]}

package/dist/hooks/useControllableState.d.mts

@@ -0,0 +1,22 @@
+type UseControllableStateParams<T> = {
+    /** When defined, the hook is controlled and this value is returned as state. */
+    value?: T;
+    /** Initial / fallback value when uncontrolled (`value` is `undefined`). */
+    defaultValue: T;
+    /** Notified on every `setValue` with the resolved next value (controlled and uncontrolled). */
+    onChange?: (next: T) => void;
+};
+/**
+ * Implements the React “controlled vs uncontrolled” pattern as a single state tuple.
+ *
+ * - If `value` is `undefined`, internal state mirrors `defaultValue` and updates on `setValue`.
+ * - If `value` is defined, returned state follows `value`; `setValue` still calls `onChange` so the parent can update.
+ * - `setValue` accepts either the next value or an updater `(prev) => next` (updater uses the current `value` in controlled mode).
+ *
+ * @typeParam T - State value type.
+ * @param params - `value`, `defaultValue`, and optional `onChange`.
+ * @returns `[value, setValue]` compatible with `useState`-style usage.
+ */
+declare function useControllableState<T>({ value: valueProp, defaultValue, onChange, }: UseControllableStateParams<T>): [T, (next: T | ((prev: T) => T)) => void];
+
+export { type UseControllableStateParams, useControllableState };

package/dist/hooks/useControllableState.d.ts

@@ -0,0 +1,22 @@
+type UseControllableStateParams<T> = {
+    /** When defined, the hook is controlled and this value is returned as state. */
+    value?: T;
+    /** Initial / fallback value when uncontrolled (`value` is `undefined`). */
+    defaultValue: T;
+    /** Notified on every `setValue` with the resolved next value (controlled and uncontrolled). */
+    onChange?: (next: T) => void;
+};
+/**
+ * Implements the React “controlled vs uncontrolled” pattern as a single state tuple.
+ *
+ * - If `value` is `undefined`, internal state mirrors `defaultValue` and updates on `setValue`.
+ * - If `value` is defined, returned state follows `value`; `setValue` still calls `onChange` so the parent can update.
+ * - `setValue` accepts either the next value or an updater `(prev) => next` (updater uses the current `value` in controlled mode).
+ *
+ * @typeParam T - State value type.
+ * @param params - `value`, `defaultValue`, and optional `onChange`.
+ * @returns `[value, setValue]` compatible with `useState`-style usage.
+ */
+declare function useControllableState<T>({ value: valueProp, defaultValue, onChange, }: UseControllableStateParams<T>): [T, (next: T | ((prev: T) => T)) => void];
+
+export { type UseControllableStateParams, useControllableState };

package/dist/hooks/useControllableState.js

@@ -0,0 +1,13 @@
+"use client";
+'use strict';
+
+var chunk2VQJ6OIL_js = require('../chunk-2VQJ6OIL.js');
+
+
+
+Object.defineProperty(exports, "useControllableState", {
+  enumerable: true,
+  get: function () { return chunk2VQJ6OIL_js.useControllableState; }
+});
+//# sourceMappingURL=useControllableState.js.map
+//# sourceMappingURL=useControllableState.js.map

package/dist/hooks/useControllableState.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useControllableState.js"}

package/dist/hooks/useControllableState.mjs

@@ -0,0 +1,4 @@
+"use client";
+export { useControllableState } from '../chunk-73VCO5TE.mjs';
+//# sourceMappingURL=useControllableState.mjs.map
+//# sourceMappingURL=useControllableState.mjs.map

package/dist/hooks/useControllableState.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useControllableState.mjs"}

package/dist/hooks/useDebouncedValue.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Returns a lagged copy of `value` that only updates after `value` has been stable for `delayMs`.
+ * Each change to `value` or `delayMs` resets the timer; rapid updates collapse into one committed update.
+ *
+ * Common uses: search inputs, resize-driven layout, or any expensive work that should not run on every keystroke.
+ *
+ * @typeParam T - Value type (any JSON-serializable or referential type).
+ * @param value - Live value from props or state.
+ * @param delayMs - Debounce interval in milliseconds.
+ * @returns The last value that survived the full delay without a newer `value` arriving.
+ */
+declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+
+export { useDebouncedValue };

package/dist/hooks/useDebouncedValue.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns a lagged copy of `value` that only updates after `value` has been stable for `delayMs`.
+ * Each change to `value` or `delayMs` resets the timer; rapid updates collapse into one committed update.
+ *
+ * Common uses: search inputs, resize-driven layout, or any expensive work that should not run on every keystroke.
+ *
+ * @typeParam T - Value type (any JSON-serializable or referential type).
+ * @param value - Live value from props or state.
+ * @param delayMs - Debounce interval in milliseconds.
+ * @returns The last value that survived the full delay without a newer `value` arriving.
+ */
+declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+
+export { useDebouncedValue };

package/dist/hooks/useDebouncedValue.js

@@ -0,0 +1,22 @@
+"use client";
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useDebouncedValue/useDebouncedValue.ts
+function useDebouncedValue(value, delayMs) {
+  const [debounced, setDebounced] = react.useState(value);
+  react.useEffect(() => {
+    const id = setTimeout(() => {
+      setDebounced(value);
+    }, delayMs);
+    return () => {
+      clearTimeout(id);
+    };
+  }, [delayMs, value]);
+  return debounced;
+}
+
+exports.useDebouncedValue = useDebouncedValue;
+//# sourceMappingURL=useDebouncedValue.js.map
+//# sourceMappingURL=useDebouncedValue.js.map

package/dist/hooks/useDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useDebouncedValue/useDebouncedValue.ts"],"names":["useState","useEffect"],"mappings":";;;;;AAeO,SAAS,iBAAA,CAAqB,OAAU,OAAA,EAAoB;AACjE,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIA,eAAS,KAAK,CAAA;AAEhD,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,EAAA,GAAK,WAAW,MAAM;AAC1B,MAAA,YAAA,CAAa,KAAK,CAAA;AAAA,IACpB,GAAG,OAAO,CAAA;AACV,IAAA,OAAO,MAAM;AACX,MAAA,YAAA,CAAa,EAAE,CAAA;AAAA,IACjB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,OAAA,EAAS,KAAK,CAAC,CAAA;AAEnB,EAAA,OAAO,SAAA;AACT","file":"useDebouncedValue.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/**\n * Returns a lagged copy of `value` that only updates after `value` has been stable for `delayMs`.\n * Each change to `value` or `delayMs` resets the timer; rapid updates collapse into one committed update.\n *\n * Common uses: search inputs, resize-driven layout, or any expensive work that should not run on every keystroke.\n *\n * @typeParam T - Value type (any JSON-serializable or referential type).\n * @param value - Live value from props or state.\n * @param delayMs - Debounce interval in milliseconds.\n * @returns The last value that survived the full delay without a newer `value` arriving.\n */\nexport function useDebouncedValue<T>(value: T, delayMs: number): T {\n  const [debounced, setDebounced] = useState(value);\n\n  useEffect(() => {\n    const id = setTimeout(() => {\n      setDebounced(value);\n    }, delayMs);\n    return () => {\n      clearTimeout(id);\n    };\n  }, [delayMs, value]);\n\n  return debounced;\n}\n"]}

package/dist/hooks/useDebouncedValue.mjs

@@ -0,0 +1,20 @@
+"use client";
+import { useState, useEffect } from 'react';
+
+// src/hooks/useDebouncedValue/useDebouncedValue.ts
+function useDebouncedValue(value, delayMs) {
+  const [debounced, setDebounced] = useState(value);
+  useEffect(() => {
+    const id = setTimeout(() => {
+      setDebounced(value);
+    }, delayMs);
+    return () => {
+      clearTimeout(id);
+    };
+  }, [delayMs, value]);
+  return debounced;
+}
+
+export { useDebouncedValue };
+//# sourceMappingURL=useDebouncedValue.mjs.map
+//# sourceMappingURL=useDebouncedValue.mjs.map

package/dist/hooks/useDebouncedValue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useDebouncedValue/useDebouncedValue.ts"],"names":[],"mappings":";;;AAeO,SAAS,iBAAA,CAAqB,OAAU,OAAA,EAAoB;AACjE,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAI,SAAS,KAAK,CAAA;AAEhD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,EAAA,GAAK,WAAW,MAAM;AAC1B,MAAA,YAAA,CAAa,KAAK,CAAA;AAAA,IACpB,GAAG,OAAO,CAAA;AACV,IAAA,OAAO,MAAM;AACX,MAAA,YAAA,CAAa,EAAE,CAAA;AAAA,IACjB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,OAAA,EAAS,KAAK,CAAC,CAAA;AAEnB,EAAA,OAAO,SAAA;AACT","file":"useDebouncedValue.mjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/**\n * Returns a lagged copy of `value` that only updates after `value` has been stable for `delayMs`.\n * Each change to `value` or `delayMs` resets the timer; rapid updates collapse into one committed update.\n *\n * Common uses: search inputs, resize-driven layout, or any expensive work that should not run on every keystroke.\n *\n * @typeParam T - Value type (any JSON-serializable or referential type).\n * @param value - Live value from props or state.\n * @param delayMs - Debounce interval in milliseconds.\n * @returns The last value that survived the full delay without a newer `value` arriving.\n */\nexport function useDebouncedValue<T>(value: T, delayMs: number): T {\n  const [debounced, setDebounced] = useState(value);\n\n  useEffect(() => {\n    const id = setTimeout(() => {\n      setDebounced(value);\n    }, delayMs);\n    return () => {\n      clearTimeout(id);\n    };\n  }, [delayMs, value]);\n\n  return debounced;\n}\n"]}

package/dist/hooks/useDisclosure.d.mts

@@ -0,0 +1,25 @@
+type UseDisclosureParams = {
+    /** Controlled open flag; omit for uncontrolled usage with `defaultOpen`. */
+    open?: boolean;
+    /** Initial open state when uncontrolled. */
+    defaultOpen?: boolean;
+    /** Fired whenever open state changes from user-driven `setOpen` / `open` / `close` / `toggle`. */
+    onOpenChange?: (open: boolean) => void;
+};
+type UseDisclosureResult = {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    setOpen: (open: boolean) => void;
+};
+/**
+ * Boolean open/close state for overlays (dialogs, menus, collapsible regions) with optional control from the parent.
+ * Built on {@link useControllableState}; semantics match common headless UI libraries.
+ *
+ * @param params - Optional `open`, `defaultOpen`, and `onOpenChange`.
+ * @returns Helpers `open`, `close`, `toggle`, `setOpen`, and the current `isOpen` flag.
+ */
+declare function useDisclosure({ open: openProp, defaultOpen, onOpenChange, }?: UseDisclosureParams): UseDisclosureResult;
+
+export { type UseDisclosureParams, type UseDisclosureResult, useDisclosure };

package/dist/hooks/useDisclosure.d.ts

@@ -0,0 +1,25 @@
+type UseDisclosureParams = {
+    /** Controlled open flag; omit for uncontrolled usage with `defaultOpen`. */
+    open?: boolean;
+    /** Initial open state when uncontrolled. */
+    defaultOpen?: boolean;
+    /** Fired whenever open state changes from user-driven `setOpen` / `open` / `close` / `toggle`. */
+    onOpenChange?: (open: boolean) => void;
+};
+type UseDisclosureResult = {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    setOpen: (open: boolean) => void;
+};
+/**
+ * Boolean open/close state for overlays (dialogs, menus, collapsible regions) with optional control from the parent.
+ * Built on {@link useControllableState}; semantics match common headless UI libraries.
+ *
+ * @param params - Optional `open`, `defaultOpen`, and `onOpenChange`.
+ * @returns Helpers `open`, `close`, `toggle`, `setOpen`, and the current `isOpen` flag.
+ */
+declare function useDisclosure({ open: openProp, defaultOpen, onOpenChange, }?: UseDisclosureParams): UseDisclosureResult;
+
+export { type UseDisclosureParams, type UseDisclosureResult, useDisclosure };

package/dist/hooks/useDisclosure.js

@@ -0,0 +1,37 @@
+"use client";
+'use strict';
+
+var chunk2VQJ6OIL_js = require('../chunk-2VQJ6OIL.js');
+var react = require('react');
+
+function useDisclosure({
+  open: openProp,
+  defaultOpen = false,
+  onOpenChange
+} = {}) {
+  const [isOpen, setOpenState] = chunk2VQJ6OIL_js.useControllableState({
+    value: openProp,
+    defaultValue: defaultOpen,
+    onChange: onOpenChange
+  });
+  const setOpen = react.useCallback(
+    (open2) => {
+      setOpenState(open2);
+    },
+    [setOpenState]
+  );
+  const open = react.useCallback(() => {
+    setOpenState(true);
+  }, [setOpenState]);
+  const close = react.useCallback(() => {
+    setOpenState(false);
+  }, [setOpenState]);
+  const toggle = react.useCallback(() => {
+    setOpenState(!isOpen);
+  }, [isOpen, setOpenState]);
+  return { isOpen, open, close, toggle, setOpen };
+}
+
+exports.useDisclosure = useDisclosure;
+//# sourceMappingURL=useDisclosure.js.map
+//# sourceMappingURL=useDisclosure.js.map

package/dist/hooks/useDisclosure.js.map

@@ -0,0 +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"]}

package/dist/hooks/useDisclosure.mjs

@@ -0,0 +1,35 @@
+"use client";
+import { useControllableState } from '../chunk-73VCO5TE.mjs';
+import { useCallback } from 'react';
+
+function useDisclosure({
+  open: openProp,
+  defaultOpen = false,
+  onOpenChange
+} = {}) {
+  const [isOpen, setOpenState] = useControllableState({
+    value: openProp,
+    defaultValue: defaultOpen,
+    onChange: onOpenChange
+  });
+  const setOpen = useCallback(
+    (open2) => {
+      setOpenState(open2);
+    },
+    [setOpenState]
+  );
+  const open = useCallback(() => {
+    setOpenState(true);
+  }, [setOpenState]);
+  const close = useCallback(() => {
+    setOpenState(false);
+  }, [setOpenState]);
+  const toggle = useCallback(() => {
+    setOpenState(!isOpen);
+  }, [isOpen, setOpenState]);
+  return { isOpen, open, close, toggle, setOpen };
+}
+
+export { useDisclosure };
+//# sourceMappingURL=useDisclosure.mjs.map
+//# sourceMappingURL=useDisclosure.mjs.map

package/dist/hooks/useDisclosure.mjs.map

@@ -0,0 +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"]}

package/dist/hooks/useDocumentTitle.d.mts

@@ -0,0 +1,19 @@
+type UseDocumentTitleParams = {
+    title: string;
+    /** When true (default), restores the document title from before this hook mounted when the component unmounts */
+    restoreOnUnmount?: boolean;
+};
+/**
+ * Keeps `document.title` in sync with `title` for the lifetime of the component.
+ *
+ * On first mount in the browser, the current title is captured. When `title` changes, the document title updates.
+ * If `restoreOnUnmount` is true when the component unmounts, the captured title is restored so nested routes or
+ * modals do not leak titles. Changing `restoreOnUnmount` while mounted does not run restore; only unmount does.
+ *
+ * @param params.title - Desired `document.title` string.
+ * @param params.restoreOnUnmount - Whether to restore the pre-mount title on unmount (default `true`). The value
+ *   read at unmount time determines behavior, not mid-mount prop changes.
+ */
+declare function useDocumentTitle({ title, restoreOnUnmount, }: UseDocumentTitleParams): void;
+
+export { type UseDocumentTitleParams, useDocumentTitle };

package/dist/hooks/useDocumentTitle.d.ts

@@ -0,0 +1,19 @@
+type UseDocumentTitleParams = {
+    title: string;
+    /** When true (default), restores the document title from before this hook mounted when the component unmounts */
+    restoreOnUnmount?: boolean;
+};
+/**
+ * Keeps `document.title` in sync with `title` for the lifetime of the component.
+ *
+ * On first mount in the browser, the current title is captured. When `title` changes, the document title updates.
+ * If `restoreOnUnmount` is true when the component unmounts, the captured title is restored so nested routes or
+ * modals do not leak titles. Changing `restoreOnUnmount` while mounted does not run restore; only unmount does.
+ *
+ * @param params.title - Desired `document.title` string.
+ * @param params.restoreOnUnmount - Whether to restore the pre-mount title on unmount (default `true`). The value
+ *   read at unmount time determines behavior, not mid-mount prop changes.
+ */
+declare function useDocumentTitle({ title, restoreOnUnmount, }: UseDocumentTitleParams): void;
+
+export { type UseDocumentTitleParams, useDocumentTitle };

package/dist/hooks/useDocumentTitle.js

@@ -0,0 +1,40 @@
+"use client";
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useDocumentTitle/useDocumentTitle.ts
+function useDocumentTitle({
+  title,
+  restoreOnUnmount = true
+}) {
+  const originalTitle = react.useRef(void 0);
+  const restoreOnUnmountRef = react.useRef(restoreOnUnmount);
+  restoreOnUnmountRef.current = restoreOnUnmount;
+  react.useEffect(() => {
+    if (typeof document === "undefined") {
+      return;
+    }
+    if (originalTitle.current === void 0) {
+      originalTitle.current = document.title;
+    }
+  }, []);
+  react.useEffect(() => {
+    if (typeof document === "undefined") {
+      return;
+    }
+    document.title = title;
+  }, [title]);
+  react.useEffect(() => {
+    return () => {
+      if (!restoreOnUnmountRef.current || typeof document === "undefined" || originalTitle.current === void 0) {
+        return;
+      }
+      document.title = originalTitle.current;
+    };
+  }, []);
+}
+
+exports.useDocumentTitle = useDocumentTitle;
+//# sourceMappingURL=useDocumentTitle.js.map
+//# sourceMappingURL=useDocumentTitle.js.map

package/dist/hooks/useDocumentTitle.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useDocumentTitle/useDocumentTitle.ts"],"names":["useRef","useEffect"],"mappings":";;;;;AAqBO,SAAS,gBAAA,CAAiB;AAAA,EAC/B,KAAA;AAAA,EACA,gBAAA,GAAmB;AACrB,CAAA,EAAiC;AAC/B,EAAA,MAAM,aAAA,GAAgBA,aAA2B,MAAS,CAAA;AAC1D,EAAA,MAAM,mBAAA,GAAsBA,aAAO,gBAAgB,CAAA;AACnD,EAAA,mBAAA,CAAoB,OAAA,GAAU,gBAAA;AAE9B,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,MAAA;AAAA,IACF;AACA,IAAA,IAAI,aAAA,CAAc,YAAY,MAAA,EAAW;AACvC,MAAA,aAAA,CAAc,UAAU,QAAA,CAAS,KAAA;AAAA,IACnC;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,MAAA;AAAA,IACF;AACA,IAAA,QAAA,CAAS,KAAA,GAAQ,KAAA;AAAA,EACnB,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,OAAO,MAAM;AACX,MAAA,IACE,CAAC,oBAAoB,OAAA,IACrB,OAAO,aAAa,WAAA,IACpB,aAAA,CAAc,YAAY,MAAA,EAC1B;AACA,QAAA;AAAA,MACF;AACA,MAAA,QAAA,CAAS,QAAQ,aAAA,CAAc,OAAA;AAAA,IACjC,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AACP","file":"useDocumentTitle.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\nexport type UseDocumentTitleParams = {\n  title: string;\n  /** When true (default), restores the document title from before this hook mounted when the component unmounts */\n  restoreOnUnmount?: boolean;\n};\n\n/**\n * Keeps `document.title` in sync with `title` for the lifetime of the component.\n *\n * On first mount in the browser, the current title is captured. When `title` changes, the document title updates.\n * If `restoreOnUnmount` is true when the component unmounts, the captured title is restored so nested routes or\n * modals do not leak titles. Changing `restoreOnUnmount` while mounted does not run restore; only unmount does.\n *\n * @param params.title - Desired `document.title` string.\n * @param params.restoreOnUnmount - Whether to restore the pre-mount title on unmount (default `true`). The value\n *   read at unmount time determines behavior, not mid-mount prop changes.\n */\nexport function useDocumentTitle({\n  title,\n  restoreOnUnmount = true,\n}: UseDocumentTitleParams): void {\n  const originalTitle = useRef<string | undefined>(undefined);\n  const restoreOnUnmountRef = useRef(restoreOnUnmount);\n  restoreOnUnmountRef.current = restoreOnUnmount;\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") {\n      return;\n    }\n    if (originalTitle.current === undefined) {\n      originalTitle.current = document.title;\n    }\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") {\n      return;\n    }\n    document.title = title;\n  }, [title]);\n\n  useEffect(() => {\n    return () => {\n      if (\n        !restoreOnUnmountRef.current ||\n        typeof document === \"undefined\" ||\n        originalTitle.current === undefined\n      ) {\n        return;\n      }\n      document.title = originalTitle.current;\n    };\n  }, []);\n}\n"]}

package/dist/hooks/useDocumentTitle.mjs

@@ -0,0 +1,38 @@
+"use client";
+import { useRef, useEffect } from 'react';
+
+// src/hooks/useDocumentTitle/useDocumentTitle.ts
+function useDocumentTitle({
+  title,
+  restoreOnUnmount = true
+}) {
+  const originalTitle = useRef(void 0);
+  const restoreOnUnmountRef = useRef(restoreOnUnmount);
+  restoreOnUnmountRef.current = restoreOnUnmount;
+  useEffect(() => {
+    if (typeof document === "undefined") {
+      return;
+    }
+    if (originalTitle.current === void 0) {
+      originalTitle.current = document.title;
+    }
+  }, []);
+  useEffect(() => {
+    if (typeof document === "undefined") {
+      return;
+    }
+    document.title = title;
+  }, [title]);
+  useEffect(() => {
+    return () => {
+      if (!restoreOnUnmountRef.current || typeof document === "undefined" || originalTitle.current === void 0) {
+        return;
+      }
+      document.title = originalTitle.current;
+    };
+  }, []);
+}
+
+export { useDocumentTitle };
+//# sourceMappingURL=useDocumentTitle.mjs.map
+//# sourceMappingURL=useDocumentTitle.mjs.map

package/dist/hooks/useDocumentTitle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useDocumentTitle/useDocumentTitle.ts"],"names":[],"mappings":";;;AAqBO,SAAS,gBAAA,CAAiB;AAAA,EAC/B,KAAA;AAAA,EACA,gBAAA,GAAmB;AACrB,CAAA,EAAiC;AAC/B,EAAA,MAAM,aAAA,GAAgB,OAA2B,MAAS,CAAA;AAC1D,EAAA,MAAM,mBAAA,GAAsB,OAAO,gBAAgB,CAAA;AACnD,EAAA,mBAAA,CAAoB,OAAA,GAAU,gBAAA;AAE9B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,MAAA;AAAA,IACF;AACA,IAAA,IAAI,aAAA,CAAc,YAAY,MAAA,EAAW;AACvC,MAAA,aAAA,CAAc,UAAU,QAAA,CAAS,KAAA;AAAA,IACnC;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,MAAA;AAAA,IACF;AACA,IAAA,QAAA,CAAS,KAAA,GAAQ,KAAA;AAAA,EACnB,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,OAAO,MAAM;AACX,MAAA,IACE,CAAC,oBAAoB,OAAA,IACrB,OAAO,aAAa,WAAA,IACpB,aAAA,CAAc,YAAY,MAAA,EAC1B;AACA,QAAA;AAAA,MACF;AACA,MAAA,QAAA,CAAS,QAAQ,aAAA,CAAc,OAAA;AAAA,IACjC,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AACP","file":"useDocumentTitle.mjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\nexport type UseDocumentTitleParams = {\n  title: string;\n  /** When true (default), restores the document title from before this hook mounted when the component unmounts */\n  restoreOnUnmount?: boolean;\n};\n\n/**\n * Keeps `document.title` in sync with `title` for the lifetime of the component.\n *\n * On first mount in the browser, the current title is captured. When `title` changes, the document title updates.\n * If `restoreOnUnmount` is true when the component unmounts, the captured title is restored so nested routes or\n * modals do not leak titles. Changing `restoreOnUnmount` while mounted does not run restore; only unmount does.\n *\n * @param params.title - Desired `document.title` string.\n * @param params.restoreOnUnmount - Whether to restore the pre-mount title on unmount (default `true`). The value\n *   read at unmount time determines behavior, not mid-mount prop changes.\n */\nexport function useDocumentTitle({\n  title,\n  restoreOnUnmount = true,\n}: UseDocumentTitleParams): void {\n  const originalTitle = useRef<string | undefined>(undefined);\n  const restoreOnUnmountRef = useRef(restoreOnUnmount);\n  restoreOnUnmountRef.current = restoreOnUnmount;\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") {\n      return;\n    }\n    if (originalTitle.current === undefined) {\n      originalTitle.current = document.title;\n    }\n  }, []);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") {\n      return;\n    }\n    document.title = title;\n  }, [title]);\n\n  useEffect(() => {\n    return () => {\n      if (\n        !restoreOnUnmountRef.current ||\n        typeof document === \"undefined\" ||\n        originalTitle.current === undefined\n      ) {\n        return;\n      }\n      document.title = originalTitle.current;\n    };\n  }, []);\n}\n"]}

package/dist/hooks/useFocusManagement.d.mts

@@ -0,0 +1,24 @@
+import { RefObject } from 'react';
+
+/**
+ * Composes modal-like behavior for an open overlay: body scroll lock, Escape to close, and focus trapping.
+ *
+ * - Delegates scroll locking to {@link useBodyScrollLock} while `open` is true.
+ * - Listens for `Escape` on `window` and calls `setOpen(false)`.
+ * - When `open` becomes true, focuses the first visible focusable inside `contentRef`, or the container itself.
+ * - Traps focus within `contentRef` via a capturing `focusin` listener on `document` that redirects focus back inside.
+ * - On close/unmount of the open effect, restores focus to the element that was focused before the trap ran.
+ *
+ * @param params.open - Whether the overlay is visible.
+ * @param params.setOpen - Setter used for Escape and cleanup paths.
+ * @param params.contentRef - Root of the dialog/drawer content (must point at a focusable container or include focusables).
+ * @param params.focusableSelector - Query selector for tabbable elements; defaults to a common interactive set.
+ */
+declare const useFocusManagement: ({ open, setOpen, contentRef, focusableSelector, }: {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    contentRef: RefObject<HTMLDivElement | null>;
+    focusableSelector?: string;
+}) => void;
+
+export { useFocusManagement };

package/dist/hooks/useFocusManagement.d.ts

@@ -0,0 +1,24 @@
+import { RefObject } from 'react';
+
+/**
+ * Composes modal-like behavior for an open overlay: body scroll lock, Escape to close, and focus trapping.
+ *
+ * - Delegates scroll locking to {@link useBodyScrollLock} while `open` is true.
+ * - Listens for `Escape` on `window` and calls `setOpen(false)`.
+ * - When `open` becomes true, focuses the first visible focusable inside `contentRef`, or the container itself.
+ * - Traps focus within `contentRef` via a capturing `focusin` listener on `document` that redirects focus back inside.
+ * - On close/unmount of the open effect, restores focus to the element that was focused before the trap ran.
+ *
+ * @param params.open - Whether the overlay is visible.
+ * @param params.setOpen - Setter used for Escape and cleanup paths.
+ * @param params.contentRef - Root of the dialog/drawer content (must point at a focusable container or include focusables).
+ * @param params.focusableSelector - Query selector for tabbable elements; defaults to a common interactive set.
+ */
+declare const useFocusManagement: ({ open, setOpen, contentRef, focusableSelector, }: {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    contentRef: RefObject<HTMLDivElement | null>;
+    focusableSelector?: string;
+}) => void;
+
+export { useFocusManagement };

package/dist/hooks/useFocusManagement.js

@@ -0,0 +1,14 @@
+"use client";
+'use strict';
+
+var chunkYPLVTUYL_js = require('../chunk-YPLVTUYL.js');
+require('../chunk-UIYFEP3I.js');
+
+
+
+Object.defineProperty(exports, "useFocusManagement", {
+  enumerable: true,
+  get: function () { return chunkYPLVTUYL_js.useFocusManagement; }
+});
+//# sourceMappingURL=useFocusManagement.js.map
+//# sourceMappingURL=useFocusManagement.js.map

package/dist/hooks/useFocusManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useFocusManagement.js"}

package/dist/hooks/useFocusManagement.mjs

@@ -0,0 +1,5 @@
+"use client";
+export { useFocusManagement } from '../chunk-WL5I7RVS.mjs';
+import '../chunk-PMAF6FBF.mjs';
+//# sourceMappingURL=useFocusManagement.mjs.map
+//# sourceMappingURL=useFocusManagement.mjs.map

package/dist/hooks/useFocusManagement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"useFocusManagement.mjs"}

package/dist/hooks/useHover.d.mts

@@ -0,0 +1,15 @@
+import { RefCallback } from 'react';
+
+/**
+ * Tracks pointer hover state for a single DOM node using `pointerenter` / `pointerleave`.
+ *
+ * When the ref target changes (or unmounts), hover is cleared so state does not stay `true` after
+ * retargeting without a `pointerleave` on the previous node.
+ *
+ * @typeParam T - HTMLElement subtype for the ref callback (e.g. `HTMLDivElement`).
+ * @returns A tuple `[setRef, hovered]` where `setRef` is a callback ref to attach to the target element
+ *          and `hovered` is `true` while the pointer is over that element (primary button agnostic).
+ */
+declare function useHover<T extends HTMLElement>(): [RefCallback<T>, boolean];
+
+export { useHover };

package/dist/hooks/useHover.d.ts

@@ -0,0 +1,15 @@
+import { RefCallback } from 'react';
+
+/**
+ * Tracks pointer hover state for a single DOM node using `pointerenter` / `pointerleave`.
+ *
+ * When the ref target changes (or unmounts), hover is cleared so state does not stay `true` after
+ * retargeting without a `pointerleave` on the previous node.
+ *
+ * @typeParam T - HTMLElement subtype for the ref callback (e.g. `HTMLDivElement`).
+ * @returns A tuple `[setRef, hovered]` where `setRef` is a callback ref to attach to the target element
+ *          and `hovered` is `true` while the pointer is over that element (primary button agnostic).
+ */
+declare function useHover<T extends HTMLElement>(): [RefCallback<T>, boolean];
+
+export { useHover };