@jini-ai/ui 0.1.0

package/dist/react/components/WorkingDirPicker.js

@@ -0,0 +1,183 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useId, useRef, useState, } from 'react';
+import { Icon } from './Icon';
+export const DEFAULT_WORKING_DIR_LABELS = {
+    missing: 'Directory no longer exists',
+    hint: 'Select a working directory',
+    trigger: 'Working directory',
+    replace: 'Change folder',
+    pick: 'Choose folder',
+    recent: 'Recent folders',
+    recentEmpty: 'No recent folders',
+    clear: 'Clear',
+};
+/** Merge host label overrides onto the built-in English defaults. */
+export function resolveWorkingDirLabels(labels) {
+    return { ...DEFAULT_WORKING_DIR_LABELS, ...labels };
+}
+/** Last path segment of a `/`- or `\`-separated dir; the whole input if empty. */
+export function basename(dir) {
+    return dir.split(/[/\\]/).filter(Boolean).pop() ?? dir;
+}
+/**
+ * Owns the panel's open/closed boolean plus the "click outside or press
+ * Escape to dismiss" behavior. While open, it listens on `document` for a
+ * pointer press outside `wrapRef` or an Escape keypress and closes.
+ * `toggle` flips the state and invokes `onOpen` only on the closed→open
+ * transition. Exported so the behavior is testable without a render.
+ */
+export function useDismissablePanel(onOpen) {
+    const [open, setOpen] = useState(false);
+    const wrapRef = useRef(null);
+    const close = useCallback(() => setOpen(false), []);
+    const toggle = useCallback(() => {
+        setOpen((v) => {
+            if (!v)
+                onOpen?.();
+            return !v;
+        });
+    }, [onOpen]);
+    useEffect(() => {
+        if (!open)
+            return;
+        function onPointer(event) {
+            if (wrapRef.current?.contains(event.target))
+                return;
+            setOpen(false);
+        }
+        function onKey(event) {
+            if (event.key === 'Escape')
+                setOpen(false);
+        }
+        document.addEventListener('mousedown', onPointer);
+        document.addEventListener('keydown', onKey);
+        return () => {
+            document.removeEventListener('mousedown', onPointer);
+            document.removeEventListener('keydown', onKey);
+        };
+    }, [open]);
+    return { open, wrapRef, toggle, close };
+}
+/**
+ * Owns the "Recent folders" flyout's open boolean. Auto-collapses whenever the
+ * parent panel closes (`panelOpen` goes false), matching the original's
+ * single-effect reset. Exported for isolated testing.
+ */
+export function useRecentFlyout(panelOpen) {
+    const [recentOpen, setRecentOpen] = useState(false);
+    useEffect(() => {
+        if (!panelOpen)
+            setRecentOpen(false);
+    }, [panelOpen]);
+    const show = useCallback(() => setRecentOpen(true), []);
+    const hide = useCallback(() => setRecentOpen(false), []);
+    const toggle = useCallback(() => setRecentOpen((v) => !v), []);
+    return { recentOpen, show, hide, toggle };
+}
+/**
+ * Composes {@link useDismissablePanel} and {@link useRecentFlyout} and builds
+ * the picker's action handlers (each closes the panel and forwards to the host
+ * callback). `clear` tolerates a missing `onClear` — a defensive guard the
+ * dumb component never reaches (it only renders the clear button when
+ * `onClear` is set), but reachable directly through this hook.
+ * {@link WorkingDirPicker} is the dumb consumer of this result.
+ */
+export function useWorkingDirPicker(input) {
+    const { onPickDirectory, onSelectRecent, onClear, onOpen, labels } = input;
+    const panel = useDismissablePanel(onOpen);
+    const flyout = useRecentFlyout(panel.open);
+    const resolved = resolveWorkingDirLabels(labels);
+    const pick = useCallback(() => {
+        panel.close();
+        onPickDirectory();
+    }, [onPickDirectory, panel]);
+    const selectRecent = useCallback((dir) => {
+        onSelectRecent(dir);
+        panel.close();
+    }, [onSelectRecent, panel]);
+    const clear = useCallback(() => {
+        onClear?.();
+        panel.close();
+    }, [onClear, panel]);
+    return {
+        open: panel.open,
+        recentOpen: flyout.recentOpen,
+        wrapRef: panel.wrapRef,
+        labels: resolved,
+        toggle: panel.toggle,
+        pick,
+        selectRecent,
+        clear,
+        showRecent: flyout.show,
+        hideRecent: flyout.hide,
+        toggleRecent: flyout.toggle,
+    };
+}
+/**
+ * Working-directory picker: a borderless trigger that opens a panel with
+ * "Choose folder" and a "Recent folders" submenu. Layout is left to the host
+ * via `className`; all open/close/keyboard state lives in
+ * {@link useWorkingDirPicker}. This component is a dumb render.
+ */
+export function WorkingDirPicker({ workingDir, recentDirs, onPickDirectory, onSelectRecent, onClear, className, placement = 'down', invalid = false, onOpen, labels, useWorkingDirPicker: useWorkingDirPickerHook = useWorkingDirPicker, }) {
+    const panelId = useId();
+    const triggerRef = useRef(null);
+    const panelRef = useRef(null);
+    const wasOpenRef = useRef(false);
+    const { open, recentOpen, wrapRef, labels: t, toggle, pick, selectRecent, clear, showRecent, hideRecent, toggleRecent, } = useWorkingDirPickerHook({ onPickDirectory, onSelectRecent, onClear, onOpen, labels });
+    useEffect(() => {
+        if (open) {
+            wasOpenRef.current = true;
+            panelRef.current?.querySelector('[role="menuitem"]:not(:disabled)')?.focus();
+            return;
+        }
+        if (!wasOpenRef.current)
+            return;
+        wasOpenRef.current = false;
+        const timeout = window.setTimeout(() => triggerRef.current?.focus(), 0);
+        return () => window.clearTimeout(timeout);
+    }, [open]);
+    const handlePanelKeyDown = useCallback((event) => {
+        const menuItems = [...(panelRef.current?.querySelectorAll('[role="menuitem"]:not(:disabled)') ?? [])];
+        const currentIndex = menuItems.indexOf(document.activeElement);
+        if (event.key === 'ArrowDown'
+            || event.key === 'ArrowUp'
+            || event.key === 'Home'
+            || event.key === 'End') {
+            if (menuItems.length === 0)
+                return;
+            event.preventDefault();
+            const nextIndex = event.key === 'Home'
+                ? 0
+                : event.key === 'End'
+                    ? menuItems.length - 1
+                    : event.key === 'ArrowDown'
+                        ? (currentIndex + 1 + menuItems.length) % menuItems.length
+                        : (currentIndex - 1 + menuItems.length) % menuItems.length;
+            menuItems[nextIndex]?.focus();
+            return;
+        }
+        if (event.key === 'ArrowRight'
+            && event.target === panelRef.current?.querySelector('[data-testid="working-dir-recent"]')) {
+            event.preventDefault();
+            showRecent();
+            window.setTimeout(() => {
+                panelRef.current
+                    ?.querySelector('[data-testid="working-dir-recent-list"] [role="menuitem"]')
+                    ?.focus();
+            }, 0);
+            return;
+        }
+        if (event.key === 'ArrowLeft'
+            && event.target instanceof HTMLElement
+            && event.target.closest('[data-testid="working-dir-recent-list"]')) {
+            event.preventDefault();
+            hideRecent();
+            panelRef.current
+                ?.querySelector('[data-testid="working-dir-recent"]')
+                ?.focus();
+        }
+    }, [hideRecent, showRecent]);
+    return (_jsxs("div", { ref: wrapRef, className: `jini-working-dir-picker${className ? ` ${className}` : ''}`, "data-testid": "working-dir-picker", children: [_jsx("div", { className: "jini-working-dir-trigger-row", children: _jsxs("button", { ref: triggerRef, type: "button", className: `jini-working-dir-trigger${invalid ? ' invalid' : ''}`, "data-testid": "working-dir-trigger", "aria-haspopup": "menu", "aria-expanded": open, "aria-controls": panelId, title: invalid ? t.missing : (workingDir ?? t.hint), onClick: toggle, children: [_jsx(Icon, { name: "folder", size: 13, className: "jini-working-dir-trigger-icon" }), _jsx("span", { className: "jini-working-dir-trigger-label", children: workingDir ? basename(workingDir) : t.trigger }), _jsx(Icon, { name: "chevron-down", size: 11, className: "jini-working-dir-trigger-chevron" })] }) }), open ? (_jsxs("div", { ref: panelRef, id: panelId, className: `jini-working-dir-panel${placement === 'up' ? ' up' : ''}`, role: "menu", "data-testid": "working-dir-panel", onKeyDown: handlePanelKeyDown, children: [_jsxs("button", { type: "button", role: "menuitem", className: "jini-working-dir-item", "data-testid": "working-dir-pick", onClick: pick, children: [_jsx(Icon, { name: "folder", size: 14, className: "jini-working-dir-item-icon" }), _jsx("span", { children: workingDir ? t.replace : t.pick })] }), _jsxs("div", { className: "jini-working-dir-submenu-row", onMouseEnter: showRecent, onMouseLeave: hideRecent, children: [_jsxs("button", { type: "button", role: "menuitem", className: "jini-working-dir-item", "aria-haspopup": "menu", "aria-expanded": recentOpen, "data-testid": "working-dir-recent", onClick: toggleRecent, children: [_jsx(Icon, { name: "history", size: 14, className: "jini-working-dir-item-icon" }), _jsx("span", { children: t.recent }), _jsx(Icon, { name: "chevron-right", size: 12, className: "jini-working-dir-item-chevron" })] }), recentOpen ? (_jsx("div", { className: `jini-working-dir-flyout${placement === 'up' ? ' up' : ''}`, role: "menu", "data-testid": "working-dir-recent-list", children: recentDirs.length === 0 ? (_jsx("div", { className: "jini-working-dir-empty", children: t.recentEmpty })) : (recentDirs.map((dir) => (_jsxs("button", { type: "button", role: "menuitem", className: "jini-working-dir-recent-item", title: dir, onClick: () => selectRecent(dir), children: [_jsx(Icon, { name: "folder", size: 13, className: "jini-working-dir-item-icon" }), _jsx("span", { className: "jini-working-dir-recent-name", children: basename(dir) }), _jsx("span", { className: "jini-working-dir-recent-path", children: dir })] }, dir)))) })) : null] }), workingDir && onClear ? (_jsxs("button", { type: "button", role: "menuitem", className: "jini-working-dir-item", "data-testid": "working-dir-clear", onClick: clear, children: [_jsx(Icon, { name: "close", size: 14, className: "jini-working-dir-item-icon" }), _jsx("span", { children: t.clear })] })) : null] })) : null] }));
+}
+//# sourceMappingURL=WorkingDirPicker.js.map

package/dist/react/components/WorkingDirPicker.js.map

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

package/dist/react/hooks/useBrandFonts.d.ts

@@ -0,0 +1,22 @@
+export interface BrandFontManifestFile {
+    family: string;
+    weight: string;
+    style: string;
+    file: string;
+    format: string;
+}
+export interface BrandFontManifest {
+    files?: BrandFontManifestFile[];
+}
+export interface UseBrandFontsOptions {
+    /**
+     * Builds the URL for a project asset path (e.g. `fonts/manifest.json`).
+     * Omit to skip the self-hosted-font-manifest stage entirely — this hook
+     * never hardcodes a font-service URL of its own.
+     */
+    resolveProjectAssetUrl?: (projectId: string, path: string) => string;
+}
+export declare function useBrandFonts(projectId: string | undefined, fonts: {
+    googleFontsUrl?: string;
+}[], options?: UseBrandFontsOptions): void;
+//# sourceMappingURL=useBrandFonts.d.ts.map

package/dist/react/hooks/useBrandFonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBrandFonts.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useBrandFonts.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACtE;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACpC,OAAO,GAAE,oBAAyB,GACjC,IAAI,CA+DN"}

package/dist/react/hooks/useBrandFonts.js

@@ -0,0 +1,75 @@
+// Load real typefaces so brand-kit typography specimens render for real:
+// append any Google Fonts stylesheets the kit declares, and (when a host
+// supplies `resolveProjectAssetUrl`) inject self-hosted `@font-face` rules
+// from the project's own font-manifest asset. Both are best-effort and torn
+// down on change. Not tied to any one feature domain — feature-local hooks
+// live inside their own `features/<domain>/react/hooks/` instead.
+import { useEffect, useMemo } from 'react';
+export function useBrandFonts(projectId, fonts, options = {}) {
+    const { resolveProjectAssetUrl } = options;
+    const googleUrls = useMemo(() => {
+        const urls = fonts
+            .map((f) => f.googleFontsUrl)
+            .filter((u) => Boolean(u && /^https:\/\/fonts\.googleapis\.com\//i.test(u)));
+        return Array.from(new Set(urls));
+    }, [fonts]);
+    useEffect(() => {
+        const links = googleUrls.map((href) => {
+            const link = document.createElement('link');
+            link.rel = 'stylesheet';
+            link.href = href;
+            document.head.appendChild(link);
+            return link;
+        });
+        return () => {
+            for (const link of links)
+                link.remove();
+        };
+    }, [googleUrls]);
+    useEffect(() => {
+        if (!projectId || !resolveProjectAssetUrl)
+            return;
+        let cancelled = false;
+        let styleEl = null;
+        void (async () => {
+            try {
+                const resp = await fetch(resolveProjectAssetUrl(projectId, 'fonts/manifest.json'), {
+                    cache: 'no-store',
+                });
+                if (!resp.ok)
+                    return;
+                const data = (await resp.json());
+                const files = Array.isArray(data?.files) ? data.files : [];
+                if (cancelled || files.length === 0)
+                    return;
+                const css = files
+                    .map((f) => {
+                    const url = resolveProjectAssetUrl(projectId, `fonts/${f.file}`);
+                    return [
+                        '@font-face {',
+                        `  font-family: '${f.family.replace(/'/g, '')}';`,
+                        `  src: url('${url}') format('${f.format}');`,
+                        `  font-weight: ${f.weight};`,
+                        `  font-style: ${f.style};`,
+                        '  font-display: swap;',
+                        '}',
+                    ].join('\n');
+                })
+                    .join('\n');
+                styleEl = document.createElement('style');
+                styleEl.dataset.brandFonts = projectId;
+                styleEl.textContent = css;
+                document.head.appendChild(styleEl);
+            }
+            catch {
+                // A missing/malformed manifest is expected for some systems.
+            }
+        })();
+        return () => {
+            cancelled = true;
+            if (styleEl)
+                styleEl.remove();
+        };
+    }, [projectId, resolveProjectAssetUrl]);
+}
+//# sourceMappingURL=useBrandFonts.js.map

package/dist/react/hooks/useBrandFonts.js.map

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

package/dist/react/hooks/useCoalescedCallback.d.ts

@@ -0,0 +1,35 @@
+export interface CoalesceOptions {
+    /**
+     * Quiet window (ms) the trigger waits for before firing the callback.
+     * Each new trigger inside the window resets this timer.
+     */
+    wait: number;
+    /**
+     * Hard upper bound (ms) on how long a sustained burst can keep deferring
+     * the callback. If `maxWait` elapses since the first trigger of the
+     * current burst, the next call flushes immediately. Omit to disable the
+     * cap (only useful for short, well-bounded bursts).
+     */
+    maxWait?: number;
+}
+/**
+ * Returns a stable trigger function that coalesces rapid bursts of calls
+ * into a single trailing invocation of `callback`. Useful for absorbing
+ * near-simultaneous change signals (e.g. a filesystem watcher emitting a
+ * paired remove+add for what is really one rename) into one downstream
+ * update instead of a flicker of intermediate UI states.
+ *
+ * Semantics:
+ *   - First trigger arms a timer for `wait` ms.
+ *   - Subsequent triggers inside the quiet window reset the timer.
+ *   - When the timer fires, the latest `callback` runs once.
+ *   - If `maxWait` is set and the current burst has been deferred for
+ *     `>= maxWait`, the next trigger flushes immediately instead of
+ *     resetting again — sustained edit storms don't starve the UI.
+ *   - The hook's identity is stable across renders; only `wait` /
+ *     `maxWait` changes regenerate the trigger.
+ *   - The pending timer is cleared on unmount, so a late event after the
+ *     component leaves the tree cannot call into a stale `callback`.
+ */
+export declare function useCoalescedCallback(callback: () => void, options: CoalesceOptions): () => void;
+//# sourceMappingURL=useCoalescedCallback.d.ts.map

package/dist/react/hooks/useCoalescedCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCoalescedCallback.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useCoalescedCallback.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,EAAE,eAAe,GACvB,MAAM,IAAI,CAsCZ"}

package/dist/react/hooks/useCoalescedCallback.js

@@ -0,0 +1,61 @@
+import { useCallback, useEffect, useRef } from 'react';
+/**
+ * Returns a stable trigger function that coalesces rapid bursts of calls
+ * into a single trailing invocation of `callback`. Useful for absorbing
+ * near-simultaneous change signals (e.g. a filesystem watcher emitting a
+ * paired remove+add for what is really one rename) into one downstream
+ * update instead of a flicker of intermediate UI states.
+ *
+ * Semantics:
+ *   - First trigger arms a timer for `wait` ms.
+ *   - Subsequent triggers inside the quiet window reset the timer.
+ *   - When the timer fires, the latest `callback` runs once.
+ *   - If `maxWait` is set and the current burst has been deferred for
+ *     `>= maxWait`, the next trigger flushes immediately instead of
+ *     resetting again — sustained edit storms don't starve the UI.
+ *   - The hook's identity is stable across renders; only `wait` /
+ *     `maxWait` changes regenerate the trigger.
+ *   - The pending timer is cleared on unmount, so a late event after the
+ *     component leaves the tree cannot call into a stale `callback`.
+ */
+export function useCoalescedCallback(callback, options) {
+    const stateRef = useRef({ timer: null, firstSeenAt: null });
+    const callbackRef = useRef(callback);
+    useEffect(() => {
+        callbackRef.current = callback;
+    });
+    useEffect(() => {
+        return () => {
+            const s = stateRef.current;
+            if (s.timer !== null) {
+                clearTimeout(s.timer);
+                s.timer = null;
+                s.firstSeenAt = null;
+            }
+        };
+    }, []);
+    const { wait, maxWait } = options;
+    return useCallback(() => {
+        const s = stateRef.current;
+        const flush = () => {
+            if (s.timer !== null)
+                clearTimeout(s.timer);
+            s.timer = null;
+            s.firstSeenAt = null;
+            callbackRef.current();
+        };
+        const now = Date.now();
+        if (s.firstSeenAt !== null &&
+            maxWait !== undefined &&
+            now - s.firstSeenAt >= maxWait) {
+            flush();
+            return;
+        }
+        if (s.firstSeenAt === null)
+            s.firstSeenAt = now;
+        if (s.timer !== null)
+            clearTimeout(s.timer);
+        s.timer = setTimeout(flush, wait);
+    }, [wait, maxWait]);
+}
+//# sourceMappingURL=useCoalescedCallback.js.map

package/dist/react/hooks/useCoalescedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCoalescedCallback.js","sourceRoot":"","sources":["../../../src/react/hooks/useCoalescedCallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAsBvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAoB,EACpB,OAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,CAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;YAC3B,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACrB,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;gBACf,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAClC,OAAO,WAAW,CAAC,GAAG,EAAE;QACtB,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;gBAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;YACf,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC;YACrB,WAAW,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IACE,CAAC,CAAC,WAAW,KAAK,IAAI;YACtB,OAAO,KAAK,SAAS;YACrB,GAAG,GAAG,CAAC,CAAC,WAAW,IAAI,OAAO,EAC9B,CAAC;YACD,KAAK,EAAE,CAAC;YACR,OAAO;QACT,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI;YAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC;QAChD,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;YAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function useDebouncedValue<T>(value: T, delayMs: number): T;
+//# sourceMappingURL=useDebouncedValue.d.ts.map

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

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

package/dist/react/hooks/useDebouncedValue.js

@@ -0,0 +1,14 @@
+// Trailing-debounce a fast-changing value (e.g. a search box) before it
+// drives an expensive downstream effect (a network fetch). Not tied to any
+// one feature domain — feature-local hooks live inside their own
+// `features/<domain>/react/hooks/` instead.
+import { useEffect, useState } from 'react';
+export function useDebouncedValue(value, delayMs) {
+    const [debounced, setDebounced] = useState(value);
+    useEffect(() => {
+        const timer = setTimeout(() => setDebounced(value), delayMs);
+        return () => clearTimeout(timer);
+    }, [value, delayMs]);
+    return debounced;
+}
+//# sourceMappingURL=useDebouncedValue.js.map

package/dist/react/hooks/useDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.js","sourceRoot":"","sources":["../../../src/react/hooks/useDebouncedValue.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,iEAAiE;AACjE,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAI,KAAQ,EAAE,OAAe;IAC5D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAErB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/react/hooks/useEdgeAutoScroll.d.ts

@@ -0,0 +1,18 @@
+import type { RefObject } from 'react';
+export interface EdgeAutoScroll {
+    scrollRef: RefObject<HTMLDivElement | null>;
+    edges: {
+        left: boolean;
+        right: boolean;
+    };
+    startAutoScroll: (direction: 1 | -1) => void;
+    stopAutoScroll: () => void;
+    nudge: (direction: 1 | -1) => void;
+}
+/**
+ * Wire a horizontally-scrolling element (assign `scrollRef` to it) with
+ * edge-driven auto-scroll. `contentKey` should change whenever the item count
+ * changes so the reachable-edge state is re-measured.
+ */
+export declare function useEdgeAutoScroll(contentKey?: unknown): EdgeAutoScroll;
+//# sourceMappingURL=useEdgeAutoScroll.d.ts.map

package/dist/react/hooks/useEdgeAutoScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEdgeAutoScroll.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useEdgeAutoScroll.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5C,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IACzC,eAAe,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,cAAc,CAuEtE"}

package/dist/react/hooks/useEdgeAutoScroll.js

@@ -0,0 +1,80 @@
+// Edge hover/click auto-scroll for a horizontally-overflowing rail.
+//
+// A horizontally-scrolling rail is reachable by trackpad swipe, but a plain
+// mouse (no trackpad, no shift+wheel habit) has no easy way to scroll it.
+// This hook drives two edge zones: hover one to glide continuously, or click
+// it to jump. Pair with `EdgeScrollZones` for the rendered overlay, or wire
+// the returned handlers to your own UI.
+import { useCallback, useEffect, useRef, useState } from 'react';
+const STEP_PX = 9; // per-frame hover-glide speed
+const NUDGE_PX = 332; // click jump (~2 small cards / one large card + gap)
+/**
+ * Wire a horizontally-scrolling element (assign `scrollRef` to it) with
+ * edge-driven auto-scroll. `contentKey` should change whenever the item count
+ * changes so the reachable-edge state is re-measured.
+ */
+export function useEdgeAutoScroll(contentKey) {
+    const scrollRef = useRef(null);
+    const rafRef = useRef(null);
+    const [edges, setEdges] = useState({
+        left: false,
+        right: false,
+    });
+    const stopAutoScroll = useCallback(() => {
+        if (rafRef.current != null) {
+            cancelAnimationFrame(rafRef.current);
+            rafRef.current = null;
+        }
+    }, []);
+    const startAutoScroll = useCallback((direction) => {
+        stopAutoScroll();
+        const step = () => {
+            const el = scrollRef.current;
+            if (!el)
+                return;
+            const maxScroll = el.scrollWidth - el.clientWidth;
+            el.scrollLeft += direction * STEP_PX;
+            const reachedEnd = direction < 0 ? el.scrollLeft <= 0 : el.scrollLeft >= maxScroll;
+            if (reachedEnd) {
+                stopAutoScroll();
+                return;
+            }
+            rafRef.current = requestAnimationFrame(step);
+        };
+        rafRef.current = requestAnimationFrame(step);
+    }, [stopAutoScroll]);
+    const nudge = useCallback((direction) => {
+        const el = scrollRef.current;
+        if (!el)
+            return;
+        el.scrollBy({ left: direction * NUDGE_PX, behavior: 'smooth' });
+    }, []);
+    useEffect(() => {
+        const el = scrollRef.current;
+        if (!el)
+            return;
+        const updateEdges = () => {
+            const maxScroll = el.scrollWidth - el.clientWidth;
+            setEdges({
+                left: el.scrollLeft > 1,
+                right: el.scrollLeft < maxScroll - 1,
+            });
+        };
+        updateEdges();
+        el.addEventListener('scroll', updateEdges, { passive: true });
+        // ResizeObserver is absent in jsdom; the scroll listener still keeps edges
+        // fresh, so observing the viewport is a best-effort extra.
+        const observer = typeof ResizeObserver !== 'undefined'
+            ? new ResizeObserver(updateEdges)
+            : null;
+        observer?.observe(el);
+        return () => {
+            el.removeEventListener('scroll', updateEdges);
+            observer?.disconnect();
+        };
+    }, [contentKey]);
+    // Cancel any in-flight glide when the rail unmounts.
+    useEffect(() => stopAutoScroll, [stopAutoScroll]);
+    return { scrollRef, edges, startAutoScroll, stopAutoScroll, nudge };
+}
+//# sourceMappingURL=useEdgeAutoScroll.js.map

package/dist/react/hooks/useEdgeAutoScroll.js.map

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

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

@@ -0,0 +1,19 @@
+export interface UseInViewOptions {
+    rootMargin?: string;
+    /** Stop observing after the first time the node becomes visible. */
+    once?: boolean;
+    /**
+     * Observe against this scroll container instead of the viewport. Needed
+     * when the target lives in an overflow container: clipping empties the
+     * intersection rect regardless of a viewport rootMargin, so pre-mounting
+     * "just off-screen" targets only works with the container as root. Pass a
+     * ref (read at observe time) because the container mounts in the same
+     * commit as the targets.
+     */
+    root?: React.RefObject<Element | null>;
+}
+export declare function useInView<T extends Element = HTMLElement>(options?: UseInViewOptions): {
+    ref: React.MutableRefObject<T | null>;
+    inView: boolean;
+};
+//# sourceMappingURL=useInView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useInView.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useInView.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACxC;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,WAAW,EACvD,OAAO,GAAE,gBAAqB,GAC7B;IAAE,GAAG,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAoC5D"}

package/dist/react/hooks/useInView.js

@@ -0,0 +1,39 @@
+// IntersectionObserver-backed visibility hook — defer expensive work (image
+// fetches, srcDoc iframes, autoplaying video) until a node actually scrolls
+// into view. Once a node has been visible at least once it stays "armed" by
+// default so re-scrolling does not cause repeated mount churn (pass
+// `once: false` to track visibility continuously instead).
+import { useEffect, useRef, useState } from 'react';
+export function useInView(options = {}) {
+    const ref = useRef(null);
+    const [inView, setInView] = useState(false);
+    useEffect(() => {
+        const node = ref.current;
+        if (!node)
+            return;
+        if (typeof IntersectionObserver === 'undefined') {
+            setInView(true);
+            return;
+        }
+        const observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting) {
+                    setInView(true);
+                    if (options.once !== false) {
+                        observer.disconnect();
+                    }
+                }
+                else if (options.once === false) {
+                    setInView(false);
+                }
+            }
+        }, {
+            rootMargin: options.rootMargin ?? '240px',
+            root: options.root?.current ?? null,
+        });
+        observer.observe(node);
+        return () => observer.disconnect();
+    }, [options.once, options.rootMargin, options.root]);
+    return { ref, inView };
+}
+//# sourceMappingURL=useInView.js.map

package/dist/react/hooks/useInView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInView.js","sourceRoot":"","sources":["../../../src/react/hooks/useInView.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,oEAAoE;AACpE,2DAA2D;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAiBpD,MAAM,UAAU,SAAS,CACvB,UAA4B,EAAE;IAE9B,MAAM,GAAG,GAAG,MAAM,CAAW,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,OAAO,oBAAoB,KAAK,WAAW,EAAE,CAAC;YAChD,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,EAAE;YACV,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;oBACzB,SAAS,CAAC,IAAI,CAAC,CAAC;oBAChB,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;wBAC3B,QAAQ,CAAC,UAAU,EAAE,CAAC;oBACxB,CAAC;gBACH,CAAC;qBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;oBAClC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC,EACD;YACE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO;YACzC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI;SACpC,CACF,CAAC;QACF,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzB,CAAC"}