@jterrats/open-orchestra 1.0.14 → 1.0.16

package/dist/diagrams/layout.js

@@ -0,0 +1,142 @@
+import { rectCenter } from "./geometry.js";
+const PAGE_MARGIN = 48;
+const NODE_WIDTH = 184;
+const NODE_HEIGHT = 88;
+const ICON_SIZE = 24;
+const COLUMN_GAP = 96;
+const ROW_GAP = 56;
+const GROUP_PADDING = 24;
+const GROUP_HEADER = 30;
+const LABEL_WIDTH = 112;
+const LABEL_HEIGHT = 24;
+export function layoutDiagram(model) {
+    const lanes = createLanes(model);
+    const nodes = model.nodes.map((node, index) => layoutNode(model, node, index, lanes.get(node.groupId ?? "")));
+    const groups = layoutGroups(model, nodes);
+    const connectors = model.connectors.map((connector) => layoutConnector(connector, nodes));
+    const canvas = layoutCanvas(nodes, groups);
+    return { modelId: model.id, canvas, nodes, groups, connectors };
+}
+function createLanes(model) {
+    const lanes = new Map();
+    for (const node of model.nodes) {
+        const laneId = node.groupId ?? "";
+        if (!lanes.has(laneId)) {
+            lanes.set(laneId, lanes.size);
+        }
+    }
+    return lanes;
+}
+function layoutNode(model, node, index, laneIndex) {
+    const column = model.direction === "right" ? index : (laneIndex ?? 0);
+    const row = model.direction === "right" ? (laneIndex ?? 0) : index;
+    const x = PAGE_MARGIN + column * (NODE_WIDTH + COLUMN_GAP);
+    const y = PAGE_MARGIN + GROUP_HEADER + row * (NODE_HEIGHT + ROW_GAP);
+    const height = Math.max(NODE_HEIGHT, textLineCount(node) * 18 + 32);
+    const layout = {
+        nodeId: node.id,
+        x,
+        y,
+        width: NODE_WIDTH,
+        height,
+        text: {
+            x: x + (node.icon ? 52 : 16),
+            y: y + 18,
+            width: node.icon ? NODE_WIDTH - 68 : NODE_WIDTH - 32,
+            height: height - 32,
+        },
+    };
+    if (node.icon) {
+        layout.icon = { x: x + 16, y: y + 18, width: ICON_SIZE, height: ICON_SIZE };
+    }
+    return layout;
+}
+function textLineCount(node) {
+    return [node.text.label, node.text.description ?? ""]
+        .flatMap((line) => line.split("\n"))
+        .filter(Boolean).length;
+}
+function layoutGroups(model, nodes) {
+    return (model.groups ?? []).flatMap((group) => {
+        const childIds = model.nodes
+            .filter((node) => node.groupId === group.id)
+            .map((node) => node.id);
+        const childRects = nodes.filter((node) => childIds.includes(node.nodeId));
+        if (childRects.length === 0) {
+            return [];
+        }
+        const bounds = boundingRect(childRects);
+        return [
+            {
+                groupId: group.id,
+                x: bounds.x - GROUP_PADDING,
+                y: bounds.y - GROUP_HEADER,
+                width: bounds.width + GROUP_PADDING * 2,
+                height: bounds.height + GROUP_HEADER + GROUP_PADDING,
+            },
+        ];
+    });
+}
+function layoutConnector(connector, nodes) {
+    const from = findNodeLayout(nodes, connector.from);
+    const to = findNodeLayout(nodes, connector.to);
+    const start = rightAnchor(from);
+    const end = leftAnchor(to);
+    const points = routeConnector(start, end);
+    const layout = {
+        connectorId: connector.id,
+        points,
+    };
+    if (connector.label) {
+        layout.label = layoutConnectorLabel(points);
+    }
+    return layout;
+}
+function routeConnector(start, end) {
+    if (start.y === end.y || start.x === end.x) {
+        return [start, end];
+    }
+    const midX = start.x + (end.x - start.x) / 2;
+    return [start, { x: midX, y: start.y }, { x: midX, y: end.y }, end];
+}
+function layoutConnectorLabel(points) {
+    const midpoint = points[Math.floor(points.length / 2)] ?? { x: 0, y: 0 };
+    return {
+        x: midpoint.x - LABEL_WIDTH / 2,
+        y: midpoint.y - LABEL_HEIGHT / 2,
+        width: LABEL_WIDTH,
+        height: LABEL_HEIGHT,
+    };
+}
+function layoutCanvas(nodes, groups) {
+    const bounds = boundingRect([...groups, ...nodes]);
+    return {
+        x: 0,
+        y: 0,
+        width: bounds.x + bounds.width + PAGE_MARGIN,
+        height: bounds.y + bounds.height + PAGE_MARGIN,
+    };
+}
+function boundingRect(rects) {
+    const minX = Math.min(...rects.map((rect) => rect.x));
+    const minY = Math.min(...rects.map((rect) => rect.y));
+    const maxX = Math.max(...rects.map((rect) => rect.x + rect.width));
+    const maxY = Math.max(...rects.map((rect) => rect.y + rect.height));
+    return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+function findNodeLayout(nodes, nodeId) {
+    const node = nodes.find((layout) => layout.nodeId === nodeId);
+    if (!node) {
+        throw new Error(`connector references missing node: ${nodeId}`);
+    }
+    return node;
+}
+function rightAnchor(rect) {
+    const center = rectCenter(rect);
+    return { x: rect.x + rect.width, y: center.y };
+}
+function leftAnchor(rect) {
+    const center = rectCenter(rect);
+    return { x: rect.x, y: center.y };
+}
+//# sourceMappingURL=layout.js.map

package/dist/diagrams/layout.js.map

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

package/dist/diagrams/model.d.ts

@@ -0,0 +1,94 @@
+export type DiagramNodeKind = "actor" | "system" | "service" | "database" | "queue" | "boundary";
+export type DiagramConnectorKind = "sync" | "async" | "data" | "control";
+export type DiagramDirection = "right" | "down";
+export type DiagramSeverity = "error" | "warning";
+export interface DiagramText {
+    label: string;
+    description?: string;
+}
+export interface DiagramIconRef {
+    semantic: string;
+    iconifyId: string;
+}
+export interface DiagramNode {
+    id: string;
+    kind: DiagramNodeKind;
+    text: DiagramText;
+    groupId?: string;
+    icon?: DiagramIconRef;
+}
+export interface DiagramGroup {
+    id: string;
+    title: string;
+}
+export interface DiagramConnector {
+    id: string;
+    from: string;
+    to: string;
+    kind: DiagramConnectorKind;
+    label?: string;
+}
+export interface DiagramModel {
+    id: string;
+    title: string;
+    direction: DiagramDirection;
+    nodes: DiagramNode[];
+    connectors: DiagramConnector[];
+    groups?: DiagramGroup[];
+}
+export interface DiagramPoint {
+    x: number;
+    y: number;
+}
+export interface DiagramRect extends DiagramPoint {
+    width: number;
+    height: number;
+}
+export interface DiagramNodeLayout extends DiagramRect {
+    nodeId: string;
+    icon?: DiagramRect;
+    text: DiagramRect;
+}
+export interface DiagramGroupLayout extends DiagramRect {
+    groupId: string;
+}
+export interface DiagramConnectorLayout {
+    connectorId: string;
+    points: DiagramPoint[];
+    label?: DiagramRect;
+}
+export interface DiagramLayout {
+    modelId: string;
+    canvas: DiagramRect;
+    nodes: DiagramNodeLayout[];
+    connectors: DiagramConnectorLayout[];
+    groups: DiagramGroupLayout[];
+}
+export interface DiagramValidationFinding {
+    id: string;
+    severity: DiagramSeverity;
+    rule: string;
+    message: string;
+    elementId: string;
+}
+export interface DiagramArtifact {
+    model: DiagramModel;
+    layout: DiagramLayout;
+    svg: string;
+    findings: DiagramValidationFinding[];
+}
+export interface DiagramPipelineRunOptions {
+    maxPasses?: number;
+    retainIterations?: boolean;
+}
+export interface DiagramPipelineIteration {
+    pass: number;
+    artifact: DiagramArtifact;
+    action: "rendered" | "wrapped-text" | "accepted";
+    retained: boolean;
+}
+export interface DiagramPipelineRun {
+    final: DiagramArtifact;
+    iterations: DiagramPipelineIteration[];
+    discardedIterations: number;
+}

package/dist/diagrams/model.js

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

package/dist/diagrams/model.js.map

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

package/dist/diagrams/pipeline.d.ts

@@ -0,0 +1,11 @@
+import type { DiagramArtifact, DiagramModel, DiagramPipelineRun, DiagramPipelineRunOptions } from "./model.js";
+import type { IconifyIconCache } from "./iconify.js";
+export declare function generateDeterministicDiagram({ model, iconCache, }: {
+    model: DiagramModel;
+    iconCache?: IconifyIconCache;
+}): DiagramArtifact;
+export declare function runDeterministicDiagramPipeline({ model, iconCache, options, }: {
+    model: DiagramModel;
+    iconCache?: IconifyIconCache;
+    options?: DiagramPipelineRunOptions;
+}): DiagramPipelineRun;

package/dist/diagrams/pipeline.js

@@ -0,0 +1,92 @@
+import { layoutDiagram } from "./layout.js";
+import { renderDiagramSvg } from "./render-svg.js";
+import { validateDiagramArtifact } from "./validate.js";
+import { validateDiagramModelPayload } from "../diagram-schema.js";
+const DEFAULT_MAX_PASSES = 3;
+const TEXT_WRAP_CHARS = 20;
+export function generateDeterministicDiagram({ model, iconCache, }) {
+    const validModel = validateDiagramModelPayload(model);
+    const layout = layoutDiagram(validModel);
+    const findings = validateDiagramArtifact({ model: validModel, layout });
+    const svg = iconCache
+        ? renderDiagramSvg({ model: validModel, layout, iconCache })
+        : renderDiagramSvg({ model: validModel, layout });
+    return { model: validModel, layout, svg, findings };
+}
+export function runDeterministicDiagramPipeline({ model, iconCache, options = {}, }) {
+    const maxPasses = Math.max(1, options.maxPasses ?? DEFAULT_MAX_PASSES);
+    const allIterations = [];
+    let currentModel = model;
+    let nextAction = "rendered";
+    for (let pass = 1; pass <= maxPasses; pass += 1) {
+        const artifact = generateDeterministicDiagram(iconCache ? { model: currentModel, iconCache } : { model: currentModel });
+        const isAccepted = artifact.findings.every((finding) => finding.severity !== "error");
+        allIterations.push({
+            pass,
+            artifact,
+            action: isAccepted ? "accepted" : nextAction,
+            retained: false,
+        });
+        if (isAccepted || pass === maxPasses)
+            break;
+        const repairedModel = wrapTextFitFindings(currentModel, artifact);
+        if (repairedModel === currentModel)
+            break;
+        currentModel = repairedModel;
+        nextAction = "wrapped-text";
+    }
+    const retained = retainIterations(allIterations, options.retainIterations);
+    const final = allIterations.at(-1)?.artifact;
+    if (!final) {
+        throw new Error("diagram pipeline produced no iterations");
+    }
+    return {
+        final,
+        iterations: retained,
+        discardedIterations: allIterations.length - retained.length,
+    };
+}
+function retainIterations(iterations, retainAll = false) {
+    const retained = retainAll ? iterations : iterations.slice(-1);
+    return retained.map((iteration) => ({ ...iteration, retained: true }));
+}
+function wrapTextFitFindings(model, artifact) {
+    const textFitNodeIds = new Set(artifact.findings
+        .filter((finding) => finding.rule === "text-fit")
+        .map((finding) => finding.elementId));
+    if (textFitNodeIds.size === 0)
+        return model;
+    return {
+        ...model,
+        nodes: model.nodes.map((node) => textFitNodeIds.has(node.id)
+            ? { ...node, text: wrappedDiagramText(node.text) }
+            : node),
+    };
+}
+function wrappedDiagramText(text) {
+    return {
+        label: wrapText(text.label),
+        ...(text.description ? { description: wrapText(text.description) } : {}),
+    };
+}
+function wrapText(value) {
+    if (value.length <= TEXT_WRAP_CHARS || value.includes("\n"))
+        return value;
+    const words = value.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let current = "";
+    for (const word of words) {
+        const candidate = current ? `${current} ${word}` : word;
+        if (candidate.length > TEXT_WRAP_CHARS && current) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines.join("\n");
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/diagrams/pipeline.js.map

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

package/dist/diagrams/render-svg.d.ts

@@ -0,0 +1,7 @@
+import type { DiagramLayout, DiagramModel } from "./model.js";
+import { type IconifyIconCache } from "./iconify.js";
+export declare function renderDiagramSvg({ model, layout, iconCache, }: {
+    model: DiagramModel;
+    layout: DiagramLayout;
+    iconCache?: IconifyIconCache;
+}): string;

package/dist/diagrams/render-svg.js

@@ -0,0 +1,66 @@
+import { MemoryIconifyIconCache, resolveIconifySymbol, } from "./iconify.js";
+const NODE_FILL = "#ffffff";
+const NODE_STROKE = "#65758b";
+const GROUP_FILL = "#f8fafc";
+const GROUP_STROKE = "#cbd5e1";
+const CONNECTOR_STROKE = "#334155";
+export function renderDiagramSvg({ model, layout, iconCache = new MemoryIconifyIconCache(), }) {
+    return [
+        `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${layout.canvas.width} ${layout.canvas.height}" role="img" aria-labelledby="${escapeXml(model.id)}-title">`,
+        `<title id="${escapeXml(model.id)}-title">${escapeXml(model.title)}</title>`,
+        '<defs><marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="3" orient="auto"><path d="M0,0 L0,6 L9,3 z" fill="#334155"/></marker></defs>',
+        '<rect x="0" y="0" width="100%" height="100%" fill="#ffffff"/>',
+        ...layout.groups.map((group) => {
+            const modelGroup = model.groups?.find((item) => item.id === group.groupId);
+            return `<g data-group-id="${escapeXml(group.groupId)}"><rect x="${group.x}" y="${group.y}" width="${group.width}" height="${group.height}" rx="8" fill="${GROUP_FILL}" stroke="${GROUP_STROKE}"/><text x="${group.x + 16}" y="${group.y + 20}" font-size="13" font-family="Arial, sans-serif" fill="#334155">${escapeXml(modelGroup?.title ?? group.groupId)}</text></g>`;
+        }),
+        ...layout.connectors.map((connector) => {
+            const points = connector.points
+                .map((point) => `${point.x},${point.y}`)
+                .join(" ");
+            const label = connector.label
+                ? `<rect x="${connector.label.x}" y="${connector.label.y}" width="${connector.label.width}" height="${connector.label.height}" rx="4" fill="#ffffff" stroke="#e2e8f0"/><text x="${connector.label.x + 8}" y="${connector.label.y + 16}" font-size="11" font-family="Arial, sans-serif" fill="#334155">${escapeXml(model.connectors.find((item) => item.id === connector.connectorId)?.label ?? "")}</text>`
+                : "";
+            return `<g data-connector-id="${escapeXml(connector.connectorId)}"><polyline points="${points}" fill="none" stroke="${CONNECTOR_STROKE}" stroke-width="2" marker-end="url(#arrow)"/>${label}</g>`;
+        }),
+        ...layout.nodes.map((nodeLayout) => {
+            const node = model.nodes.find((item) => item.id === nodeLayout.nodeId);
+            if (!node) {
+                throw new Error(`layout references missing node: ${nodeLayout.nodeId}`);
+            }
+            const icon = node.icon && nodeLayout.icon
+                ? renderIcon(node.icon.iconifyId, nodeLayout.icon, iconCache)
+                : "";
+            return `<g data-node-id="${escapeXml(node.id)}"><rect x="${nodeLayout.x}" y="${nodeLayout.y}" width="${nodeLayout.width}" height="${nodeLayout.height}" rx="8" fill="${NODE_FILL}" stroke="${NODE_STROKE}" stroke-width="1.5"/>${icon}${renderMultilineText({ x: nodeLayout.text.x, y: nodeLayout.text.y + 16, lines: node.text.label.split("\n"), fontSize: 13, weight: "700", fill: "#0f172a" })}${node.text.description ? renderMultilineText({ x: nodeLayout.text.x, y: nodeLayout.text.y + 40, lines: node.text.description.split("\n"), fontSize: 11, fill: "#475569" }) : ""}</g>`;
+        }),
+        "</svg>",
+    ].join("");
+}
+function renderMultilineText({ x, y, lines, fontSize, fill, weight, }) {
+    const attrs = [
+        `x="${x}"`,
+        `y="${y}"`,
+        `font-size="${fontSize}"`,
+        'font-family="Arial, sans-serif"',
+        weight ? `font-weight="${weight}"` : "",
+        `fill="${fill}"`,
+    ]
+        .filter(Boolean)
+        .join(" ");
+    const tspans = lines
+        .map((line, index) => `<tspan x="${x}" dy="${index === 0 ? 0 : fontSize + 3}">${escapeXml(line)}</tspan>`)
+        .join("");
+    return `<text ${attrs}>${tspans}</text>`;
+}
+function renderIcon(iconifyId, rect, cache) {
+    const symbol = resolveIconifySymbol({ iconifyId, cache });
+    return `<svg x="${rect.x}" y="${rect.y}" width="${rect.width}" height="${rect.height}" viewBox="0 0 ${symbol.width} ${symbol.height}" aria-hidden="true" fill="#2563eb">${symbol.body}</svg>`;
+}
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+//# sourceMappingURL=render-svg.js.map

package/dist/diagrams/render-svg.js.map

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

package/dist/diagrams/validate.d.ts

@@ -0,0 +1,5 @@
+import type { DiagramLayout, DiagramModel, DiagramValidationFinding } from "./model.js";
+export declare function validateDiagramArtifact({ model, layout, }: {
+    model: DiagramModel;
+    layout: DiagramLayout;
+}): DiagramValidationFinding[];

package/dist/diagrams/validate.js

@@ -0,0 +1,120 @@
+import { pointDistance, polylineSegments, rectContainsRect, rectsOverlap, segmentIntersectsRect, } from "./geometry.js";
+const APPROX_CHAR_WIDTH = 7;
+const APPROX_LINE_HEIGHT = 16;
+const ENDPOINT_TOLERANCE = 1;
+export function validateDiagramArtifact({ model, layout, }) {
+    return [
+        ...validateTextFit(model, layout),
+        ...validateContainerBounds(layout),
+        ...validateConnectorEndpoints(model, layout),
+        ...validateConnectorOverlaps(layout),
+        ...validateConnectorLabelOverlaps(layout),
+        ...validateUnnecessaryBends(layout),
+    ];
+}
+function validateTextFit(model, layout) {
+    return layout.nodes.flatMap((nodeLayout) => {
+        const node = model.nodes.find((item) => item.id === nodeLayout.nodeId);
+        if (!node) {
+            return [];
+        }
+        const lines = [node.text.label, node.text.description ?? ""]
+            .flatMap((line) => line.split("\n"))
+            .filter((line) => line !== "");
+        const widestLine = Math.max(...lines.map((line) => line.length));
+        const expectedWidth = widestLine * APPROX_CHAR_WIDTH;
+        const expectedHeight = lines.length * APPROX_LINE_HEIGHT;
+        if (expectedWidth <= nodeLayout.text.width &&
+            expectedHeight <= nodeLayout.text.height) {
+            return [];
+        }
+        return [
+            finding("text-fit", node.id, `Text for node ${node.id} exceeds allocated text bounds.`),
+        ];
+    });
+}
+function validateContainerBounds(layout) {
+    const canvasFindings = layout.nodes
+        .filter((node) => !rectContainsRect(layout.canvas, node))
+        .map((node) => finding("canvas-containment", node.nodeId, `${node.nodeId} exceeds canvas.`));
+    const groupFindings = layout.groups.flatMap((group) => layout.nodes
+        .filter((node) => rectsOverlap(group, node) && !rectContainsRect(group, node))
+        .map((node) => finding("container-containment", group.groupId, `${node.nodeId} is not fully contained by ${group.groupId}.`)));
+    return [...canvasFindings, ...groupFindings];
+}
+function validateConnectorEndpoints(model, layout) {
+    return layout.connectors.flatMap((connectorLayout) => {
+        const connector = model.connectors.find((item) => item.id === connectorLayout.connectorId);
+        if (!connector) {
+            return [];
+        }
+        const source = findNodeLayout(layout.nodes, connector.from);
+        const target = findNodeLayout(layout.nodes, connector.to);
+        const firstPoint = connectorLayout.points[0];
+        const lastPoint = connectorLayout.points.at(-1);
+        const problems = [];
+        if (!firstPoint ||
+            pointDistance(firstPoint, rightAnchor(source)) > ENDPOINT_TOLERANCE) {
+            problems.push(finding("connector-endpoint", connector.id, `${connector.id} does not start on ${connector.from}.`));
+        }
+        if (!lastPoint ||
+            pointDistance(lastPoint, leftAnchor(target)) > ENDPOINT_TOLERANCE) {
+            problems.push(finding("connector-endpoint", connector.id, `${connector.id} does not end on ${connector.to}.`));
+        }
+        return problems;
+    });
+}
+function validateConnectorOverlaps(layout) {
+    return layout.connectors.flatMap((connector) => polylineSegments(connector.points).flatMap((segment) => layout.nodes
+        .filter((node) => !isConnectorEndpointNode(connector.points, node))
+        .filter((node) => segmentIntersectsRect(segment.start, segment.end, node))
+        .map((node) => finding("connector-overlap", connector.connectorId, `${connector.connectorId} crosses ${node.nodeId}.`))));
+}
+function validateConnectorLabelOverlaps(layout) {
+    const labels = layout.connectors.flatMap((connector) => connector.label
+        ? [{ connectorId: connector.connectorId, rect: connector.label }]
+        : []);
+    return labels.flatMap((label) => layout.connectors
+        .filter((connector) => connector.connectorId !== label.connectorId)
+        .filter((connector) => polylineSegments(connector.points).some((segment) => segmentIntersectsRect(segment.start, segment.end, label.rect)))
+        .map((connector) => finding("connector-label-overlap", label.connectorId, `${label.connectorId} label overlaps ${connector.connectorId}.`)));
+}
+function validateUnnecessaryBends(layout) {
+    return layout.connectors
+        .filter((connector) => connector.points.length > 2)
+        .filter((connector) => {
+        const first = connector.points[0];
+        const last = connector.points.at(-1);
+        return first && last && (first.x === last.x || first.y === last.y);
+    })
+        .map((connector) => finding("unnecessary-bend", connector.connectorId, `${connector.connectorId} has bends on a straight path.`, "warning"));
+}
+function isConnectorEndpointNode(points, node) {
+    const first = points[0];
+    const last = points.at(-1);
+    return Boolean((first && pointDistance(first, rightAnchor(node)) <= ENDPOINT_TOLERANCE) ||
+        (last && pointDistance(last, leftAnchor(node)) <= ENDPOINT_TOLERANCE));
+}
+function findNodeLayout(nodes, nodeId) {
+    const node = nodes.find((layout) => layout.nodeId === nodeId);
+    if (!node) {
+        throw new Error(`connector references missing node: ${nodeId}`);
+    }
+    return node;
+}
+function rightAnchor(rect) {
+    return { x: rect.x + rect.width, y: rect.y + rect.height / 2 };
+}
+function leftAnchor(rect) {
+    return { x: rect.x, y: rect.y + rect.height / 2 };
+}
+function finding(rule, elementId, message, severity = "error") {
+    return {
+        id: `${rule}:${elementId}`,
+        rule,
+        elementId,
+        message,
+        severity,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/diagrams/validate.js.map

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