@kosmeo-ui/react 0.1.0

package/dist/hooks/useDebouncedValue.js

@@ -0,0 +1,16 @@
+"use client";
+import { useEffect, useState } from "react";
+/**
+ * Returns `value` after it has remained unchanged for `delay` milliseconds.
+ * Resets the timer on every change.
+ */
+const useDebouncedValue = (value, delay) => {
+    const [debounced, setDebounced] = useState(value);
+    useEffect(() => {
+        const id = setTimeout(() => setDebounced(value), delay);
+        return () => clearTimeout(id);
+    }, [value, delay]);
+    return debounced;
+};
+export default useDebouncedValue;
+//# sourceMappingURL=useDebouncedValue.js.map

package/dist/hooks/useDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.js","sourceRoot":"","sources":["../../src/hooks/useDebouncedValue.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CAAI,KAAQ,EAAE,KAAa,EAAK,EAAE;IAC1D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnB,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/hooks/useFloatingPosition.d.ts

@@ -0,0 +1,32 @@
+import { RefObject } from "react";
+export type FloatingSide = "below" | "top" | "bottom" | "left" | "right";
+export interface FloatingPosition {
+    top: number;
+    left: number;
+    width: number;
+}
+interface UseFloatingPositionOptions {
+    isOpen: boolean;
+    /** Placement relative to the anchor. `below` matches anchor width (default). */
+    side?: FloatingSide;
+    /** Ref to the floating element — required for `top`/`bottom`/`left`/`right`. */
+    floatingRef?: RefObject<HTMLElement | null>;
+    /** Distance in px between anchor and floating element (ignored for `below`). */
+    offset?: number;
+    /** Clamp position inside the viewport. */
+    clampViewport?: boolean;
+    /** Padding from viewport edges when clamping. */
+    padding?: number;
+}
+/**
+ * Tracks the screen position of a floating element anchored to a trigger.
+ * Supports anchored-below dropdowns and side-positioned tooltips/popovers
+ * with optional viewport clamping. Updates on scroll/resize while `isOpen`.
+ */
+declare const useFloatingPosition: ({ isOpen, side, floatingRef, offset, clampViewport, padding, }: UseFloatingPositionOptions) => {
+    anchorRef: RefObject<HTMLDivElement | null>;
+    position: FloatingPosition | null;
+    update: () => void;
+};
+export default useFloatingPosition;
+//# sourceMappingURL=useFloatingPosition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFloatingPosition.d.ts","sourceRoot":"","sources":["../../src/hooks/useFloatingPosition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAA4C,MAAM,OAAO,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,0BAA0B;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,QAAA,MAAM,mBAAmB,GAAI,gEAO1B,0BAA0B;;;;CAqE5B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/hooks/useFloatingPosition.js

@@ -0,0 +1,69 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * Tracks the screen position of a floating element anchored to a trigger.
+ * Supports anchored-below dropdowns and side-positioned tooltips/popovers
+ * with optional viewport clamping. Updates on scroll/resize while `isOpen`.
+ */
+const useFloatingPosition = ({ isOpen, side = "below", floatingRef, offset = 0, clampViewport = false, padding = 8, }) => {
+    const anchorRef = useRef(null);
+    const [position, setPosition] = useState(null);
+    const update = useCallback(() => {
+        const anchor = anchorRef.current;
+        if (!anchor)
+            return;
+        const a = anchor.getBoundingClientRect();
+        const f = floatingRef?.current?.getBoundingClientRect();
+        let top = 0;
+        let left = 0;
+        if (side === "below") {
+            top = a.bottom;
+            left = a.left;
+        }
+        else {
+            if (!f)
+                return;
+            const centerX = a.left + (a.width - f.width) / 2;
+            const centerY = a.top + (a.height - f.height) / 2;
+            switch (side) {
+                case "top":
+                    top = a.top - f.height - offset;
+                    left = centerX;
+                    break;
+                case "bottom":
+                    top = a.bottom + offset;
+                    left = centerX;
+                    break;
+                case "left":
+                    top = centerY;
+                    left = a.left - f.width - offset;
+                    break;
+                case "right":
+                    top = centerY;
+                    left = a.right + offset;
+                    break;
+            }
+        }
+        if (clampViewport && f) {
+            left = Math.max(padding, Math.min(left, window.innerWidth - f.width - padding));
+            top = Math.max(padding, Math.min(top, window.innerHeight - f.height - padding));
+        }
+        setPosition({ top, left, width: a.width });
+    }, [side, offset, clampViewport, padding, floatingRef]);
+    useEffect(() => {
+        if (!isOpen) {
+            setPosition(null);
+            return;
+        }
+        update();
+        window.addEventListener("scroll", update, true);
+        window.addEventListener("resize", update);
+        return () => {
+            window.removeEventListener("scroll", update, true);
+            window.removeEventListener("resize", update);
+        };
+    }, [isOpen, update]);
+    return { anchorRef, position, update };
+};
+export default useFloatingPosition;
+//# sourceMappingURL=useFloatingPosition.js.map

package/dist/hooks/useFloatingPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFloatingPosition.js","sourceRoot":"","sources":["../../src/hooks/useFloatingPosition.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useFocusTrap.d.ts

@@ -0,0 +1,9 @@
+import { RefObject } from "react";
+/**
+ * Traps Tab focus inside `containerRef` while `enabled`. Focuses the first
+ * focusable element on activation and restores the previously focused element
+ * on deactivation.
+ */
+declare const useFocusTrap: (containerRef: RefObject<HTMLElement | null>, enabled: boolean) => void;
+export default useFocusTrap;
+//# sourceMappingURL=useFocusTrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAW7C;;;;GAIG;AACH,QAAA,MAAM,YAAY,GAChB,cAAc,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAC3C,SAAS,OAAO,SAiCjB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/useFocusTrap.js

@@ -0,0 +1,51 @@
+"use client";
+import { useEffect } from "react";
+const FOCUSABLE_SELECTOR = [
+    "button:not([disabled])",
+    "[href]",
+    "input:not([disabled])",
+    "select:not([disabled])",
+    "textarea:not([disabled])",
+    '[tabindex]:not([tabindex="-1"])',
+].join(",");
+/**
+ * Traps Tab focus inside `containerRef` while `enabled`. Focuses the first
+ * focusable element on activation and restores the previously focused element
+ * on deactivation.
+ */
+const useFocusTrap = (containerRef, enabled) => {
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const container = containerRef.current;
+        if (!container)
+            return;
+        const prevActive = document.activeElement;
+        const getFocusables = () => Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR));
+        getFocusables()[0]?.focus();
+        const handleKey = (e) => {
+            if (e.key !== "Tab")
+                return;
+            const list = getFocusables();
+            if (list.length === 0)
+                return;
+            const first = list[0];
+            const last = list[list.length - 1];
+            if (e.shiftKey && document.activeElement === first) {
+                e.preventDefault();
+                last.focus();
+            }
+            else if (!e.shiftKey && document.activeElement === last) {
+                e.preventDefault();
+                first.focus();
+            }
+        };
+        document.addEventListener("keydown", handleKey);
+        return () => {
+            document.removeEventListener("keydown", handleKey);
+            prevActive?.focus?.();
+        };
+    }, [enabled, containerRef]);
+};
+export default useFocusTrap;
+//# sourceMappingURL=useFocusTrap.js.map

package/dist/hooks/useFocusTrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusTrap.js","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAa,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7C,MAAM,kBAAkB,GAAG;IACzB,wBAAwB;IACxB,QAAQ;IACR,uBAAuB;IACvB,wBAAwB;IACxB,0BAA0B;IAC1B,iCAAiC;CAClC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ;;;;GAIG;AACH,MAAM,YAAY,GAAG,CACnB,YAA2C,EAC3C,OAAgB,EAChB,EAAE;IACF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAmC,CAAC;QAChE,MAAM,aAAa,GAAG,GAAG,EAAE,CACzB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAc,kBAAkB,CAAC,CAAC,CAAC;QAE1E,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QAE5B,MAAM,SAAS,GAAG,CAAC,CAAgB,EAAE,EAAE;YACrC,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK;gBAAE,OAAO;YAC5B,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;gBACnD,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;iBAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;gBAC1D,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACnD,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/useInfinite.d.ts

@@ -0,0 +1,28 @@
+import { AxiosInstance } from "axios";
+interface UseInfiniteOptions {
+    axiosInstance: AxiosInstance;
+    /** The API endpoint to fetch from (e.g., "/buckets/my-bucket/objects") */
+    endpoint: string;
+    /** The query key for React Query caching */
+    queryKey: string;
+    /** Organization ID to scope cache keys (prevents stale cross-org data) */
+    orgId?: string | null;
+    /** Initial limit (default: 10) */
+    initialLimit?: number;
+    /** Whether or not the query should be enabled */
+    enabled?: boolean;
+}
+export interface UseInfiniteReturn<T> {
+    data: T[];
+    hasMore: boolean;
+    isLoading: boolean;
+    isReloading: boolean;
+    total: number;
+    onQueryChange: (queryString: string) => void;
+    reload: () => void;
+}
+declare const useInfinite: <T extends {
+    id: number | string;
+}>(options: UseInfiniteOptions) => UseInfiniteReturn<T>;
+export default useInfinite;
+//# sourceMappingURL=useInfinite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useInfinite.d.ts","sourceRoot":"","sources":["../../src/hooks/useInfinite.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAQtC,UAAU,kBAAkB;IAC1B,aAAa,EAAE,aAAa,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,QAAA,MAAM,WAAW,GAAI,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACpD,SAAS,kBAAkB,KAC1B,iBAAiB,CAAC,CAAC,CA8GrB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/hooks/useInfinite.js

@@ -0,0 +1,95 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useQuery } from "@tanstack/react-query";
+const useInfinite = (options) => {
+    const { axiosInstance, endpoint, queryKey, orgId, initialLimit = 10, } = options;
+    const [queryString, setQueryString] = useState(`limit=${initialLimit}&offset=0`);
+    const [allData, setAllData] = useState([]);
+    const [reloadKey, setReloadKey] = useState(0);
+    const isNextPageRef = useRef(false);
+    const lastQueryStringRef = useRef(queryString);
+    const queryStringRef = useRef(queryString);
+    // Keep ref in sync with state
+    queryStringRef.current = queryString;
+    const queryFn = async () => {
+        const res = await axiosInstance.get(`${endpoint}?${queryString}`);
+        return res.data;
+    };
+    const query = useQuery({
+        queryKey: [`${queryKey}-infinite`, orgId ?? null, queryString, reloadKey],
+        queryFn,
+        staleTime: 0,
+        gcTime: 0,
+    });
+    // Handle query change from InfiniteScroll
+    const handleQueryChange = useCallback((newQueryString) => {
+        // Prevent unnecessary updates if query string hasn't changed
+        if (newQueryString === lastQueryStringRef.current)
+            return;
+        lastQueryStringRef.current = newQueryString;
+        const params = new URLSearchParams(newQueryString);
+        const offset = parseInt(params.get("offset") || "0", 10);
+        if (offset === 0) {
+            // Fresh fetch - reset data only if we have data
+            setAllData((prev) => (prev.length > 0 ? [] : prev));
+            isNextPageRef.current = false;
+        }
+        else {
+            // Next page fetch
+            isNextPageRef.current = true;
+        }
+        setQueryString(newQueryString);
+    }, []);
+    // Reload from the beginning (reset offset to 0)
+    const reload = useCallback(() => {
+        const params = new URLSearchParams(queryStringRef.current);
+        params.set("offset", "0");
+        const newQueryString = params.toString();
+        // Force update even if query string is the same
+        lastQueryStringRef.current = "";
+        isNextPageRef.current = false;
+        setAllData([]);
+        setReloadKey((k) => k + 1);
+        setQueryString(newQueryString);
+    }, []);
+    // Merge data when query succeeds
+    useEffect(() => {
+        if (!query.data)
+            return;
+        const newData = query.data.data;
+        if (!newData)
+            return;
+        if (isNextPageRef.current) {
+            // Append new data for next page
+            setAllData((prev) => {
+                const existingIds = new Set(prev.map((item) => item.id));
+                const uniqueNewData = newData.filter((item) => !existingIds.has(item.id));
+                if (uniqueNewData.length === 0)
+                    return prev;
+                return [...prev, ...uniqueNewData];
+            });
+            isNextPageRef.current = false;
+        }
+        else {
+            // Replace data for fresh fetch - only update if different
+            setAllData((prev) => {
+                if (prev.length === newData.length &&
+                    prev.every((item, i) => item.id === newData[i]?.id)) {
+                    return prev;
+                }
+                return newData;
+            });
+        }
+    }, [query.data]);
+    return {
+        data: allData,
+        hasMore: query.data?.hasMore ?? true,
+        isLoading: query.isLoading,
+        isReloading: query.isFetching && allData.length > 0,
+        total: query.data?.total ?? 0,
+        onQueryChange: handleQueryChange,
+        reload,
+    };
+};
+export default useInfinite;
+//# sourceMappingURL=useInfinite.js.map

package/dist/hooks/useInfinite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfinite.js","sourceRoot":"","sources":["../../src/hooks/useInfinite.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useInfiniteArchivableCursor.d.ts

@@ -0,0 +1,31 @@
+import type { UseInfiniteReturn } from "./useInfinite.js";
+import type { AxiosInstance } from "axios";
+interface UseInfiniteArchivableCursorOptions {
+    axiosInstance: AxiosInstance;
+    /** API endpoint to fetch from (e.g., "/v1/projects"). */
+    endpoint: string;
+    /**
+     * Query key stem. A string keys the list under `${queryKey}-infinite`; an
+     * array keys it under `[...queryKey, "infinite"]`, for apps that invalidate
+     * by a multi-segment prefix.
+     */
+    queryKey: string | (string | null)[];
+    /** Organization ID to scope cache keys (prevents stale cross-org data). */
+    orgId?: string | null;
+    /** Initial page size (default: 10). */
+    initialLimit?: number;
+    enabled?: boolean;
+}
+/**
+ * Cursor-paginated list hook for archivable resources.
+ * It behaves like `useInfiniteCursor` — same `-infinite` query
+ * key and `UseInfiniteReturn` shape, so existing prefix-matched invalidations
+ * keep working — but lifts the "Archived" menu filter out of the generic
+ * `filter[...]` bag: InfiniteScroll emits it as `filter[includeArchived]`,
+ * whereas the backend reads a top-level `includeArchived` flag.
+ */
+declare const useInfiniteArchivableCursor: <T extends {
+    id: number | string;
+}>(options: UseInfiniteArchivableCursorOptions) => UseInfiniteReturn<T>;
+export default useInfiniteArchivableCursor;
+//# sourceMappingURL=useInfiniteArchivableCursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteArchivableCursor.d.ts","sourceRoot":"","sources":["../../src/hooks/useInfiniteArchivableCursor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAS3C,UAAU,kCAAkC;IAC1C,aAAa,EAAE,aAAa,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IACrC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,2BAA2B,GAAI,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACpE,SAAS,kCAAkC,KAC1C,iBAAiB,CAAC,CAAC,CAmGrB,CAAC;AAEF,eAAe,2BAA2B,CAAC"}

package/dist/hooks/useInfiniteArchivableCursor.js

@@ -0,0 +1,95 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useInfiniteQuery } from "@tanstack/react-query";
+/**
+ * Cursor-paginated list hook for archivable resources.
+ * It behaves like `useInfiniteCursor` — same `-infinite` query
+ * key and `UseInfiniteReturn` shape, so existing prefix-matched invalidations
+ * keep working — but lifts the "Archived" menu filter out of the generic
+ * `filter[...]` bag: InfiniteScroll emits it as `filter[includeArchived]`,
+ * whereas the backend reads a top-level `includeArchived` flag.
+ */
+const useInfiniteArchivableCursor = (options) => {
+    const { axiosInstance, endpoint, queryKey, orgId, initialLimit = 10, enabled = true, } = options;
+    const [queryString, setQueryString] = useState(`limit=${initialLimit}`);
+    const lastQueryRef = useRef(queryString);
+    // An array stem nests "infinite" as its own segment so prefix invalidations
+    // like `["projects", projectId]` still match; a string keeps the legacy
+    // `${queryKey}-infinite` stem.
+    const infiniteKey = Array.isArray(queryKey)
+        ? [...queryKey, "infinite", orgId ?? null, queryString]
+        : [`${queryKey}-infinite`, orgId ?? null, queryString];
+    const query = useInfiniteQuery({
+        queryKey: infiniteKey,
+        enabled,
+        initialPageParam: undefined,
+        getNextPageParam: (last) => last.hasMore && last.nextCursor ? last.nextCursor : undefined,
+        queryFn: async ({ pageParam }) => {
+            const params = new URLSearchParams(queryString);
+            // Cursor mode never uses offset — strip it if a caller leaks one in.
+            params.delete("offset");
+            // The "Archived" menu filter arrives as `filter[includeArchived]`, but the
+            // backend reads it as a top-level flag (not a filter clause). Lift it out
+            // so the default — flag absent — excludes archived rows.
+            const archived = params.get("filter[includeArchived]");
+            params.delete("filter[includeArchived]");
+            params.delete("filter[includeArchived_op]");
+            if (archived === "true")
+                params.set("includeArchived", "true");
+            if (pageParam)
+                params.set("cursor", pageParam);
+            const res = await axiosInstance.get(`${endpoint}?${params.toString()}`);
+            return res.data;
+        },
+        staleTime: 0,
+        gcTime: 0,
+    });
+    const queryRef = useRef(query);
+    queryRef.current = query;
+    const onQueryChange = useCallback((newQueryString) => {
+        const params = new URLSearchParams(newQueryString);
+        params.delete("offset");
+        const normalized = params.toString();
+        // Same filter/sort? InfiniteScroll is asking for the next page. The offset
+        // value it passes is meaningless for cursor mode — just fetch the next page.
+        if (normalized === lastQueryRef.current) {
+            const q = queryRef.current;
+            if (q.hasNextPage && !q.isFetchingNextPage)
+                q.fetchNextPage();
+            return;
+        }
+        lastQueryRef.current = normalized;
+        setQueryString(normalized);
+    }, []);
+    const reload = useCallback(() => {
+        queryRef.current.refetch();
+    }, []);
+    const [allData, setAllData] = useState([]);
+    useEffect(() => {
+        const pages = query.data?.pages ?? [];
+        const flat = pages.flatMap((p) => p.data);
+        // Dedup defensively — composite cursors on merged proxies can yield repeats.
+        const seen = new Set();
+        const unique = [];
+        for (const item of flat) {
+            if (!seen.has(item.id)) {
+                seen.add(item.id);
+                unique.push(item);
+            }
+        }
+        setAllData(unique);
+    }, [query.data]);
+    const lastPage = query.data?.pages[query.data.pages.length - 1];
+    const hasMore = lastPage?.hasMore ?? query.hasNextPage ?? false;
+    return {
+        data: allData,
+        hasMore,
+        isLoading: query.isLoading,
+        isReloading: query.isRefetching && allData.length > 0,
+        total: 0,
+        onQueryChange,
+        reload,
+    };
+};
+export default useInfiniteArchivableCursor;
+//# sourceMappingURL=useInfiniteArchivableCursor.js.map

package/dist/hooks/useInfiniteArchivableCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteArchivableCursor.js","sourceRoot":"","sources":["../../src/hooks/useInfiniteArchivableCursor.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useInfiniteCursor.d.ts

@@ -0,0 +1,27 @@
+import type { UseInfiniteReturn } from "./useInfinite.js";
+import { AxiosInstance } from "axios";
+interface UseInfiniteCursorOptions {
+    axiosInstance: AxiosInstance;
+    /** API endpoint to fetch from (e.g., "/v1/projects"). */
+    endpoint: string;
+    /** Query key for React Query caching. */
+    queryKey: string;
+    /** Organization ID to scope cache keys (prevents stale cross-org data). */
+    orgId?: string | null;
+    /** Initial page size (default: 10). */
+    initialLimit?: number;
+    enabled?: boolean;
+}
+/**
+ * Cursor-paginated counterpart to `useInfinite`. Returns the same
+ * `UseInfiniteReturn` shape so it's a drop-in replacement for callers that
+ * have migrated their backend list endpoint to cursor pagination
+ * (`{ data, hasMore, limit, nextCursor }`).
+ *
+ * `total` is always 0 — cursor endpoints intentionally do not expose `COUNT(*)`.
+ */
+declare const useInfiniteCursor: <T extends {
+    id: number | string;
+}>(options: UseInfiniteCursorOptions) => UseInfiniteReturn<T>;
+export default useInfiniteCursor;
+//# sourceMappingURL=useInfiniteCursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteCursor.d.ts","sourceRoot":"","sources":["../../src/hooks/useInfiniteCursor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAStC,UAAU,wBAAwB;IAChC,aAAa,EAAE,aAAa,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,GAAI,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC1D,SAAS,wBAAwB,KAChC,iBAAiB,CAAC,CAAC,CAqFrB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/hooks/useInfiniteCursor.js

@@ -0,0 +1,81 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useInfiniteQuery } from "@tanstack/react-query";
+/**
+ * Cursor-paginated counterpart to `useInfinite`. Returns the same
+ * `UseInfiniteReturn` shape so it's a drop-in replacement for callers that
+ * have migrated their backend list endpoint to cursor pagination
+ * (`{ data, hasMore, limit, nextCursor }`).
+ *
+ * `total` is always 0 — cursor endpoints intentionally do not expose `COUNT(*)`.
+ */
+const useInfiniteCursor = (options) => {
+    const { axiosInstance, endpoint, queryKey, orgId, initialLimit = 10, enabled = true, } = options;
+    const [queryString, setQueryString] = useState(`limit=${initialLimit}`);
+    const lastQueryRef = useRef(queryString);
+    const query = useInfiniteQuery({
+        queryKey: [`${queryKey}-infinite`, orgId ?? null, queryString],
+        enabled,
+        initialPageParam: undefined,
+        getNextPageParam: (last) => last.hasMore && last.nextCursor ? last.nextCursor : undefined,
+        queryFn: async ({ pageParam }) => {
+            const params = new URLSearchParams(queryString);
+            // Cursor mode never uses offset — strip it if a caller leaks one in.
+            params.delete("offset");
+            if (pageParam)
+                params.set("cursor", pageParam);
+            const res = await axiosInstance.get(`${endpoint}?${params.toString()}`);
+            return res.data;
+        },
+        staleTime: 0,
+        gcTime: 0,
+    });
+    const queryRef = useRef(query);
+    queryRef.current = query;
+    const onQueryChange = useCallback((newQueryString) => {
+        const params = new URLSearchParams(newQueryString);
+        params.delete("offset");
+        const normalized = params.toString();
+        // Same filter/sort? InfiniteScroll is asking for the next page. The offset
+        // value it passes is meaningless for cursor mode — just trigger fetchNextPage.
+        if (normalized === lastQueryRef.current) {
+            const q = queryRef.current;
+            if (q.hasNextPage && !q.isFetchingNextPage)
+                q.fetchNextPage();
+            return;
+        }
+        lastQueryRef.current = normalized;
+        setQueryString(normalized);
+    }, []);
+    const reload = useCallback(() => {
+        queryRef.current.refetch();
+    }, []);
+    const [allData, setAllData] = useState([]);
+    useEffect(() => {
+        const pages = query.data?.pages ?? [];
+        const flat = pages.flatMap((p) => p.data);
+        // Dedup defensively — composite cursors on merged proxies can yield repeats.
+        const seen = new Set();
+        const unique = [];
+        for (const item of flat) {
+            if (!seen.has(item.id)) {
+                seen.add(item.id);
+                unique.push(item);
+            }
+        }
+        setAllData(unique);
+    }, [query.data]);
+    const lastPage = query.data?.pages[query.data.pages.length - 1];
+    const hasMore = lastPage?.hasMore ?? query.hasNextPage ?? false;
+    return {
+        data: allData,
+        hasMore,
+        isLoading: query.isLoading,
+        isReloading: query.isRefetching && allData.length > 0,
+        total: 0,
+        onQueryChange,
+        reload,
+    };
+};
+export default useInfiniteCursor;
+//# sourceMappingURL=useInfiniteCursor.js.map

package/dist/hooks/useInfiniteCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteCursor.js","sourceRoot":"","sources":["../../src/hooks/useInfiniteCursor.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useListKeyboard.d.ts

@@ -0,0 +1,19 @@
+import { Dispatch, KeyboardEvent, SetStateAction } from "react";
+interface UseListKeyboardOptions {
+    isOpen: boolean;
+    length: number;
+    highlightedIndex: number;
+    setHighlightedIndex: Dispatch<SetStateAction<number>>;
+    onSelect: (index: number) => void;
+    onClose: () => void;
+    /** If true, Tab selects highlighted (or first) option. */
+    selectOnTab?: boolean;
+}
+/**
+ * Returns a keydown handler that drives arrow-key list navigation,
+ * Enter to select, Escape to close, and optional Tab-to-select.
+ * Shared by Typeahead and SearchList.
+ */
+declare const useListKeyboard: ({ isOpen, length, highlightedIndex, setHighlightedIndex, onSelect, onClose, selectOnTab, }: UseListKeyboardOptions) => (e: KeyboardEvent<HTMLElement>) => void;
+export default useListKeyboard;
+//# sourceMappingURL=useListKeyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useListKeyboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useListKeyboard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAe,MAAM,OAAO,CAAC;AAE7E,UAAU,sBAAsB;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,QAAA,MAAM,eAAe,GAAI,4FAQtB,sBAAsB,SAEjB,aAAa,CAAC,WAAW,CAAC,SAmC/B,CAAC;AAEJ,eAAe,eAAe,CAAC"}