@n-dx/core 0.1.0

package/packages/web/dist/viewer/tick-visibility-gate.js

@@ -0,0 +1,146 @@
+/**
+ * Tick visibility gate — pauses elapsed time timer updates during tab inactivity.
+ *
+ * Bridges the Page Visibility API (via tab-visibility) to the tick timer's
+ * suspend/resume lifecycle. When the browser tab is backgrounded, the tick
+ * timer's shared setInterval is cleared to conserve CPU and battery. When the
+ * tab returns to the foreground, the timer is resumed with an immediate
+ * catch-up tick so elapsed time displays jump to the correct current value.
+ *
+ * Pipeline position:
+ *
+ *   tab-visibility → **tick-visibility-gate** → tick-timer → batched-tick-dispatcher → useTick → render
+ *
+ * When visible:  tick timer runs normally (1s interval)
+ * When hidden:   tick timer is suspended (no interval, no ticks, zero CPU)
+ * On resume:     immediate catch-up tick → restart interval
+ *
+ * Lifecycle:
+ *
+ *   Tab goes hidden:
+ *     1. Immediately suspend the tick timer (clearInterval).
+ *     2. No ticks fire while the tab is hidden — zero overhead.
+ *
+ *   Tab becomes visible (after resume debounce):
+ *     1. Resume the tick timer — fires an immediate tick for catch-up,
+ *        then restarts the 1-second interval.
+ *     2. The immediate tick causes all elapsed time displays to recompute
+ *        from their absolute startedAt timestamps, jumping to the correct
+ *        current value without waiting up to 1 second.
+ *
+ * The resume is debounced (100ms default) to prevent thrashing during rapid
+ * tab switching (e.g. quick alt-tab sequences). Suspension is always immediate
+ * to stop unnecessary work as fast as possible.
+ *
+ * This module complements the polling-manager (which manages its own set of
+ * registered pollers) and the DOM update gate (which gates state updates).
+ * Together they form a complete tab-inactivity optimization pipeline.
+ *
+ * Designed as a standalone module with zero framework dependencies.
+ */
+import { onVisibilityChange, isTabVisible, } from "./tab-visibility.js";
+import { suspendTickTimer, resumeTickTimer } from "./tick-timer.js";
+// ─── Constants ───────────────────────────────────────────────────────────────
+const DEFAULT_RESUME_DEBOUNCE_MS = 100;
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a new tick visibility gate.
+ *
+ * Usage:
+ * ```ts
+ * // During app initialization (after startTabVisibilityMonitor):
+ * const gate = createTickVisibilityGate();
+ *
+ * // On app shutdown:
+ * gate.dispose();
+ * ```
+ */
+export function createTickVisibilityGate(config = {}) {
+    const resumeDebounceMs = config.resumeDebounceMs ?? DEFAULT_RESUME_DEBOUNCE_MS;
+    const onSuspend = config.onSuspend;
+    const onResume = config.onResume;
+    let running = true;
+    let suspensionCount = 0;
+    let resumeCount = 0;
+    let resumeTimer = null;
+    let disposed = false;
+    // ─── Internal helpers ─────────────────────────────────────────────
+    function clearResumeTimer() {
+        if (resumeTimer !== null) {
+            clearTimeout(resumeTimer);
+            resumeTimer = null;
+        }
+    }
+    function suspend() {
+        if (!running)
+            return;
+        running = false;
+        suspensionCount++;
+        suspendTickTimer();
+        if (onSuspend) {
+            try {
+                onSuspend();
+            }
+            catch {
+                // Swallow errors from the suspend callback.
+            }
+        }
+    }
+    function resume() {
+        if (running)
+            return;
+        running = true;
+        resumeCount++;
+        resumeTickTimer();
+        if (onResume) {
+            try {
+                onResume();
+            }
+            catch {
+                // Swallow errors from the resume callback.
+            }
+        }
+    }
+    function handleVisibilityChange(snapshot) {
+        if (disposed)
+            return;
+        if (snapshot.isVisible) {
+            // Tab became visible — resume with debounce to prevent thrash.
+            clearResumeTimer();
+            resumeTimer = setTimeout(() => {
+                resumeTimer = null;
+                resume();
+            }, resumeDebounceMs);
+        }
+        else {
+            // Tab became hidden — suspend immediately.
+            clearResumeTimer();
+            suspend();
+        }
+    }
+    // Subscribe to tab visibility changes.
+    const unsubVisibility = onVisibilityChange(handleVisibilityChange);
+    // If the tab is currently hidden, suspend immediately.
+    if (!isTabVisible()) {
+        suspend();
+    }
+    // ─── Public methods ─────────────────────────────────────────────────
+    function isRunning() {
+        return running;
+    }
+    function getSnapshot() {
+        return {
+            isRunning: running,
+            suspensionCount,
+            resumeCount,
+            disposed,
+        };
+    }
+    function dispose() {
+        disposed = true;
+        clearResumeTimer();
+        unsubVisibility();
+    }
+    return { isRunning, getSnapshot, dispose };
+}
+//# sourceMappingURL=tick-visibility-gate.js.map

package/packages/web/dist/viewer/tick-visibility-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick-visibility-gate.js","sourceRoot":"","sources":["../../src/viewer/tick-visibility-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EACL,kBAAkB,EAClB,YAAY,GAEb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAkDpE,gFAAgF;AAEhF,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAEvC,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAmC,EAAE;IAErC,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAEjC,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,WAAW,GAAyC,IAAI,CAAC;IAC7D,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,qEAAqE;IAErE,SAAS,gBAAgB;QACvB,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,YAAY,CAAC,WAAW,CAAC,CAAC;YAC1B,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,SAAS,OAAO;QACd,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,OAAO,GAAG,KAAK,CAAC;QAChB,eAAe,EAAE,CAAC;QAElB,gBAAgB,EAAE,CAAC;QAEnB,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,SAAS,EAAE,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,MAAM;QACb,IAAI,OAAO;YAAE,OAAO;QAEpB,OAAO,GAAG,IAAI,CAAC;QACf,WAAW,EAAE,CAAC;QAEd,eAAe,EAAE,CAAC;QAElB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,2CAA2C;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,sBAAsB,CAAC,QAA+B;QAC7D,IAAI,QAAQ;YAAE,OAAO;QAErB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,+DAA+D;YAC/D,gBAAgB,EAAE,CAAC;YACnB,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM,EAAE,CAAC;YACX,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,2CAA2C;YAC3C,gBAAgB,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,eAAe,GAAG,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IAEnE,uDAAuD;IACvD,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,uEAAuE;IAEvE,SAAS,SAAS;QAChB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS,WAAW;QAClB,OAAO;YACL,SAAS,EAAE,OAAO;YAClB,eAAe;YACf,WAAW;YACX,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,SAAS,OAAO;QACd,QAAQ,GAAG,IAAI,CAAC;QAChB,gBAAgB,EAAE,CAAC;QACnB,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/packages/web/dist/viewer/types.d.ts

@@ -0,0 +1,66 @@
+import type { Manifest, Inventory, Imports, Zones, Components, CallGraph, ViewId } from "./external.js";
+export type { ViewId };
+export interface LoadedData {
+    manifest: Manifest | null;
+    inventory: Inventory | null;
+    imports: Imports | null;
+    zones: Zones | null;
+    components: Components | null;
+    callGraph: CallGraph | null;
+}
+export type NavigateTo = (view: ViewId, opts?: {
+    file?: string;
+    zone?: string;
+    runId?: string;
+    taskId?: string;
+}) => void;
+export interface FileDetail {
+    type: "file";
+    title: string;
+    path: string;
+    language?: string;
+    size?: string;
+    lines?: number;
+    role?: string;
+    category?: string;
+    hash?: string;
+    zone?: string;
+    incomingImports?: number;
+}
+export interface ZoneDetail {
+    type: "zone";
+    title: string;
+    id: string;
+    zoneId?: string;
+    description: string;
+    files: number;
+    entryPoints: string[];
+    cohesion: string;
+    coupling: string;
+}
+export interface GenericDetail {
+    type: "generic";
+    title: string;
+    [key: string]: unknown;
+}
+export interface PRDDetail {
+    type: "prd";
+    title: string;
+    id: string;
+    level: string;
+    status: string;
+    description?: string;
+    acceptanceCriteria?: string[];
+    priority?: string;
+    tags?: string[];
+    blockedBy?: string[];
+    startedAt?: string;
+    completedAt?: string;
+    children?: Array<{
+        id: string;
+        title: string;
+        status: string;
+        level: string;
+    }>;
+}
+export type DetailItem = FileDetail | ZoneDetail | GenericDetail | PRDDetail;

package/packages/web/dist/viewer/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/packages/web/dist/viewer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/viewer/types.ts"],"names":[],"mappings":""}

package/packages/web/dist/viewer/update-batcher.d.ts

@@ -0,0 +1,79 @@
+/**
+ * requestAnimationFrame-based update batching for rapid UI state changes.
+ *
+ * When multiple WebSocket messages trigger state updates in quick succession,
+ * this module batches them into a single animation frame to prevent unnecessary
+ * intermediate renders. All queued updaters are composed per-setter and applied
+ * once within one RAF callback, preserving final state consistency.
+ *
+ * Two operating modes:
+ *
+ *   **Enabled (default)** — updaters are queued and applied in the next RAF.
+ *   Multiple `schedule()` calls for the same setter are composed in arrival
+ *   order so the setter is invoked exactly once per frame. Different setters
+ *   are invoked independently within the same frame.
+ *
+ *   **Disabled** — updaters are applied synchronously on each `schedule()`
+ *   call, bypassing RAF entirely. Useful for debugging and testing where
+ *   immediate state visibility is needed.
+ *
+ * Pipeline position:
+ *
+ *   ... → coalescer.onMessage → updateBatcher.schedule(setter, updater) → RAF → render
+ *
+ * Designed as a standalone module with zero framework dependencies.
+ * The Preact integration lives in the consumer (views/prd.ts etc.).
+ */
+/** Configuration for the update batcher. */
+export interface UpdateBatcherConfig {
+    /**
+     * When true, bypasses RAF batching and applies updates synchronously.
+     * Useful for debugging and testing.
+     * Default: false.
+     */
+    disabled?: boolean | undefined;
+}
+/** An update batcher instance. */
+export interface UpdateBatcher {
+    /**
+     * Schedule a state update to be applied in the next animation frame.
+     *
+     * Multiple updates for the same setter are composed in order: each updater
+     * receives the result of the previous, and the setter is called once with
+     * the final composed value — identical to sequential application.
+     *
+     * When batching is disabled, the setter is called immediately.
+     */
+    schedule<T>(setter: (updater: (prev: T) => T) => void, updater: (prev: T) => T): void;
+    /**
+     * Force-flush all pending updates synchronously. Cancels any pending RAF.
+     * No-op if no updates are pending.
+     */
+    flush(): void;
+    /** Whether updates are currently pending in the batch queue. */
+    hasPending(): boolean;
+    /** Dispose: cancel pending RAF, clear queue, ignore future schedules. */
+    dispose(): void;
+}
+/**
+ * Create a new update batcher.
+ *
+ * Usage:
+ * ```ts
+ * const batcher = createUpdateBatcher();
+ *
+ * // In a WebSocket message handler:
+ * coalescer.onMessage = (msg) => {
+ *   if (msg.type === "rex:item-updated") {
+ *     batcher.schedule(setData, (prev) => {
+ *       const newItems = applyItemUpdate(prev.items, msg.itemId, msg.updates);
+ *       return newItems === prev.items ? prev : { ...prev, items: newItems };
+ *     });
+ *   }
+ * };
+ *
+ * // On component unmount:
+ * batcher.dispose();
+ * ```
+ */
+export declare function createUpdateBatcher(config?: UpdateBatcherConfig): UpdateBatcher;

package/packages/web/dist/viewer/update-batcher.js

@@ -0,0 +1,119 @@
+/**
+ * requestAnimationFrame-based update batching for rapid UI state changes.
+ *
+ * When multiple WebSocket messages trigger state updates in quick succession,
+ * this module batches them into a single animation frame to prevent unnecessary
+ * intermediate renders. All queued updaters are composed per-setter and applied
+ * once within one RAF callback, preserving final state consistency.
+ *
+ * Two operating modes:
+ *
+ *   **Enabled (default)** — updaters are queued and applied in the next RAF.
+ *   Multiple `schedule()` calls for the same setter are composed in arrival
+ *   order so the setter is invoked exactly once per frame. Different setters
+ *   are invoked independently within the same frame.
+ *
+ *   **Disabled** — updaters are applied synchronously on each `schedule()`
+ *   call, bypassing RAF entirely. Useful for debugging and testing where
+ *   immediate state visibility is needed.
+ *
+ * Pipeline position:
+ *
+ *   ... → coalescer.onMessage → updateBatcher.schedule(setter, updater) → RAF → render
+ *
+ * Designed as a standalone module with zero framework dependencies.
+ * The Preact integration lives in the consumer (views/prd.ts etc.).
+ */
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a new update batcher.
+ *
+ * Usage:
+ * ```ts
+ * const batcher = createUpdateBatcher();
+ *
+ * // In a WebSocket message handler:
+ * coalescer.onMessage = (msg) => {
+ *   if (msg.type === "rex:item-updated") {
+ *     batcher.schedule(setData, (prev) => {
+ *       const newItems = applyItemUpdate(prev.items, msg.itemId, msg.updates);
+ *       return newItems === prev.items ? prev : { ...prev, items: newItems };
+ *     });
+ *   }
+ * };
+ *
+ * // On component unmount:
+ * batcher.dispose();
+ * ```
+ */
+export function createUpdateBatcher(config) {
+    const disabled = config?.disabled ?? false;
+    // Map from setter reference → array of updater functions.
+    // Using a Map preserves insertion order for deterministic flush ordering.
+    let queue = new Map();
+    let rafId = null;
+    let disposed = false;
+    function applyAll() {
+        const entries = queue;
+        queue = new Map();
+        rafId = null;
+        for (const entry of entries.values()) {
+            // Compose all updaters into a single function call.
+            // Each updater receives the output of the previous one.
+            const composed = (prev) => {
+                let current = prev;
+                for (const updater of entry.updaters) {
+                    current = updater(current);
+                }
+                return current;
+            };
+            entry.setter(composed);
+        }
+    }
+    function scheduleRAF() {
+        if (rafId !== null)
+            return; // Already scheduled
+        rafId = requestAnimationFrame(applyAll);
+    }
+    function cancelRAF() {
+        if (rafId !== null) {
+            cancelAnimationFrame(rafId);
+            rafId = null;
+        }
+    }
+    function schedule(setter, updater) {
+        if (disposed)
+            return;
+        // Disabled mode: apply immediately, no batching.
+        if (disabled) {
+            setter(updater);
+            return;
+        }
+        const key = setter;
+        let entry = queue.get(key);
+        if (!entry) {
+            entry = { setter: key, updaters: [] };
+            queue.set(key, entry);
+        }
+        entry.updaters.push(updater);
+        scheduleRAF();
+    }
+    function flush() {
+        if (disposed)
+            return;
+        if (queue.size === 0)
+            return;
+        cancelRAF();
+        applyAll();
+    }
+    function hasPending() {
+        return queue.size > 0;
+    }
+    function dispose() {
+        disposed = true;
+        cancelRAF();
+        queue = new Map();
+    }
+    return { schedule, flush, hasPending, dispose };
+}
+//# sourceMappingURL=update-batcher.js.map

package/packages/web/dist/viewer/update-batcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-batcher.js","sourceRoot":"","sources":["../../src/viewer/update-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAwDH,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA4B;IAC9D,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,KAAK,CAAC;IAE3C,0DAA0D;IAC1D,0EAA0E;IAC1E,IAAI,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,SAAS,QAAQ;QACf,MAAM,OAAO,GAAG,KAAK,CAAC;QACtB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QAClB,KAAK,GAAG,IAAI,CAAC;QAEb,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,oDAAoD;YACpD,wDAAwD;YACxD,MAAM,QAAQ,GAAe,CAAC,IAAI,EAAE,EAAE;gBACpC,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACrC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC7B,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC;YAEF,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,SAAS,WAAW;QAClB,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,oBAAoB;QAChD,KAAK,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,SAAS;QAChB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC5B,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC;IAED,SAAS,QAAQ,CACf,MAAyC,EACzC,OAAuB;QAEvB,IAAI,QAAQ;YAAE,OAAO;QAErB,iDAAiD;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,MAAmB,CAAC;QAChC,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACtC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAqB,CAAC,CAAC;QAE3C,WAAW,EAAE,CAAC;IAChB,CAAC;IAED,SAAS,KAAK;QACZ,IAAI,QAAQ;YAAE,OAAO;QACrB,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE7B,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,SAAS,UAAU;QACjB,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,SAAS,OAAO;QACd,QAAQ,GAAG,IAAI,CAAC;QAChB,SAAS,EAAE,CAAC;QACZ,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/packages/web/dist/viewer/usage/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared constants for token usage functionality.
+ *
+ * Centralises polling key, interval, and view identifier so that the
+ * token-usage view, polling integration tests, and navigation tests
+ * all reference the same source of truth.
+ */
+import type { ViewId } from "../types.js";
+/** Polling-manager registration key for the token usage poller. */
+export declare const TOKEN_USAGE_POLL_KEY = "token-usage";
+/** Polling interval for automatic usage data refresh (ms). */
+export declare const USAGE_POLL_INTERVAL_MS = 10000;
+/** View ID used in routing and sidebar navigation. */
+export declare const TOKEN_USAGE_VIEW_ID: ViewId;

package/packages/web/dist/viewer/usage/constants.js

@@ -0,0 +1,14 @@
+/**
+ * Shared constants for token usage functionality.
+ *
+ * Centralises polling key, interval, and view identifier so that the
+ * token-usage view, polling integration tests, and navigation tests
+ * all reference the same source of truth.
+ */
+/** Polling-manager registration key for the token usage poller. */
+export const TOKEN_USAGE_POLL_KEY = "token-usage";
+/** Polling interval for automatic usage data refresh (ms). */
+export const USAGE_POLL_INTERVAL_MS = 10_000;
+/** View ID used in routing and sidebar navigation. */
+export const TOKEN_USAGE_VIEW_ID = "token-usage";
+//# sourceMappingURL=constants.js.map

package/packages/web/dist/viewer/usage/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/viewer/usage/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAElD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAW,aAAa,CAAC"}

package/packages/web/dist/viewer/usage/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Token usage module barrel.
+ *
+ * Re-exports shared constants used across the token-usage view,
+ * polling integration, and navigation tests.
+ */
+export { TOKEN_USAGE_POLL_KEY, USAGE_POLL_INTERVAL_MS, TOKEN_USAGE_VIEW_ID, } from "./constants.js";

package/packages/web/dist/viewer/usage/index.js

@@ -0,0 +1,8 @@
+/**
+ * Token usage module barrel.
+ *
+ * Re-exports shared constants used across the token-usage view,
+ * polling integration, and navigation tests.
+ */
+export { TOKEN_USAGE_POLL_KEY, USAGE_POLL_INTERVAL_MS, TOKEN_USAGE_VIEW_ID, } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/packages/web/dist/viewer/usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/viewer/usage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/packages/web/dist/viewer/utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared viewer utilities — path display helpers.
+ *
+ * Color, metric, and flow-diagram utilities have been extracted to the
+ * `visualization/` layer (colors.ts, metrics.ts, flow.ts) to reduce this
+ * module's hub status and consolidate visualization concerns.
+ *
+ * Re-exports are provided below for backward compatibility so existing
+ * consumers don't break.  New code should import from `visualization/`
+ * directly.
+ */
+/** Extract the filename from a path (last segment after '/'). */
+export declare function basename(path: string): string;
+/**
+ * Truncate a filename for graph labels, preserving extension and meaningful prefix.
+ * Returns a shortened name with ellipsis when the name exceeds maxLen characters.
+ *
+ * Examples:
+ *   truncateFilename("very-long-component-name.tsx", 16) → "very-long…e.tsx"
+ *   truncateFilename("short.ts", 16) → "short.ts"
+ */
+export declare function truncateFilename(name: string, maxLen?: number): string;
+export { getZoneColorByIndex, getZoneColor, buildZoneColorMap, } from "./visualization/colors.js";
+export { meterClass } from "./visualization/metrics.js";
+export { buildFileToZoneMap, buildFlowEdges, buildCallFlowEdges, buildExternalImportEdges, buildFlowNodes, } from "./visualization/flow.js";

package/packages/web/dist/viewer/utils.js

@@ -0,0 +1,48 @@
+/**
+ * Shared viewer utilities — path display helpers.
+ *
+ * Color, metric, and flow-diagram utilities have been extracted to the
+ * `visualization/` layer (colors.ts, metrics.ts, flow.ts) to reduce this
+ * module's hub status and consolidate visualization concerns.
+ *
+ * Re-exports are provided below for backward compatibility so existing
+ * consumers don't break.  New code should import from `visualization/`
+ * directly.
+ */
+// ── Path display helpers (owned here) ───────────────────────────────
+/** Extract the filename from a path (last segment after '/'). */
+export function basename(path) {
+    return path.split("/").pop() || path;
+}
+/**
+ * Truncate a filename for graph labels, preserving extension and meaningful prefix.
+ * Returns a shortened name with ellipsis when the name exceeds maxLen characters.
+ *
+ * Examples:
+ *   truncateFilename("very-long-component-name.tsx", 16) → "very-long…e.tsx"
+ *   truncateFilename("short.ts", 16) → "short.ts"
+ */
+export function truncateFilename(name, maxLen = 18) {
+    if (name.length <= maxLen)
+        return name;
+    const dotIdx = name.lastIndexOf(".");
+    if (dotIdx <= 0) {
+        // No extension — simple truncation
+        return name.slice(0, maxLen - 1) + "…";
+    }
+    const ext = name.slice(dotIdx); // e.g. ".tsx"
+    // Keep at least 4 chars of the stem visible + ellipsis + extension
+    const stemBudget = maxLen - ext.length - 1; // -1 for the "…"
+    if (stemBudget < 4) {
+        // Extension too long relative to budget — just truncate the whole thing
+        return name.slice(0, maxLen - 1) + "…";
+    }
+    const stem = name.slice(0, dotIdx);
+    return stem.slice(0, stemBudget) + "…" + ext;
+}
+// ── Backward-compatible re-exports from visualization layer ─────────
+// New code should import from `visualization/` directly.
+export { getZoneColorByIndex, getZoneColor, buildZoneColorMap, } from "./visualization/colors.js";
+export { meterClass } from "./visualization/metrics.js";
+export { buildFileToZoneMap, buildFlowEdges, buildCallFlowEdges, buildExternalImportEdges, buildFlowNodes, } from "./visualization/flow.js";
+//# sourceMappingURL=utils.js.map

package/packages/web/dist/viewer/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/viewer/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AAEvE,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB,EAAE;IAChE,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,mCAAmC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACzC,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc;IAC9C,mEAAmE;IACnE,MAAM,UAAU,GAAG,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iBAAiB;IAC7D,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,wEAAwE;QACxE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;AAC/C,CAAC;AAED,uEAAuE;AACvE,yDAAyD;AACzD,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACf,MAAM,yBAAyB,CAAC"}

package/packages/web/dist/viewer/validate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Client-side data validation for the sourcevision viewer.
+ *
+ * Zod schemas that validate JSON fetched from the server or dropped
+ * as files. Lives in the viewer layer because the viewer is the sole
+ * consumer — the server layer does its own domain-specific validation
+ * independently.
+ */
+import { z } from "zod";
+import type { V1 } from "./external.js";
+export type ValidationResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    errors: z.ZodError;
+};
+export declare function validateManifest(data: unknown): ValidationResult<V1.Manifest>;
+export declare function validateInventory(data: unknown): ValidationResult<V1.Inventory>;
+export declare function validateImports(data: unknown): ValidationResult<V1.Imports>;
+export declare function validateZones(data: unknown): ValidationResult<V1.Zones>;
+export declare function validateComponents(data: unknown): ValidationResult<V1.Components>;
+export declare function validateCallGraph(data: unknown): ValidationResult<V1.CallGraph>;