wabachi 0.2.1 → 0.3.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wabachi",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Repository analysis and Architecture Canon workflows through the Wabachi CLI.",
   "skills": "skills/wabachi"
 }

package/README.md

@@ -53,6 +53,11 @@ Wabachi keeps repository facts and architecture declarations explicit. Repositor
 
 The matrix workflow emits retained artifacts so provider output, correlations, and reports can be inspected rather than treated as opaque agent context.
 
+Architecture rendering is npm-native: `wabachi architecture render
+./architecture.json --out ./artifacts/site` uses the bundled React Flow + ELK
+renderer and does not require Java, Docker, Chromium, Structurizr, a CDN, or
+network access.
+
 ## Development
 
 ```bash

package/dist/architecture/cli.js

@@ -3,9 +3,8 @@ import path from "node:path";
 import { parseCanonicalArchitectureDocument } from "./canon/codec.js";
 import { projectArchitectureDocument } from "./documentation/project.js";
 import { ArchitectureSiteError, buildArchitectureSite } from "./documentation/site.js";
-import { projectArchitectureDocumentToStructurizr } from "./projection/structurizr.js";
-import { commandUsage } from "../command-contract.js";
-const DEFAULT_STRUCTURIZR_COMMAND = "structurizr";
+import { projectArchitectureDocumentToReactFlow } from "./projection/react-flow.js";
+import { commandUsage, DEFAULT_ARCHITECTURE_CANON_PATH } from "../command-contract.js";
 const MAX_DIAGNOSTIC_LENGTH = 240;
 function usage(command) {
     if (command === "validate")
@@ -23,15 +22,29 @@ function bounded(value) {
 function errorMessage(error) {
     return bounded(error instanceof Error ? error.message : String(error));
 }
+function architectureCanonCounts(document) {
+    return {
+        elements: document.elements.length,
+        interfaces: document.interfaces.length,
+        relationships: document.relationships.length,
+        flows: document.flows.length,
+        views: document.views.length,
+    };
+}
+function architectureCanonSummary(counts) {
+    return `Architecture Canon summary: elements=${counts.elements}, interfaces=${counts.interfaces}, relationships=${counts.relationships}, flows=${counts.flows}, views=${counts.views}`;
+}
+function isMissingFileError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
 function parseArguments(args) {
     const command = args[0];
     const json = args.includes("--json");
-    if (command !== "validate" && command !== "render") {
+    if (command !== "example" && command !== "validate" && command !== "render") {
         return { ok: false, json, message: usage() };
     }
     let file;
     let outputRoot;
-    let structurizrCommand;
     for (let index = 1; index < args.length; index += 1) {
         const argument = args[index];
         if (argument === "--json")
@@ -47,33 +60,22 @@ function parseArguments(args) {
             index += 1;
             continue;
         }
-        if (argument === "--structurizr-command") {
-            const value = args[index + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ok: false, json, message: "--structurizr-command requires an executable path" };
-            }
-            if (structurizrCommand !== undefined) {
-                return { ok: false, json, message: "--structurizr-command may be provided only once" };
-            }
-            structurizrCommand = value;
-            index += 1;
-            continue;
-        }
         if (argument.startsWith("--"))
             return { ok: false, json, message: `unknown option: ${argument}` };
         if (file !== undefined)
             return { ok: false, json, message: "architecture commands accept one explicit file" };
         file = argument;
     }
-    if (file === undefined)
-        return { ok: false, json, message: usage(command) };
-    if (command === "validate" && (outputRoot !== undefined || structurizrCommand !== undefined)) {
+    if (command === "example" && file !== undefined) {
+        return { ok: false, json, message: "architecture example does not accept a file" };
+    }
+    if (command === "validate" && outputRoot !== undefined) {
         return { ok: false, json, message: "validate does not accept render options" };
     }
     if (command === "render" && outputRoot === undefined) {
         return { ok: false, json, message: "render requires --out <dir>" };
     }
-    return { ok: true, value: { command, file, outputRoot, structurizrCommand, json } };
+    return { ok: true, value: { command, file, outputRoot, json } };
 }
 function writeFailure(command, json, diagnostic) {
     const result = {
@@ -104,38 +106,51 @@ export async function runArchitectureCli(args) {
     const parsed = parseArguments(args);
     if (!parsed.ok)
         return writeUsageFailure(parsed.json, parsed.message);
-    const { command, file, json } = parsed.value;
+    const { command, json } = parsed.value;
+    if (command === "example") {
+        try {
+            const source = await readFile(new URL("../../docs/examples/minimal-canon.json", import.meta.url), "utf8");
+            parseCanonicalArchitectureDocument(source);
+            console.log(source.trim());
+            return 0;
+        }
+        catch (error) {
+            return writeFailure(command, json, { code: "example-unavailable", message: errorMessage(error) });
+        }
+    }
+    const file = parsed.value.file ?? DEFAULT_ARCHITECTURE_CANON_PATH;
     let document;
     try {
         document = parseCanonicalArchitectureDocument(await readFile(file, "utf8"));
     }
     catch (error) {
+        if (isMissingFileError(error)) {
+            return writeFailure(command, json, {
+                code: "invalid-canon",
+                message: `architecture document not found: ${file}`,
+            });
+        }
         return writeFailure(command, json, { code: "invalid-canon", message: errorMessage(error) });
     }
     if (command === "validate") {
+        const counts = architectureCanonCounts(document);
         if (json) {
-            console.log(JSON.stringify({ ok: true, command: "architecture validate", file }));
+            console.log(JSON.stringify({ ok: true, command: "architecture validate", file, ...counts }));
         }
         else {
             console.log(`valid Architecture Canon: ${file}`);
+            console.log(architectureCanonSummary(counts));
         }
         return 0;
     }
     try {
         const documentation = projectArchitectureDocument(document);
-        const structurizr = projectArchitectureDocumentToStructurizr(document);
+        const reactFlow = await projectArchitectureDocumentToReactFlow(document);
         const result = await buildArchitectureSite({
             outputRoot: path.resolve(parsed.value.outputRoot),
             documentation,
-            structurizr,
-            launcher: { executable: parsed.value.structurizrCommand ?? DEFAULT_STRUCTURIZR_COMMAND },
+            reactFlow,
         });
-        if (!result.complete) {
-            return writeFailure(command, json, {
-                code: "export-failed",
-                message: result.export.diagnostic?.message ?? "Structurizr static export failed",
-            });
-        }
         if (json) {
             console.log(JSON.stringify({
                 ok: true,

package/dist/architecture/cli.js.map

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

package/dist/architecture/documentation/react-flow.d.ts

@@ -0,0 +1,23 @@
+import type { ReactFlowProjection } from "../projection/react-flow.js";
+export interface ReactFlowStaticAsset {
+    readonly path: "wabachi-react-flow.css";
+    readonly contentType: "text/css";
+    readonly content: string;
+}
+export interface ReactFlowStaticRenderResult {
+    /** An HTML fragment that can be inserted into a Wabachi-owned document. */
+    readonly markup: string;
+    /** Local assets required by the fragment; no network request is needed. */
+    readonly assets: readonly ReactFlowStaticAsset[];
+}
+export declare class ReactFlowStaticRenderError extends Error {
+    readonly code: "invalid-projection";
+    constructor(message: string);
+}
+export declare const REACT_FLOW_DIAGRAM_CSS: string;
+export declare const REACT_FLOW_STATIC_ASSETS: readonly ReactFlowStaticAsset[];
+/** Render the React Flow projection with @xyflow/react's ReactFlow component and local assets. */
+export declare function renderReactFlowStatic(projection: ReactFlowProjection): ReactFlowStaticRenderResult;
+/** Convenience form for callers that only need the composable HTML fragment. */
+export declare function renderReactFlowHtml(projection: ReactFlowProjection): string;
+export declare const renderReactFlowProjection: typeof renderReactFlowStatic;

package/dist/architecture/documentation/react-flow.js

@@ -0,0 +1,436 @@
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import React from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+import { BaseEdge, Handle, MarkerType, Position, ReactFlow, ReactFlowProvider, } from "@xyflow/react";
+export class ReactFlowStaticRenderError extends Error {
+    code = "invalid-projection";
+    constructor(message) {
+        super(message);
+        this.name = "ReactFlowStaticRenderError";
+    }
+}
+const require = createRequire(import.meta.url);
+function reactFlowStylesheet() {
+    try {
+        return readFileSync(require.resolve("@xyflow/react/dist/style.css"), "utf8");
+    }
+    catch (error) {
+        const detail = error instanceof Error ? `: ${error.message}` : "";
+        throw new ReactFlowStaticRenderError(`React Flow stylesheet is unavailable${detail}`);
+    }
+}
+const WABACHI_REACT_FLOW_CSS = `.wabachi-react-flow-diagrams {
+  --wabachi-flow-ink: #202124;
+  --wabachi-flow-muted: #5f6368;
+  --wabachi-flow-border: #aeb7c4;
+  --wabachi-flow-edge: #53657a;
+  --wabachi-flow-surface: #ffffff;
+  --wabachi-flow-canvas: #f8fafc;
+  display: grid;
+  gap: 2rem;
+  color: var(--wabachi-flow-ink);
+  font-family: system-ui, sans-serif;
+}
+
+.wabachi-react-flow-diagram {
+  min-inline-size: 0;
+}
+
+.wabachi-react-flow-diagram > header {
+  margin-block-end: 1rem;
+}
+
+.wabachi-react-flow-diagram > header h2,
+.wabachi-react-flow-diagram > header p {
+  margin-block: 0.25rem;
+}
+
+.wabachi-react-flow-diagram > header p,
+.wabachi-react-flow-losses {
+  color: var(--wabachi-flow-muted);
+}
+
+.wabachi-react-flow-canvas {
+  display: block;
+  inline-size: 100%;
+  min-block-size: 12rem;
+  overflow: hidden;
+  background: var(--wabachi-flow-canvas);
+  border: 1px solid var(--wabachi-flow-border);
+  border-radius: 0.5rem;
+}
+
+.wabachi-react-flow-surface {
+  color: var(--wabachi-flow-ink);
+  background: var(--wabachi-flow-canvas);
+}
+
+.wabachi-react-flow-node {
+  display: grid;
+  place-items: center;
+  box-sizing: border-box;
+  inline-size: 100%;
+  block-size: 100%;
+  padding: 0.75rem;
+  color: var(--wabachi-flow-ink);
+  background: var(--wabachi-flow-surface);
+  border: 2px solid var(--wabachi-flow-border);
+  border-radius: 0.5rem;
+  font-size: 14px;
+  font-weight: 600;
+  text-align: center;
+}
+
+.wabachi-react-flow-node--parent {
+  border-style: dashed;
+}
+
+.wabachi-react-flow-node[data-kind="service"],
+.wabachi-react-flow-node[data-kind="system"] {
+  background: #eef6ff;
+}
+
+.wabachi-react-flow-node[data-kind="component"] {
+  background: #f4f0ff;
+}
+
+.wabachi-react-flow-node[data-kind="actor"] {
+  background: #fff7e6;
+}
+
+.wabachi-react-flow-node > .react-flow__handle {
+  opacity: 0;
+}
+
+.wabachi-react-flow-edge .react-flow__edge-path {
+  stroke: var(--wabachi-flow-edge);
+  stroke-width: 2;
+}
+
+.wabachi-react-flow-edge .react-flow__edge-text {
+  fill: var(--wabachi-flow-ink);
+  font-size: 12px;
+}
+
+.wabachi-react-flow-edge .react-flow__edge-textbg {
+  fill: var(--wabachi-flow-canvas);
+  opacity: 0.95;
+}
+`;
+export const REACT_FLOW_DIAGRAM_CSS = `${reactFlowStylesheet()}\n${WABACHI_REACT_FLOW_CSS}`;
+export const REACT_FLOW_STATIC_ASSETS = Object.freeze([
+    Object.freeze({
+        path: "wabachi-react-flow.css",
+        contentType: "text/css",
+        content: REACT_FLOW_DIAGRAM_CSS,
+    }),
+]);
+const HTML_ESCAPE_PATTERN = /[&<>"']/g;
+const HTML_ESCAPES = {
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+};
+function escapeHtml(value) {
+    return value.replace(HTML_ESCAPE_PATTERN, (character) => HTML_ESCAPES[character] ?? character);
+}
+function identityToken(value) {
+    const token = Array.from(value, (character) => {
+        if (/^[A-Za-z0-9]$/u.test(character))
+            return character;
+        return `_u${character.codePointAt(0)?.toString(16) ?? "0"}_`;
+    }).join("");
+    return token.length === 0 ? "empty" : token;
+}
+function compareStrings(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function finiteNumber(value, path) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new ReactFlowStaticRenderError(`${path} must be a finite number`);
+    }
+    return Object.is(value, -0) ? 0 : value;
+}
+function formatNumber(value) {
+    return String(Object.is(value, -0) ? 0 : value);
+}
+function nodePosition(node, path) {
+    return Object.freeze({
+        x: finiteNumber(node.position.x, `${path}.position.x`),
+        y: finiteNumber(node.position.y, `${path}.position.y`),
+    });
+}
+function nodeSize(node, path) {
+    const width = finiteNumber(node.width, `${path}.width`);
+    const height = finiteNumber(node.height, `${path}.height`);
+    if (width <= 0 || height <= 0) {
+        throw new ReactFlowStaticRenderError(`${path} dimensions must be positive`);
+    }
+    return Object.freeze({ width, height });
+}
+function sectionPoints(section, path) {
+    const points = [section.startPoint, ...section.bendPoints, section.endPoint];
+    return Object.freeze(points.map((point, index) => ({
+        x: finiteNumber(point.x, `${path}[${index}].x`),
+        y: finiteNumber(point.y, `${path}[${index}].y`),
+    })));
+}
+function edgePath(edge) {
+    if (edge.data.sections.length === 0) {
+        throw new ReactFlowStaticRenderError(`view ${edge.data.viewKey} edge ${edge.id} has no routed sections`);
+    }
+    const paths = [];
+    let labelPoint;
+    edge.data.sections.forEach((section, sectionIndex) => {
+        const points = sectionPoints(section, `views[${edge.data.viewKey}].edges[${edge.id}].sections[${sectionIndex}]`);
+        if (points.length < 2) {
+            throw new ReactFlowStaticRenderError(`view ${edge.data.viewKey} edge ${edge.id} has an incomplete routed section`);
+        }
+        const [first, ...rest] = points;
+        paths.push(`M ${formatNumber(first.x)} ${formatNumber(first.y)} ${rest.map((point) => `L ${formatNumber(point.x)} ${formatNumber(point.y)}`).join(" ")}`);
+        if (labelPoint === undefined) {
+            const midpoint = Math.floor((points.length - 1) / 2);
+            const start = points[midpoint];
+            const end = points[midpoint + 1];
+            labelPoint = Object.freeze({ x: (start.x + end.x) / 2, y: (start.y + end.y) / 2 });
+        }
+    });
+    return Object.freeze({ path: paths.join(" "), labelPoint: labelPoint });
+}
+function includePoint(bounds, x, y) {
+    bounds.minX = Math.min(bounds.minX, x);
+    bounds.minY = Math.min(bounds.minY, y);
+    bounds.maxX = Math.max(bounds.maxX, x);
+    bounds.maxY = Math.max(bounds.maxY, y);
+}
+function addNodeBounds(bounds, node, absolute, path) {
+    const size = nodeSize(node, path);
+    includePoint(bounds, absolute.x, absolute.y);
+    includePoint(bounds, absolute.x + size.width, absolute.y + size.height);
+}
+function validateProjection(projection) {
+    if (projection === null || typeof projection !== "object" || !Array.isArray(projection.views)) {
+        throw new ReactFlowStaticRenderError("React Flow renderer requires a projection with views");
+    }
+    const viewKeys = new Set();
+    for (const [viewIndex, view] of projection.views.entries()) {
+        if (typeof view.key !== "string" || view.key.length === 0) {
+            throw new ReactFlowStaticRenderError(`views[${viewIndex}].key must be a non-empty string`);
+        }
+        if (viewKeys.has(view.key)) {
+            throw new ReactFlowStaticRenderError(`projection contains duplicate view key: ${view.key}`);
+        }
+        viewKeys.add(view.key);
+        const nodeIds = new Set();
+        for (const [nodeIndex, node] of view.nodes.entries()) {
+            const path = `views[${viewIndex}].nodes[${nodeIndex}]`;
+            if (typeof node.id !== "string" || node.id.length === 0) {
+                throw new ReactFlowStaticRenderError(`${path}.id must be a non-empty string`);
+            }
+            if (nodeIds.has(node.id)) {
+                throw new ReactFlowStaticRenderError(`view ${view.key} contains duplicate node id: ${node.id}`);
+            }
+            nodeIds.add(node.id);
+            if (node.data.viewKey !== view.key) {
+                throw new ReactFlowStaticRenderError(`${path}.data.viewKey does not match view key ${view.key}`);
+            }
+            nodePosition(node, path);
+            nodeSize(node, path);
+        }
+        for (const node of view.nodes) {
+            if (node.parentId !== undefined && !nodeIds.has(node.parentId)) {
+                throw new ReactFlowStaticRenderError(`view ${view.key} node ${node.id} refers to missing parent ${node.parentId}`);
+            }
+        }
+        for (const [edgeIndex, edge] of view.edges.entries()) {
+            const path = `views[${viewIndex}].edges[${edgeIndex}]`;
+            if (typeof edge.id !== "string" || edge.id.length === 0) {
+                throw new ReactFlowStaticRenderError(`${path}.id must be a non-empty string`);
+            }
+            if (!nodeIds.has(edge.source) || !nodeIds.has(edge.target)) {
+                throw new ReactFlowStaticRenderError(`view ${view.key} edge ${edge.id} refers to a missing endpoint`);
+            }
+            if (edge.data.viewKey !== view.key) {
+                throw new ReactFlowStaticRenderError(`${path}.data.viewKey does not match view key ${view.key}`);
+            }
+            edgePath(edge);
+        }
+    }
+}
+function absoluteNodePosition(node, nodesById, cache, visiting) {
+    const cached = cache.get(node.id);
+    if (cached !== undefined)
+        return cached;
+    if (visiting.has(node.id))
+        throw new ReactFlowStaticRenderError(`view contains a parent cycle at node ${node.id}`);
+    visiting.add(node.id);
+    const position = nodePosition(node, `node ${node.id}`);
+    const parent = node.parentId === undefined ? undefined : nodesById.get(node.parentId);
+    const parentPosition = parent === undefined ? { x: 0, y: 0 } : absoluteNodePosition(parent, nodesById, cache, visiting);
+    const result = Object.freeze({ x: position.x + parentPosition.x, y: position.y + parentPosition.y });
+    visiting.delete(node.id);
+    cache.set(node.id, result);
+    return result;
+}
+function viewBounds(view, absolutePositions) {
+    const bounds = { minX: 0, minY: 0, maxX: 320, maxY: 160 };
+    for (const node of view.nodes) {
+        const position = absolutePositions.get(node.id);
+        addNodeBounds(bounds, node, position, `node ${node.id}`);
+    }
+    for (const edge of view.edges) {
+        edge.data.sections.forEach((section, sectionIndex) => {
+            for (const point of sectionPoints(section, `edge ${edge.id}.sections[${sectionIndex}]`)) {
+                includePoint(bounds, point.x, point.y);
+            }
+        });
+    }
+    const padding = 32;
+    return Object.freeze({
+        width: Math.max(320, bounds.maxX - bounds.minX + padding * 2),
+        height: Math.max(160, bounds.maxY - bounds.minY + padding * 2),
+        defaultViewport: Object.freeze({ x: padding - bounds.minX, y: padding - bounds.minY, zoom: 1 }),
+    });
+}
+function ArchitectureNode({ data, parentId }) {
+    const className = data.isParent
+        ? "wabachi-react-flow-node wabachi-react-flow-node--parent"
+        : "wabachi-react-flow-node";
+    return React.createElement(React.Fragment, null, React.createElement(Handle, { type: "target", position: Position.Left, "aria-hidden": true }), React.createElement("div", {
+        className,
+        "data-canon-id": data.canonId,
+        "data-view-key": data.viewKey,
+        "data-kind": data.kind,
+        ...(parentId === undefined ? {} : { "data-parent-id": parentId }),
+        role: "group",
+    }, data.label), React.createElement(Handle, { type: "source", position: Position.Right, "aria-hidden": true }));
+}
+function RoutedEdge({ id, data, label, markerEnd }) {
+    if (data === undefined) {
+        throw new ReactFlowStaticRenderError(`React Flow edge ${id} has no projection data`);
+    }
+    const routed = edgePath({ id, data });
+    return React.createElement("g", {
+        "data-view-key": data.viewKey,
+        "data-canon-source-id": data.canonSourceId,
+        "data-canon-target-id": data.canonTargetId,
+        ...(data.canonRelationshipId === undefined ? {} : { "data-canon-relationship-id": data.canonRelationshipId }),
+        "data-section-count": String(data.sections.length),
+    }, React.createElement(BaseEdge, {
+        id,
+        path: routed.path,
+        label,
+        labelX: routed.labelPoint.x,
+        labelY: routed.labelPoint.y,
+        markerEnd,
+        className: "wabachi-react-flow-edge",
+    }));
+}
+const NODE_TYPES = Object.freeze({ architecture: ArchitectureNode });
+const EDGE_TYPES = Object.freeze({ routed: RoutedEdge });
+function flowNodes(view) {
+    const nodes = [...view.nodes].sort((left, right) => compareStrings(left.id, right.id));
+    const parentIds = new Set(nodes.flatMap((node) => (node.parentId === undefined ? [] : [node.parentId])));
+    return Object.freeze(nodes
+        .map((node) => ({
+        id: node.id,
+        type: "architecture",
+        data: { ...node.data, isParent: parentIds.has(node.id) },
+        position: { ...node.position },
+        width: node.width,
+        height: node.height,
+        handles: [
+            { type: "target", position: Position.Left, x: 0, y: node.height / 2 },
+            { type: "source", position: Position.Right, x: node.width, y: node.height / 2 },
+        ],
+        ...(node.parentId === undefined ? {} : { parentId: node.parentId, extent: "parent" }),
+    }))
+        .map((node) => ({
+        ...node,
+        data: node.data,
+    })));
+}
+function flowEdges(view) {
+    const edges = [...view.edges].sort((left, right) => compareStrings(left.id, right.id));
+    return Object.freeze(edges
+        .map((edge) => ({
+        id: edge.id,
+        type: "routed",
+        source: edge.source,
+        target: edge.target,
+        label: edge.label,
+        markerEnd: { type: MarkerType.ArrowClosed },
+        data: edge.data,
+    }))
+        .map((edge) => edge));
+}
+function renderView(projection, view) {
+    const nodes = [...flowNodes(view)];
+    const edges = [...flowEdges(view)];
+    const nodesById = new Map(view.nodes.map((node) => [node.id, node]));
+    const absolutePositions = new Map();
+    for (const node of view.nodes)
+        absoluteNodePosition(node, nodesById, absolutePositions, new Set());
+    const bounds = viewBounds(view, absolutePositions);
+    const viewToken = identityToken(view.key);
+    const titleId = `react-flow-title-${viewToken}`;
+    const title = view.title ?? view.key;
+    const description = view.description === undefined ? "" : `<p>${escapeHtml(view.description)}</p>`;
+    const losses = view.losses.length === 0
+        ? ""
+        : `<p class="wabachi-react-flow-losses" data-loss-count="${String(view.losses.length)}">Projection losses: ${String(view.losses.length)}</p>`;
+    const flowMarkup = renderToStaticMarkup(React.createElement(ReactFlowProvider, {
+        initialNodes: nodes,
+        initialEdges: edges,
+        children: React.createElement(ReactFlow, {
+            id: `react-flow-${viewToken}`,
+            nodes,
+            edges,
+            nodeTypes: NODE_TYPES,
+            edgeTypes: EDGE_TYPES,
+            defaultViewport: bounds.defaultViewport,
+            nodesDraggable: false,
+            nodesConnectable: false,
+            elementsSelectable: false,
+            panOnDrag: false,
+            zoomOnScroll: false,
+            zoomOnPinch: false,
+            zoomOnDoubleClick: false,
+            proOptions: { hideAttribution: true },
+            className: "wabachi-react-flow-surface",
+            style: { width: "100%", height: `${formatNumber(bounds.height)}px` },
+            "aria-label": `${title} architecture diagram`,
+        }),
+    }));
+    return `<section id="react-flow-view-${escapeHtml(viewToken)}" class="wabachi-react-flow-diagram" data-view-key="${escapeHtml(view.key)}" data-canon-document-id="${escapeHtml(projection.documentId)}" data-canon-version="${escapeHtml(String(projection.canonVersion))}" data-projection-loss-count="${String(view.losses.length)}">
+<header>
+<h2 id="${escapeHtml(titleId)}">${escapeHtml(title)}</h2>
+${description}${losses}
+</header>
+<div class="wabachi-react-flow-canvas" data-view-key="${escapeHtml(view.key)}" data-canon-document-id="${escapeHtml(projection.documentId)}" data-canon-version="${escapeHtml(String(projection.canonVersion))}" style="height: ${formatNumber(bounds.height)}px" role="img" aria-labelledby="${escapeHtml(titleId)}">
+${flowMarkup}
+</div>
+</section>`;
+}
+/** Render the React Flow projection with @xyflow/react's ReactFlow component and local assets. */
+export function renderReactFlowStatic(projection) {
+    validateProjection(projection);
+    const views = [...projection.views].sort((left, right) => compareStrings(left.key, right.key));
+    const markup = `<div class="wabachi-react-flow-diagrams" data-canon-document-id="${escapeHtml(projection.documentId)}" data-canon-version="${escapeHtml(String(projection.canonVersion))}">
+${views.map((view) => renderView(projection, view)).join("\n")}
+</div>`;
+    return Object.freeze({ markup, assets: REACT_FLOW_STATIC_ASSETS });
+}
+/** Convenience form for callers that only need the composable HTML fragment. */
+export function renderReactFlowHtml(projection) {
+    return renderReactFlowStatic(projection).markup;
+}
+export const renderReactFlowProjection = renderReactFlowStatic;
+//# sourceMappingURL=react-flow.js.map