@mastra/playground-ui 55.0.0 → 56.0.0-alpha.10

package/dist/hooks/use-fluid-hover.es.js

@@ -0,0 +1,289 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+
+function pickNearest({
+  axis,
+  point,
+  rects,
+  containerRect,
+  scroll,
+  border,
+  layoutSize,
+  isDisabled
+}) {
+  const scaleX = layoutSize.width > 0 ? containerRect.width / layoutSize.width : 1;
+  const scaleY = layoutSize.height > 0 ? containerRect.height / layoutSize.height : 1;
+  let closestIndex = null;
+  let closestDistance = Infinity;
+  let containingIndex = null;
+  for (let index = 0; index < rects.length; index++) {
+    const r = rects[index];
+    if (!r) continue;
+    if (isDisabled?.(index)) continue;
+    if (axis === "xy") {
+      const left = containerRect.left + (border.x + r.left - scroll.x) * scaleX;
+      const top = containerRect.top + (border.y + r.top - scroll.y) * scaleY;
+      const width = r.width * scaleX;
+      const height = r.height * scaleY;
+      if (point.x >= left && point.x <= left + width && point.y >= top && point.y <= top + height) {
+        containingIndex = index;
+      }
+      const distance2 = Math.hypot(point.x - (left + width / 2), point.y - (top + height / 2));
+      if (distance2 < closestDistance) {
+        closestDistance = distance2;
+        closestIndex = index;
+      }
+      continue;
+    }
+    const horizontal = axis === "x";
+    const mousePos = horizontal ? point.x : point.y;
+    const scale = horizontal ? scaleX : scaleY;
+    const itemStart = (horizontal ? containerRect.left : containerRect.top) + ((horizontal ? border.x : border.y) + (horizontal ? r.left : r.top) - (horizontal ? scroll.x : scroll.y)) * scale;
+    const itemSize = (horizontal ? r.width : r.height) * scale;
+    if (mousePos >= itemStart && mousePos <= itemStart + itemSize) {
+      containingIndex = index;
+    }
+    const distance = Math.abs(mousePos - (itemStart + itemSize / 2));
+    if (distance < closestDistance) {
+      closestDistance = distance;
+      closestIndex = index;
+    }
+  }
+  return containingIndex ?? closestIndex;
+}
+const ACTIVE_ATTR = "data-fluid-hover-active";
+const ACTIVE_INDEX_ATTR = "data-fluid-hover-active-index";
+const ACTIVATOR_SELECTOR = "a[href], button, [role='menuitem'], [role='menuitemradio'], [role='menuitemcheckbox'], [role='option'], [role='radio'], [role='checkbox'], [role='tab'], [role='link'], [role='button']";
+function resolveActivator(element) {
+  if (element.matches(ACTIVATOR_SELECTOR) || element.hasAttribute("tabindex")) {
+    return element;
+  }
+  return element.querySelector(ACTIVATOR_SELECTOR) ?? element;
+}
+const measurementAttempts = 3;
+function useFluidHover(containerRef, options = {}) {
+  const { axis = "y", isItemDisabled, gapClick = true } = options;
+  const gapClickMaxDistance = typeof gapClick === "object" ? gapClick.maxDistance ?? Infinity : Infinity;
+  const itemsRef = useRef(/* @__PURE__ */ new Map());
+  const [activeIndex, setActiveIndex] = useState(null);
+  const activeIndexRef = useRef(null);
+  activeIndexRef.current = activeIndex;
+  useEffect(() => {
+    const container = containerRef.current;
+    if (activeIndex === null) container?.removeAttribute(ACTIVE_INDEX_ATTR);
+    else container?.setAttribute(ACTIVE_INDEX_ATTR, String(activeIndex));
+    const active = activeIndex === null ? void 0 : itemsRef.current.get(activeIndex);
+    active?.setAttribute(ACTIVE_ATTR, "");
+    return () => {
+      active?.removeAttribute(ACTIVE_ATTR);
+      if (activeIndex !== null) itemsRef.current.get(activeIndex)?.removeAttribute(ACTIVE_ATTR);
+    };
+  }, [activeIndex, containerRef]);
+  const [itemRects, setItemRects] = useState([]);
+  const [isMeasured, setIsMeasured] = useState(false);
+  const itemRectsRef = useRef([]);
+  const sessionRef = useRef(0);
+  const rafIdRef = useRef(null);
+  const remeasureRafIdRef = useRef(null);
+  const runMeasurement = useCallback(() => {
+    const container = containerRef.current;
+    if (!container) return false;
+    const rects = [];
+    let everyItemHasLayout = true;
+    itemsRef.current.forEach((element, index) => {
+      const hasLayoutBox = element.offsetParent !== null || element.offsetWidth > 0 || element.offsetHeight > 0;
+      if (!hasLayoutBox) {
+        everyItemHasLayout = false;
+        return;
+      }
+      let top = element.offsetTop;
+      let left = element.offsetLeft;
+      let ancestor = element.offsetParent;
+      while (ancestor && ancestor !== container && container.contains(ancestor)) {
+        top += ancestor.offsetTop + ancestor.clientTop;
+        left += ancestor.offsetLeft + ancestor.clientLeft;
+        ancestor = ancestor.offsetParent;
+      }
+      rects[index] = {
+        top,
+        height: element.offsetHeight,
+        left,
+        width: element.offsetWidth
+      };
+    });
+    if (!everyItemHasLayout) return false;
+    const prev = itemRectsRef.current;
+    let changed = prev.length !== rects.length;
+    for (let i = 0; !changed && i < rects.length; i++) {
+      const p = prev[i];
+      const r = rects[i];
+      if (p === r) continue;
+      changed = !p || !r || p.top !== r.top || p.left !== r.left || p.width !== r.width || p.height !== r.height;
+    }
+    if (changed) {
+      itemRectsRef.current = rects;
+      setItemRects(rects);
+    }
+    return true;
+  }, [containerRef]);
+  const measureItems = useCallback(() => {
+    runMeasurement();
+  }, [runMeasurement]);
+  const scheduleMeasurement = useCallback(
+    (attemptsLeft) => {
+      if (remeasureRafIdRef.current !== null) {
+        cancelAnimationFrame(remeasureRafIdRef.current);
+      }
+      remeasureRafIdRef.current = requestAnimationFrame(() => {
+        remeasureRafIdRef.current = null;
+        if (runMeasurement()) {
+          setIsMeasured(true);
+        } else if (attemptsLeft > 1) {
+          scheduleMeasurement(attemptsLeft - 1);
+        }
+      });
+    },
+    [runMeasurement]
+  );
+  const remeasure = useCallback(() => {
+    setIsMeasured(false);
+    scheduleMeasurement(measurementAttempts);
+  }, [scheduleMeasurement]);
+  const itemRoRef = useRef(null);
+  const getItemRo = useCallback(() => {
+    if (itemRoRef.current === null && typeof ResizeObserver !== "undefined") {
+      itemRoRef.current = new ResizeObserver(() => scheduleMeasurement(measurementAttempts));
+    }
+    return itemRoRef.current;
+  }, [scheduleMeasurement]);
+  const registerItem = useCallback(
+    (index, element) => {
+      if (element) {
+        itemsRef.current.set(index, element);
+        getItemRo()?.observe(element);
+        if (index === activeIndexRef.current) element.setAttribute(ACTIVE_ATTR, "");
+      } else {
+        const previous = itemsRef.current.get(index);
+        if (previous) itemRoRef.current?.unobserve(previous);
+        previous?.removeAttribute(ACTIVE_ATTR);
+        itemsRef.current.delete(index);
+        if (index === activeIndexRef.current) {
+          setActiveIndex((current) => current === index && !itemsRef.current.has(index) ? null : current);
+        }
+      }
+      remeasure();
+    },
+    [remeasure, getItemRo]
+  );
+  const handleMouseMove = useCallback(
+    (e) => {
+      const mouseX = e.clientX;
+      const mouseY = e.clientY;
+      if (rafIdRef.current !== null) {
+        cancelAnimationFrame(rafIdRef.current);
+      }
+      rafIdRef.current = requestAnimationFrame(() => {
+        rafIdRef.current = null;
+        const container = containerRef.current;
+        if (!container) return;
+        setActiveIndex(
+          pickNearest({
+            axis,
+            point: { x: mouseX, y: mouseY },
+            rects: itemRectsRef.current,
+            containerRect: container.getBoundingClientRect(),
+            scroll: { x: container.scrollLeft, y: container.scrollTop },
+            border: { x: container.clientLeft, y: container.clientTop },
+            layoutSize: { width: container.offsetWidth, height: container.offsetHeight },
+            isDisabled: isItemDisabled ? (index) => {
+              const el = itemsRef.current.get(index);
+              return !!el && isItemDisabled(el);
+            } : void 0
+          })
+        );
+      });
+    },
+    [axis, containerRef, isItemDisabled]
+  );
+  const handleMouseEnter = useCallback(() => {
+    sessionRef.current += 1;
+  }, []);
+  const handleMouseLeave = useCallback(() => {
+    if (rafIdRef.current !== null) {
+      cancelAnimationFrame(rafIdRef.current);
+      rafIdRef.current = null;
+    }
+    setActiveIndex(null);
+  }, []);
+  const handleClick = useCallback(
+    (e) => {
+      const target = e.target;
+      if (!target) return;
+      for (const element2 of itemsRef.current.values()) {
+        if (element2.contains(target)) return;
+      }
+      if (!target.isConnected) return;
+      const control = target.closest?.(
+        "input, textarea, select, button, a, summary, [contenteditable], [role='textbox'], [role='searchbox'], [role='button']"
+      );
+      if (control) return;
+      if (gapClick === false) return;
+      const index = activeIndexRef.current;
+      if (index === null) return;
+      const element = itemsRef.current.get(index);
+      if (!element || isItemDisabled?.(element)) return;
+      if (gapClickMaxDistance !== Infinity) {
+        const r = element.getBoundingClientRect();
+        const dx = Math.max(r.left - e.clientX, 0, e.clientX - r.right);
+        const dy = Math.max(r.top - e.clientY, 0, e.clientY - r.bottom);
+        if (Math.hypot(dx, dy) > gapClickMaxDistance) return;
+      }
+      resolveActivator(element).click();
+    },
+    [isItemDisabled, gapClick, gapClickMaxDistance]
+  );
+  useEffect(() => {
+    const container = containerRef.current;
+    if (!container || typeof ResizeObserver === "undefined") return;
+    const ro = new ResizeObserver(() => scheduleMeasurement(measurementAttempts));
+    ro.observe(container);
+    return () => ro.disconnect();
+  }, [containerRef, scheduleMeasurement]);
+  useEffect(() => {
+    return () => {
+      if (rafIdRef.current !== null) {
+        cancelAnimationFrame(rafIdRef.current);
+      }
+      if (remeasureRafIdRef.current !== null) {
+        cancelAnimationFrame(remeasureRafIdRef.current);
+      }
+      itemRoRef.current?.disconnect();
+      itemRoRef.current = null;
+    };
+  }, []);
+  return {
+    activeIndex,
+    setActiveIndex,
+    itemRects,
+    isMeasured,
+    sessionRef,
+    handlers: {
+      onMouseMove: handleMouseMove,
+      onMouseEnter: handleMouseEnter,
+      onMouseLeave: handleMouseLeave,
+      onClick: handleClick
+    },
+    registerItem,
+    remeasure,
+    measureItems
+  };
+}
+function useRegisterFluidHoverItem(registerItem, index, ref) {
+  useEffect(() => {
+    if (!registerItem || index === void 0) return;
+    registerItem(index, ref.current);
+    return () => registerItem(index, null);
+  }, [index, registerItem, ref]);
+}
+
+export { ACTIVE_ATTR, ACTIVE_INDEX_ATTR, pickNearest, useFluidHover, useRegisterFluidHoverItem };
+//# sourceMappingURL=use-fluid-hover.es.js.map

package/dist/hooks/use-fluid-hover.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fluid-hover.es.js","sources":["../../src/hooks/use-fluid-hover.ts"],"sourcesContent":["'use client';\n\nimport { useRef, useState, useCallback, useEffect, type Dispatch, type RefObject, type SetStateAction } from 'react';\n\nexport interface ItemRect {\n  top: number;\n  height: number;\n  left: number;\n  width: number;\n}\n\nexport interface UseFluidHoverOptions {\n  /**\n   * Which direction to resolve the nearest item along.\n   *   \"y\"  — vertical lists (default): closest by top/height\n   *   \"x\"  — horizontal strips: closest by left/width\n   *   \"xy\" — 2-D grids: closest card across both rows AND columns,\n   *          measured by Euclidean distance to each item's center\n   */\n  axis?: 'x' | 'y' | 'xy';\n  /**\n   * Makes an item invisible to hit-testing without unregistering it — for\n   * rows that stay mounted while clipped away (a collapsed sub-tree).\n   * Unregistering would invalidate every measurement; a skipped item keeps\n   * the set stable. Consulted per mouse move, so keep it cheap.\n   */\n  isItemDisabled?: (element: HTMLElement) => boolean;\n  /**\n   * Whether a click that lands between items (a gap, the padding, past the\n   * last row) is routed to the highlighted item, so what is lit is what a\n   * click hits. On by default: in a menu or a list the highlight is a\n   * promise about the click. Pass `false` where empty space should stay\n   * inert (rows with destructive actions, generous whitespace), or\n   * `{ maxDistance }` to route only clicks within that many pixels of the\n   * highlighted item's edge.\n   */\n  gapClick?: boolean | { maxDistance?: number };\n}\n\nexport interface UseFluidHoverReturn {\n  activeIndex: number | null;\n  setActiveIndex: Dispatch<SetStateAction<number | null>>;\n  itemRects: ItemRect[];\n  /**\n   * True once every registered item has been measured and no remeasure is\n   * pending, i.e. `itemRects` describes the current item set. Gate absolutely\n   * positioned overlays on it: an overlay that mounts against a rect a later\n   * pass still corrects animates from the wrong place to the right one, which\n   * reads as the highlight sliding in from another row.\n   */\n  isMeasured: boolean;\n  sessionRef: RefObject<number>;\n  handlers: {\n    onMouseMove: (e: React.MouseEvent) => void;\n    onMouseEnter: () => void;\n    onMouseLeave: () => void;\n    /**\n     * Routes a click that lands between items (a gap, the padding, past the\n     * last row) to the highlighted item, so the highlight and the click agree:\n     * what is lit is what a click hits. A click inside an item is left to the\n     * item. Disabled items (`isItemDisabled`) are never activated.\n     */\n    onClick: (e: React.MouseEvent) => void;\n  };\n  registerItem: (index: number, element: HTMLElement | null) => void;\n  /**\n   * Invalidates the published rects and runs the hook's coalesced measurement\n   * pass again, holding `isMeasured` false until it settles. Reach for it when\n   * the rects may be wrong and showing an overlay against them would misplace\n   * it: a popup that stays mounted between opens keeps its items registered,\n   * so nothing else would notice that its rects were taken while it was\n   * hidden. Registration, item resize, and container resize already trigger\n   * a pass; do not call this on `children` changes.\n   */\n  remeasure: () => void;\n  /**\n   * Re-reads the rects synchronously, keeping `isMeasured` as it is. Only for\n   * layout that moves the rows under a visible overlay frame by frame (the\n   * accordion re-measures inside its height animation). Everything else\n   * wants `remeasure`, or nothing.\n   */\n  measureItems: () => void;\n}\n\nexport interface PickNearestInput {\n  axis: 'x' | 'y' | 'xy';\n  /** The pointer, in viewport coordinates. */\n  point: { x: number; y: number };\n  /** Item rects in the container's layout space (sparse: unregistered slots\n   *  are undefined). */\n  rects: readonly (ItemRect | undefined)[];\n  /** The container's bounding rect and live scroll / border offsets, which\n   *  map layout rects into the pointer's viewport space. */\n  containerRect: { left: number; top: number; width: number; height: number };\n  scroll: { x: number; y: number };\n  border: { x: number; y: number };\n  /** Layout size of the container, so a cumulative ancestor `transform:\n   *  scale` (a popup mid scale-in) can be factored out per axis. */\n  layoutSize: { width: number; height: number };\n  /** Skips an item without unregistering it. */\n  isDisabled?: (index: number) => boolean;\n}\n\n/**\n * The rule, as one pure function: an item the pointer is inside wins;\n * otherwise the item whose center is nearest does, so a pointer in a gap, in\n * the padding, or past the last row still lands. `y` and `x` measure one\n * coordinate; `xy` measures the straight line to each center. Ties keep the\n * first item. The hook calls this once per animation frame; the docs page\n * times it.\n */\nexport function pickNearest({\n  axis,\n  point,\n  rects,\n  containerRect,\n  scroll,\n  border,\n  layoutSize,\n  isDisabled,\n}: PickNearestInput): number | null {\n  const scaleX = layoutSize.width > 0 ? containerRect.width / layoutSize.width : 1;\n  const scaleY = layoutSize.height > 0 ? containerRect.height / layoutSize.height : 1;\n  let closestIndex: number | null = null;\n  let closestDistance = Infinity;\n  let containingIndex: number | null = null;\n\n  for (let index = 0; index < rects.length; index++) {\n    const r = rects[index];\n    if (!r) continue;\n    if (isDisabled?.(index)) continue;\n\n    if (axis === 'xy') {\n      const left = containerRect.left + (border.x + r.left - scroll.x) * scaleX;\n      const top = containerRect.top + (border.y + r.top - scroll.y) * scaleY;\n      const width = r.width * scaleX;\n      const height = r.height * scaleY;\n      if (point.x >= left && point.x <= left + width && point.y >= top && point.y <= top + height) {\n        containingIndex = index;\n      }\n      const distance = Math.hypot(point.x - (left + width / 2), point.y - (top + height / 2));\n      if (distance < closestDistance) {\n        closestDistance = distance;\n        closestIndex = index;\n      }\n      continue;\n    }\n\n    const horizontal = axis === 'x';\n    const mousePos = horizontal ? point.x : point.y;\n    const scale = horizontal ? scaleX : scaleY;\n    const itemStart =\n      (horizontal ? containerRect.left : containerRect.top) +\n      ((horizontal ? border.x : border.y) + (horizontal ? r.left : r.top) - (horizontal ? scroll.x : scroll.y)) * scale;\n    const itemSize = (horizontal ? r.width : r.height) * scale;\n    if (mousePos >= itemStart && mousePos <= itemStart + itemSize) {\n      containingIndex = index;\n    }\n    const distance = Math.abs(mousePos - (itemStart + itemSize / 2));\n    if (distance < closestDistance) {\n      closestDistance = distance;\n      closestIndex = index;\n    }\n  }\n\n  return containingIndex ?? closestIndex;\n}\n\n/** Set on the highlighted item (boolean attribute). */\nexport const ACTIVE_ATTR = 'data-fluid-hover-active';\n/** Set on the container: the highlighted index, or absent. */\nexport const ACTIVE_INDEX_ATTR = 'data-fluid-hover-active-index';\n\nconst ACTIVATOR_SELECTOR =\n  \"a[href], button, [role='menuitem'], [role='menuitemradio'], [role='menuitemcheckbox'], [role='option'], [role='radio'], [role='checkbox'], [role='tab'], [role='link'], [role='button']\";\n\n/**\n * The element a routed click should land on. A registered item is usually\n * the interactive row itself; when it is only a box around one (a sidebar\n * row around its button, a card around its link), the first control inside\n * is what a real click on the row would have reached.\n */\nfunction resolveActivator(element: HTMLElement): HTMLElement {\n  if (element.matches(ACTIVATOR_SELECTOR) || element.hasAttribute('tabindex')) {\n    return element;\n  }\n  return element.querySelector<HTMLElement>(ACTIVATOR_SELECTOR) ?? element;\n}\n\n/**\n * How many frames the coalesced remeasure retries while the registered items\n * still have no layout box. A popup can be in the DOM one frame before it is\n * laid out; retrying beats publishing zeroed rects, and the cap keeps a list\n * that stays hidden for good from spinning frames forever.\n */\nconst measurementAttempts = 3;\n\nexport function useFluidHover<T extends HTMLElement>(\n  containerRef: RefObject<T | null>,\n  options: UseFluidHoverOptions = {},\n): UseFluidHoverReturn {\n  const { axis = 'y', isItemDisabled, gapClick = true } = options;\n  const gapClickMaxDistance = typeof gapClick === 'object' ? (gapClick.maxDistance ?? Infinity) : Infinity;\n  const itemsRef = useRef(new Map<number, HTMLElement>());\n  const [activeIndex, setActiveIndex] = useState<number | null>(null);\n  // Mirrored for handlers that read it outside a render (the gap click).\n  const activeIndexRef = useRef<number | null>(null);\n  activeIndexRef.current = activeIndex;\n\n  // The state, in the DOM: `data-fluid-hover-active` on the highlighted item\n  // and `data-fluid-hover-active-index` on the container. Devtools shows it\n  // and a test asserts on it without waiting for a frame. React does not\n  // manage these attributes, so it never clobbers them.\n  useEffect(() => {\n    const container = containerRef.current;\n    if (activeIndex === null) container?.removeAttribute(ACTIVE_INDEX_ATTR);\n    else container?.setAttribute(ACTIVE_INDEX_ATTR, String(activeIndex));\n    const active = activeIndex === null ? undefined : itemsRef.current.get(activeIndex);\n    active?.setAttribute(ACTIVE_ATTR, '');\n    return () => {\n      active?.removeAttribute(ACTIVE_ATTR);\n      // A row that re-registered under this index while it was highlighted\n      // (a remount under a new key) was marked by registerItem, not by this\n      // effect: drop the mark from whatever element holds the index now.\n      // eslint-disable-next-line react-hooks/exhaustive-deps -- itemsRef is a registry Map, reading it at cleanup is the point\n      if (activeIndex !== null) itemsRef.current.get(activeIndex)?.removeAttribute(ACTIVE_ATTR);\n    };\n  }, [activeIndex, containerRef]);\n  const [itemRects, setItemRects] = useState<ItemRect[]>([]);\n  const [isMeasured, setIsMeasured] = useState(false);\n  const itemRectsRef = useRef<ItemRect[]>([]);\n  const sessionRef = useRef(0);\n  const rafIdRef = useRef<number | null>(null);\n  const remeasureRafIdRef = useRef<number | null>(null);\n\n  /**\n   * Publishes a rect for every registered item. Returns false when the\n   * measurement could not be completed (no container, or an item without a\n   * layout box) — nothing is published in that case, so the last complete\n   * measurement stands instead of being overwritten with zeroes.\n   */\n  const runMeasurement = useCallback(() => {\n    const container = containerRef.current;\n    if (!container) return false;\n    const rects: ItemRect[] = [];\n    let everyItemHasLayout = true;\n    itemsRef.current.forEach((element, index) => {\n      // An element inside a display:none / not-yet-laid-out popup has no\n      // offsetParent and reports every offset as 0. Publishing that would pin\n      // overlays to the top of the list, so treat the whole pass as\n      // incomplete. A boxless element is the only case: `position: fixed`\n      // items also have no offsetParent but do have a size.\n      const hasLayoutBox = element.offsetParent !== null || element.offsetWidth > 0 || element.offsetHeight > 0;\n      if (!hasLayoutBox) {\n        everyItemHasLayout = false;\n        return;\n      }\n      // Use offset* instead of getBoundingClientRect so measurements are\n      // unaffected by CSS transforms (e.g. scaleY animation on the parent\n      // motion.div). offsetTop/offsetLeft are layout values relative to the\n      // offsetParent (the scroll container), matching the coordinate space\n      // used by `position: absolute` children. Items nested inside positioned\n      // descendants of the container (a sidebar sub-menu's rows live inside a\n      // positioned row) accumulate those ancestors' offsets, so every rect\n      // lands in the container's own coordinate space; for a flat list the\n      // loop never runs and this is exactly the plain offsetTop/offsetLeft.\n      let top = element.offsetTop;\n      let left = element.offsetLeft;\n      let ancestor = element.offsetParent as HTMLElement | null;\n      while (ancestor && ancestor !== container && container.contains(ancestor)) {\n        top += ancestor.offsetTop + ancestor.clientTop;\n        left += ancestor.offsetLeft + ancestor.clientLeft;\n        ancestor = ancestor.offsetParent as HTMLElement | null;\n      }\n      rects[index] = {\n        top,\n        height: element.offsetHeight,\n        left,\n        width: element.offsetWidth,\n      };\n    });\n    if (!everyItemHasLayout) return false;\n    // Skip the state update when nothing moved (a cheap top/left/width/height\n    // compare) so redundant remeasures don't churn re-renders.\n    const prev = itemRectsRef.current;\n    let changed = prev.length !== rects.length;\n    for (let i = 0; !changed && i < rects.length; i++) {\n      const p = prev[i];\n      const r = rects[i];\n      if (p === r) continue; // both undefined (sparse slot)\n      changed = !p || !r || p.top !== r.top || p.left !== r.left || p.width !== r.width || p.height !== r.height;\n    }\n    if (changed) {\n      itemRectsRef.current = rects;\n      setItemRects(rects);\n    }\n    return true;\n  }, [containerRef]);\n\n  const measureItems = useCallback(() => {\n    runMeasurement();\n  }, [runMeasurement]);\n\n  /**\n   * The hook's single measurement pass: coalesces every trigger (item\n   * registration, container resize) into one remeasure on the next frame and\n   * is the only place readiness is reported, so `isMeasured` can never turn\n   * true while another pass is still queued.\n   */\n  const scheduleMeasurement = useCallback(\n    (attemptsLeft: number) => {\n      if (remeasureRafIdRef.current !== null) {\n        cancelAnimationFrame(remeasureRafIdRef.current);\n      }\n      remeasureRafIdRef.current = requestAnimationFrame(() => {\n        remeasureRafIdRef.current = null;\n        if (runMeasurement()) {\n          setIsMeasured(true);\n        } else if (attemptsLeft > 1) {\n          scheduleMeasurement(attemptsLeft - 1);\n        }\n      });\n    },\n    [runMeasurement],\n  );\n\n  const remeasure = useCallback(() => {\n    // Readiness drops first: until the pass below settles, the published rects\n    // may not describe what is on screen, and an overlay positioned from them\n    // would be corrected after mounting — which animates as a slide.\n    setIsMeasured(false);\n    scheduleMeasurement(measurementAttempts);\n  }, [scheduleMeasurement]);\n\n  // Observes the registered items themselves (not just the container): rows\n  // that change size in place — e.g. the site-wide size step flipping while a\n  // selection background is up — must invalidate the published rects even when\n  // the container the effect below captured has since been remounted and the\n  // ref points at a different element than the one being observed.\n  const itemRoRef = useRef<ResizeObserver | null>(null);\n  const getItemRo = useCallback(() => {\n    if (itemRoRef.current === null && typeof ResizeObserver !== 'undefined') {\n      itemRoRef.current = new ResizeObserver(() => scheduleMeasurement(measurementAttempts));\n    }\n    return itemRoRef.current;\n  }, [scheduleMeasurement]);\n\n  const registerItem = useCallback(\n    (index: number, element: HTMLElement | null) => {\n      if (element) {\n        itemsRef.current.set(index, element);\n        getItemRo()?.observe(element);\n        if (index === activeIndexRef.current) element.setAttribute(ACTIVE_ATTR, '');\n      } else {\n        const previous = itemsRef.current.get(index);\n        if (previous) itemRoRef.current?.unobserve(previous);\n        // The mark leaves with the element: a row that only moved to another\n        // index (a filtering list re-ordering) must not carry it there.\n        previous?.removeAttribute(ACTIVE_ATTR);\n        itemsRef.current.delete(index);\n        // The highlighted row is gone: nothing should stay lit or receive a\n        // routed click until the pointer picks again. Decided when the\n        // update applies, after this commit's registrations, so a row that\n        // only moved index hands the highlight to the row now under it.\n        if (index === activeIndexRef.current) {\n          setActiveIndex(current => (current === index && !itemsRef.current.has(index) ? null : current));\n        }\n      }\n      // Coalesce rapid register/unregister calls (e.g. when an AnimatePresence\n      // remounts a list of rows) into a single remeasure on the next frame,\n      // so consumers don't have to manually call measureItems after the\n      // container's children swap.\n      remeasure();\n    },\n    [remeasure, getItemRo],\n  );\n\n  const handleMouseMove = useCallback(\n    (e: React.MouseEvent) => {\n      const mouseX = e.clientX;\n      const mouseY = e.clientY;\n\n      if (rafIdRef.current !== null) {\n        cancelAnimationFrame(rafIdRef.current);\n      }\n\n      rafIdRef.current = requestAnimationFrame(() => {\n        rafIdRef.current = null;\n        const container = containerRef.current;\n        if (!container) return;\n        setActiveIndex(\n          pickNearest({\n            axis,\n            point: { x: mouseX, y: mouseY },\n            rects: itemRectsRef.current,\n            containerRect: container.getBoundingClientRect(),\n            scroll: { x: container.scrollLeft, y: container.scrollTop },\n            border: { x: container.clientLeft, y: container.clientTop },\n            layoutSize: { width: container.offsetWidth, height: container.offsetHeight },\n            isDisabled: isItemDisabled\n              ? index => {\n                  const el = itemsRef.current.get(index);\n                  return !!el && isItemDisabled(el);\n                }\n              : undefined,\n          }),\n        );\n      });\n    },\n    [axis, containerRef, isItemDisabled],\n  );\n\n  const handleMouseEnter = useCallback(() => {\n    sessionRef.current += 1;\n  }, []);\n\n  const handleMouseLeave = useCallback(() => {\n    if (rafIdRef.current !== null) {\n      cancelAnimationFrame(rafIdRef.current);\n      rafIdRef.current = null;\n    }\n    setActiveIndex(null);\n  }, []);\n\n  const handleClick = useCallback(\n    (e: React.MouseEvent) => {\n      const target = e.target as Node | null;\n      if (!target) return;\n      // Inside an item: the item owns the click.\n      for (const element of itemsRef.current.values()) {\n        if (element.contains(target)) return;\n      }\n      // A row that unmounted while its own click was still bubbling (a pick\n      // whose primitive re-renders the list synchronously, like a \"create\"\n      // row that becomes a real item) already landed; it is not a gap.\n      if (!target.isConnected) return;\n      // A control that sits between the rows (a search field at the top of\n      // a menu, a footer button) keeps its own click too.\n      const control = (target as Element).closest?.(\n        \"input, textarea, select, button, a, summary, [contenteditable], [role='textbox'], [role='searchbox'], [role='button']\",\n      );\n      if (control) return;\n      if (gapClick === false) return;\n      const index = activeIndexRef.current;\n      if (index === null) return;\n      const element = itemsRef.current.get(index);\n      if (!element || isItemDisabled?.(element)) return;\n      if (gapClickMaxDistance !== Infinity) {\n        const r = element.getBoundingClientRect();\n        const dx = Math.max(r.left - e.clientX, 0, e.clientX - r.right);\n        const dy = Math.max(r.top - e.clientY, 0, e.clientY - r.bottom);\n        if (Math.hypot(dx, dy) > gapClickMaxDistance) return;\n      }\n      // A real DOM click on the item, so its own handlers (and the primitive\n      // wrapping it, if any) run exactly as if the pointer had been inside.\n      resolveActivator(element).click();\n    },\n    [isItemDisabled, gapClick, gapClickMaxDistance],\n  );\n\n  // Remeasure when the container resizes — a reflow moves items even though\n  // the registered set is unchanged, which would otherwise leave itemRects\n  // stale. Coalesced through the same rAF as register/unregister. Readiness is\n  // deliberately not dropped: the item set is unchanged, so the published rects\n  // stay usable, and hiding overlays on every reflow would flicker them.\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container || typeof ResizeObserver === 'undefined') return;\n    const ro = new ResizeObserver(() => scheduleMeasurement(measurementAttempts));\n    ro.observe(container);\n    return () => ro.disconnect();\n  }, [containerRef, scheduleMeasurement]);\n\n  // Clean up rAF and the item observer on unmount\n  useEffect(() => {\n    return () => {\n      if (rafIdRef.current !== null) {\n        cancelAnimationFrame(rafIdRef.current);\n      }\n      if (remeasureRafIdRef.current !== null) {\n        cancelAnimationFrame(remeasureRafIdRef.current);\n      }\n      itemRoRef.current?.disconnect();\n      itemRoRef.current = null;\n    };\n  }, []);\n\n  return {\n    activeIndex,\n    setActiveIndex,\n    itemRects,\n    isMeasured,\n    sessionRef,\n    handlers: {\n      onMouseMove: handleMouseMove,\n      onMouseEnter: handleMouseEnter,\n      onMouseLeave: handleMouseLeave,\n      onClick: handleClick,\n    },\n    registerItem,\n    remeasure,\n    measureItems,\n  };\n}\n\n/**\n * Registers an item's element with its list for as long as it is mounted.\n * The one way rows join a list: pass the hook's `registerItem` (or the copy\n * a context hands down), the row's index, and its ref. Either may be\n * missing for a row rendered outside a list (a standalone card, an accordion\n * item that is not grouped); then nothing is registered.\n */\nexport function useRegisterFluidHoverItem(\n  registerItem: ((index: number, element: HTMLElement | null) => void) | undefined,\n  index: number | undefined,\n  ref: RefObject<HTMLElement | null>,\n) {\n  useEffect(() => {\n    if (!registerItem || index === undefined) return;\n    registerItem(index, ref.current);\n    return () => registerItem(index, null);\n  }, [index, registerItem, ref]);\n}\n"],"names":["distance","element"],"mappings":"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"}

package/dist/hooks/use-local-storage-state.cjs.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const React = require('react');
+const v4 = require('zod/v4');
 
 function useLocalStorageState({
   initialKey,
@@ -30,6 +31,54 @@ function useLocalStorageState({
   }, [storageKey, value, serialize]);
   return [value, setValue];
 }
+const EMPTY_ENTRY = { value: void 0, expired: false };
+const toMs = (expiresAt) => expiresAt instanceof Date ? expiresAt.getTime() : expiresAt;
+const removeStoredItem = (key) => {
+  try {
+    localStorage.removeItem(key);
+  } catch {
+  }
+};
+function useExpiringLocalStorageState({
+  key,
+  expiresAt,
+  schema,
+  now = Date.now
+}) {
+  const [storageKey] = React.useState(key);
+  const [entry, setEntry] = React.useState(() => {
+    try {
+      const stored = localStorage.getItem(storageKey);
+      if (stored === null) return EMPTY_ENTRY;
+      const parsed = v4.z.object({ value: schema, expiresAt: v4.z.number() }).safeParse(JSON.parse(stored));
+      if (!parsed.success) return EMPTY_ENTRY;
+      if (parsed.data.expiresAt <= now()) {
+        removeStoredItem(storageKey);
+        return { ...EMPTY_ENTRY, expired: true };
+      }
+      return { value: parsed.data.value, expired: false };
+    } catch {
+      return EMPTY_ENTRY;
+    }
+  });
+  const setValue = React.useCallback(
+    (value) => {
+      const expiresAtMs = toMs(expiresAt);
+      try {
+        localStorage.setItem(storageKey, JSON.stringify({ value, expiresAt: expiresAtMs }));
+      } catch {
+      }
+      setEntry({ value, expired: false });
+    },
+    [storageKey, expiresAt]
+  );
+  const clear = React.useCallback(() => {
+    removeStoredItem(storageKey);
+    setEntry(EMPTY_ENTRY);
+  }, [storageKey]);
+  return { value: entry.value, expired: entry.expired, setValue, clear };
+}
 
+exports.useExpiringLocalStorageState = useExpiringLocalStorageState;
 exports.useLocalStorageState = useLocalStorageState;
 //# sourceMappingURL=use-local-storage-state.cjs.js.map

package/dist/hooks/use-local-storage-state.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-local-storage-state.cjs.js","sources":["../../src/hooks/use-local-storage-state.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from 'react';\nimport { useEffect, useState } from 'react';\nimport type { z } from 'zod/v4';\n\ninterface LocalStorageStateOptions<T> {\n  initialKey: string;\n  defaultValue: T;\n  schema: z.ZodType<T>;\n  serialize?: (value: T) => string;\n}\n\n// Like useState, initialization happens once. Remount the consumer when its storage key changes.\nexport function useLocalStorageState<T>({\n  initialKey,\n  defaultValue,\n  schema,\n  serialize = JSON.stringify,\n}: LocalStorageStateOptions<T>): [T, Dispatch<SetStateAction<T>>] {\n  const [storageKey] = useState(initialKey);\n  const [value, setValue] = useState<T>(() => {\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored !== null) {\n        const parsed = schema.safeParse(JSON.parse(stored));\n        if (parsed.success) return parsed.data;\n      }\n    } catch {\n      // Invalid JSON or unavailable browser storage falls back to the initial value.\n    }\n    return defaultValue;\n  });\n\n  useEffect(() => {\n    try {\n      localStorage.setItem(storageKey, serialize(value));\n    } catch {\n      // Keep in-memory state usable when storage is unavailable or full.\n    }\n  }, [storageKey, value, serialize]);\n\n  return [value, setValue];\n}\n"],"names":["useState","useEffect"],"mappings":";;;;;;AAYO,SAAS,oBAAA,CAAwB;AAAA,EACtC,UAAA;AAAA,EACA,YAAA;AAAA,EACA,MAAA;AAAA,EACA,YAAY,IAAA,CAAK;AACnB,CAAA,EAAkE;AAChE,EAAA,MAAM,CAAC,UAAU,CAAA,GAAIA,cAAA,CAAS,UAAU,CAAA;AACxC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAY,MAAM;AAC1C,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,YAAA,CAAa,OAAA,CAAQ,UAAU,CAAA;AAC9C,MAAA,IAAI,WAAW,IAAA,EAAM;AACnB,QAAA,MAAM,SAAS,MAAA,CAAO,SAAA,CAAU,IAAA,CAAK,KAAA,CAAM,MAAM,CAAC,CAAA;AAClD,QAAA,IAAI,MAAA,CAAO,OAAA,EAAS,OAAO,MAAA,CAAO,IAAA;AAAA,MACpC;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AACA,IAAA,OAAO,YAAA;AAAA,EACT,CAAC,CAAA;AAED,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI;AACF,MAAA,YAAA,CAAa,OAAA,CAAQ,UAAA,EAAY,SAAA,CAAU,KAAK,CAAC,CAAA;AAAA,IACnD,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA,EAAG,CAAC,UAAA,EAAY,KAAA,EAAO,SAAS,CAAC,CAAA;AAEjC,EAAA,OAAO,CAAC,OAAO,QAAQ,CAAA;AACzB;;;;"}
+{"version":3,"file":"use-local-storage-state.cjs.js","sources":["../../src/hooks/use-local-storage-state.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from 'react';\nimport { useCallback, useEffect, useState } from 'react';\nimport { z } from 'zod/v4';\n\ninterface LocalStorageStateOptions<T> {\n  initialKey: string;\n  defaultValue: T;\n  schema: z.ZodType<T>;\n  serialize?: (value: T) => string;\n}\n\n// Like useState, initialization happens once. Remount the consumer when its storage key changes.\nexport function useLocalStorageState<T>({\n  initialKey,\n  defaultValue,\n  schema,\n  serialize = JSON.stringify,\n}: LocalStorageStateOptions<T>): [T, Dispatch<SetStateAction<T>>] {\n  const [storageKey] = useState(initialKey);\n  const [value, setValue] = useState<T>(() => {\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored !== null) {\n        const parsed = schema.safeParse(JSON.parse(stored));\n        if (parsed.success) return parsed.data;\n      }\n    } catch {\n      // Invalid JSON or unavailable browser storage falls back to the initial value.\n    }\n    return defaultValue;\n  });\n\n  useEffect(() => {\n    try {\n      localStorage.setItem(storageKey, serialize(value));\n    } catch {\n      // Keep in-memory state usable when storage is unavailable or full.\n    }\n  }, [storageKey, value, serialize]);\n\n  return [value, setValue];\n}\n\ninterface ExpiringLocalStorageStateOptions<T> {\n  key: string;\n  /** Absolute expiration applied to values written through `setValue`. */\n  expiresAt: Date | number;\n  schema: z.ZodType<T>;\n  now?: () => number;\n}\n\ninterface ExpiringLocalStorageState<T> {\n  /** `undefined` when nothing is stored or the stored entry has expired. */\n  value: T | undefined;\n  /** `true` when an entry existed but its expiration date has passed. */\n  expired: boolean;\n  setValue: (value: T) => void;\n  clear: () => void;\n}\n\ninterface ExpiringEntry<T> {\n  value: T | undefined;\n  expired: boolean;\n}\n\nconst EMPTY_ENTRY = { value: undefined, expired: false };\n\nconst toMs = (expiresAt: Date | number) => (expiresAt instanceof Date ? expiresAt.getTime() : expiresAt);\n\nconst removeStoredItem = (key: string) => {\n  try {\n    localStorage.removeItem(key);\n  } catch {\n    // Storage may be unavailable; the in-memory state is still cleared.\n  }\n};\n\n// Stores `{ value, expiresAt }` under `key`. Expiration is only checked when the key is read\n// (at mount); an expired entry is removed and reported as `expired`. Like useState,\n// initialization happens once. Remount the consumer when its storage key changes.\nexport function useExpiringLocalStorageState<T>({\n  key,\n  expiresAt,\n  schema,\n  now = Date.now,\n}: ExpiringLocalStorageStateOptions<T>): ExpiringLocalStorageState<T> {\n  const [storageKey] = useState(key);\n  const [entry, setEntry] = useState<ExpiringEntry<T>>(() => {\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored === null) return EMPTY_ENTRY;\n      const parsed = z.object({ value: schema, expiresAt: z.number() }).safeParse(JSON.parse(stored));\n      if (!parsed.success) return EMPTY_ENTRY;\n      if (parsed.data.expiresAt <= now()) {\n        removeStoredItem(storageKey);\n        return { ...EMPTY_ENTRY, expired: true };\n      }\n      return { value: parsed.data.value, expired: false };\n    } catch {\n      // Invalid JSON or unavailable browser storage behaves like an empty entry.\n      return EMPTY_ENTRY;\n    }\n  });\n\n  const setValue = useCallback(\n    (value: T) => {\n      const expiresAtMs = toMs(expiresAt);\n      try {\n        localStorage.setItem(storageKey, JSON.stringify({ value, expiresAt: expiresAtMs }));\n      } catch {\n        // Keep in-memory state usable when storage is unavailable or full.\n      }\n      setEntry({ value, expired: false });\n    },\n    [storageKey, expiresAt],\n  );\n\n  const clear = useCallback(() => {\n    removeStoredItem(storageKey);\n    setEntry(EMPTY_ENTRY);\n  }, [storageKey]);\n\n  return { value: entry.value, expired: entry.expired, setValue, clear };\n}\n"],"names":["useState","useEffect","z","useCallback"],"mappings":"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"}

package/dist/hooks/use-local-storage-state.es.js

@@ -1,4 +1,5 @@
-import { useState, useEffect } from 'react';
+import { useState, useCallback, useEffect } from 'react';
+import { z } from 'zod/v4';
 
 function useLocalStorageState({
   initialKey,
@@ -26,6 +27,53 @@ function useLocalStorageState({
   }, [storageKey, value, serialize]);
   return [value, setValue];
 }
+const EMPTY_ENTRY = { value: void 0, expired: false };
+const toMs = (expiresAt) => expiresAt instanceof Date ? expiresAt.getTime() : expiresAt;
+const removeStoredItem = (key) => {
+  try {
+    localStorage.removeItem(key);
+  } catch {
+  }
+};
+function useExpiringLocalStorageState({
+  key,
+  expiresAt,
+  schema,
+  now = Date.now
+}) {
+  const [storageKey] = useState(key);
+  const [entry, setEntry] = useState(() => {
+    try {
+      const stored = localStorage.getItem(storageKey);
+      if (stored === null) return EMPTY_ENTRY;
+      const parsed = z.object({ value: schema, expiresAt: z.number() }).safeParse(JSON.parse(stored));
+      if (!parsed.success) return EMPTY_ENTRY;
+      if (parsed.data.expiresAt <= now()) {
+        removeStoredItem(storageKey);
+        return { ...EMPTY_ENTRY, expired: true };
+      }
+      return { value: parsed.data.value, expired: false };
+    } catch {
+      return EMPTY_ENTRY;
+    }
+  });
+  const setValue = useCallback(
+    (value) => {
+      const expiresAtMs = toMs(expiresAt);
+      try {
+        localStorage.setItem(storageKey, JSON.stringify({ value, expiresAt: expiresAtMs }));
+      } catch {
+      }
+      setEntry({ value, expired: false });
+    },
+    [storageKey, expiresAt]
+  );
+  const clear = useCallback(() => {
+    removeStoredItem(storageKey);
+    setEntry(EMPTY_ENTRY);
+  }, [storageKey]);
+  return { value: entry.value, expired: entry.expired, setValue, clear };
+}
 
-export { useLocalStorageState };
+export { useExpiringLocalStorageState, useLocalStorageState };
 //# sourceMappingURL=use-local-storage-state.es.js.map

package/dist/hooks/use-local-storage-state.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-local-storage-state.es.js","sources":["../../src/hooks/use-local-storage-state.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from 'react';\nimport { useEffect, useState } from 'react';\nimport type { z } from 'zod/v4';\n\ninterface LocalStorageStateOptions<T> {\n  initialKey: string;\n  defaultValue: T;\n  schema: z.ZodType<T>;\n  serialize?: (value: T) => string;\n}\n\n// Like useState, initialization happens once. Remount the consumer when its storage key changes.\nexport function useLocalStorageState<T>({\n  initialKey,\n  defaultValue,\n  schema,\n  serialize = JSON.stringify,\n}: LocalStorageStateOptions<T>): [T, Dispatch<SetStateAction<T>>] {\n  const [storageKey] = useState(initialKey);\n  const [value, setValue] = useState<T>(() => {\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored !== null) {\n        const parsed = schema.safeParse(JSON.parse(stored));\n        if (parsed.success) return parsed.data;\n      }\n    } catch {\n      // Invalid JSON or unavailable browser storage falls back to the initial value.\n    }\n    return defaultValue;\n  });\n\n  useEffect(() => {\n    try {\n      localStorage.setItem(storageKey, serialize(value));\n    } catch {\n      // Keep in-memory state usable when storage is unavailable or full.\n    }\n  }, [storageKey, value, serialize]);\n\n  return [value, setValue];\n}\n"],"names":[],"mappings":";;AAYO,SAAS,oBAAA,CAAwB;AAAA,EACtC,UAAA;AAAA,EACA,YAAA;AAAA,EACA,MAAA;AAAA,EACA,YAAY,IAAA,CAAK;AACnB,CAAA,EAAkE;AAChE,EAAA,MAAM,CAAC,UAAU,CAAA,GAAI,QAAA,CAAS,UAAU,CAAA;AACxC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAY,MAAM;AAC1C,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,YAAA,CAAa,OAAA,CAAQ,UAAU,CAAA;AAC9C,MAAA,IAAI,WAAW,IAAA,EAAM;AACnB,QAAA,MAAM,SAAS,MAAA,CAAO,SAAA,CAAU,IAAA,CAAK,KAAA,CAAM,MAAM,CAAC,CAAA;AAClD,QAAA,IAAI,MAAA,CAAO,OAAA,EAAS,OAAO,MAAA,CAAO,IAAA;AAAA,MACpC;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AACA,IAAA,OAAO,YAAA;AAAA,EACT,CAAC,CAAA;AAED,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI;AACF,MAAA,YAAA,CAAa,OAAA,CAAQ,UAAA,EAAY,SAAA,CAAU,KAAK,CAAC,CAAA;AAAA,IACnD,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA,EAAG,CAAC,UAAA,EAAY,KAAA,EAAO,SAAS,CAAC,CAAA;AAEjC,EAAA,OAAO,CAAC,OAAO,QAAQ,CAAA;AACzB;;;;"}
+{"version":3,"file":"use-local-storage-state.es.js","sources":["../../src/hooks/use-local-storage-state.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from 'react';\nimport { useCallback, useEffect, useState } from 'react';\nimport { z } from 'zod/v4';\n\ninterface LocalStorageStateOptions<T> {\n  initialKey: string;\n  defaultValue: T;\n  schema: z.ZodType<T>;\n  serialize?: (value: T) => string;\n}\n\n// Like useState, initialization happens once. Remount the consumer when its storage key changes.\nexport function useLocalStorageState<T>({\n  initialKey,\n  defaultValue,\n  schema,\n  serialize = JSON.stringify,\n}: LocalStorageStateOptions<T>): [T, Dispatch<SetStateAction<T>>] {\n  const [storageKey] = useState(initialKey);\n  const [value, setValue] = useState<T>(() => {\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored !== null) {\n        const parsed = schema.safeParse(JSON.parse(stored));\n        if (parsed.success) return parsed.data;\n      }\n    } catch {\n      // Invalid JSON or unavailable browser storage falls back to the initial value.\n    }\n    return defaultValue;\n  });\n\n  useEffect(() => {\n    try {\n      localStorage.setItem(storageKey, serialize(value));\n    } catch {\n      // Keep in-memory state usable when storage is unavailable or full.\n    }\n  }, [storageKey, value, serialize]);\n\n  return [value, setValue];\n}\n\ninterface ExpiringLocalStorageStateOptions<T> {\n  key: string;\n  /** Absolute expiration applied to values written through `setValue`. */\n  expiresAt: Date | number;\n  schema: z.ZodType<T>;\n  now?: () => number;\n}\n\ninterface ExpiringLocalStorageState<T> {\n  /** `undefined` when nothing is stored or the stored entry has expired. */\n  value: T | undefined;\n  /** `true` when an entry existed but its expiration date has passed. */\n  expired: boolean;\n  setValue: (value: T) => void;\n  clear: () => void;\n}\n\ninterface ExpiringEntry<T> {\n  value: T | undefined;\n  expired: boolean;\n}\n\nconst EMPTY_ENTRY = { value: undefined, expired: false };\n\nconst toMs = (expiresAt: Date | number) => (expiresAt instanceof Date ? expiresAt.getTime() : expiresAt);\n\nconst removeStoredItem = (key: string) => {\n  try {\n    localStorage.removeItem(key);\n  } catch {\n    // Storage may be unavailable; the in-memory state is still cleared.\n  }\n};\n\n// Stores `{ value, expiresAt }` under `key`. Expiration is only checked when the key is read\n// (at mount); an expired entry is removed and reported as `expired`. Like useState,\n// initialization happens once. Remount the consumer when its storage key changes.\nexport function useExpiringLocalStorageState<T>({\n  key,\n  expiresAt,\n  schema,\n  now = Date.now,\n}: ExpiringLocalStorageStateOptions<T>): ExpiringLocalStorageState<T> {\n  const [storageKey] = useState(key);\n  const [entry, setEntry] = useState<ExpiringEntry<T>>(() => {\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored === null) return EMPTY_ENTRY;\n      const parsed = z.object({ value: schema, expiresAt: z.number() }).safeParse(JSON.parse(stored));\n      if (!parsed.success) return EMPTY_ENTRY;\n      if (parsed.data.expiresAt <= now()) {\n        removeStoredItem(storageKey);\n        return { ...EMPTY_ENTRY, expired: true };\n      }\n      return { value: parsed.data.value, expired: false };\n    } catch {\n      // Invalid JSON or unavailable browser storage behaves like an empty entry.\n      return EMPTY_ENTRY;\n    }\n  });\n\n  const setValue = useCallback(\n    (value: T) => {\n      const expiresAtMs = toMs(expiresAt);\n      try {\n        localStorage.setItem(storageKey, JSON.stringify({ value, expiresAt: expiresAtMs }));\n      } catch {\n        // Keep in-memory state usable when storage is unavailable or full.\n      }\n      setEntry({ value, expired: false });\n    },\n    [storageKey, expiresAt],\n  );\n\n  const clear = useCallback(() => {\n    removeStoredItem(storageKey);\n    setEntry(EMPTY_ENTRY);\n  }, [storageKey]);\n\n  return { value: entry.value, expired: entry.expired, setValue, clear };\n}\n"],"names":[],"mappings":"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"}