@zentauri-ui/zentauri-components 1.4.0 → 1.4.1

package/README.md

@@ -280,16 +280,25 @@ Which UI folders are valid for `add` is driven by **`cli/registry.json`**: a gen
 
 ### Commands
 
+Call the published binary by name after the package (recommended so `npx` does not treat the first word as a shell command):
+
+```bash
+npx @zentauri-ui/zentauri-components zentauri-components init
+npx @zentauri-ui/zentauri-components zentauri-components add buttons inputs
+```
+
+**Hooks only** (copy `src/hooks/<name>` into your app, plus sibling hook dependencies such as `useMediaQuery` when needed):
+
 ```bash
-npx @zentauri-ui/zentauri-components init
-npx @zentauri-ui/zentauri-components add buttons inputs
+npx @zentauri-ui/zentauri-components zentauri-components add hook useWindowSize
+npx @zentauri-ui/zentauri-components zentauri-components add hook useToggle useDebouncedValue
 ```
 
-The **`zentauri-ui`** command is the same script as **`zentauri-components`** (`package.json` → `bin`). If `npx` does not resolve the binary you expect, pin the package explicitly:
+The **`zentauri-ui`** binary is the same entry as **`zentauri-components`**. If `npx` still mis-resolves, pin the package:
 
 ```bash
 npx --yes --package=@zentauri-ui/zentauri-components zentauri-components init
-npx --yes --package=@zentauri-ui/zentauri-components zentauri-ui add button
+npx --yes --package=@zentauri-ui/zentauri-components zentauri-components add button
 ```
 
 From a monorepo checkout you can run the script by path instead of `npx`:
@@ -297,12 +306,14 @@ From a monorepo checkout you can run the script by path instead of `npx`:
 ```bash
 node node_modules/@zentauri-ui/zentauri-components/cli/index.mjs init
 node node_modules/@zentauri-ui/zentauri-components/cli/index.mjs add accordion
+node node_modules/@zentauri-ui/zentauri-components/cli/index.mjs add hook useWindowSize
 ```
 
 | Command | What it does |
 | ------- | -------------- |
 | `init` | Writes **`components.json`** in the current working directory (or `--cwd`) with default `aliases` and `resolvedPaths`. Refuses to overwrite an existing file. |
-| `add <names...>` | Walks up from `--cwd` (default `.`) to find `components.json`, then copies each resolved UI folder, pulls in hooks those files depend on (including transitive hook imports), and creates **`src/lib/utils.ts`** from the package template if it is missing. |
+| `add <names...>` | Walks up from `--cwd` (default `.`) to find `components.json`, then copies each resolved **UI** folder under `src/ui`, pulls in hooks those files depend on (including transitive hook imports), and creates **`lib/utils`** at `resolvedPaths.utils` from the package template if it is missing. |
+| `add hook <names...>` | Same config lookup; copies only **hook** folders listed under `registry.hooks` (from `hooksEntryNames` in `tsup.config.ts`), including transitive sibling-hook imports. Does not copy UI unless a hook’s imports require you to add a component separately (for example `usePagination` imports types from `ui/pagination`). |
 
 Global flags: `-h` / `--help`, `-v` / `--version`, `--cwd <dir>` (relative to `process.cwd()`).
 
@@ -328,6 +339,7 @@ Defaults look like this; edit `resolvedPaths` and `aliases` so they match your a
 ### Registry (`cli/registry.json`)
 
 - **`components`**: sorted list of folder names under **`src/ui/`** that `add` may copy. The file is **generated**; the canonical build list lives in **`tsup.config.ts`** as `uiComponentNames`, and the generator always ensures **`spinner`** is included so the CLI stays aligned with the animated-only spinner bundle.
+- **`hooks`**: sorted list of folder names under **`src/hooks/`** that `add hook` may copy; generated from **`hooksEntryNames`** in **`tsup.config.ts`** (same entries as published `…/hooks/<name>` subpaths).
 - **`nameAliases`**: optional map from a CLI token to a real folder name. Today: `button` → `buttons`, `input` → `inputs` (matching common singular names while folders stay plural).
 
 Example: these are equivalent when `nameAliases` is configured:
@@ -359,7 +371,7 @@ From this package directory in the monorepo:
 - `pnpm build` (or `npm run build`) — production bundle via `tsup` (Rollup treeshake + `scripts/prepend-use-client.mjs` via `onSuccess` so each UI entry under `dist/ui/`, including `dist/ui/<name>/animated.*`, starts with `"use client"` where needed)
 - `pnpm dev` — `tsup` watch mode (same `onSuccess` hook after each rebuild)
 - `pnpm test` / `pnpm test:watch` — **Vitest** and **Testing Library** unit tests
-- **`pnpm run generate:registry`** — runs `scripts/generate-registry.mjs`, which reads **`uiComponentNames`** from `tsup.config.ts`, merges in **`spinner`**, applies fixed **`nameAliases`**, and writes **`cli/registry.json`**. Run this after adding or renaming UI areas so the CLI’s addable list stays in sync (the script prints how many components were written).
+- **`pnpm run generate:registry`** — runs `scripts/generate-registry.mjs`, which reads **`uiComponentNames`** and **`hooksEntryNames`** from `tsup.config.ts`, merges in **`spinner`**, applies fixed **`nameAliases`**, and writes **`cli/registry.json`** (`components` + `hooks`). Run this after adding or renaming UI areas or hook entries so the CLI stays in sync (the script prints counts).
 - **`prepack`** — invokes `generate:registry` automatically before `npm pack` / publish so the published tarball always ships an up-to-date registry alongside `cli/index.mjs`.
 
 ## Github Release log

package/cli/cli.integration.test.ts

@@ -48,4 +48,32 @@ describe("zentauri-ui CLI", () => {
       rmSync(dir, { recursive: true, force: true });
     }
   });
+
+  it("should add hook-only mode for useWindowSize", () => {
+    const dir = mkdtempSync(join(tmpdir(), "zentauri-cli-hook-"));
+    try {
+      runCli(dir, ["init"]);
+      runCli(dir, ["add", "hook", "useWindowSize"]);
+      const hookFile = join(dir, "src/hooks/useWindowSize/useWindowSize.ts");
+      expect(existsSync(hookFile)).toBe(true);
+      const src = readFileSync(hookFile, "utf8");
+      expect(src).toContain("useWindowSize");
+      expect(src).toContain('"use client"');
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  it("should pull transitive hook deps for usePrefersReducedMotion", () => {
+    const dir = mkdtempSync(join(tmpdir(), "zentauri-cli-hook-trans-"));
+    try {
+      runCli(dir, ["init"]);
+      runCli(dir, ["add", "hook", "usePrefersReducedMotion"]);
+      expect(
+        existsSync(join(dir, "src/hooks/useMediaQuery/useMediaQuery.ts")),
+      ).toBe(true);
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
 });

package/cli/index.mjs

@@ -134,8 +134,15 @@ function printHelp() {
   console.log(`Zentauri UI — copy component source into your app (shadcn-style)
 
 Usage:
-  zentauri-components init [options]   Create components.json with defaults
-  zentauri-components add <names...>   Copy one or more components (and deps)
+  zentauri-components init [options]              Create components.json with defaults
+  zentauri-components add <component> [...]       Copy UI components (and their hooks)
+  zentauri-components add hook <hook> [...]     Copy hook source only (plus transitive hook deps)
+
+List of components:
+${registry.components.join("\n")}
+
+List of hooks:
+${registry.hooks.join("\n")}
 
   (The zentauri-ui binary name works the same if your PATH exposes it.)
 
@@ -147,7 +154,11 @@ Options:
 Local (no npm publish): cd to your app root, then run Node with a path to this CLI (yours may differ):
   node ../../packages/components/cli/index.mjs init
   node ../../packages/components/cli/index.mjs add button
-  Only copies that component’s folder (here: ui/buttons) and creates lib/utils.ts if missing—not the whole monorepo.
+  node ../../packages/components/cli/index.mjs add hook useWindowSize
+  Only copies the requested trees; not the whole monorepo.
+
+Use hooks from the package without copying (after npm install):
+  import { useWindowSize } from "@zentauri-ui/zentauri-components/hooks/useWindowSize";
 
 Published package:
   npx @zentauri-ui/zentauri-components init
@@ -341,6 +352,25 @@ function resolveComponentName(input, registry) {
   );
 }
 
+/**
+ * @param {string} input — argv token, e.g. `useWindowSize`
+ * @param {object} registry — must include `hooks` string array
+ * @returns {string} — canonical hook folder name under `src/hooks`
+ */
+function resolveHookName(input, registry) {
+  const list = registry.hooks ?? [];
+  if (list.includes(input)) {
+    return input;
+  }
+  const found = list.find((h) => h.toLowerCase() === input.toLowerCase());
+  if (found) {
+    return found;
+  }
+  throw new Error(
+    `Unknown hook "${input}". Valid hooks include: ${list.join(", ")}`,
+  );
+}
+
 /**
  * Starting from hook folder names discovered in UI code, expands the set to
  * include every hook that those hooks import from **sibling** hook packages
@@ -560,9 +590,33 @@ async function cmdAdd(names, cwd) {
   validateConfig(config);
 
   const registry = loadRegistry();
-  const resolvedNames = names.map((n) => resolveComponentName(n, registry));
+  const hookMode =
+    names.length > 0 && names[0].toLowerCase() === "hook";
+  const payload = hookMode ? names.slice(1) : names;
+
+  if (hookMode && payload.length === 0) {
+    console.error(
+      "Usage: zentauri-components add hook <hookName> [more...]  (e.g. add hook useWindowSize)",
+    );
+    process.exitCode = 1;
+    return;
+  }  
+
+  if (hookMode) {
+    const resolvedHooks = payload.map((n) => resolveHookName(n, registry));
+    const finalHooks = await collectHookTransitiveClosure(
+      packageRoot,
+      resolvedHooks,
+    );
+    for (const h of finalHooks) {
+      console.log(`Adding hook ${h}…`);
+      await copyHookFolder(h, config, configDir, packageRoot);
+    }
+    console.log("Done.");
+    return;
+  }
 
-  await ensureUtilsFile(config, configDir, packageRoot);
+  const resolvedNames = payload.map((n) => resolveComponentName(n, registry));
 
   const allHooks = new Set();
   for (const name of resolvedNames) {
@@ -644,7 +698,7 @@ async function main() {
   if (cmd === "add") {
     if (rest.length === 0) {
       console.error(
-        "Usage: zentauri-components add <component> [more...]  (or: zentauri-ui add …)",
+        "Usage: zentauri-components add <component> [more...]  |  add hook <hookName> [more...]",
       );
       process.exitCode = 1;
       return;

package/cli/registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "description": "Addable UI component folder names under src/ui. Generated by scripts/generate-registry.mjs.",
+  "description": "Addable UI components (src/ui) and hooks (src/hooks). Generated by scripts/generate-registry.mjs.",
   "components": [
     "accordion",
     "alert",
@@ -29,6 +29,33 @@
     "toggle",
     "tooltip"
   ],
+  "hooks": [
+    "useBodyScrollLock",
+    "useClickOutside",
+    "useClipboard",
+    "useControllableState",
+    "useDebouncedValue",
+    "useDisclosure",
+    "useDocumentTitle",
+    "useFocusManagement",
+    "useHover",
+    "useInView",
+    "useIntersectionObserver",
+    "useIsMounted",
+    "useIsomorphicLayoutEffect",
+    "useLocalStorage",
+    "useMediaQuery",
+    "useNetworkStatus",
+    "usePageVisibility",
+    "usePagination",
+    "usePrefersColorScheme",
+    "usePrefersReducedMotion",
+    "useResizeObserver",
+    "useSessionStorage",
+    "useThrottledCallback",
+    "useToggle",
+    "useWindowSize"
+  ],
   "nameAliases": {
     "button": "buttons",
     "input": "inputs"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zentauri-ui/zentauri-components",
-  "version": "1.4.0",
-  "description": "A UI component library built with React and Tailwind CSS",
+  "version": "1.4.1",
+  "description": "React + Tailwind UI kit with ESM/CJS builds, per-entry exports, and a zentauri-components / zentauri-ui CLI to vendor UI or hook source into your app",
   "license": "MIT",
   "files": ["dist", "src/ui", "src/lib", "src/hooks", "cli"],
   "sideEffects": false,

package/dist/hooks/index.d.ts

@@ -1,27 +0,0 @@
-export { cn, clampPage, range } from "../lib/utils";
-export { useBodyScrollLock } from "./useBodyScrollLock";
-export { useClickOutside, type ClickOutsideEventType, type UseClickOutsideParams, } from "./useClickOutside";
-export { useFocusManagement } from "./useFocusManagement";
-export { buildPaginationItems, usePagination, type BuildPaginationItemsParams, type PaginationPageItem, } from "./usePagination";
-export { useClipboard, type UseClipboardResult } from "./useClipboard";
-export { useControllableState, type UseControllableStateParams, } from "./useControllableState";
-export { useDebouncedValue } from "./useDebouncedValue";
-export { useDisclosure, type UseDisclosureParams, type UseDisclosureResult, } from "./useDisclosure";
-export { useDocumentTitle, type UseDocumentTitleParams } from "./useDocumentTitle";
-export { useHover } from "./useHover";
-export { useInView, type UseInViewParams } from "./useInView";
-export { useIntersectionObserver, type UseIntersectionObserverParams, } from "./useIntersectionObserver";
-export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect";
-export { useIsMounted } from "./useIsMounted";
-export { useLocalStorage, type UseLocalStorageResult } from "./useLocalStorage";
-export { useMediaQuery } from "./useMediaQuery";
-export { useNetworkStatus } from "./useNetworkStatus";
-export { usePageVisibility } from "./usePageVisibility";
-export { usePrefersColorScheme, type ColorSchemePreference, } from "./usePrefersColorScheme";
-export { usePrefersReducedMotion } from "./usePrefersReducedMotion";
-export { useResizeObserver, type ElementSize } from "./useResizeObserver";
-export { useSessionStorage, type UseSessionStorageResult } from "./useSessionStorage";
-export { useThrottledCallback } from "./useThrottledCallback";
-export { useToggle } from "./useToggle";
-export { useWindowSize, type WindowSize } from "./useWindowSize";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,uBAAuB,EACvB,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

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

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

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

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

package/dist/hooks/useBodyScrollLock/useBodyScrollLock.d.ts

@@ -1,13 +0,0 @@
-/**
- * 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.
- */
-export declare const useBodyScrollLock: (locked: boolean) => void;
-//# sourceMappingURL=useBodyScrollLock.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useBodyScrollLock.d.ts","sourceRoot":"","sources":["../../../src/hooks/useBodyScrollLock/useBodyScrollLock.ts"],"names":[],"mappings":"AA0BA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,OAAO,SAUhD,CAAC"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useClickOutside/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/hooks/useClickOutside/useClickOutside.d.ts

@@ -1,22 +0,0 @@
-import type { RefObject } from "react";
-import { Dispatch, SetStateAction } from "react";
-/** DOM events that can represent an “outside” press for closing overlays. */
-export type ClickOutsideEventType = "mousedown" | "pointerdown" | "touchstart";
-export 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.
- */
-export declare const useClickOutside: ({ setOpen, ref, listenEvents, }: UseClickOutsideParams) => void;
-//# sourceMappingURL=useClickOutside.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useClickOutside.d.ts","sourceRoot":"","sources":["../../../src/hooks/useClickOutside/useClickOutside.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAa,MAAM,OAAO,CAAC;AAE5D,6EAA6E;AAC7E,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,MAAM,qBAAqB,GAAG;IAClC,mFAAmF;IACnF,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,6EAA6E;IAC7E,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACnC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,iCAI7B,qBAAqB,SAmBvB,CAAC"}

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

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

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

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

package/dist/hooks/useClipboard/useClipboard.d.ts

@@ -1,21 +0,0 @@
-export 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.
- */
-export declare function useClipboard(resetDelay?: number): UseClipboardResult;
-//# sourceMappingURL=useClipboard.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useClipboard.d.ts","sourceRoot":"","sources":["../../../src/hooks/useClipboard/useClipboard.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC;IAChB,6FAA6F;IAC7F,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,8FAA8F;IAC9F,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,0EAA0E;IAC1E,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,SAAO,GAAG,kBAAkB,CA4ClE"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useControllableState/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,wBAAwB,CAAC"}

package/dist/hooks/useControllableState/useControllableState.d.ts

@@ -1,21 +0,0 @@
-export 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.
- */
-export declare function useControllableState<T>({ value: valueProp, defaultValue, onChange, }: UseControllableStateParams<T>): [T, (next: T | ((prev: T) => T)) => void];
-//# sourceMappingURL=useControllableState.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useControllableState.d.ts","sourceRoot":"","sources":["../../../src/hooks/useControllableState/useControllableState.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,0BAA0B,CAAC,CAAC,IAAI;IAC1C,gFAAgF;IAChF,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,2EAA2E;IAC3E,YAAY,EAAE,CAAC,CAAC;IAChB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EACtC,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,QAAQ,GACT,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAoB3E"}

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

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

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

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

package/dist/hooks/useDebouncedValue/useDebouncedValue.d.ts

@@ -1,13 +0,0 @@
-/**
- * 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.
- */
-export declare function useDebouncedValue<T>(value: T, delayMs: number): T;
-//# sourceMappingURL=useDebouncedValue.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useDebouncedValue.d.ts","sourceRoot":"","sources":["../../../src/hooks/useDebouncedValue/useDebouncedValue.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAajE"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useDisclosure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/hooks/useDisclosure/useDisclosure.d.ts

@@ -1,24 +0,0 @@
-export 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;
-};
-export 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.
- */
-export declare function useDisclosure({ open: openProp, defaultOpen, onOpenChange, }?: UseDisclosureParams): UseDisclosureResult;
-//# sourceMappingURL=useDisclosure.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useDisclosure.d.ts","sourceRoot":"","sources":["../../../src/hooks/useDisclosure/useDisclosure.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG;IAChC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kGAAkG;IAClG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EAAE,QAAQ,EACd,WAAmB,EACnB,YAAY,GACb,GAAE,mBAAwB,GAAG,mBAAmB,CA2BhD"}

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

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

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

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

package/dist/hooks/useDocumentTitle/useDocumentTitle.d.ts

@@ -1,18 +0,0 @@
-export 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.
- */
-export declare function useDocumentTitle({ title, restoreOnUnmount, }: UseDocumentTitleParams): void;
-//# sourceMappingURL=useDocumentTitle.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useDocumentTitle.d.ts","sourceRoot":"","sources":["../../../src/hooks/useDocumentTitle/useDocumentTitle.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,iHAAiH;IACjH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,gBAAuB,GACxB,EAAE,sBAAsB,GAAG,IAAI,CAiC/B"}

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

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

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

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

package/dist/hooks/useFocusManagement/useFocusManagement.d.ts

@@ -1,22 +0,0 @@
-import type { 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.
- */
-export declare const useFocusManagement: ({ open, setOpen, contentRef, focusableSelector, }: {
-    open: boolean;
-    setOpen: (open: boolean) => void;
-    contentRef: RefObject<HTMLDivElement | null>;
-    focusableSelector?: string;
-}) => void;
-//# sourceMappingURL=useFocusManagement.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useFocusManagement.d.ts","sourceRoot":"","sources":["../../../src/hooks/useFocusManagement/useFocusManagement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,GAAI,mDAKhC;IACD,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,SA2CA,CAAC"}

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

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

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

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

package/dist/hooks/useHover/useHover.d.ts

@@ -1,13 +0,0 @@
-import type { 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).
- */
-export declare function useHover<T extends HTMLElement>(): [RefCallback<T>, boolean];
-//# sourceMappingURL=useHover.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useHover.d.ts","sourceRoot":"","sources":["../../../src/hooks/useHover/useHover.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzC;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CA6B3E"}

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

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

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

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

package/dist/hooks/useInView/useInView.d.ts

@@ -1,17 +0,0 @@
-import type { RefCallback } from "react";
-export type UseInViewParams = IntersectionObserverInit & {
-    /** When `false`, no observer is attached (useful to pause work when off-screen lists are virtualized). */
-    enabled?: boolean;
-};
-/**
- * Convenience wrapper around {@link useIntersectionObserver} that exposes only a boolean `inView` flag.
- *
- * `inView` is `true` when the latest `IntersectionObserverEntry.isIntersecting` is truthy; otherwise `false`.
- * Accepts the same `root`, `rootMargin`, `threshold`, and `enabled` options as the underlying observer.
- *
- * @typeParam T - Observed element type.
- * @param params - IntersectionObserver options plus optional `enabled` flag.
- * @returns `[setRef, inView]` callback ref and intersection boolean.
- */
-export declare function useInView<T extends Element>(params?: UseInViewParams): [RefCallback<T>, boolean];
-//# sourceMappingURL=useInView.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useInView.d.ts","sourceRoot":"","sources":["../../../src/hooks/useInView/useInView.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAIzC,MAAM,MAAM,eAAe,GAAG,wBAAwB,GAAG;IACvD,0GAA0G;IAC1G,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EACzC,MAAM,GAAE,eAAoB,GAC3B,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAI3B"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useIntersectionObserver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAC"}