@milehimikey/em-portal 0.1.0

package/dist/pages/model.js

@@ -0,0 +1,54 @@
+// SPDX-License-Identifier: MIT
+// Per-model page: the model's full diagram plus its slice table — the
+// drill-down step between the multi-model landing index and an individual
+// slice page (model -> slice -> doc, per MIL-162's "state up front" design).
+import { escapeHtml, layout } from "./html.js";
+// Note: this page's slice links are relative to the model directory itself
+// ("slices/<key>.html"), not the site-root-relative form src/refs.ts's
+// sliceUrl() returns (which is for cross-page links, e.g. the landing
+// page's cross-model-links table) — so this page builds its own hrefs
+// rather than reusing that helper.
+const PATTERN_LABEL = {
+    "state-change": "State Change",
+    "state-view": "State View",
+    automation: "Automation",
+    translation: "Translation",
+    unclassified: "Unclassified",
+};
+function statusBadge(hasDoc, status) {
+    if (!hasDoc)
+        return `<span class="badge">no doc</span>`;
+    if (!status)
+        return `<span class="badge">unknown</span>`;
+    const cls = status === "implemented" ? "ok" : "";
+    return `<span class="badge ${cls}">${escapeHtml(status)}</span>`;
+}
+function driftBadge(drift) {
+    if (!drift)
+        return "";
+    const cls = drift === "in-sync" ? "ok" : drift === "never-implemented" ? "warn" : "bad";
+    return `<span class="badge ${cls}">${escapeHtml(drift)}</span>`;
+}
+export function renderModelPage(args) {
+    const { modelName, file, diagramFile, slices } = args;
+    const rows = slices
+        .map((s) => `      <tr id="${escapeHtml(s.key)}">
+        <td><a href="slices/${escapeHtml(s.key)}.html">${escapeHtml(s.name)}</a></td>
+        <td class="pattern">${escapeHtml(PATTERN_LABEL[s.pattern])}</td>
+        <td>${statusBadge(s.hasDoc, s.status)}</td>
+        <td>${driftBadge(s.driftSignal)}</td>
+      </tr>`)
+        .join("\n");
+    const body = `    <p><code>${escapeHtml(file)}</code></p>
+    <h1>${escapeHtml(modelName)}</h1>
+    <div class="diagram-frame"><object class="diagram" type="image/svg+xml" data="${escapeHtml(diagramFile)}"></object></div>
+    <p class="full-diagram-link"><a href="${escapeHtml(diagramFile)}">Open full diagram &rarr;</a></p>
+    <table>
+      <thead><tr><th>Slice</th><th>Pattern</th><th>Status</th><th>Drift</th></tr></thead>
+      <tbody>
+${rows}
+      </tbody>
+    </table>`;
+    return layout(`${modelName} — em portal`, body, "../index.html", [{ label: modelName, href: "." }]);
+}
+//# sourceMappingURL=model.js.map

package/dist/pages/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/pages/model.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sEAAsE;AACtE,0EAA0E;AAC1E,6EAA6E;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE/C,2EAA2E;AAC3E,uEAAuE;AACvE,sEAAsE;AACtE,sEAAsE;AACtE,mCAAmC;AAEnC,MAAM,aAAa,GAAiC;IAClD,cAAc,EAAE,cAAc;IAC9B,YAAY,EAAE,YAAY;IAC1B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;CAC7B,CAAC;AAEF,SAAS,WAAW,CAAC,MAAe,EAAE,MAAqB;IACzD,IAAI,CAAC,MAAM;QAAE,OAAO,mCAAmC,CAAC;IACxD,IAAI,CAAC,MAAM;QAAE,OAAO,oCAAoC,CAAC;IACzD,MAAM,GAAG,GAAG,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,OAAO,sBAAsB,GAAG,KAAK,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,SAAS,UAAU,CAAC,KAAoB;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACxF,OAAO,sBAAsB,GAAG,KAAK,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC;AAClE,CAAC;AAmBD,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM;SAChB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;8BACjB,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;8BAC7C,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;cACpD,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;cAC/B,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;YAC3B,CACP;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,gBAAgB,UAAU,CAAC,IAAI,CAAC;UACrC,UAAU,CAAC,SAAS,CAAC;oFACqD,UAAU,CAAC,WAAW,CAAC;4CAC/D,UAAU,CAAC,WAAW,CAAC;;;;EAIjE,IAAI;;aAEO,CAAC;IAEZ,OAAO,MAAM,CAAC,GAAG,SAAS,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AACtG,CAAC"}

package/dist/pages/slice.d.ts

@@ -0,0 +1,16 @@
+import { EmSlice, SliceDocJoin, SlicePattern } from "../em/exportDoc.js";
+export interface SlicePageArgs {
+    modelName: string;
+    modelKey: string;
+    diagramFile: string;
+    sliceDiagramFile: string;
+    slice: EmSlice;
+    pattern: SlicePattern;
+    doc: SliceDocJoin;
+    /** Rendered markdown body of the bound doc (src/em/docBody.ts) — `em
+     *  export`'s own `doc` field never carries this (frontmatter only). `null`
+     *  when no doc is bound, the bound file couldn't be read, or it has no
+     *  body content after its frontmatter block. */
+    docBodyHtml: string | null;
+}
+export declare function renderSlicePage(args: SlicePageArgs): string;

package/dist/pages/slice.js

@@ -0,0 +1,144 @@
+// SPDX-License-Identifier: MIT
+// Per-slice page: this slice's own diagram, its rendered doc, driftSignal,
+// and a link to wherever it was implemented (MIL-172's scope: "diagram,
+// rendered doc, driftSignal, PR link"). MIL-173: every element row also
+// carries its own `em export` ref as a DOM id plus a visible, copyable
+// deep-link permalink (src/refs.ts) — the URL scheme an agent's `em query`/
+// MCP citation and a stakeholder's portal link share.
+import { escapeHtml, layout } from "./html.js";
+import { elementDeepLink } from "../refs.js";
+const PATTERN_LABEL = {
+    "state-change": "State Change",
+    "state-view": "State View",
+    automation: "Automation",
+    translation: "Translation",
+    unclassified: "Unclassified",
+};
+function statusBadge(status) {
+    if (!status)
+        return `<span class="badge">unknown</span>`;
+    const cls = status === "implemented" ? "ok" : "";
+    return `<span class="badge ${cls}">${escapeHtml(status)}</span>`;
+}
+function driftBadge(drift) {
+    if (!drift)
+        return `<span class="badge">n/a</span>`;
+    const cls = drift === "in-sync" ? "ok" : drift === "never-implemented" ? "warn" : "bad";
+    return `<span class="badge ${cls}">${escapeHtml(drift)}</span>`;
+}
+/** Renders a doc's `implementedIn` value as a link when it looks like a URL
+ *  (a PR/commit link — the common case per docs/slice-doc-schema.md), or as
+ *  plain code text otherwise (a bare file path — no portal-side path
+ *  resolution is attempted, since the target repo isn't necessarily the one
+ *  the portal was built from). */
+function implementedInHtml(implementedIn) {
+    if (!implementedIn)
+        return `<span class="no-doc">not linked</span>`;
+    if (/^https?:\/\//.test(implementedIn)) {
+        return `<a href="${escapeHtml(implementedIn)}">${escapeHtml(implementedIn)}</a>`;
+    }
+    return `<code>${escapeHtml(implementedIn)}</code>`;
+}
+/** `ratifiedBy`/`ratifiedOn` (schema 1.8, MIL-165) — who signed off on this
+ *  doc's current status/version, and when. Both are hand-filled and often
+ *  absent even on an `implemented` doc predating the feature (or ratified by
+ *  hand before it existed) — that's routine, not a gap, so it renders as a
+ *  plain "not recorded" note rather than a warning badge. */
+function ratifiedByHtml(ratifiedBy, ratifiedOn) {
+    if (!ratifiedBy)
+        return `<span class="no-doc">not recorded</span>`;
+    return ratifiedOn ? `${escapeHtml(ratifiedBy)} <span class="pattern">(${escapeHtml(ratifiedOn)})</span>` : escapeHtml(ratifiedBy);
+}
+/** `owner`/`tracking` (schema 1.9, MIL-171) — rendered as one optional line
+ *  beneath the stat row, omitted entirely when neither is set (same
+ *  "nothing to report" convention `em status`'s own text report uses for
+ *  its doc-issues line), rather than two more always-present "not set"
+ *  tiles cluttering the common case. */
+function ownerTrackingHtml(owner, tracking) {
+    if (!owner && !tracking)
+        return "";
+    const parts = [];
+    if (owner)
+        parts.push(`Owner: <strong>${escapeHtml(owner)}</strong>`);
+    if (tracking) {
+        parts.push(/^https?:\/\//.test(tracking)
+            ? `Tracking: <a href="${escapeHtml(tracking)}">${escapeHtml(tracking)}</a>`
+            : `Tracking: <code>${escapeHtml(tracking)}</code>`);
+    }
+    return `    <p>${parts.join(" &middot; ")}</p>\n`;
+}
+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.map((f) => f.name).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(elements, modelKey) {
+    const rows = elements
+        .map((el) => {
+        const annotations = [];
+        if (el.issue)
+            annotations.push(`<div><span class="badge warn">issue</span> ${escapeHtml(el.issue)}</div>`);
+        if (el.divergence)
+            annotations.push(`<div><span class="badge">divergence</span> ${escapeHtml(el.divergence)}</div>`);
+        // The fragment jump target for THIS page is always local ("#<ref>") — a
+        // relative deep link never needs the "<model-key>/slices/<key>.html"
+        // prefix when it's already pointing at the page it's sitting on. The
+        // full portable citation (what elementDeepLink returns) is shown as
+        // the visible, copyable permalink text instead, so a reader can grab
+        // the whole address without leaving the page.
+        const deepLink = elementDeepLink(modelKey, el.ref);
+        return `      <tr id="${escapeHtml(el.ref)}">
+        <td>${escapeHtml(el.kind)}</td>
+        <td>${escapeHtml(el.name)}</td>
+        <td>${elementDetail(el)}${annotations.join("")}</td>
+        <td class="permalink"><a href="#${escapeHtml(el.ref)}" title="Deep link: ${escapeHtml(deepLink)}">#${escapeHtml(el.ref)}</a></td>
+      </tr>`;
+    })
+        .join("\n");
+    return `    <table>
+      <thead><tr><th>Kind</th><th>Name</th><th>Detail</th><th>Ref</th></tr></thead>
+      <tbody>
+${rows}
+      </tbody>
+    </table>`;
+}
+export function renderSlicePage(args) {
+    const { modelName, diagramFile, sliceDiagramFile, slice, pattern, doc, docBodyHtml } = args;
+    const docSection = docBodyHtml
+        ? `    <div class="doc">${docBodyHtml}</div>`
+        : `    <p class="no-doc">${doc.found ? `Doc bound at <code>${escapeHtml(doc.path)}</code> but has no rendered body.` : `No slice doc bound. Expected at <code>${escapeHtml(doc.path)}</code>.`}</p>`;
+    const body = `    <h1>${escapeHtml(slice.name)}</h1>
+    <p class="pattern">${escapeHtml(PATTERN_LABEL[pattern])}</p>
+    <div class="stat-row">
+      <div class="stat"><span class="label">Status</span>${statusBadge(doc.status)}</div>
+      <div class="stat"><span class="label">Drift signal</span>${driftBadge(doc.driftSignal)}</div>
+      <div class="stat"><span class="label">Implemented in</span>${implementedInHtml(doc.implementedIn)}</div>
+      <div class="stat"><span class="label">Ratified by</span>${ratifiedByHtml(doc.ratifiedBy, doc.ratifiedOn)}</div>
+    </div>
+${ownerTrackingHtml(doc.owner, doc.tracking)}    <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.elements, args.modelKey)}
+${docSection}`;
+    return layout(`${slice.name} — ${modelName}`, body, "../../index.html", [
+        { label: modelName, href: ".." },
+        { label: slice.name, href: "." },
+    ]);
+}
+//# sourceMappingURL=slice.js.map

package/dist/pages/slice.js.map

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

package/dist/pages/types.d.ts

@@ -0,0 +1,22 @@
+import { SlicePattern } from "../em/exportDoc.js";
+import { CrossModelLink } from "../crossModel.js";
+export interface SliceSummary {
+    key: string;
+    name: string;
+    pattern: SlicePattern;
+    hasDoc: boolean;
+    status: string | null;
+    driftSignal: string | null;
+}
+export interface ModelSummary {
+    key: string;
+    name: string;
+    file: string;
+    sliceCount: number;
+    slices: SliceSummary[];
+}
+export interface PortalSummary {
+    title: string;
+    models: ModelSummary[];
+    crossModelLinks: CrossModelLink[];
+}

package/dist/pages/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: MIT
+// Shared summary shapes passed between build.ts and the page builders.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pages/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pages/types.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,uEAAuE"}

package/dist/refs.d.ts

@@ -0,0 +1,36 @@
+export interface ParsedElementRef {
+    sliceKey: string;
+    kind: string;
+    slug: string;
+}
+/** Splits an `em export` element ref (`<sliceKey>/<kind>.<slug>`) into its
+ *  three parts. `sliceKey` never contains `/` or `.` (kebab-slug, dedupe
+ *  suffix `~2`/`~3`/... only); `kind` is a single bare word (`ui`, `command`,
+ *  `event`, ...) and never contains `.`, so splitting on the FIRST `.` after
+ *  the slice-key boundary is always unambiguous even though `slug` itself
+ *  can carry a `~2`-style suffix. Throws on a string that doesn't have the
+ *  `/` + `.` shape at all — a caller should never see that for a ref that
+ *  actually came from `em export`. */
+export declare function parseElementRef(ref: string): ParsedElementRef;
+/** The page URL for a whole slice, relative to the site root. */
+export declare function sliceUrl(modelKey: string, sliceKey: string): string;
+/** The full portable deep link to one element: the slice page's URL plus a
+ *  `#`-fragment of its own `em export` ref. Portable in the sense that it's
+ *  exactly what you'd bookmark, paste into a doc, or hand to another tool —
+ *  resolving it never requires knowing anything beyond the model key (a
+ *  portal-build-time choice) and the ref itself (an em-export-time one). */
+export declare function elementDeepLink(modelKey: string, ref: string): string;
+export interface ParsedDeepLink {
+    modelKey: string;
+    sliceKey: string;
+    /** The element ref's `<kind>.<slug>` fragment, or `null` for a slice-level
+     *  link with no element fragment. */
+    elementRef: string | null;
+}
+/** The inverse of `sliceUrl`/`elementDeepLink` — parses a portal-relative
+ *  deep link back into its model/slice/element parts. Returns `null` for
+ *  anything that isn't shaped like a page this portal generates (the site's
+ *  own `index.html`, an external URL, ...), rather than throwing — a caller
+ *  resolving an arbitrary string should treat "not a portal deep link" as a
+ *  normal outcome. */
+export declare function parseDeepLink(link: string): ParsedDeepLink | null;

package/dist/refs.js

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: MIT
+// MIL-173: the portal's URL scheme, built entirely on `em export`'s own
+// stable identifiers — a slice's `key` and an element's `ref`
+// (`<sliceKey>/<kind>.<slug>`, docs/cli.md in the em repo). One addressing
+// scheme for both audiences: an agent citing a ref via `em query`/MCP and a
+// stakeholder clicking a portal link name the same element, and the scheme
+// survives re-renders and model growth because it depends only on export's
+// ref-stability guarantee (inserting/reordering slices never changes an
+// existing ref) — never on layout, coordinates, or this portal's own
+// directory-naming choices for a model (`src/slug.ts`, portal-local, not
+// part of the addressing scheme itself).
+//
+// A slice page's URL already IS that slice's export key
+// (`<model-key>/slices/<sliceKey>.html`) — no separate per-element page is
+// needed, since an element's ref always starts with its own slice's key.
+// An element-level deep link is that same page plus a `#`-fragment of the
+// element's full ref, so `<model-key>/slices/<sliceKey>.html#<ref>` and
+// `<model-key>/<ref>` carry the exact same three pieces of information
+// (model, slice, element) — just spelled with `/slices/` and `.html#`
+// standing in for the ref's own internal `/`.
+/** Splits an `em export` element ref (`<sliceKey>/<kind>.<slug>`) into its
+ *  three parts. `sliceKey` never contains `/` or `.` (kebab-slug, dedupe
+ *  suffix `~2`/`~3`/... only); `kind` is a single bare word (`ui`, `command`,
+ *  `event`, ...) and never contains `.`, so splitting on the FIRST `.` after
+ *  the slice-key boundary is always unambiguous even though `slug` itself
+ *  can carry a `~2`-style suffix. Throws on a string that doesn't have the
+ *  `/` + `.` shape at all — a caller should never see that for a ref that
+ *  actually came from `em export`. */
+export function parseElementRef(ref) {
+    const slashIndex = ref.indexOf("/");
+    if (slashIndex === -1) {
+        throw new Error(`not an em export element ref (missing "/"): ${ref}`);
+    }
+    const sliceKey = ref.slice(0, slashIndex);
+    const rest = ref.slice(slashIndex + 1);
+    const dotIndex = rest.indexOf(".");
+    if (dotIndex === -1) {
+        throw new Error(`not an em export element ref (missing "." after "/"): ${ref}`);
+    }
+    return { sliceKey, kind: rest.slice(0, dotIndex), slug: rest.slice(dotIndex + 1) };
+}
+/** The page URL for a whole slice, relative to the site root. */
+export function sliceUrl(modelKey, sliceKey) {
+    return `${modelKey}/slices/${sliceKey}.html`;
+}
+/** The full portable deep link to one element: the slice page's URL plus a
+ *  `#`-fragment of its own `em export` ref. Portable in the sense that it's
+ *  exactly what you'd bookmark, paste into a doc, or hand to another tool —
+ *  resolving it never requires knowing anything beyond the model key (a
+ *  portal-build-time choice) and the ref itself (an em-export-time one). */
+export function elementDeepLink(modelKey, ref) {
+    const { sliceKey } = parseElementRef(ref);
+    return `${sliceUrl(modelKey, sliceKey)}#${ref}`;
+}
+const DEEP_LINK_PATTERN = /^([^/]+)\/slices\/([^/]+)\.html(?:#(.+))?$/;
+/** The inverse of `sliceUrl`/`elementDeepLink` — parses a portal-relative
+ *  deep link back into its model/slice/element parts. Returns `null` for
+ *  anything that isn't shaped like a page this portal generates (the site's
+ *  own `index.html`, an external URL, ...), rather than throwing — a caller
+ *  resolving an arbitrary string should treat "not a portal deep link" as a
+ *  normal outcome. */
+export function parseDeepLink(link) {
+    const match = DEEP_LINK_PATTERN.exec(link);
+    if (!match)
+        return null;
+    const [, modelKey, sliceKey, elementRef] = match;
+    return { modelKey, sliceKey, elementRef: elementRef ?? null };
+}
+//# sourceMappingURL=refs.js.map

package/dist/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,wEAAwE;AACxE,8DAA8D;AAC9D,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,2EAA2E;AAC3E,wEAAwE;AACxE,qEAAqE;AACrE,yEAAyE;AACzE,yCAAyC;AACzC,EAAE;AACF,wDAAwD;AACxD,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AACvE,sEAAsE;AACtE,8CAA8C;AAQ9C;;;;;;;sCAOsC;AACtC,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,GAAG,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yDAAyD,GAAG,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,QAAgB;IACzD,OAAO,GAAG,QAAQ,WAAW,QAAQ,OAAO,CAAC;AAC/C,CAAC;AAED;;;;4EAI4E;AAC5E,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAW;IAC3D,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC;AAClD,CAAC;AAUD,MAAM,iBAAiB,GAAG,4CAA4C,CAAC;AAEvE;;;;;sBAKsB;AACtB,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;IACjD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,IAAI,IAAI,EAAE,CAAC;AAChE,CAAC"}

package/dist/slug.d.ts

@@ -0,0 +1,5 @@
+export declare function kebabSlug(name: string): string;
+/** Returns a slug unique within `used`, suffixing `~2`, `~3`, ... on collision
+ *  (same separator em's own dedupe() uses, for a familiar convention) and
+ *  records the chosen value into `used` before returning it. */
+export declare function dedupe(candidate: string, used: Set<string>): string;

package/dist/slug.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: MIT
+// Portal-local slug/dedupe helpers for naming output directories (one per
+// input model, mirroring `em catalog`'s convention). Deliberately NOT shared
+// code with em's own src/util/slug.ts — em-portal is a separate package with
+// no access to em's internals (see docs/decisions/mil-162-teachable-navigator.md
+// in the em repo); slice keys and element refs always come straight from
+// `em export`'s own JSON instead of being re-derived here.
+export function kebabSlug(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "model";
+}
+/** Returns a slug unique within `used`, suffixing `~2`, `~3`, ... on collision
+ *  (same separator em's own dedupe() uses, for a familiar convention) and
+ *  records the chosen value into `used` before returning it. */
+export function dedupe(candidate, used) {
+    if (!used.has(candidate)) {
+        used.add(candidate);
+        return candidate;
+    }
+    let n = 2;
+    while (used.has(`${candidate}~${n}`))
+        n++;
+    const deduped = `${candidate}~${n}`;
+    used.add(deduped);
+    return deduped;
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,iFAAiF;AACjF,yEAAyE;AACzE,2DAA2D;AAE3D,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;AACxC,CAAC;AAED;;gEAEgE;AAChE,MAAM,UAAU,MAAM,CAAC,SAAiB,EAAE,IAAiB;IACzD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,CAAC,EAAE,CAAC;QAAE,CAAC,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,CAAC,EAAE,CAAC;IACpC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@milehimikey/em-portal",
+  "version": "0.1.0",
+  "description": "Stakeholder-facing static portal for em event models — a multi-model, read-only browser built from `em export`/`em status --json`",
+  "type": "module",
+  "bin": {
+    "em-portal": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsx src/cli.ts",
+    "em-portal": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "pretest": "npm run build",
+    "prepublishOnly": "npm run build && npm run typecheck && npm test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "author": "milehimikey",
+  "homepage": "https://github.com/milehimikey/em-portal#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/milehimikey/em-portal.git"
+  },
+  "bugs": {
+    "url": "https://github.com/milehimikey/em-portal/issues"
+  },
+  "keywords": [
+    "event-modeling",
+    "portal",
+    "static-site",
+    "dashboard",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "marked": "^18.0.11"
+  },
+  "devDependencies": {
+    "@milehimikey/em": "file:vendor/milehimikey-em-1.8.1.tgz",
+    "@types/node": "^22.0.0",
+    "jsdom": "^26.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.10"
+  }
+}