@milehimikey/em 1.5.0 → 1.6.0

package/dist/render/render.d.ts

@@ -1,6 +1,25 @@
 import { NormalizedModel } from "../model/model.js";
+import { Grid } from "../layout/grid.js";
 export declare function formatFromPath(outPath: string, fallback?: string): string;
-export declare function renderDot(dot: string, model: NormalizedModel, outPath: string, format?: string, baseDir?: string): Promise<void>;
+/** Run the Graphviz WASM layout pass only — the part shared by every caller that
+ *  needs to compose the same layout for more than one output location (a full
+ *  diagram and a slice diagram of it, note hrefs recomputed for each — see
+ *  buildCatalog and `em render --slice`), so it isn't paid for twice. */
+export declare function layoutDot(dot: string): Promise<string>;
+/**
+ * Compose a laid-out SVG with edges, notes, slice tags/metadata, and the legend —
+ * the pure/string half of rendering, split out from layoutDot's WASM call. `outDir`
+ * is where the composed SVG will ultimately be written; note links are authored
+ * relative to `baseDir` (the .em file) and get rewritten relative to `outDir` here,
+ * so a caller composing the *same* layout for two different output locations (e.g.
+ * a full diagram and a slice diagram one directory deeper) must call this twice,
+ * once per real outDir, rather than reuse one composed string for both.
+ */
+export declare function composeSvg(rawSvg: string, model: NormalizedModel, grid: Grid, baseDir: string, outDir: string): string;
+/** Serialize a composed SVG string to `outPath` in the requested format — split out
+ *  so a caller can transform the composed string in between composing and writing it. */
+export declare function writeRendered(svg: string, outPath: string, format?: string): Promise<void>;
+export declare function renderDot(dot: string, model: NormalizedModel, grid: Grid, outPath: string, format?: string, baseDir?: string): Promise<void>;
 /**
  * Resolve a note path (authored relative to the .em file) into an href relative
  * to the output SVG's directory, so links stay valid wherever the SVG is

package/dist/render/render.js

@@ -14,7 +14,10 @@ import { Graphviz } from "@hpcc-js/wasm-graphviz";
 import { Resvg } from "@resvg/resvg-js";
 import { fitCanvas, parseNodeRects } from "./svgGeometry.js";
 import { buildEdgeOverlay } from "./drawEdges.js";
-import { buildNoteMarkers, buildIssueMarkers, appendNoteLegend } from "./drawNotes.js";
+import { buildNoteMarkers, buildIssueMarkers, buildDivergenceMarkers, appendNoteLegend } from "./drawNotes.js";
+import { sliceOverlayIds, tagSliceAttrs, buildSliceOverlay } from "./sliceOverlay.js";
+import { readSliceStatuses } from "./sliceStatus.js";
+import { applyStatusColors, appendStatusLegend } from "./statusOverlay.js";
 const RSVG_BIN = process.env.EM_RSVG || "rsvg-convert";
 // The WASM Graphviz module is loaded once and reused across renders.
 let graphvizModule;
@@ -25,13 +28,31 @@ export function formatFromPath(outPath, fallback = "svg") {
     const ext = extname(outPath).replace(/^\./, "").toLowerCase();
     return ext || fallback;
 }
-export async function renderDot(dot, model, outPath, format = formatFromPath(outPath), baseDir = process.cwd()) {
-    // Note links are authored relative to the .em file (baseDir); rewrite them
-    // relative to the output SVG so they resolve wherever the SVG is written.
-    const outDir = dirname(outPath);
-    const hrefOf = (el) => noteHref(el.note ?? "", baseDir, outDir);
+/** Run the Graphviz WASM layout pass only — the part shared by every caller that
+ *  needs to compose the same layout for more than one output location (a full
+ *  diagram and a slice diagram of it, note hrefs recomputed for each — see
+ *  buildCatalog and `em render --slice`), so it isn't paid for twice. */
+export async function layoutDot(dot) {
     const gv = await graphviz();
-    const svg = withOverlays(gv.layout(dot, "svg", "dot"), model, hrefOf);
+    return gv.layout(dot, "svg", "dot");
+}
+/**
+ * Compose a laid-out SVG with edges, notes, slice tags/metadata, and the legend —
+ * the pure/string half of rendering, split out from layoutDot's WASM call. `outDir`
+ * is where the composed SVG will ultimately be written; note links are authored
+ * relative to `baseDir` (the .em file) and get rewritten relative to `outDir` here,
+ * so a caller composing the *same* layout for two different output locations (e.g.
+ * a full diagram and a slice diagram one directory deeper) must call this twice,
+ * once per real outDir, rather than reuse one composed string for both.
+ */
+export function composeSvg(rawSvg, model, grid, baseDir, outDir) {
+    const hrefOf = (el) => noteHref(el.note ?? "", baseDir, outDir);
+    const statuses = readSliceStatuses(model, baseDir);
+    return withOverlays(rawSvg, model, grid, hrefOf, statuses);
+}
+/** Serialize a composed SVG string to `outPath` in the requested format — split out
+ *  so a caller can transform the composed string in between composing and writing it. */
+export async function writeRendered(svg, outPath, format = formatFromPath(outPath)) {
     if (format === "svg") {
         await writeFile(outPath, svg, "utf8");
         return;
@@ -49,6 +70,12 @@ export async function renderDot(dot, model, outPath, format = formatFromPath(out
     throw new Error(`format '${format}' is not built in (svg and png are). Install librsvg ` +
         `(provides '${RSVG_BIN}') to render '${format}', or use -o file.svg / -o file.png.`);
 }
+export async function renderDot(dot, model, grid, outPath, format = formatFromPath(outPath), baseDir = process.cwd()) {
+    const outDir = dirname(outPath);
+    const raw = await layoutDot(dot);
+    const svg = composeSvg(raw, model, grid, baseDir, outDir);
+    await writeRendered(svg, outPath, format);
+}
 /**
  * Resolve a note path (authored relative to the .em file) into an href relative
  * to the output SVG's directory, so links stay valid wherever the SVG is
@@ -63,28 +90,39 @@ export function noteHref(note, baseDir, outDir) {
     return rel.split(sep).join("/"); // posix separators for URLs
 }
 /** Draw the semantic edges and note markers into a Graphviz-rendered SVG. */
-function withOverlays(svg, model, hrefOf) {
-    const rects = parseNodeRects(svg, new Set(model.byId.keys()));
+function withOverlays(svg, model, grid, hrefOf, statuses) {
+    const rects = parseNodeRects(svg, new Set([...model.byId.keys(), ...sliceOverlayIds(grid)]));
     const { defs, group, bbox } = buildEdgeOverlay(model, rects);
     const notes = buildNoteMarkers(model, rects, hrefOf);
     const issues = buildIssueMarkers(model, rects);
+    const divergences = buildDivergenceMarkers(model, rects);
     // an edge detour can run outside the box grid Graphviz sized the canvas for, so make
     // room before anything else measures or appends to the viewBox
     let out = fitCanvas(svg, bbox);
-    // arrowhead markers go just inside <svg …>
-    out = out.replace(/(<svg\b[^>]*>)/, `$1${defs}`);
+    // recolor each slice's header cell per its doc status (src/render/sliceStatus.ts) —
+    // a scoped string replace keyed on each header's own <title> id, independent of
+    // tagSliceAttrs/buildSliceOverlay below, so the ordering here isn't load-bearing.
+    out = applyStatusColors(out, grid, statuses);
+    // tag each element's node group with data-slice="<index>" so the storyboard
+    // viewer (`em watch --serve`) can highlight/zoom to one slice at a time
+    // client-side, purely from what's already in the SVG.
+    out = tagSliceAttrs(out, model);
+    const sliceOverlay = buildSliceOverlay(out, grid, rects);
+    // arrowhead markers + slice metadata/style go just inside <svg …>
+    out = out.replace(/(<svg\b[^>]*>)/, `$1${defs}${sliceOverlay}`);
     // edges go under the boxes: just before the first node group
     const nodeAt = out.search(/<g\b[^>]*class="node"[^>]*>/);
     if (nodeAt >= 0)
         out = out.slice(0, nodeAt) + group + out.slice(nodeAt);
     else
         out = out.replace(/<\/svg>/, `${group}</svg>`);
-    // note/issue markers go on top of the boxes — inside the graph transform group
-    // (so they share the box coordinate space) but after every node, as the last
+    // note/issue/divergence markers go on top of the boxes — inside the graph transform
+    // group (so they share the box coordinate space) but after every node, as the last
     // children of that group, making them the topmost clickable layer.
-    out = out.replace(/(<\/g>\s*)(<\/svg>)/, `${notes}${issues}$1$2`);
+    out = out.replace(/(<\/g>\s*)(<\/svg>)/, `${notes}${issues}${divergences}$1$2`);
     // grow the canvas and append the legend below the diagram (root coords)
     out = appendNoteLegend(out, model, hrefOf);
+    out = appendStatusLegend(out, grid, statuses);
     return out;
 }
 /** Convert an SVG string to the requested format with an optional system rsvg-convert. */

package/dist/render/render.js.map

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

package/dist/render/serve.js

@@ -135,6 +135,14 @@ async function serveStatic(pathname, root, res) {
 // Served viewer page. Same double-buffered, no-flicker swap as the static
 // live.html fallback, but driven by SSE push instead of a poll loop — the
 // browser reloads only when the server says the SVG actually changed.
+//
+// Also carries stakeholder review mode: a Prev/Next storyboard that highlights
+// and pans/zooms to one slice at a time, reading the `data-slice`
+// attributes/`<metadata id="em-slices">` that src/render/sliceOverlay.ts
+// embeds in every rendered SVG. Review-mode state (`reviewMode`/`activeSlice`)
+// deliberately lives outside reload()'s closure and is re-applied after every
+// SSE-triggered swap — a facilitator hand-editing an `issue "..."` clause live
+// during a session should see it appear without losing their place.
 const VIEWER_HTML = `<!doctype html>
 <html lang="en">
 <head>
@@ -150,6 +158,26 @@ const VIEWER_HTML = `<!doctype html>
     header .dot { width: 9px; height: 9px; border-radius: 50%; background: #34c759; transition: background .3s; }
     header .dot.stale { background: #f0a020; }
     header .stamp { margin-left: auto; opacity: .7; font-variant-numeric: tabular-nums; }
+    .btn {
+      background: #3b4754; color: #fff; border: 0; border-radius: 4px;
+      padding: .3rem .7rem; font-size: 13px; cursor: pointer; font-family: inherit;
+    }
+    .btn:hover { background: #4b5763; }
+    .btn:disabled { opacity: .4; cursor: default; }
+    .btn.active { background: #2f6fed; }
+    #storyboard {
+      display: flex; align-items: center; gap: .5rem; padding: .4rem .9rem;
+      background: #e8eaed; border-bottom: 1px solid #d0d3d7;
+    }
+    #storyboard[hidden] { display: none; }
+    #storyboard .nav { background: none; border: 0; font-size: 18px; line-height: 1; cursor: pointer; color: #3b4754; padding: 0 .3rem; }
+    #storyboard .nav:disabled { opacity: .3; cursor: default; }
+    #filmstrip { display: flex; gap: .35rem; overflow-x: auto; }
+    #filmstrip .slice {
+      padding: .25rem .6rem; border-radius: 12px; background: #fff; border: 1px solid #d0d3d7;
+      font-size: 12px; white-space: nowrap; cursor: pointer; color: #3b4754; font-family: inherit;
+    }
+    #filmstrip .slice.active { background: #2f6fed; border-color: #2f6fed; color: #fff; font-weight: 600; }
     #stage { padding: 1rem; }
     object { width: 100%; height: calc(100vh - 60px); border: 0; }
   </style>
@@ -158,8 +186,14 @@ const VIEWER_HTML = `<!doctype html>
   <header>
     <span class="dot" id="dot"></span>
     <span>Event Model — live (push)</span>
+    <button class="btn" id="reviewToggle" title="Step through one slice at a time">Review mode</button>
     <span class="stamp" id="stamp">connecting…</span>
   </header>
+  <nav id="storyboard" hidden>
+    <button class="nav" id="prevSlice" aria-label="Previous slice">‹</button>
+    <div id="filmstrip"></div>
+    <button class="nav" id="nextSlice" aria-label="Next slice">›</button>
+  </nav>
   <div id="stage">
     <object id="svg" type="image/svg+xml"></object>
   </div>
@@ -170,8 +204,21 @@ const VIEWER_HTML = `<!doctype html>
     const stage = document.getElementById("stage");
     const stamp = document.getElementById("stamp");
     const dot = document.getElementById("dot");
+    const reviewToggle = document.getElementById("reviewToggle");
+    const storyboard = document.getElementById("storyboard");
+    const filmstrip = document.getElementById("filmstrip");
+    const prevBtn = document.getElementById("prevSlice");
+    const nextBtn = document.getElementById("nextSlice");
     let current = document.getElementById("svg");
 
+    // --- storyboard state: outside reload()'s closure on purpose, see the
+    // file-level comment above — an SSE reload must not reset these. ---
+    let reviewMode = false;
+    let activeSlice = null; // slice index, or null for "show all"
+    let slices = []; // [{index, name, x0, x1}], from this load's <metadata>
+    let rowLabels = null; // {x0, x1} | null, the swimlane label column's range
+    let naturalViewBox = null; // this load's pre-zoom viewBox, cached once per load
+
     // Double-buffer: load into a hidden <object>, swap on load, so the shared
     // screen never flashes white during a reload. Keep <object> (not <img>) so
     // note "..." links inside the SVG stay clickable.
@@ -185,10 +232,118 @@ const VIEWER_HTML = `<!doctype html>
         current = next;
         stamp.textContent = new Date().toLocaleTimeString();
         dot.classList.remove("stale");
+        onSvgLoaded();
       }, { once: true });
       next.setAttribute("data", SVG_FILE + "?t=" + Date.now());
     }
 
+    function readSliceMeta(doc) {
+      const el = doc.getElementById("em-slices");
+      if (!el) return null;
+      try { return JSON.parse(el.textContent); } catch { return null; }
+    }
+
+    // The currently-loaded SVG's own document + root element, or null before
+    // the first load / if the served file isn't a well-formed SVG.
+    function currentSvgDoc() {
+      const doc = current.contentDocument;
+      const svgRoot = doc && doc.querySelector("svg");
+      return doc && svgRoot ? { doc, svgRoot } : null;
+    }
+
+    // Re-read this load's slice metadata + natural viewBox, then reapply
+    // whatever storyboard state was already in effect (a fresh SSE push mid-
+    // review shouldn't reset the facilitator's position).
+    function onSvgLoaded() {
+      const loaded = currentSvgDoc();
+      if (!loaded) return;
+
+      naturalViewBox = loaded.svgRoot.getAttribute("viewBox");
+      const meta = readSliceMeta(loaded.doc);
+      slices = (meta && meta.slices) || [];
+      rowLabels = (meta && meta.rowLabels) || null;
+      // The model may have changed shape (slice added/removed) between loads.
+      if (activeSlice !== null && !slices.some((s) => s.index === activeSlice)) {
+        activeSlice = slices.length ? slices[0].index : null;
+      }
+      render();
+    }
+
+    // Apply reviewMode/activeSlice to the currently-loaded SVG + the control bar.
+    // Safe to call directly from UI handlers (Prev/Next/toggle/arrow keys) — it
+    // never re-reads metadata, just re-applies the cached state.
+    function render() {
+      storyboard.hidden = slices.length === 0;
+      reviewToggle.classList.toggle("active", reviewMode);
+      reviewToggle.disabled = slices.length === 0;
+      renderFilmstrip();
+
+      const loaded = currentSvgDoc();
+      if (!loaded) return;
+      const { doc, svgRoot } = loaded;
+
+      doc.querySelectorAll("[data-slice]").forEach((node) => {
+        const dim = reviewMode && activeSlice !== null &&
+          Number(node.getAttribute("data-slice")) !== activeSlice;
+        node.classList.toggle("em-slice-dim", dim);
+      });
+
+      if (!naturalViewBox) return;
+      if (!reviewMode || activeSlice === null) {
+        svgRoot.setAttribute("viewBox", naturalViewBox);
+        return;
+      }
+      const slice = slices.find((s) => s.index === activeSlice);
+      if (!slice) return;
+      const [nx, ny, nw, nh] = naturalViewBox.split(/\\s+/).map(Number);
+      const PAD = 24; // breathing room around the framed slice
+      let x0 = rowLabels ? Math.min(rowLabels.x0, slice.x0) : slice.x0;
+      let x1 = slice.x1;
+      x0 = Math.max(nx, x0 - PAD);
+      x1 = Math.min(nx + nw, x1 + PAD);
+      svgRoot.setAttribute("viewBox", x0 + " " + ny + " " + Math.max(1, x1 - x0) + " " + nh);
+    }
+
+    function renderFilmstrip() {
+      filmstrip.innerHTML = "";
+      for (const s of slices) {
+        const b = document.createElement("button");
+        b.className = "slice" + (s.index === activeSlice ? " active" : "");
+        b.textContent = s.name;
+        b.addEventListener("click", () => goTo(s.index));
+        filmstrip.appendChild(b);
+      }
+      const first = slices[0], last = slices[slices.length - 1];
+      prevBtn.disabled = activeSlice === null || !first || activeSlice <= first.index;
+      nextBtn.disabled = activeSlice === null || !last || activeSlice >= last.index;
+    }
+
+    function goTo(index) {
+      activeSlice = index;
+      render();
+    }
+
+    function step(delta) {
+      if (!slices.length) return;
+      if (activeSlice === null) { goTo(slices[0].index); return; }
+      const i = slices.findIndex((s) => s.index === activeSlice);
+      const next = slices[Math.min(slices.length - 1, Math.max(0, i + delta))];
+      if (next) goTo(next.index);
+    }
+
+    reviewToggle.addEventListener("click", () => {
+      reviewMode = !reviewMode;
+      if (reviewMode && activeSlice === null && slices.length) activeSlice = slices[0].index;
+      render();
+    });
+    prevBtn.addEventListener("click", () => step(-1));
+    nextBtn.addEventListener("click", () => step(1));
+    document.addEventListener("keydown", (e) => {
+      if (!reviewMode) return;
+      if (e.key === "ArrowLeft") step(-1);
+      else if (e.key === "ArrowRight") step(1);
+    });
+
     reload();
 
     const es = new EventSource("/__events");

package/dist/render/serve.js.map

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

package/dist/render/sliceDiagram.d.ts

@@ -0,0 +1,11 @@
+import { NormalizedModel } from "../model/model.js";
+import { Grid, LayoutOptions } from "../layout/grid.js";
+export interface SliceDiagramResult {
+    model: NormalizedModel;
+    grid: Grid;
+    dot: string;
+}
+/** 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 declare function buildSliceDiagram(model: NormalizedModel, sliceIndex: number, opts?: LayoutOptions): SliceDiagramResult;

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":"AAAA,+BAA+B;AAC/B,wEAAwE;AACxE,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,wEAAwE;AACxE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,qBAAqB;AACrB,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAmC,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAuB,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAQ9D;;gFAEgF;AAChF,MAAM,UAAU,iBAAiB,CAC/B,KAAsB,EACtB,UAAkB,EAClB,OAAsB,EAAE;IAExB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACzC,CAAC;AASD,SAAS,cAAc,CAAC,KAAsB,EAAE,UAAkB,EAAE,OAAe;IACjF,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,cAAc;YACjB,OAAO,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAClD,KAAK,YAAY;YACf,OAAO,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAChD,KAAK,YAAY,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC/C,SAAS,iBAAiB;YACxB,OAAO,CAAC,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED;;mEAEmE;AACnE,SAAS,qBAAqB,CAAC,KAAsB,EAAE,CAAS;IAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAsB,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;qCAIqC;AACrC,SAAS,mBAAmB,CAAC,KAAsB,EAAE,CAAS;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACjD,IAAI,GAAG;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;gFAKgF;AAChF,SAAS,kBAAkB,CAAC,KAAsB,EAAE,CAAS;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAsB,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;iFAIiF;AACjF,SAAS,YAAY,CAAC,OAA0B;IAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IACzD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;YACrB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,QAAQ;YAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;SAC/F,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,sBAAsB,CAAC,KAAsB,EAAE,OAA0B,EAAE,KAAa;IAC/F,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE5C,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAW,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QAC1F,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtH,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACpB,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;gBACvB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtF,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzF,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM;QACN,QAAQ;QACR,IAAI;QACJ,MAAM;QACN,+EAA+E;QAC/E,8EAA8E;QAC9E,yEAAyE;QACzE,0EAA0E;QAC1E,6EAA6E;QAC7E,MAAM,EAAE,EAAE;QACV,6EAA6E;QAC7E,6EAA6E;QAC7E,oCAAoC;QACpC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAA8B;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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;