@n-dx/web 0.1.0

package/dist/viewer/components/zone-slideout.d.ts

@@ -0,0 +1,17 @@
+import type { Zone, ZoneCrossing } from "../external.js";
+import type { NavigateTo } from "../types.js";
+export interface ZoneSlideoutProps {
+    /** Zone to display, or null to hide the panel. */
+    zone: Zone | null;
+    /** All crossings for computing dependencies. */
+    crossings: ZoneCrossing[];
+    /** Full zone list for color lookup and dependency name resolution. */
+    allZones: Zone[];
+    /** Close the slideout. */
+    onClose: () => void;
+    /** Navigate to a file when clicked. */
+    onFileClick?: (path: string) => void;
+    /** Navigate to a different view. */
+    navigateTo?: NavigateTo;
+}
+export declare function ZoneSlideout({ zone, crossings, allZones, onClose, onFileClick, navigateTo, }: ZoneSlideoutProps): import("preact").VNode<import("preact").Attributes> | null;

package/dist/viewer/components/zone-slideout.js

@@ -0,0 +1,162 @@
+import { h, Fragment } from "preact";
+import { useState, useEffect, useCallback } from "preact/hooks";
+import { getZoneColorByIndex } from "../visualization/colors.js";
+import { meterClass } from "../visualization/metrics.js";
+import { basename } from "../utils.js";
+// ── Component ──────────────────────────────────────────────────────────
+export function ZoneSlideout({ zone, crossings, allZones, onClose, onFileClick, navigateTo, }) {
+    const [showFiles, setShowFiles] = useState(false);
+    // Reset file list when zone changes
+    useEffect(() => { setShowFiles(false); }, [zone?.id]);
+    // Close on Escape
+    useEffect(() => {
+        if (!zone)
+            return;
+        const handleKey = (e) => {
+            if (e.key === "Escape")
+                onClose();
+        };
+        document.addEventListener("keydown", handleKey);
+        return () => document.removeEventListener("keydown", handleKey);
+    }, [zone, onClose]);
+    // Trap focus inside the panel when open
+    const panelRef = useCallback((el) => {
+        if (el)
+            el.focus();
+    }, []);
+    if (!zone)
+        return null;
+    const zoneIdx = allZones.indexOf(zone);
+    const color = getZoneColorByIndex(zoneIdx >= 0 ? zoneIdx : 0);
+    // Dependencies
+    const incoming = crossings.filter((c) => c.toZone === zone.id);
+    const outgoing = crossings.filter((c) => c.fromZone === zone.id);
+    const incomingByZone = groupBy(incoming, (c) => c.fromZone);
+    const outgoingByZone = groupBy(outgoing, (c) => c.toZone);
+    return h(Fragment, null, 
+    // Backdrop — click to dismiss
+    h("div", {
+        class: "zone-slideout-backdrop open",
+        onClick: onClose,
+        "aria-hidden": "true",
+    }), 
+    // Panel
+    h("aside", {
+        ref: panelRef,
+        class: "zone-slideout open",
+        role: "complementary",
+        "aria-label": `Zone details: ${zone.name}`,
+        tabIndex: -1,
+        style: `--zone-accent: ${color}`,
+    }, 
+    // Header
+    h("div", { class: "zone-slideout-header" }, h("div", { class: "zone-slideout-title" }, h("span", { class: "zone-slideout-dot", style: `background: ${color}` }), h("h3", null, zone.name)), h("button", {
+        class: "zone-slideout-close",
+        onClick: onClose,
+        "aria-label": "Close zone details",
+        title: "Close (Esc)",
+    }, "\u2715")), 
+    // Description
+    zone.description
+        ? h("p", { class: "zone-slideout-desc" }, zone.description)
+        : null, 
+    // Metrics row
+    h("div", { class: "zone-slideout-metrics" }, h("div", { class: "zone-slideout-metric" }, h("span", { class: "zone-slideout-metric-val" }, zone.files.length), h("span", { class: "zone-slideout-metric-lbl" }, "files")), h("div", { class: "zone-slideout-metric" }, h("span", {
+        class: "zone-slideout-metric-val",
+        style: `color: ${cohesionColor(zone.cohesion)}`,
+    }, zone.cohesion.toFixed(2)), h("span", { class: "zone-slideout-metric-lbl" }, "cohesion")), h("div", { class: "zone-slideout-metric" }, h("span", {
+        class: "zone-slideout-metric-val",
+        style: `color: ${couplingColor(zone.coupling)}`,
+    }, zone.coupling.toFixed(2)), h("span", { class: "zone-slideout-metric-lbl" }, "coupling"))), 
+    // Cohesion meter
+    h("div", { class: "zone-slideout-meter-row" }, h("span", { class: "zone-slideout-meter-label" }, "Cohesion"), h("div", { class: "meter" }, h("div", {
+        class: `meter-fill ${meterClass(zone.cohesion)}`,
+        style: `width: ${zone.cohesion * 100}%`,
+    }))), 
+    // Coupling meter
+    h("div", { class: "zone-slideout-meter-row" }, h("span", { class: "zone-slideout-meter-label" }, "Coupling"), h("div", { class: "meter" }, h("div", {
+        class: `meter-fill ${meterClass(zone.coupling, true)}`,
+        style: `width: ${zone.coupling * 100}%`,
+    }))), 
+    // Entry points
+    zone.entryPoints.length > 0
+        ? h("div", { class: "zone-slideout-section" }, h("h4", null, "Entry Points"), h("ul", { class: "zone-slideout-list" }, zone.entryPoints.slice(0, 8).map((ep) => h("li", {
+            key: ep,
+            class: `zone-slideout-list-item mono-sm ${onFileClick ? "clickable" : ""}`,
+            title: ep,
+            onClick: onFileClick ? () => onFileClick(ep) : undefined,
+        }, basename(ep))), zone.entryPoints.length > 8
+            ? h("li", { class: "zone-slideout-list-more" }, `+${zone.entryPoints.length - 8} more`)
+            : null))
+        : null, 
+    // Insights
+    zone.insights && zone.insights.length > 0
+        ? h("div", { class: "zone-slideout-section" }, h("h4", null, "Insights"), h("ul", { class: "zone-slideout-list" }, zone.insights.slice(0, 6).map((ins, i) => h("li", { key: i, class: "zone-slideout-list-item" }, ins)), zone.insights.length > 6
+            ? h("li", { class: "zone-slideout-list-more" }, `+${zone.insights.length - 6} more`)
+            : null))
+        : null, 
+    // Sub-zones
+    zone.subZones && zone.subZones.length > 0
+        ? h("div", { class: "zone-slideout-section" }, h("h4", null, "Sub-zones"), h("ul", { class: "zone-slideout-list" }, zone.subZones.slice(0, 6).map((sz) => h("li", { key: sz.id, class: "zone-slideout-dep-item" }, h("span", null, sz.name), h("span", { class: "zone-slideout-dep-count" }, `${sz.files.length} files`))), zone.subZones.length > 6
+            ? h("li", { class: "zone-slideout-list-more" }, `+${zone.subZones.length - 6} more`)
+            : null))
+        : null, 
+    // Dependencies
+    (Object.keys(incomingByZone).length > 0 || Object.keys(outgoingByZone).length > 0)
+        ? h("div", { class: "zone-slideout-section" }, h("h4", null, "Dependencies"), h("div", { class: "zone-slideout-deps" }, Object.keys(outgoingByZone).length > 0
+            ? h("div", { class: "zone-slideout-dep-col" }, h("span", { class: "zone-slideout-dep-label" }, "Depends on"), ...Object.entries(outgoingByZone).slice(0, 6).map(([zoneId, items]) => {
+                const target = allZones.find((z) => z.id === zoneId);
+                return h("div", { key: zoneId, class: "zone-slideout-dep-item" }, h("span", null, target?.name || zoneId), h("span", { class: "zone-slideout-dep-count" }, items.length));
+            }))
+            : null, Object.keys(incomingByZone).length > 0
+            ? h("div", { class: "zone-slideout-dep-col" }, h("span", { class: "zone-slideout-dep-label" }, "Used by"), ...Object.entries(incomingByZone).slice(0, 6).map(([zoneId, items]) => {
+                const source = allZones.find((z) => z.id === zoneId);
+                return h("div", { key: zoneId, class: "zone-slideout-dep-item" }, h("span", null, source?.name || zoneId), h("span", { class: "zone-slideout-dep-count" }, items.length));
+            }))
+            : null))
+        : null, 
+    // Files toggle
+    h("div", { class: "zone-slideout-section" }, h("button", {
+        class: "zone-slideout-files-toggle",
+        onClick: () => setShowFiles(!showFiles),
+    }, showFiles ? "Hide files" : `Show ${zone.files.length} files`), showFiles
+        ? h("ul", { class: "zone-slideout-file-list" }, zone.files.map((f) => h("li", {
+            key: f,
+            class: `zone-slideout-file-item mono-sm ${onFileClick ? "clickable" : ""}`,
+            onClick: onFileClick ? () => onFileClick(f) : undefined,
+        }, h("span", { class: "zone-slideout-file-path" }, f), zone.entryPoints.includes(f)
+            ? h("span", { class: "zone-slideout-entry-badge" }, "entry")
+            : null)))
+        : null), 
+    // Navigation buttons
+    navigateTo
+        ? h("div", { class: "zone-slideout-nav" }, h("button", {
+            class: "zone-slideout-nav-btn",
+            onClick: () => navigateTo("files", { zone: zone.id }),
+        }, "\u2630 View in Files"), h("button", {
+            class: "zone-slideout-nav-btn",
+            onClick: () => navigateTo("problems"),
+        }, "\u26A0 View Problems"), h("button", {
+            class: "zone-slideout-nav-btn",
+            onClick: () => navigateTo("suggestions"),
+        }, "\u2728 View Suggestions"))
+        : null));
+}
+// ── Helpers ────────────────────────────────────────────────────────────
+function cohesionColor(v) {
+    return v >= 0.7 ? "var(--green)" : v >= 0.4 ? "var(--orange)" : "var(--red)";
+}
+function couplingColor(v) {
+    return v <= 0.3 ? "var(--green)" : v <= 0.5 ? "var(--orange)" : "var(--red)";
+}
+function groupBy(items, key) {
+    const result = {};
+    for (const item of items) {
+        const k = key(item);
+        if (!result[k])
+            result[k] = [];
+        result[k].push(item);
+    }
+    return result;
+}
+//# sourceMappingURL=zone-slideout.js.map

package/dist/viewer/components/zone-slideout.js.map

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

package/dist/viewer/crash/crash-detector.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Client-side crash detection and automatic recovery.
+ *
+ * Detects memory-related browser crashes using a sessionStorage heartbeat:
+ * a "running" flag is set on page load and cleared on clean unload. If the
+ * flag is still present at next load, the previous session ended abnormally
+ * — most likely an OOM crash or browser-killed tab (error code 5).
+ *
+ * Tracks crash history to detect crash loops and preserves the user's
+ * navigation state so it can be restored after recovery.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact hook (`useCrashRecovery`) is provided separately.
+ */
+import type { ViewId } from "../../shared/view-id.js";
+/** Saved navigation state that survives a crash. */
+export interface SavedNavigationState {
+    view: ViewId;
+    selectedFile: string | null;
+    selectedZone: string | null;
+    selectedRunId: string | null;
+    selectedTaskId: string | null;
+    timestamp: string;
+}
+/** Result of crash detection performed at page load. */
+export interface CrashDetectionResult {
+    /** Whether a crash was detected (previous session didn't unload cleanly). */
+    crashed: boolean;
+    /** Whether multiple crashes happened recently (crash loop). */
+    crashLoop: boolean;
+    /** Number of recent crashes within the loop window. */
+    recentCrashCount: number;
+    /** Recovered navigation state from before the crash, if available. */
+    recoveredState: SavedNavigationState | null;
+}
+/**
+ * Detect whether the previous session ended in a crash.
+ *
+ * Must be called **once** early in page startup (before any clean unload
+ * has a chance to clear the heartbeat). Returns the detection result and
+ * installs the heartbeat + unload handler for this session.
+ *
+ * Safe to call multiple times — returns the cached result after first call.
+ */
+export declare function detectCrash(): CrashDetectionResult;
+/**
+ * Save the current navigation state so it can be restored after a crash.
+ *
+ * Call this on every view change to keep the saved state fresh.
+ */
+export declare function saveNavigationState(state: Omit<SavedNavigationState, "timestamp">): void;
+/**
+ * Clear the saved navigation state (e.g. after successful recovery).
+ */
+export declare function clearSavedNavigationState(): void;
+/**
+ * Mark that the recovery banner has been shown/dismissed in this session.
+ */
+export declare function markRecoveryShown(): void;
+/**
+ * Check if recovery was already shown in this session.
+ */
+export declare function wasRecoveryShown(): boolean;
+/** Get the cached crash detection result (null if detectCrash hasn't been called). */
+export declare function getDetectionResult(): CrashDetectionResult | null;
+/** Clear the crash history. */
+export declare function clearCrashHistory(): void;
+/** Reset all module state (for testing). */
+export declare function resetCrashDetector(): void;

package/dist/viewer/crash/crash-detector.js

@@ -0,0 +1,239 @@
+/**
+ * Client-side crash detection and automatic recovery.
+ *
+ * Detects memory-related browser crashes using a sessionStorage heartbeat:
+ * a "running" flag is set on page load and cleared on clean unload. If the
+ * flag is still present at next load, the previous session ended abnormally
+ * — most likely an OOM crash or browser-killed tab (error code 5).
+ *
+ * Tracks crash history to detect crash loops and preserves the user's
+ * navigation state so it can be restored after recovery.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact hook (`useCrashRecovery`) is provided separately.
+ */
+// ─── Constants ───────────────────────────────────────────────────────────────
+/** sessionStorage key: set while the page is alive, cleared on clean unload. */
+const HEARTBEAT_KEY = "ndx-crash-heartbeat";
+/** sessionStorage key: saved navigation state for recovery. */
+const NAV_STATE_KEY = "ndx-crash-nav-state";
+/** sessionStorage key: JSON array of recent crash timestamps. */
+const CRASH_HISTORY_KEY = "ndx-crash-history";
+/** sessionStorage key: tracks whether we've already shown recovery for this session. */
+const RECOVERY_SHOWN_KEY = "ndx-crash-recovery-shown";
+/** Time window for crash loop detection (5 minutes). */
+const CRASH_LOOP_WINDOW_MS = 5 * 60 * 1000;
+/** Number of crashes within the window that constitutes a loop. */
+const CRASH_LOOP_THRESHOLD = 2;
+/** Maximum crash history entries to retain. */
+const MAX_CRASH_HISTORY = 10;
+// ─── Storage helpers ─────────────────────────────────────────────────────────
+function storageAvailable() {
+    try {
+        const key = "__ndx_storage_test__";
+        sessionStorage.setItem(key, "1");
+        sessionStorage.removeItem(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getJSON(key) {
+    try {
+        const raw = sessionStorage.getItem(key);
+        if (!raw)
+            return null;
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function setJSON(key, value) {
+    try {
+        sessionStorage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        // Storage full or unavailable — silently ignore.
+    }
+}
+// ─── Crash history management ────────────────────────────────────────────────
+function getCrashHistory() {
+    return getJSON(CRASH_HISTORY_KEY) ?? [];
+}
+function addCrashRecord() {
+    const history = getCrashHistory();
+    history.push({ timestamp: new Date().toISOString() });
+    // Trim to bounded size.
+    const trimmed = history.slice(-MAX_CRASH_HISTORY);
+    setJSON(CRASH_HISTORY_KEY, trimmed);
+    return trimmed;
+}
+function getRecentCrashCount(history) {
+    const cutoff = Date.now() - CRASH_LOOP_WINDOW_MS;
+    return history.filter((r) => new Date(r.timestamp).getTime() > cutoff).length;
+}
+// ─── Heartbeat lifecycle ─────────────────────────────────────────────────────
+/** Set the heartbeat flag — call once at page startup. */
+function setHeartbeat() {
+    try {
+        sessionStorage.setItem(HEARTBEAT_KEY, new Date().toISOString());
+    }
+    catch {
+        // noop
+    }
+}
+/** Clear the heartbeat flag — called on clean page unload. */
+function clearHeartbeat() {
+    try {
+        sessionStorage.removeItem(HEARTBEAT_KEY);
+    }
+    catch {
+        // noop
+    }
+}
+/** Check whether the heartbeat was left set from a previous load. */
+function heartbeatPresent() {
+    try {
+        return sessionStorage.getItem(HEARTBEAT_KEY) !== null;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Module state ────────────────────────────────────────────────────────────
+let initialized = false;
+let detectionResult = null;
+let unloadHandler = null;
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Detect whether the previous session ended in a crash.
+ *
+ * Must be called **once** early in page startup (before any clean unload
+ * has a chance to clear the heartbeat). Returns the detection result and
+ * installs the heartbeat + unload handler for this session.
+ *
+ * Safe to call multiple times — returns the cached result after first call.
+ */
+export function detectCrash() {
+    if (detectionResult)
+        return detectionResult;
+    if (!storageAvailable()) {
+        detectionResult = {
+            crashed: false,
+            crashLoop: false,
+            recentCrashCount: 0,
+            recoveredState: null,
+        };
+        return detectionResult;
+    }
+    const crashed = heartbeatPresent();
+    let recoveredState = null;
+    let recentCrashCount = 0;
+    let crashLoop = false;
+    if (crashed) {
+        // Record this crash in history.
+        const history = addCrashRecord();
+        recentCrashCount = getRecentCrashCount(history);
+        crashLoop = recentCrashCount >= CRASH_LOOP_THRESHOLD;
+        // Recover saved navigation state.
+        recoveredState = getJSON(NAV_STATE_KEY);
+    }
+    detectionResult = { crashed, crashLoop, recentCrashCount, recoveredState };
+    // Install heartbeat for this session.
+    setHeartbeat();
+    // Clear heartbeat on clean unload so next load won't see a false crash.
+    unloadHandler = () => clearHeartbeat();
+    window.addEventListener("beforeunload", unloadHandler);
+    // Mark recovery as not yet shown for this session.
+    try {
+        sessionStorage.removeItem(RECOVERY_SHOWN_KEY);
+    }
+    catch {
+        // noop
+    }
+    initialized = true;
+    return detectionResult;
+}
+/**
+ * Save the current navigation state so it can be restored after a crash.
+ *
+ * Call this on every view change to keep the saved state fresh.
+ */
+export function saveNavigationState(state) {
+    if (!storageAvailable())
+        return;
+    const full = {
+        ...state,
+        timestamp: new Date().toISOString(),
+    };
+    setJSON(NAV_STATE_KEY, full);
+}
+/**
+ * Clear the saved navigation state (e.g. after successful recovery).
+ */
+export function clearSavedNavigationState() {
+    try {
+        sessionStorage.removeItem(NAV_STATE_KEY);
+    }
+    catch {
+        // noop
+    }
+}
+/**
+ * Mark that the recovery banner has been shown/dismissed in this session.
+ */
+export function markRecoveryShown() {
+    try {
+        sessionStorage.setItem(RECOVERY_SHOWN_KEY, "true");
+    }
+    catch {
+        // noop
+    }
+}
+/**
+ * Check if recovery was already shown in this session.
+ */
+export function wasRecoveryShown() {
+    try {
+        return sessionStorage.getItem(RECOVERY_SHOWN_KEY) === "true";
+    }
+    catch {
+        return false;
+    }
+}
+/** Get the cached crash detection result (null if detectCrash hasn't been called). */
+export function getDetectionResult() {
+    return detectionResult;
+}
+/** Clear the crash history. */
+export function clearCrashHistory() {
+    try {
+        sessionStorage.removeItem(CRASH_HISTORY_KEY);
+    }
+    catch {
+        // noop
+    }
+}
+/** Reset all module state (for testing). */
+export function resetCrashDetector() {
+    if (unloadHandler) {
+        window.removeEventListener("beforeunload", unloadHandler);
+        unloadHandler = null;
+    }
+    initialized = false;
+    detectionResult = null;
+    try {
+        sessionStorage.removeItem(HEARTBEAT_KEY);
+        sessionStorage.removeItem(NAV_STATE_KEY);
+        sessionStorage.removeItem(CRASH_HISTORY_KEY);
+        sessionStorage.removeItem(RECOVERY_SHOWN_KEY);
+    }
+    catch {
+        // noop
+    }
+}
+// Test-only constants and helpers are in tests/helpers/crash-detector-test-support.ts
+// to keep the production API surface clean.
+//# sourceMappingURL=crash-detector.js.map

package/dist/viewer/crash/crash-detector.js.map

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

package/dist/viewer/crash/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Crash recovery zone public interface.
+ *
+ * All cross-zone consumers should import from this barrel rather than
+ * the crash-detector implementation file directly.
+ */
+export { detectCrash, saveNavigationState, clearSavedNavigationState, markRecoveryShown, wasRecoveryShown, getDetectionResult, clearCrashHistory, resetCrashDetector, type CrashDetectionResult, type SavedNavigationState, } from "./crash-detector.js";

package/dist/viewer/crash/index.js

@@ -0,0 +1,8 @@
+/**
+ * Crash recovery zone public interface.
+ *
+ * All cross-zone consumers should import from this barrel rather than
+ * the crash-detector implementation file directly.
+ */
+export { detectCrash, saveNavigationState, clearSavedNavigationState, markRecoveryShown, wasRecoveryShown, getDetectionResult, clearCrashHistory, resetCrashDetector, } from "./crash-detector.js";
+//# sourceMappingURL=index.js.map

package/dist/viewer/crash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/viewer/crash/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,qBAAqB,CAAC"}

package/dist/viewer/deployed-mode.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Deployed mode support — static export fetch adapter.
+ *
+ * When the viewer is exported as a static site via `ndx export`, a global
+ * flag (`window.__NDX_DEPLOYED__`) is injected into the HTML.  This module
+ * detects that flag and installs a fetch adapter that transparently rewrites
+ * API requests to pre-rendered static JSON files.
+ *
+ * The adapter means no per-component changes are needed — existing `fetch()`
+ * calls to `/api/*` and `/data/*` just work against the static file tree.
+ */
+interface DeployedConfig {
+    basePath: string;
+    exportedAt: string;
+}
+declare global {
+    interface Window {
+        __NDX_DEPLOYED__?: DeployedConfig;
+    }
+}
+/** Check whether the viewer is running in deployed (static export) mode. */
+export declare function isDeployedMode(): boolean;
+/** Return the deployed config, or null if not in deployed mode. */
+export declare function getDeployedConfig(): DeployedConfig | null;
+/**
+ * Install a global fetch adapter that rewrites requests for deployed mode.
+ *
+ * Rewrites:
+ *   GET /api/*          → {basePath}api/*.json
+ *   GET /data           → {basePath}data/index.json
+ *   GET /data/status    → synthetic { mtimes: {} }
+ *   GET /data/*         → {basePath}data/*
+ *   Non-GET methods     → synthetic 405 response
+ *   Everything else     → pass through
+ */
+export declare function installFetchAdapter(): void;
+export {};