@n-dx/core 0.1.0

package/packages/sourcevision/dist/viewer/views/zones.js

@@ -0,0 +1,146 @@
+import { h } from "preact";
+import { useState, useMemo } from "preact/hooks";
+import { ZONE_COLORS } from "../components/constants.js";
+import { CollapsibleSection } from "../components/data-display/collapsible-section.js";
+import { SearchFilter } from "../components/search-filter.js";
+import { FlowDiagram } from "../components/data-display/mini-charts.js";
+import { meterClass, buildFlowNodes, buildFlowEdges } from "../utils.js";
+import { BrandedHeader } from "../components/logos.js";
+export function ZonesView({ data, onSelect }) {
+    const { zones } = data;
+    const [selectedZone, setSelectedZone] = useState(null);
+    const [search, setSearch] = useState("");
+    if (!zones) {
+        return h("div", { class: "loading" }, "No zone data available.");
+    }
+    const handleZoneClick = (zone) => {
+        setSelectedZone(zone.id === selectedZone ? null : zone.id);
+        onSelect({
+            type: "zone",
+            title: zone.name,
+            id: zone.id,
+            description: zone.description,
+            files: zone.files.length,
+            entryPoints: zone.entryPoints,
+            cohesion: zone.cohesion.toFixed(2),
+            coupling: zone.coupling.toFixed(2),
+        });
+    };
+    // Cross-zone traffic summary
+    const zoneTraffic = new Map();
+    for (const z of zones.zones) {
+        zoneTraffic.set(z.id, { incoming: 0, outgoing: 0 });
+    }
+    for (const c of zones.crossings) {
+        const from = zoneTraffic.get(c.fromZone);
+        const to = zoneTraffic.get(c.toZone);
+        if (from)
+            from.outgoing++;
+        if (to)
+            to.incoming++;
+    }
+    // FlowDiagram data
+    const flowNodes = useMemo(() => buildFlowNodes(zones), [zones.zones]);
+    const flowEdges = useMemo(() => buildFlowEdges(zones.crossings), [zones.crossings]);
+    const handleFlowNodeClick = (id) => {
+        const el = document.getElementById(`zone-card-${id}`);
+        if (el)
+            el.scrollIntoView({ behavior: "smooth", block: "center" });
+        setSelectedZone(id);
+    };
+    // Search filtering
+    const filteredZones = useMemo(() => {
+        if (!search)
+            return zones.zones;
+        const q = search.toLowerCase();
+        return zones.zones.filter((z) => z.name.toLowerCase().includes(q) ||
+            z.description.toLowerCase().includes(q) ||
+            z.files.some((f) => f.toLowerCase().includes(q)));
+    }, [zones.zones, search]);
+    return h("div", null, h("div", { class: "view-header" }, h(BrandedHeader, { product: "sourcevision", title: "SourceVision", class: "branded-header-sv" }), h("h2", { class: "section-header" }, "Zones")), h("p", { class: "section-sub" }, `${zones.zones.length} zones, ${zones.crossings.length} cross-zone dependencies, ${zones.unzoned.length} unzoned files`), 
+    // Flow Diagram
+    flowNodes.length > 1 && flowEdges.length > 0
+        ? h(FlowDiagram, {
+            nodes: flowNodes,
+            edges: flowEdges,
+            onNodeClick: handleFlowNodeClick,
+        })
+        : null, 
+    // Search
+    h(SearchFilter, {
+        placeholder: "Search zones, files...",
+        value: search,
+        onInput: setSearch,
+        resultCount: filteredZones.length,
+        totalCount: zones.zones.length,
+    }), 
+    // Zone cards
+    h("div", { class: "zone-grid" }, filteredZones.map((zone, i) => {
+        const globalIdx = zones.zones.indexOf(zone);
+        const traffic = zoneTraffic.get(zone.id);
+        const color = ZONE_COLORS[globalIdx % ZONE_COLORS.length];
+        return h("div", {
+            key: zone.id,
+            id: `zone-card-${zone.id}`,
+            class: `zone-card ${selectedZone === zone.id ? "selected" : ""}`,
+            style: selectedZone === zone.id ? `border-color: ${color}` : "",
+            onClick: () => handleZoneClick(zone),
+        }, h("div", { class: "flex-row" }, h("div", {
+            class: "zone-dot",
+            style: `background: ${color}`,
+        }), h("h3", null, zone.name)), h("p", { class: "desc" }, zone.description), h("div", { class: "zone-metrics" }, h("div", { class: "zone-metric" }, h("div", { class: "val" }, zone.files.length), h("div", { class: "lbl" }, "Files")), h("div", { class: "zone-metric" }, h("div", { class: "val" }, zone.cohesion.toFixed(2)), h("div", { class: "lbl" }, "Cohesion"), h("div", { class: "meter" }, h("div", {
+            class: `meter-fill ${meterClass(zone.cohesion)}`,
+            style: `width: ${zone.cohesion * 100}%`,
+        }))), h("div", { class: "zone-metric" }, h("div", { class: "val" }, zone.coupling.toFixed(2)), h("div", { class: "lbl" }, "Coupling"), h("div", { class: "meter" }, h("div", {
+            class: `meter-fill ${meterClass(zone.coupling, true)}`,
+            style: `width: ${zone.coupling * 100}%`,
+        }))), traffic
+            ? h("div", { class: "zone-metric" }, h("div", { class: "val" }, `${traffic.incoming}/${traffic.outgoing}`), h("div", { class: "lbl" }, "In/Out"))
+            : null), 
+        // Per-zone findings/insights
+        (() => {
+            const zoneFindings = (zones.findings ?? []).filter((f) => f.scope === zone.id);
+            const insightTexts = zoneFindings.length > 0
+                ? zoneFindings.map((f) => f.text)
+                : zone.insights ?? [];
+            if (insightTexts.length === 0)
+                return null;
+            return h(CollapsibleSection, {
+                title: "Insights",
+                count: insightTexts.length,
+                defaultOpen: true,
+                threshold: 3,
+            }, ...insightTexts.map((text, j) => h("div", { key: j, class: "insight-item" }, text)));
+        })());
+    })), 
+    // Selected zone file list
+    selectedZone
+        ? (() => {
+            const zone = zones.zones.find((z) => z.id === selectedZone);
+            if (!zone)
+                return null;
+            return h(CollapsibleSection, {
+                title: `Files in "${zone.name}"`,
+                count: zone.files.length,
+                defaultOpen: true,
+                threshold: 20,
+            }, h("div", { class: "data-table-wrapper" }, h("table", { class: "data-table" }, h("thead", null, h("tr", null, h("th", null, "Path"), h("th", null, "Entry Point"))), h("tbody", null, zone.files.map((f) => h("tr", { key: f }, h("td", { class: "mono-sm" }, f), h("td", null, zone.entryPoints.includes(f)
+                ? h("span", { class: "tag tag-test" }, "entry")
+                : null)))))));
+        })()
+        : null, 
+    // Unzoned files
+    zones.unzoned.length
+        ? h(CollapsibleSection, {
+            title: "Unzoned Files",
+            count: zones.unzoned.length,
+            defaultOpen: false,
+            threshold: 10,
+        }, ...zones.unzoned.map((f) => h("div", {
+            key: f,
+            class: "mono-sm text-dim",
+            style: "line-height: 1.8",
+        }, f)))
+        : null);
+}
+//# sourceMappingURL=zones.js.map

package/packages/sourcevision/dist/viewer/views/zones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zones.js","sourceRoot":"","sources":["../../../src/viewer/views/zones.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AASvD,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAkB;IAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,yBAAyB,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,eAAe,GAAG,CAAC,IAAU,EAAE,EAAE;QACrC,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,QAAQ,CAAC;YACP,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;SACnC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,6BAA6B;IAC7B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkD,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,IAAI;YAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC1B,IAAI,EAAE;YAAE,EAAE,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED,mBAAmB;IACnB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAEpF,MAAM,mBAAmB,GAAG,CAAC,EAAU,EAAE,EAAE;QACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE;YAAE,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,eAAe,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,mBAAmB;IACnB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC;QAChC,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CACnD,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAE1B,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAClB,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAC/B,CAAC,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,EAChG,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAC9C,EACD,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAC7B,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,SAAS,CAAC,MAAM,6BAA6B,KAAK,CAAC,OAAO,CAAC,MAAM,gBAAgB,CACxH;IAED,eAAe;IACf,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAC1C,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YACb,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,mBAAmB;SACjC,CAAC;QACJ,CAAC,CAAC,IAAI;IAER,SAAS;IACT,CAAC,CAAC,YAAY,EAAE;QACd,WAAW,EAAE,wBAAwB;QACrC,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,aAAa,CAAC,MAAM;QACjC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;KAC/B,CAAC;IAEF,aAAa;IACb,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAC7B,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1D,OAAO,CAAC,CAAC,KAAK,EAAE;YACd,GAAG,EAAE,IAAI,CAAC,EAAE;YACZ,EAAE,EAAE,aAAa,IAAI,CAAC,EAAE,EAAE;YAC1B,KAAK,EAAE,aAAa,YAAY,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;YAChE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;YAC/D,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;SACrC,EACC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAC5B,CAAC,CAAC,KAAK,EAAE;YACP,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,eAAe,KAAK,EAAE;SAC9B,CAAC,EACF,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CACzB,EACD,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,EAC3C,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAChC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAC/B,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAC7C,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CACpC,EACD,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAC/B,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EACpD,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,CAAC,EACtC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EACzB,CAAC,CAAC,KAAK,EAAE;YACP,KAAK,EAAE,cAAc,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;YAChD,KAAK,EAAE,UAAU,IAAI,CAAC,QAAQ,GAAG,GAAG,GAAG;SACxC,CAAC,CACH,CACF,EACD,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAC/B,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EACpD,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,CAAC,EACtC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EACzB,CAAC,CAAC,KAAK,EAAE;YACP,KAAK,EAAE,cAAc,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE;YACtD,KAAK,EAAE,UAAU,IAAI,CAAC,QAAQ,GAAG,GAAG,GAAG;SACxC,CAAC,CACH,CACF,EACD,OAAO;YACL,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAC/B,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,EACrE,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CACrC;YACH,CAAC,CAAC,IAAI,CACT;QACD,6BAA6B;QAC7B,CAAC,GAAG,EAAE;YACJ,MAAM,YAAY,GAAc,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAC3D,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,CACpC,CAAC;YACF,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;gBAC1C,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;YACxB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAE3C,OAAO,CAAC,CAAC,kBAAkB,EAAE;gBAC3B,KAAK,EAAE,UAAU;gBACjB,KAAK,EAAE,YAAY,CAAC,MAAM;gBAC1B,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,CAAC;aACb,EACC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAC9B,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,IAAI,CAAC,CAClD,CACF,CAAC;QACJ,CAAC,CAAC,EAAE,CACL,CAAC;IACJ,CAAC,CAAC,CACH;IAED,0BAA0B;IAC1B,YAAY;QACV,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAEvB,OAAO,CAAC,CAAC,kBAAkB,EAAE;gBAC3B,KAAK,EAAE,aAAa,IAAI,CAAC,IAAI,GAAG;gBAChC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;gBACxB,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,EAAE;aACd,EACC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,EACtC,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAChC,CAAC,CAAC,OAAO,EAAE,IAAI,EACb,CAAC,CAAC,IAAI,EAAE,IAAI,EACV,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EACrB,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAC7B,CACF,EACD,CAAC,CAAC,OAAO,EAAE,IAAI,EACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACnB,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAChB,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,EAChC,CAAC,CAAC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC1B,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC;gBAC/C,CAAC,CAAC,IAAI,CACT,CACF,CACF,CACF,CACF,CACF,CACF,CAAC;QACJ,CAAC,CAAC,EAAE;QACN,CAAC,CAAC,IAAI;IAER,gBAAgB;IAChB,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE;YACpB,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAC3B,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,EAAE;SACd,EACC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzB,CAAC,CAAC,KAAK,EAAE;YACP,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,kBAAkB;YACzB,KAAK,EAAE,kBAAkB;SAC1B,EAAE,CAAC,CAAC,CACN,CACF;QACH,CAAC,CAAC,IAAI,CACT,CAAC;AACJ,CAAC"}

package/packages/sourcevision/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "sourcevision",
+  "version": "0.1.0",
+  "license": "Elastic-2.0",
+  "description": "Codebase analysis tool with structured, git-friendly output",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "sourcevision": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/public.js",
+      "types": "./dist/public.d.ts"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "validate": "tsc --noEmit && vitest run",
+    "prepare": "pnpm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@n-dx/llm-client": "workspace:*",
+    "ora": "^8.0.1",
+    "pdfkit": "^0.17.2",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "@types/pdfkit": "^0.17.4",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  }
+}

package/packages/web/build.js

@@ -0,0 +1,243 @@
+import * as esbuild from "esbuild";
+import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const watchMode = process.argv.includes("--watch");
+const viewerOnly = process.argv.includes("--viewer-only");
+const landingOnly = process.argv.includes("--landing-only");
+
+const jsEntryPoint = resolve(__dirname, "src/viewer/main.ts");
+const cssEntryPoint = resolve(__dirname, "src/viewer/styles/index.css");
+const htmlTemplatePath = resolve(__dirname, "src/viewer/index.html");
+const outDir = resolve(__dirname, "dist/viewer");
+
+// ── Landing page entry points ─────────────────────────────────────────────────
+// The landing page is a self-contained vanilla-JS feature with no Preact
+// dependency.  All source files (landing.ts, landing.css, index.html) are
+// co-located in src/landing/ so a single zone owns the full feature boundary.
+// Build-time coupling is limited to this build script — there are no runtime
+// imports between the landing page and the dashboard viewer.
+const landingJsEntryPoint = resolve(__dirname, "src/landing/landing.ts");
+const landingCssEntryPoint = resolve(__dirname, "src/landing/landing.css");
+const landingHtmlTemplatePath = resolve(__dirname, "src/landing/index.html");
+const landingOutDir = resolve(__dirname, "dist/landing");
+
+const commonJsOptions = {
+  entryPoints: [jsEntryPoint],
+  bundle: true,
+  format: "esm",
+  target: "es2022",
+  jsx: "automatic",
+  jsxImportSource: "preact",
+  define: {
+    "process.env.NODE_ENV": watchMode ? '"development"' : '"production"',
+  },
+};
+
+function buildHtml(jsCode, cssCode) {
+  const htmlTemplate = readFileSync(htmlTemplatePath, "utf-8");
+
+  let inlinedHtml = htmlTemplate.replace(
+    '<link rel="stylesheet" href="./styles.css">',
+    () => `<style>${cssCode}</style>`
+  );
+
+  inlinedHtml = inlinedHtml.replace(
+    '<script type="module" src="./main.ts"></script>',
+    () => `<script type="module">${jsCode}</script>`
+  );
+
+  mkdirSync(outDir, { recursive: true });
+  writeFileSync(resolve(outDir, "index.html"), inlinedHtml);
+  copyFileSync(resolve(__dirname, "SourceVision.png"), resolve(outDir, "SourceVision.png"));
+  if (existsSync(resolve(__dirname, "SourceVision-F.png"))) {
+    copyFileSync(resolve(__dirname, "SourceVision-F.png"), resolve(outDir, "SourceVision-F.png"));
+  }
+  // Copy logos from sibling packages and project root
+  const monorepoRoot = resolve(__dirname, "../..");
+  const logoPaths = [
+    [resolve(__dirname, "../rex/Rex-F.png"), "Rex-F.png"],
+    [resolve(__dirname, "../hench/Hench-F.png"), "Hench-F.png"],
+    [resolve(monorepoRoot, "n-dx.png"), "n-dx.png"],
+  ];
+  for (const [src, dest] of logoPaths) {
+    if (existsSync(src)) {
+      copyFileSync(src, resolve(outDir, dest));
+    }
+  }
+}
+
+async function bundleCss() {
+  const result = await esbuild.build({
+    entryPoints: [cssEntryPoint],
+    bundle: true,
+    write: false,
+    minify: !watchMode,
+  });
+  return result.outputFiles[0].text;
+}
+
+// ── Landing page build helpers ──
+
+function buildLandingHtml(jsCode, cssCode) {
+  const htmlTemplate = readFileSync(landingHtmlTemplatePath, "utf-8");
+
+  let inlinedHtml = htmlTemplate.replace(
+    '<link rel="stylesheet" href="./landing.css">',
+    () => `<style>${cssCode}</style>`
+  );
+
+  inlinedHtml = inlinedHtml.replace(
+    '<script type="module" src="./landing.ts"></script>',
+    () => `<script type="module">${jsCode}</script>`
+  );
+
+  mkdirSync(landingOutDir, { recursive: true });
+  writeFileSync(resolve(landingOutDir, "index.html"), inlinedHtml);
+}
+
+async function bundleLandingCss() {
+  const result = await esbuild.build({
+    entryPoints: [landingCssEntryPoint],
+    bundle: true,
+    write: false,
+    minify: !watchMode,
+  });
+  return result.outputFiles[0].text;
+}
+
+const landingJsOptions = {
+  entryPoints: [landingJsEntryPoint],
+  bundle: true,
+  format: "esm",
+  target: "es2022",
+};
+
+async function buildViewer() {
+  const jsResult = await esbuild.build({
+    ...commonJsOptions,
+    write: false,
+    minify: true,
+  });
+
+  const jsCode = jsResult.outputFiles[0].text;
+  const cssCode = await bundleCss();
+
+  buildHtml(jsCode, cssCode);
+  console.log("Built viewer: dist/viewer/index.html");
+}
+
+async function buildLanding() {
+  const landingJsResult = await esbuild.build({
+    ...landingJsOptions,
+    write: false,
+    minify: true,
+  });
+
+  const landingJsCode = landingJsResult.outputFiles[0].text;
+  const landingCssCode = await bundleLandingCss();
+
+  buildLandingHtml(landingJsCode, landingCssCode);
+  console.log("Built landing: dist/landing/index.html");
+}
+
+async function buildProduction() {
+  if (landingOnly) {
+    await buildLanding();
+  } else if (viewerOnly) {
+    await buildViewer();
+  } else {
+    await buildViewer();
+    await buildLanding();
+  }
+}
+
+async function buildWatch() {
+  // CSS context for watching
+  const cssCtx = await esbuild.context({
+    entryPoints: [cssEntryPoint],
+    bundle: true,
+    outfile: resolve(outDir, "styles.css"),
+    logLevel: "info",
+  });
+
+  // JS context for watching
+  const jsCtx = await esbuild.context({
+    ...commonJsOptions,
+    write: false,
+    plugins: [{
+      name: "rebuild-html",
+      setup(build) {
+        build.onEnd(async (result) => {
+          if (result.errors.length > 0) return;
+
+          try {
+            const jsCode = result.outputFiles?.[0]?.text ?? "";
+            const cssCode = await bundleCss();
+            buildHtml(jsCode, cssCode);
+            console.log(`[esbuild] Rebuilt viewer: dist/viewer/index.html`);
+          } catch (err) {
+            console.error("[esbuild] HTML rebuild failed:", err.message);
+          }
+        });
+      },
+    }],
+  });
+
+  // Landing page JS context for watching
+  const landingJsCtx = await esbuild.context({
+    ...landingJsOptions,
+    write: false,
+    plugins: [{
+      name: "rebuild-landing-html",
+      setup(build) {
+        build.onEnd(async (result) => {
+          if (result.errors.length > 0) return;
+
+          try {
+            const jsCode = result.outputFiles?.[0]?.text ?? "";
+            const cssCode = await bundleLandingCss();
+            buildLandingHtml(jsCode, cssCode);
+            console.log(`[esbuild] Rebuilt landing: dist/landing/index.html`);
+          } catch (err) {
+            console.error("[esbuild] Landing rebuild failed:", err.message);
+          }
+        });
+      },
+    }],
+  });
+
+  // Initial build — viewer
+  const jsResult = await jsCtx.rebuild();
+  const jsCode = jsResult.outputFiles?.[0]?.text ?? "";
+  const cssCode = await bundleCss();
+  buildHtml(jsCode, cssCode);
+  console.log("[esbuild] Initial build complete: dist/viewer/index.html");
+
+  // Initial build — landing
+  const landingJsResult = await landingJsCtx.rebuild();
+  const landingJsCode = landingJsResult.outputFiles?.[0]?.text ?? "";
+  const landingCssCode = await bundleLandingCss();
+  buildLandingHtml(landingJsCode, landingCssCode);
+  console.log("[esbuild] Initial build complete: dist/landing/index.html");
+
+  // Start watching all
+  await cssCtx.watch();
+  await jsCtx.watch();
+  await landingJsCtx.watch();
+  console.log("[esbuild] Watching for changes...");
+}
+
+if (watchMode) {
+  buildWatch().catch((err) => {
+    console.error("Watch failed:", err);
+    process.exit(1);
+  });
+} else {
+  buildProduction().catch((err) => {
+    console.error("Build failed:", err);
+    process.exit(1);
+  });
+}

package/packages/web/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * n-dx web dashboard CLI
+ *
+ * Commands:
+ *   serve [dir]   - Start the web dashboard server
+ */
+export {};

package/packages/web/dist/cli/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * n-dx web dashboard CLI
+ *
+ * Commands:
+ *   serve [dir]   - Start the web dashboard server
+ */
+import { resolve } from "node:path";
+import { startServer } from "../server/start.js";
+const VALID_SCOPES = new Set(["sourcevision", "rex", "hench"]);
+const args = process.argv.slice(2);
+const command = args[0];
+let port = 3117;
+let scope;
+for (const a of args.slice(1)) {
+    if (a.startsWith("--port=")) {
+        port = parseInt(a.split("=")[1], 10);
+    }
+    else if (a.startsWith("--scope=")) {
+        const val = a.split("=")[1];
+        if (!VALID_SCOPES.has(val)) {
+            console.error(`Invalid scope: ${val} (valid: ${[...VALID_SCOPES].join(", ")})`);
+            process.exit(1);
+        }
+        scope = val;
+    }
+}
+const targetArg = args.slice(1).find((a) => !a.startsWith("-"));
+if (command === "serve") {
+    const dir = resolve(targetArg || ".");
+    const dev = args.includes("--dev");
+    await startServer(dir, port, { dev, scope });
+}
+else {
+    console.log(`n-dx web dashboard
+
+Commands:
+  serve [dir]   Start the web dashboard server
+
+Options:
+  --port=N                  Port to listen on (default: 3117)
+  --scope=<package>         Restrict to a single package (sourcevision, rex, hench)
+  --dev                     Enable dev mode (live reload)
+`);
+    if (command) {
+        console.error(`Unknown command: ${command}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/packages/web/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAc,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,IAAI,IAAI,GAAG,IAAI,CAAC;AAChB,IAAI,KAA8B,CAAC;AAEnC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAgB,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,GAAG,GAAG,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC;;;;;;;;;CASb,CAAC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/packages/web/dist/landing/color-inversion.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Color inversion easter egg — Ctrl+I (or Cmd+I on macOS) toggles
+ * a full-page color inversion effect via CSS `filter: invert(1) hue-rotate(180deg)`.
+ *
+ * Returns a cleanup function that removes the event listener.
+ */
+export declare function setupColorInversion(): () => void;

package/packages/web/dist/landing/color-inversion.js

@@ -0,0 +1,24 @@
+/**
+ * Color inversion easter egg — Ctrl+I (or Cmd+I on macOS) toggles
+ * a full-page color inversion effect via CSS `filter: invert(1) hue-rotate(180deg)`.
+ *
+ * Returns a cleanup function that removes the event listener.
+ */
+export function setupColorInversion() {
+    function handleKeydown(e) {
+        // Only Ctrl+I or Meta+I — ignore if Shift or Alt are also pressed
+        if (e.key.toLowerCase() !== "i")
+            return;
+        if (!(e.ctrlKey || e.metaKey))
+            return;
+        if (e.shiftKey || e.altKey)
+            return;
+        e.preventDefault();
+        document.documentElement.classList.toggle("color-inverted");
+    }
+    document.addEventListener("keydown", handleKeydown);
+    return () => {
+        document.removeEventListener("keydown", handleKeydown);
+    };
+}
+//# sourceMappingURL=color-inversion.js.map

package/packages/web/dist/landing/color-inversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-inversion.js","sourceRoot":"","sources":["../../src/landing/color-inversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,SAAS,aAAa,CAAC,CAAgB;QACrC,kEAAkE;QAClE,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,GAAG;YAAE,OAAO;QACxC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC;YAAE,OAAO;QACtC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO;QAEnC,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC9D,CAAC;IAED,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAEpD,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACzD,CAAC,CAAC;AACJ,CAAC"}