@zentauri-ui/zentauri-components 1.9.2 → 2.0.0

package/dist/hooks/useLongPress.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useLongPress/useLongPress.ts"],"names":[],"mappings":"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","file":"useLongPress.mjs","sourcesContent":["\"use client\";\n\nimport type {\n  MouseEvent as ReactMouseEvent,\n  PointerEvent as ReactPointerEvent,\n} from \"react\";\nimport { useCallback, useEffect, useRef } from \"react\";\n\nexport type UseLongPressOptions = {\n  /** Hold duration in milliseconds before the press counts as \"long\" (default `500`). */\n  thresholdMs?: number;\n  /** Pointer travel in pixels that cancels the press (default `10`). */\n  moveTolerancePx?: number;\n  /** Called when the pointer goes down (press attempt starts). */\n  onStart?: (event: ReactPointerEvent) => void;\n  /** Called on release after a long press fired. */\n  onFinish?: (event: ReactPointerEvent) => void;\n  /** Called when the press is released or cancelled before the threshold. */\n  onCancel?: (event: ReactPointerEvent) => void;\n};\n\nexport type UseLongPressHandlers = {\n  onPointerDown: (event: ReactPointerEvent) => void;\n  onPointerMove: (event: ReactPointerEvent) => void;\n  onPointerUp: (event: ReactPointerEvent) => void;\n  onPointerLeave: (event: ReactPointerEvent) => void;\n  /** Handles browser-level pointer cancellation (e.g. system interruption, scroll takeover). */\n  onPointerCancel: (event: ReactPointerEvent) => void;\n  /**\n   * Suppresses the synthetic `click` event that fires after a successful long press.\n   * Spread alongside the other handlers to prevent unintended navigation or button actions.\n   */\n  onClick: (event: ReactMouseEvent) => void;\n};\n\n/**\n * Long-press gesture detection built on pointer events, so it works for mouse, touch, and pen.\n *\n * Spread the returned handlers onto the target element. After the pointer is held\n * `thresholdMs` without travelling more than `moveTolerancePx`, `callback` fires once;\n * releasing afterwards calls `onFinish`, while early release / movement / leaving the\n * element calls `onCancel`.\n *\n * Only the primary button (button 0 / left click / first touch contact) starts a long press;\n * right and middle mouse buttons are ignored.\n *\n * Pair with `touch-action` / `select-none` CSS on touch targets to suppress native\n * scrolling or text selection during the hold where needed.\n *\n * @param callback - Invoked once when the press crosses the threshold.\n * @param options - {@link UseLongPressOptions}\n * @returns Spreadable pointer handlers ({@link UseLongPressHandlers}).\n */\nexport function useLongPress(\n  callback: (event: ReactPointerEvent) => void,\n  options: UseLongPressOptions = {},\n): UseLongPressHandlers {\n  const {\n    thresholdMs = 500,\n    moveTolerancePx = 10,\n    onStart,\n    onFinish,\n    onCancel,\n  } = options;\n\n  const callbackRef = useRef(callback);\n  const onStartRef = useRef(onStart);\n  const onFinishRef = useRef(onFinish);\n  const onCancelRef = useRef(onCancel);\n\n  useEffect(() => {\n    callbackRef.current = callback;\n    onStartRef.current = onStart;\n    onFinishRef.current = onFinish;\n    onCancelRef.current = onCancel;\n  }, [callback, onCancel, onFinish, onStart]);\n\n  const timeoutRef = useRef<number | undefined>(undefined);\n  const triggeredRef = useRef(false);\n  const pressingRef = useRef(false);\n  const originRef = useRef({ x: 0, y: 0 });\n\n  const stopTimer = useCallback(() => {\n    if (timeoutRef.current !== undefined) {\n      window.clearTimeout(timeoutRef.current);\n      timeoutRef.current = undefined;\n    }\n  }, []);\n\n  useEffect(() => stopTimer, [stopTimer]);\n\n  const cancel = useCallback(\n    (event: ReactPointerEvent) => {\n      if (!pressingRef.current) {\n        return;\n      }\n      pressingRef.current = false;\n      stopTimer();\n      if (!triggeredRef.current) {\n        onCancelRef.current?.(event);\n      }\n    },\n    [stopTimer],\n  );\n\n  const onPointerDown = useCallback(\n    (event: ReactPointerEvent) => {\n      // Only respond to the primary button (left click / first touch contact).\n      // event.button > 0 catches right (2) and middle (1) mouse buttons.\n      if (event.button > 0) {\n        return;\n      }\n      pressingRef.current = true;\n      triggeredRef.current = false;\n      originRef.current = { x: event.clientX, y: event.clientY };\n      onStartRef.current?.(event);\n      stopTimer();\n      timeoutRef.current = window.setTimeout(() => {\n        timeoutRef.current = undefined;\n        if (pressingRef.current) {\n          triggeredRef.current = true;\n          callbackRef.current(event);\n        }\n      }, thresholdMs);\n    },\n    [stopTimer, thresholdMs],\n  );\n\n  const onPointerMove = useCallback(\n    (event: ReactPointerEvent) => {\n      if (!pressingRef.current || triggeredRef.current) {\n        return;\n      }\n      const dx = event.clientX - originRef.current.x;\n      const dy = event.clientY - originRef.current.y;\n      if (Math.hypot(dx, dy) > moveTolerancePx) {\n        cancel(event);\n      }\n    },\n    [cancel, moveTolerancePx],\n  );\n\n  const onPointerUp = useCallback(\n    (event: ReactPointerEvent) => {\n      if (!pressingRef.current) {\n        return;\n      }\n      const triggered = triggeredRef.current;\n      pressingRef.current = false;\n      stopTimer();\n      if (triggered) {\n        onFinishRef.current?.(event);\n      } else {\n        onCancelRef.current?.(event);\n      }\n    },\n    [stopTimer],\n  );\n\n  // After a successful long press the browser fires a synthetic `click` event on pointer up.\n  // This handler suppresses it so navigation and button actions aren't triggered unexpectedly.\n  const onClick = useCallback((event: ReactMouseEvent) => {\n    if (triggeredRef.current) {\n      event.preventDefault();\n      triggeredRef.current = false;\n    }\n  }, []);\n\n  return {\n    onPointerDown,\n    onPointerMove,\n    onPointerUp,\n    onPointerLeave: cancel,\n    onPointerCancel: cancel,\n    onClick,\n  };\n}\n"]}

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

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

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

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

package/dist/hooks/usePrevious/usePrevious.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns the value passed in on the previous render (`undefined` on first render).
+ *
+ * The ref is updated in an effect after each committed render, so during a render
+ * you always see the value from the previous one — handy for diffing props/state,
+ * animation direction, or "changed since last render" checks.
+ *
+ * @typeParam T - Tracked value type.
+ * @param value - The current value to track.
+ * @returns The value from the previous render, or `undefined` before the first update.
+ */
+export declare function usePrevious<T>(value: T): T | undefined;
+//# sourceMappingURL=usePrevious.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePrevious.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePrevious/usePrevious.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAQtD"}

package/dist/hooks/usePrevious.js

@@ -0,0 +1,17 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function usePrevious(value) {
+  const previousRef = react.useRef(void 0);
+  react.useEffect(() => {
+    previousRef.current = value;
+  }, [value]);
+  return previousRef.current;
+}
+
+exports.usePrevious = usePrevious;
+//# sourceMappingURL=usePrevious.js.map
+//# sourceMappingURL=usePrevious.js.map

package/dist/hooks/usePrevious.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/usePrevious/usePrevious.ts"],"names":["useRef","useEffect"],"mappings":";;;;;AAeO,SAAS,YAAe,KAAA,EAAyB;AACtD,EAAA,MAAM,WAAA,GAAcA,aAAsB,MAAS,CAAA;AAEnD,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,WAAA,CAAY,OAAA,GAAU,KAAA;AAAA,EACxB,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB","file":"usePrevious.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\n/**\n * Returns the value passed in on the previous render (`undefined` on first render).\n *\n * The ref is updated in an effect after each committed render, so during a render\n * you always see the value from the previous one — handy for diffing props/state,\n * animation direction, or \"changed since last render\" checks.\n *\n * @typeParam T - Tracked value type.\n * @param value - The current value to track.\n * @returns The value from the previous render, or `undefined` before the first update.\n */\nexport function usePrevious<T>(value: T): T | undefined {\n  const previousRef = useRef<T | undefined>(undefined);\n\n  useEffect(() => {\n    previousRef.current = value;\n  }, [value]);\n\n  return previousRef.current;\n}\n"]}

package/dist/hooks/usePrevious.mjs

@@ -0,0 +1,15 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useRef, useEffect } from 'react';
+
+function usePrevious(value) {
+  const previousRef = useRef(void 0);
+  useEffect(() => {
+    previousRef.current = value;
+  }, [value]);
+  return previousRef.current;
+}
+
+export { usePrevious };
+//# sourceMappingURL=usePrevious.mjs.map
+//# sourceMappingURL=usePrevious.mjs.map

package/dist/hooks/usePrevious.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/usePrevious/usePrevious.ts"],"names":[],"mappings":";;;AAeO,SAAS,YAAe,KAAA,EAAyB;AACtD,EAAA,MAAM,WAAA,GAAc,OAAsB,MAAS,CAAA;AAEnD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,WAAA,CAAY,OAAA,GAAU,KAAA;AAAA,EACxB,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,WAAA,CAAY,OAAA;AACrB","file":"usePrevious.mjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\n/**\n * Returns the value passed in on the previous render (`undefined` on first render).\n *\n * The ref is updated in an effect after each committed render, so during a render\n * you always see the value from the previous one — handy for diffing props/state,\n * animation direction, or \"changed since last render\" checks.\n *\n * @typeParam T - Tracked value type.\n * @param value - The current value to track.\n * @returns The value from the previous render, or `undefined` before the first update.\n */\nexport function usePrevious<T>(value: T): T | undefined {\n  const previousRef = useRef<T | undefined>(undefined);\n\n  useEffect(() => {\n    previousRef.current = value;\n  }, [value]);\n\n  return previousRef.current;\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScrollPosition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC"}

package/dist/hooks/useScrollPosition/useScrollPosition.d.ts

@@ -0,0 +1,37 @@
+import type { RefCallback, RefObject } from "react";
+export type ScrollPosition = {
+    x: number;
+    y: number;
+};
+export type UseScrollPositionParams<T extends HTMLElement = HTMLElement> = {
+    /**
+     * Scroll container to observe via a pre-populated RefObject.
+     * For elements that mount asynchronously, use the returned `setRef` callback ref instead.
+     */
+    target?: RefObject<T | null>;
+};
+export type UseScrollPositionResult<T extends HTMLElement = HTMLElement> = ScrollPosition & {
+    /**
+     * Callback ref to attach to a scroll container — works correctly with elements
+     * that are null on initial render (lazy / conditional mounts). Pass this as `ref`
+     * on the scrollable element when you cannot guarantee the ref is populated at mount.
+     */
+    setRef: RefCallback<T>;
+};
+/**
+ * Tracks the scroll offset of the window (default) or a scrollable element.
+ *
+ * - Window mode reads `scrollX` / `scrollY`; element mode reads `scrollLeft` / `scrollTop`.
+ * - Subscribes with a passive `scroll` listener and reads the initial position on mount.
+ * - Pass a pre-populated `target` RefObject **or** use the returned `setRef` callback ref on
+ *   the scrollable element. Prefer `setRef` for elements that may be null on the first render
+ *   (conditional mounts, portals) — it stores the element in state so the effect re-attaches
+ *   correctly when the element becomes available.
+ * - For high-frequency consumers, derive throttled values downstream (e.g. with
+ *   `useThrottledCallback`) rather than throttling the source of truth.
+ *
+ * @param params - {@link UseScrollPositionParams}
+ * @returns Latest `{ x, y }` scroll offset in pixels plus a `setRef` callback ref.
+ */
+export declare function useScrollPosition<T extends HTMLElement = HTMLElement>(params?: UseScrollPositionParams<T>): UseScrollPositionResult<T>;
+//# sourceMappingURL=useScrollPosition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollPosition.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScrollPosition/useScrollPosition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpD,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI;IACzE;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IACrE,cAAc,GAAG;IACf;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACxB,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACnE,MAAM,GAAE,uBAAuB,CAAC,CAAC,CAAM,GACtC,uBAAuB,CAAC,CAAC,CAAC,CA0C5B"}

package/dist/hooks/useScrollPosition.js

@@ -0,0 +1,41 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function useScrollPosition(params = {}) {
+  const { target } = params;
+  const [element, setElement] = react.useState(
+    () => target?.current ?? null
+  );
+  const [position, setPosition] = react.useState({ x: 0, y: 0 });
+  react.useEffect(() => {
+    if (target?.current != null) {
+      setElement(target.current);
+    }
+  }, [target]);
+  const setRef = react.useCallback((node) => {
+    setElement(node);
+  }, []);
+  react.useEffect(() => {
+    const node = element ?? (typeof window === "undefined" ? null : window);
+    if (node == null) {
+      return;
+    }
+    const read = () => element == null ? { x: window.scrollX, y: window.scrollY } : { x: element.scrollLeft, y: element.scrollTop };
+    const onScroll = () => {
+      setPosition(read());
+    };
+    onScroll();
+    node.addEventListener("scroll", onScroll, { passive: true });
+    return () => {
+      node.removeEventListener("scroll", onScroll);
+    };
+  }, [element]);
+  return { x: position.x, y: position.y, setRef };
+}
+
+exports.useScrollPosition = useScrollPosition;
+//# sourceMappingURL=useScrollPosition.js.map
+//# sourceMappingURL=useScrollPosition.js.map

package/dist/hooks/useScrollPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useScrollPosition/useScrollPosition.ts"],"names":["useState","useEffect","useCallback"],"mappings":";;;;;AA2CO,SAAS,iBAAA,CACd,MAAA,GAAqC,EAAC,EACV;AAC5B,EAAA,MAAM,EAAE,QAAO,GAAI,MAAA;AAInB,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,cAAA;AAAA,IAC5B,MAAM,QAAQ,OAAA,IAAW;AAAA,GAC3B;AACA,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIA,cAAA,CAAyB,EAAE,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA;AAGvE,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,MAAA,EAAQ,WAAW,IAAA,EAAM;AAC3B,MAAA,UAAA,CAAW,OAAO,OAAO,CAAA;AAAA,IAC3B;AAAA,EACF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,MAAA,GAASC,iBAAA,CAAY,CAAC,IAAA,KAAmB;AAC7C,IAAA,UAAA,CAAW,IAAI,CAAA;AAAA,EACjB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAAD,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,IAAA,GACJ,OAAA,KAAY,OAAO,MAAA,KAAW,cAAc,IAAA,GAAO,MAAA,CAAA;AACrD,IAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,OAAO,MACX,OAAA,IAAW,OACP,EAAE,CAAA,EAAG,OAAO,OAAA,EAAS,CAAA,EAAG,MAAA,CAAO,OAAA,KAC/B,EAAE,CAAA,EAAG,QAAQ,UAAA,EAAY,CAAA,EAAG,QAAQ,SAAA,EAAU;AACpD,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,WAAA,CAAY,MAAM,CAAA;AAAA,IACpB,CAAA;AACA,IAAA,QAAA,EAAS;AACT,IAAA,IAAA,CAAK,iBAAiB,QAAA,EAAU,QAAA,EAAU,EAAE,OAAA,EAAS,MAAM,CAAA;AAC3D,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,mBAAA,CAAoB,UAAU,QAAQ,CAAA;AAAA,IAC7C,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAEZ,EAAA,OAAO,EAAE,CAAA,EAAG,QAAA,CAAS,GAAG,CAAA,EAAG,QAAA,CAAS,GAAG,MAAA,EAAO;AAChD","file":"useScrollPosition.js","sourcesContent":["\"use client\";\n\nimport type { RefCallback, RefObject } from \"react\";\nimport { useCallback, useEffect, useState } from \"react\";\n\nexport type ScrollPosition = {\n  x: number;\n  y: number;\n};\n\nexport type UseScrollPositionParams<T extends HTMLElement = HTMLElement> = {\n  /**\n   * Scroll container to observe via a pre-populated RefObject.\n   * For elements that mount asynchronously, use the returned `setRef` callback ref instead.\n   */\n  target?: RefObject<T | null>;\n};\n\nexport type UseScrollPositionResult<T extends HTMLElement = HTMLElement> =\n  ScrollPosition & {\n    /**\n     * Callback ref to attach to a scroll container — works correctly with elements\n     * that are null on initial render (lazy / conditional mounts). Pass this as `ref`\n     * on the scrollable element when you cannot guarantee the ref is populated at mount.\n     */\n    setRef: RefCallback<T>;\n  };\n\n/**\n * Tracks the scroll offset of the window (default) or a scrollable element.\n *\n * - Window mode reads `scrollX` / `scrollY`; element mode reads `scrollLeft` / `scrollTop`.\n * - Subscribes with a passive `scroll` listener and reads the initial position on mount.\n * - Pass a pre-populated `target` RefObject **or** use the returned `setRef` callback ref on\n *   the scrollable element. Prefer `setRef` for elements that may be null on the first render\n *   (conditional mounts, portals) — it stores the element in state so the effect re-attaches\n *   correctly when the element becomes available.\n * - For high-frequency consumers, derive throttled values downstream (e.g. with\n *   `useThrottledCallback`) rather than throttling the source of truth.\n *\n * @param params - {@link UseScrollPositionParams}\n * @returns Latest `{ x, y }` scroll offset in pixels plus a `setRef` callback ref.\n */\nexport function useScrollPosition<T extends HTMLElement = HTMLElement>(\n  params: UseScrollPositionParams<T> = {},\n): UseScrollPositionResult<T> {\n  const { target } = params;\n\n  // Track the element in state so the scroll listener effect reruns when the element\n  // is assigned (handles callback-ref / lazy-mount patterns).\n  const [element, setElement] = useState<T | null>(\n    () => target?.current ?? null,\n  );\n  const [position, setPosition] = useState<ScrollPosition>({ x: 0, y: 0 });\n\n  // Sync element state when the target RefObject changes (pre-populated refs).\n  useEffect(() => {\n    if (target?.current != null) {\n      setElement(target.current);\n    }\n  }, [target]);\n\n  const setRef = useCallback((node: T | null) => {\n    setElement(node);\n  }, []);\n\n  useEffect(() => {\n    const node: Window | T | null =\n      element ?? (typeof window === \"undefined\" ? null : window);\n    if (node == null) {\n      return;\n    }\n    const read = (): ScrollPosition =>\n      element == null\n        ? { x: window.scrollX, y: window.scrollY }\n        : { x: element.scrollLeft, y: element.scrollTop };\n    const onScroll = () => {\n      setPosition(read());\n    };\n    onScroll();\n    node.addEventListener(\"scroll\", onScroll, { passive: true });\n    return () => {\n      node.removeEventListener(\"scroll\", onScroll);\n    };\n  }, [element]);\n\n  return { x: position.x, y: position.y, setRef };\n}\n"]}

package/dist/hooks/useScrollPosition.mjs

@@ -0,0 +1,39 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useState, useEffect, useCallback } from 'react';
+
+function useScrollPosition(params = {}) {
+  const { target } = params;
+  const [element, setElement] = useState(
+    () => target?.current ?? null
+  );
+  const [position, setPosition] = useState({ x: 0, y: 0 });
+  useEffect(() => {
+    if (target?.current != null) {
+      setElement(target.current);
+    }
+  }, [target]);
+  const setRef = useCallback((node) => {
+    setElement(node);
+  }, []);
+  useEffect(() => {
+    const node = element ?? (typeof window === "undefined" ? null : window);
+    if (node == null) {
+      return;
+    }
+    const read = () => element == null ? { x: window.scrollX, y: window.scrollY } : { x: element.scrollLeft, y: element.scrollTop };
+    const onScroll = () => {
+      setPosition(read());
+    };
+    onScroll();
+    node.addEventListener("scroll", onScroll, { passive: true });
+    return () => {
+      node.removeEventListener("scroll", onScroll);
+    };
+  }, [element]);
+  return { x: position.x, y: position.y, setRef };
+}
+
+export { useScrollPosition };
+//# sourceMappingURL=useScrollPosition.mjs.map
+//# sourceMappingURL=useScrollPosition.mjs.map

package/dist/hooks/useScrollPosition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useScrollPosition/useScrollPosition.ts"],"names":[],"mappings":";;;AA2CO,SAAS,iBAAA,CACd,MAAA,GAAqC,EAAC,EACV;AAC5B,EAAA,MAAM,EAAE,QAAO,GAAI,MAAA;AAInB,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,QAAA;AAAA,IAC5B,MAAM,QAAQ,OAAA,IAAW;AAAA,GAC3B;AACA,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAI,QAAA,CAAyB,EAAE,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA;AAGvE,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,MAAA,EAAQ,WAAW,IAAA,EAAM;AAC3B,MAAA,UAAA,CAAW,OAAO,OAAO,CAAA;AAAA,IAC3B;AAAA,EACF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,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,MAAM,IAAA,GACJ,OAAA,KAAY,OAAO,MAAA,KAAW,cAAc,IAAA,GAAO,MAAA,CAAA;AACrD,IAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,OAAO,MACX,OAAA,IAAW,OACP,EAAE,CAAA,EAAG,OAAO,OAAA,EAAS,CAAA,EAAG,MAAA,CAAO,OAAA,KAC/B,EAAE,CAAA,EAAG,QAAQ,UAAA,EAAY,CAAA,EAAG,QAAQ,SAAA,EAAU;AACpD,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,WAAA,CAAY,MAAM,CAAA;AAAA,IACpB,CAAA;AACA,IAAA,QAAA,EAAS;AACT,IAAA,IAAA,CAAK,iBAAiB,QAAA,EAAU,QAAA,EAAU,EAAE,OAAA,EAAS,MAAM,CAAA;AAC3D,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,mBAAA,CAAoB,UAAU,QAAQ,CAAA;AAAA,IAC7C,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAEZ,EAAA,OAAO,EAAE,CAAA,EAAG,QAAA,CAAS,GAAG,CAAA,EAAG,QAAA,CAAS,GAAG,MAAA,EAAO;AAChD","file":"useScrollPosition.mjs","sourcesContent":["\"use client\";\n\nimport type { RefCallback, RefObject } from \"react\";\nimport { useCallback, useEffect, useState } from \"react\";\n\nexport type ScrollPosition = {\n  x: number;\n  y: number;\n};\n\nexport type UseScrollPositionParams<T extends HTMLElement = HTMLElement> = {\n  /**\n   * Scroll container to observe via a pre-populated RefObject.\n   * For elements that mount asynchronously, use the returned `setRef` callback ref instead.\n   */\n  target?: RefObject<T | null>;\n};\n\nexport type UseScrollPositionResult<T extends HTMLElement = HTMLElement> =\n  ScrollPosition & {\n    /**\n     * Callback ref to attach to a scroll container — works correctly with elements\n     * that are null on initial render (lazy / conditional mounts). Pass this as `ref`\n     * on the scrollable element when you cannot guarantee the ref is populated at mount.\n     */\n    setRef: RefCallback<T>;\n  };\n\n/**\n * Tracks the scroll offset of the window (default) or a scrollable element.\n *\n * - Window mode reads `scrollX` / `scrollY`; element mode reads `scrollLeft` / `scrollTop`.\n * - Subscribes with a passive `scroll` listener and reads the initial position on mount.\n * - Pass a pre-populated `target` RefObject **or** use the returned `setRef` callback ref on\n *   the scrollable element. Prefer `setRef` for elements that may be null on the first render\n *   (conditional mounts, portals) — it stores the element in state so the effect re-attaches\n *   correctly when the element becomes available.\n * - For high-frequency consumers, derive throttled values downstream (e.g. with\n *   `useThrottledCallback`) rather than throttling the source of truth.\n *\n * @param params - {@link UseScrollPositionParams}\n * @returns Latest `{ x, y }` scroll offset in pixels plus a `setRef` callback ref.\n */\nexport function useScrollPosition<T extends HTMLElement = HTMLElement>(\n  params: UseScrollPositionParams<T> = {},\n): UseScrollPositionResult<T> {\n  const { target } = params;\n\n  // Track the element in state so the scroll listener effect reruns when the element\n  // is assigned (handles callback-ref / lazy-mount patterns).\n  const [element, setElement] = useState<T | null>(\n    () => target?.current ?? null,\n  );\n  const [position, setPosition] = useState<ScrollPosition>({ x: 0, y: 0 });\n\n  // Sync element state when the target RefObject changes (pre-populated refs).\n  useEffect(() => {\n    if (target?.current != null) {\n      setElement(target.current);\n    }\n  }, [target]);\n\n  const setRef = useCallback((node: T | null) => {\n    setElement(node);\n  }, []);\n\n  useEffect(() => {\n    const node: Window | T | null =\n      element ?? (typeof window === \"undefined\" ? null : window);\n    if (node == null) {\n      return;\n    }\n    const read = (): ScrollPosition =>\n      element == null\n        ? { x: window.scrollX, y: window.scrollY }\n        : { x: element.scrollLeft, y: element.scrollTop };\n    const onScroll = () => {\n      setPosition(read());\n    };\n    onScroll();\n    node.addEventListener(\"scroll\", onScroll, { passive: true });\n    return () => {\n      node.removeEventListener(\"scroll\", onScroll);\n    };\n  }, [element]);\n\n  return { x: position.x, y: position.y, setRef };\n}\n"]}

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

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

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

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

package/dist/hooks/useTimeout/useTimeout.d.ts

@@ -0,0 +1,19 @@
+export type UseTimeoutResult = {
+    /** Cancel the pending timeout (no-op if already fired or cleared). */
+    clear: () => void;
+    /** Cancel any pending timeout and schedule a fresh one with the current delay. */
+    reset: () => void;
+};
+/**
+ * Declarative `setTimeout`: runs `callback` once after `delayMs` milliseconds with automatic cleanup.
+ *
+ * - The latest callback is kept in a ref, so a new inline function each render does not reschedule.
+ * - Pass `null` as the delay to cancel scheduling entirely.
+ * - Changing `delayMs` cancels the pending timeout and schedules a new one.
+ *
+ * @param callback - Function invoked when the timeout fires.
+ * @param delayMs - Delay in milliseconds, or `null` to disable.
+ * @returns `{ clear, reset }` to cancel or restart the timeout imperatively.
+ */
+export declare function useTimeout(callback: () => void, delayMs: number | null): UseTimeoutResult;
+//# sourceMappingURL=useTimeout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeout.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTimeout/useTimeout.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sEAAsE;IACtE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kFAAkF;IAClF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,gBAAgB,CAgClB"}

package/dist/hooks/useTimeout.js

@@ -0,0 +1,38 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function useTimeout(callback, delayMs) {
+  const callbackRef = react.useRef(callback);
+  const timeoutRef = react.useRef(void 0);
+  react.useEffect(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+  const clear = react.useCallback(() => {
+    if (timeoutRef.current !== void 0) {
+      window.clearTimeout(timeoutRef.current);
+      timeoutRef.current = void 0;
+    }
+  }, []);
+  const reset = react.useCallback(() => {
+    clear();
+    if (delayMs == null) {
+      return;
+    }
+    timeoutRef.current = window.setTimeout(() => {
+      timeoutRef.current = void 0;
+      callbackRef.current();
+    }, delayMs);
+  }, [clear, delayMs]);
+  react.useEffect(() => {
+    reset();
+    return clear;
+  }, [clear, reset]);
+  return { clear, reset };
+}
+
+exports.useTimeout = useTimeout;
+//# sourceMappingURL=useTimeout.js.map
+//# sourceMappingURL=useTimeout.js.map

package/dist/hooks/useTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useTimeout/useTimeout.ts"],"names":["useRef","useEffect","useCallback"],"mappings":";;;;;AAsBO,SAAS,UAAA,CACd,UACA,OAAA,EACkB;AAClB,EAAA,MAAM,WAAA,GAAcA,aAAO,QAAQ,CAAA;AACnC,EAAA,MAAM,UAAA,GAAaA,aAA2B,MAAS,CAAA;AAEvD,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAAA,EACxB,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAA,MAAM,KAAA,GAAQC,kBAAY,MAAM;AAC9B,IAAA,IAAI,UAAA,CAAW,YAAY,MAAA,EAAW;AACpC,MAAA,MAAA,CAAO,YAAA,CAAa,WAAW,OAAO,CAAA;AACtC,MAAA,UAAA,CAAW,OAAA,GAAU,MAAA;AAAA,IACvB;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,KAAA,GAAQA,kBAAY,MAAM;AAC9B,IAAA,KAAA,EAAM;AACN,IAAA,IAAI,WAAW,IAAA,EAAM;AACnB,MAAA;AAAA,IACF;AACA,IAAA,UAAA,CAAW,OAAA,GAAU,MAAA,CAAO,UAAA,CAAW,MAAM;AAC3C,MAAA,UAAA,CAAW,OAAA,GAAU,MAAA;AACrB,MAAA,WAAA,CAAY,OAAA,EAAQ;AAAA,IACtB,GAAG,OAAO,CAAA;AAAA,EACZ,CAAA,EAAG,CAAC,KAAA,EAAO,OAAO,CAAC,CAAA;AAEnB,EAAAD,eAAA,CAAU,MAAM;AACd,IAAA,KAAA,EAAM;AACN,IAAA,OAAO,KAAA;AAAA,EACT,CAAA,EAAG,CAAC,KAAA,EAAO,KAAK,CAAC,CAAA;AAEjB,EAAA,OAAO,EAAE,OAAO,KAAA,EAAM;AACxB","file":"useTimeout.js","sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useRef } from \"react\";\n\nexport type UseTimeoutResult = {\n  /** Cancel the pending timeout (no-op if already fired or cleared). */\n  clear: () => void;\n  /** Cancel any pending timeout and schedule a fresh one with the current delay. */\n  reset: () => void;\n};\n\n/**\n * Declarative `setTimeout`: runs `callback` once after `delayMs` milliseconds with automatic cleanup.\n *\n * - The latest callback is kept in a ref, so a new inline function each render does not reschedule.\n * - Pass `null` as the delay to cancel scheduling entirely.\n * - Changing `delayMs` cancels the pending timeout and schedules a new one.\n *\n * @param callback - Function invoked when the timeout fires.\n * @param delayMs - Delay in milliseconds, or `null` to disable.\n * @returns `{ clear, reset }` to cancel or restart the timeout imperatively.\n */\nexport function useTimeout(\n  callback: () => void,\n  delayMs: number | null,\n): UseTimeoutResult {\n  const callbackRef = useRef(callback);\n  const timeoutRef = useRef<number | undefined>(undefined);\n\n  useEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n\n  const clear = useCallback(() => {\n    if (timeoutRef.current !== undefined) {\n      window.clearTimeout(timeoutRef.current);\n      timeoutRef.current = undefined;\n    }\n  }, []);\n\n  const reset = useCallback(() => {\n    clear();\n    if (delayMs == null) {\n      return;\n    }\n    timeoutRef.current = window.setTimeout(() => {\n      timeoutRef.current = undefined;\n      callbackRef.current();\n    }, delayMs);\n  }, [clear, delayMs]);\n\n  useEffect(() => {\n    reset();\n    return clear;\n  }, [clear, reset]);\n\n  return { clear, reset };\n}\n"]}

package/dist/hooks/useTimeout.mjs

@@ -0,0 +1,36 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useRef, useEffect, useCallback } from 'react';
+
+function useTimeout(callback, delayMs) {
+  const callbackRef = useRef(callback);
+  const timeoutRef = useRef(void 0);
+  useEffect(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+  const clear = useCallback(() => {
+    if (timeoutRef.current !== void 0) {
+      window.clearTimeout(timeoutRef.current);
+      timeoutRef.current = void 0;
+    }
+  }, []);
+  const reset = useCallback(() => {
+    clear();
+    if (delayMs == null) {
+      return;
+    }
+    timeoutRef.current = window.setTimeout(() => {
+      timeoutRef.current = void 0;
+      callbackRef.current();
+    }, delayMs);
+  }, [clear, delayMs]);
+  useEffect(() => {
+    reset();
+    return clear;
+  }, [clear, reset]);
+  return { clear, reset };
+}
+
+export { useTimeout };
+//# sourceMappingURL=useTimeout.mjs.map
+//# sourceMappingURL=useTimeout.mjs.map

package/dist/hooks/useTimeout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useTimeout/useTimeout.ts"],"names":[],"mappings":";;;AAsBO,SAAS,UAAA,CACd,UACA,OAAA,EACkB;AAClB,EAAA,MAAM,WAAA,GAAc,OAAO,QAAQ,CAAA;AACnC,EAAA,MAAM,UAAA,GAAa,OAA2B,MAAS,CAAA;AAEvD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AAAA,EACxB,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,IAAI,UAAA,CAAW,YAAY,MAAA,EAAW;AACpC,MAAA,MAAA,CAAO,YAAA,CAAa,WAAW,OAAO,CAAA;AACtC,MAAA,UAAA,CAAW,OAAA,GAAU,MAAA;AAAA,IACvB;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC9B,IAAA,KAAA,EAAM;AACN,IAAA,IAAI,WAAW,IAAA,EAAM;AACnB,MAAA;AAAA,IACF;AACA,IAAA,UAAA,CAAW,OAAA,GAAU,MAAA,CAAO,UAAA,CAAW,MAAM;AAC3C,MAAA,UAAA,CAAW,OAAA,GAAU,MAAA;AACrB,MAAA,WAAA,CAAY,OAAA,EAAQ;AAAA,IACtB,GAAG,OAAO,CAAA;AAAA,EACZ,CAAA,EAAG,CAAC,KAAA,EAAO,OAAO,CAAC,CAAA;AAEnB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,KAAA,EAAM;AACN,IAAA,OAAO,KAAA;AAAA,EACT,CAAA,EAAG,CAAC,KAAA,EAAO,KAAK,CAAC,CAAA;AAEjB,EAAA,OAAO,EAAE,OAAO,KAAA,EAAM;AACxB","file":"useTimeout.mjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useRef } from \"react\";\n\nexport type UseTimeoutResult = {\n  /** Cancel the pending timeout (no-op if already fired or cleared). */\n  clear: () => void;\n  /** Cancel any pending timeout and schedule a fresh one with the current delay. */\n  reset: () => void;\n};\n\n/**\n * Declarative `setTimeout`: runs `callback` once after `delayMs` milliseconds with automatic cleanup.\n *\n * - The latest callback is kept in a ref, so a new inline function each render does not reschedule.\n * - Pass `null` as the delay to cancel scheduling entirely.\n * - Changing `delayMs` cancels the pending timeout and schedules a new one.\n *\n * @param callback - Function invoked when the timeout fires.\n * @param delayMs - Delay in milliseconds, or `null` to disable.\n * @returns `{ clear, reset }` to cancel or restart the timeout imperatively.\n */\nexport function useTimeout(\n  callback: () => void,\n  delayMs: number | null,\n): UseTimeoutResult {\n  const callbackRef = useRef(callback);\n  const timeoutRef = useRef<number | undefined>(undefined);\n\n  useEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n\n  const clear = useCallback(() => {\n    if (timeoutRef.current !== undefined) {\n      window.clearTimeout(timeoutRef.current);\n      timeoutRef.current = undefined;\n    }\n  }, []);\n\n  const reset = useCallback(() => {\n    clear();\n    if (delayMs == null) {\n      return;\n    }\n    timeoutRef.current = window.setTimeout(() => {\n      timeoutRef.current = undefined;\n      callbackRef.current();\n    }, delayMs);\n  }, [clear, delayMs]);\n\n  useEffect(() => {\n    reset();\n    return clear;\n  }, [clear, reset]);\n\n  return { clear, reset };\n}\n"]}

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

@@ -0,0 +1,2 @@
+export { useVirtualList, type UseVirtualListParams, type UseVirtualListResult, type VirtualItem, } from "./useVirtualList";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useVirtualList/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/hooks/useVirtualList/useVirtualList.d.ts

@@ -0,0 +1,47 @@
+import type { RefCallback } from "react";
+export type VirtualItem = {
+    /** Index into your data array. */
+    index: number;
+    /** Offset from the top of the scroll content in pixels (use for `translateY` / `top`). */
+    start: number;
+    /** Row height in pixels. */
+    size: number;
+};
+export type UseVirtualListParams = {
+    /** Total number of rows in the list. */
+    itemCount: number;
+    /** Fixed height of every row in pixels (must be > 0). */
+    itemHeight: number;
+    /** Extra rows rendered above and below the viewport (default `3`). */
+    overscan?: number;
+};
+export type UseVirtualListResult = {
+    /** Callback ref for the scrollable container (needs `overflow-y: auto` and a bounded height). */
+    setContainerRef: RefCallback<HTMLElement>;
+    /** The rows to render, each with its absolute `start` offset. */
+    virtualItems: VirtualItem[];
+    /** Height of the full list content; set it on an inner spacer element. */
+    totalHeight: number;
+    /** First rendered index (after overscan). */
+    startIndex: number;
+    /** Last rendered index (after overscan), `-1` when empty. */
+    endIndex: number;
+    /** Scroll the container so the given row is at the top. */
+    scrollToIndex: (index: number) => void;
+};
+/**
+ * Headless fixed-height list virtualization: renders only the rows visible in the
+ * scroll container (plus `overscan`), so lists of tens of thousands of rows stay cheap.
+ *
+ * Markup recipe: outer container gets `setContainerRef` + `overflow-y: auto` and a height;
+ * inside it, one relative spacer div with `height: totalHeight`; each virtual item is
+ * absolutely positioned at `translateY(item.start)` with `height: item.size`.
+ *
+ * Viewport size tracks `ResizeObserver` (when available) and scroll position tracks a
+ * passive `scroll` listener. For variable-height rows, reach for a dedicated virtualizer.
+ *
+ * @param params - {@link UseVirtualListParams}
+ * @returns {@link UseVirtualListResult}
+ */
+export declare function useVirtualList({ itemCount, itemHeight, overscan, }: UseVirtualListParams): UseVirtualListResult;
+//# sourceMappingURL=useVirtualList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualList.d.ts","sourceRoot":"","sources":["../../../src/hooks/useVirtualList/useVirtualList.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzC,MAAM,MAAM,WAAW,GAAG;IACxB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,iGAAiG;IACjG,eAAe,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAC1C,iEAAiE;IACjE,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,UAAU,EACV,QAAY,GACb,EAAE,oBAAoB,GAAG,oBAAoB,CAuF7C"}

package/dist/hooks/useVirtualList.js

@@ -0,0 +1,87 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function useVirtualList({
+  itemCount,
+  itemHeight,
+  overscan = 3
+}) {
+  const [container, setContainer] = react.useState(null);
+  const [scrollTop, setScrollTop] = react.useState(0);
+  const [viewportHeight, setViewportHeight] = react.useState(0);
+  const setContainerRef = react.useCallback((node) => {
+    setContainer(node);
+  }, []);
+  react.useEffect(() => {
+    if (container == null) {
+      return;
+    }
+    const onScroll = () => {
+      setScrollTop(container.scrollTop);
+    };
+    const measure = () => {
+      setViewportHeight(container.clientHeight);
+    };
+    measure();
+    onScroll();
+    container.addEventListener("scroll", onScroll, { passive: true });
+    let observer;
+    if (typeof ResizeObserver !== "undefined") {
+      observer = new ResizeObserver(measure);
+      observer.observe(container);
+    }
+    return () => {
+      container.removeEventListener("scroll", onScroll);
+      observer?.disconnect();
+    };
+  }, [container]);
+  const safeItemCount = Math.max(0, Math.floor(itemCount));
+  const safeItemHeight = Math.max(1, itemHeight);
+  const safeOverscan = Math.max(0, Math.floor(overscan));
+  const totalHeight = safeItemCount * safeItemHeight;
+  const startIndex = safeItemCount === 0 ? 0 : Math.max(
+    0,
+    Math.floor(scrollTop / safeItemHeight) - safeOverscan
+  );
+  const endIndex = safeItemCount === 0 ? -1 : Math.min(
+    safeItemCount - 1,
+    Math.ceil((scrollTop + viewportHeight) / safeItemHeight) - 1 + safeOverscan
+  );
+  const virtualItems = react.useMemo(() => {
+    const items = [];
+    for (let index = startIndex; index <= endIndex; index += 1) {
+      items.push({
+        index,
+        start: index * safeItemHeight,
+        size: safeItemHeight
+      });
+    }
+    return items;
+  }, [endIndex, safeItemHeight, startIndex]);
+  const scrollToIndex = react.useCallback(
+    (index) => {
+      if (container == null || safeItemCount === 0) {
+        return;
+      }
+      const clamped = Math.min(Math.max(index, 0), safeItemCount - 1);
+      container.scrollTop = clamped * safeItemHeight;
+      setScrollTop(container.scrollTop);
+    },
+    [container, safeItemCount, safeItemHeight]
+  );
+  return {
+    setContainerRef,
+    virtualItems,
+    totalHeight,
+    startIndex,
+    endIndex,
+    scrollToIndex
+  };
+}
+
+exports.useVirtualList = useVirtualList;
+//# sourceMappingURL=useVirtualList.js.map
+//# sourceMappingURL=useVirtualList.js.map

package/dist/hooks/useVirtualList.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useVirtualList/useVirtualList.ts"],"names":["useState","useCallback","useEffect","useMemo"],"mappings":"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","file":"useVirtualList.js","sourcesContent":["\"use client\";\n\nimport type { RefCallback } from \"react\";\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\n\nexport type VirtualItem = {\n  /** Index into your data array. */\n  index: number;\n  /** Offset from the top of the scroll content in pixels (use for `translateY` / `top`). */\n  start: number;\n  /** Row height in pixels. */\n  size: number;\n};\n\nexport type UseVirtualListParams = {\n  /** Total number of rows in the list. */\n  itemCount: number;\n  /** Fixed height of every row in pixels (must be > 0). */\n  itemHeight: number;\n  /** Extra rows rendered above and below the viewport (default `3`). */\n  overscan?: number;\n};\n\nexport type UseVirtualListResult = {\n  /** Callback ref for the scrollable container (needs `overflow-y: auto` and a bounded height). */\n  setContainerRef: RefCallback<HTMLElement>;\n  /** The rows to render, each with its absolute `start` offset. */\n  virtualItems: VirtualItem[];\n  /** Height of the full list content; set it on an inner spacer element. */\n  totalHeight: number;\n  /** First rendered index (after overscan). */\n  startIndex: number;\n  /** Last rendered index (after overscan), `-1` when empty. */\n  endIndex: number;\n  /** Scroll the container so the given row is at the top. */\n  scrollToIndex: (index: number) => void;\n};\n\n/**\n * Headless fixed-height list virtualization: renders only the rows visible in the\n * scroll container (plus `overscan`), so lists of tens of thousands of rows stay cheap.\n *\n * Markup recipe: outer container gets `setContainerRef` + `overflow-y: auto` and a height;\n * inside it, one relative spacer div with `height: totalHeight`; each virtual item is\n * absolutely positioned at `translateY(item.start)` with `height: item.size`.\n *\n * Viewport size tracks `ResizeObserver` (when available) and scroll position tracks a\n * passive `scroll` listener. For variable-height rows, reach for a dedicated virtualizer.\n *\n * @param params - {@link UseVirtualListParams}\n * @returns {@link UseVirtualListResult}\n */\nexport function useVirtualList({\n  itemCount,\n  itemHeight,\n  overscan = 3,\n}: UseVirtualListParams): UseVirtualListResult {\n  const [container, setContainer] = useState<HTMLElement | null>(null);\n  const [scrollTop, setScrollTop] = useState(0);\n  const [viewportHeight, setViewportHeight] = useState(0);\n\n  const setContainerRef = useCallback((node: HTMLElement | null) => {\n    setContainer(node);\n  }, []);\n\n  useEffect(() => {\n    if (container == null) {\n      return;\n    }\n    const onScroll = () => {\n      setScrollTop(container.scrollTop);\n    };\n    const measure = () => {\n      setViewportHeight(container.clientHeight);\n    };\n    measure();\n    onScroll();\n    container.addEventListener(\"scroll\", onScroll, { passive: true });\n    let observer: ResizeObserver | undefined;\n    if (typeof ResizeObserver !== \"undefined\") {\n      observer = new ResizeObserver(measure);\n      observer.observe(container);\n    }\n    return () => {\n      container.removeEventListener(\"scroll\", onScroll);\n      observer?.disconnect();\n    };\n  }, [container]);\n\n  const safeItemCount = Math.max(0, Math.floor(itemCount));\n  const safeItemHeight = Math.max(1, itemHeight);\n  const safeOverscan = Math.max(0, Math.floor(overscan));\n\n  const totalHeight = safeItemCount * safeItemHeight;\n  const startIndex =\n    safeItemCount === 0\n      ? 0\n      : Math.max(\n          0,\n          Math.floor(scrollTop / safeItemHeight) - safeOverscan,\n        );\n  const endIndex =\n    safeItemCount === 0\n      ? -1\n      : Math.min(\n          safeItemCount - 1,\n          Math.ceil((scrollTop + viewportHeight) / safeItemHeight) -\n            1 +\n            safeOverscan,\n        );\n\n  const virtualItems = useMemo(() => {\n    const items: VirtualItem[] = [];\n    for (let index = startIndex; index <= endIndex; index += 1) {\n      items.push({\n        index,\n        start: index * safeItemHeight,\n        size: safeItemHeight,\n      });\n    }\n    return items;\n  }, [endIndex, safeItemHeight, startIndex]);\n\n  const scrollToIndex = useCallback(\n    (index: number) => {\n      if (container == null || safeItemCount === 0) {\n        return;\n      }\n      const clamped = Math.min(Math.max(index, 0), safeItemCount - 1);\n      container.scrollTop = clamped * safeItemHeight;\n      setScrollTop(container.scrollTop);\n    },\n    [container, safeItemCount, safeItemHeight],\n  );\n\n  return {\n    setContainerRef,\n    virtualItems,\n    totalHeight,\n    startIndex,\n    endIndex,\n    scrollToIndex,\n  };\n}\n"]}

package/dist/hooks/useVirtualList.mjs

@@ -0,0 +1,85 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useState, useCallback, useEffect, useMemo } from 'react';
+
+function useVirtualList({
+  itemCount,
+  itemHeight,
+  overscan = 3
+}) {
+  const [container, setContainer] = useState(null);
+  const [scrollTop, setScrollTop] = useState(0);
+  const [viewportHeight, setViewportHeight] = useState(0);
+  const setContainerRef = useCallback((node) => {
+    setContainer(node);
+  }, []);
+  useEffect(() => {
+    if (container == null) {
+      return;
+    }
+    const onScroll = () => {
+      setScrollTop(container.scrollTop);
+    };
+    const measure = () => {
+      setViewportHeight(container.clientHeight);
+    };
+    measure();
+    onScroll();
+    container.addEventListener("scroll", onScroll, { passive: true });
+    let observer;
+    if (typeof ResizeObserver !== "undefined") {
+      observer = new ResizeObserver(measure);
+      observer.observe(container);
+    }
+    return () => {
+      container.removeEventListener("scroll", onScroll);
+      observer?.disconnect();
+    };
+  }, [container]);
+  const safeItemCount = Math.max(0, Math.floor(itemCount));
+  const safeItemHeight = Math.max(1, itemHeight);
+  const safeOverscan = Math.max(0, Math.floor(overscan));
+  const totalHeight = safeItemCount * safeItemHeight;
+  const startIndex = safeItemCount === 0 ? 0 : Math.max(
+    0,
+    Math.floor(scrollTop / safeItemHeight) - safeOverscan
+  );
+  const endIndex = safeItemCount === 0 ? -1 : Math.min(
+    safeItemCount - 1,
+    Math.ceil((scrollTop + viewportHeight) / safeItemHeight) - 1 + safeOverscan
+  );
+  const virtualItems = useMemo(() => {
+    const items = [];
+    for (let index = startIndex; index <= endIndex; index += 1) {
+      items.push({
+        index,
+        start: index * safeItemHeight,
+        size: safeItemHeight
+      });
+    }
+    return items;
+  }, [endIndex, safeItemHeight, startIndex]);
+  const scrollToIndex = useCallback(
+    (index) => {
+      if (container == null || safeItemCount === 0) {
+        return;
+      }
+      const clamped = Math.min(Math.max(index, 0), safeItemCount - 1);
+      container.scrollTop = clamped * safeItemHeight;
+      setScrollTop(container.scrollTop);
+    },
+    [container, safeItemCount, safeItemHeight]
+  );
+  return {
+    setContainerRef,
+    virtualItems,
+    totalHeight,
+    startIndex,
+    endIndex,
+    scrollToIndex
+  };
+}
+
+export { useVirtualList };
+//# sourceMappingURL=useVirtualList.mjs.map
+//# sourceMappingURL=useVirtualList.mjs.map