@milehimikey/em 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 milehimikey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+# em — AI friendly event modeling
+
+`em` is a command-line tool for [Event Modeling](https://eventmodeling.org/). You write a
+model in a small, **plain-text, slice-first DSL** (`.em`) and `em` renders it to a clean,
+deterministic diagram (SVG by default, PNG on request). Because the source is just text —
+diff-able, reviewable, and unambiguous — it's as easy for an LLM to generate and edit as it
+is for a person to write by hand. Layout is a **strict grid**: swimlane rows and
+time-ordered slice columns stay perfectly aligned with no manual offsets.
+
+```
+examples/order-fulfillment.em  ->  em render  ->  order-fulfillment.svg
+```
+
+Rendering is **self-contained** — Graphviz runs as bundled WebAssembly and PNG is
+rasterized in-process, so there's nothing to `apt`/`brew` install for SVG or PNG output.
+
+## Install
+
+```bash
+npm install -g @milehimikey/em     # then `em` is on your PATH
+```
+
+Requires **Node ≥ 18**. SVG and PNG need no other tools. PDF (and other Graphviz raster
+formats) are optional and use a system `rsvg-convert` (librsvg) if one is installed.
+
+Run without installing:
+
+```bash
+npx @milehimikey/em init model.em
+npx @milehimikey/em render model.em
+```
+
+## Quickstart
+
+```bash
+em init model.em          # scaffold a starter model
+em render model.em        # -> model.svg  (open it in a browser)
+em watch model.em         # re-render on every save
+em validate model.em      # check event-modeling rules
+```
+
+A `.em` model is a list of **slices** (vertical time steps), each holding elements that fall
+into swimlane rows:
+
+```
+model "Order Fulfillment"
+
+persona Customer           # UI swimlanes (top), one row per persona
+context Order              # event swimlanes (bottom), one row per context
+context Payment
+
+slice "Browse Catalog" {           # each slice is one column (time, left -> right)
+  ui Product Catalog @Customer     # @Persona places the screen in a persona row
+  command Place Order {            # a `{ … }` block declares the element's fields
+    customerId
+    total: Money                   # optional `: Type` annotation
+  }
+  event Order Placed @Order note "notes/order-placed.md" {   # note "…" links docs
+    orderId
+    total: Money
+  }
+}
+
+slice "View Open Orders" {
+  view Open Orders from "Order Placed"   # from "<event>" wires the data flow
+  ui Order List @Customer
+}
+```
+
+## The four patterns
+
+Event Modeling is built from four patterns, all expressible as slices:
+
+| Pattern | Flow | DSL elements |
+|---|---|---|
+| **Input** (state change) | UI → command → event | `ui`, `command`, `event` |
+| **Output** (state view) | event → read model → UI | `event`, `view from "…"`, `ui` |
+| **Automation** | read model (todo) → processor → command → event | `view from "…"` + `processor`, then `command` + `event` |
+| **Translation** | external read model → translation → command → event | `view from "…"` + `translation`, then `command` + `event` |
+
+Automation/translation slices are **not** triggered by a command — they react to a read
+model (a "todo list") or a timer and *issue* a command when done. The automation slice
+contains **only** the read model it reads and the processor/translation; the command it
+triggers (and that command's event) is the **next** slice.
+
+## DSL reference
+
+### Element keywords → swimlane bands (top → bottom)
+
+0. *(header)* — each slice name is rendered as a title cell in the top row
+1. `automation` / `processor` / `saga` / `translation` — **Automation** band (only shown if used)
+2. `ui` — **persona** rows (one per `persona`)
+3. `command` + `view` — the **API** row (commands and read models share one lane)
+4. `event` — **context/concept** rows (one per `context`)
+
+Commands and read models share the **API** row, so a slice holds *either* a command *or* a
+read model. The empty API lane is dropped when a model has neither; pass `--keep-empty-lanes`
+to keep it.
+
+`@Persona` / `@Context` choose the row within a band (undeclared tags create a new row).
+`view … from "Event"[, "Event2"]` declares which events feed a read model and draws the
+data-flow arrow. Arrows within a slice are inferred from the pattern; use `arrow A -> B` for
+anything extra (e.g. a read model feeding a different screen).
+
+### Fields
+
+Any element can declare **data fields** in a `{ … }` block — the data it accepts (command),
+records (event), projects (read model), or shows (UI). Each field is `name` with an optional
+`: Type`; write one per line, or inline and comma-separated:
+
+```
+command Place Order {            # one per line
+  customerId
+  items: List<LineItem>
+  total: Money
+}
+
+event Payment Requested @Payment { orderId, amount: Money }   # inline
+```
+
+Fields render **in the box**, UML-style: the name, a divider rule, then the fields. The box
+grows to fit them (width stays fixed, so columns stay aligned), and arrows still anchor to
+the box edges so the lines stay stable. A field block coexists with `note`/`from` clauses on
+the same element. Fields are the foundation of the later event-modeling phases (the slicing /
+information-completeness process); field-level validation across slices is planned.
+
+### Notes
+
+Any element can carry `note "path.md"` (valid on every keyword). The prose lives in the
+markdown file — keeping the diagram uncluttered — and the box gets a small **numbered
+folded-corner marker** in its top-right corner. A **legend** is appended below the diagram
+mapping each number to its element and note file, so even a static export tells you which
+note belongs to which box.
+
+In **SVG** output the markers and legend rows are links; clicking one opens the markdown
+file. Links resolve relative to the **output SVG's location**, so they keep working whether
+the SVG is rendered beside the model or into another folder (as long as the notes travel
+with it). Open the SVG in a **web browser** to use the links — image viewers like macOS
+Preview/Quick Look show the markers but ignore SVG hyperlinks. Raster output (PNG/PDF) can't
+carry links — that's what the footnote numbers + legend are for.
+
+## Commands
+
+```bash
+em init [file]                        # scaffold a starter model (default: model.em)
+em render <file> [-o out.svg]         # render (format from -o extension or -T)
+em render <file> -o out.png           # PNG (in-process, no system deps)
+em render <file> --emit-dot           # print the generated DOT instead of rendering
+em render <file> --keep-empty-lanes   # don't collapse the API lane when empty
+em watch <file> [-o out.svg]          # re-render on every save
+em validate <file>                    # check event-modeling rules (non-zero exit on errors)
+```
+
+## Validation rules (`em validate`)
+
+- two same-band elements in one slice (collision) → **error** (split into separate slices)
+- a read model whose `from "Event"` doesn't exist → **error**
+- an automation/translation whose `from "<read model>"` doesn't exist → **error**
+- an `arrow` endpoint that matches no element → **error**
+- an automation/translation slice that also holds the command it triggers → **warning**
+- a command that records no event → **warning**
+- a read model with no source event → **warning**
+- a name defined more than once and referenced → **warning** (resolves to first)
+
+## Documentation
+
+- [docs/why-dot-not-plantuml.md](docs/why-dot-not-plantuml.md) — why DOT + the strict-grid /
+  self-drawn-edges architecture
+- [docs/features.md](docs/features.md) — full feature list and roadmap
+- [docs/dependencies.md](docs/dependencies.md) — how rendering works with no system deps
+
+## Development
+
+```bash
+npm install
+npm run build          # produces dist/, exposes the `em` bin
+npm test               # vitest
+npx tsx src/cli.ts <command> ...   # run straight from source
+```
+
+## License
+
+[MIT](LICENSE) © milehimikey

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { basename, dirname, extname, resolve } from "node:path";
+import { Command } from "commander";
+import { compile } from "./pipeline.js";
+import { ParseError } from "./parser/parser.js";
+import { renderDot, formatFromPath } from "./render/render.js";
+import { watchFile } from "./render/watch.js";
+import { formatDiagnostic, hasErrors } from "./model/validate.js";
+import { STARTER_EM } from "./templates.js";
+const program = new Command();
+program
+    .name("em")
+    .description("Event Modeling CLI — slice-first DSL rendered as a strict Graphviz grid")
+    .version("0.1.0");
+program
+    .command("init")
+    .description("scaffold a starter .em model")
+    .argument("[file]", "output file", "model.em")
+    .option("-f, --force", "overwrite if the file exists")
+    .action((file, opts) => {
+    if (existsSync(file) && !opts.force) {
+        console.error(`refusing to overwrite ${file} (use --force)`);
+        process.exit(1);
+    }
+    writeFileSync(file, STARTER_EM);
+    console.log(`wrote ${file}`);
+});
+program
+    .command("render")
+    .description("transpile a model and render it (or emit DOT)")
+    .argument("<file>", "input .em file")
+    .option("-o, --out <path>", "output path (extension picks the format)")
+    .option("-T, --format <fmt>", "output format (svg, png, pdf, ...)")
+    .option("--emit-dot", "print the generated DOT instead of rendering")
+    .option("--keep-empty-lanes", "keep the API lane even when empty")
+    .action(async (file, opts) => {
+    const { dot, model, diagnostics } = compileFile(file, {
+        keepEmptyLanes: opts.keepEmptyLanes,
+    });
+    printDiagnostics(diagnostics);
+    warnMissingNotes(file, model);
+    if (opts.emitDot) {
+        if (opts.out) {
+            writeFileSync(opts.out, dot);
+            console.log(`wrote ${opts.out}`);
+        }
+        else {
+            process.stdout.write(dot + "\n");
+        }
+        return;
+    }
+    if (hasErrors(diagnostics)) {
+        console.error("not rendering: fix the errors above");
+        process.exit(1);
+    }
+    const out = opts.out ?? defaultOut(file, opts.format ?? "svg");
+    const fmt = opts.format ?? formatFromPath(out);
+    await renderDot(dot, model, out, fmt, dirname(file));
+    console.log(`rendered ${out}`);
+});
+program
+    .command("watch")
+    .description("re-render on every save")
+    .argument("<file>", "input .em file")
+    .option("-o, --out <path>", "output path (extension picks the format)")
+    .option("-T, --format <fmt>", "output format (svg, png, pdf, ...)")
+    .option("--keep-empty-lanes", "keep the API lane even when empty")
+    .action(async (file, opts) => {
+    const out = opts.out ?? defaultOut(file, opts.format ?? "svg");
+    const fmt = opts.format ?? formatFromPath(out);
+    const build = async () => {
+        const started = Date.now();
+        try {
+            const { dot, model, diagnostics } = compileFile(file, {
+                keepEmptyLanes: opts.keepEmptyLanes,
+            });
+            printDiagnostics(diagnostics);
+            warnMissingNotes(file, model);
+            if (hasErrors(diagnostics)) {
+                console.error("skipped render (errors above)");
+                return;
+            }
+            await renderDot(dot, model, out, fmt, dirname(file));
+            console.log(`rendered ${out} (${Date.now() - started}ms)`);
+        }
+        catch (e) {
+            reportError(e);
+        }
+    };
+    await build();
+    watchFile(file, build);
+    console.log(`watching ${file} … (ctrl-c to stop)`);
+});
+program
+    .command("validate")
+    .description("check a model against event-modeling rules")
+    .argument("<file>", "input .em file")
+    .action((file) => {
+    const { diagnostics } = compileFile(file);
+    printDiagnostics(diagnostics);
+    if (hasErrors(diagnostics))
+        process.exit(1);
+    if (diagnostics.length === 0)
+        console.log("ok — no issues");
+});
+program.parseAsync().catch((e) => {
+    reportError(e);
+    process.exit(1);
+});
+// ---- helpers ----
+function compileFile(file, opts = {}) {
+    let source;
+    try {
+        source = readFileSync(file, "utf8");
+    }
+    catch {
+        console.error(`cannot read ${file}`);
+        process.exit(1);
+    }
+    try {
+        return compile(source, opts);
+    }
+    catch (e) {
+        if (e instanceof ParseError) {
+            console.error(`parse error in ${file} ${e.message}`);
+            process.exit(1);
+        }
+        throw e;
+    }
+}
+function defaultOut(file, fmt) {
+    const base = basename(file, extname(file));
+    return `${base}.${fmt}`;
+}
+/** Warn (without failing) when an element's `note` file can't be found. */
+function warnMissingNotes(file, model) {
+    const base = dirname(file);
+    for (const el of model.elements) {
+        if (el.note && !existsSync(resolve(base, el.note))) {
+            console.warn(`  warn  note file not found for "${el.name}": ${el.note}`);
+        }
+    }
+}
+function printDiagnostics(diags) {
+    if (diags.length === 0)
+        return;
+    for (const d of diags) {
+        const line = formatDiagnostic(d);
+        if (d.severity === "error")
+            console.error(line);
+        else
+            console.warn(line);
+    }
+}
+function reportError(e) {
+    console.error(e instanceof Error ? e.message : String(e));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/emit/dot.d.ts

@@ -0,0 +1,3 @@
+import { NormalizedModel } from "../model/model.js";
+import { Grid } from "../layout/grid.js";
+export declare function emitDot(model: NormalizedModel, grid: Grid): string;

package/dist/emit/dot.js

@@ -0,0 +1,150 @@
+// SPDX-License-Identifier: MIT
+// Emits Graphviz DOT for a normalized model using the strict-grid technique:
+//   - one heavily-weighted invisible vertical edge chain per column locks columns
+//   - one `rank=same` group per row locks rows and orders cells left -> right
+//   - a fixed-width title cell per slice anchors the column widths
+//   - empty coordinates are invisible spacers; elements are floating boxes
+//
+// No semantic arrows are emitted here: Graphviz only lays out the grid and
+// renders the boxes/labels. The renderer reads each box's rectangle back out of
+// the rendered SVG and draws the arrows itself (see src/render/drawEdges.ts), so
+// it has full control over straight within-slice lines and curved cross-slice
+// lines instead of fighting Graphviz's global edge router.
+import { headerCellId, nodeIdAt, placeholderId } from "../layout/grid.js";
+import { styleFor } from "./theme.js";
+const HEADER_FILL = "#E3E7EB";
+const HEADER_BORDER = "#C7CDD4";
+// Every cell is the same width so columns are evenly spaced and the header row
+// lines up with the element columns. Header width (pt) must match CELL_W (in).
+const CELL_W = 2.0; // inches
+const CELL_H = 0.62;
+const HEADER_H = 0.46;
+export function emitDot(model, grid) {
+    const L = [];
+    L.push(`digraph EventModel {`);
+    L.push(`  graph [rankdir=TB, splines=false, nodesep=0.35, ranksep="0.5 equally", ` +
+        `fontname="Helvetica", fontsize=18, labelloc="t", label=${q(model.name)}];`);
+    L.push(`  node [shape=box, style="filled", fontname="Helvetica", fontsize=11, ` +
+        `margin="0.18,0.10", penwidth=1.3];`);
+    L.push(`  edge [fontname="Helvetica", fontsize=9];`);
+    L.push("");
+    // ---- row label nodes (leftmost column) ----
+    L.push("  // row (swimlane) labels");
+    grid.rows.forEach((row, r) => {
+        L.push(`  ${rowLabelId(r)} [shape=plaintext, style="", label=${q(row.label)}, ` +
+            `fontsize=10, fontcolor="#5F6368"];`);
+    });
+    L.push("");
+    // ---- cell nodes ----
+    L.push("  // cells");
+    grid.rows.forEach((row, r) => {
+        for (let c = 0; c < grid.cols; c++) {
+            if (row.band === "header") {
+                L.push("  " + headerCell(c, grid.sliceNames[c]));
+            }
+            else {
+                const el = grid.cells[r][c];
+                L.push("  " + (el ? elementCell(el) : emptyCell(r, c)));
+            }
+        }
+    });
+    L.push("");
+    // ---- rigid grid: weighted invisible vertical chains per column ----
+    L.push("  // column locks");
+    L.push(`  edge [style=invis, weight=1000, arrowhead=none];`);
+    L.push("  " + columnChain(grid, -1) + ";"); // label column
+    for (let c = 0; c < grid.cols; c++) {
+        L.push("  " + columnChain(grid, c) + ";");
+    }
+    L.push("");
+    // ---- rows: rank=same + left-right ordering ----
+    L.push("  // row ranks");
+    grid.rows.forEach((_row, r) => {
+        const ids = [rowLabelId(r)];
+        for (let c = 0; c < grid.cols; c++)
+            ids.push(nodeIdAt(grid, r, c));
+        L.push(`  { rank=same; ${ids.join(" -> ")} [style=invis, arrowhead=none]; }`);
+    });
+    L.push(`}`);
+    return L.join("\n");
+}
+function elementCell(el) {
+    const s = styleFor(el.kind);
+    const shape = el.kind === "ui" ? `"filled"` : `"filled,rounded"`;
+    if (el.fields && el.fields.length > 0) {
+        // UML-style box: title, a divider rule, then the fields. The HTML table
+        // auto-sizes the box (height grows with the field count); width stays at
+        // CELL_W as a minimum so columns stay aligned. Arrows still anchor to the
+        // box edges read back from the SVG, so they remain stable.
+        return (`${el.id} [label=${fieldLabel(el)}, fillcolor="${s.fill}", ` +
+            `color="${s.stroke}", fontcolor="${s.fontColor}", style=${shape}, ` +
+            `shape=box, fixedsize=false, width=${CELL_W}, margin="0.04,0.03"];`);
+    }
+    return (`${el.id} [label=${q(wrapLabel(el.name))}, fillcolor="${s.fill}", ` +
+        `color="${s.stroke}", fontcolor="${s.fontColor}", style=${shape}, ` +
+        `fixedsize=true, width=${CELL_W}, height=${CELL_H}];`);
+}
+/** Graphviz HTML-table label: bold title, a horizontal rule, one row per field. */
+function fieldLabel(el) {
+    const rows = [];
+    rows.push(`<TR><TD><B>${esc(el.name)}</B></TD></TR>`);
+    rows.push(`<HR/>`);
+    for (const f of el.fields ?? []) {
+        const ftype = f.type ? ` : <FONT COLOR="#5F6368">${esc(f.type)}</FONT>` : "";
+        rows.push(`<TR><TD ALIGN="LEFT"><FONT POINT-SIZE="9">${esc(f.name)}${ftype}</FONT></TD></TR>`);
+    }
+    return (`<<TABLE BORDER="0" CELLBORDER="0" CELLSPACING="0" CELLPADDING="1">` +
+        rows.join("") +
+        `</TABLE>>`);
+}
+/** Escape text for use inside a Graphviz HTML-like label. */
+function esc(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/** Empty cells are invisible spacers that hold the column width and row height. */
+function emptyCell(r, c) {
+    return `${placeholderId(r, c)} [label="", style=invis, fixedsize=true, width=${CELL_W}, height=${CELL_H}];`;
+}
+/** Fixed-size title cell per slice (same width as cells, so columns line up). */
+function headerCell(c, name) {
+    return (`${headerCellId(c)} [label=${q(wrapLabel(name, 20))}, shape=box, ` +
+        `style=filled, fillcolor="${HEADER_FILL}", color="${HEADER_BORDER}", ` +
+        `fontcolor="#1F2933", fontname="Helvetica-Bold", fontsize=10, ` +
+        `fixedsize=true, width=${CELL_W}, height=${HEADER_H}, penwidth=1];`);
+}
+function columnChain(grid, col) {
+    const ids = [];
+    grid.rows.forEach((_row, r) => {
+        ids.push(col < 0 ? rowLabelId(r) : nodeIdAt(grid, r, col));
+    });
+    return ids.join(" -> ");
+}
+function rowLabelId(r) {
+    return `__row_${r}`;
+}
+/** Word-wrap long labels onto multiple lines for tidier boxes. */
+function wrapLabel(name, max = 18) {
+    return wrap(name, max).join("\\n");
+}
+function wrap(name, max) {
+    const words = name.split(/\s+/);
+    const lines = [];
+    let cur = "";
+    for (const w of words) {
+        if (cur && (cur + " " + w).length > max) {
+            lines.push(cur);
+            cur = w;
+        }
+        else {
+            cur = cur ? cur + " " + w : w;
+        }
+    }
+    if (cur)
+        lines.push(cur);
+    return lines;
+}
+/** Quote a string for DOT (label newlines already encoded as \n). */
+function q(s) {
+    return `"${s.replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=dot.js.map

package/dist/emit/dot.js.map

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

package/dist/emit/theme.d.ts

@@ -0,0 +1,9 @@
+import { ElementKind } from "../parser/ast.js";
+export interface NodeStyle {
+    fill: string;
+    stroke: string;
+    fontColor: string;
+}
+export declare function styleFor(kind: ElementKind): NodeStyle;
+/** Arrow colour keyed on the source element's kind. */
+export declare function edgeColorFor(kind: ElementKind | undefined): string;

package/dist/emit/theme.js

@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: MIT
+// Event Modeling colour conventions.
+const STYLES = {
+    ui: { fill: "#FFFFFF", stroke: "#9AA0A6", fontColor: "#202124" },
+    command: { fill: "#B8D0F5", stroke: "#2B6CB0", fontColor: "#10243E" },
+    view: { fill: "#C6E7C6", stroke: "#2F855A", fontColor: "#173F25" },
+    event: { fill: "#F6B26B", stroke: "#B7791F", fontColor: "#3F2A06" },
+    automation: { fill: "#DBDBDB", stroke: "#5F6368", fontColor: "#202124" },
+    processor: { fill: "#DBDBDB", stroke: "#5F6368", fontColor: "#202124" },
+    saga: { fill: "#DBDBDB", stroke: "#5F6368", fontColor: "#202124" },
+    translation: { fill: "#E4D5F7", stroke: "#6B46C1", fontColor: "#2A1A4A" },
+};
+export function styleFor(kind) {
+    return STYLES[kind];
+}
+/** Arrow colour keyed on the source element's kind. */
+export function edgeColorFor(kind) {
+    switch (kind) {
+        case "command":
+            return "#2B6CB0";
+        case "view":
+            return "#2F855A";
+        case "event":
+            return "#B7791F";
+        case "automation":
+        case "processor":
+        case "saga":
+            return "#5F6368";
+        case "translation":
+            return "#6B46C1";
+        default:
+            return "#3C4043";
+    }
+}
+//# sourceMappingURL=theme.js.map

package/dist/emit/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/emit/theme.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,qCAAqC;AAUrC,MAAM,MAAM,GAAmC;IAC7C,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IAChE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IACrE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IAClE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IACnE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IACxE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IACvE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;IAClE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE;CAC1E,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAiB;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,IAA6B;IACxD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,SAAS,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,WAAW,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,aAAa;YAChB,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/layout/grid.d.ts

@@ -0,0 +1,33 @@
+import { Element, NormalizedModel } from "../model/model.js";
+export type Band = "header" | "automation" | "ui" | "api" | "event";
+export declare const HEADER_KEY = "__header";
+export interface GridRow {
+    key: string;
+    label: string;
+    band: Band;
+}
+export interface Collision {
+    rowKey: string;
+    col: number;
+    kept: Element;
+    dropped: Element;
+}
+export interface Grid {
+    rows: GridRow[];
+    cols: number;
+    /** Slice names, one per column (rendered in the header row). */
+    sliceNames: string[];
+    /** cells[rowIndex][colIndex] — real element or null (placeholder/header). */
+    cells: (Element | null)[][];
+    rowIndexByKey: Map<string, number>;
+    collisions: Collision[];
+}
+export interface LayoutOptions {
+    /** Keep the structural command/view rows even when empty. */
+    keepEmptyLanes?: boolean;
+}
+export declare function placeholderId(row: number, col: number): string;
+export declare function headerCellId(col: number): string;
+/** Node id at a grid coordinate (header cell, element, or placeholder). */
+export declare function nodeIdAt(grid: Grid, row: number, col: number): string;
+export declare function layout(model: NormalizedModel, opts?: LayoutOptions): Grid;