@fazelstudio/floe 1.0.0

package/dist/src/render/svg.js

@@ -0,0 +1,227 @@
+import { renderNodeShape } from "./shapes.js";
+const DEFAULT_FONT = "ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif";
+/**
+ * Deterministic SVG renderer.
+ * Consumes LayoutResult (semantic + layout), not raw Floe text.
+ */
+export function renderSvg(layout, opts) {
+    const padding = opts?.padding ?? 0;
+    const background = opts?.background ?? "#ffffff";
+    const fontFamily = opts?.fontFamily ?? DEFAULT_FONT;
+    // Deterministic dimensions: layout width/height plus padding
+    const width = Math.ceil(layout.width + padding * 2);
+    const height = Math.ceil(layout.height + padding * 2);
+    const viewBox = `0 0 ${width} ${height}`;
+    // Sort for determinism
+    const nodesSorted = [...layout.nodes].sort((a, b) => a.id.localeCompare(b.id));
+    const edgesSorted = [...layout.edges].sort((a, b) => {
+        if (a.source !== b.source)
+            return a.source.localeCompare(b.source);
+        if (a.target !== b.target)
+            return a.target.localeCompare(b.target);
+        return (a.label ?? "").localeCompare(b.label ?? "");
+    });
+    const parts = [];
+    // Header
+    parts.push(`<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="${viewBox}" role="img" font-family="${escapeAttr(fontFamily)}">`);
+    // Background
+    if (background && background !== "transparent") {
+        parts.push(`<rect width="${width}" height="${height}" fill="${escapeAttr(background)}" />`);
+    }
+    // Styles
+    const css = opts?.css ?? defaultCss();
+    parts.push(`<style>${css}</style>`);
+    // Defs: arrowhead marker (deterministic id)
+    parts.push(`<defs>`);
+    parts.push(`<marker id="arrowhead" viewBox="0 0 10 7" refX="9" refY="3.5" markerWidth="10" markerHeight="7" orient="auto" markerUnits="strokeWidth">`);
+    parts.push(`<path d="M 0 0 L 10 3.5 L 0 7 z" fill="#334155" />`);
+    parts.push(`</marker>`);
+    parts.push(`</defs>`);
+    // Group for offset padding
+    const offset = padding;
+    if (offset !== 0)
+        parts.push(`<g transform="translate(${offset} ${offset})">`);
+    // Groups containers — draw behind nodes/edges but above background
+    const groups = layout.groups ?? [];
+    if (groups.length > 0) {
+        parts.push(`<g class="groups">`);
+        // flatten and sort deterministically already done by layout, but re-sort for rendering stability
+        const flatGroups = flattenGroups(groups);
+        // Draw outer groups first (sorted by area descending so outer wraps inner? For determinism, sort by id depth)
+        // Already deterministic, just render each via helper
+        for (const g of flatGroups) {
+            // For nested rendering, we render all groups individually; outer will be drawn before inner due to flat order (parent before child)
+            parts.push(renderGroupSvg(g, fontFamily));
+        }
+        parts.push(`</g>`);
+    }
+    // Edges group (draw first, under nodes)
+    parts.push(`<g class="edges" stroke-linecap="round" stroke-linejoin="round">`);
+    for (const e of edgesSorted) {
+        const d = pointsToPath(e.points);
+        const edgeId = `edge-${escapeId(e.source)}-${escapeId(e.target)}${e.label ? "-" + hashLabel(e.label) : ""}`;
+        // Edge semantics: directed has arrow, undirected is dashed without arrow
+        const isUndirected = e.data?.kind === "undirected";
+        const dash = isUndirected ? ` stroke-dasharray="6 3"` : "";
+        const marker = isUndirected ? "" : ` marker-end="url(#arrowhead)"`;
+        parts.push(`<path id="${edgeId}" d="${d}" fill="none" stroke="#334155" stroke-width="1.6"${dash}${marker} />`);
+    }
+    parts.push(`</g>`);
+    // Edge labels group (above edges, below nodes)
+    if (edgesSorted.some((e) => e.label)) {
+        parts.push(`<g class="edge-labels">`);
+        for (const e of edgesSorted) {
+            if (!e.label)
+                continue;
+            const pos = e.labelPos ?? midpoint(e.points);
+            const x = fmt(pos.x);
+            const y = fmt(pos.y);
+            const label = escapeXml(e.label);
+            // Estimate text width for background rect
+            const estW = estimateTextWidth(e.label) + 8;
+            const estH = 16;
+            const rx = 4;
+            // Background rect for readability
+            parts.push(`<g class="edge-label" transform="translate(${x} ${y})">`);
+            parts.push(`<rect x="${fmt(-estW / 2)}" y="${fmt(-estH / 2 + 1)}" width="${fmt(estW)}" height="${fmt(estH)}" rx="${rx}" ry="${rx}" fill="white" stroke="#e2e8f0" stroke-width="0.8" />`);
+            parts.push(`<text text-anchor="middle" dominant-baseline="middle" font-size="11" fill="#334155" font-family="${escapeAttr(fontFamily)}">${label}</text>`);
+            parts.push(`</g>`);
+        }
+        parts.push(`</g>`);
+    }
+    // Nodes group
+    parts.push(`<g class="nodes">`);
+    for (const n of nodesSorted) {
+        const shapeSvg = renderNodeShape(n);
+        const label = escapeXml(n.label);
+        const tx = fmt(n.x);
+        const ty = fmt(n.y);
+        // Node group with deterministic id and class per type
+        const kindClass = n.type ? `node-${escapeId(n.type)}` : `node-default`;
+        parts.push(`<g id="node-${escapeId(n.id)}" class="node ${kindClass}" data-node-id="${escapeAttr(n.id)}"${n.type ? ` data-node-type="${escapeAttr(n.type)}"` : ""}>`);
+        parts.push(shapeSvg);
+        // Label centered
+        // For database shape, label y is slightly lower due to cylinder top? Keep centered for now
+        parts.push(`<text x="${tx}" y="${ty}" text-anchor="middle" dominant-baseline="middle" font-size="12" font-weight="500" fill="#0f172a" font-family="${escapeAttr(fontFamily)}">${label}</text>`);
+        parts.push(`</g>`);
+    }
+    parts.push(`</g>`);
+    if (offset !== 0)
+        parts.push(`</g>`);
+    // Optional debug: bounding boxes
+    if (opts?.debug) {
+        parts.push(`<g class="debug">`);
+        for (const n of nodesSorted) {
+            const x = fmt(n.x - n.width / 2);
+            const y = fmt(n.y - n.height / 2);
+            parts.push(`<rect x="${x}" y="${y}" width="${fmt(n.width)}" height="${fmt(n.height)}" fill="none" stroke="red" stroke-dasharray="3 3" stroke-width="0.5" />`);
+        }
+        parts.push(`</g>`);
+    }
+    parts.push(`</svg>`);
+    return parts.join("\n");
+}
+function defaultCss() {
+    return `
+  .node text { pointer-events: none; user-select: none; }
+  .edge-label text { pointer-events: none; user-select: none; }
+  `;
+}
+function pointsToPath(points) {
+    if (points.length === 0)
+        return "";
+    if (points.length === 1)
+        return `M ${fmt(points[0].x)} ${fmt(points[0].y)}`;
+    const start = points[0];
+    let d = `M ${fmt(start.x)} ${fmt(start.y)}`;
+    for (let i = 1; i < points.length; i++) {
+        const p = points[i];
+        d += ` L ${fmt(p.x)} ${fmt(p.y)}`;
+    }
+    return d;
+}
+function midpoint(points) {
+    if (points.length === 0)
+        return { x: 0, y: 0 };
+    if (points.length === 1)
+        return points[0];
+    if (points.length === 2) {
+        const a = points[0], b = points[1];
+        return { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 };
+    }
+    const mid = Math.floor(points.length / 2);
+    const a = points[mid - 1], b = points[mid];
+    return { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 };
+}
+function estimateTextWidth(text) {
+    // Deterministic char width approximation: 6.5 per char at 11px
+    return text.length * 6.5;
+}
+function fmt(n) {
+    const r = Math.round(n * 100) / 100;
+    if (Number.isInteger(r))
+        return String(r);
+    return r.toFixed(2).replace(/\.?0+$/, "");
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function escapeAttr(s) {
+    return escapeXml(s);
+}
+function escapeId(s) {
+    // For SVG id attribute, replace invalid chars deterministically
+    return s.replace(/[^A-Za-z0-9_-]/g, "_");
+}
+function hashLabel(s) {
+    let h = 0;
+    for (let i = 0; i < s.length; i++) {
+        h = (h * 31 + s.charCodeAt(i)) | 0;
+    }
+    return Math.abs(h).toString(36).slice(0, 6);
+}
+function renderGroupSvg(g, fontFamily) {
+    const x = fmt(g.x - g.width / 2);
+    const y = fmt(g.y - g.height / 2);
+    const w = fmt(g.width);
+    const h = fmt(g.height);
+    const label = escapeXml(g.label);
+    const gid = escapeId(g.id);
+    const typeAttr = g.type ? ` data-group-type="${escapeAttr(g.type)}"` : "";
+    // Group container rect with subtle fill and header bar for label
+    const headerH = 22;
+    // Main group rect
+    const parts = [];
+    parts.push(`<g id="group-${gid}" class="group group-${gid}" data-group-id="${escapeAttr(g.id)}"${typeAttr}>`);
+    // Background
+    parts.push(`<rect x="${x}" y="${y}" width="${w}" height="${h}" rx="8" ry="8" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.2" stroke-dasharray="8 4" />`);
+    // Header bar
+    parts.push(`<rect x="${x}" y="${y}" width="${w}" height="${fmt(headerH)}" rx="8" ry="8" fill="#e2e8f0" stroke="none" />`);
+    // To keep header rounded only top, overlay bottom rect of header? Simplify as above.
+    // Clip bottom of header: draw rect covering lower part of header's rounded bottom to make sharp bottom
+    parts.push(`<rect x="${x}" y="${fmt(g.y - g.height / 2 + headerH / 2)}" width="${w}" height="${fmt(headerH / 2)}" fill="#e2e8f0" stroke="none" />`);
+    // Header label
+    parts.push(`<text x="${fmt(g.x)}" y="${fmt(g.y - g.height / 2 + headerH / 2 + 1)}" text-anchor="middle" dominant-baseline="middle" font-size="11" font-weight="600" fill="#334155" font-family="${escapeAttr(fontFamily)}">${label}</text>`);
+    parts.push(`</g>`);
+    return parts.join("\n");
+}
+function flattenGroups(groups) {
+    const out = [];
+    function dfs(arr) {
+        // Deterministic order: sort by id at each level (layout already sorted, but enforce)
+        const sorted = [...arr].sort((a, b) => a.id.localeCompare(b.id));
+        for (const g of sorted) {
+            out.push(g);
+            if (g.children && g.children.length > 0)
+                dfs(g.children);
+        }
+    }
+    dfs(groups);
+    return out;
+}
+//# sourceMappingURL=svg.js.map

package/dist/src/render/svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../../src/render/svg.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAe9C,MAAM,YAAY,GAAG,yFAAyF,CAAC;AAE/G;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,IAAuB;IACrE,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,SAAS,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,YAAY,CAAC;IAEpD,6DAA6D;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,KAAK,IAAI,MAAM,EAAE,CAAC;IAEzC,uBAAuB;IACvB,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS;IACT,KAAK,CAAC,IAAI,CAAC,kDAAkD,KAAK,aAAa,MAAM,cAAc,OAAO,6BAA6B,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEnK,aAAa;IACb,IAAI,UAAU,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,aAAa,MAAM,WAAW,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9F,CAAC;IAED,SAAS;IACT,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IAEpC,4CAA4C;IAC5C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,0IAA0I,CAAC,CAAC;IACvJ,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtB,2BAA2B;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,2BAA2B,MAAM,IAAI,MAAM,KAAK,CAAC,CAAC;IAE/E,mEAAmE;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,iGAAiG;QACjG,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,8GAA8G;QAC9G,qDAAqD;QACrD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,oIAAoI;YACpI,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5G,yEAAyE;QACzE,MAAM,YAAY,GAAI,CAAC,CAAC,IAAY,EAAE,IAAI,KAAK,YAAY,CAAC;QAC5D,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,+BAA+B,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,QAAQ,CAAC,oDAAoD,IAAI,GAAG,MAAM,KAAK,CAAC,CAAC;IACjH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnB,+CAA+C;IAC/C,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,CAAC,KAAK;gBAAE,SAAS;YACvB,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACjC,0CAA0C;YAC1C,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,EAAE,CAAC;YAChB,MAAM,EAAE,GAAG,CAAC,CAAC;YACb,kCAAkC;YAClC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,uDAAuD,CAAC,CAAC;YACzL,KAAK,CAAC,IAAI,CAAC,oGAAoG,UAAU,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;YAC1J,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,cAAc;IACd,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,sDAAsD;QACtD,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,SAAS,mBAAmB,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrK,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,iBAAiB;QACjB,2FAA2F;QAC3F,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,kHAAkH,UAAU,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QAChM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnB,IAAI,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAErC,iCAAiC;IACjC,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,yEAAyE,CAAC,CAAC;QAChK,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAErB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;;;GAGN,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAuC;IAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACzB,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACrB,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,MAAuC;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACrC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACpD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAE,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC;IAC7C,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,+DAA+D;IAC/D,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;AAC3B,CAAC;AAED,SAAS,GAAG,CAAC,CAAS;IACpB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACpC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,gEAAgE;IAChE,OAAO,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,CAA2C,EAAE,UAAkB;IACrF,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3B,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,iEAAiE;IACjE,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,kBAAkB;IAClB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,wBAAwB,GAAG,oBAAoB,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;IAC9G,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,CAAC,8FAA8F,CAAC,CAAC;IAC5J,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,GAAG,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC;IAC1H,qFAAqF;IACrF,uGAAuG;IACvG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC,aAAa,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,mCAAmC,CAAC,CAAC;IACpJ,eAAe;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,kHAAkH,UAAU,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAC7O,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa,CAAC,MAAkD;IACvE,MAAM,GAAG,GAA+C,EAAE,CAAC;IAC3D,SAAS,GAAG,CAAC,GAA+C;QAC1D,qFAAqF;QACrF,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,CAAC;IACZ,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/security/url.d.ts

@@ -0,0 +1,7 @@
+/**
+ * URL sanitization for Floe links — prevents execution vectors.
+ * Only allow safe schemes; block javascript:, data:, vbscript:
+ */
+export declare function sanitizeUrl(url: string): string | null;
+export declare function isSafeUrl(url: string): boolean;
+//# sourceMappingURL=url.d.ts.map

package/dist/src/security/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/security/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C"}

package/dist/src/security/url.js

@@ -0,0 +1,27 @@
+/**
+ * URL sanitization for Floe links — prevents execution vectors.
+ * Only allow safe schemes; block javascript:, data:, vbscript:
+ */
+export function sanitizeUrl(url) {
+    const s = url.trim();
+    if (!s)
+        return null;
+    if (/^(javascript|data|vbscript):/i.test(s))
+        return null;
+    // allow http/https, mailto, relative paths, or simple identifiers without scheme
+    if (/^https?:\/\//i.test(s))
+        return s;
+    if (/^mailto:/i.test(s))
+        return s;
+    if (s.startsWith("/") && !s.startsWith("//"))
+        return s;
+    // relative or simple: allow if no colon (no scheme) or known safe
+    if (!s.includes(":"))
+        return s;
+    // unknown scheme -> block
+    return null;
+}
+export function isSafeUrl(url) {
+    return sanitizeUrl(url) !== null;
+}
+//# sourceMappingURL=url.js.map

package/dist/src/security/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/security/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,IAAI,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,iFAAiF;IACjF,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACvD,kEAAkE;IAClE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,0BAA0B;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AACnC,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,111 @@
+import type { Range } from "./range.js";
+/**
+ * Supported diagram directions
+ */
+export type Direction = "TB" | "BT" | "LR" | "RL";
+export declare const DIRECTIONS: readonly Direction[];
+export declare const DEFAULT_DIRECTION: Direction;
+/**
+ * Identifier rules:
+ * - Must match: [A-Za-z_][A-Za-z0-9_-]*
+ * - Must start with letter or underscore
+ * - May contain letters, digits, underscore, hyphen
+ * - No spaces, no Unicode beyond ASCII, no leading digit, no punctuation other than _ and -
+ * - Case-sensitive
+ * - Display labels are separate concept; IDs are internal keys
+ */
+export declare const IDENTIFIER_RE: RegExp;
+export declare function isValidIdentifier(id: string): boolean;
+/**
+ * Semantic edge kind — directed or undirected association
+ */
+export type EdgeKind = "directed" | "undirected";
+/**
+ * Renderer-independent semantic model
+ * No visual coordinates, SVG, or layout information.
+ */
+export interface FloeNode {
+    id: string;
+    /** Display label — conceptually separate from `id`; quoted string after id/type, defaults to id if not set */
+    label?: string;
+    /** Explicit node type, e.g. "person", "service", "database" — semantic style reference */
+    type?: string;
+    /** Source range covering the identifier (and type brackets if present, and label if present) */
+    range: Range;
+}
+/**
+ * Annotation — semantic note attached to a node/group or diagram-level if target undefined.
+ */
+export interface FloeAnnotation {
+    /** Target node or group id; undefined => diagram-level */
+    target?: string;
+    text: string;
+    range: Range;
+}
+/**
+ * Link — semantic external link attached to a node/group.
+ */
+export interface FloeLink {
+    target: string;
+    url: string;
+    range: Range;
+}
+export interface FloeEdge {
+    source: string;
+    target: string;
+    label?: string;
+    /** Edge semantics: directed ( -> ) or undirected ( -- ) */
+    kind: EdgeKind;
+    /** Range covering entire edge statement */
+    range: Range;
+    /** Ranges for sub-components for diagnostics / tooling */
+    sourceRange: Range;
+    targetRange: Range;
+    labelRange?: Range;
+}
+/**
+ * Group — semantic container; may be nested. Renderer-independent.
+ */
+export interface FloeGroup {
+    id: string;
+    /** Display label for group (quoted string), defaults to id */
+    label?: string;
+    /** Semantic type e.g. "subsystem" */
+    type?: string;
+    range: Range;
+    /** Direct member node ids defined inside this group (not counting nested subgroup members) */
+    nodeIds: string[];
+    /** Nested groups */
+    groups: FloeGroup[];
+    /** Semantic metadata scoped to this group */
+    metadata: Record<string, string>;
+    /** Annotations scoped to this group */
+    annotations: FloeAnnotation[];
+    /** External link for group */
+    link?: string;
+    /** Parent group id if nested */
+    parentId?: string;
+}
+export interface FloeDiagram {
+    direction: Direction;
+    /** Direction declaration range if explicitly provided */
+    directionRange?: Range;
+    nodes: FloeNode[];
+    edges: FloeEdge[];
+    /** Top-level groups (nested via groups[].groups) */
+    groups: FloeGroup[];
+    /** Semantic metadata at diagram level */
+    metadata: Record<string, string>;
+    /** Diagram-level and targeted annotations */
+    annotations: FloeAnnotation[];
+    /** Semantic external links (target -> url) */
+    links: FloeLink[];
+}
+/**
+ * Full parse result including diagnostics
+ */
+export interface ParseResult {
+    diagram: FloeDiagram;
+    diagnostics: import("./diagnostics.js").Diagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAAsC,CAAC;AAClF,eAAO,MAAM,iBAAiB,EAAE,SAAgB,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,QAA8B,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,8GAA8G;IAC9G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,EAAE,QAAQ,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,KAAK,CAAC;IACb,0DAA0D;IAC1D,WAAW,EAAE,KAAK,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uCAAuC;IACvC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,yDAAyD;IACzD,cAAc,CAAC,EAAE,KAAK,CAAC;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,oDAAoD;IACpD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6CAA6C;IAC7C,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,OAAO,kBAAkB,EAAE,UAAU,EAAE,CAAC;CACtD"}

package/dist/src/types.js

@@ -0,0 +1,16 @@
+export const DIRECTIONS = ["TB", "BT", "LR", "RL"];
+export const DEFAULT_DIRECTION = "TB";
+/**
+ * Identifier rules:
+ * - Must match: [A-Za-z_][A-Za-z0-9_-]*
+ * - Must start with letter or underscore
+ * - May contain letters, digits, underscore, hyphen
+ * - No spaces, no Unicode beyond ASCII, no leading digit, no punctuation other than _ and -
+ * - Case-sensitive
+ * - Display labels are separate concept; IDs are internal keys
+ */
+export const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+export function isValidIdentifier(id) {
+    return IDENTIFIER_RE.test(id);
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,UAAU,GAAyB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAc,IAAI,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAEzD,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/validator.d.ts

@@ -0,0 +1,47 @@
+import type { Diagnostic } from "./diagnostics.js";
+import type { FloeDiagram, FloeNode, FloeEdge, FloeGroup } from "./types.js";
+import type { Range } from "./range.js";
+/**
+ * Input for semantic validation — separates syntax parsing from semantic checks.
+ */
+export interface ValidationInput {
+    /** Diagram produced by parser (may contain duplicates before validation) */
+    diagram: FloeDiagram;
+    /** Diagnostics already produced by parser (syntax errors) */
+    diagnostics: Diagnostic[];
+    /** Explicit node declarations as parsed (including duplicates, before implicit expansion) */
+    explicitNodes: FloeNode[];
+    /** Parsed edges */
+    edges: FloeEdge[];
+    /** All direction declarations as they appeared in source */
+    directionDeclarations: Array<{
+        value: string;
+        range: Range;
+        rawLexeme: string;
+    }>;
+    /** Groups tree */
+    groups?: FloeGroup[];
+    /** Annotations */
+    annotations?: import("./types.js").FloeAnnotation[];
+    /** Links */
+    links?: import("./types.js").FloeLink[];
+}
+export interface ValidationResult {
+    diagram: FloeDiagram;
+    diagnostics: Diagnostic[];
+}
+/**
+ * Semantic validator
+ *
+ * Detects:
+ * - invalid direction (E001)
+ * - invalid identifiers (E002)
+ * - duplicate node declarations (E003)
+ * - duplicate direction declarations (E004)
+ * - malformed / invalid constructs (E005, E008, etc.)
+ *
+ * Keeps validation separate from parsing so the core model can be reused
+ * without parser errors leaking into semantics.
+ */
+export declare function validate(input: ValidationInput): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/src/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,OAAO,EAAE,WAAW,CAAC;IACrB,6DAA6D;IAC7D,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,6FAA6F;IAC7F,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC1B,mBAAmB;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,4DAA4D;IAC5D,qBAAqB,EAAE,KAAK,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,kBAAkB;IAClB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,kBAAkB;IAClB,WAAW,CAAC,EAAE,OAAO,YAAY,EAAE,cAAc,EAAE,CAAC;IACpD,YAAY;IACZ,KAAK,CAAC,EAAE,OAAO,YAAY,EAAE,QAAQ,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAyQjE"}