@zentauri-ui/zentauri-components 1.1.1 → 1.2.1

package/README.md

@@ -6,16 +6,16 @@ A React UI kit for building product interfaces with Tailwind CSS. Components are
 
 The library targets **React 18+** apps that use **Tailwind CSS v4** (or an equivalent setup where Tailwind can scan this package via `@source`). Styling uses utility classes; **class-variance-authority** powers variant APIs (size, appearance, and similar props), with **clsx** and **tailwind-merge** for predictable `className` composition. **Framer Motion** backs motion where components animate, and **react-icons** is used for iconography where applicable.
 
-Published artifacts live under `dist/`. You can import either the **UI barrel** (`@zentauri-ui/zentauri-components/ui`) or a **per-area subpath** (`@zentauri-ui/zentauri-components/ui/<name>`) so bundlers only pull in the entry you use. Most apps rely on Tailwind scanning the package sources (see installation); a separate CSS import is not required for that setup.
+Published artifacts live under `dist/`. Imports use **per-entry subpaths**: `@zentauri-ui/zentauri-components/ui/<area>` for components and `@zentauri-ui/zentauri-components/hooks/<entry>` for React hooks (and shared helpers under `hooks/utils`). Each entry resolves to its own ESM (`.mjs`), CJS (`.js`), and types (`.d.ts`) so bundlers pull only what you import. Most apps rely on Tailwind scanning the package sources (see installation); a separate CSS import is not required for that setup.
 
 ## Package exports
 
-| Subpath                                      | Description                                                                                                                      |
-| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `@zentauri-ui/zentauri-components/ui`        | Full UI barrel: all components, hooks, and types (ESM `.js`, CJS `.cjs`, `.d.ts`)                                                |
-| `@zentauri-ui/zentauri-components/ui/<name>` | Single area entry (same artifacts per file). Use this when you import from one module only to keep the dependency graph smaller. |
+| Subpath                                         | Description                                                                                                                                 |
+| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@zentauri-ui/zentauri-components/ui/<name>`   | Single UI area: components (and any re-exports from that area’s `index`, e.g. `usePagination` from `ui/pagination`).                         |
+| `@zentauri-ui/zentauri-components/hooks/<entry>` | One hook module or `utils` (`cn`, `clampPage`, `range` from `src/lib/utils.ts`). Entries match files under `src/hooks/` (see **React hooks**). |
 
-The `<name>` segment matches the folder under `src/ui/` (for example `accordion`, `select`, `empty-state`, `buttons` for `Button`, `inputs` for `Input`).
+The UI `<name>` segment matches the folder under `src/ui/` (for example `accordion`, `select`, `empty-state`, `buttons` for `Button`, `inputs` for `Input`). The hooks `<entry>` is the file stem (for example `useMediaQuery`, `usePagination`) or `utils`.
 
 ## Requirements
 
@@ -24,7 +24,7 @@ The `<name>` segment matches the folder under `src/ui/` (for example `accordion`
 
 ## Components
 
-Each area is available from the barrel and from its own subpath (`…/ui/<subpath>`):
+Each area is available from its own subpath (`…/ui/<subpath>`):
 
 | Area           | Subpath `…/ui/…` |
 | -------------- | ---------------- |
@@ -55,9 +55,56 @@ Each area is available from the barrel and from its own subpath (`…/ui/<subpat
 | Toggle         | `toggle`         |
 | Tooltip        | `tooltip`        |
 
+## React hooks
+
+Hooks live in `src/hooks/`. Each hook is a separate published entry under `@zentauri-ui/zentauri-components/hooks/<name>` (same pattern as UI areas). Types are exported where the implementation defines them (for example `UseDisclosureResult`, `PaginationPageItem`). For class-name merging and pagination helpers used alongside hooks, import from `@zentauri-ui/zentauri-components/hooks/utils`.
+
+| Hook / module              | Subpath `…/hooks/…`           | Notes (selected exports) |
+| -------------------------- | ----------------------------- | -------------------------- |
+| `useBodyScrollLock`        | `useBodyScrollLock`           | Locks document scroll while open |
+| `useClickOutside`          | `useClickOutside`             | `ClickOutsideEventType`, `UseClickOutsideParams` |
+| `useClipboard`             | `useClipboard`                | `UseClipboardResult` |
+| `useControllableState`     | `useControllableState`        | `UseControllableStateParams` |
+| `useDebouncedValue`        | `useDebouncedValue`           | Debounced state from a value |
+| `useDisclosure`            | `useDisclosure`               | `UseDisclosureParams`, `UseDisclosureResult` |
+| `useDocumentTitle`         | `useDocumentTitle`            | `UseDocumentTitleParams` |
+| `useFocusManagement`       | `useFocusManagement`          | Focus trap / focus moves for overlays |
+| `useHover`                 | `useHover`                    | Pointer hover state |
+| `useInView`                | `useInView`                   | `UseInViewParams` |
+| `useIntersectionObserver`  | `useIntersectionObserver`     | `UseIntersectionObserverParams` |
+| `useIsomorphicLayoutEffect`| `useIsomorphicLayoutEffect`   | `useLayoutEffect` safe for SSR |
+| `useIsMounted`             | `useIsMounted`                | Ref / flag after mount |
+| `useLocalStorage`          | `useLocalStorage`             | `UseLocalStorageResult` |
+| `useMediaQuery`            | `useMediaQuery`               | Match CSS media queries |
+| `useNetworkStatus`         | `useNetworkStatus`            | Online / offline |
+| `usePageVisibility`        | `usePageVisibility`           | Document visibility API |
+| `usePagination`            | `usePagination`               | `buildPaginationItems`, `BuildPaginationItemsParams`, `PaginationPageItem` |
+| `usePrefersColorScheme`    | `usePrefersColorScheme`       | `ColorSchemePreference` |
+| `usePrefersReducedMotion`  | `usePrefersReducedMotion`     | `prefers-reduced-motion` |
+| `useResizeObserver`        | `useResizeObserver`           | `ElementSize` |
+| `useSessionStorage`        | `useSessionStorage`           | `UseSessionStorageResult` |
+| `useThrottledCallback`     | `useThrottledCallback`        | Throttled callback ref |
+| `useToggle`                | `useToggle`                   | Boolean toggle state |
+| `useWindowSize`            | `useWindowSize`               | `WindowSize` |
+| `cn`, `clampPage`, `range` | `utils`                       | Shared helpers from `src/lib/utils.ts` |
+
+#### Hook import example
+
+```tsx
+import { useDisclosure } from "@zentauri-ui/zentauri-components/hooks/useDisclosure";
+import { useMediaQuery } from "@zentauri-ui/zentauri-components/hooks/useMediaQuery";
+import {
+  buildPaginationItems,
+  usePagination,
+} from "@zentauri-ui/zentauri-components/hooks/usePagination";
+import { cn } from "@zentauri-ui/zentauri-components/hooks/utils";
+```
+
+Some UI packages re-export the hook that belongs to that component (for example `usePagination` from `@zentauri-ui/zentauri-components/ui/pagination`). Prefer `hooks/<name>` when you only need the hook without the UI primitives.
+
 ## Installation
 
-**Getting started** — Add the package, install peer dependencies so primitives resolve correctly, point Tailwind at the library sources, then import from the UI barrel or from a specific `ui/<name>` subpath.
+**Getting started** — Add the package, install peer dependencies so primitives resolve correctly, point Tailwind at the library sources, then import from `ui/<name>` and/or `hooks/<entry>` subpaths.
 
 ### Step 1 — Install the package
 
@@ -135,11 +182,11 @@ Add an `@source` entry so Tailwind scans class names inside `@zentauri-ui/zentau
 @source "../node_modules/@zentauri-ui/zentauri-components";
 ```
 
-### Step 4 — Import and use components
+### Step 4 — Import and use components and hooks
 
-Prefer a **subpath** when you only need one area (smaller resolved graph than the full barrel). The barrel remains valid when you use many primitives from different areas.
+Use **one subpath per UI area** and **one subpath per hook module** so the bundler resolves only the entries you use.
 
-#### Imports (subpath — recommended for a single area)
+#### Imports (single UI area)
 
 ```tsx
 import {
@@ -150,7 +197,7 @@ import {
 } from "@zentauri-ui/zentauri-components/ui/accordion";
 ```
 
-#### Imports (multiple areas — one subpath import per area)
+#### Imports (multiple UI areas)
 
 ```tsx
 import { Button } from "@zentauri-ui/zentauri-components/ui/buttons";
@@ -163,17 +210,11 @@ import {
 } from "@zentauri-ui/zentauri-components/ui/select";
 ```
 
-#### Imports (barrel — one entry for symbols from several areas)
+#### Imports (hooks alongside UI)
 
 ```tsx
-import {
-  Button,
-  Select,
-  SelectTrigger,
-  SelectValue,
-  SelectContent,
-  SelectItem,
-} from "@zentauri-ui/zentauri-components/ui";
+import { useDisclosure } from "@zentauri-ui/zentauri-components/hooks/useDisclosure";
+import { Button } from "@zentauri-ui/zentauri-components/ui/buttons";
 ```
 
 #### Usage

package/dist/chunk-2VQJ6OIL.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useControllableState/useControllableState.ts
+function useControllableState({
+  value: valueProp,
+  defaultValue,
+  onChange
+}) {
+  const [uncontrolled, setUncontrolled] = react.useState(defaultValue);
+  const isControlled = valueProp !== void 0;
+  const value = isControlled ? valueProp : uncontrolled;
+  const onChangeRef = react.useRef(onChange);
+  onChangeRef.current = onChange;
+  const setValue = react.useCallback(
+    (next) => {
+      const resolved = typeof next === "function" ? next(value) : next;
+      if (!isControlled) {
+        setUncontrolled(resolved);
+      }
+      onChangeRef.current?.(resolved);
+    },
+    [isControlled, value]
+  );
+  return [value, setValue];
+}
+
+exports.useControllableState = useControllableState;
+//# sourceMappingURL=chunk-2VQJ6OIL.js.map
+//# sourceMappingURL=chunk-2VQJ6OIL.js.map

package/dist/chunk-2VQJ6OIL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useControllableState/useControllableState.ts"],"names":["useState","useRef","useCallback"],"mappings":";;;;;AAwBO,SAAS,oBAAA,CAAwB;AAAA,EACtC,KAAA,EAAO,SAAA;AAAA,EACP,YAAA;AAAA,EACA;AACF,CAAA,EAA6E;AAC3E,EAAA,MAAM,CAAC,YAAA,EAAc,eAAe,CAAA,GAAIA,eAAS,YAAY,CAAA;AAC7D,EAAA,MAAM,eAAe,SAAA,KAAc,MAAA;AACnC,EAAA,MAAM,KAAA,GAAQ,eAAe,SAAA,GAAY,YAAA;AACzC,EAAA,MAAM,WAAA,GAAcC,aAAO,QAAQ,CAAA;AACnC,EAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAEtB,EAAA,MAAM,QAAA,GAAWC,iBAAA;AAAA,IACf,CAAC,IAAA,KAA+B;AAC9B,MAAA,MAAM,WACJ,OAAO,IAAA,KAAS,UAAA,GAAc,IAAA,CAAwB,KAAK,CAAA,GAAI,IAAA;AACjE,MAAA,IAAI,CAAC,YAAA,EAAc;AACjB,QAAA,eAAA,CAAgB,QAAQ,CAAA;AAAA,MAC1B;AACA,MAAA,WAAA,CAAY,UAAU,QAAQ,CAAA;AAAA,IAChC,CAAA;AAAA,IACA,CAAC,cAAc,KAAK;AAAA,GACtB;AAEA,EAAA,OAAO,CAAC,OAAO,QAAQ,CAAA;AACzB","file":"chunk-2VQJ6OIL.js","sourcesContent":["\"use client\";\n\nimport { useCallback, useRef, useState } from \"react\";\n\nexport type UseControllableStateParams<T> = {\n  /** When defined, the hook is controlled and this value is returned as state. */\n  value?: T;\n  /** Initial / fallback value when uncontrolled (`value` is `undefined`). */\n  defaultValue: T;\n  /** Notified on every `setValue` with the resolved next value (controlled and uncontrolled). */\n  onChange?: (next: T) => void;\n};\n\n/**\n * Implements the React “controlled vs uncontrolled” pattern as a single state tuple.\n *\n * - If `value` is `undefined`, internal state mirrors `defaultValue` and updates on `setValue`.\n * - If `value` is defined, returned state follows `value`; `setValue` still calls `onChange` so the parent can update.\n * - `setValue` accepts either the next value or an updater `(prev) => next` (updater uses the current `value` in controlled mode).\n *\n * @typeParam T - State value type.\n * @param params - `value`, `defaultValue`, and optional `onChange`.\n * @returns `[value, setValue]` compatible with `useState`-style usage.\n */\nexport function useControllableState<T>({\n  value: valueProp,\n  defaultValue,\n  onChange,\n}: UseControllableStateParams<T>): [T, (next: T | ((prev: T) => T)) => void] {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue);\n  const isControlled = valueProp !== undefined;\n  const value = isControlled ? valueProp : uncontrolled;\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const setValue = useCallback(\n    (next: T | ((prev: T) => T)) => {\n      const resolved =\n        typeof next === \"function\" ? (next as (prev: T) => T)(value) : next;\n      if (!isControlled) {\n        setUncontrolled(resolved);\n      }\n      onChangeRef.current?.(resolved);\n    },\n    [isControlled, value],\n  );\n\n  return [value, setValue];\n}\n"]}

package/dist/chunk-73VCO5TE.mjs

@@ -0,0 +1,29 @@
+import { useState, useRef, useCallback } from 'react';
+
+// src/hooks/useControllableState/useControllableState.ts
+function useControllableState({
+  value: valueProp,
+  defaultValue,
+  onChange
+}) {
+  const [uncontrolled, setUncontrolled] = useState(defaultValue);
+  const isControlled = valueProp !== void 0;
+  const value = isControlled ? valueProp : uncontrolled;
+  const onChangeRef = useRef(onChange);
+  onChangeRef.current = onChange;
+  const setValue = useCallback(
+    (next) => {
+      const resolved = typeof next === "function" ? next(value) : next;
+      if (!isControlled) {
+        setUncontrolled(resolved);
+      }
+      onChangeRef.current?.(resolved);
+    },
+    [isControlled, value]
+  );
+  return [value, setValue];
+}
+
+export { useControllableState };
+//# sourceMappingURL=chunk-73VCO5TE.mjs.map
+//# sourceMappingURL=chunk-73VCO5TE.mjs.map

package/dist/chunk-73VCO5TE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useControllableState/useControllableState.ts"],"names":[],"mappings":";;;AAwBO,SAAS,oBAAA,CAAwB;AAAA,EACtC,KAAA,EAAO,SAAA;AAAA,EACP,YAAA;AAAA,EACA;AACF,CAAA,EAA6E;AAC3E,EAAA,MAAM,CAAC,YAAA,EAAc,eAAe,CAAA,GAAI,SAAS,YAAY,CAAA;AAC7D,EAAA,MAAM,eAAe,SAAA,KAAc,MAAA;AACnC,EAAA,MAAM,KAAA,GAAQ,eAAe,SAAA,GAAY,YAAA;AACzC,EAAA,MAAM,WAAA,GAAc,OAAO,QAAQ,CAAA;AACnC,EAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAEtB,EAAA,MAAM,QAAA,GAAW,WAAA;AAAA,IACf,CAAC,IAAA,KAA+B;AAC9B,MAAA,MAAM,WACJ,OAAO,IAAA,KAAS,UAAA,GAAc,IAAA,CAAwB,KAAK,CAAA,GAAI,IAAA;AACjE,MAAA,IAAI,CAAC,YAAA,EAAc;AACjB,QAAA,eAAA,CAAgB,QAAQ,CAAA;AAAA,MAC1B;AACA,MAAA,WAAA,CAAY,UAAU,QAAQ,CAAA;AAAA,IAChC,CAAA;AAAA,IACA,CAAC,cAAc,KAAK;AAAA,GACtB;AAEA,EAAA,OAAO,CAAC,OAAO,QAAQ,CAAA;AACzB","file":"chunk-73VCO5TE.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useRef, useState } from \"react\";\n\nexport type UseControllableStateParams<T> = {\n  /** When defined, the hook is controlled and this value is returned as state. */\n  value?: T;\n  /** Initial / fallback value when uncontrolled (`value` is `undefined`). */\n  defaultValue: T;\n  /** Notified on every `setValue` with the resolved next value (controlled and uncontrolled). */\n  onChange?: (next: T) => void;\n};\n\n/**\n * Implements the React “controlled vs uncontrolled” pattern as a single state tuple.\n *\n * - If `value` is `undefined`, internal state mirrors `defaultValue` and updates on `setValue`.\n * - If `value` is defined, returned state follows `value`; `setValue` still calls `onChange` so the parent can update.\n * - `setValue` accepts either the next value or an updater `(prev) => next` (updater uses the current `value` in controlled mode).\n *\n * @typeParam T - State value type.\n * @param params - `value`, `defaultValue`, and optional `onChange`.\n * @returns `[value, setValue]` compatible with `useState`-style usage.\n */\nexport function useControllableState<T>({\n  value: valueProp,\n  defaultValue,\n  onChange,\n}: UseControllableStateParams<T>): [T, (next: T | ((prev: T) => T)) => void] {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue);\n  const isControlled = valueProp !== undefined;\n  const value = isControlled ? valueProp : uncontrolled;\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const setValue = useCallback(\n    (next: T | ((prev: T) => T)) => {\n      const resolved =\n        typeof next === \"function\" ? (next as (prev: T) => T)(value) : next;\n      if (!isControlled) {\n        setUncontrolled(resolved);\n      }\n      onChangeRef.current?.(resolved);\n    },\n    [isControlled, value],\n  );\n\n  return [value, setValue];\n}\n"]}

package/dist/chunk-BSWYZTYK.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useClickOutside/useClickOutside.ts
+var useClickOutside = ({
+  setOpen,
+  ref,
+  listenEvents
+}) => {
+  react.useEffect(() => {
+    const events = listenEvents && listenEvents.length > 0 ? listenEvents : ["mousedown"];
+    const handleClickOutside = (event) => {
+      if (ref.current && !ref.current.contains(event.target)) {
+        setOpen(false);
+      }
+    };
+    for (const eventName of events) {
+      document.addEventListener(eventName, handleClickOutside);
+    }
+    return () => {
+      for (const eventName of events) {
+        document.removeEventListener(eventName, handleClickOutside);
+      }
+    };
+  }, [listenEvents, ref, setOpen]);
+};
+
+exports.useClickOutside = useClickOutside;
+//# sourceMappingURL=chunk-BSWYZTYK.js.map
+//# sourceMappingURL=chunk-BSWYZTYK.js.map

package/dist/chunk-BSWYZTYK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useClickOutside/useClickOutside.ts"],"names":["useEffect"],"mappings":";;;;;AA4BO,IAAM,kBAAkB,CAAC;AAAA,EAC9B,OAAA;AAAA,EACA,GAAA;AAAA,EACA;AACF,CAAA,KAA6B;AAC3B,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,SACJ,YAAA,IAAgB,YAAA,CAAa,SAAS,CAAA,GAAI,YAAA,GAAe,CAAC,WAAW,CAAA;AACvE,IAAA,MAAM,kBAAA,GAAqB,CAAC,KAAA,KAAiB;AAC3C,MAAA,IAAI,GAAA,CAAI,WAAW,CAAC,GAAA,CAAI,QAAQ,QAAA,CAAS,KAAA,CAAM,MAAc,CAAA,EAAG;AAC9D,QAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,MACf;AAAA,IACF,CAAA;AAEA,IAAA,KAAA,MAAW,aAAa,MAAA,EAAQ;AAC9B,MAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,kBAAkB,CAAA;AAAA,IACzD;AACA,IAAA,OAAO,MAAM;AACX,MAAA,KAAA,MAAW,aAAa,MAAA,EAAQ;AAC9B,QAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,kBAAkB,CAAA;AAAA,MAC5D;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,YAAA,EAAc,GAAA,EAAK,OAAO,CAAC,CAAA;AACjC","file":"chunk-BSWYZTYK.js","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { Dispatch, SetStateAction, useEffect } from \"react\";\n\n/** DOM events that can represent an “outside” press for closing overlays. */\nexport type ClickOutsideEventType =\n  | \"mousedown\"\n  | \"pointerdown\"\n  | \"touchstart\";\n\nexport type UseClickOutsideParams = {\n  /** Called with `false` when a qualifying event target is outside `ref.current`. */\n  setOpen: (open: boolean) => void | Dispatch<SetStateAction<boolean>>;\n  /** Root element of the floating UI; clicks inside this node do not close. */\n  ref: RefObject<HTMLElement | null>;\n  /** Defaults to `[\"mousedown\"]` for backward compatibility */\n  listenEvents?: ClickOutsideEventType[];\n};\n\n/**\n * Registers document-level listeners so that when the user activates outside of `ref`, `setOpen(false)`\n * runs. Useful for dropdowns, popovers, and menus paired with `open` state.\n *\n * @param params.setOpen - State setter or callback that closes the surface.\n * @param params.ref - Container ref; outside is determined with `contains()` on the event target.\n * @param params.listenEvents - Which events to listen for; default is `mousedown` only.\n */\nexport const useClickOutside = ({\n  setOpen,\n  ref,\n  listenEvents,\n}: UseClickOutsideParams) => {\n  useEffect(() => {\n    const events =\n      listenEvents && listenEvents.length > 0 ? listenEvents : [\"mousedown\"];\n    const handleClickOutside = (event: Event) => {\n      if (ref.current && !ref.current.contains(event.target as Node)) {\n        setOpen(false);\n      }\n    };\n\n    for (const eventName of events) {\n      document.addEventListener(eventName, handleClickOutside);\n    }\n    return () => {\n      for (const eventName of events) {\n        document.removeEventListener(eventName, handleClickOutside);\n      }\n    };\n  }, [listenEvents, ref, setOpen]);\n};\n"]}

package/dist/chunk-CY5BQKRZ.mjs

@@ -0,0 +1,29 @@
+import { useEffect } from 'react';
+
+// src/hooks/useClickOutside/useClickOutside.ts
+var useClickOutside = ({
+  setOpen,
+  ref,
+  listenEvents
+}) => {
+  useEffect(() => {
+    const events = listenEvents && listenEvents.length > 0 ? listenEvents : ["mousedown"];
+    const handleClickOutside = (event) => {
+      if (ref.current && !ref.current.contains(event.target)) {
+        setOpen(false);
+      }
+    };
+    for (const eventName of events) {
+      document.addEventListener(eventName, handleClickOutside);
+    }
+    return () => {
+      for (const eventName of events) {
+        document.removeEventListener(eventName, handleClickOutside);
+      }
+    };
+  }, [listenEvents, ref, setOpen]);
+};
+
+export { useClickOutside };
+//# sourceMappingURL=chunk-CY5BQKRZ.mjs.map
+//# sourceMappingURL=chunk-CY5BQKRZ.mjs.map

package/dist/chunk-CY5BQKRZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useClickOutside/useClickOutside.ts"],"names":[],"mappings":";;;AA4BO,IAAM,kBAAkB,CAAC;AAAA,EAC9B,OAAA;AAAA,EACA,GAAA;AAAA,EACA;AACF,CAAA,KAA6B;AAC3B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,SACJ,YAAA,IAAgB,YAAA,CAAa,SAAS,CAAA,GAAI,YAAA,GAAe,CAAC,WAAW,CAAA;AACvE,IAAA,MAAM,kBAAA,GAAqB,CAAC,KAAA,KAAiB;AAC3C,MAAA,IAAI,GAAA,CAAI,WAAW,CAAC,GAAA,CAAI,QAAQ,QAAA,CAAS,KAAA,CAAM,MAAc,CAAA,EAAG;AAC9D,QAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,MACf;AAAA,IACF,CAAA;AAEA,IAAA,KAAA,MAAW,aAAa,MAAA,EAAQ;AAC9B,MAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,kBAAkB,CAAA;AAAA,IACzD;AACA,IAAA,OAAO,MAAM;AACX,MAAA,KAAA,MAAW,aAAa,MAAA,EAAQ;AAC9B,QAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,kBAAkB,CAAA;AAAA,MAC5D;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,YAAA,EAAc,GAAA,EAAK,OAAO,CAAC,CAAA;AACjC","file":"chunk-CY5BQKRZ.mjs","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { Dispatch, SetStateAction, useEffect } from \"react\";\n\n/** DOM events that can represent an “outside” press for closing overlays. */\nexport type ClickOutsideEventType =\n  | \"mousedown\"\n  | \"pointerdown\"\n  | \"touchstart\";\n\nexport type UseClickOutsideParams = {\n  /** Called with `false` when a qualifying event target is outside `ref.current`. */\n  setOpen: (open: boolean) => void | Dispatch<SetStateAction<boolean>>;\n  /** Root element of the floating UI; clicks inside this node do not close. */\n  ref: RefObject<HTMLElement | null>;\n  /** Defaults to `[\"mousedown\"]` for backward compatibility */\n  listenEvents?: ClickOutsideEventType[];\n};\n\n/**\n * Registers document-level listeners so that when the user activates outside of `ref`, `setOpen(false)`\n * runs. Useful for dropdowns, popovers, and menus paired with `open` state.\n *\n * @param params.setOpen - State setter or callback that closes the surface.\n * @param params.ref - Container ref; outside is determined with `contains()` on the event target.\n * @param params.listenEvents - Which events to listen for; default is `mousedown` only.\n */\nexport const useClickOutside = ({\n  setOpen,\n  ref,\n  listenEvents,\n}: UseClickOutsideParams) => {\n  useEffect(() => {\n    const events =\n      listenEvents && listenEvents.length > 0 ? listenEvents : [\"mousedown\"];\n    const handleClickOutside = (event: Event) => {\n      if (ref.current && !ref.current.contains(event.target as Node)) {\n        setOpen(false);\n      }\n    };\n\n    for (const eventName of events) {\n      document.addEventListener(eventName, handleClickOutside);\n    }\n    return () => {\n      for (const eventName of events) {\n        document.removeEventListener(eventName, handleClickOutside);\n      }\n    };\n  }, [listenEvents, ref, setOpen]);\n};\n"]}

package/dist/chunk-DFEZH7TC.mjs

@@ -0,0 +1,27 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+// src/lib/utils.ts
+function cn(...inputs) {
+  return twMerge(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));
+};
+
+export { clamp, clampPage, cn, range };
+//# sourceMappingURL=chunk-DFEZH7TC.mjs.map
+//# sourceMappingURL=chunk-DFEZH7TC.mjs.map

package/dist/chunk-DFEZH7TC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/utils.ts"],"names":[],"mappings":";;;;AAGO,SAAS,MAAM,MAAA,EAAsB;AAC1C,EAAA,OAAO,OAAA,CAAQ,IAAA,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-DFEZH7TC.mjs","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-FT2LMA66.mjs

@@ -0,0 +1,25 @@
+import { useState, useEffect } from 'react';
+
+// src/hooks/useMediaQuery/useMediaQuery.ts
+function useMediaQuery(query, defaultValue = false) {
+  const [matches, setMatches] = useState(defaultValue);
+  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;
+}
+
+export { useMediaQuery };
+//# sourceMappingURL=chunk-FT2LMA66.mjs.map
+//# sourceMappingURL=chunk-FT2LMA66.mjs.map

package/dist/chunk-FT2LMA66.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useMediaQuery/useMediaQuery.ts"],"names":[],"mappings":";;;AAcO,SAAS,aAAA,CACd,KAAA,EACA,YAAA,GAAe,KAAA,EACN;AACT,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAS,YAAY,CAAA;AAEnD,EAAA,SAAA,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-FT2LMA66.mjs","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-JE3PD5ZA.js

@@ -0,0 +1,107 @@
+'use strict';
+
+var chunkUOZYPWDZ_js = require('./chunk-UOZYPWDZ.js');
+var react = require('react');
+
+function usePagination({
+  pageCount,
+  page,
+  defaultPage = 1,
+  siblingCount = 1,
+  boundaryCount = 1,
+  onPageChange
+}) {
+  const [internalPage, setInternalPage] = react.useState(
+    () => chunkUOZYPWDZ_js.clampPage(defaultPage, pageCount)
+  );
+  const isControlled = page !== void 0;
+  const currentPage = chunkUOZYPWDZ_js.clampPage(isControlled ? page : internalPage, pageCount);
+  const setPage = react.useCallback(
+    (next) => {
+      const clamped = chunkUOZYPWDZ_js.clampPage(next, pageCount);
+      if (!isControlled) {
+        setInternalPage(clamped);
+      }
+      onPageChange?.(clamped);
+    },
+    [isControlled, onPageChange, pageCount]
+  );
+  const items = react.useMemo(
+    () => buildPaginationItems({
+      pageCount,
+      currentPage,
+      siblingCount,
+      boundaryCount
+    }),
+    [boundaryCount, currentPage, pageCount, siblingCount]
+  );
+  const canGoPrev = pageCount > 0 && currentPage > 1;
+  const canGoNext = pageCount > 0 && currentPage < pageCount;
+  const goPrev = react.useCallback(() => {
+    if (canGoPrev) {
+      setPage(currentPage - 1);
+    }
+  }, [canGoPrev, currentPage, setPage]);
+  const goNext = react.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 = chunkUOZYPWDZ_js.clampPage(currentPage, pageCount);
+  const totalNumbers = safeBoundary * 2 + safeSibling * 2 + 1;
+  if (pageCount <= totalNumbers) {
+    return chunkUOZYPWDZ_js.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;
+}
+
+exports.buildPaginationItems = buildPaginationItems;
+exports.usePagination = usePagination;
+//# sourceMappingURL=chunk-JE3PD5ZA.js.map
+//# sourceMappingURL=chunk-JE3PD5ZA.js.map

package/dist/chunk-JE3PD5ZA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/usePagination/usePagination.ts"],"names":["useState","clampPage","useCallback","useMemo","range"],"mappings":"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","file":"chunk-JE3PD5ZA.js","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-JXCTEAXD.js

@@ -0,0 +1,38 @@
+'use strict';
+
+var react = require('react');
+
+// src/hooks/useIntersectionObserver/useIntersectionObserver.ts
+function useIntersectionObserver(params = {}) {
+  const { enabled = true, root, rootMargin, threshold } = params;
+  const [element, setElement] = react.useState(null);
+  const [entry, setEntry] = react.useState(
+    void 0
+  );
+  const setRef = react.useCallback((node) => {
+    setElement(node);
+  }, []);
+  react.useEffect(() => {
+    if (!enabled || element == null) {
+      return;
+    }
+    if (typeof IntersectionObserver === "undefined") {
+      return;
+    }
+    const observer = new IntersectionObserver(
+      (records) => {
+        setEntry(records[0]);
+      },
+      { root, rootMargin, threshold }
+    );
+    observer.observe(element);
+    return () => {
+      observer.disconnect();
+    };
+  }, [element, enabled, root, rootMargin, threshold]);
+  return [setRef, entry];
+}
+
+exports.useIntersectionObserver = useIntersectionObserver;
+//# sourceMappingURL=chunk-JXCTEAXD.js.map
+//# sourceMappingURL=chunk-JXCTEAXD.js.map

package/dist/chunk-JXCTEAXD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useIntersectionObserver/useIntersectionObserver.ts"],"names":["useState","useCallback","useEffect"],"mappings":";;;;;AAoBO,SAAS,uBAAA,CACd,MAAA,GAAwC,EAAC,EACgB;AACzD,EAAA,MAAM,EAAE,OAAA,GAAU,IAAA,EAAM,IAAA,EAAM,UAAA,EAAY,WAAU,GAAI,MAAA;AACxD,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAAmB,IAAI,CAAA;AACrD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,cAAA;AAAA,IACxB;AAAA,GACF;AAEA,EAAA,MAAM,MAAA,GAASC,iBAAA,CAAY,CAAC,IAAA,KAAmB;AAC7C,IAAA,UAAA,CAAW,IAAI,CAAA;AAAA,EACjB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,IAAW,OAAA,IAAW,IAAA,EAAM;AAC/B,MAAA;AAAA,IACF;AACA,IAAA,IAAI,OAAO,yBAAyB,WAAA,EAAa;AAC/C,MAAA;AAAA,IACF;AACA,IAAA,MAAM,WAAW,IAAI,oBAAA;AAAA,MACnB,CAAC,OAAA,KAAY;AACX,QAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,CAAC,CAAA;AAAA,MACrB,CAAA;AAAA,MACA,EAAE,IAAA,EAAM,UAAA,EAAY,SAAA;AAAU,KAChC;AACA,IAAA,QAAA,CAAS,QAAQ,OAAO,CAAA;AACxB,IAAA,OAAO,MAAM;AACX,MAAA,QAAA,CAAS,UAAA,EAAW;AAAA,IACtB,CAAA;AAAA,EACF,GAAG,CAAC,OAAA,EAAS,SAAS,IAAA,EAAM,UAAA,EAAY,SAAS,CAAC,CAAA;AAElD,EAAA,OAAO,CAAC,QAAQ,KAAK,CAAA;AACvB","file":"chunk-JXCTEAXD.js","sourcesContent":["\"use client\";\n\nimport type { RefCallback } from \"react\";\nimport { useCallback, useEffect, useState } from \"react\";\n\nexport type UseIntersectionObserverParams = IntersectionObserverInit & {\n  /** When `false`, disconnects the observer until re-enabled (saves work for hidden or inactive content). */\n  enabled?: boolean;\n};\n\n/**\n * Observes a single element with the browser `IntersectionObserver` API and exposes the latest entry.\n *\n * Returns a callback ref: assign it to the element to measure. When `enabled` is false or `IntersectionObserver`\n * is undefined (unsupported environment), the effect is a no-op and `entry` may stay `undefined`.\n *\n * @typeParam T - Observed element type.\n * @param params - Standard `IntersectionObserverInit` fields plus optional `enabled` (default `true`).\n * @returns `[setRef, entry]` where `entry` is the most recent callback record for the observed target.\n */\nexport function useIntersectionObserver<T extends Element>(\n  params: UseIntersectionObserverParams = {},\n): [RefCallback<T>, IntersectionObserverEntry | undefined] {\n  const { enabled = true, root, rootMargin, threshold } = params;\n  const [element, setElement] = useState<T | null>(null);\n  const [entry, setEntry] = useState<IntersectionObserverEntry | undefined>(\n    undefined,\n  );\n\n  const setRef = useCallback((node: T | null) => {\n    setElement(node);\n  }, []);\n\n  useEffect(() => {\n    if (!enabled || element == null) {\n      return;\n    }\n    if (typeof IntersectionObserver === \"undefined\") {\n      return;\n    }\n    const observer = new IntersectionObserver(\n      (records) => {\n        setEntry(records[0]);\n      },\n      { root, rootMargin, threshold },\n    );\n    observer.observe(element);\n    return () => {\n      observer.disconnect();\n    };\n  }, [element, enabled, root, rootMargin, threshold]);\n\n  return [setRef, entry];\n}\n"]}

package/dist/chunk-LIJ6BDGP.mjs

@@ -0,0 +1,36 @@
+import { useState, useCallback, useEffect } from 'react';
+
+// src/hooks/useIntersectionObserver/useIntersectionObserver.ts
+function useIntersectionObserver(params = {}) {
+  const { enabled = true, root, rootMargin, threshold } = params;
+  const [element, setElement] = useState(null);
+  const [entry, setEntry] = useState(
+    void 0
+  );
+  const setRef = useCallback((node) => {
+    setElement(node);
+  }, []);
+  useEffect(() => {
+    if (!enabled || element == null) {
+      return;
+    }
+    if (typeof IntersectionObserver === "undefined") {
+      return;
+    }
+    const observer = new IntersectionObserver(
+      (records) => {
+        setEntry(records[0]);
+      },
+      { root, rootMargin, threshold }
+    );
+    observer.observe(element);
+    return () => {
+      observer.disconnect();
+    };
+  }, [element, enabled, root, rootMargin, threshold]);
+  return [setRef, entry];
+}
+
+export { useIntersectionObserver };
+//# sourceMappingURL=chunk-LIJ6BDGP.mjs.map
+//# sourceMappingURL=chunk-LIJ6BDGP.mjs.map

package/dist/chunk-LIJ6BDGP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useIntersectionObserver/useIntersectionObserver.ts"],"names":[],"mappings":";;;AAoBO,SAAS,uBAAA,CACd,MAAA,GAAwC,EAAC,EACgB;AACzD,EAAA,MAAM,EAAE,OAAA,GAAU,IAAA,EAAM,IAAA,EAAM,UAAA,EAAY,WAAU,GAAI,MAAA;AACxD,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAmB,IAAI,CAAA;AACrD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA;AAAA,IACxB;AAAA,GACF;AAEA,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,CAAC,IAAA,KAAmB;AAC7C,IAAA,UAAA,CAAW,IAAI,CAAA;AAAA,EACjB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,IAAW,OAAA,IAAW,IAAA,EAAM;AAC/B,MAAA;AAAA,IACF;AACA,IAAA,IAAI,OAAO,yBAAyB,WAAA,EAAa;AAC/C,MAAA;AAAA,IACF;AACA,IAAA,MAAM,WAAW,IAAI,oBAAA;AAAA,MACnB,CAAC,OAAA,KAAY;AACX,QAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,CAAC,CAAA;AAAA,MACrB,CAAA;AAAA,MACA,EAAE,IAAA,EAAM,UAAA,EAAY,SAAA;AAAU,KAChC;AACA,IAAA,QAAA,CAAS,QAAQ,OAAO,CAAA;AACxB,IAAA,OAAO,MAAM;AACX,MAAA,QAAA,CAAS,UAAA,EAAW;AAAA,IACtB,CAAA;AAAA,EACF,GAAG,CAAC,OAAA,EAAS,SAAS,IAAA,EAAM,UAAA,EAAY,SAAS,CAAC,CAAA;AAElD,EAAA,OAAO,CAAC,QAAQ,KAAK,CAAA;AACvB","file":"chunk-LIJ6BDGP.mjs","sourcesContent":["\"use client\";\n\nimport type { RefCallback } from \"react\";\nimport { useCallback, useEffect, useState } from \"react\";\n\nexport type UseIntersectionObserverParams = IntersectionObserverInit & {\n  /** When `false`, disconnects the observer until re-enabled (saves work for hidden or inactive content). */\n  enabled?: boolean;\n};\n\n/**\n * Observes a single element with the browser `IntersectionObserver` API and exposes the latest entry.\n *\n * Returns a callback ref: assign it to the element to measure. When `enabled` is false or `IntersectionObserver`\n * is undefined (unsupported environment), the effect is a no-op and `entry` may stay `undefined`.\n *\n * @typeParam T - Observed element type.\n * @param params - Standard `IntersectionObserverInit` fields plus optional `enabled` (default `true`).\n * @returns `[setRef, entry]` where `entry` is the most recent callback record for the observed target.\n */\nexport function useIntersectionObserver<T extends Element>(\n  params: UseIntersectionObserverParams = {},\n): [RefCallback<T>, IntersectionObserverEntry | undefined] {\n  const { enabled = true, root, rootMargin, threshold } = params;\n  const [element, setElement] = useState<T | null>(null);\n  const [entry, setEntry] = useState<IntersectionObserverEntry | undefined>(\n    undefined,\n  );\n\n  const setRef = useCallback((node: T | null) => {\n    setElement(node);\n  }, []);\n\n  useEffect(() => {\n    if (!enabled || element == null) {\n      return;\n    }\n    if (typeof IntersectionObserver === \"undefined\") {\n      return;\n    }\n    const observer = new IntersectionObserver(\n      (records) => {\n        setEntry(records[0]);\n      },\n      { root, rootMargin, threshold },\n    );\n    observer.observe(element);\n    return () => {\n      observer.disconnect();\n    };\n  }, [element, enabled, root, rootMargin, threshold]);\n\n  return [setRef, entry];\n}\n"]}