@n-dx/core 0.1.0

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

@@ -0,0 +1,33 @@
+/**
+ * Data loader for sourcevision viewer.
+ * Fetches and validates .sourcevision/ JSON files.
+ * Supports both server mode (fetch from /data/) and file drop mode.
+ *
+ * Memory-efficient strategies:
+ * - loadModules(): lazy-load data files on demand in parallel
+ * - Selective refresh: only reload files whose mtime changed
+ */
+import type { LoadedData } from "./types.js";
+type DataChangeHandler = (data: LoadedData) => void;
+export declare function getData(): LoadedData;
+export declare function onDataChange(handler: DataChangeHandler): void;
+/** Remove the current data-change handler (for cleanup on unmount). */
+export declare function clearOnChange(): void;
+/**
+ * Lazy-load multiple modules in parallel. Only fetches modules that
+ * are not already loaded. Returns the current data state.
+ */
+export declare function loadModules(keys: Array<keyof LoadedData>): Promise<LoadedData>;
+/** Load data from dropped files */
+export declare function loadFromFiles(files: FileList): Promise<LoadedData>;
+/** Check if we're running in server mode */
+export declare function detectMode(): Promise<"server" | "static">;
+/**
+ * Start polling for data changes (selective refresh — only changed files).
+ * Registers with the centralized polling manager for automatic
+ * suspend/resume based on tab visibility.
+ */
+export declare function startPolling(intervalMs?: number): void;
+/** Stop polling for data changes */
+export declare function stopPolling(): void;
+export {};

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

@@ -0,0 +1,195 @@
+/**
+ * Data loader for sourcevision viewer.
+ * Fetches and validates .sourcevision/ JSON files.
+ * Supports both server mode (fetch from /data/) and file drop mode.
+ *
+ * Memory-efficient strategies:
+ * - loadModules(): lazy-load data files on demand in parallel
+ * - Selective refresh: only reload files whose mtime changed
+ */
+import { validateManifest, validateInventory, validateImports, validateZones, validateComponents, validateCallGraph, } from "./validate.js";
+import { DATA_FILES } from "./external.js";
+import { migrateData } from "./schema-compat.js";
+import { registerPoller, unregisterPoller } from "./polling/polling-manager.js";
+const MODULE_DEFS = [
+    { key: "manifest", file: DATA_FILES.manifest, validate: validateManifest },
+    { key: "inventory", file: DATA_FILES.inventory, validate: validateInventory },
+    { key: "imports", file: DATA_FILES.imports, validate: validateImports },
+    { key: "zones", file: DATA_FILES.zones, validate: validateZones },
+    { key: "components", file: DATA_FILES.components, validate: validateComponents },
+    { key: "callGraph", file: DATA_FILES.callGraph, validate: validateCallGraph },
+];
+/** Map from data filename to its module key, for selective refresh. */
+const FILE_TO_KEY = {};
+for (const mod of MODULE_DEFS) {
+    FILE_TO_KEY[mod.file] = mod.key;
+}
+let currentData = {
+    manifest: null,
+    inventory: null,
+    imports: null,
+    zones: null,
+    components: null,
+    callGraph: null,
+};
+let onChange = null;
+let pollingActive = false;
+let lastMtimes = {};
+export function getData() {
+    return currentData;
+}
+export function onDataChange(handler) {
+    onChange = handler;
+}
+/** Remove the current data-change handler (for cleanup on unmount). */
+export function clearOnChange() {
+    onChange = null;
+}
+function notifyChange() {
+    if (onChange)
+        onChange(currentData);
+}
+/** Fetch, validate, and store a single module. Returns true on success. */
+async function fetchModule(mod) {
+    try {
+        const res = await fetch(`/data/${mod.file}`);
+        if (!res.ok)
+            return false;
+        const raw = await res.json();
+        const migrated = migrateData(mod.key, raw);
+        const result = mod.validate(migrated);
+        if (result.ok) {
+            currentData[mod.key] = result.data;
+            return true;
+        }
+        console.warn(`Validation failed for ${mod.file}:`, result);
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Lazy-load multiple modules in parallel. Only fetches modules that
+ * are not already loaded. Returns the current data state.
+ */
+export async function loadModules(keys) {
+    const toLoad = keys
+        .filter((key) => currentData[key] === null)
+        .map((key) => MODULE_DEFS.find((m) => m.key === key))
+        .filter((mod) => mod !== undefined);
+    if (toLoad.length > 0) {
+        await Promise.allSettled(toLoad.map((mod) => fetchModule(mod)));
+        notifyChange();
+    }
+    return currentData;
+}
+/** Load data from dropped files */
+export async function loadFromFiles(files) {
+    const fileMap = new Map();
+    for (const f of files) {
+        fileMap.set(f.name, f);
+    }
+    for (const mod of MODULE_DEFS) {
+        const file = fileMap.get(mod.file);
+        if (!file)
+            continue;
+        try {
+            const text = await file.text();
+            const raw = JSON.parse(text);
+            const migrated = migrateData(mod.key, raw);
+            const result = mod.validate(migrated);
+            if (result.ok) {
+                currentData[mod.key] = result.data;
+            }
+            else {
+                console.warn(`Validation failed for ${mod.file}:`, result);
+            }
+        }
+        catch (err) {
+            console.warn(`Failed to parse ${mod.file}:`, err);
+        }
+    }
+    notifyChange();
+    return currentData;
+}
+/** Check if we're running in server mode */
+export async function detectMode() {
+    try {
+        const res = await fetch("/data");
+        if (res.ok)
+            return "server";
+    }
+    catch {
+        // Not in server mode
+    }
+    return "static";
+}
+/**
+ * Selectively reload only the data files whose mtime has changed.
+ * More memory-efficient than reloading all files on every change.
+ */
+async function refreshChangedModules(newMtimes) {
+    const changedKeys = [];
+    for (const [file, mtime] of Object.entries(newMtimes)) {
+        if (lastMtimes[file] !== mtime) {
+            const key = FILE_TO_KEY[file];
+            if (key) {
+                changedKeys.push(key);
+            }
+        }
+    }
+    if (changedKeys.length === 0)
+        return;
+    lastMtimes = newMtimes;
+    // Only fetch the modules that actually changed
+    const toLoad = changedKeys
+        .map((key) => MODULE_DEFS.find((m) => m.key === key))
+        .filter((mod) => mod !== undefined);
+    if (toLoad.length > 0) {
+        await Promise.allSettled(toLoad.map((mod) => fetchModule(mod)));
+        notifyChange();
+    }
+}
+/** The polling callback, extracted for registration with the polling manager. */
+async function pollForChanges() {
+    try {
+        const res = await fetch("/data/status");
+        if (!res.ok)
+            return;
+        const status = await res.json();
+        // Check if any file changed
+        let changed = false;
+        for (const [file, mtime] of Object.entries(status.mtimes)) {
+            if (lastMtimes[file] !== mtime) {
+                changed = true;
+                break;
+            }
+        }
+        if (changed) {
+            await refreshChangedModules(status.mtimes);
+        }
+    }
+    catch {
+        // Server may be down — ignore
+    }
+}
+/**
+ * Start polling for data changes (selective refresh — only changed files).
+ * Registers with the centralized polling manager for automatic
+ * suspend/resume based on tab visibility.
+ */
+export function startPolling(intervalMs = 5000) {
+    if (pollingActive)
+        return;
+    pollingActive = true;
+    registerPoller("loader:data-status", pollForChanges, intervalMs);
+}
+/** Stop polling for data changes */
+export function stopPolling() {
+    if (!pollingActive)
+        return;
+    pollingActive = false;
+    unregisterPoller("loader:data-status");
+}
+//# sourceMappingURL=loader.js.map

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

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

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,121 @@
+import { h, render, Fragment } from "preact";
+import { useState, useEffect, useMemo, useCallback } from "preact/hooks";
+import { ALL_DATA_FILES } from "./external.js";
+import { Sidebar, DetailPanel, Guide, Breadcrumb, updateFavicon, MemoryWarningBanner, CrashRecoveryBanner, DegradationBanner, RefreshQueueStatus, PollingSuspensionIndicator, SearchOverlay, useSearchOverlay, } from "./components/index.js";
+import { useRouteState, useAppData, useMemoryMonitor, useCrashRecovery, useGracefulDegradation, useRefreshThrottle, usePollingSuspension, } from "./hooks/index.js";
+import { bootstrap } from "./bootstrap.js";
+import { renderActiveView, buildValidViews } from "./views/view-registry.js";
+bootstrap();
+/** Fetch viewer scope from the server config endpoint. */
+async function fetchScope() {
+    try {
+        const res = await fetch("/api/config");
+        if (!res.ok)
+            return null;
+        const config = await res.json();
+        return config.scope ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+const SIDEBAR_COLLAPSED_KEY = "sidebar-collapsed";
+function getInitialSidebarCollapsed() {
+    try {
+        return localStorage.getItem(SIDEBAR_COLLAPSED_KEY) === "true";
+    }
+    catch {
+        return false;
+    }
+}
+function App({ scope }) {
+    const validViews = useMemo(() => buildValidViews(scope), [scope]);
+    const { view, selectedFile, setSelectedFile, selectedZone, selectedRunId, selectedTaskId, navigateTo, handleSidebarNav, } = useRouteState(validViews);
+    const { snapshot: memorySnapshot, level: memoryLevel, showWarning: showMemoryWarning, dismiss: dismissMemoryWarning } = useMemoryMonitor();
+    const { tier: degradationTier, isDegraded, summary: degradationSummary, disabledFeatures, isDisabled: isFeatureDisabled, } = useGracefulDegradation();
+    const { state: refreshQueueState } = useRefreshThrottle();
+    const { isSuspended: pollingSuspended, suspendedCount: pollingSuspendedCount } = usePollingSuspension();
+    const [searchOpen, , closeSearch] = useSearchOverlay();
+    const { data, loading, refreshToast, showDrop } = useAppData({ pausePolling: isFeatureDisabled("autoRefresh") });
+    const { showRecovery, crashLoop, recentCrashCount, recoveredState, dismiss: dismissRecovery, restore: restoreCrashState, } = useCrashRecovery({ view, selectedFile, selectedZone, selectedRunId, selectedTaskId });
+    const [detail, setDetail] = useState(null);
+    const [degradationDismissed, setDegradationDismissed] = useState(false);
+    const [sidebarCollapsed, setSidebarCollapsed] = useState(getInitialSidebarCollapsed);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const [prdDetailContent, setPrdDetailContent] = useState(null);
+    const handleRestore = () => {
+        const state = restoreCrashState();
+        if (state) {
+            navigateTo(state.view, {
+                file: state.selectedFile ?? undefined,
+                zone: state.selectedZone ?? undefined,
+                runId: state.selectedRunId ?? undefined,
+                taskId: state.selectedTaskId ?? undefined,
+            });
+        }
+    };
+    const handleManualRefresh = useCallback(() => {
+        window.location.reload();
+    }, []);
+    const handleToggleSidebar = () => {
+        setSidebarCollapsed((prev) => {
+            const next = !prev;
+            try {
+                localStorage.setItem(SIDEBAR_COLLAPSED_KEY, String(next));
+            }
+            catch { /* noop */ }
+            return next;
+        });
+    };
+    // Re-show degradation banner when tier escalates
+    useEffect(() => {
+        if (isDegraded)
+            setDegradationDismissed(false);
+    }, [degradationTier]);
+    // Toggle CSS animation suppression class when animations are degraded
+    useEffect(() => {
+        const el = document.documentElement;
+        if (isFeatureDisabled("animations")) {
+            el.classList.add("degradation-no-animations");
+        }
+        else {
+            el.classList.remove("degradation-no-animations");
+        }
+        return () => { el.classList.remove("degradation-no-animations"); };
+    }, [isFeatureDisabled]);
+    // Scroll to top on view change
+    useEffect(() => {
+        document.getElementById("main-content")?.scrollTo(0, 0);
+    }, [view]);
+    // Update browser favicon to match the active product section
+    useEffect(() => {
+        updateFavicon(view);
+    }, [view]);
+    const hasData = data.manifest || data.inventory || data.imports || data.zones;
+    // Show degradation banner when degraded and not already showing the memory warning (avoid stacking)
+    const showDegradationBanner = isDegraded && !degradationDismissed && !showMemoryWarning;
+    return h(Fragment, null, h(CrashRecoveryBanner, { visible: showRecovery, crashLoop, recentCrashCount, recoveredState, onDismiss: dismissRecovery, onRestore: handleRestore }), h(MemoryWarningBanner, { snapshot: memorySnapshot, level: memoryLevel, visible: showMemoryWarning, onDismiss: dismissMemoryWarning }), h(DegradationBanner, { tier: degradationTier, isDegraded, summary: degradationSummary, disabledFeatures, visible: showDegradationBanner, onDismiss: () => setDegradationDismissed(true) }), h("a", { href: "#main-content", class: "skip-link" }, "Skip to main content"), h(Sidebar, { view, onNavigate: handleSidebarNav, manifest: data.manifest, zones: data.zones, sidebarCollapsed, onToggleSidebar: handleToggleSidebar, scope }), h("main", {
+        id: "main-content",
+        class: "main",
+        role: "main",
+        "aria-label": "Main content",
+    }, 
+    // Page-context bar: breadcrumb navigation + help buttons
+    h("div", { class: "page-context-bar", role: "group", "aria-label": "Page navigation and help" }, h(Breadcrumb, { view, navigateTo, scope }), h("div", { class: "page-context-actions" }, h(Guide, { view }))), loading
+        ? h("div", { class: "loading", role: "status", "aria-live": "polite" }, "Loading...")
+        : renderActiveView(view, { data, setDetail, setPrdDetailContent, selectedFile, setSelectedFile, selectedZone, selectedRunId, selectedTaskId, navigateTo, isFeatureDisabled })), !isFeatureDisabled("detailPanel")
+        ? h(DetailPanel, { detail, data, navigateTo, onClose: () => { setDetail(null); setPrdDetailContent(null); }, prdDetailContent })
+        : null, (refreshToast && !isFeatureDisabled("autoRefresh"))
+        ? h("div", { class: "refresh-toast", role: "status", "aria-live": "polite" }, "Data updated")
+        : null, h(RefreshQueueStatus, { state: refreshQueueState, visible: !isFeatureDisabled("autoRefresh") }), h(PollingSuspensionIndicator, { isSuspended: pollingSuspended, suspendedCount: pollingSuspendedCount, onRefresh: handleManualRefresh }), (showDrop && !hasData)
+        ? h("div", { class: "drop-overlay", role: "dialog", "aria-label": "File drop zone" }, h("div", { class: "drop-box" }, h("h2", null, "Drop .sourcevision files"), h("p", null, `Drag and drop ${ALL_DATA_FILES.join(", ")}`)))
+        : null, h(SearchOverlay, { visible: searchOpen, onClose: closeSearch, navigateTo }));
+}
+const root = document.getElementById("app");
+if (root) {
+    // Fetch scope before first render to avoid flash of unscoped content
+    fetchScope().then((scope) => {
+        render(h(App, { scope }), root);
+    });
+}
+//# sourceMappingURL=main.js.map

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

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

package/packages/web/dist/viewer/memory-monitor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Client-side memory usage monitoring and early warning system.
+ *
+ * Tracks browser memory consumption in real-time, detects approaching
+ * memory limits, and triggers graceful degradation before OOM crashes.
+ *
+ * Uses `performance.memory` (Chrome/Edge) for precise readings and
+ * falls back to heuristic-based estimation on other browsers.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact hook (`useMemoryMonitor`) is provided separately.
+ */
+/** Memory usage snapshot at a point in time. */
+export interface MemorySnapshot {
+    /** JS heap currently used (bytes). -1 if unavailable. */
+    usedJSHeapSize: number;
+    /** Total JS heap allocated by the browser (bytes). -1 if unavailable. */
+    totalJSHeapSize: number;
+    /** JS heap size limit (bytes). -1 if unavailable. */
+    jsHeapSizeLimit: number;
+    /** Usage ratio: usedJSHeapSize / jsHeapSizeLimit (0–1). -1 if unavailable. */
+    usageRatio: number;
+    /** Current warning level based on threshold configuration. */
+    level: MemoryLevel;
+    /** ISO timestamp of when this snapshot was taken. */
+    timestamp: string;
+    /** Whether precise memory data is available (Chrome/Edge only). */
+    precise: boolean;
+}
+/** Warning levels ordered by severity. */
+export type MemoryLevel = "normal" | "elevated" | "warning" | "critical";
+/** Threshold configuration for memory warning levels. */
+export interface MemoryThresholds {
+    /** Ratio above which level becomes "elevated" (default: 0.50). */
+    elevated: number;
+    /** Ratio above which level becomes "warning" (default: 0.70). */
+    warning: number;
+    /** Ratio above which level becomes "critical" (default: 0.85). */
+    critical: number;
+}
+/** Callback invoked when memory level changes. */
+export type MemoryLevelChangeHandler = (snapshot: MemorySnapshot, previousLevel: MemoryLevel) => void;
+/** Configuration for the memory monitor. */
+export interface MemoryMonitorConfig {
+    /** Polling interval in milliseconds (default: 5000). */
+    intervalMs: number;
+    /** Warning thresholds (ratios 0–1). */
+    thresholds: MemoryThresholds;
+    /** Called when the memory level changes (e.g. normal → warning). */
+    onLevelChange: MemoryLevelChangeHandler | null;
+}
+/** Check if the browser exposes precise memory metrics. */
+export declare function hasPerformanceMemory(): boolean;
+/** Determine the memory level for a given usage ratio. */
+export declare function classifyLevel(ratio: number, thresholds: MemoryThresholds): MemoryLevel;
+/** Take a memory snapshot using the best available API. */
+export declare function takeSnapshot(thresholds?: MemoryThresholds): MemorySnapshot;
+/** Format bytes as a human-readable string (e.g. "142.5 MB"). */
+export declare function formatBytes(bytes: number): string;
+/** Format a usage ratio as a percentage string (e.g. "72.3%"). */
+export declare function formatRatio(ratio: number): string;
+/** Subscribe to every new snapshot. Returns an unsubscribe function. */
+export declare function onSnapshot(listener: (snapshot: MemorySnapshot) => void): () => void;
+/**
+ * Start the memory monitor with the given configuration overrides.
+ * Safe to call multiple times — restarts with new config if already running.
+ */
+export declare function startMemoryMonitor(overrides?: Partial<MemoryMonitorConfig>): void;
+/** Stop the memory monitor and clean up. */
+export declare function stopMemoryMonitor(): void;
+/** Get the most recent memory snapshot, or null if the monitor has not run. */
+export declare function getLatestSnapshot(): MemorySnapshot | null;
+/** Get the snapshot history (up to MAX_HISTORY_LENGTH entries). */
+export declare function getSnapshotHistory(): readonly MemorySnapshot[];
+/** Get the current memory warning level. */
+export declare function getCurrentLevel(): MemoryLevel;
+/** Reset all module state (for testing). */
+export declare function resetMemoryMonitor(): void;