@sgummalla-works/sketchon 0.1.0

package/dist/application/registry.js

@@ -0,0 +1,45 @@
+export class TechniqueRegistry {
+    map = new 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, technique) {
+        if (this.map.has(key)) {
+            throw new Error(`Technique "${key}" is already registered. Each engine key must be unique.`);
+        }
+        this.map.set(key, technique);
+        return this;
+    }
+    /**
+     * Look up a technique by engine key.
+     *
+     * @param key the engine identifier
+     * @throws if no technique is registered for that key
+     */
+    get(key) {
+        const t = this.map.get(key);
+        if (!t) {
+            throw new Error(`No technique registered for key "${key}". ` +
+                `Registered: ${[...this.map.keys()].join(', ')}`);
+        }
+        return t;
+    }
+    /** Whether a key is registered. */
+    has(key) {
+        return this.map.has(key);
+    }
+    /** All registered techniques in insertion order. */
+    techniques() {
+        return [...this.map.values()];
+    }
+    /** All registered engine keys in insertion order. */
+    keys() {
+        return [...this.map.keys()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/application/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/application/registry.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,iBAAiB;IACX,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEpD;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAW,EAAE,SAAoB;QACxC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,cAAc,GAAG,0DAA0D,CAC5E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CACb,oCAAoC,GAAG,KAAK;gBAC1C,eAAe,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnD,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,mCAAmC;IACnC,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,oDAAoD;IACpD,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,qDAAqD;IACrD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/application/router.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Router — application-layer routing logic.
+ *
+ * HEXAGONAL ARCHITECTURE INVARIANT:
+ *   This file MUST NEVER import from '../adapters/' or any concrete adapter.
+ *   It depends on TechniqueRegistry (application layer) and the domain types.
+ *   The routing table (KIND_ENGINE) is application policy, not adapter knowledge.
+ *
+ * The router takes a TechniqueRegistry via constructor injection.
+ * The registry is populated by the composition root (index.ts), which is the
+ * only place that is allowed to import concrete adapters.
+ */
+import type { DiagramSpec } from '../domain/spec.js';
+import type { Technique, RenderResult } from '../ports/Technique.js';
+import type { TechniqueRegistry } from './registry.js';
+/**
+ * Valid engine keys — extend this union when registering a new engine.
+ * Lives here because routing policy (which kind maps to which engine)
+ * is an application concern, not a domain or adapter concern.
+ */
+export type EngineKey = 'baseline' | 'elk' | 'satori' | 'sequence';
+/**
+ * The Router orchestrates rendering by resolving the right engine from the
+ * registry based on the spec's kind (or an explicit override).
+ *
+ * Constructed with a TechniqueRegistry injected from the composition root.
+ * Has no knowledge of which concrete adapters exist.
+ */
+export declare class Router {
+    private readonly registry;
+    constructor(registry: TechniqueRegistry);
+    /**
+     * Select the engine key for a spec.
+     * An explicit `spec.renderer` override takes priority over the kind default.
+     *
+     * @param spec the diagram spec
+     * @returns the resolved engine key
+     */
+    selectEngineKey(spec: DiagramSpec): EngineKey;
+    /**
+     * Resolve the Technique that will render a spec.
+     *
+     * @param spec the diagram spec
+     * @returns the chosen Technique implementation
+     */
+    selectEngine(spec: DiagramSpec): Technique;
+    /**
+     * Render a spec with the routed engine.
+     * This is the primary use case entry point — what consumers call.
+     *
+     * @param spec the validated, coordinate-free diagram spec
+     * @returns the rendered SVG + metadata
+     */
+    renderDiagram(spec: DiagramSpec): RenderResult | Promise<RenderResult>;
+}
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/application/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;AAgBnE;;;;;;GAMG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,iBAAiB;IAExD;;;;;;OAMG;IACH,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS;IAO7C;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS;IAI1C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAGvE"}

package/dist/application/router.js

@@ -0,0 +1,59 @@
+/**
+ * The authoritative kind → engine mapping.
+ * One entry per DiagramKind — adding a new kind means adding one line here.
+ */
+const KIND_ENGINE = {
+    concept: 'satori',
+    mindmap: 'satori',
+    sequence: 'sequence',
+    flow: 'elk',
+    architecture: 'elk',
+    state: 'elk',
+    er: 'elk',
+};
+/**
+ * The Router orchestrates rendering by resolving the right engine from the
+ * registry based on the spec's kind (or an explicit override).
+ *
+ * Constructed with a TechniqueRegistry injected from the composition root.
+ * Has no knowledge of which concrete adapters exist.
+ */
+export class Router {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Select the engine key for a spec.
+     * An explicit `spec.renderer` override takes priority over the kind default.
+     *
+     * @param spec the diagram spec
+     * @returns the resolved engine key
+     */
+    selectEngineKey(spec) {
+        if (spec.renderer && this.registry.has(spec.renderer)) {
+            return spec.renderer;
+        }
+        return KIND_ENGINE[spec.kind] ?? 'elk';
+    }
+    /**
+     * Resolve the Technique that will render a spec.
+     *
+     * @param spec the diagram spec
+     * @returns the chosen Technique implementation
+     */
+    selectEngine(spec) {
+        return this.registry.get(this.selectEngineKey(spec));
+    }
+    /**
+     * Render a spec with the routed engine.
+     * This is the primary use case entry point — what consumers call.
+     *
+     * @param spec the validated, coordinate-free diagram spec
+     * @returns the rendered SVG + metadata
+     */
+    renderDiagram(spec) {
+        return this.selectEngine(spec).render(spec);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/application/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/application/router.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,WAAW,GAAmC;IAClD,OAAO,EAAO,QAAQ;IACtB,OAAO,EAAO,QAAQ;IACtB,QAAQ,EAAM,UAAU;IACxB,IAAI,EAAU,KAAK;IACnB,YAAY,EAAE,KAAK;IACnB,KAAK,EAAS,KAAK;IACnB,EAAE,EAAY,KAAK;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IACY;IAA7B,YAA6B,QAA2B;QAA3B,aAAQ,GAAR,QAAQ,CAAmB;IAAG,CAAC;IAE5D;;;;;;OAMG;IACH,eAAe,CAAC,IAAiB;QAC/B,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC,QAAqB,CAAC;QACpC,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,IAAiB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,IAAiB;QAC7B,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tunable constants for the diagram lab. Kept out of logic files so a
+ * technique or metric never inlines a magic number — change layout/eval
+ * behaviour here, in one place.
+ */
+export declare const AVG_CHAR_WIDTH_EM = 0.58;
+export declare const DEFAULT_FONT_SIZE = 14;
+export declare const NODE_LABEL_FONT_SIZE = 14;
+export declare const NODE_SUBLABEL_FONT_SIZE = 11;
+export declare const EDGE_LABEL_FONT_SIZE = 12;
+export declare const NODE_PADDING_X = 16;
+export declare const NODE_PADDING_Y = 12;
+export declare const NODE_MIN_WIDTH = 72;
+export declare const NODE_MIN_HEIGHT = 40;
+export declare const NODE_MAX_WIDTH = 240;
+export declare const LAYER_GAP = 90;
+export declare const NODE_GAP = 36;
+export declare const CANVAS_PADDING = 40;
+export declare const SCORE_START = 100;
+export declare const PENALTY_PER_OVERLAP_PAIR = 12;
+export declare const PENALTY_PER_OFFCANVAS_BOX = 10;
+export declare const PENALTY_PER_TEXT_OVERFLOW = 8;
+export declare const PENALTY_PER_EDGE_CROSSING = 3;
+export declare const TEXT_OVERFLOW_TOLERANCE_PX = 2;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,cAAc,MAAM,CAAC;AAGlC,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,cAAc,KAAK,CAAC;AAKjC,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,0BAA0B,IAAI,CAAC"}

package/dist/constants.js

@@ -0,0 +1,35 @@
+/**
+ * Tunable constants for the diagram lab. Kept out of logic files so a
+ * technique or metric never inlines a magic number — change layout/eval
+ * behaviour here, in one place.
+ */
+// ── Text measurement ────────────────────────────────────────────────────────
+// We have no real font metrics in the baseline (no browser, no Satori yet),
+// so width is estimated as `chars * AVG_CHAR_WIDTH_EM * fontSize`. ~0.58em is a
+// reasonable mean advance width for a humanist sans at typical sizes. Real
+// engines (Satori/resvg) will replace this estimate with true glyph metrics.
+export const AVG_CHAR_WIDTH_EM = 0.58;
+export const DEFAULT_FONT_SIZE = 14;
+export const NODE_LABEL_FONT_SIZE = 14;
+export const NODE_SUBLABEL_FONT_SIZE = 11;
+export const EDGE_LABEL_FONT_SIZE = 12;
+// ── Node sizing ─────────────────────────────────────────────────────────────
+export const NODE_PADDING_X = 16;
+export const NODE_PADDING_Y = 12;
+export const NODE_MIN_WIDTH = 72;
+export const NODE_MIN_HEIGHT = 40;
+export const NODE_MAX_WIDTH = 240;
+// ── Layout spacing (baseline layered layout) ────────────────────────────────
+export const LAYER_GAP = 90; // gap between layers (rank direction)
+export const NODE_GAP = 36; // gap between siblings within a layer
+export const CANVAS_PADDING = 40; // margin around the whole drawing
+// ── Eval thresholds + scoring weights ───────────────────────────────────────
+// Composite score starts at 100; each problem subtracts its weight (clamped
+// at 0). Weights encode "how bad is this for a reader."
+export const SCORE_START = 100;
+export const PENALTY_PER_OVERLAP_PAIR = 12; // boxes physically overlapping
+export const PENALTY_PER_OFFCANVAS_BOX = 10; // box outside the viewBox
+export const PENALTY_PER_TEXT_OVERFLOW = 8; // label wider than its box
+export const PENALTY_PER_EDGE_CROSSING = 3; // two edges crossing
+export const TEXT_OVERFLOW_TOLERANCE_PX = 2; // ignore sub-pixel rounding
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,4EAA4E;AAC5E,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC,sCAAsC;AACnE,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC,sCAAsC;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,kCAAkC;AAEpE,+EAA+E;AAC/E,4EAA4E;AAC5E,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC,CAAC,+BAA+B;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC,CAAC,0BAA0B;AACvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,CAAC,2BAA2B;AACvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,CAAC,qBAAqB;AACjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,CAAC,4BAA4B"}

package/dist/domain/spec.d.ts

@@ -0,0 +1,163 @@
+/**
+ * The DiagramSpec — a SEMANTIC, coordinate-free description of a diagram.
+ *
+ * This is the central contract of the lab and the thing that eventually ports
+ * into pragna2. The whole premise of #36 is: the model (or a hand-authored
+ * fixture) emits ONLY structure — what relates to what, how it's grouped, what
+ * to emphasise — and a deterministic layout engine computes every pixel. So
+ * there are deliberately NO x/y/width coordinates anywhere in this file. If a
+ * coordinate ever appears in a spec, the design has leaked the broken part
+ * (model-does-trig) back in.
+ *
+ * One schema spans ALL diagram kinds (flow, sequence, architecture, ER, state,
+ * and free-form concept/illustrative). A technique reads the same spec and
+ * lays it out however suits its engine.
+ */
+/** What family of diagram this is. Drives default layout strategy + shapes. */
+export type DiagramKind = 'flow' | 'sequence' | 'architecture' | 'er' | 'state' | 'mindmap' | 'concept';
+/** Preferred primary flow direction. Engines may honour or override. */
+export type Direction = 'TB' | 'BT' | 'LR' | 'RL';
+/** Visual shape of a node. Semantic, not pixel-level. */
+export type NodeShape = 'box' | 'rounded' | 'pill' | 'circle' | 'diamond' | 'cylinder' | 'actor' | 'note' | 'icon' | 'card' | 'checkpoint';
+/**
+ * Visual weight. Lets the author say "this is the important one" without
+ * choosing colours — the renderer maps emphasis → theme tokens.
+ */
+export type Emphasis = 'normal' | 'primary' | 'muted' | 'danger' | 'success' | 'accent';
+/** Line treatment for an edge. */
+export type EdgeStyle = 'solid' | 'dashed' | 'dotted';
+/** Arrowhead treatment. */
+export type ArrowKind = 'none' | 'open' | 'filled';
+/**
+ * Semantic edge category. The renderer can style each consistently
+ * (e.g. dataflow vs dependency vs sequence-message) without per-edge styling
+ * from the author.
+ */
+export type EdgeSemantic = 'default' | 'dependency' | 'dataflow' | 'message' | 'return' | 'association';
+export interface DiagramNode {
+    /** Stable id, referenced by edges, groups, annotations. */
+    id: string;
+    /** Primary visible text. */
+    label: string;
+    /**
+     * Optional second line (role, type, short qualifier). For `card` shapes this
+     * is the tinted sub-line; render as `·`-joined when given as `sublabelParts`.
+     */
+    sublabel?: string;
+    /**
+     * Structured sub-line tokens for rich cards, rendered `·`-separated
+     * (e.g. ["Vector DB", "semantic search", "doc chunking"]). Preferred over
+     * `sublabel` for `card` shapes; the renderer joins them.
+     */
+    sublabelParts?: string[];
+    shape?: NodeShape;
+    emphasis?: Emphasis;
+    /**
+     * Optional leading glyph. May be a literal emoji (e.g. "🔍") for concept/card
+     * diagrams, or a semantic icon name the renderer maps. Never a URL.
+     */
+    icon?: string;
+    /** Id of the group this node belongs to, if any. */
+    group?: string;
+    /**
+     * Id of the colour `category` this node belongs to (legend-style colouring).
+     * Independent of `emphasis`: category drives the colour family + legend,
+     * emphasis is a per-node weight. When both are set, category wins for fill.
+     */
+    category?: string;
+}
+export interface DiagramEdge {
+    /** Source node id. */
+    from: string;
+    /** Target node id. */
+    to: string;
+    /** Optional edge text (condition, message, cardinality). */
+    label?: string;
+    style?: EdgeStyle;
+    arrow?: ArrowKind;
+    semantic?: EdgeSemantic;
+}
+/**
+ * A visual grouping / container (a subsystem boundary, a swimlane, a cluster).
+ * Members are node ids. Groups may nest via `parent`.
+ */
+export interface DiagramGroup {
+    id: string;
+    label?: string;
+    members: string[];
+    emphasis?: Emphasis;
+    /** Optional parent group id for nested containers. */
+    parent?: string;
+}
+/** Where an annotation sits relative to its target. */
+export type AnnotationPlacement = 'top' | 'bottom' | 'left' | 'right' | 'callout';
+/**
+ * Free-floating explanatory text, optionally tied to a node/group. Central to
+ * the illustrative/concept kind ("build intuition" labels pointing at parts).
+ */
+export interface DiagramAnnotation {
+    text: string;
+    /** Node or group id this annotation points at, if any. */
+    target?: string;
+    placement?: AnnotationPlacement;
+}
+/** Optional hints; renderer supplies defaults for anything omitted. */
+export interface ThemeHints {
+    /** 'light' | 'dark' — renderer picks token set. */
+    mode?: 'light' | 'dark';
+    /** Rough density preference. */
+    density?: 'compact' | 'comfortable';
+}
+/**
+ * A named category for legend-style colour coding (e.g. "retrieval",
+ * "execution"). Added after the 2026-05-31 reference image, which colours nodes
+ * by CATEGORY (retrieval=blue, reasoning=purple, …) and renders a legend — a
+ * different axis from per-node semantic `emphasis`. A node points at a category
+ * via `DiagramNode.category`; the renderer maps category → colour and draws the
+ * legend from the categories actually used.
+ */
+export interface DiagramCategory {
+    /** Stable id referenced by `DiagramNode.category`. */
+    id: string;
+    /** Legend label, e.g. "Retrieval / grounding". */
+    label: string;
+    /** Colour intent; renderer maps to a concrete token. */
+    emphasis?: Emphasis;
+}
+/**
+ * Column headers for the annotated two-column "concept" layout (the reference
+ * image's "Tool layer" / "Why it's mandatory"). Only meaningful when nodes
+ * carry right-placed annotations rendered as a paired second column.
+ */
+export interface ColumnHeaders {
+    /** Heading over the node column. */
+    primary: string;
+    /** Heading over the annotation column. */
+    annotation: string;
+}
+export interface DiagramSpec {
+    /** Stable id for the spec (used in filenames / preview). */
+    id: string;
+    /** Optional diagram title rendered as a heading. */
+    title?: string;
+    kind: DiagramKind;
+    /** Preferred direction for directed kinds. Default per-kind in the renderer. */
+    direction?: Direction;
+    nodes: DiagramNode[];
+    edges: DiagramEdge[];
+    groups?: DiagramGroup[];
+    annotations?: DiagramAnnotation[];
+    /** Legend-style colour categories referenced by `DiagramNode.category`. */
+    categories?: DiagramCategory[];
+    /** Column headers for the annotated two-column concept layout. */
+    columns?: ColumnHeaders;
+    /**
+     * Optional engine override. Normally omitted — the renderer auto-routes by
+     * `kind` (panel/concept → Satori, graph kinds → elkjs). Set only for the rare
+     * case where the kind's default engine is the wrong fit. The model should not
+     * set this routinely; declaring the right `kind` is the intended path.
+     */
+    renderer?: 'satori' | 'elk' | 'sequence';
+    theme?: ThemeHints;
+}
+//# sourceMappingURL=spec.d.ts.map

package/dist/domain/spec.d.ts.map

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

package/dist/domain/spec.js

@@ -0,0 +1,17 @@
+/**
+ * The DiagramSpec — a SEMANTIC, coordinate-free description of a diagram.
+ *
+ * This is the central contract of the lab and the thing that eventually ports
+ * into pragna2. The whole premise of #36 is: the model (or a hand-authored
+ * fixture) emits ONLY structure — what relates to what, how it's grouped, what
+ * to emphasise — and a deterministic layout engine computes every pixel. So
+ * there are deliberately NO x/y/width coordinates anywhere in this file. If a
+ * coordinate ever appears in a spec, the design has leaked the broken part
+ * (model-does-trig) back in.
+ *
+ * One schema spans ALL diagram kinds (flow, sequence, architecture, ER, state,
+ * and free-form concept/illustrative). A technique reads the same spec and
+ * lays it out however suits its engine.
+ */
+export {};
+//# sourceMappingURL=spec.js.map

package/dist/domain/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/domain/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/domain/theme.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Colour tokens for the diagram renderer.
+ *
+ * Single source of truth for every colour value used across all rendering
+ * adapters. No hex string should appear in any adapter file — use these named
+ * constants instead so the visual language is tunable from one place.
+ *
+ * Tokens are grouped by concern. All values are hex strings or rgba() strings
+ * that SVG and Satori both accept.
+ */
+export declare const COLOR_TEXT_PRIMARY = "#0f172a";
+export declare const COLOR_TEXT_BODY = "#475569";
+export declare const COLOR_TEXT_MUTED = "#64748b";
+export declare const COLOR_TEXT_WHITE = "#ffffff";
+export declare const COLOR_BORDER_LIGHT = "#e2e8f0";
+export declare const COLOR_BORDER_DEFAULT = "#cbd5e1";
+export declare const COLOR_EDGE_DEFAULT = "#64748b";
+export declare const COLOR_EDGE_DASHED = "#94a3b8";
+export declare const PALETTE_NORMAL: {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+export declare const PALETTE_PRIMARY: {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+export declare const PALETTE_ACCENT: {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+export declare const PALETTE_MUTED: {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+export declare const PALETTE_DANGER: {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+export declare const PALETTE_SUCCESS: {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+export declare const DARK_PRIMARY = "#1e3a5f";
+export declare const DARK_ACCENT = "#3730a3";
+export declare const DARK_SUCCESS = "#14532d";
+export declare const DARK_DANGER = "#7f1d1d";
+export declare const DARK_NORMAL = "#334155";
+export declare const DARK_MUTED = "#475569";
+export declare const ACTOR_CYCLE_FILLS: readonly ["#1e3a5f", "#14532d", "#3730a3", "#7c2d12", "#134e4a", "#4c1d95"];
+export declare const CARD_PALETTE_PRIMARY = "#1e4e79";
+export declare const CARD_PALETTE_ACCENT = "#4b3f9e";
+export declare const CARD_PALETTE_DANGER = "#8a3a2c";
+export declare const CARD_PALETTE_SUCCESS = "#3f6e26";
+export declare const CARD_PALETTE_NORMAL = "#3b4250";
+export declare const CARD_PALETTE_MUTED = "#64748b";
+export declare const CHECKPOINT_FILL = "#6b5212";
+export declare const CHECKPOINT_BORDER = "#b8923a";
+export declare const CHECKPOINT_TEXT = "#ffd98a";
+export declare const CONNECTOR_COLOR = "#cbd5e1";
+export declare const ARROW_FILL = "#475569";
+export declare const ARROW_STROKE = "#475569";
+//# sourceMappingURL=theme.d.ts.map

package/dist/domain/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/domain/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,eAAO,MAAM,kBAAkB,YAAe,CAAC;AAC/C,eAAO,MAAM,eAAe,YAAkB,CAAC;AAC/C,eAAO,MAAM,gBAAgB,YAAiB,CAAC;AAC/C,eAAO,MAAM,gBAAgB,YAAiB,CAAC;AAE/C,eAAO,MAAM,kBAAkB,YAAe,CAAC;AAC/C,eAAO,MAAM,oBAAoB,YAAa,CAAC;AAC/C,eAAO,MAAM,kBAAkB,YAAe,CAAC;AAC/C,eAAO,MAAM,iBAAiB,YAAgB,CAAC;AAI/C,eAAO,MAAM,cAAc;;;;CAAoE,CAAC;AAChG,eAAO,MAAM,eAAe;;;;CAA0D,CAAC;AACvF,eAAO,MAAM,cAAc;;;;CAA2D,CAAC;AACvF,eAAO,MAAM,aAAa;;;;CAA4D,CAAC;AACvF,eAAO,MAAM,cAAc;;;;CAA2D,CAAC;AACvF,eAAO,MAAM,eAAe;;;;CAA0D,CAAC;AAGvF,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,WAAW,YAAa,CAAC;AACtC,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,WAAW,YAAa,CAAC;AACtC,eAAO,MAAM,WAAW,YAAa,CAAC;AACtC,eAAO,MAAM,UAAU,YAAc,CAAC;AAGtC,eAAO,MAAM,iBAAiB,6EAOpB,CAAC;AAGX,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,mBAAmB,YAAa,CAAC;AAC9C,eAAO,MAAM,mBAAmB,YAAa,CAAC;AAC9C,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,mBAAmB,YAAa,CAAC;AAC9C,eAAO,MAAM,kBAAkB,YAAc,CAAC;AAG9C,eAAO,MAAM,eAAe,YAAc,CAAC;AAC3C,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,eAAe,YAAc,CAAC;AAG3C,eAAO,MAAM,eAAe,YAAY,CAAC;AAGzC,eAAO,MAAM,UAAU,YAAc,CAAC;AACtC,eAAO,MAAM,YAAY,YAAY,CAAC"}

package/dist/domain/theme.js

@@ -0,0 +1,60 @@
+/**
+ * Colour tokens for the diagram renderer.
+ *
+ * Single source of truth for every colour value used across all rendering
+ * adapters. No hex string should appear in any adapter file — use these named
+ * constants instead so the visual language is tunable from one place.
+ *
+ * Tokens are grouped by concern. All values are hex strings or rgba() strings
+ * that SVG and Satori both accept.
+ */
+// ── Structural / neutral ──────────────────────────────────────────────────────
+export const COLOR_TEXT_PRIMARY = '#0f172a'; // heading text
+export const COLOR_TEXT_BODY = '#475569'; // body / label text
+export const COLOR_TEXT_MUTED = '#64748b'; // secondary / muted labels
+export const COLOR_TEXT_WHITE = '#ffffff'; // white text on dark fills
+export const COLOR_BORDER_LIGHT = '#e2e8f0'; // dividers, subtle borders
+export const COLOR_BORDER_DEFAULT = '#cbd5e1'; // lifelines, group outlines
+export const COLOR_EDGE_DEFAULT = '#64748b'; // solid edge stroke
+export const COLOR_EDGE_DASHED = '#94a3b8'; // dashed / return edge stroke
+// ── Light semantic palette (outlined boxes — baseline + elk nodes) ────────────
+// Fill + stroke + text per emphasis value.
+export const PALETTE_NORMAL = { fill: '#f1f5f9', stroke: '#94a3b8', text: COLOR_TEXT_PRIMARY };
+export const PALETTE_PRIMARY = { fill: '#dbeafe', stroke: '#3b82f6', text: '#0c2a5b' };
+export const PALETTE_ACCENT = { fill: '#ede9fe', stroke: '#8b5cf6', text: '#3b1d80' };
+export const PALETTE_MUTED = { fill: '#f8fafc', stroke: '#cbd5e1', text: '#475569' };
+export const PALETTE_DANGER = { fill: '#fee2e2', stroke: '#ef4444', text: '#7f1d1d' };
+export const PALETTE_SUCCESS = { fill: '#dcfce7', stroke: '#22c55e', text: '#14532d' };
+// ── Dark semantic palette (sequence actor boxes — saturated fills + white text) ─
+export const DARK_PRIMARY = '#1e3a5f'; // deep navy
+export const DARK_ACCENT = '#3730a3'; // deep indigo / purple
+export const DARK_SUCCESS = '#14532d'; // dark forest green
+export const DARK_DANGER = '#7f1d1d'; // dark crimson
+export const DARK_NORMAL = '#334155'; // dark slate
+export const DARK_MUTED = '#475569'; // medium slate
+// Cycling fills for actors with no explicit emphasis (distinct per slot).
+export const ACTOR_CYCLE_FILLS = [
+    DARK_PRIMARY, // navy   (slot 0)
+    DARK_SUCCESS, // green  (slot 1)
+    DARK_ACCENT, // indigo (slot 2)
+    '#7c2d12', // rust   (slot 3)
+    '#134e4a', // teal   (slot 4)
+    '#4c1d95', // violet (slot 5)
+];
+// ── Satori card palette (rich panel cards — always white text) ────────────────
+export const CARD_PALETTE_PRIMARY = '#1e4e79';
+export const CARD_PALETTE_ACCENT = '#4b3f9e';
+export const CARD_PALETTE_DANGER = '#8a3a2c';
+export const CARD_PALETTE_SUCCESS = '#3f6e26';
+export const CARD_PALETTE_NORMAL = '#3b4250';
+export const CARD_PALETTE_MUTED = '#64748b';
+// ── Satori checkpoint pills ───────────────────────────────────────────────────
+export const CHECKPOINT_FILL = '#6b5212';
+export const CHECKPOINT_BORDER = '#b8923a';
+export const CHECKPOINT_TEXT = '#ffd98a';
+// ── Satori connector arrows (vertical between cards) ─────────────────────────
+export const CONNECTOR_COLOR = '#cbd5e1';
+// ── Arrow markers (graph edges) ───────────────────────────────────────────────
+export const ARROW_FILL = '#475569'; // filled arrowhead
+export const ARROW_STROKE = '#475569'; // open arrowhead stroke
+//# sourceMappingURL=theme.js.map

package/dist/domain/theme.js.map

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

package/dist/domain/validate.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Runtime validation for a DiagramSpec. The schema is the contract a model
+ * (later) must emit; the lab fails loud on a malformed spec so a technique
+ * never silently renders garbage. Pure, dependency-free.
+ */
+import type { DiagramSpec } from './spec.js';
+export interface ValidationIssue {
+    path: string;
+    message: string;
+}
+/**
+ * Validate structural integrity of a spec: unique node ids, edges/groups/
+ * annotations referencing real nodes, non-empty labels.
+ *
+ * @param spec the diagram spec to check
+ * @returns a list of issues; empty means valid
+ */
+export declare function validateSpec(spec: DiagramSpec): ValidationIssue[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/domain/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/domain/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,EAAE,CA+DjE"}