@milehimikey/em 1.5.0 → 1.6.1

package/dist/render/sliceDiagram.js

@@ -0,0 +1,198 @@
+// SPDX-License-Identifier: MIT
+// Renders a single slice's own diagram, matching the canonical shape of
+// whichever of the 4 Event Modeling patterns it is (State Change, State View,
+// Automation, Translation) — instead of cropping the full multi-slice diagram
+// down to one column (which forces a narrow crop to still show a wide swimlane
+// label, and can pull in most of a neighboring slice; see git history).
+//
+// The key trick: every piece of "immediate context" a slice needs to draw its
+// own shape is already one hop away in the compiled model — a view's upstream
+// event(s) resolve via `from` (resolveFromSource, shared with semanticEdges),
+// and an automation/translation's watched view is just whatever `view` sits in
+// the same slice. So this builds a tiny *synthetic* NormalizedModel — reusing
+// the real, already-normalized Element objects (same ids, same fields, same
+// notes), shallow-cloned only to reassign which of a handful of new columns
+// they land in — and runs it through the exact same layout()/emitDot() the
+// full model uses, unmodified. Edge-drawing comes free too: semanticEdges()
+// resolves `from` via byName, so as long as the synthetic model's byName map
+// is populated, the arrows get drawn by the existing inference with zero new
+// edge-drawing code.
+//
+// This never chases more than one hop away (previous slice for a triggerless
+// State Change; a view's own `from` sources for State View; the next slice for
+// Automation/Translation — semanticEdges itself never looks further than i+1),
+// so a slice diagram can never balloon into showing most of the model, the way
+// a naive crop or a naive "just extract this slice and recompile" both could.
+import { AUTOMATION_KINDS } from "../parser/ast.js";
+import { normalizeName } from "../model/model.js";
+import { resolveFromSource } from "../model/edges.js";
+import { layout } from "../layout/grid.js";
+import { emitDot } from "../emit/dot.js";
+import { classifySlicePattern } from "../catalog/classify.js";
+/** Build a small, standalone diagram for one slice — real Graphviz layout, not a crop.
+ *  `opts` is forwarded to layout() unchanged, so `--keep-empty-lanes` behaves the same
+ *  way here as it does for the full model instead of being silently dropped. */
+export function buildSliceDiagram(model, sliceIndex, opts = {}) {
+    const slice = model.slices[sliceIndex];
+    const pattern = classifySlicePattern(slice);
+    const columns = mergeColumns(collectColumns(model, sliceIndex, pattern));
+    const synthetic = assembleSyntheticModel(model, columns, slice.name);
+    const grid = layout(synthetic, opts);
+    const dot = emitDot(synthetic, grid);
+    return { model: synthetic, grid, dot };
+}
+function collectColumns(model, sliceIndex, pattern) {
+    switch (pattern) {
+        case "state-change":
+            return columnsForStateChange(model, sliceIndex);
+        case "state-view":
+            return columnsForStateView(model, sliceIndex);
+        case "automation":
+        case "translation":
+            return columnsForReaction(model, sliceIndex);
+        default: // "unclassified"
+            return [{ sourceSliceIndex: sliceIndex, elements: model.slices[sliceIndex].elements }];
+    }
+}
+/** State Change: UI -> Command -> Event, all in this slice. If there's no local
+ *  UI, the command's real trigger is the previous slice's automation/translation
+ *  reaction — pull in just that one element as earlier context. */
+function columnsForStateChange(model, i) {
+    const slice = model.slices[i];
+    const hasUi = slice.elements.some((e) => e.kind === "ui");
+    const cols = [{ sourceSliceIndex: i, elements: slice.elements }];
+    if (!hasUi) {
+        const prev = model.slices[i - 1];
+        const trigger = prev?.elements.find((e) => AUTOMATION_KINDS.has(e.kind));
+        if (trigger)
+            cols.push({ sourceSliceIndex: i - 1, elements: [trigger] });
+    }
+    return cols;
+}
+/** State View: Event(s) -> View -> UI. Each view's `from` names resolve to their
+ *  real source Elements (same rule semanticEdges uses) — one column per distinct
+ *  origin slice, so a multi-source view (e.g. a dashboard reading two events from
+ *  two different, possibly far-apart slices) naturally gets one column per source,
+ *  not a single blown-out column. */
+function columnsForStateView(model, i) {
+    const slice = model.slices[i];
+    const cols = [];
+    for (const view of slice.elements.filter((e) => e.kind === "view")) {
+        for (const name of view.from ?? []) {
+            const src = resolveFromSource(model, view, name);
+            if (src)
+                cols.push({ sourceSliceIndex: src.sliceIndex, elements: [src] });
+        }
+    }
+    cols.push({ sourceSliceIndex: i, elements: slice.elements });
+    return cols;
+}
+/** Automation/Translation share one shape: [View ->] Automation (this slice),
+ *  then Command -> Event (the immediately next slice — never further, mirroring
+ *  semanticEdges' own i+1-only rule). The watched view is same-slice adjacency,
+ *  not a `from` hop, so it's already included via this slice's own elements —
+ *  deliberately not chased any further back. Only command/event are pulled from
+ *  the next slice; a stray `ui` there belongs to *that* slice's own diagram. */
+function columnsForReaction(model, i) {
+    const slice = model.slices[i];
+    const cols = [{ sourceSliceIndex: i, elements: slice.elements }];
+    const next = model.slices[i + 1];
+    const forward = next?.elements.filter((e) => e.kind === "command" || e.kind === "event") ?? [];
+    if (forward.length > 0)
+        cols.push({ sourceSliceIndex: i + 1, elements: forward });
+    return cols;
+}
+/** Merge columns sharing a source slice (two `from` names can resolve to the same
+ *  origin slice), dedupe elements by id, then sort chronologically. `from`/reaction
+ *  wiring only ever points backward or to the immediate next slice, so a plain
+ *  ascending sort by real slice index is sufficient for correct left-to-right
+ *  placement across every pattern — no pattern-specific ordering code needed. */
+function mergeColumns(columns) {
+    const bySource = new Map();
+    for (const col of columns) {
+        let elements = bySource.get(col.sourceSliceIndex);
+        if (!elements) {
+            elements = new Map();
+            bySource.set(col.sourceSliceIndex, elements);
+        }
+        for (const el of col.elements)
+            elements.set(el.id, el);
+    }
+    return [...bySource.entries()]
+        .map(([sourceSliceIndex, elements]) => ({ sourceSliceIndex, elements: [...elements.values()] }))
+        .sort((a, b) => a.sourceSliceIndex - b.sourceSliceIndex);
+}
+/**
+ * Assemble a small, valid NormalizedModel from the given columns — real Element
+ * objects, shallow-cloned only to reassign `sliceIndex` to their new synthetic
+ * column (never mutating the real model). Two details matter for correctness:
+ *
+ * - `byId` keeps each clone's *original* id — everything downstream (emitDot's
+ *   node ids, styleFor, note markers, parseNodeRects) keys off Element.id, so
+ *   preserving it is what keeps the whole rest of the render pipeline working
+ *   completely unmodified.
+ * - `byName` is populated from the clones actually included, using their
+ *   untouched `name`/`from` strings — this is the entire trick that makes edge
+ *   drawing free: semanticEdges() (called later, unmodified, inside
+ *   composeSvg) resolves `from` via byName exactly as it does for the full
+ *   model, so it finds the clones and draws the arrows automatically.
+ *
+ * `personas`/`contexts` are derived from only the included elements, not
+ * copied from the full model — copying them was the exact class of bug that
+ * made the previous crop-based approach barely narrower than the full diagram
+ * (an unused row still reserves its own swimlane).
+ */
+function assembleSyntheticModel(model, columns, title) {
+    const slices = [];
+    const elements = [];
+    const byId = new Map();
+    const byName = new Map();
+    columns.forEach((col, syntheticIndex) => {
+        const origin = model.slices[col.sourceSliceIndex];
+        const cloned = col.elements.map((el) => ({ ...el, sliceIndex: syntheticIndex }));
+        slices.push({ name: origin.name, index: syntheticIndex, source: origin.source, elements: cloned, line: origin.line });
+        for (const el of cloned) {
+            elements.push(el);
+            byId.set(el.id, el);
+            const key = normalizeName(el.name);
+            const bucket = byName.get(key);
+            if (bucket)
+                bucket.push(el);
+            else
+                byName.set(key, [el]);
+        }
+    });
+    return {
+        name: title,
+        personas: dedupeDefined(elements.filter((e) => e.kind === "ui").map((e) => e.persona)),
+        contexts: dedupeDefined(elements.filter((e) => e.kind === "event").map((e) => e.context)),
+        hasAutomation: elements.some((e) => AUTOMATION_KINDS.has(e.kind)),
+        slices,
+        elements,
+        byId,
+        byName,
+        // v1 gap, deliberate: explicit DSL `arrow` statements are rare (they exist for
+        // relationships semanticEdges' pattern inference can't derive on its own) and
+        // dropping them from a single-slice extraction is narrow, not silent — a
+        // follow-up could remap model.arrows entries whose both endpoints resolve
+        // through an original-id -> cloned-id map, but it's not needed to ship this.
+        arrows: [],
+        // Unused by layout()/emitDot() — fieldLabel() prints a field's type as a raw
+        // string, never resolves it — so passthrough is free and avoids handing back
+        // broken/empty maps for no benefit.
+        types: model.types,
+        typesByName: model.typesByName,
+    };
+}
+function dedupeDefined(values) {
+    const seen = new Set();
+    const out = [];
+    for (const v of values) {
+        if (v && !seen.has(v)) {
+            seen.add(v);
+            out.push(v);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=sliceDiagram.js.map

package/dist/render/sliceDiagram.js.map

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

package/dist/render/sliceOverlay.d.ts

@@ -0,0 +1,21 @@
+import { NormalizedModel } from "../model/model.js";
+import { Grid } from "../layout/grid.js";
+import { Rect } from "./svgGeometry.js";
+/** Every non-element node id the slice overlay needs a rect for (header cells),
+ *  to fold into the same parseNodeRects() call as element ids. */
+export declare function sliceOverlayIds(grid: Grid): string[];
+/** Splice `data-slice="<index>"` onto every element's node group. */
+export declare function tagSliceAttrs(svg: string, model: NormalizedModel): string;
+/** `<metadata>` (slice ranges, as JSON) + `<style>` (the dim class) block, spliced
+ *  just inside the root `<svg>`. `svg` is scanned (post-fitCanvas/tagSliceAttrs is
+ *  fine — neither touches `<text>` elements) for the row-label column's x-range.
+ *  Returns "" if no slice has a rect — the model is empty, or the SVG shape wasn't
+ *  what parseNodeRects expected.
+ *
+ *  rects (from parseNodeRects) and the row-label `<text>` x positions scanned below
+ *  are both in graph-space — the coordinate system *inside* Graphviz's
+ *  `<g class="graph" transform="scale(...) translate(...)">` wrapper — not the root
+ *  SVG/viewBox space the served viewer sets `viewBox` in. Every x0/x1 here goes
+ *  through readGraphTransform()'s toRoot() before it's embedded, the same
+ *  conversion fitCanvas() applies to the edge-detour bbox for the same reason. */
+export declare function buildSliceOverlay(svg: string, grid: Grid, rects: Map<string, Rect>): string;

package/dist/render/sliceOverlay.js

@@ -0,0 +1,111 @@
+// SPDX-License-Identifier: MIT
+// Tags each element's rendered node group with its slice index, and embeds a
+// <metadata> block describing every slice's name and x-range in the SVG.
+//
+// This is what lets the storyboard mode in the live viewer (`em watch --serve`,
+// see src/render/serve.ts) highlight and pan/zoom to one slice at a time
+// entirely client-side, with no separate data fetch — everything the browser
+// needs travels inside the SVG it already loads.
+//
+// A slice's x-range comes from its header-cell rect (headerCellId), not from
+// element rects — a slice can have empty rows, which would give an element-based
+// bbox a wrong or missing range.
+//
+// The row-label (swimlane) column has no rect at all in parseNodeRects' sense:
+// row labels render as bare `shape=plaintext` Graphviz nodes, which emit only a
+// `<text>` element (no `<polygon>`/`<path>`), so they fall outside
+// parseNodeRects' polygon/path-based extraction entirely. Their x-range is
+// instead estimated straight from each `<text>` element: an exact center
+// (Graphviz always emits `text-anchor="middle"` here) and a width approximated
+// from character count and font size. That's a deliberate approximation local
+// to this file — good enough to keep the swimlane labels in frame when the
+// storyboard viewer pans/zooms to a slice, not meant to be pixel-accurate, and
+// not worth teaching the shared parseNodeRects() a text-measuring fallback for
+// its one caller that needs it.
+import { headerCellId } from "../layout/grid.js";
+import { rowLabelId } from "../emit/dot.js";
+import { decode, readGraphTransform, NODE_GROUP, TITLE } from "./svgGeometry.js";
+const TEXT = /<text\b([^>]*)>([^<]*)<\/text>/;
+/** Every non-element node id the slice overlay needs a rect for (header cells),
+ *  to fold into the same parseNodeRects() call as element ids. */
+export function sliceOverlayIds(grid) {
+    const ids = [];
+    for (let c = 0; c < grid.cols; c++)
+        ids.push(headerCellId(c));
+    return ids;
+}
+/** Splice `data-slice="<index>"` onto every element's node group. */
+export function tagSliceAttrs(svg, model) {
+    return svg.replace(NODE_GROUP, (block) => {
+        const id = decode(TITLE.exec(block)?.[1] ?? "");
+        const el = model.byId.get(id);
+        if (!el)
+            return block; // header cell, row label, or placeholder — leave untagged
+        return block.replace(/^<g\b/, `<g data-slice="${el.sliceIndex}"`);
+    });
+}
+/** `<metadata>` (slice ranges, as JSON) + `<style>` (the dim class) block, spliced
+ *  just inside the root `<svg>`. `svg` is scanned (post-fitCanvas/tagSliceAttrs is
+ *  fine — neither touches `<text>` elements) for the row-label column's x-range.
+ *  Returns "" if no slice has a rect — the model is empty, or the SVG shape wasn't
+ *  what parseNodeRects expected.
+ *
+ *  rects (from parseNodeRects) and the row-label `<text>` x positions scanned below
+ *  are both in graph-space — the coordinate system *inside* Graphviz's
+ *  `<g class="graph" transform="scale(...) translate(...)">` wrapper — not the root
+ *  SVG/viewBox space the served viewer sets `viewBox` in. Every x0/x1 here goes
+ *  through readGraphTransform()'s toRoot() before it's embedded, the same
+ *  conversion fitCanvas() applies to the edge-detour bbox for the same reason. */
+export function buildSliceOverlay(svg, grid, rects) {
+    const transform = readGraphTransform(svg);
+    const toRootX = (x) => transform.toRoot(x, 0).x;
+    const slices = [];
+    for (let c = 0; c < grid.cols; c++) {
+        const r = rects.get(headerCellId(c));
+        if (!r)
+            continue;
+        slices.push({ index: c, name: grid.sliceNames[c], x0: toRootX(r.left), x1: toRootX(r.right) });
+    }
+    if (slices.length === 0)
+        return "";
+    const rowLabels = rowLabelXRange(svg, grid.rows.length, toRootX);
+    const payload = { slices, rowLabels };
+    const metadata = `<metadata id="em-slices">${escXml(JSON.stringify(payload))}</metadata>`;
+    const style = `<style>.em-slice-dim{opacity:.15;transition:opacity .15s ease}</style>`;
+    return metadata + style;
+}
+/** Estimate the row-label column's x-range from its `<text>` elements — see the
+ *  file header comment for why this can't go through parseNodeRects. `toRootX`
+ *  converts the graph-space text position (and the estimated half-width around
+ *  it) into root/viewBox space — see buildSliceOverlay's comment. Returns null
+ *  if no row label rendered any text (e.g. an empty model). */
+function rowLabelXRange(svg, rowCount, toRootX) {
+    let range = null;
+    for (let r = 0; r < rowCount; r++) {
+        // Scoped to this row's own node group (up to its closing </g>) rather than a
+        // fixed-length lookahead — the header row's label is always "" (no <text> of
+        // its own), and a fixed window would otherwise pick up the *next* row's text.
+        const body = new RegExp(`<title>${rowLabelId(r)}<\\/title>([\\s\\S]*?)<\\/g>`).exec(svg)?.[1];
+        if (!body)
+            continue;
+        const m = TEXT.exec(body);
+        if (!m)
+            continue; // the header row's label is "" — plaintext emits no <text> at all
+        const x = +(attr(m[1], "x") ?? NaN);
+        if (Number.isNaN(x))
+            continue;
+        const fontSize = +(attr(m[1], "font-size") ?? 10);
+        const halfWidth = (decode(m[2]).length * fontSize) / 2 + 4; // + a little breathing room
+        const x0 = toRootX(x - halfWidth);
+        const x1 = toRootX(x + halfWidth);
+        range = range ? { x0: Math.min(range.x0, x0), x1: Math.max(range.x1, x1) } : { x0, x1 };
+    }
+    return range;
+}
+function attr(attrs, name) {
+    return new RegExp(`\\b${name}="(-?[\\d.]+)"`).exec(attrs)?.[1];
+}
+function escXml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=sliceOverlay.js.map

package/dist/render/sliceOverlay.js.map

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

package/dist/render/sliceStatus.d.ts

@@ -0,0 +1,5 @@
+import { NormalizedModel } from "../model/model.js";
+/** One status per slice, same order as model.slices (and so the same order as
+ *  the header row's columns — see layout/grid.ts's sliceNames). null means no
+ *  doc was found, or the doc has no `- **Status:** ...` line. */
+export declare function readSliceStatuses(model: NormalizedModel, baseDir: string): (string | null)[];

package/dist/render/sliceStatus.js

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: MIT
+// Reads each slice's development status from its sibling design doc
+// (slices/<kebab-slug>.md, see .claude/skills/event-modeling/templates/slice.md),
+// for the main render pipeline (composeSvg) to color slice headers with.
+//
+// Same doc-path convention `em catalog` already uses (src/catalog/build.ts):
+// the *deduped* export key from computeRefs(), not a fresh kebabSlug(name) —
+// so two same-named slices resolve statuses the same way `em catalog` resolves
+// docs for them (first one gets the real file, the second honestly gets null).
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { computeRefs } from "../emit/json.js";
+import { parseSliceDoc } from "../catalog/sliceDoc.js";
+/** One status per slice, same order as model.slices (and so the same order as
+ *  the header row's columns — see layout/grid.ts's sliceNames). null means no
+ *  doc was found, or the doc has no `- **Status:** ...` line. */
+export function readSliceStatuses(model, baseDir) {
+    const { sliceKeys } = computeRefs(model);
+    return model.slices.map((_slice, i) => {
+        const docPath = join(baseDir, "slices", `${sliceKeys[i]}.md`);
+        if (!existsSync(docPath))
+            return null;
+        return parseSliceDoc(readFileSync(docPath, "utf8")).status;
+    });
+}
+//# sourceMappingURL=sliceStatus.js.map

package/dist/render/sliceStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliceStatus.js","sourceRoot":"","sources":["../../src/render/sliceStatus.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,oEAAoE;AACpE,kFAAkF;AAClF,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;iEAEiE;AACjE,MAAM,UAAU,iBAAiB,CAAC,KAAsB,EAAE,OAAe;IACvE,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/render/statusOverlay.d.ts

@@ -0,0 +1,16 @@
+import { Grid } from "../layout/grid.js";
+/** Recolor each header cell whose slice resolved to a known status (see
+ *  statusStyle()). Slices with no doc, `draft`, or an unrecognized status
+ *  string are left with the default header colors, untouched. */
+export declare function applyStatusColors(svg: string, grid: Grid, statuses: (string | null)[]): string;
+/**
+ * Grow the canvas and append a "Slice Status" legend below the diagram, one
+ * swatch+label row per distinct known status actually present among
+ * `statuses`. Returns the SVG unchanged if no slice resolved to a known
+ * status (nobody's using slice docs yet, or none set a recognized value), or
+ * if the SVG's dimensions can't be parsed. Independent of appendNoteLegend
+ * (src/render/drawNotes.ts) — safe to call after it since it recomputes the
+ * (possibly already-grown) viewBox itself, same as every other
+ * append-below-diagram step in the render pipeline.
+ */
+export declare function appendStatusLegend(svg: string, grid: Grid, statuses: (string | null)[]): string;

package/dist/render/statusOverlay.js

@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: MIT
+// Recolors each slice header cell's fill/stroke/font in a Graphviz-rendered SVG
+// based on that slice's development status (see src/render/sliceStatus.ts),
+// and appends a small legend explaining the colors actually used.
+//
+// This is a post-layout overlay, the same pattern as drawEdges.ts/drawNotes.ts:
+// Graphviz always lays out every header cell identically (status never affects
+// size, only color), so recoloring is a scoped string replace on the already-
+// rendered header node group rather than anything that needs new geometry.
+import { headerCellId } from "../layout/grid.js";
+import { HEADER_FILL, HEADER_BORDER, HEADER_FONT } from "../emit/dot.js";
+import { statusStyle } from "../emit/theme.js";
+// Graphviz lowercases hex colors in its SVG output (e.g. our "#E3E7EB" comes
+// back as "#e3e7eb"), so matching must be case-insensitive even though we
+// authored the DOT-side constants in uppercase.
+function attrRe(name, value) {
+    return new RegExp(`${name}="${value}"`, "gi");
+}
+/** Recolor each header cell whose slice resolved to a known status (see
+ *  statusStyle()). Slices with no doc, `draft`, or an unrecognized status
+ *  string are left with the default header colors, untouched. */
+export function applyStatusColors(svg, grid, statuses) {
+    let out = svg;
+    for (let c = 0; c < grid.cols; c++) {
+        const style = statusStyle(statuses[c] ?? null);
+        if (!style)
+            continue;
+        const id = headerCellId(c);
+        const re = new RegExp(`(<title>${id}</title>)([\\s\\S]*?)(</g>)`);
+        out = out.replace(re, (_whole, title, body, close) => {
+            const recolored = body
+                .replace(attrRe("fill", HEADER_FILL), `fill="${style.fill}"`)
+                .replace(attrRe("stroke", HEADER_BORDER), `stroke="${style.stroke}"`)
+                .replace(attrRe("fill", HEADER_FONT), `fill="${style.fontColor}"`);
+            return title + recolored + close;
+        });
+    }
+    return out;
+}
+// ---- legend ----
+const PAD_X = 16;
+const PAD_TOP = 14;
+const HEAD_H = 22;
+const LINE_H = 18;
+const PAD_BOTTOM = 14;
+const SWATCH = 11;
+/** Canonical display order, independent of column order — a model's slices can
+ *  land in any status in any order, but the legend should read the same way
+ *  (earliest-to-latest lifecycle stage) every time. */
+const STATUS_ORDER = ["reviewed", "ready-to-implement", "implemented"];
+function humanizeStatus(status) {
+    return status.charAt(0).toUpperCase() + status.slice(1).replace(/-/g, " ");
+}
+/**
+ * Grow the canvas and append a "Slice Status" legend below the diagram, one
+ * swatch+label row per distinct known status actually present among
+ * `statuses`. Returns the SVG unchanged if no slice resolved to a known
+ * status (nobody's using slice docs yet, or none set a recognized value), or
+ * if the SVG's dimensions can't be parsed. Independent of appendNoteLegend
+ * (src/render/drawNotes.ts) — safe to call after it since it recomputes the
+ * (possibly already-grown) viewBox itself, same as every other
+ * append-below-diagram step in the render pipeline.
+ */
+export function appendStatusLegend(svg, grid, statuses) {
+    const present = new Set(statuses.slice(0, grid.cols).map((s) => s?.toLowerCase()).filter((s) => !!s));
+    const rows = STATUS_ORDER.filter((s) => present.has(s));
+    if (rows.length === 0)
+        return svg;
+    const vb = /viewBox="([\d.eE+-]+)\s+([\d.eE+-]+)\s+([\d.eE+-]+)\s+([\d.eE+-]+)"/.exec(svg);
+    const hpt = /height="([\d.eE+-]+)pt"/.exec(svg);
+    if (!vb || !hpt)
+        return svg;
+    const minX = +vb[1];
+    const minY = +vb[2];
+    const vw = +vb[3];
+    const vh = +vb[4];
+    const legendH = PAD_TOP + HEAD_H + rows.length * LINE_H + PAD_BOTTOM;
+    const newVh = vh + legendH;
+    const newHpt = +hpt[1] * (newVh / vh);
+    const top = minY + vh;
+    let out = svg;
+    out = out.replace(hpt[0], `height="${n(newHpt)}pt"`);
+    out = out.replace(vb[0], `viewBox="${vb[1]} ${vb[2]} ${vb[3]} ${n(newVh)}"`);
+    const sectionY = top + PAD_TOP;
+    let sections = `<text x="${n(minX + PAD_X)}" y="${n(sectionY + 14)}" font-family="Helvetica" ` +
+        `font-weight="bold" font-size="12" fill="#202124">Slice Status</text>`;
+    sections += rows
+        .map((status, i) => {
+        const style = statusStyle(status);
+        const y = sectionY + HEAD_H + i * LINE_H;
+        return (`<rect x="${n(minX + PAD_X)}" y="${n(y)}" width="${SWATCH}" height="${SWATCH}" ` +
+            `fill="${style.fill}" stroke="${style.stroke}"/>` +
+            `<text x="${n(minX + PAD_X + SWATCH + 6)}" y="${n(y + SWATCH - 1)}" font-family="Helvetica" ` +
+            `font-size="11" fill="#3C4043">${esc(humanizeStatus(status))}</text>`);
+    })
+        .join("");
+    const legend = `<g class="em-status-legend">` +
+        `<rect x="${n(minX)}" y="${n(top)}" width="${n(vw)}" height="${n(legendH)}" fill="#FFFFFF"/>` +
+        `<line x1="${n(minX)}" y1="${n(top)}" x2="${n(minX + vw)}" y2="${n(top)}" stroke="#D0D0D0" stroke-width="1"/>` +
+        sections +
+        `</g>`;
+    return out.replace(/(<\/g>\s*)(<\/svg>)/, `$1${legend}$2`);
+}
+function n(v) {
+    return String(Math.round(v * 100) / 100);
+}
+function esc(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=statusOverlay.js.map

package/dist/render/statusOverlay.js.map

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

package/dist/render/svgGeometry.d.ts

@@ -6,6 +6,8 @@ export interface Rect {
     cx: number;
     cy: number;
 }
+export declare const NODE_GROUP: RegExp;
+export declare const TITLE: RegExp;
 /** Map each requested node id to its rectangle in SVG coordinates. */
 export declare function parseNodeRects(svg: string, ids: Set<string>): Map<string, Rect>;
 /** A bounding box in the graph's own (post-transform) coordinate space. */
@@ -15,9 +17,37 @@ export interface Box {
     maxX: number;
     maxY: number;
 }
+/** scale/translate read from the graph's own transform, and the root-space
+ *  conversion it implies — see readGraphTransform() for where this comes from. */
+export interface GraphTransform {
+    sx: number;
+    sy: number;
+    tx: number;
+    ty: number;
+    /** Convert a graph-space (pre-transform) point — e.g. a rect from
+     *  parseNodeRects(), or a raw `<text>` x/y — into root/viewBox space. */
+    toRoot(x: number, y: number): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Graphviz wraps the graph in `transform="scale(sx sy) rotate(0) translate(tx ty)"`,
+ * applied right to left, so a graph-space point lands at `scale * (p + translate)`.
+ * Anything computed from parseNodeRects()'s box coordinates (or a `<text>` element's
+ * raw x/y) is in that same pre-transform graph space — it must go through
+ * `toRoot()` before it's valid as a viewBox coordinate or compared against one.
+ * Defaults to the identity transform (scale 1, translate 0) if the graph group or
+ * its transform attribute isn't present, matching what Graphviz emits when neither
+ * scaling nor an offset was needed.
+ */
+export declare function readGraphTransform(svg: string): GraphTransform;
 /**
  * Grow the canvas so content drawn in graph space isn't clipped by the root viewBox.
  * Edge detours can legitimately run outside the box grid Graphviz sized the canvas for
  * (an arc under the bottom lane, say), and anything past the viewBox is simply lost.
  */
 export declare function fitCanvas(svg: string, box: Box | null): string;
+/** Decode the handful of entities Graphviz emits in `<title>` text. Shared with
+ *  sliceOverlay.ts, which also needs to recover an element id from a title. */
+export declare function decode(s: string): string;