@milehimikey/em 1.4.0 → 1.6.0

package/dist/catalog/pages.js

@@ -0,0 +1,174 @@
+// SPDX-License-Identifier: MIT
+// HTML-string builders for `em catalog`'s static site: an index page and one
+// per-slice detail page. Hand-written template literals, no templating
+// library — same convention as the live-viewer page in
+// src/render/serve.ts's VIEWER_HTML, just as functions instead of one static
+// template, since these pages vary per model/slice.
+import { slicePatternLabel } from "./classify.js";
+export function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+/** Human-readable status cell: "no doc" (nothing found), "unknown" (doc found, no Status
+ *  line), or the doc's own Status value verbatim. Shared by the index and slice pages so the
+ *  two never drift out of sync on how a missing/freeform doc reads. */
+function statusLabel(hasDoc, status) {
+    if (!hasDoc)
+        return "no doc";
+    if (!status)
+        return "unknown";
+    return status;
+}
+/** MIME type for the diagram `<object>` — must match the actual file `buildCatalog` wrote
+ *  (`diagram.svg` or `diagram.png`), or the browser won't render it. */
+function diagramMimeType(format) {
+    return format === "png" ? "image/png" : "image/svg+xml";
+}
+/** `homeHref` is relative to the page being built (`index.html` from the index page itself,
+ *  `../../index.html` from a slice page two levels down) so the site works opened straight
+ *  off disk via `file://`, with no server — an absolute `href="/"` would jump to the
+ *  filesystem root instead. */
+function layout(title, bodyHtml, homeHref) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <title>${escapeHtml(title)}</title>
+  <style>
+    :root { color-scheme: light dark; }
+    body {
+      margin: 0; font-family: system-ui, sans-serif; line-height: 1.5;
+      background: #fafafa; color: #1f2933;
+    }
+    header {
+      padding: .75rem 1.25rem; background: #1f2933; color: #fff;
+    }
+    header a { color: #fff; text-decoration: none; }
+    main { max-width: 960px; margin: 0 auto; padding: 1.5rem 1.25rem 3rem; }
+    table { border-collapse: collapse; width: 100%; margin: 1rem 0; }
+    th, td { text-align: left; padding: .4rem .6rem; border-bottom: 1px solid #ddd; font-size: 14px; }
+    th { font-weight: 600; background: #f0f2f5; }
+    .status { display: inline-block; padding: .1rem .5rem; border-radius: 999px; font-size: 12px; background: #e4e7eb; }
+    .pattern { font-size: 12px; color: #52606d; }
+    /* Fixed-height frame, not a width-driven one: a slice diagram is often
+       narrow and tall relative to the full model's wide/short diagram, so
+       sizing by width alone would blow a narrow one's height up hugely.
+       object-fit doesn't apply to <object> the way it does <img> (needed here,
+       not <img>, so the SVG's clickable note links keep working) — giving it a
+       DEFINITE width AND height together stretches it non-uniformly, distorting
+       the aspect ratio instead of preserving it. width:auto + height:100% +
+       max-width:100% instead sizes it from its own intrinsic aspect ratio
+       (capped, never overflowing the frame); the flex centers it horizontally. */
+    .diagram-frame {
+      height: 420px; border: 1px solid #ddd; margin: 1rem 0; overflow: hidden; background: #fff;
+      display: flex; align-items: flex-start; justify-content: center;
+    }
+    object.diagram { width: auto; height: 100%; max-width: 100%; }
+    .full-diagram-link { margin: 0 0 1rem; font-size: 13px; }
+    .doc { margin-top: 1.5rem; padding-top: 1rem; border-top: 1px solid #ddd; }
+    .doc h1 { font-size: 1.3rem; }
+    .doc h2 { font-size: 1.05rem; }
+    .no-doc { color: #7b8794; font-style: italic; }
+    code { background: #eee; padding: .05rem .3rem; border-radius: 3px; }
+  </style>
+</head>
+<body>
+  <header><a href="${escapeHtml(homeHref)}">Event Model Catalog</a></header>
+  <main>
+${bodyHtml}
+  </main>
+</body>
+</html>
+`;
+}
+export function renderIndexPage(models, title, format) {
+    const sections = models
+        .map((m) => {
+        const rows = m.slices
+            .map((s) => `      <tr>
+        <td><a href="${escapeHtml(m.key)}/slices/${escapeHtml(s.key)}.html">${escapeHtml(s.name)}</a></td>
+        <td class="pattern">${escapeHtml(slicePatternLabel(s.pattern))}</td>
+        <td><span class="status">${escapeHtml(statusLabel(s.hasDoc, s.status))}</span></td>
+      </tr>`)
+            .join("\n");
+        const diagramHref = `${escapeHtml(m.key)}/${escapeHtml(m.diagramFile)}`;
+        return `    <section>
+      <h2>${escapeHtml(m.name)}</h2>
+      <p>${m.slices.length} slice${m.slices.length === 1 ? "" : "s"} · <code>${escapeHtml(m.file)}</code> · <a href="${diagramHref}">open diagram full-size</a></p>
+      <div class="diagram-frame"><object class="diagram" type="${diagramMimeType(format)}" data="${diagramHref}"></object></div>
+      <table>
+        <thead><tr><th>Slice</th><th>Pattern</th><th>Status</th></tr></thead>
+        <tbody>
+${rows}
+        </tbody>
+      </table>
+    </section>`;
+    })
+        .join("\n");
+    return layout(title, `    <h1>${escapeHtml(title)}</h1>
+${sections}`, "index.html");
+}
+function formatFields(el) {
+    if (!el.fields || el.fields.length === 0)
+        return "";
+    return el.fields.map((f) => (f.type ? `${f.name}: ${f.type}` : f.name)).join(", ");
+}
+function elementDetail(el) {
+    const parts = [];
+    if (el.persona)
+        parts.push(`@${el.persona}`);
+    if (el.context)
+        parts.push(`@${el.context}`);
+    if (el.from && el.from.length > 0)
+        parts.push(`from ${el.from.join(", ")}`);
+    if (el.again)
+        parts.push("again");
+    if (el.public)
+        parts.push("public");
+    const fields = formatFields(el);
+    if (fields)
+        parts.push(`{ ${fields} }`);
+    return parts.map(escapeHtml).join(" &middot; ");
+}
+function renderElementsTable(slice, elementRefs) {
+    const rows = slice.elements
+        .map((el) => {
+        const ref = elementRefs.get(el.id);
+        const anchor = ref ? ` id="${escapeHtml(ref)}"` : "";
+        const annotations = [];
+        if (el.issue)
+            annotations.push(`<div><span class="status">issue</span> ${escapeHtml(el.issue)}</div>`);
+        if (el.divergence)
+            annotations.push(`<div><span class="status">divergence</span> ${escapeHtml(el.divergence)}</div>`);
+        return `      <tr${anchor}>
+        <td>${escapeHtml(el.kind)}</td>
+        <td>${escapeHtml(el.name)}</td>
+        <td>${elementDetail(el)}${annotations.join("")}</td>
+      </tr>`;
+    })
+        .join("\n");
+    return `    <table>
+      <thead><tr><th>Kind</th><th>Name</th><th>Detail</th></tr></thead>
+      <tbody>
+${rows}
+      </tbody>
+    </table>`;
+}
+export function renderSlicePage(args) {
+    const { modelName, diagramFile, sliceDiagramFile, slice, pattern, elementRefs, doc, docExpectedPath } = args;
+    const docSection = doc
+        ? `    <div class="doc">${doc.html}</div>`
+        : `    <p class="no-doc">No slice doc found at <code>${escapeHtml(docExpectedPath)}</code>.</p>`;
+    return layout(`${slice.name} — ${modelName}`, `    <p><a href="../../index.html">&larr; ${escapeHtml(modelName)}</a></p>
+    <h1>${escapeHtml(slice.name)}</h1>
+    <p class="pattern">${escapeHtml(slicePatternLabel(pattern))} · <span class="status">${escapeHtml(statusLabel(!!doc, doc?.status ?? null))}</span></p>
+    <div class="diagram-frame"><object class="diagram" type="image/svg+xml" data="${escapeHtml(sliceDiagramFile)}"></object></div>
+    <p class="full-diagram-link"><a href="${escapeHtml(diagramFile)}">View full model diagram &rarr;</a></p>
+${renderElementsTable(slice, elementRefs)}
+${docSection}`, "../../index.html");
+}
+//# sourceMappingURL=pages.js.map

package/dist/catalog/pages.js.map

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

package/dist/catalog/sliceDoc.d.ts

@@ -0,0 +1,10 @@
+export interface SliceDoc {
+    /** The doc's raw markdown, as read from disk. */
+    raw: string;
+    /** Lowercased value of the doc's `- **Status:** ...` line, or null if no such line is found
+     *  (a freeform doc that doesn't follow the slice.md template). */
+    status: string | null;
+    /** The whole doc rendered to HTML. */
+    html: string;
+}
+export declare function parseSliceDoc(markdown: string): SliceDoc;

package/dist/catalog/sliceDoc.js

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: MIT
+// Parses a slice design doc (slices/<slice-name>.md, see
+// .claude/skills/event-modeling/templates/slice.md) for `em catalog`. `em`
+// has never parsed this markdown structurally before — it only checked the
+// file exists (cli.ts's warnMissingNotes). This is deliberately shallow: pull
+// the one bold-label line the index page needs (`- **Status:** ...`) with a
+// regex rather than a full frontmatter parser, and render the whole doc body
+// as HTML for the per-slice detail page. Pure — no fs access; the caller
+// reads the file and hands us its text.
+import { marked } from "marked";
+const STATUS_LINE = /^-\s*\*\*Status:\*\*\s*(.+?)\s*$/im;
+export function parseSliceDoc(markdown) {
+    const match = markdown.match(STATUS_LINE);
+    return {
+        raw: markdown,
+        status: match ? match[1].trim().toLowerCase() : null,
+        html: marked.parse(markdown, { async: false }),
+    };
+}
+//# sourceMappingURL=sliceDoc.js.map

package/dist/catalog/sliceDoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliceDoc.js","sourceRoot":"","sources":["../../src/catalog/sliceDoc.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,yDAAyD;AACzD,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,wCAAwC;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAYhC,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1C,OAAO;QACL,GAAG,EAAE,QAAQ;QACb,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QACpD,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAW;KACzD,CAAC;AACJ,CAAC"}

package/dist/cli/catalog-inputs.d.ts

@@ -0,0 +1,16 @@
+/** Resolved `em catalog` flag validation, or a user-facing `error`. */
+export type CatalogPlan = {
+    error: string;
+} | {
+    ok: true;
+    format: "svg" | "png";
+};
+/**
+ * Validate the `em catalog` `--format` flag. Pure — no I/O. Only svg/png are
+ * accepted: the per-slice page embeds the diagram in an `<object>`/`<img>`,
+ * which needs a format a browser can render directly — pdf (and any other
+ * rsvg-convert-only format) is out of scope for a static browsable site.
+ */
+export declare function planCatalogArgs(opts: {
+    format?: string;
+}): CatalogPlan;

package/dist/cli/catalog-inputs.js

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: MIT
+// Testable input handling for `em catalog`: --format validation, factored
+// out of cli.ts so it's unit-testable without spawning a subprocess (mirrors
+// src/cli/glossary-inputs.ts's planGlossaryArgs shape).
+/**
+ * Validate the `em catalog` `--format` flag. Pure — no I/O. Only svg/png are
+ * accepted: the per-slice page embeds the diagram in an `<object>`/`<img>`,
+ * which needs a format a browser can render directly — pdf (and any other
+ * rsvg-convert-only format) is out of scope for a static browsable site.
+ */
+export function planCatalogArgs(opts) {
+    const format = opts.format ?? "svg";
+    if (format !== "svg" && format !== "png") {
+        return { error: `em catalog: unsupported --format '${format}' (catalog diagrams support svg or png only)` };
+    }
+    return { ok: true, format };
+}
+//# sourceMappingURL=catalog-inputs.js.map

package/dist/cli/catalog-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-inputs.js","sourceRoot":"","sources":["../../src/cli/catalog-inputs.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,0EAA0E;AAC1E,6EAA6E;AAC7E,wDAAwD;AAKxD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IACpC,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,qCAAqC,MAAM,8CAA8C,EAAE,CAAC;IAC9G,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/cli/glossary-inputs.d.ts

@@ -0,0 +1,15 @@
+/** Resolved `em glossary` flag validation, or a user-facing `error`. */
+export type GlossaryPlan = {
+    error: string;
+} | {
+    ok: true;
+};
+/**
+ * Validate the `em glossary` flag combination. Pure — no I/O. `-o` only makes
+ * sense alongside `--json`: there's no JSON document to write from the text
+ * report, so the combination is a usage error rather than a silent no-op.
+ */
+export declare function planGlossaryArgs(opts: {
+    json?: boolean;
+    out?: string;
+}): GlossaryPlan;

package/dist/cli/glossary-inputs.js

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: MIT
+// Testable input handling for `em glossary`: flag-combination validation,
+// factored out of cli.ts so it's unit-testable without spawning a subprocess
+// (cli.ts keeps the process.exit/console wiring; see test/glossary-inputs.test.ts).
+// Mirrors src/cli/diff-inputs.ts's planDiffArgs shape for the same reason.
+/**
+ * Validate the `em glossary` flag combination. Pure — no I/O. `-o` only makes
+ * sense alongside `--json`: there's no JSON document to write from the text
+ * report, so the combination is a usage error rather than a silent no-op.
+ */
+export function planGlossaryArgs(opts) {
+    if (opts.out && !opts.json) {
+        return { error: "em glossary: -o requires --json (there's no file to write from the text report)" };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=glossary-inputs.js.map

package/dist/cli/glossary-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary-inputs.js","sourceRoot":"","sources":["../../src/cli/glossary-inputs.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,0EAA0E;AAC1E,6EAA6E;AAC7E,oFAAoF;AACpF,2EAA2E;AAK3E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAsC;IACrE,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,iFAAiF,EAAE,CAAC;IACtG,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/cli/render-inputs.d.ts

@@ -0,0 +1,27 @@
+import { Slice } from "../model/model.js";
+export type SliceLookup = {
+    index: number;
+} | {
+    error: string;
+};
+/**
+ * Resolve `--slice <name>` against the compiled model's slices: an exact,
+ * case-sensitive match against `Slice.name` — not a fuzzy namespace. On no
+ * match, lists every valid slice name in declaration order so a typo is
+ * correctable without opening the .em file.
+ *
+ * Note this is a *different* identity than `em export`/`em catalog`'s
+ * deduped `sliceKey` (kebab-slug + `~2`/`~3` suffix for repeated names) —
+ * `findIndex` here always returns the *first* slice with a given name, so two
+ * identically-named slices can't be disambiguated via `--slice` at all today.
+ * Rare in practice (duplicate slice names are themselves a validation
+ * warning), and not worth a key-based `--slice` syntax until it's a real
+ * complaint — flagging here rather than silently.
+ */
+export declare function resolveSliceArg(name: string, slices: Slice[]): SliceLookup;
+/**
+ * Default output path for a slice diagram: slices/<kebab-slug>.svg next to the
+ * .em file — the same slices/ + kebabSlug convention em catalog's sibling-file
+ * lookup and the event-modeling skill's slice-doc path already use.
+ */
+export declare function defaultSliceOut(file: string, sliceName: string): string;

package/dist/cli/render-inputs.js

@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: MIT
+// Testable input handling for `em render --slice`: slice-name resolution and
+// its default output path, factored out of cli.ts so they're unit-testable
+// without spawning a subprocess (mirrors src/cli/catalog-inputs.ts's shape).
+// Unlike planCatalogArgs's pre-file --format check, resolving a slice name
+// needs the compiled model, so this isn't a pre-file plan*Args gate — it's
+// called from the render action after compileFile().
+import { dirname, join } from "node:path";
+import { kebabSlug } from "../util/slug.js";
+/**
+ * Resolve `--slice <name>` against the compiled model's slices: an exact,
+ * case-sensitive match against `Slice.name` — not a fuzzy namespace. On no
+ * match, lists every valid slice name in declaration order so a typo is
+ * correctable without opening the .em file.
+ *
+ * Note this is a *different* identity than `em export`/`em catalog`'s
+ * deduped `sliceKey` (kebab-slug + `~2`/`~3` suffix for repeated names) —
+ * `findIndex` here always returns the *first* slice with a given name, so two
+ * identically-named slices can't be disambiguated via `--slice` at all today.
+ * Rare in practice (duplicate slice names are themselves a validation
+ * warning), and not worth a key-based `--slice` syntax until it's a real
+ * complaint — flagging here rather than silently.
+ */
+export function resolveSliceArg(name, slices) {
+    const index = slices.findIndex((s) => s.name === name);
+    if (index >= 0)
+        return { index };
+    const names = slices.map((s) => `"${s.name}"`).join(", ");
+    return {
+        error: `em render: no slice named "${name}" — valid slices: ${names || "(model has no slices)"}`,
+    };
+}
+/**
+ * Default output path for a slice diagram: slices/<kebab-slug>.svg next to the
+ * .em file — the same slices/ + kebabSlug convention em catalog's sibling-file
+ * lookup and the event-modeling skill's slice-doc path already use.
+ */
+export function defaultSliceOut(file, sliceName) {
+    return join(dirname(file), "slices", `${kebabSlug(sliceName)}.svg`);
+}
+//# sourceMappingURL=render-inputs.js.map

package/dist/cli/render-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-inputs.js","sourceRoot":"","sources":["../../src/cli/render-inputs.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,qDAAqD;AAErD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAe;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACvD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO;QACL,KAAK,EAAE,8BAA8B,IAAI,qBAAqB,KAAK,IAAI,uBAAuB,EAAE;KACjG,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,SAAiB;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC"}