@zentauri-ui/zentauri-components 1.1.1 → 1.2.0

package/dist/chunk-TZ2JVWTZ.mjs

@@ -0,0 +1,104 @@
+import { clampPage, range } from './chunk-DFEZH7TC.mjs';
+import { useState, useCallback, useMemo } from 'react';
+
+function usePagination({
+  pageCount,
+  page,
+  defaultPage = 1,
+  siblingCount = 1,
+  boundaryCount = 1,
+  onPageChange
+}) {
+  const [internalPage, setInternalPage] = useState(
+    () => clampPage(defaultPage, pageCount)
+  );
+  const isControlled = page !== void 0;
+  const currentPage = clampPage(isControlled ? page : internalPage, pageCount);
+  const setPage = useCallback(
+    (next) => {
+      const clamped = clampPage(next, pageCount);
+      if (!isControlled) {
+        setInternalPage(clamped);
+      }
+      onPageChange?.(clamped);
+    },
+    [isControlled, onPageChange, pageCount]
+  );
+  const items = useMemo(
+    () => buildPaginationItems({
+      pageCount,
+      currentPage,
+      siblingCount,
+      boundaryCount
+    }),
+    [boundaryCount, currentPage, pageCount, siblingCount]
+  );
+  const canGoPrev = pageCount > 0 && currentPage > 1;
+  const canGoNext = pageCount > 0 && currentPage < pageCount;
+  const goPrev = useCallback(() => {
+    if (canGoPrev) {
+      setPage(currentPage - 1);
+    }
+  }, [canGoPrev, currentPage, setPage]);
+  const goNext = useCallback(() => {
+    if (canGoNext) {
+      setPage(currentPage + 1);
+    }
+  }, [canGoNext, currentPage, setPage]);
+  return {
+    currentPage,
+    pageCount,
+    items,
+    setPage,
+    goPrev,
+    goNext,
+    canGoPrev,
+    canGoNext
+  };
+}
+function buildPaginationItems({
+  pageCount,
+  currentPage,
+  siblingCount,
+  boundaryCount
+}) {
+  if (pageCount <= 0) {
+    return [];
+  }
+  const safeBoundary = Math.max(1, boundaryCount);
+  const safeSibling = Math.max(0, siblingCount);
+  const current = clampPage(currentPage, pageCount);
+  const totalNumbers = safeBoundary * 2 + safeSibling * 2 + 1;
+  if (pageCount <= totalNumbers) {
+    return range(1, pageCount).map((value) => ({ type: "page", value }));
+  }
+  const leftBoundaryEnd = safeBoundary;
+  const rightBoundaryStart = pageCount - safeBoundary + 1;
+  const siblingsStart = Math.max(current - safeSibling, leftBoundaryEnd + 1);
+  const siblingsEnd = Math.min(current + safeSibling, rightBoundaryStart - 1);
+  const pages = /* @__PURE__ */ new Set();
+  for (let p = 1; p <= leftBoundaryEnd; p += 1) {
+    pages.add(p);
+  }
+  for (let p = rightBoundaryStart; p <= pageCount; p += 1) {
+    pages.add(p);
+  }
+  for (let p = siblingsStart; p <= siblingsEnd; p += 1) {
+    pages.add(p);
+  }
+  const sorted = [...pages].sort((a, b) => a - b);
+  const items = [];
+  for (let i = 0; i < sorted.length; i += 1) {
+    const value = sorted[i];
+    const prev = sorted[i - 1];
+    if (i > 0 && prev !== void 0 && value && value - prev > 1) {
+      items.push({ type: "ellipsis", key: `gap-${prev}-${value}` });
+    }
+    items.push({ type: "page", value });
+  }
+  return items;
+}
+
+export { buildPaginationItems, usePagination };
+//# sourceMappingURL=chunk-TZ2JVWTZ.mjs.map
+//# sourceMappingURL=chunk-TZ2JVWTZ.mjs.map

package/dist/chunk-TZ2JVWTZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/usePagination/usePagination.ts"],"names":[],"mappings":"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","file":"chunk-TZ2JVWTZ.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useMemo, useState } from \"react\";\n\nimport type {\n  PaginationPageItem,\n  UsePaginationParams,\n  UsePaginationResult,\n} from \"../../ui/pagination/types\";\nimport { clampPage, range } from \"../../lib/utils\";\n\nexport type { PaginationPageItem } from \"../../ui/pagination/types\";\n\nexport type BuildPaginationItemsParams = {\n  pageCount: number;\n  currentPage: number;\n  siblingCount: number;\n  boundaryCount: number;\n};\n\n/**\n * Headless pagination state: current page, derived page button items, and prev/next helpers.\n *\n * Supports controlled mode when `page` is passed from the parent, or internal state seeded by `defaultPage`.\n * All page indices are **1-based** and clamped to `[1, pageCount]` via {@link clampPage}. `items` is memoized from\n * {@link buildPaginationItems} for rendering numeric pages and ellipsis gaps.\n *\n * @param params - See `UsePaginationParams` in `../ui/pagination/types` for full fields (`pageCount`, `page`, `onPageChange`, etc.).\n * @returns Current page, item list, `setPage`, navigation helpers, and `canGoPrev` / `canGoNext` flags.\n */\nexport function usePagination({\n  pageCount,\n  page,\n  defaultPage = 1,\n  siblingCount = 1,\n  boundaryCount = 1,\n  onPageChange,\n}: UsePaginationParams): UsePaginationResult {\n  const [internalPage, setInternalPage] = useState(() =>\n    clampPage(defaultPage, pageCount),\n  );\n\n  const isControlled = page !== undefined;\n  const currentPage = clampPage(isControlled ? page : internalPage, pageCount);\n\n  const setPage = useCallback(\n    (next: number) => {\n      const clamped = clampPage(next, pageCount);\n      if (!isControlled) {\n        setInternalPage(clamped);\n      }\n      onPageChange?.(clamped);\n    },\n    [isControlled, onPageChange, pageCount],\n  );\n\n  const items = useMemo(\n    () =>\n      buildPaginationItems({\n        pageCount,\n        currentPage,\n        siblingCount,\n        boundaryCount,\n      }),\n    [boundaryCount, currentPage, pageCount, siblingCount],\n  );\n\n  const canGoPrev = pageCount > 0 && currentPage > 1;\n  const canGoNext = pageCount > 0 && currentPage < pageCount;\n\n  const goPrev = useCallback(() => {\n    if (canGoPrev) {\n      setPage(currentPage - 1);\n    }\n  }, [canGoPrev, currentPage, setPage]);\n\n  const goNext = useCallback(() => {\n    if (canGoNext) {\n      setPage(currentPage + 1);\n    }\n  }, [canGoNext, currentPage, setPage]);\n\n  return {\n    currentPage,\n    pageCount,\n    items,\n    setPage,\n    goPrev,\n    goNext,\n    canGoPrev,\n    canGoNext,\n  };\n}\n\n/**\n * Builds the ordered list of page numbers and ellipsis markers for a pagination control.\n *\n * @param params.pageCount - Total number of pages (must be >= 0; empty list when 0).\n * @param params.currentPage - Active page index (1-based).\n * @param params.siblingCount - How many page buttons to show on each side of the current page.\n * @param params.boundaryCount - How many pages to pin at the start and end of the range.\n * @returns Items suitable for rendering, e.g. page `1`, ellipsis gap, middle window, ellipsis, last page.\n */\nexport function buildPaginationItems({\n  pageCount,\n  currentPage,\n  siblingCount,\n  boundaryCount,\n}: BuildPaginationItemsParams): PaginationPageItem[] {\n  if (pageCount <= 0) {\n    return [];\n  }\n\n  const safeBoundary = Math.max(1, boundaryCount);\n  const safeSibling = Math.max(0, siblingCount);\n  const current = clampPage(currentPage, pageCount);\n\n  const totalNumbers = safeBoundary * 2 + safeSibling * 2 + 1;\n  if (pageCount <= totalNumbers) {\n    return range(1, pageCount).map((value) => ({ type: \"page\", value }));\n  }\n\n  const leftBoundaryEnd = safeBoundary;\n  const rightBoundaryStart = pageCount - safeBoundary + 1;\n\n  const siblingsStart = Math.max(current - safeSibling, leftBoundaryEnd + 1);\n  const siblingsEnd = Math.min(current + safeSibling, rightBoundaryStart - 1);\n\n  const pages = new Set<number>();\n  for (let p = 1; p <= leftBoundaryEnd; p += 1) {\n    pages.add(p);\n  }\n  for (let p = rightBoundaryStart; p <= pageCount; p += 1) {\n    pages.add(p);\n  }\n  for (let p = siblingsStart; p <= siblingsEnd; p += 1) {\n    pages.add(p);\n  }\n\n  const sorted = [...pages].sort((a, b) => a - b);\n  const items: PaginationPageItem[] = [];\n\n  for (let i = 0; i < sorted.length; i += 1) {\n    const value = sorted[i];\n    const prev = sorted[i - 1];\n    if (i > 0 && prev !== undefined && value && value - prev > 1) {\n      items.push({ type: \"ellipsis\", key: `gap-${prev}-${value}` });\n    }\n    items.push({ type: \"page\", value: value as number });\n  }\n\n  return items;\n}\n"]}

package/dist/chunk-UIYFEP3I.js

@@ -0,0 +1,39 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useBodyScrollLock/useBodyScrollLock.ts
+var activeLockCount = 0;
+var storedOverflow;
+var acquireBodyScrollLock = () => {
+  if (activeLockCount === 0) {
+    storedOverflow = document.body.style.overflow;
+    document.body.style.overflow = "hidden";
+  }
+  activeLockCount += 1;
+};
+var releaseBodyScrollLock = () => {
+  if (activeLockCount <= 0) {
+    return;
+  }
+  activeLockCount -= 1;
+  if (activeLockCount === 0) {
+    document.body.style.overflow = storedOverflow ?? "";
+    storedOverflow = void 0;
+  }
+};
+var useBodyScrollLock = (locked) => {
+  react.useEffect(() => {
+    if (!locked) {
+      return;
+    }
+    acquireBodyScrollLock();
+    return () => {
+      releaseBodyScrollLock();
+    };
+  }, [locked]);
+};
+
+exports.useBodyScrollLock = useBodyScrollLock;
+//# sourceMappingURL=chunk-UIYFEP3I.js.map
+//# sourceMappingURL=chunk-UIYFEP3I.js.map

package/dist/chunk-UIYFEP3I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useBodyScrollLock/useBodyScrollLock.ts"],"names":["useEffect"],"mappings":";;;;;AAIA,IAAI,eAAA,GAAkB,CAAA;AACtB,IAAI,cAAA;AAEJ,IAAM,wBAAwB,MAAM;AAClC,EAAA,IAAI,oBAAoB,CAAA,EAAG;AACzB,IAAA,cAAA,GAAiB,QAAA,CAAS,KAAK,KAAA,CAAM,QAAA;AACrC,IAAA,QAAA,CAAS,IAAA,CAAK,MAAM,QAAA,GAAW,QAAA;AAAA,EACjC;AACA,EAAA,eAAA,IAAmB,CAAA;AACrB,CAAA;AAEA,IAAM,wBAAwB,MAAM;AAClC,EAAA,IAAI,mBAAmB,CAAA,EAAG;AACxB,IAAA;AAAA,EACF;AACA,EAAA,eAAA,IAAmB,CAAA;AACnB,EAAA,IAAI,oBAAoB,CAAA,EAAG;AACzB,IAAA,QAAA,CAAS,IAAA,CAAK,KAAA,CAAM,QAAA,GAAW,cAAA,IAAkB,EAAA;AACjD,IAAA,cAAA,GAAiB,MAAA;AAAA,EACnB;AACF,CAAA;AAaO,IAAM,iBAAA,GAAoB,CAAC,MAAA,KAAoB;AACpD,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA;AAAA,IACF;AACA,IAAA,qBAAA,EAAsB;AACtB,IAAA,OAAO,MAAM;AACX,MAAA,qBAAA,EAAsB;AAAA,IACxB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AACb","file":"chunk-UIYFEP3I.js","sourcesContent":["\"use client\";\n\nimport { useEffect } from \"react\";\n\nlet activeLockCount = 0;\nlet storedOverflow: string | undefined;\n\nconst acquireBodyScrollLock = () => {\n  if (activeLockCount === 0) {\n    storedOverflow = document.body.style.overflow;\n    document.body.style.overflow = \"hidden\";\n  }\n  activeLockCount += 1;\n};\n\nconst releaseBodyScrollLock = () => {\n  if (activeLockCount <= 0) {\n    return;\n  }\n  activeLockCount -= 1;\n  if (activeLockCount === 0) {\n    document.body.style.overflow = storedOverflow ?? \"\";\n    storedOverflow = undefined;\n  }\n};\n\n/**\n * Locks the document body scroll while `locked` is true by setting `document.body.style.overflow`\n * to `\"hidden\"`. Uses a module-level lock count so multiple concurrent callers (nested modals,\n * drawer + modal, several hook instances) only restore the original inline `overflow` after the\n * last lock releases.\n *\n * Typical use: modals, drawers, and full-screen overlays where background content must not scroll.\n *\n * @param locked - When `true`, body scroll is hidden; when `false`, this instance releases its\n *   lock; the prior overflow is restored only when no instance still holds a lock.\n */\nexport const useBodyScrollLock = (locked: boolean) => {\n  useEffect(() => {\n    if (!locked) {\n      return;\n    }\n    acquireBodyScrollLock();\n    return () => {\n      releaseBodyScrollLock();\n    };\n  }, [locked]);\n};\n"]}

package/dist/chunk-UOZYPWDZ.js

@@ -0,0 +1,32 @@
+'use strict';
+
+var clsx = require('clsx');
+var tailwindMerge = require('tailwind-merge');
+
+// src/lib/utils.ts
+function cn(...inputs) {
+  return tailwindMerge.twMerge(clsx.clsx(inputs));
+}
+var clampPage = (page, pageCount) => {
+  if (pageCount <= 0) {
+    return 1;
+  }
+  return Math.min(pageCount, Math.max(1, Math.floor(page)));
+};
+var range = (from, to) => {
+  const out = [];
+  for (let i = from; i <= to; i += 1) {
+    out.push(i);
+  }
+  return out;
+};
+var clamp = (value, min, max) => {
+  return Math.min(max, Math.max(min, value));
+};
+
+exports.clamp = clamp;
+exports.clampPage = clampPage;
+exports.cn = cn;
+exports.range = range;
+//# sourceMappingURL=chunk-UOZYPWDZ.js.map
+//# sourceMappingURL=chunk-UOZYPWDZ.js.map

package/dist/chunk-UOZYPWDZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/utils.ts"],"names":["twMerge","clsx"],"mappings":";;;;;;AAGO,SAAS,MAAM,MAAA,EAAsB;AAC1C,EAAA,OAAOA,qBAAA,CAAQC,SAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;AAEO,IAAM,SAAA,GAAY,CAAC,IAAA,EAAc,SAAA,KAA8B;AACpE,EAAA,IAAI,aAAa,CAAA,EAAG;AAClB,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,SAAA,EAAW,IAAA,CAAK,GAAA,CAAI,GAAG,IAAA,CAAK,KAAA,CAAM,IAAI,CAAC,CAAC,CAAA;AAC1D;AAEO,IAAM,KAAA,GAAQ,CAAC,IAAA,EAAc,EAAA,KAAyB;AAC3D,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,CAAA,GAAI,IAAA,EAAM,CAAA,IAAK,EAAA,EAAI,KAAK,CAAA,EAAG;AAClC,IAAA,GAAA,CAAI,KAAK,CAAC,CAAA;AAAA,EACZ;AACA,EAAA,OAAO,GAAA;AACT;AAEO,IAAM,KAAA,GAAQ,CAAC,KAAA,EAAe,GAAA,EAAa,GAAA,KAAgB;AAChE,EAAA,OAAO,KAAK,GAAA,CAAI,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA,EAAK,KAAK,CAAC,CAAA;AAC3C","file":"chunk-UOZYPWDZ.js","sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n\nexport const clampPage = (page: number, pageCount: number): number => {\n  if (pageCount <= 0) {\n    return 1;\n  }\n  return Math.min(pageCount, Math.max(1, Math.floor(page)));\n}\n\nexport const range = (from: number, to: number): number[] => {\n  const out: number[] = [];\n  for (let i = from; i <= to; i += 1) {\n    out.push(i);\n  }\n  return out;\n}\n\nexport const clamp = (value: number, min: number, max: number) => {\n  return Math.min(max, Math.max(min, value));\n}\n"]}

package/dist/chunk-WL5I7RVS.mjs

@@ -0,0 +1,54 @@
+import { useBodyScrollLock } from './chunk-PMAF6FBF.mjs';
+import { useEffect } from 'react';
+
+var FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), textarea, input, select, [tabindex]:not([tabindex="-1"])';
+var useFocusManagement = ({
+  open,
+  setOpen,
+  contentRef,
+  focusableSelector = FOCUSABLE_SELECTOR
+}) => {
+  useBodyScrollLock(open);
+  useEffect(() => {
+    if (!open) {
+      return;
+    }
+    const handleKeyDown = (event) => {
+      if (event.key === "Escape") {
+        setOpen(false);
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [open, setOpen]);
+  useEffect(() => {
+    if (!open) {
+      return;
+    }
+    const node = contentRef.current;
+    if (!node) {
+      return;
+    }
+    const focusables = Array.from(
+      node.querySelectorAll(focusableSelector)
+    ).filter((element) => element.offsetParent !== null || element === node);
+    const target = focusables[0] ?? node;
+    const previouslyFocused = document.activeElement;
+    target.focus();
+    const handleFocusIn = (event) => {
+      if (!node.contains(event.target)) {
+        event.stopPropagation();
+        target.focus();
+      }
+    };
+    document.addEventListener("focusin", handleFocusIn);
+    return () => {
+      document.removeEventListener("focusin", handleFocusIn);
+      previouslyFocused?.focus?.();
+    };
+  }, [contentRef, open]);
+};
+
+export { useFocusManagement };
+//# sourceMappingURL=chunk-WL5I7RVS.mjs.map
+//# sourceMappingURL=chunk-WL5I7RVS.mjs.map

package/dist/chunk-WL5I7RVS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useFocusManagement/useFocusManagement.ts"],"names":[],"mappings":";;;AAMA,IAAM,kBAAA,GACJ,2FAAA;AAgBK,IAAM,qBAAqB,CAAC;AAAA,EACjC,IAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,iBAAA,GAAoB;AACtB,CAAA,KAKM;AACJ,EAAA,iBAAA,CAAkB,IAAI,CAAA;AAEtB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA;AAAA,IACF;AACA,IAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAAyB;AAC9C,MAAA,IAAI,KAAA,CAAM,QAAQ,QAAA,EAAU;AAC1B,QAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,MACf;AAAA,IACF,CAAA;AACA,IAAA,MAAA,CAAO,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAChD,IAAA,OAAO,MAAM,MAAA,CAAO,mBAAA,CAAoB,SAAA,EAAW,aAAa,CAAA;AAAA,EAClE,CAAA,EAAG,CAAC,IAAA,EAAM,OAAO,CAAC,CAAA;AAElB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA;AAAA,IACF;AACA,IAAA,MAAM,OAAO,UAAA,CAAW,OAAA;AACxB,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA;AAAA,IACF;AACA,IAAA,MAAM,aAAa,KAAA,CAAM,IAAA;AAAA,MACvB,IAAA,CAAK,iBAA8B,iBAAiB;AAAA,KACtD,CAAE,OAAO,CAAC,OAAA,KAAY,QAAQ,YAAA,KAAiB,IAAA,IAAQ,YAAY,IAAI,CAAA;AACvE,IAAA,MAAM,MAAA,GAAS,UAAA,CAAW,CAAC,CAAA,IAAK,IAAA;AAChC,IAAA,MAAM,oBAAoB,QAAA,CAAS,aAAA;AACnC,IAAA,MAAA,CAAO,KAAA,EAAM;AAEb,IAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAAsB;AAC3C,MAAA,IAAI,CAAC,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,MAAc,CAAA,EAAG;AACxC,QAAA,KAAA,CAAM,eAAA,EAAgB;AACtB,QAAA,MAAA,CAAO,KAAA,EAAM;AAAA,MACf;AAAA,IACF,CAAA;AACA,IAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAClD,IAAA,OAAO,MAAM;AACX,MAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,aAAa,CAAA;AACrD,MAAA,iBAAA,EAAmB,KAAA,IAAQ;AAAA,IAC7B,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,UAAA,EAAY,IAAI,CAAC,CAAA;AACvB","file":"chunk-WL5I7RVS.mjs","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { useEffect } from \"react\";\nimport { useBodyScrollLock } from \"../useBodyScrollLock\";\n\nconst FOCUSABLE_SELECTOR =\n  'a[href], button:not([disabled]), textarea, input, select, [tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * Composes modal-like behavior for an open overlay: body scroll lock, Escape to close, and focus trapping.\n *\n * - Delegates scroll locking to {@link useBodyScrollLock} while `open` is true.\n * - Listens for `Escape` on `window` and calls `setOpen(false)`.\n * - When `open` becomes true, focuses the first visible focusable inside `contentRef`, or the container itself.\n * - Traps focus within `contentRef` via a capturing `focusin` listener on `document` that redirects focus back inside.\n * - On close/unmount of the open effect, restores focus to the element that was focused before the trap ran.\n *\n * @param params.open - Whether the overlay is visible.\n * @param params.setOpen - Setter used for Escape and cleanup paths.\n * @param params.contentRef - Root of the dialog/drawer content (must point at a focusable container or include focusables).\n * @param params.focusableSelector - Query selector for tabbable elements; defaults to a common interactive set.\n */\nexport const useFocusManagement = ({\n  open,\n  setOpen,\n  contentRef,\n  focusableSelector = FOCUSABLE_SELECTOR,\n}: {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  contentRef: RefObject<HTMLDivElement | null>;\n  focusableSelector?: string;\n}) => {\n  useBodyScrollLock(open);\n\n  useEffect(() => {\n    if (!open) {\n      return;\n    }\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.key === \"Escape\") {\n        setOpen(false);\n      }\n    };\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, [open, setOpen]);\n\n  useEffect(() => {\n    if (!open) {\n      return;\n    }\n    const node = contentRef.current;\n    if (!node) {\n      return;\n    }\n    const focusables = Array.from(\n      node.querySelectorAll<HTMLElement>(focusableSelector),\n    ).filter((element) => element.offsetParent !== null || element === node);\n    const target = focusables[0] ?? node;\n    const previouslyFocused = document.activeElement as HTMLElement | null;\n    target.focus();\n\n    const handleFocusIn = (event: FocusEvent) => {\n      if (!node.contains(event.target as Node)) {\n        event.stopPropagation();\n        target.focus();\n      }\n    };\n    document.addEventListener(\"focusin\", handleFocusIn);\n    return () => {\n      document.removeEventListener(\"focusin\", handleFocusIn);\n      previouslyFocused?.focus?.();\n    };\n  }, [contentRef, open]);\n};\n"]}

package/dist/chunk-WP7GYBRI.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useMediaQuery/useMediaQuery.ts
+function useMediaQuery(query, defaultValue = false) {
+  const [matches, setMatches] = react.useState(defaultValue);
+  react.useEffect(() => {
+    if (typeof window === "undefined" || !window.matchMedia) {
+      return;
+    }
+    const media = window.matchMedia(query);
+    const onChange = () => {
+      setMatches(media.matches);
+    };
+    setMatches(media.matches);
+    media.addEventListener("change", onChange);
+    return () => {
+      media.removeEventListener("change", onChange);
+    };
+  }, [query]);
+  return matches;
+}
+
+exports.useMediaQuery = useMediaQuery;
+//# sourceMappingURL=chunk-WP7GYBRI.js.map
+//# sourceMappingURL=chunk-WP7GYBRI.js.map

package/dist/chunk-WP7GYBRI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useMediaQuery/useMediaQuery.ts"],"names":["useState","useEffect"],"mappings":";;;;;AAcO,SAAS,aAAA,CACd,KAAA,EACA,YAAA,GAAe,KAAA,EACN;AACT,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAAS,YAAY,CAAA;AAEnD,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,CAAC,OAAO,UAAA,EAAY;AACvD,MAAA;AAAA,IACF;AACA,IAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AACrC,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,UAAA,CAAW,MAAM,OAAO,CAAA;AAAA,IAC1B,CAAA;AACA,IAAA,UAAA,CAAW,MAAM,OAAO,CAAA;AACxB,IAAA,KAAA,CAAM,gBAAA,CAAiB,UAAU,QAAQ,CAAA;AACzC,IAAA,OAAO,MAAM;AACX,MAAA,KAAA,CAAM,mBAAA,CAAoB,UAAU,QAAQ,CAAA;AAAA,IAC9C,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,OAAA;AACT","file":"chunk-WP7GYBRI.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/**\n * Subscribes to `window.matchMedia(query)` and returns whether the query currently matches.\n *\n * On the server or when `matchMedia` is missing, `defaultValue` is used for the initial render and the effect no-ops.\n * The `change` listener keeps `matches` updated when the viewport or user settings change.\n *\n * @param query - A valid media query string, e.g. `\"(min-width: 768px)\"`.\n * @param defaultValue - Value to use before hydration or when `matchMedia` is unavailable (default `false`).\n * @returns Current `matches` boolean for the query.\n */\nexport function useMediaQuery(\n  query: string,\n  defaultValue = false,\n): boolean {\n  const [matches, setMatches] = useState(defaultValue);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\" || !window.matchMedia) {\n      return;\n    }\n    const media = window.matchMedia(query);\n    const onChange = () => {\n      setMatches(media.matches);\n    };\n    setMatches(media.matches);\n    media.addEventListener(\"change\", onChange);\n    return () => {\n      media.removeEventListener(\"change\", onChange);\n    };\n  }, [query]);\n\n  return matches;\n}\n"]}

package/dist/chunk-YPLVTUYL.js

@@ -0,0 +1,56 @@
+'use strict';
+
+var chunkUIYFEP3I_js = require('./chunk-UIYFEP3I.js');
+var react = require('react');
+
+var FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), textarea, input, select, [tabindex]:not([tabindex="-1"])';
+var useFocusManagement = ({
+  open,
+  setOpen,
+  contentRef,
+  focusableSelector = FOCUSABLE_SELECTOR
+}) => {
+  chunkUIYFEP3I_js.useBodyScrollLock(open);
+  react.useEffect(() => {
+    if (!open) {
+      return;
+    }
+    const handleKeyDown = (event) => {
+      if (event.key === "Escape") {
+        setOpen(false);
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [open, setOpen]);
+  react.useEffect(() => {
+    if (!open) {
+      return;
+    }
+    const node = contentRef.current;
+    if (!node) {
+      return;
+    }
+    const focusables = Array.from(
+      node.querySelectorAll(focusableSelector)
+    ).filter((element) => element.offsetParent !== null || element === node);
+    const target = focusables[0] ?? node;
+    const previouslyFocused = document.activeElement;
+    target.focus();
+    const handleFocusIn = (event) => {
+      if (!node.contains(event.target)) {
+        event.stopPropagation();
+        target.focus();
+      }
+    };
+    document.addEventListener("focusin", handleFocusIn);
+    return () => {
+      document.removeEventListener("focusin", handleFocusIn);
+      previouslyFocused?.focus?.();
+    };
+  }, [contentRef, open]);
+};
+
+exports.useFocusManagement = useFocusManagement;
+//# sourceMappingURL=chunk-YPLVTUYL.js.map
+//# sourceMappingURL=chunk-YPLVTUYL.js.map

package/dist/chunk-YPLVTUYL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useFocusManagement/useFocusManagement.ts"],"names":["useBodyScrollLock","useEffect"],"mappings":";;;;;AAMA,IAAM,kBAAA,GACJ,2FAAA;AAgBK,IAAM,qBAAqB,CAAC;AAAA,EACjC,IAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,iBAAA,GAAoB;AACtB,CAAA,KAKM;AACJ,EAAAA,kCAAA,CAAkB,IAAI,CAAA;AAEtB,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA;AAAA,IACF;AACA,IAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAAyB;AAC9C,MAAA,IAAI,KAAA,CAAM,QAAQ,QAAA,EAAU;AAC1B,QAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,MACf;AAAA,IACF,CAAA;AACA,IAAA,MAAA,CAAO,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAChD,IAAA,OAAO,MAAM,MAAA,CAAO,mBAAA,CAAoB,SAAA,EAAW,aAAa,CAAA;AAAA,EAClE,CAAA,EAAG,CAAC,IAAA,EAAM,OAAO,CAAC,CAAA;AAElB,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA;AAAA,IACF;AACA,IAAA,MAAM,OAAO,UAAA,CAAW,OAAA;AACxB,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA;AAAA,IACF;AACA,IAAA,MAAM,aAAa,KAAA,CAAM,IAAA;AAAA,MACvB,IAAA,CAAK,iBAA8B,iBAAiB;AAAA,KACtD,CAAE,OAAO,CAAC,OAAA,KAAY,QAAQ,YAAA,KAAiB,IAAA,IAAQ,YAAY,IAAI,CAAA;AACvE,IAAA,MAAM,MAAA,GAAS,UAAA,CAAW,CAAC,CAAA,IAAK,IAAA;AAChC,IAAA,MAAM,oBAAoB,QAAA,CAAS,aAAA;AACnC,IAAA,MAAA,CAAO,KAAA,EAAM;AAEb,IAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAAsB;AAC3C,MAAA,IAAI,CAAC,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,MAAc,CAAA,EAAG;AACxC,QAAA,KAAA,CAAM,eAAA,EAAgB;AACtB,QAAA,MAAA,CAAO,KAAA,EAAM;AAAA,MACf;AAAA,IACF,CAAA;AACA,IAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAClD,IAAA,OAAO,MAAM;AACX,MAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,aAAa,CAAA;AACrD,MAAA,iBAAA,EAAmB,KAAA,IAAQ;AAAA,IAC7B,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,UAAA,EAAY,IAAI,CAAC,CAAA;AACvB","file":"chunk-YPLVTUYL.js","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { useEffect } from \"react\";\nimport { useBodyScrollLock } from \"../useBodyScrollLock\";\n\nconst FOCUSABLE_SELECTOR =\n  'a[href], button:not([disabled]), textarea, input, select, [tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * Composes modal-like behavior for an open overlay: body scroll lock, Escape to close, and focus trapping.\n *\n * - Delegates scroll locking to {@link useBodyScrollLock} while `open` is true.\n * - Listens for `Escape` on `window` and calls `setOpen(false)`.\n * - When `open` becomes true, focuses the first visible focusable inside `contentRef`, or the container itself.\n * - Traps focus within `contentRef` via a capturing `focusin` listener on `document` that redirects focus back inside.\n * - On close/unmount of the open effect, restores focus to the element that was focused before the trap ran.\n *\n * @param params.open - Whether the overlay is visible.\n * @param params.setOpen - Setter used for Escape and cleanup paths.\n * @param params.contentRef - Root of the dialog/drawer content (must point at a focusable container or include focusables).\n * @param params.focusableSelector - Query selector for tabbable elements; defaults to a common interactive set.\n */\nexport const useFocusManagement = ({\n  open,\n  setOpen,\n  contentRef,\n  focusableSelector = FOCUSABLE_SELECTOR,\n}: {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  contentRef: RefObject<HTMLDivElement | null>;\n  focusableSelector?: string;\n}) => {\n  useBodyScrollLock(open);\n\n  useEffect(() => {\n    if (!open) {\n      return;\n    }\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.key === \"Escape\") {\n        setOpen(false);\n      }\n    };\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, [open, setOpen]);\n\n  useEffect(() => {\n    if (!open) {\n      return;\n    }\n    const node = contentRef.current;\n    if (!node) {\n      return;\n    }\n    const focusables = Array.from(\n      node.querySelectorAll<HTMLElement>(focusableSelector),\n    ).filter((element) => element.offsetParent !== null || element === node);\n    const target = focusables[0] ?? node;\n    const previouslyFocused = document.activeElement as HTMLElement | null;\n    target.focus();\n\n    const handleFocusIn = (event: FocusEvent) => {\n      if (!node.contains(event.target as Node)) {\n        event.stopPropagation();\n        target.focus();\n      }\n    };\n    document.addEventListener(\"focusin\", handleFocusIn);\n    return () => {\n      document.removeEventListener(\"focusin\", handleFocusIn);\n      previouslyFocused?.focus?.();\n    };\n  }, [contentRef, open]);\n};\n"]}

package/dist/hooks/useBodyScrollLock.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Locks the document body scroll while `locked` is true by setting `document.body.style.overflow`
+ * to `"hidden"`. Uses a module-level lock count so multiple concurrent callers (nested modals,
+ * drawer + modal, several hook instances) only restore the original inline `overflow` after the
+ * last lock releases.
+ *
+ * Typical use: modals, drawers, and full-screen overlays where background content must not scroll.
+ *
+ * @param locked - When `true`, body scroll is hidden; when `false`, this instance releases its
+ *   lock; the prior overflow is restored only when no instance still holds a lock.
+ */
+declare const useBodyScrollLock: (locked: boolean) => void;
+
+export { useBodyScrollLock };

package/dist/hooks/useBodyScrollLock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Locks the document body scroll while `locked` is true by setting `document.body.style.overflow`
+ * to `"hidden"`. Uses a module-level lock count so multiple concurrent callers (nested modals,
+ * drawer + modal, several hook instances) only restore the original inline `overflow` after the
+ * last lock releases.
+ *
+ * Typical use: modals, drawers, and full-screen overlays where background content must not scroll.
+ *
+ * @param locked - When `true`, body scroll is hidden; when `false`, this instance releases its
+ *   lock; the prior overflow is restored only when no instance still holds a lock.
+ */
+declare const useBodyScrollLock: (locked: boolean) => void;
+
+export { useBodyScrollLock };

package/dist/hooks/useBodyScrollLock.js

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

package/dist/hooks/useBodyScrollLock.js.map

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

package/dist/hooks/useBodyScrollLock.mjs

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

package/dist/hooks/useBodyScrollLock.mjs.map

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

package/dist/hooks/useClickOutside.d.mts

@@ -0,0 +1,23 @@
+import { Dispatch, SetStateAction, RefObject } from 'react';
+
+/** DOM events that can represent an “outside” press for closing overlays. */
+type ClickOutsideEventType = "mousedown" | "pointerdown" | "touchstart";
+type UseClickOutsideParams = {
+    /** Called with `false` when a qualifying event target is outside `ref.current`. */
+    setOpen: (open: boolean) => void | Dispatch<SetStateAction<boolean>>;
+    /** Root element of the floating UI; clicks inside this node do not close. */
+    ref: RefObject<HTMLElement | null>;
+    /** Defaults to `["mousedown"]` for backward compatibility */
+    listenEvents?: ClickOutsideEventType[];
+};
+/**
+ * Registers document-level listeners so that when the user activates outside of `ref`, `setOpen(false)`
+ * runs. Useful for dropdowns, popovers, and menus paired with `open` state.
+ *
+ * @param params.setOpen - State setter or callback that closes the surface.
+ * @param params.ref - Container ref; outside is determined with `contains()` on the event target.
+ * @param params.listenEvents - Which events to listen for; default is `mousedown` only.
+ */
+declare const useClickOutside: ({ setOpen, ref, listenEvents, }: UseClickOutsideParams) => void;
+
+export { type ClickOutsideEventType, type UseClickOutsideParams, useClickOutside };

package/dist/hooks/useClickOutside.d.ts

@@ -0,0 +1,23 @@
+import { Dispatch, SetStateAction, RefObject } from 'react';
+
+/** DOM events that can represent an “outside” press for closing overlays. */
+type ClickOutsideEventType = "mousedown" | "pointerdown" | "touchstart";
+type UseClickOutsideParams = {
+    /** Called with `false` when a qualifying event target is outside `ref.current`. */
+    setOpen: (open: boolean) => void | Dispatch<SetStateAction<boolean>>;
+    /** Root element of the floating UI; clicks inside this node do not close. */
+    ref: RefObject<HTMLElement | null>;
+    /** Defaults to `["mousedown"]` for backward compatibility */
+    listenEvents?: ClickOutsideEventType[];
+};
+/**
+ * Registers document-level listeners so that when the user activates outside of `ref`, `setOpen(false)`
+ * runs. Useful for dropdowns, popovers, and menus paired with `open` state.
+ *
+ * @param params.setOpen - State setter or callback that closes the surface.
+ * @param params.ref - Container ref; outside is determined with `contains()` on the event target.
+ * @param params.listenEvents - Which events to listen for; default is `mousedown` only.
+ */
+declare const useClickOutside: ({ setOpen, ref, listenEvents, }: UseClickOutsideParams) => void;
+
+export { type ClickOutsideEventType, type UseClickOutsideParams, useClickOutside };

package/dist/hooks/useClickOutside.js

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

package/dist/hooks/useClickOutside.js.map

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

package/dist/hooks/useClickOutside.mjs

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

package/dist/hooks/useClickOutside.mjs.map

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

package/dist/hooks/useClipboard.d.mts

@@ -0,0 +1,22 @@
+type UseClipboardResult = {
+    /** `true` after a successful `copy` until the reset delay elapses or `reset` is called. */
+    copied: boolean;
+    /** Set when the Clipboard API is missing or `writeText` rejects (e.g. permission denied). */
+    error: Error | undefined;
+    /** Writes `text` via `navigator.clipboard.writeText`; returns whether the write succeeded. */
+    copy: (text: string) => Promise<boolean>;
+    /** Clears `copied`/`error` and cancels any pending auto-reset timeout. */
+    reset: () => void;
+};
+/**
+ * Wraps the async Clipboard API with React state for UX feedback (“Copied!”) and error surfacing.
+ *
+ * After a successful copy, `copied` flips to `true` for `resetDelay` ms (or stays true if `resetDelay` is 0).
+ * SSR-safe: `copy` resolves `false` with an error when `navigator.clipboard` is unavailable.
+ *
+ * @param resetDelay - Milliseconds before `copied` auto-clears after success; `0` disables auto-clear.
+ * @returns `{ copied, error, copy, reset }` for rendering and handlers.
+ */
+declare function useClipboard(resetDelay?: number): UseClipboardResult;
+
+export { type UseClipboardResult, useClipboard };

package/dist/hooks/useClipboard.d.ts

@@ -0,0 +1,22 @@
+type UseClipboardResult = {
+    /** `true` after a successful `copy` until the reset delay elapses or `reset` is called. */
+    copied: boolean;
+    /** Set when the Clipboard API is missing or `writeText` rejects (e.g. permission denied). */
+    error: Error | undefined;
+    /** Writes `text` via `navigator.clipboard.writeText`; returns whether the write succeeded. */
+    copy: (text: string) => Promise<boolean>;
+    /** Clears `copied`/`error` and cancels any pending auto-reset timeout. */
+    reset: () => void;
+};
+/**
+ * Wraps the async Clipboard API with React state for UX feedback (“Copied!”) and error surfacing.
+ *
+ * After a successful copy, `copied` flips to `true` for `resetDelay` ms (or stays true if `resetDelay` is 0).
+ * SSR-safe: `copy` resolves `false` with an error when `navigator.clipboard` is unavailable.
+ *
+ * @param resetDelay - Milliseconds before `copied` auto-clears after success; `0` disables auto-clear.
+ * @returns `{ copied, error, copy, reset }` for rendering and handlers.
+ */
+declare function useClipboard(resetDelay?: number): UseClipboardResult;
+
+export { type UseClipboardResult, useClipboard };

package/dist/hooks/useClipboard.js

@@ -0,0 +1,51 @@
+"use client";
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useClipboard/useClipboard.ts
+function useClipboard(resetDelay = 2e3) {
+  const [copied, setCopied] = react.useState(false);
+  const [error, setError] = react.useState(void 0);
+  const timeoutRef = react.useRef(
+    void 0
+  );
+  const reset = react.useCallback(() => {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = void 0;
+    }
+    setCopied(false);
+    setError(void 0);
+  }, []);
+  const copy = react.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 };
+}
+
+exports.useClipboard = useClipboard;
+//# sourceMappingURL=useClipboard.js.map
+//# sourceMappingURL=useClipboard.js.map

package/dist/hooks/useClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useClipboard/useClipboard.ts"],"names":["useState","useRef","useCallback"],"mappings":";;;;;AAwBO,SAAS,YAAA,CAAa,aAAa,GAAA,EAA0B;AAClE,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIA,eAAS,KAAK,CAAA;AAC1C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAA4B,MAAS,CAAA;AAC/D,EAAA,MAAM,UAAA,GAAaC,YAAA;AAAA,IACjB;AAAA,GACF;AAEA,EAAA,MAAM,KAAA,GAAQC,kBAAY,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,GAAOA,iBAAA;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.js","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"]}