@sgummalla-works/sketchon 0.1.0

package/dist/adapters/elk.js

@@ -0,0 +1,230 @@
+/**
+ * elkjs technique — the engine for GRAPH-shaped diagrams (flow, architecture,
+ * state, ER): cases where edges must be routed between freely-placed nodes, not
+ * stacked in a flexbox column. Satori owns the panel/concept family; ELK owns
+ * this one.
+ *
+ * Same thesis: the model declares a coordinate-free spec; ELK's layered layout
+ * computes every node coordinate AND routes every edge (with bend points). We
+ * never hand-place anything. Because ELK returns real coordinates, this
+ * technique CAN report boxes + edge segments back to the geometry eval — so its
+ * overlap/off-canvas/crossing scores are genuinely measured, unlike Satori's.
+ *
+ * Groups are rendered as ELK hierarchy: a grouped node becomes a child of a
+ * container node, so ELK keeps cluster members together and we draw the group
+ * box behind them.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+import ELKConstructor from 'elkjs/lib/elk.bundled.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const ELK = ELKConstructor;
+import { CANVAS_PADDING, EDGE_LABEL_FONT_SIZE, NODE_LABEL_FONT_SIZE, NODE_MAX_WIDTH, NODE_MIN_HEIGHT, NODE_MIN_WIDTH, NODE_PADDING_X, NODE_PADDING_Y, NODE_SUBLABEL_FONT_SIZE, } from '../constants.js';
+import { esc, estimateTextWidth, palette, svgDocument, wrapText } from './svg.js';
+const LABEL_LINE_HEIGHT = 18; // px per wrapped label line
+const elk = new ELK();
+/** Map our Direction to ELK's. */
+function elkDirection(dir, kind) {
+    const d = dir ?? (kind === 'sequence' || kind === 'er' || kind === 'state' ? 'LR' : 'TB');
+    switch (d) {
+        case 'LR':
+            return 'RIGHT';
+        case 'RL':
+            return 'LEFT';
+        case 'BT':
+            return 'UP';
+        default:
+            return 'DOWN';
+    }
+}
+function clamp(v, lo, hi) {
+    return Math.max(lo, Math.min(hi, v));
+}
+/**
+ * Size a node box from its (wrapped) label + sublabel. Long labels wrap to
+ * NODE_MAX_WIDTH and the box grows TALLER to fit the lines, instead of letting
+ * a single line overflow. Diamonds get extra slack since their usable interior
+ * is smaller than their bounding box.
+ *
+ * @param node the node to size
+ * @returns box width/height, the wrapped lines, and the widest line's px width
+ */
+function sizeNode(node) {
+    const innerMax = NODE_MAX_WIDTH - NODE_PADDING_X * 2;
+    const lines = wrapText(node.label, innerMax, NODE_LABEL_FONT_SIZE);
+    const contentWidth = Math.max(...lines.map((l) => estimateTextWidth(l, NODE_LABEL_FONT_SIZE)));
+    const subW = node.sublabel ? estimateTextWidth(node.sublabel, NODE_SUBLABEL_FONT_SIZE) : 0;
+    const width = clamp(Math.max(contentWidth, subW) + NODE_PADDING_X * 2, NODE_MIN_WIDTH, NODE_MAX_WIDTH);
+    const labelBlock = lines.length * LABEL_LINE_HEIGHT;
+    const subBlock = node.sublabel ? NODE_SUBLABEL_FONT_SIZE + 4 : 0;
+    const height = Math.max(NODE_MIN_HEIGHT, labelBlock + subBlock + NODE_PADDING_Y * 2);
+    return { width, height, lines, contentWidth };
+}
+/** Build the ELK graph (with group hierarchy) from the spec. */
+function buildElkGraph(spec) {
+    const nodeById = new Map(spec.nodes.map((n) => [n.id, n]));
+    const groupOf = new Map();
+    for (const n of spec.nodes)
+        if (n.group)
+            groupOf.set(n.id, n.group);
+    const makeNode = (n) => {
+        const { width, height } = sizeNode(n);
+        return { id: n.id, width, height };
+    };
+    const children = [];
+    if (spec.groups?.length) {
+        const grouped = new Set();
+        for (const g of spec.groups) {
+            const members = g.members.filter((m) => nodeById.has(m));
+            members.forEach((m) => grouped.add(m));
+            children.push({
+                id: `group:${g.id}`,
+                layoutOptions: { 'elk.padding': '[top=28,left=16,bottom=16,right=16]' },
+                labels: g.label ? [{ text: g.label, width: estimateTextWidth(g.label, 12), height: 16 }] : [],
+                children: members.map((m) => makeNode(nodeById.get(m))),
+            });
+        }
+        // Ungrouped nodes sit at the top level alongside the group containers.
+        for (const n of spec.nodes)
+            if (!grouped.has(n.id))
+                children.push(makeNode(n));
+    }
+    else {
+        for (const n of spec.nodes)
+            children.push(makeNode(n));
+    }
+    const edges = spec.edges.map((e, i) => ({
+        id: `e${i}`,
+        sources: [e.from],
+        targets: [e.to],
+        labels: e.label
+            ? [{ text: e.label, width: estimateTextWidth(e.label, EDGE_LABEL_FONT_SIZE), height: 14 }]
+            : [],
+    }));
+    return {
+        id: 'root',
+        layoutOptions: {
+            'elk.algorithm': 'layered',
+            'elk.direction': elkDirection(spec.direction, spec.kind),
+            'elk.spacing.nodeNode': '36',
+            'elk.layered.spacing.nodeNodeBetweenLayers': '64',
+            'elk.spacing.edgeNode': '20',
+            'elk.layered.spacing.edgeNodeBetweenLayers': '20',
+            'elk.edgeRouting': 'ORTHOGONAL',
+            'elk.hierarchyHandling': 'INCLUDE_CHILDREN',
+        },
+        children,
+        edges,
+    };
+}
+/** Recursively collect absolute-positioned boxes (ELK child coords are parent-relative). */
+function collectBoxes(node, offsetX, offsetY, spec, boxes, svg) {
+    for (const child of node.children ?? []) {
+        const ax = offsetX + (child.x ?? 0);
+        const ay = offsetY + (child.y ?? 0);
+        if (child.id.startsWith('group:')) {
+            // Group container box behind its members.
+            const gId = child.id.slice('group:'.length);
+            const g = spec.groups?.find((gr) => gr.id === gId);
+            const p = palette(g?.emphasis ?? 'muted');
+            svg.push(`<rect x="${ax.toFixed(1)}" y="${ay.toFixed(1)}" width="${(child.width ?? 0).toFixed(1)}" height="${(child.height ?? 0).toFixed(1)}" rx="10" fill="${p.fill}" fill-opacity="0.35" stroke="${p.stroke}" stroke-width="1.5" stroke-dasharray="5 4"/>`);
+            if (child.labels?.[0]) {
+                svg.push(`<text x="${(ax + 12).toFixed(1)}" y="${(ay + 18).toFixed(1)}" font-size="12" font-weight="600" fill="${p.text}">${esc(child.labels[0].text)}</text>`);
+            }
+            boxes.push({ id: child.id, x: ax, y: ay, w: child.width ?? 0, h: child.height ?? 0, label: '', fontSize: 12, role: 'group' });
+            collectBoxes(child, ax, ay, spec, boxes, svg);
+        }
+        else {
+            const node2 = spec.nodes.find((n) => n.id === child.id);
+            const p = palette(node2.emphasis);
+            const w = child.width ?? 0;
+            const h = child.height ?? 0;
+            const isDiamond = node2.shape === 'diamond';
+            const isRound = node2.shape === 'pill' || node2.shape === 'rounded' || node2.shape === 'circle';
+            const cx = ax + w / 2;
+            if (isDiamond) {
+                svg.push(`<polygon points="${cx.toFixed(1)},${ay.toFixed(1)} ${(ax + w).toFixed(1)},${(ay + h / 2).toFixed(1)} ${cx.toFixed(1)},${(ay + h).toFixed(1)} ${ax.toFixed(1)},${(ay + h / 2).toFixed(1)}" fill="${p.fill}" stroke="${p.stroke}" stroke-width="1.5"/>`);
+            }
+            else {
+                svg.push(`<rect x="${ax.toFixed(1)}" y="${ay.toFixed(1)}" width="${w.toFixed(1)}" height="${h.toFixed(1)}" rx="${isRound ? 14 : 4}" fill="${p.fill}" stroke="${p.stroke}" stroke-width="1.5"/>`);
+            }
+            // Re-wrap to the box's actual inner width so multi-line labels fit.
+            const lines = wrapText(node2.label, w - NODE_PADDING_X * 2, NODE_LABEL_FONT_SIZE);
+            const contentWidth = Math.max(...lines.map((l) => estimateTextWidth(l, NODE_LABEL_FONT_SIZE)));
+            const subBlock = node2.sublabel ? NODE_SUBLABEL_FONT_SIZE + 4 : 0;
+            const labelBlock = lines.length * LABEL_LINE_HEIGHT;
+            // Vertically center the (label block + sublabel) within the box.
+            const blockTop = ay + (h - labelBlock - subBlock) / 2;
+            const tspans = lines
+                .map((ln, i) => `<tspan x="${cx.toFixed(1)}" y="${(blockTop + i * LABEL_LINE_HEIGHT + LABEL_LINE_HEIGHT / 2).toFixed(1)}">${esc(ln)}</tspan>`)
+                .join('');
+            svg.push(`<text font-size="${NODE_LABEL_FONT_SIZE}" fill="${p.text}" text-anchor="middle" dominant-baseline="middle" font-weight="500">${tspans}</text>`);
+            if (node2.sublabel) {
+                svg.push(`<text x="${cx.toFixed(1)}" y="${(blockTop + labelBlock + subBlock / 2).toFixed(1)}" font-size="${NODE_SUBLABEL_FONT_SIZE}" fill="${p.text}" text-anchor="middle" dominant-baseline="middle" opacity="0.75">${esc(node2.sublabel)}</text>`);
+            }
+            boxes.push({ id: child.id, x: ax, y: ay, w, h, label: node2.label, fontSize: NODE_LABEL_FONT_SIZE, contentWidth, role: 'node' });
+        }
+    }
+}
+export const elkTechnique = {
+    key: 'elk',
+    name: 'elkjs (layered graph)',
+    blurb: 'ELK computes node coords + routes edges (orthogonal). Engine for flow/architecture/state/ER graphs.',
+    async render(spec) {
+        const graph = buildElkGraph(spec);
+        const laid = (await elk.layout(graph));
+        const boxes = [];
+        const nodeSvg = [];
+        collectBoxes(laid, CANVAS_PADDING, CANVAS_PADDING, spec, boxes, nodeSvg);
+        // Edges (top-level; ELK routes them with absolute coords at root level).
+        const placedEdges = [];
+        const edgeSvg = [];
+        const byId = new Map((laid.edges ?? []).map((e) => [e.id, e]));
+        spec.edges.forEach((e, i) => {
+            const le = byId.get(`e${i}`);
+            const sec = le?.sections?.[0];
+            if (!sec)
+                return;
+            const ox = CANVAS_PADDING;
+            const oy = CANVAS_PADDING;
+            const pts = [sec.startPoint, ...(sec.bendPoints ?? []), sec.endPoint].map((p) => ({
+                x: p.x + ox,
+                y: p.y + oy,
+            }));
+            const dash = e.style === 'dashed' ? ' stroke-dasharray="6 4"' : e.style === 'dotted' ? ' stroke-dasharray="2 4"' : '';
+            const d = pts.map((p, idx) => `${idx === 0 ? 'M' : 'L'}${p.x.toFixed(1)},${p.y.toFixed(1)}`).join(' ');
+            const marker = e.arrow === 'none' ? '' : ' marker-end="url(#arrow-filled)"';
+            edgeSvg.push(`<path d="${d}" fill="none" stroke="#64748b" stroke-width="1.5"${dash}${marker}/>`);
+            // Record the last segment for crossing detection.
+            const a = pts[pts.length - 2] ?? pts[0];
+            const b = pts[pts.length - 1];
+            placedEdges.push({ x1: a.x, y1: a.y, x2: b.x, y2: b.y, fromId: e.from, toId: e.to });
+            if (e.label && le?.labels?.[0]) {
+                const mid = pts[Math.floor(pts.length / 2)];
+                edgeSvg.push(`<text x="${mid.x.toFixed(1)}" y="${(mid.y - 4).toFixed(1)}" font-size="${EDGE_LABEL_FONT_SIZE}" fill="#475569" text-anchor="middle">${esc(e.label)}</text>`);
+            }
+        });
+        const width = Math.ceil((laid.width ?? 0) + CANVAS_PADDING * 2);
+        const height = Math.ceil((laid.height ?? 0) + CANVAS_PADDING * 2);
+        const title = spec.title
+            ? `<text x="${CANVAS_PADDING}" y="24" font-size="16" font-weight="600" fill="#0f172a">${esc(spec.title)}</text>`
+            : '';
+        const body = [title, ...edgeSvg, ...nodeSvg].join('\n');
+        const svg = svgDocument(width, height, body);
+        return {
+            svg,
+            width,
+            height,
+            boxes,
+            edges: placedEdges,
+            features: {
+                // ELK draws plain graph nodes — not the rich panel features.
+                cards: false,
+                checkpoints: false,
+                twoColumn: false,
+                legend: false,
+                categoryColors: false,
+            },
+        };
+    },
+};
+//# sourceMappingURL=elk.js.map

package/dist/adapters/elk.js.map

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

package/dist/adapters/emoji.d.ts

@@ -0,0 +1,10 @@
+/** Twemoji asset code for an emoji grapheme (FE0F stripped unless ZWJ-joined). */
+export declare function emojiCode(emoji: string): string;
+/**
+ * Resolve an emoji to a base64 SVG data-URI for Satori, via disk + memory cache.
+ *
+ * @param emoji a single emoji grapheme
+ * @returns a data-URI for the Twemoji SVG, or a transparent pixel if unresolved
+ */
+export declare function emojiToDataUri(emoji: string): Promise<string>;
+//# sourceMappingURL=emoji.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emoji.d.ts","sourceRoot":"","sources":["../../src/adapters/emoji.ts"],"names":[],"mappings":"AA6CA,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAID;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BnE"}

package/dist/adapters/emoji.js

@@ -0,0 +1,80 @@
+/**
+ * Emoji rendering for Satori. Satori has no emoji font, so it calls
+ * `loadAdditionalAsset('emoji', segment)` for each emoji grapheme and expects an
+ * image data-URI back. We map the emoji to a Twemoji SVG (jdecked's maintained
+ * fork), cache it to `assets/emoji/` so the lab runs offline after the first
+ * fetch, and return it base64-encoded.
+ *
+ * Codepoint derivation follows Twemoji's own filename rule: strip the FE0F
+ * variation selector UNLESS the sequence is a ZWJ join — otherwise the asset
+ * name won't match (e.g. ⚙️ U+2699 U+FE0F → "2699.svg").
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const EMOJI_DIR = resolve(__dirname, '../../assets/emoji');
+const TWEMOJI_BASE = 'https://cdn.jsdelivr.net/gh/jdecked/twemoji@latest/assets/svg';
+const U200D = String.fromCharCode(0x200d); // zero-width joiner
+const UFE0F = /️/g; // variation selector-16
+/** A 1×1 transparent SVG, returned when an emoji can't be resolved (offline / 404). */
+const TRANSPARENT = `data:image/svg+xml;base64,${Buffer.from('<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"/>').toString('base64')}`;
+/** Convert a (possibly surrogate-pair) string to dash-joined hex codepoints. */
+function toCodePoint(s) {
+    const out = [];
+    let prev = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (prev) {
+            out.push((0x10000 + ((prev - 0xd800) << 10) + (c - 0xdc00)).toString(16));
+            prev = 0;
+        }
+        else if (c >= 0xd800 && c <= 0xdbff) {
+            prev = c;
+        }
+        else {
+            out.push(c.toString(16));
+        }
+    }
+    return out.join('-');
+}
+/** Twemoji asset code for an emoji grapheme (FE0F stripped unless ZWJ-joined). */
+export function emojiCode(emoji) {
+    const grapheme = emoji.indexOf(U200D) < 0 ? emoji.replace(UFE0F, '') : emoji;
+    return toCodePoint(grapheme);
+}
+const memCache = new Map(); // code -> data URI
+/**
+ * Resolve an emoji to a base64 SVG data-URI for Satori, via disk + memory cache.
+ *
+ * @param emoji a single emoji grapheme
+ * @returns a data-URI for the Twemoji SVG, or a transparent pixel if unresolved
+ */
+export async function emojiToDataUri(emoji) {
+    const code = emojiCode(emoji);
+    const cached = memCache.get(code);
+    if (cached)
+        return cached;
+    mkdirSync(EMOJI_DIR, { recursive: true });
+    const file = resolve(EMOJI_DIR, `${code}.svg`);
+    let svg;
+    if (existsSync(file)) {
+        svg = readFileSync(file, 'utf8');
+    }
+    else {
+        try {
+            const res = await fetch(`${TWEMOJI_BASE}/${code}.svg`);
+            if (res.ok) {
+                svg = await res.text();
+                writeFileSync(file, svg, 'utf8');
+            }
+        }
+        catch {
+            // offline or fetch error — fall through to the transparent placeholder
+        }
+    }
+    const uri = svg ? `data:image/svg+xml;base64,${Buffer.from(svg).toString('base64')}` : TRANSPARENT;
+    memCache.set(code, uri);
+    return uri;
+}
+//# sourceMappingURL=emoji.js.map

package/dist/adapters/emoji.js.map

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

package/dist/adapters/fonts.d.ts

@@ -0,0 +1,13 @@
+export interface SatoriFont {
+    name: string;
+    data: Buffer;
+    weight: 400 | 600 | 700;
+    style: 'normal';
+}
+/**
+ * Load the Inter font set (regular / semibold / bold) for Satori.
+ *
+ * @returns the font descriptors Satori expects in its `fonts` option
+ */
+export declare function loadFonts(): SatoriFont[];
+//# sourceMappingURL=fonts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/adapters/fonts.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACxB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,UAAU,EAAE,CAQxC"}

package/dist/adapters/fonts.js

@@ -0,0 +1,27 @@
+/**
+ * Font loading for Satori. Satori needs at least one font buffer (it has no
+ * system font access). We bundle Inter TTFs (OFL-licensed) under assets/ so the
+ * lab is self-contained and runs offline after clone. Loaded once and cached.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ASSETS = resolve(__dirname, '../../assets');
+let cached = null;
+/**
+ * Load the Inter font set (regular / semibold / bold) for Satori.
+ *
+ * @returns the font descriptors Satori expects in its `fonts` option
+ */
+export function loadFonts() {
+    if (cached)
+        return cached;
+    cached = [
+        { name: 'Inter', data: readFileSync(resolve(ASSETS, 'inter-400.ttf')), weight: 400, style: 'normal' },
+        { name: 'Inter', data: readFileSync(resolve(ASSETS, 'inter-600.ttf')), weight: 600, style: 'normal' },
+        { name: 'Inter', data: readFileSync(resolve(ASSETS, 'inter-700.ttf')), weight: 700, style: 'normal' },
+    ];
+    return cached;
+}
+//# sourceMappingURL=fonts.js.map

package/dist/adapters/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../src/adapters/fonts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AASlD,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG;QACP,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE;QACrG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE;QACrG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE;KACtG,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/adapters/satori-helpers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Helpers for building Satori element trees + the card colour palette.
+ *
+ * Two things live here so the technique file stays about LAYOUT, not plumbing:
+ *  - `el()` — a tiny factory for the React-element-shaped objects Satori reads
+ *    (we avoid JSX to skip the react/jsx toolchain; Satori only needs
+ *    `{ type, props }`).
+ *  - `CARD_PALETTE` / category resolution + `stripEmoji` + `monogram`.
+ *
+ * Why strip emoji: Satori throws when a glyph isn't in any supplied font, and
+ * Inter has no emoji. v1 renders a category-tinted monogram chip instead; real
+ * emoji (Twemoji via loadAdditionalAsset) is a tracked follow-up.
+ */
+import type { Emphasis } from '../domain/spec.js';
+/** Loose element type matching what Satori accepts as a node. */
+export interface SatoriEl {
+    type: string;
+    props: {
+        style?: Record<string, unknown>;
+        children?: unknown;
+    };
+}
+/**
+ * Build a Satori element.
+ *
+ * @param type HTML-ish tag (only `div` / `span` are needed)
+ * @param style flat CSS style object (Satori supports a flexbox subset)
+ * @param children child element(s) or text; nullish children are dropped
+ * @returns an element object Satori can render
+ */
+export declare function el(type: string, style: Record<string, unknown>, children?: unknown): SatoriEl;
+/**
+ * Saturated card palette: white text on a strong fill, matching the reference
+ * image's category colours. Distinct from the light `PALETTE` in svg.ts (used by
+ * the baseline's outlined boxes) — cards need bold fills.
+ */
+export declare const CARD_PALETTE: Record<Emphasis, string>;
+/** Gold checkpoint-pill colours (fill / border / text). */
+export declare const CHECKPOINT_COLORS: {
+    fill: string;
+    border: string;
+    text: string;
+};
+/** Strip emoji / pictographic glyphs so Satori never hits a missing-glyph throw. */
+export declare function stripEmoji(s: string): string;
+/** First letters of the first two words, for the monogram icon chip. */
+export declare function monogram(label: string): string;
+//# sourceMappingURL=satori-helpers.d.ts.map

package/dist/adapters/satori-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satori-helpers.d.ts","sourceRoot":"","sources":["../../src/adapters/satori-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAChE;AAED;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,CAAC,EAAE,OAAO,GACjB,QAAQ,CAKV;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAOjD,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB;;;;CAA0D,CAAC;AAEzF,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/dist/adapters/satori-helpers.js

@@ -0,0 +1,43 @@
+/**
+ * Build a Satori element.
+ *
+ * @param type HTML-ish tag (only `div` / `span` are needed)
+ * @param style flat CSS style object (Satori supports a flexbox subset)
+ * @param children child element(s) or text; nullish children are dropped
+ * @returns an element object Satori can render
+ */
+export function el(type, style, children) {
+    const kids = Array.isArray(children)
+        ? children.filter((c) => c !== null && c !== undefined && c !== false)
+        : children;
+    return { type, props: { style, children: kids } };
+}
+/**
+ * Saturated card palette: white text on a strong fill, matching the reference
+ * image's category colours. Distinct from the light `PALETTE` in svg.ts (used by
+ * the baseline's outlined boxes) — cards need bold fills.
+ */
+export const CARD_PALETTE = {
+    primary: '#1e4e79', // retrieval — blue
+    accent: '#4b3f9e', // reasoning — purple
+    danger: '#8a3a2c', // hitl — rust
+    success: '#3f6e26', // execution — green
+    normal: '#3b4250', // observability — slate
+    muted: '#64748b',
+};
+/** Gold checkpoint-pill colours (fill / border / text). */
+export const CHECKPOINT_COLORS = { fill: '#6b5212', border: '#b8923a', text: '#ffd98a' };
+/** Strip emoji / pictographic glyphs so Satori never hits a missing-glyph throw. */
+export function stripEmoji(s) {
+    return s.replace(/[\p{Extended_Pictographic}‍️⏸]/gu, '').trim();
+}
+/** First letters of the first two words, for the monogram icon chip. */
+export function monogram(label) {
+    const words = stripEmoji(label).split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return '?';
+    if (words.length === 1)
+        return words[0].slice(0, 1).toUpperCase();
+    return (words[0][0] + words[1][0]).toUpperCase();
+}
+//# sourceMappingURL=satori-helpers.js.map

package/dist/adapters/satori-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"satori-helpers.js","sourceRoot":"","sources":["../../src/adapters/satori-helpers.ts"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,MAAM,UAAU,EAAE,CAChB,IAAY,EACZ,KAA8B,EAC9B,QAAkB;IAElB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAClC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,CAAC;QACtE,CAAC,CAAC,QAAQ,CAAC;IACb,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAA6B;IACpD,OAAO,EAAE,SAAS,EAAE,mBAAmB;IACvC,MAAM,EAAE,SAAS,EAAE,qBAAqB;IACxC,MAAM,EAAE,SAAS,EAAE,cAAc;IACjC,OAAO,EAAE,SAAS,EAAE,oBAAoB;IACxC,MAAM,EAAE,SAAS,EAAE,wBAAwB;IAC3C,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAEzF,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACnD,CAAC"}

package/dist/adapters/satori.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"satori.d.ts","sourceRoot":"","sources":["../../src/adapters/satori.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAmRrE,eAAO,MAAM,eAAe,EAAE,SAkC7B,CAAC"}