@jini-ai/ui 0.1.0

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

@@ -0,0 +1,44 @@
+import { type CSSProperties, type KeyboardEvent as ReactKeyboardEvent, type PointerEvent as ReactPointerEvent, type RefObject } from 'react';
+export interface UseResizableSplitPaneOptions {
+    /** localStorage key the last-committed width persists under. Omit to use a generic, package-neutral default key. */
+    storageKey?: string;
+    /** Width (px) used before any persisted value is read, and as the Home-key target. Default 460. */
+    defaultWidth?: number;
+    /** Hard floor (px) the primary pane's width is clamped to. Default 345. */
+    minWidth?: number;
+    /** Hard ceiling (px) the primary pane's width is clamped to, before container-width narrowing. Default 720. */
+    maxWidth?: number;
+    /** Width (px) reserved for the drag handle itself in the computed grid-template-columns. Default 8. */
+    handleWidth?: number;
+    /** Minimum width (px) the secondary pane keeps; the primary pane's effective max shrinks to preserve it. Default 400. */
+    minSecondaryWidth?: number;
+    /** Pixels moved per ArrowLeft/ArrowRight keypress on the handle. Default 16. */
+    keyboardStep?: number;
+}
+export interface ResizableSplitPaneController {
+    /** The primary pane's current committed width (px). */
+    width: number;
+    /** The primary pane's current effective max width (px), narrowed by container size. */
+    maxWidth: number;
+    /** The secondary pane's current effective min width (px); 0 once the container is too narrow to guarantee it. */
+    secondaryMinWidth: number;
+    /** True while a pointer drag is in progress. */
+    isResizing: boolean;
+    /** Attach to the split container element (the one whose grid-template-columns this hook manages). */
+    containerRef: RefObject<HTMLDivElement | null>;
+    /** Attach to the drag handle element's onPointerDown. */
+    onHandlePointerDown: (event: ReactPointerEvent<HTMLElement>) => void;
+    /** Attach to the drag handle element's onKeyDown (ArrowLeft/ArrowRight/Home/End). */
+    onHandleKeyDown: (event: ReactKeyboardEvent<HTMLElement>) => void;
+    /** Attach to the drag handle element's onBlur — cancels an in-progress drag if focus leaves mid-resize. */
+    onHandleBlur: () => void;
+    /** Spread onto the split container: sets the CSS custom properties and grid-template-columns for the current width. */
+    containerStyle: CSSProperties & {
+        '--resizable-split-pane-primary-width': string;
+        '--resizable-split-pane-secondary-track': string;
+    };
+}
+export declare function readSavedWidth(storageKey: string, defaultWidth: number, min: number, max: number): number;
+export declare function saveWidth(storageKey: string, width: number, min: number, max: number): void;
+export declare function useResizableSplitPane(options?: UseResizableSplitPaneOptions): ResizableSplitPaneController;
+//# sourceMappingURL=useResizableSplitPane.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useResizableSplitPane.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useResizableSplitPane.ts"],"names":[],"mappings":"AASA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,aAAa,IAAI,kBAAkB,EACxC,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,4BAA4B;IAC3C,oHAAoH;IACpH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uGAAuG;IACvG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yHAAyH;IACzH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;IACpB,qGAAqG;IACrG,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/C,yDAAyD;IACzD,mBAAmB,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACrE,qFAAqF;IACrF,eAAe,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAClE,2GAA2G;IAC3G,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,uHAAuH;IACvH,cAAc,EAAE,aAAa,GAAG;QAC9B,sCAAsC,EAAE,MAAM,CAAC;QAC/C,wCAAwC,EAAE,MAAM,CAAC;KAClD,CAAC;CACH;AAmBD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CASzG;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAO3F;AAaD,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,4BAA4B,CAkP9B"}

package/dist/react/hooks/useResizableSplitPane.js

@@ -0,0 +1,259 @@
+// Pointer-drag-resizable split pane: one side has a persisted, clamped width;
+// the split container exposes a `style` with the CSS custom properties/grid
+// columns needed to render both panes plus a handle. RAF-throttled pointer
+// tracking, RTL-aware, keyboard-resizable (arrow keys/Home/End on the handle),
+// ResizeObserver-clamped so the primary pane's max width shrinks with the
+// container instead of overflowing it, localStorage-persisted (skipped
+// entirely outside the browser or when storage is unavailable). Not tied to
+// any one feature domain — feature-local hooks live inside their own
+// `features/<domain>/react/hooks/` instead.
+import { useCallback, useEffect, useLayoutEffect, useRef, useState, } from 'react';
+const DEFAULT_STORAGE_KEY = 'jini.resizable-split-pane.width';
+function clampPreferredWidth(width, min, max) {
+    return Math.min(max, Math.max(min, Math.round(width)));
+}
+function clampWidthForMax(width, min, max, effectiveMax) {
+    const clampedMax = Math.max(0, Math.min(max, Math.floor(effectiveMax)));
+    const clampedMin = Math.min(min, clampedMax);
+    return Math.min(clampedMax, Math.max(clampedMin, Math.round(width)));
+}
+// Exported (despite being module-private in spirit) so their `typeof window
+// === 'undefined'` SSR guards can be exercised for real under a
+// `@vitest-environment node` companion test — this package's default jsdom
+// environment always defines `window`, so that branch is otherwise
+// unreachable. See `useResizableSplitPane.ssr.test.ts`.
+export function readSavedWidth(storageKey, defaultWidth, min, max) {
+    if (typeof window === 'undefined')
+        return defaultWidth;
+    try {
+        const raw = window.localStorage.getItem(storageKey);
+        const parsed = raw ? Number.parseInt(raw, 10) : Number.NaN;
+        return Number.isFinite(parsed) ? clampPreferredWidth(parsed, min, max) : defaultWidth;
+    }
+    catch {
+        return defaultWidth;
+    }
+}
+export function saveWidth(storageKey, width, min, max) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.setItem(storageKey, String(clampPreferredWidth(width, min, max)));
+    }
+    catch {
+        // localStorage can be unavailable in hardened browser contexts.
+    }
+}
+function applyContainerWidth(container, width, secondaryTrack, handleWidth) {
+    if (!container)
+        return;
+    container.style.setProperty('--resizable-split-pane-primary-width', `${width}px`);
+    container.style.gridTemplateColumns = `${width}px ${handleWidth}px ${secondaryTrack}`;
+}
+export function useResizableSplitPane(options = {}) {
+    const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;
+    const defaultWidth = options.defaultWidth ?? 460;
+    const minWidth = options.minWidth ?? 345;
+    const maxWidthOption = options.maxWidth ?? 720;
+    const handleWidth = options.handleWidth ?? 8;
+    const minSecondaryWidth = options.minSecondaryWidth ?? 400;
+    const keyboardStep = options.keyboardStep ?? 16;
+    const minNormalContainerWidth = minWidth + handleWidth + minSecondaryWidth;
+    const [width, setWidth] = useState(() => readSavedWidth(storageKey, defaultWidth, minWidth, maxWidthOption));
+    const [maxWidth, setMaxWidth] = useState(maxWidthOption);
+    const [secondaryMinWidth, setSecondaryMinWidth] = useState(minSecondaryWidth);
+    const [isResizing, setIsResizing] = useState(false);
+    const containerRef = useRef(null);
+    const widthRef = useRef(width);
+    const preferredWidthRef = useRef(width);
+    const resizeStartPreferredWidthRef = useRef(width);
+    const maxWidthRef = useRef(maxWidth);
+    const resizeStateRef = useRef(null);
+    const pointerCleanupRef = useRef(null);
+    const pointerFrameRef = useRef(null);
+    const pendingPointerClientXRef = useRef(null);
+    const secondaryTrack = secondaryMinWidth === 0 ? 'minmax(0, 1fr)' : `minmax(${secondaryMinWidth}px, 1fr)`;
+    const renderPreferredWidth = useCallback((preferredWidth, effectiveMax = maxWidthRef.current, opts = {}) => {
+        const next = clampWidthForMax(preferredWidth, minWidth, maxWidthOption, effectiveMax);
+        widthRef.current = next;
+        applyContainerWidth(containerRef.current, next, secondaryTrack, handleWidth);
+        if (opts.commitState !== false)
+            setWidth(next);
+        return next;
+    }, [minWidth, maxWidthOption, secondaryTrack, handleWidth]);
+    const applyWidth = useCallback((nextWidth, opts = {}) => {
+        const nextPreferred = clampPreferredWidth(clampWidthForMax(nextWidth, minWidth, maxWidthOption, maxWidthRef.current), minWidth, maxWidthOption);
+        preferredWidthRef.current = nextPreferred;
+        return renderPreferredWidth(nextPreferred, maxWidthRef.current, opts);
+    }, [renderPreferredWidth, minWidth, maxWidthOption]);
+    const finishResize = useCallback((saveFinalWidth = true) => {
+        pointerCleanupRef.current?.();
+        pointerCleanupRef.current = null;
+        if (pointerFrameRef.current !== null) {
+            cancelAnimationFrame(pointerFrameRef.current);
+            pointerFrameRef.current = null;
+        }
+        pendingPointerClientXRef.current = null;
+        resizeStateRef.current = null;
+        setIsResizing(false);
+        if (saveFinalWidth) {
+            const finalWidth = renderPreferredWidth(preferredWidthRef.current);
+            saveWidth(storageKey, finalWidth, minWidth, maxWidthOption);
+        }
+    }, [renderPreferredWidth, storageKey, minWidth, maxWidthOption]);
+    useEffect(() => {
+        widthRef.current = width;
+        applyContainerWidth(containerRef.current, width, secondaryTrack, handleWidth);
+    }, [width, secondaryTrack, handleWidth]);
+    useEffect(() => {
+        maxWidthRef.current = maxWidth;
+    }, [maxWidth]);
+    useLayoutEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return undefined;
+        const updateAllowedWidth = () => {
+            const containerWidth = container.clientWidth;
+            const nextSecondaryMin = !Number.isFinite(containerWidth) || containerWidth <= 0
+                ? minSecondaryWidth
+                : containerWidth < minNormalContainerWidth
+                    ? 0
+                    : minSecondaryWidth;
+            const nextMax = !Number.isFinite(containerWidth) || containerWidth <= 0
+                ? maxWidthOption
+                : Math.max(0, Math.min(maxWidthOption, Math.floor(containerWidth - handleWidth - nextSecondaryMin)));
+            maxWidthRef.current = nextMax;
+            setSecondaryMinWidth(nextSecondaryMin);
+            setMaxWidth(nextMax);
+            renderPreferredWidth(preferredWidthRef.current, nextMax);
+        };
+        updateAllowedWidth();
+        if (typeof ResizeObserver !== 'undefined') {
+            const observer = new ResizeObserver(updateAllowedWidth);
+            observer.observe(container);
+            return () => observer.disconnect();
+        }
+        window.addEventListener('resize', updateAllowedWidth);
+        return () => window.removeEventListener('resize', updateAllowedWidth);
+    }, [renderPreferredWidth, minNormalContainerWidth, minSecondaryWidth, maxWidthOption, handleWidth]);
+    useEffect(() => () => finishResize(false), [finishResize]);
+    const onHandlePointerDown = useCallback((event) => {
+        if (event.button !== 0)
+            return;
+        const container = containerRef.current;
+        if (!container)
+            return;
+        event.preventDefault();
+        event.currentTarget.focus();
+        event.currentTarget.setPointerCapture(event.pointerId);
+        pointerCleanupRef.current?.();
+        setIsResizing(true);
+        resizeStartPreferredWidthRef.current = preferredWidthRef.current;
+        const updateWidthFromClientX = (clientX) => {
+            // Non-null assertion, not a guard: finishResize (the only place
+            // resizeStateRef is cleared) always tears down the pointermove
+            // listener that reaches this function in the same synchronous call
+            // that clears the ref, and also cancels any pending RAF before
+            // returning — so no queued pointermove/RAF callback can ever
+            // observe a null state here.
+            const state = resizeStateRef.current;
+            const delta = clientX - state.startClientX;
+            if (delta === 0 && !state.hasMoved)
+                return;
+            state.hasMoved = true;
+            const rawWidth = state.startWidth + (state.isRtl ? -delta : delta);
+            applyWidth(rawWidth, { commitState: false });
+        };
+        const flushPendingPointerMove = () => {
+            if (pointerFrameRef.current !== null) {
+                cancelAnimationFrame(pointerFrameRef.current);
+                pointerFrameRef.current = null;
+            }
+            const clientX = pendingPointerClientXRef.current;
+            pendingPointerClientXRef.current = null;
+            if (clientX !== null)
+                updateWidthFromClientX(clientX);
+        };
+        resizeStateRef.current = {
+            startClientX: event.clientX,
+            startWidth: widthRef.current,
+            isRtl: window.getComputedStyle(container).direction === 'rtl',
+            hasMoved: false,
+        };
+        const handlePointerMove = (moveEvent) => {
+            pendingPointerClientXRef.current = moveEvent.clientX;
+            if (pointerFrameRef.current !== null)
+                return;
+            pointerFrameRef.current = requestAnimationFrame(() => {
+                pointerFrameRef.current = null;
+                flushPendingPointerMove();
+            });
+        };
+        const handlePointerEnd = () => {
+            flushPendingPointerMove();
+            finishResize(true);
+        };
+        const handlePointerCancel = () => {
+            flushPendingPointerMove();
+            preferredWidthRef.current = resizeStartPreferredWidthRef.current;
+            renderPreferredWidth(resizeStartPreferredWidthRef.current);
+            finishResize(false);
+        };
+        const cleanup = () => {
+            window.removeEventListener('pointermove', handlePointerMove);
+            window.removeEventListener('pointerup', handlePointerEnd);
+            window.removeEventListener('pointercancel', handlePointerCancel);
+            window.removeEventListener('blur', handlePointerCancel);
+        };
+        pointerCleanupRef.current = cleanup;
+        window.addEventListener('pointermove', handlePointerMove);
+        window.addEventListener('pointerup', handlePointerEnd);
+        window.addEventListener('pointercancel', handlePointerCancel);
+        window.addEventListener('blur', handlePointerCancel);
+    }, [applyWidth, finishResize, renderPreferredWidth]);
+    const onHandleBlur = useCallback(() => {
+        if (!pointerCleanupRef.current)
+            return;
+        preferredWidthRef.current = resizeStartPreferredWidthRef.current;
+        renderPreferredWidth(resizeStartPreferredWidthRef.current);
+        finishResize(false);
+    }, [finishResize, renderPreferredWidth]);
+    const onHandleKeyDown = useCallback((event) => {
+        let nextWidth = null;
+        const container = containerRef.current;
+        const isRtl = container ? window.getComputedStyle(container).direction === 'rtl' : false;
+        if (event.key === 'ArrowLeft') {
+            nextWidth = widthRef.current + (isRtl ? 1 : -1) * keyboardStep;
+        }
+        else if (event.key === 'ArrowRight') {
+            nextWidth = widthRef.current + (isRtl ? -1 : 1) * keyboardStep;
+        }
+        else if (event.key === 'Home') {
+            nextWidth = minWidth;
+        }
+        else if (event.key === 'End') {
+            nextWidth = maxWidthRef.current;
+        }
+        if (nextWidth === null)
+            return;
+        event.preventDefault();
+        const next = applyWidth(nextWidth);
+        saveWidth(storageKey, next, minWidth, maxWidthOption);
+    }, [applyWidth, keyboardStep, minWidth, maxWidthOption, storageKey]);
+    return {
+        width,
+        maxWidth,
+        secondaryMinWidth,
+        isResizing,
+        containerRef,
+        onHandlePointerDown,
+        onHandleKeyDown,
+        onHandleBlur,
+        containerStyle: {
+            '--resizable-split-pane-primary-width': `${width}px`,
+            '--resizable-split-pane-secondary-track': secondaryTrack,
+            gridTemplateColumns: `${width}px ${handleWidth}px ${secondaryTrack}`,
+        },
+    };
+}
+//# sourceMappingURL=useResizableSplitPane.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Identity-stable delegate for an event handler that closes over fresh state
+ * every render. The returned function never changes, so it can be passed to
+ * React.memo children without invalidating them, while calls always reach the
+ * latest committed closure (the ref is updated in an effect, i.e. post-commit
+ * — safe for event handlers, which only fire after commit; do not call the
+ * result during render).
+ */
+export declare function useStableHandler<Args extends unknown[], Result>(handler: (...args: Args) => Result): (...args: Args) => Result;
+//# sourceMappingURL=useStableHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStableHandler.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useStableHandler.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC7D,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GACjC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAM3B"}

package/dist/react/hooks/useStableHandler.js

@@ -0,0 +1,17 @@
+import { useCallback, useEffect, useRef } from 'react';
+/**
+ * Identity-stable delegate for an event handler that closes over fresh state
+ * every render. The returned function never changes, so it can be passed to
+ * React.memo children without invalidating them, while calls always reach the
+ * latest committed closure (the ref is updated in an effect, i.e. post-commit
+ * — safe for event handlers, which only fire after commit; do not call the
+ * result during render).
+ */
+export function useStableHandler(handler) {
+    const ref = useRef(handler);
+    useEffect(() => {
+        ref.current = handler;
+    });
+    return useCallback((...args) => ref.current(...args), []);
+}
+//# sourceMappingURL=useStableHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStableHandler.js","sourceRoot":"","sources":["../../../src/react/hooks/useStableHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAkC;IAElC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,CAAC,GAAG,IAAU,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/utils/appearance.d.ts

@@ -0,0 +1,32 @@
+export type AppearanceTheme = 'light' | 'dark';
+/** Neutral default accent — hosts are expected to override via their own
+ *  config/branding; this only guarantees the CSS vars are always set. */
+export declare const DEFAULT_ACCENT_COLOR = "#2563eb";
+export declare const ACCENT_SWATCHES: readonly ["#2563eb", "#c96442", "#7c3aed", "#059669", "#dc2626", "#d97706", "#0891b2", "#db2777"];
+/**
+ * Validate and lowercase a `#rrggbb` accent color string.
+ *
+ * @param value - Candidate accent color, typically from persisted config.
+ * @returns The lowercased 6-digit hex string, or `null` if `value` is not a
+ *   string or does not match `#rrggbb`.
+ * @complexity O(1).
+ */
+export declare function normalizeAccentColor(value: unknown): string | null;
+/** `normalizeAccentColor(value) ?? DEFAULT_ACCENT_COLOR` — always returns a
+ *  usable color. */
+export declare function resolveAccentColor(value: unknown): string;
+/**
+ * Apply a theme + accent color to `document.documentElement`: sets/clears
+ * `data-theme` and writes the five `--accent*` custom properties (using
+ * `resolveAccentColor`'s fallback when `accentColor` is missing/invalid).
+ *
+ * @param options.theme - `'light'` / `'dark'` to set `data-theme`, or
+ *   `undefined` to remove the attribute (system/auto).
+ * @param options.accentColor - Candidate accent color; validated before use.
+ * @complexity O(1) — five DOM property writes.
+ */
+export declare function applyAppearanceToDocument({ theme, accentColor, }: {
+    theme?: AppearanceTheme;
+    accentColor?: string;
+}): void;
+//# sourceMappingURL=appearance.d.ts.map

package/dist/utils/appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../src/utils/appearance.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAU/C;yEACyE;AACzE,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,eAAO,MAAM,eAAe,mGASlB,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIlE;AAED;oBACoB;AACpB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAYD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,KAAK,EACL,WAAW,GACZ,EAAE;IACD,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAaP"}

package/dist/utils/appearance.js

@@ -0,0 +1,78 @@
+// Generic light/dark theme + accent-color application: writes a
+// `data-theme` attribute and a small set of `--accent*` CSS custom
+// properties onto `document.documentElement`. Framework-free — a host
+// calls `applyAppearanceToDocument` from whatever state layer it uses
+// (a settings store, a React effect, etc.).
+const ACCENT_VARS = [
+    '--accent',
+    '--accent-strong',
+    '--accent-soft',
+    '--accent-tint',
+    '--accent-hover',
+];
+/** Neutral default accent — hosts are expected to override via their own
+ *  config/branding; this only guarantees the CSS vars are always set. */
+export const DEFAULT_ACCENT_COLOR = '#2563eb';
+export const ACCENT_SWATCHES = [
+    DEFAULT_ACCENT_COLOR,
+    '#c96442',
+    '#7c3aed',
+    '#059669',
+    '#dc2626',
+    '#d97706',
+    '#0891b2',
+    '#db2777',
+];
+/**
+ * Validate and lowercase a `#rrggbb` accent color string.
+ *
+ * @param value - Candidate accent color, typically from persisted config.
+ * @returns The lowercased 6-digit hex string, or `null` if `value` is not a
+ *   string or does not match `#rrggbb`.
+ * @complexity O(1).
+ */
+export function normalizeAccentColor(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return /^#[0-9a-fA-F]{6}$/.test(trimmed) ? trimmed.toLowerCase() : null;
+}
+/** `normalizeAccentColor(value) ?? DEFAULT_ACCENT_COLOR` — always returns a
+ *  usable color. */
+export function resolveAccentColor(value) {
+    return normalizeAccentColor(value) ?? DEFAULT_ACCENT_COLOR;
+}
+function accentVars(accentColor) {
+    return {
+        '--accent': accentColor,
+        '--accent-strong': `color-mix(in srgb, ${accentColor} 86%, var(--text-strong))`,
+        '--accent-soft': `color-mix(in srgb, ${accentColor} 22%, var(--bg-panel))`,
+        '--accent-tint': `color-mix(in srgb, ${accentColor} 12%, var(--bg-panel))`,
+        '--accent-hover': `color-mix(in srgb, ${accentColor} 90%, var(--text-strong))`,
+    };
+}
+/**
+ * Apply a theme + accent color to `document.documentElement`: sets/clears
+ * `data-theme` and writes the five `--accent*` custom properties (using
+ * `resolveAccentColor`'s fallback when `accentColor` is missing/invalid).
+ *
+ * @param options.theme - `'light'` / `'dark'` to set `data-theme`, or
+ *   `undefined` to remove the attribute (system/auto).
+ * @param options.accentColor - Candidate accent color; validated before use.
+ * @complexity O(1) — five DOM property writes.
+ */
+export function applyAppearanceToDocument({ theme, accentColor, }) {
+    const root = document.documentElement;
+    if (theme === 'light' || theme === 'dark') {
+        root.setAttribute('data-theme', theme);
+    }
+    else {
+        root.removeAttribute('data-theme');
+    }
+    const normalized = resolveAccentColor(accentColor);
+    const vars = accentVars(normalized);
+    for (const name of ACCENT_VARS) {
+        root.style.setProperty(name, vars[name]);
+    }
+}
+//# sourceMappingURL=appearance.js.map

package/dist/utils/appearance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.js","sourceRoot":"","sources":["../../src/utils/appearance.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mEAAmE;AACnE,sEAAsE;AACtE,sEAAsE;AACtE,4CAA4C;AAI5C,MAAM,WAAW,GAAG;IAClB,UAAU;IACV,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,gBAAgB;CACR,CAAC;AAEX;yEACyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oBAAoB;IACpB,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACD,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED;oBACoB;AACpB,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,oBAAoB,CAAC,KAAK,CAAC,IAAI,oBAAoB,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,WAAmB;IACrC,OAAO;QACL,UAAU,EAAE,WAAW;QACvB,iBAAiB,EAAE,sBAAsB,WAAW,2BAA2B;QAC/E,eAAe,EAAE,sBAAsB,WAAW,wBAAwB;QAC1E,eAAe,EAAE,sBAAsB,WAAW,wBAAwB;QAC1E,gBAAgB,EAAE,sBAAsB,WAAW,2BAA2B;KAC/E,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CAAC,EACxC,KAAK,EACL,WAAW,GAIZ;IACC,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;IACtC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/utils/auto-open-file.d.ts

@@ -0,0 +1,19 @@
+interface CandidateFile {
+    readonly name: string;
+    readonly path?: string;
+    readonly kind?: string;
+    readonly mtime?: number;
+}
+interface AutoOpenOptions {
+    readonly moduleFileNames?: ReadonlySet<string>;
+}
+export declare function decideAutoOpenAfterWrite(filePath: string, nextFiles: ReadonlyArray<CandidateFile>, options?: AutoOpenOptions): {
+    shouldOpen: boolean;
+    fileName: string | null;
+};
+export interface SelectAutoOpenOptions {
+    readonly preferSiteEntry?: boolean;
+}
+export declare function selectAutoOpenProducedArtifact(producedFiles: ReadonlyArray<CandidateFile>, options?: SelectAutoOpenOptions): string | null;
+export {};
+//# sourceMappingURL=auto-open-file.d.ts.map

package/dist/utils/auto-open-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-open-file.d.ts","sourceRoot":"","sources":["../../src/utils/auto-open-file.ts"],"names":[],"mappings":"AAkBA,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,eAAe;IAKvB,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChD;AAaD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,EACvC,OAAO,GAAE,eAAoB,GAC5B;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAoDlD;AAsCD,MAAM,WAAW,qBAAqB;IAQpC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAMD,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,EAC3C,OAAO,GAAE,qBAA0B,GAClC,MAAM,GAAG,IAAI,CAsCf"}