@sgummalla-works/sketchon 0.1.0

package/dist/adapters/satori.js

@@ -0,0 +1,269 @@
+/**
+ * Satori technique — the PRIMARY engine for the north-star (case #11).
+ *
+ * The model declares a coordinate-free spec; here we map it to a flexbox tree
+ * and Satori (Vercel's headless HTML/CSS→SVG engine) computes every pixel. This
+ * is the whole thesis made real: no hand-computed coordinates, so the failure
+ * mode that killed the original SVG attempt (overlaps on weak models) cannot
+ * occur — flexbox children never overlap.
+ *
+ * It renders the reference aesthetic: a vertical pipeline of category-coloured
+ * rich CARDS (icon chip + title + ·-joined sub-capabilities, white-on-fill),
+ * interspersed gold CHECKPOINT pills, a paired muted annotation column with
+ * column headers, thin connectors between stages, and a category LEGEND.
+ *
+ * Geometry eval returns no boxes (Satori can't report coordinates and can't
+ * overlap) — fidelity + the visual gallery are the real signal here.
+ */
+import satori from 'satori';
+import { loadFonts } from './fonts.js';
+import { emojiToDataUri } from './emoji.js';
+import { CARD_PALETTE, CHECKPOINT_COLORS, el, monogram, stripEmoji, } from './satori-helpers.js';
+/**
+ * Render a node's leading glyph. If the node carries an emoji `icon`, emit it as
+ * text at `size` — Satori turns it into a Twemoji image via loadAdditionalAsset.
+ * Otherwise fall back to a tinted monogram chip so iconless cards still read.
+ */
+function iconEl(node, size, onCard) {
+    if (node.icon) {
+        return el('div', { display: 'flex', alignItems: 'center', justifyContent: 'center', fontSize: size }, node.icon);
+    }
+    return el('div', {
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        width: 32,
+        height: 32,
+        borderRadius: 8,
+        background: onCard ? 'rgba(255,255,255,0.18)' : 'rgba(15,23,42,0.08)',
+        color: onCard ? '#ffffff' : '#334155',
+        fontSize: 15,
+        fontWeight: 700,
+    }, monogram(node.label));
+}
+// Layout constants (container-level only — never per-node coordinates).
+const WIDTH = 1100;
+const PAD = 32;
+const LEFT_W = 560; // pipeline column width
+const GAP_COL = 28; // gap to the annotation column
+const CARD_H = 66;
+const CHECKPOINT_H = 40;
+const CONNECTOR_H = 24;
+const HEADER_H = 34;
+const LEGEND_H = 52;
+const ARROW_W = 10; // connector arrowhead width
+const ARROW_H = 7; // connector arrowhead height
+const CONNECTOR_COLOR = '#cbd5e1';
+const TITLE_H = 40;
+/** Map a node to its fill colour via category → emphasis → palette. */
+function nodeEmphasis(spec, node) {
+    if (node.category) {
+        const cat = spec.categories?.find((c) => c.id === node.category);
+        if (cat?.emphasis)
+            return cat.emphasis;
+    }
+    return node.emphasis ?? 'normal';
+}
+/** The `·`-joined sub-line for a card. */
+function subline(node) {
+    if (node.sublabelParts?.length)
+        return node.sublabelParts.map(stripEmoji).join('  ·  ');
+    return node.sublabel ? stripEmoji(node.sublabel) : '';
+}
+function cardEl(spec, node) {
+    const fill = CARD_PALETTE[nodeEmphasis(spec, node)];
+    const sub = subline(node);
+    return el('div', {
+        display: 'flex',
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap: 14,
+        width: LEFT_W,
+        height: CARD_H,
+        padding: '0 18px',
+        borderRadius: 12,
+        background: fill,
+    }, [
+        iconEl(node, 28, true),
+        el('div', { display: 'flex', flexDirection: 'column', gap: 2 }, [
+            el('div', { color: '#ffffff', fontSize: 16, fontWeight: 700 }, stripEmoji(node.label)),
+            sub
+                ? el('div', { color: 'rgba(255,255,255,0.82)', fontSize: 12, fontWeight: 400 }, sub)
+                : null,
+        ]),
+    ]);
+}
+function checkpointEl(node) {
+    return el('div', {
+        display: 'flex',
+        flexDirection: 'row',
+        alignItems: 'center',
+        alignSelf: 'flex-start',
+        gap: 8,
+        height: CHECKPOINT_H,
+        padding: '0 18px',
+        borderRadius: 999,
+        background: CHECKPOINT_COLORS.fill,
+        border: `1px solid ${CHECKPOINT_COLORS.border}`,
+        color: CHECKPOINT_COLORS.text,
+        fontSize: 14,
+        fontWeight: 600,
+    }, [
+        node.icon
+            ? el('div', { display: 'flex', fontSize: 14 }, node.icon)
+            : el('div', { display: 'flex', fontWeight: 700 }, 'II'),
+        el('div', { display: 'flex' }, stripEmoji(node.label)),
+    ]);
+}
+/**
+ * Thin vertical connector + downward arrowhead between consecutive stages. The
+ * arrowhead is a CSS-border triangle (a 0×0 box with transparent side borders
+ * and a coloured top border) — pure flexbox, no coordinates, matches the
+ * reference's arrowed connectors.
+ */
+function connectorEl() {
+    const stem = CONNECTOR_H - ARROW_H - 2;
+    return el('div', {
+        display: 'flex',
+        flexDirection: 'column',
+        width: LEFT_W,
+        height: CONNECTOR_H,
+        alignItems: 'center',
+        justifyContent: 'center',
+    }, [
+        el('div', { width: 2, height: stem, background: CONNECTOR_COLOR }, undefined),
+        el('div', {
+            width: 0,
+            height: 0,
+            borderLeft: `${ARROW_W / 2}px solid transparent`,
+            borderRight: `${ARROW_W / 2}px solid transparent`,
+            borderTop: `${ARROW_H}px solid ${CONNECTOR_COLOR}`,
+        }, undefined),
+    ]);
+}
+function buildTree(spec) {
+    const annByTarget = new Map();
+    for (const a of spec.annotations ?? []) {
+        if (a.target)
+            annByTarget.set(a.target, stripEmoji(a.text));
+    }
+    const bodyRows = [];
+    spec.nodes.forEach((node, idx) => {
+        if (idx > 0) {
+            bodyRows.push(el('div', { display: 'flex', flexDirection: 'row', width: '100%' }, [
+                connectorEl(),
+                el('div', { display: 'flex', flex: 1 }, undefined),
+            ]));
+        }
+        const left = node.shape === 'checkpoint' ? checkpointEl(node) : cardEl(spec, node);
+        const ann = annByTarget.get(node.id);
+        bodyRows.push(el('div', { display: 'flex', flexDirection: 'row', width: '100%', alignItems: 'center' }, [
+            el('div', { display: 'flex', width: LEFT_W }, [left]),
+            el('div', {
+                display: 'flex',
+                flex: 1,
+                paddingLeft: GAP_COL,
+                color: '#64748b',
+                fontSize: 14,
+                fontWeight: 400,
+                alignItems: 'center',
+            }, ann ?? ''),
+        ]));
+    });
+    const children = [];
+    if (spec.title) {
+        children.push(el('div', { display: 'flex', color: '#0f172a', fontSize: 18, fontWeight: 700, height: TITLE_H }, stripEmoji(spec.title)));
+    }
+    if (spec.columns) {
+        children.push(el('div', {
+            display: 'flex',
+            flexDirection: 'row',
+            width: '100%',
+            height: HEADER_H,
+            alignItems: 'center',
+            borderBottom: '1px solid #e2e8f0',
+            marginBottom: 6,
+        }, [
+            el('div', { display: 'flex', width: LEFT_W, color: '#94a3b8', fontSize: 13, fontWeight: 600 }, spec.columns.primary),
+            el('div', { display: 'flex', flex: 1, paddingLeft: GAP_COL, color: '#94a3b8', fontSize: 13, fontWeight: 600 }, spec.columns.annotation),
+        ]));
+    }
+    children.push(el('div', { display: 'flex', flexDirection: 'column', width: '100%' }, bodyRows));
+    if (spec.categories?.length) {
+        const items = spec.categories.map((c) => el('div', { display: 'flex', flexDirection: 'row', alignItems: 'center', gap: 8, marginRight: 22 }, [
+            el('div', { width: 14, height: 14, borderRadius: 4, background: CARD_PALETTE[c.emphasis ?? 'normal'] }, undefined),
+            el('div', { display: 'flex', color: '#475569', fontSize: 13 }, c.label),
+        ]));
+        children.push(el('div', {
+            display: 'flex',
+            flexDirection: 'row',
+            flexWrap: 'wrap',
+            width: '100%',
+            height: LEGEND_H,
+            alignItems: 'center',
+            marginTop: 8,
+            borderTop: '1px solid #e2e8f0',
+            paddingTop: 12,
+        }, items));
+    }
+    return el('div', {
+        display: 'flex',
+        flexDirection: 'column',
+        width: '100%',
+        height: '100%',
+        padding: PAD,
+        background: '#ffffff',
+    }, children);
+}
+/** Estimate container height from row counts (container-level math, not per-node placement). */
+function estimateHeight(spec) {
+    let h = PAD * 2;
+    if (spec.title)
+        h += TITLE_H;
+    if (spec.columns)
+        h += HEADER_H + 6;
+    spec.nodes.forEach((n, idx) => {
+        if (idx > 0)
+            h += CONNECTOR_H;
+        h += n.shape === 'checkpoint' ? CHECKPOINT_H : CARD_H;
+    });
+    if (spec.categories?.length)
+        h += LEGEND_H + 12;
+    return Math.ceil(h) + 8;
+}
+export const satoriTechnique = {
+    key: 'satori',
+    name: 'Satori (flexbox → SVG)',
+    blurb: 'Model declares structure; Satori computes every pixel via flexbox. Primary engine for cards/columns/legend.',
+    async render(spec) {
+        const fonts = loadFonts();
+        const height = estimateHeight(spec);
+        const tree = buildTree(spec);
+        const svg = await satori(tree, {
+            width: WIDTH,
+            height,
+            fonts: fonts,
+            // Satori has no emoji font; resolve each emoji grapheme to a Twemoji SVG.
+            loadAdditionalAsset: async (code, segment) => {
+                if (code === 'emoji')
+                    return emojiToDataUri(segment);
+                return '';
+            },
+        });
+        const nodes = spec.nodes ?? [];
+        return {
+            svg,
+            width: WIDTH,
+            height,
+            // No boxes/edges: flexbox can't overlap + Satori doesn't report coords.
+            features: {
+                cards: nodes.some((n) => n.shape === 'card'),
+                checkpoints: nodes.some((n) => n.shape === 'checkpoint'),
+                twoColumn: !!spec.columns,
+                legend: !!spec.categories?.length,
+                categoryColors: nodes.some((n) => !!n.category),
+            },
+        };
+    },
+};
+//# sourceMappingURL=satori.js.map

package/dist/adapters/satori.js.map

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

package/dist/adapters/sequence.d.ts

@@ -0,0 +1,3 @@
+import type { Technique } from '../ports/Technique.js';
+export declare const sequenceTechnique: Technique;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/adapters/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../src/adapters/sequence.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAiDrE,eAAO,MAAM,iBAAiB,EAAE,SA6G/B,CAAC"}

package/dist/adapters/sequence.js

@@ -0,0 +1,136 @@
+/**
+ * Sequence diagram adapter — proper lifeline rendering.
+ *
+ * Actors become equally-spaced columns; edges become ordered horizontal rows.
+ * The model declares actors in left-to-right order and messages in time order;
+ * this adapter computes every coordinate algorithmically.
+ * Labels never overlap because each message occupies a unique Y row.
+ */
+import { NODE_LABEL_FONT_SIZE, EDGE_LABEL_FONT_SIZE, } from '../constants.js';
+import { DARK_PRIMARY, DARK_ACCENT, DARK_SUCCESS, DARK_DANGER, DARK_NORMAL, DARK_MUTED, ACTOR_CYCLE_FILLS, COLOR_TEXT_WHITE, COLOR_TEXT_PRIMARY, COLOR_BORDER_DEFAULT, COLOR_EDGE_DASHED, COLOR_EDGE_DEFAULT, COLOR_TEXT_MUTED, COLOR_TEXT_BODY, } from '../domain/theme.js';
+import { esc, svgDocument } from './svg.js';
+// ── Layout constants ──────────────────────────────────────────────────────────
+const ACTOR_COL_W = 210;
+const ACTOR_BOX_W = 178;
+const ACTOR_BOX_H = 50;
+const ACTOR_BOX_RX = 10;
+const CANVAS_PAD_X = 40;
+const CANVAS_PAD_BOTTOM = 48;
+const TITLE_H = 32;
+const ACTOR_Y_PAD = 10;
+const LIFELINE_GAP = 10;
+const FIRST_MSG_OFFSET = 52;
+const MSG_STEP = 52;
+const ARROW_SIZE = 8;
+const SELF_LOOP_W = 44;
+// ─────────────────────────────────────────────────────────────────────────────
+const EMPHASIS_DARK = {
+    primary: DARK_PRIMARY,
+    accent: DARK_ACCENT,
+    success: DARK_SUCCESS,
+    danger: DARK_DANGER,
+    normal: DARK_NORMAL,
+    muted: DARK_MUTED,
+};
+function actorFill(emphasis, index) {
+    if (emphasis && emphasis in EMPHASIS_DARK)
+        return EMPHASIS_DARK[emphasis];
+    return ACTOR_CYCLE_FILLS[index % ACTOR_CYCLE_FILLS.length];
+}
+function actorCx(i) {
+    return CANVAS_PAD_X + (i + 0.5) * ACTOR_COL_W;
+}
+function messageY(actorBoxBottom, rowIndex) {
+    return actorBoxBottom + FIRST_MSG_OFFSET + rowIndex * MSG_STEP;
+}
+function arrowhead(x1, x2, y, isDashed) {
+    const dir = x2 >= x1 ? 1 : -1;
+    const tip = x2;
+    const base = tip - dir * ARROW_SIZE;
+    const half = ARROW_SIZE * 0.5;
+    const fill = isDashed ? COLOR_EDGE_DASHED : COLOR_EDGE_DEFAULT;
+    return `<polygon points="${tip},${y} ${base},${y - half} ${base},${y + half}" fill="${fill}"/>`;
+}
+export const sequenceTechnique = {
+    key: 'sequence',
+    name: 'Sequence (lifeline)',
+    blurb: 'Actor columns + message rows — proper lifeline diagram, no ELK.',
+    render(spec) {
+        const nodes = spec.nodes;
+        const edges = spec.edges;
+        const n = nodes.length;
+        const width = CANVAS_PAD_X * 2 + n * ACTOR_COL_W;
+        const hasTitle = !!spec.title;
+        const actorBoxTop = (hasTitle ? TITLE_H : 0) + ACTOR_Y_PAD;
+        const actorBoxBottom = actorBoxTop + ACTOR_BOX_H;
+        const lifelineTop = actorBoxBottom + LIFELINE_GAP;
+        const lifelineBottom = actorBoxBottom + FIRST_MSG_OFFSET + edges.length * MSG_STEP + CANVAS_PAD_BOTTOM;
+        const height = lifelineBottom;
+        const colOf = new Map(nodes.map((nd, i) => [nd.id, i]));
+        const parts = [];
+        if (spec.title) {
+            parts.push(`<text x="${CANVAS_PAD_X}" y="${ACTOR_Y_PAD - 2}" ` +
+                `font-size="17" font-weight="700" fill="${COLOR_TEXT_PRIMARY}">${esc(spec.title)}</text>`);
+        }
+        nodes.forEach((_, i) => {
+            const cx = actorCx(i);
+            parts.push(`<line x1="${cx.toFixed(1)}" y1="${lifelineTop}" ` +
+                `x2="${cx.toFixed(1)}" y2="${lifelineBottom}" ` +
+                `stroke="${COLOR_BORDER_DEFAULT}" stroke-width="1.5" stroke-dasharray="6 4"/>`);
+        });
+        nodes.forEach((node, i) => {
+            const cx = actorCx(i);
+            const bx = cx - ACTOR_BOX_W / 2;
+            const fill = actorFill(node.emphasis, i);
+            const cy = actorBoxTop + ACTOR_BOX_H / 2;
+            parts.push(`<rect x="${bx.toFixed(1)}" y="${actorBoxTop}" ` +
+                `width="${ACTOR_BOX_W}" height="${ACTOR_BOX_H}" ` +
+                `rx="${ACTOR_BOX_RX}" fill="${fill}" stroke="none"/>`, `<text x="${cx.toFixed(1)}" y="${cy.toFixed(1)}" ` +
+                `font-size="${NODE_LABEL_FONT_SIZE}" font-weight="600" fill="${COLOR_TEXT_WHITE}" ` +
+                `text-anchor="middle" dominant-baseline="middle">${esc(node.label)}</text>`);
+        });
+        edges.forEach((edge, rowIdx) => {
+            const fromCol = colOf.get(edge.from) ?? 0;
+            const toCol = colOf.get(edge.to) ?? 0;
+            const y = messageY(actorBoxBottom, rowIdx);
+            const isDashed = edge.style === 'dashed' || edge.style === 'dotted' ||
+                edge.semantic === 'return';
+            const stroke = isDashed ? COLOR_EDGE_DASHED : COLOR_EDGE_DEFAULT;
+            const dash = isDashed ? ' stroke-dasharray="6 4"' : '';
+            if (fromCol === toCol) {
+                const cx = actorCx(fromCol);
+                const loopH = Math.round(MSG_STEP * 0.55);
+                parts.push(`<path d="M${cx.toFixed(1)},${y} L${(cx + SELF_LOOP_W).toFixed(1)},${y} ` +
+                    `L${(cx + SELF_LOOP_W).toFixed(1)},${y + loopH} L${cx.toFixed(1)},${y + loopH}" ` +
+                    `fill="none" stroke="${stroke}" stroke-width="1.5"${dash}/>`, arrowhead(cx + SELF_LOOP_W, cx, y + loopH, isDashed));
+                if (edge.label) {
+                    parts.push(`<text x="${(cx + SELF_LOOP_W + 5).toFixed(1)}" y="${(y + loopH / 2).toFixed(1)}" ` +
+                        `font-size="${EDGE_LABEL_FONT_SIZE}" fill="${COLOR_TEXT_MUTED}" dominant-baseline="middle">${esc(edge.label)}</text>`);
+                }
+                return;
+            }
+            const x1 = actorCx(fromCol);
+            const x2 = actorCx(toCol);
+            const xMid = (x1 + x2) / 2;
+            const dir = x2 > x1 ? 1 : -1;
+            parts.push(`<line x1="${x1.toFixed(1)}" y1="${y}" x2="${(x2 - dir * ARROW_SIZE).toFixed(1)}" y2="${y}" ` +
+                `stroke="${stroke}" stroke-width="1.5"${dash}/>`, arrowhead(x1, x2, y, isDashed));
+            if (edge.label) {
+                parts.push(`<text x="${xMid.toFixed(1)}" y="${(y - 7).toFixed(1)}" ` +
+                    `font-size="${EDGE_LABEL_FONT_SIZE}" fill="${COLOR_TEXT_BODY}" text-anchor="middle">${esc(edge.label)}</text>`);
+            }
+        });
+        return {
+            svg: svgDocument(width, height, parts.join('\n')),
+            width,
+            height,
+            boxes: [],
+            edges: [],
+            features: {
+                cards: false, checkpoints: false, twoColumn: false,
+                legend: false, categoryColors: false,
+            },
+        };
+    },
+};
+//# sourceMappingURL=sequence.js.map

package/dist/adapters/sequence.js.map

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

package/dist/adapters/svg.d.ts

@@ -0,0 +1,43 @@
+import type { Emphasis } from '../domain/spec.js';
+/** Escape text for safe inclusion in SVG/XML text nodes + attributes. */
+export declare function esc(s: string): string;
+/**
+ * Estimate rendered text width with no font engine available.
+ *
+ * @param text the string to measure
+ * @param fontSize px font size
+ * @returns estimated width in px
+ */
+export declare function estimateTextWidth(text: string, fontSize?: number): number;
+/**
+ * Greedy word-wrap a label to fit a maximum pixel width. A single word longer
+ * than the limit is kept on its own line (it sets the line width) rather than
+ * being broken mid-word. Used so graph nodes with long sentence labels grow in
+ * height instead of overflowing their box.
+ *
+ * @param text the label to wrap
+ * @param maxWidth maximum line width in px
+ * @param fontSize px font size for width estimation
+ * @returns the wrapped lines (always ≥1)
+ */
+export declare function wrapText(text: string, maxWidth: number, fontSize?: number): string[];
+/**
+ * Theme tokens keyed by emphasis. A single light palette for the baseline;
+ * Phase 2 will add a dark variant + per-engine theming.
+ */
+export declare const PALETTE: Record<Emphasis, {
+    fill: string;
+    stroke: string;
+    text: string;
+}>;
+/** Resolve a palette entry, defaulting to `normal`. */
+export declare function palette(emphasis: Emphasis | undefined): {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+/** Build the arrowhead marker defs (filled + open). */
+export declare function arrowDefs(): string;
+/** Wrap body markup in a complete, standalone SVG document. */
+export declare function svgDocument(width: number, height: number, body: string): string;
+//# sourceMappingURL=svg.d.ts.map

package/dist/adapters/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/adapters/svg.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOrC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAuB,GAAG,MAAM,CAEvF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAuB,GAAG,MAAM,EAAE,CAgBlG;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOpF,CAAC;AAEF,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS;UAVP,MAAM;YAAU,MAAM;UAAQ,MAAM;EAYlF;AAED,uDAAuD;AACvD,wBAAgB,SAAS,IAAI,MAAM,CASlC;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/E"}

package/dist/adapters/svg.js

@@ -0,0 +1,92 @@
+/**
+ * Tiny SVG building helpers. No dependency — just string assembly with proper
+ * escaping. Shared by techniques that emit SVG directly (the baseline today;
+ * Satori/resvg techniques in Phase 2 produce SVG via their own engines).
+ */
+import { AVG_CHAR_WIDTH_EM, NODE_LABEL_FONT_SIZE, } from '../constants.js';
+/** Escape text for safe inclusion in SVG/XML text nodes + attributes. */
+export function esc(s) {
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * Estimate rendered text width with no font engine available.
+ *
+ * @param text the string to measure
+ * @param fontSize px font size
+ * @returns estimated width in px
+ */
+export function estimateTextWidth(text, fontSize = NODE_LABEL_FONT_SIZE) {
+    return text.length * AVG_CHAR_WIDTH_EM * fontSize;
+}
+/**
+ * Greedy word-wrap a label to fit a maximum pixel width. A single word longer
+ * than the limit is kept on its own line (it sets the line width) rather than
+ * being broken mid-word. Used so graph nodes with long sentence labels grow in
+ * height instead of overflowing their box.
+ *
+ * @param text the label to wrap
+ * @param maxWidth maximum line width in px
+ * @param fontSize px font size for width estimation
+ * @returns the wrapped lines (always ≥1)
+ */
+export function wrapText(text, maxWidth, fontSize = NODE_LABEL_FONT_SIZE) {
+    const words = text.split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return [text];
+    const lines = [];
+    let line = '';
+    for (const word of words) {
+        const candidate = line ? `${line} ${word}` : word;
+        if (line && estimateTextWidth(candidate, fontSize) > maxWidth) {
+            lines.push(line);
+            line = word;
+        }
+        else {
+            line = candidate;
+        }
+    }
+    if (line)
+        lines.push(line);
+    return lines;
+}
+/**
+ * Theme tokens keyed by emphasis. A single light palette for the baseline;
+ * Phase 2 will add a dark variant + per-engine theming.
+ */
+export const PALETTE = {
+    normal: { fill: '#f1f5f9', stroke: '#94a3b8', text: '#0f172a' },
+    primary: { fill: '#dbeafe', stroke: '#3b82f6', text: '#0c2a5b' },
+    accent: { fill: '#ede9fe', stroke: '#8b5cf6', text: '#3b1d80' },
+    muted: { fill: '#f8fafc', stroke: '#cbd5e1', text: '#475569' },
+    danger: { fill: '#fee2e2', stroke: '#ef4444', text: '#7f1d1d' },
+    success: { fill: '#dcfce7', stroke: '#22c55e', text: '#14532d' },
+};
+/** Resolve a palette entry, defaulting to `normal`. */
+export function palette(emphasis) {
+    return PALETTE[emphasis ?? 'normal'];
+}
+/** Build the arrowhead marker defs (filled + open). */
+export function arrowDefs() {
+    return `<defs>
+  <marker id="arrow-filled" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+    <path d="M0,0 L10,5 L0,10 z" fill="#475569"/>
+  </marker>
+  <marker id="arrow-open" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+    <path d="M0,0 L10,5 L0,10" fill="none" stroke="#475569" stroke-width="1.5"/>
+  </marker>
+</defs>`;
+}
+/** Wrap body markup in a complete, standalone SVG document. */
+export function svgDocument(width, height, body) {
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" font-family="ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif">
+<rect x="0" y="0" width="${width}" height="${height}" fill="#ffffff"/>
+${arrowDefs()}
+${body}
+</svg>`;
+}
+//# sourceMappingURL=svg.js.map

package/dist/adapters/svg.js.map

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

package/dist/application/registry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * TechniqueRegistry — injectable registry for layout engines.
+ *
+ * HEXAGONAL ARCHITECTURE INVARIANT:
+ *   This file MUST NEVER import from '../adapters/' or any concrete adapter.
+ *   It depends only on the Technique port interface (application layer).
+ *   Adapters are registered externally from the composition root (index.ts).
+ *
+ * OPEN/CLOSED:
+ *   Adding a new engine = register it in index.ts + add its key to the
+ *   EngineKey union in router.ts. This class itself never changes.
+ *
+ * DEPENDENCY INVERSION:
+ *   High-level modules (router) depend on this abstraction.
+ *   Low-level adapters register themselves at startup; they never appear here.
+ */
+import type { Technique } from '../ports/Technique.js';
+export declare class TechniqueRegistry {
+    private readonly map;
+    /**
+     * Register a layout engine.
+     * Returns `this` for fluent chaining at the composition root.
+     *
+     * @param key   stable engine identifier
+     * @param technique  the Technique implementation
+     * @throws if the key is already registered (prevents silent overwrites)
+     */
+    register(key: string, technique: Technique): this;
+    /**
+     * Look up a technique by engine key.
+     *
+     * @param key the engine identifier
+     * @throws if no technique is registered for that key
+     */
+    get(key: string): Technique;
+    /** Whether a key is registered. */
+    has(key: string): boolean;
+    /** All registered techniques in insertion order. */
+    techniques(): Technique[];
+    /** All registered engine keys in insertion order. */
+    keys(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/application/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/application/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgC;IAEpD;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAUjD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAW3B,mCAAmC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,oDAAoD;IACpD,UAAU,IAAI,SAAS,EAAE;IAIzB,qDAAqD;IACrD,IAAI,IAAI,MAAM,EAAE;CAGjB"}