@milehimikey/em 1.5.0 → 1.6.0

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;

package/dist/render/svgGeometry.js

@@ -5,8 +5,11 @@
 // with coordinates in the same 1:1 user space we later inject our edges into, so
 // the numbers can be used directly. We take the bounding box of the first shape
 // in each node group.
-const NODE_GROUP = /<g\b[^>]*class="node"[^>]*>([\s\S]*?)<\/g>/g;
-const TITLE = /<title>([\s\S]*?)<\/title>/;
+// Exported: sliceOverlay.ts is a second consumer, tagging/reading these same
+// node groups for the storyboard viewer's slice overlay — share the pattern
+// rather than let it drift into a second copy.
+export const NODE_GROUP = /<g\b[^>]*class="node"[^>]*>([\s\S]*?)<\/g>/g;
+export const TITLE = /<title>([\s\S]*?)<\/title>/;
 const SHAPE = /<(?:polygon|path)\b[^>]*\b(?:points|d)="([^"]*)"/;
 const NUM = /-?\d*\.?\d+(?:e-?\d+)?/gi;
 /** Map each requested node id to its rectangle in SVG coordinates. */
@@ -37,6 +40,24 @@ export function parseNodeRects(svg, ids) {
     }
     return rects;
 }
+/**
+ * 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 function readGraphTransform(svg) {
+    const tf = /<g\b[^>]*class="graph"[^>]*transform="([^"]*)"/.exec(svg)?.[1] ?? "";
+    const sc = /scale\(([\d.eE+-]+)[\s,]+([\d.eE+-]+)\)/.exec(tf);
+    const tr = /translate\(([\d.eE+-]+)[\s,]+([\d.eE+-]+)\)/.exec(tf);
+    const [sx, sy] = sc ? [+sc[1], +sc[2]] : [1, 1];
+    const [tx, ty] = tr ? [+tr[1], +tr[2]] : [0, 0];
+    return { sx, sy, tx, ty, toRoot: (x, y) => ({ x: sx * (x + tx), y: sy * (y + ty) }) };
+}
 const FIT_PAD = 10; // breathing room, and enough for an arrowhead at the boundary
 /**
  * Grow the canvas so content drawn in graph space isn't clipped by the root viewBox.
@@ -51,23 +72,19 @@ export function fitCanvas(svg, box) {
     const hpt = /height="([\d.eE+-]+)pt"/.exec(svg);
     if (!vb || !wpt || !hpt)
         return svg; // can't resize safely — leave it alone
-    // 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).
-    const tf = /<g\b[^>]*class="graph"[^>]*transform="([^"]*)"/.exec(svg)?.[1] ?? "";
-    const sc = /scale\(([\d.eE+-]+)[\s,]+([\d.eE+-]+)\)/.exec(tf);
-    const tr = /translate\(([\d.eE+-]+)[\s,]+([\d.eE+-]+)\)/.exec(tf);
-    const [sx, sy] = sc ? [+sc[1], +sc[2]] : [1, 1];
-    const [tx, ty] = tr ? [+tr[1], +tr[2]] : [0, 0];
+    const { toRoot } = readGraphTransform(svg);
     const minX = +vb[1];
     const minY = +vb[2];
     const vw = +vb[3];
     const vh = +vb[4];
     if (vw <= 0 || vh <= 0)
         return svg;
-    const x0 = Math.min(sx * (box.minX + tx), sx * (box.maxX + tx));
-    const x1 = Math.max(sx * (box.minX + tx), sx * (box.maxX + tx));
-    const y0 = Math.min(sy * (box.minY + ty), sy * (box.maxY + ty));
-    const y1 = Math.max(sy * (box.minY + ty), sy * (box.maxY + ty));
+    const corner0 = toRoot(box.minX, box.minY);
+    const corner1 = toRoot(box.maxX, box.maxY);
+    const x0 = Math.min(corner0.x, corner1.x);
+    const x1 = Math.max(corner0.x, corner1.x);
+    const y0 = Math.min(corner0.y, corner1.y);
+    const y1 = Math.max(corner0.y, corner1.y);
     const left = Math.min(minX, Math.floor(x0 - FIT_PAD));
     const top = Math.min(minY, Math.floor(y0 - FIT_PAD));
     const right = Math.max(minX + vw, Math.ceil(x1 + FIT_PAD));
@@ -84,7 +101,9 @@ export function fitCanvas(svg, box) {
 function round(v) {
     return Math.round(v * 100) / 100;
 }
-function decode(s) {
+/** 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 function decode(s) {
     return s
         .replace(/&lt;/g, "<")
         .replace(/&gt;/g, ">")

package/dist/render/svgGeometry.js.map

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

package/dist/render/watch.d.ts

@@ -1,2 +1,2 @@
 import chokidar from "chokidar";
-export declare function watchFile(file: string, onChange: () => void | Promise<void>, debounceMs?: number): chokidar.FSWatcher;
+export declare function watchFile(paths: string | string[], onChange: () => void | Promise<void>, debounceMs?: number): chokidar.FSWatcher;

package/dist/render/watch.js

@@ -1,8 +1,11 @@
 // SPDX-License-Identifier: MIT
 // Debounced file watcher for `em watch`.
 import chokidar from "chokidar";
-export function watchFile(file, onChange, debounceMs = 80) {
-    const watcher = chokidar.watch(file, { ignoreInitial: true });
+export function watchFile(paths, onChange, debounceMs = 80) {
+    // A glob path (e.g. a slices/*.md pattern) picks up files created after the
+    // watcher starts, not just ones that already exist — needed so authoring a
+    // slice's first design doc mid-session still triggers a re-render.
+    const watcher = chokidar.watch(paths, { ignoreInitial: true });
     let timer = null;
     const trigger = () => {
         if (timer)

package/dist/render/watch.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/render/watch.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,yCAAyC;AAEzC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,QAAoC,EACpC,UAAU,GAAG,EAAE;IAEf,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,QAAQ,EAAE,CAAC;QAClB,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/render/watch.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,yCAAyC;AAEzC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,UAAU,SAAS,CACvB,KAAwB,EACxB,QAAoC,EACpC,UAAU,GAAG,EAAE;IAEf,4EAA4E;IAC5E,2EAA2E;IAC3E,mEAAmE;IACnE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,QAAQ,EAAE,CAAC;QAClB,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milehimikey/em",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "AI-friendly Event Modeling — a slice-first text DSL rendered to a strict, self-contained Graphviz grid (SVG/PNG)",
   "type": "module",
   "bin": {
@@ -52,7 +52,8 @@
     "@hpcc-js/wasm-graphviz": "^1.22.0",
     "@resvg/resvg-js": "^2.6.2",
     "chokidar": "^3.6.0",
-    "commander": "^12.1.0"
+    "commander": "^12.1.0",
+    "marked": "^18.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",