@substrat-run/model-view 0.2.2

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,50 @@
+# @substrat-run/model-view
+
+Render an emitted Substrat `model.json` — entities, field schemas, parent edges, declared
+lifecycles — as **one self-contained HTML page**: inline CSS, inline SVG, no script, no CDN,
+no external reference of any kind. It is the pure rendering core shared by `substrat model
+view` (the CLI, #756) and the dashboard's Model tab (#1214), which is why it lives apart
+from both: no filesystem, no `node:*` imports, no DOM — the same function runs in a Node
+CLI, a Cloudflare Worker, and a browser bundle.
+
+It reads the **emitted artifact, never the TypeScript**. `model.json` is the artifact of
+record (#697): `lint:model --check` gates it in CI, and everything downstream — this
+renderer included — reads it rather than re-deriving from source.
+
+## Using it
+
+```ts
+import { parseModel, renderModelHtml } from '@substrat-run/model-view';
+
+// `raw` is a model.json you read yourself — a file, a manifest field, an HTTP body.
+const model = parseModel(JSON.parse(raw), 'demos/todo/model.json');
+const html = renderModelHtml(model, { source: 'demos/todo/model.json' });
+// → a complete HTML document: write it to a file, serve it, or iframe-`srcdoc` it.
+```
+
+`parseModel` refuses anything that is not a model — with an error naming the artifact and
+the malformed declaration — rather than rendering an empty or broken page. `source` is
+display-only (a path in the CLI, a `slug@version` in the dashboard); pass `title` when the
+default (the source path's parent directory) is not the right tab title.
+
+## Caveats a user hits first
+
+- **The page is static.** No script means no pan/zoom, no click-to-highlight, and no
+  overlay hooks. A surface that needs live overlays (per-entity row counts, #1214's
+  long-term shape) renders its own component — `layerDepths` is exported so such a
+  component can reuse the layout — rather than post-processing this HTML.
+- **The diagram shows declared facts only.** An entity outside `defineEntities` does not
+  appear, and a `parents` edge pointing outside the model is drawn as no arrow (the entity
+  card still names it). A sparse diagram usually means thin registry adoption, not a bug.
+- **Field order is the model's order.** The renderer never sorts; `emitModel` already
+  emits deterministically, and re-sorting here would misrepresent the artifact.
+
+## What the tests prove — and don't
+
+The suite proves the rendered page carries every reviewable fact (tables, parent edges,
+composite keys, erasable marks, lifecycle edges), escapes hostile names, terminates on a
+cyclic `parents` declaration, and references nothing external (no `http(s)://`, no
+`<script>`, no `<link>`, no `src=`). It does **not** prove the page is legible for very
+large models (wrapping is asserted structurally, not visually), and it does not validate
+semantic coherence of the model — `emitModel`/`emitLifecycles` refused an incoherent
+declaration at emit time; this package only refuses malformed *shape*.

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import type { EmittedEntity, EmittedModel } from '@substrat-run/contracts';
+/**
+ * The emitted entity model, rendered as something a human can look at.
+ *
+ * This is the PURE half of `substrat model view` (#756), extracted so the dashboard's
+ * Model tab (#1214) renders the same page from the same artifact: it takes an already-read
+ * `model.json` — the artifact of record (#697), never the TypeScript — and returns one
+ * self-contained HTML string. No filesystem, no `node:*` imports, no DOM: it runs in the
+ * CLI, in a worker, and in a browser bundle unchanged.
+ *
+ * The output references NOTHING external: inline CSS, inline SVG, no script, no CDN.
+ * That is what makes it openable from a file path or an iframe `srcdoc` — with no server
+ * and no network — and the property is asserted by the suite.
+ */
+/** What `renderModelHtml` needs to say where a view came from. */
+export interface ModelViewSource {
+    /** The `model.json` this was rendered from, as the caller wants it displayed —
+     *  a file path in the CLI, a `slug@version` coordinate in the dashboard. */
+    readonly source: string;
+    /** The `<title>` subject. Defaults to the source path's parent directory name. */
+    readonly title?: string;
+}
+/**
+ * Validate a parsed `model.json`, refusing anything that is not one rather than rendering
+ * an empty page. `sourceLabel` prefixes every refusal so it names the artifact, not the
+ * renderer. Structural, mirroring the `emittedModel` schema in contracts — the renderer
+ * keeps its own copy because its error messages are the user-facing product here, and a
+ * malformed input that got past this would surface as a TypeError from inside the layout,
+ * which reads as a bug in the renderer instead of as a malformed input.
+ */
+export declare function parseModel(parsed: unknown, sourceLabel: string): EmittedModel;
+/**
+ * Depth of each entity: 0 for one with no parents, else one past its deepest parent.
+ *
+ * `parents` is an allowlist and a diamond is normal (a reservation hangs off both a
+ * resource and a member), so this is a longest-path layering, not a tree. A cycle would
+ * make that non-terminating — the kernel does not forbid one — so a node already on the
+ * current path is treated as depth 0 and the layout stays a drawing rather than a hang.
+ */
+export declare function layerDepths(entities: Record<string, EmittedEntity>): Map<string, number>;
+/** Render the whole view. Pure — reading and writing files is the caller's half. */
+export declare function renderModelHtml(model: EmittedModel, opts: ModelViewSource): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAoB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE7F;;;;;;;;;;;;GAYG;AAEH,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B;gFAC4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CA2D7E;AA+BD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxF;AAiND,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CA8BlF"}

package/dist/index.js

@@ -0,0 +1,315 @@
+/**
+ * Validate a parsed `model.json`, refusing anything that is not one rather than rendering
+ * an empty page. `sourceLabel` prefixes every refusal so it names the artifact, not the
+ * renderer. Structural, mirroring the `emittedModel` schema in contracts — the renderer
+ * keeps its own copy because its error messages are the user-facing product here, and a
+ * malformed input that got past this would surface as a TypeError from inside the layout,
+ * which reads as a bug in the renderer instead of as a malformed input.
+ */
+export function parseModel(parsed, sourceLabel) {
+    const entities = parsed?.entities;
+    if (!entities || typeof entities !== 'object' || Array.isArray(entities)) {
+        throw new Error(`${sourceLabel} has no 'entities' object — is it a model.json?`);
+    }
+    for (const [name, entity] of Object.entries(entities)) {
+        if (!entity || typeof entity !== 'object' || typeof entity.table !== 'string') {
+            throw new Error(`${sourceLabel}: entity '${name}' declares no table — is it a model.json?`);
+        }
+        for (const listed of ['parents', 'primaryKey', 'key', 'erasable']) {
+            const value = entity[listed];
+            if (value === undefined)
+                continue;
+            if (!Array.isArray(value) || value.some((v) => typeof v !== 'string')) {
+                throw new Error(`${sourceLabel}: entity '${name}' declares '${listed}' as something other than a list of field names`);
+            }
+        }
+    }
+    const lifecycles = parsed.lifecycles;
+    if (lifecycles !== undefined) {
+        if (!lifecycles || typeof lifecycles !== 'object' || Array.isArray(lifecycles)) {
+            throw new Error(`${sourceLabel}: 'lifecycles' is not an object keyed by entity`);
+        }
+        for (const [entity, lc] of Object.entries(lifecycles)) {
+            const states = lc?.states;
+            if (!lc || typeof lc !== 'object' || !states || typeof states !== 'object' || Array.isArray(states)) {
+                throw new Error(`${sourceLabel}: the lifecycle for '${entity}' declares no states map`);
+            }
+            for (const field of ['field', 'initial']) {
+                if (typeof lc[field] !== 'string') {
+                    throw new Error(`${sourceLabel}: the lifecycle for '${entity}' declares '${field}' as something other than a name`);
+                }
+            }
+            for (const [state, def] of Object.entries(states)) {
+                if (!def || typeof def !== 'object' || Array.isArray(def)) {
+                    throw new Error(`${sourceLabel}: state '${state}' of the '${entity}' lifecycle is not an object`);
+                }
+                const on = def.on;
+                if (on !== undefined) {
+                    if (!on || typeof on !== 'object' || Array.isArray(on)) {
+                        throw new Error(`${sourceLabel}: state '${state}' of the '${entity}' lifecycle declares 'on' as something other than a map`);
+                    }
+                    // The targets too, not only the container: a transition to `1` renders as a
+                    // TypeError out of `escapeHtml`, which is the same failure one level down.
+                    for (const [op, target] of Object.entries(on)) {
+                        if (typeof target !== 'string') {
+                            throw new Error(`${sourceLabel}: transition '${op}' from state '${state}' of the '${entity}' lifecycle names no target state`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return parsed;
+}
+const escapeHtml = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+/** The field names of an entity, in declaration order — the order the model reads in. */
+function fieldNames(entity) {
+    const props = entity.fields?.properties;
+    return props ? Object.keys(props) : [];
+}
+/** A field's JSON-Schema type, rendered short. `string`, `number | null`, `object`. */
+function fieldType(entity, field) {
+    const props = entity.fields?.properties ?? {};
+    const schema = props[field];
+    if (!schema)
+        return '';
+    const t = schema['type'];
+    if (typeof t === 'string')
+        return t;
+    if (Array.isArray(t))
+        return t.filter((x) => typeof x === 'string').join(' | ');
+    if (Array.isArray(schema['anyOf'])) {
+        const parts = schema['anyOf'].map((s) => typeof s['type'] === 'string' ? s['type'] : '…');
+        return [...new Set(parts)].join(' | ');
+    }
+    if (schema['enum'])
+        return 'enum';
+    return '';
+}
+const primaryKeyOf = (entity) => entity.primaryKey ?? ['id'];
+/**
+ * Depth of each entity: 0 for one with no parents, else one past its deepest parent.
+ *
+ * `parents` is an allowlist and a diamond is normal (a reservation hangs off both a
+ * resource and a member), so this is a longest-path layering, not a tree. A cycle would
+ * make that non-terminating — the kernel does not forbid one — so a node already on the
+ * current path is treated as depth 0 and the layout stays a drawing rather than a hang.
+ */
+export function layerDepths(entities) {
+    const depths = new Map();
+    const walk = (name, path) => {
+        const cached = depths.get(name);
+        if (cached !== undefined)
+            return cached;
+        if (path.has(name))
+            return 0;
+        const parents = (entities[name]?.parents ?? []).filter((p) => p in entities);
+        const next = new Set([...path, name]);
+        const depth = parents.length === 0 ? 0 : Math.max(...parents.map((p) => walk(p, next))) + 1;
+        depths.set(name, depth);
+        return depth;
+    };
+    for (const name of Object.keys(entities))
+        walk(name, new Set());
+    return depths;
+}
+const BOX_H = 46;
+const ROW_GAP = 104;
+const COL_GAP = 28;
+const PAD = 20;
+/** Where a depth band wraps — near enough a laptop's window that the labels stay readable. */
+const MAX_WIDTH = 1080;
+/**
+ * The ER diagram, as inline SVG with no `xmlns` — inside HTML it is parsed as SVG already,
+ * and the attribute's value is a URL, which the "nothing external" assertion reads as a
+ * reference whether a browser would fetch it or not.
+ */
+function renderDiagram(entities) {
+    const names = Object.keys(entities);
+    if (names.length === 0)
+        return '<p class="empty">This model declares no entities.</p>';
+    const depths = layerDepths(entities);
+    const rows = [];
+    for (const name of names) {
+        const d = depths.get(name) ?? 0;
+        (rows[d] ??= []).push(name);
+    }
+    // A depth band wider than MAX_WIDTH wraps onto further lines rather than growing the
+    // canvas: the SVG is scaled to the page width, so one 20-entity row would render every
+    // label too small to read. A wrapped line stays inside its band, and depth strictly
+    // increases along a parent edge, so an arrow still always points at an earlier line.
+    const boxes = new Map();
+    let width = 0;
+    let line = 0;
+    rows.forEach((row) => {
+        let x = PAD;
+        row.forEach((name, i) => {
+            const label = Math.max(name.length, (entities[name]?.table ?? '').length);
+            const w = Math.max(132, label * 8 + 28);
+            if (i > 0 && x + w + PAD > MAX_WIDTH) {
+                line += 1;
+                x = PAD;
+            }
+            boxes.set(name, { name, table: entities[name]?.table ?? '', x, y: PAD + line * ROW_GAP, w, h: BOX_H });
+            x += w + COL_GAP;
+            width = Math.max(width, x - COL_GAP + PAD);
+        });
+        line += 1;
+    });
+    const height = PAD * 2 + (line - 1) * ROW_GAP + BOX_H;
+    const edges = [];
+    for (const name of names) {
+        const child = boxes.get(name);
+        if (!child)
+            continue;
+        for (const parentName of entities[name]?.parents ?? []) {
+            const parent = boxes.get(parentName);
+            if (!parent)
+                continue; // a parent outside this model — the entity list below still names it
+            const x1 = child.x + child.w / 2;
+            const y1 = child.y;
+            const x2 = parent.x + parent.w / 2;
+            const y2 = parent.y + parent.h;
+            const mid = (y1 + y2) / 2;
+            edges.push(`<path class="edge" d="M ${x1} ${y1} C ${x1} ${mid}, ${x2} ${mid}, ${x2} ${y2}" marker-end="url(#arrow)">` +
+                `<title>${escapeHtml(name)} hangs off ${escapeHtml(parentName)}</title></path>`);
+        }
+    }
+    const nodes = [...boxes.values()].map((b) => `<g class="node"><rect x="${b.x}" y="${b.y}" width="${b.w}" height="${b.h}" rx="8" />` +
+        `<text class="node-name" x="${b.x + b.w / 2}" y="${b.y + 20}">${escapeHtml(b.name)}</text>` +
+        `<text class="node-table" x="${b.x + b.w / 2}" y="${b.y + 36}">${escapeHtml(b.table)}</text></g>`);
+    return (`<svg class="er" viewBox="0 0 ${width} ${height}" width="${width}" height="${height}" role="img" ` +
+        `aria-label="Entity relationship diagram">` +
+        `<defs><marker id="arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" ` +
+        `orient="auto-start-reverse"><path d="M 0 0 L 8 4 L 0 8 z" /></marker></defs>` +
+        `${edges.join('')}${nodes.join('')}</svg>`);
+}
+/** One entity's fields, with the primary key, the natural key and the erasable fields marked. */
+function renderEntity(name, entity) {
+    const pk = new Set(primaryKeyOf(entity));
+    const key = new Set(entity.key ?? []);
+    const erasable = new Set(entity.erasable ?? []);
+    // `fields` is carried as opaque JSON Schema, so `required` is not shape-checked by
+    // `parseModel` the way the entity-level lists are — guard it here: a malformed value
+    // renders every field as optional rather than throwing from inside the renderer.
+    const requiredRaw = entity.fields?.required;
+    const required = new Set(Array.isArray(requiredRaw) ? requiredRaw.filter((f) => typeof f === 'string') : []);
+    const rows = fieldNames(entity).map((field) => {
+        const marks = [
+            pk.has(field) ? '<span class="mark pk" title="primary key">PK</span>' : '',
+            key.has(field) ? '<span class="mark key" title="natural key">KEY</span>' : '',
+            erasable.has(field) ? '<span class="mark erasable" title="reachable by an erasure">ERASABLE</span>' : '',
+        ]
+            .filter(Boolean)
+            .join(' ');
+        return (`<tr><td class="field">${escapeHtml(field)}${required.has(field) ? '' : '<span class="opt">?</span>'}</td>` +
+            `<td class="type">${escapeHtml(fieldType(entity, field))}</td><td class="marks">${marks}</td></tr>`);
+    });
+    const parents = (entity.parents ?? []).map((p) => `<span class="pill">${escapeHtml(p)}</span>`).join(' ');
+    const meta = [
+        `<span class="meta-item">table <code>${escapeHtml(entity.table)}</code></span>`,
+        `<span class="meta-item">primary key <code>${escapeHtml(primaryKeyOf(entity).join(', '))}</code></span>`,
+        entity.key ? `<span class="meta-item">key <code>${escapeHtml(entity.key.join(', '))}</code></span>` : '',
+        parents ? `<span class="meta-item">hangs off ${parents}</span>` : '',
+    ]
+        .filter(Boolean)
+        .join('');
+    return (`<section class="entity" id="entity-${escapeHtml(name)}"><h3>${escapeHtml(name)}</h3>` +
+        `<div class="meta">${meta}</div>` +
+        `<table class="fields"><tbody>${rows.join('')}</tbody></table></section>`);
+}
+/** The declared state machines, when the model carries any (#844). */
+function renderLifecycles(lifecycles) {
+    const blocks = Object.entries(lifecycles).map(([entity, lc]) => {
+        const states = Object.entries(lc.states).map(([state, def]) => {
+            const edges = Object.entries(def.on ?? {}).map(([op, target]) => `<li><code>${escapeHtml(op)}</code> → ${escapeHtml(target)}</li>`);
+            const initial = state === lc.initial ? '<span class="mark pk" title="initial state">INITIAL</span>' : '';
+            return (`<div class="state"><h4>${escapeHtml(state)} ${initial}</h4>` +
+                `${edges.length ? `<ul>${edges.join('')}</ul>` : '<p class="empty">terminal</p>'}</div>`);
+        });
+        return (`<section class="entity"><h3>${escapeHtml(entity)}<span class="opt"> · ${escapeHtml(lc.field)}</span></h3>` +
+            `<div class="states">${states.join('')}</div></section>`);
+    });
+    return `<h2>Lifecycles</h2><div class="entities">${blocks.join('')}</div>`;
+}
+const STYLE = `
+:root { color-scheme: light dark; --fg: #16181d; --dim: #5b6272; --line: #d7dbe3; --bg: #fbfbfd;
+        --card: #ffffff; --accent: #2f5bd7; --warn: #b2542b; }
+@media (prefers-color-scheme: dark) {
+  :root { --fg: #e8eaf0; --dim: #9aa3b5; --line: #333844; --bg: #14161b; --card: #1b1e25;
+          --accent: #7fa2ff; --warn: #e2986a; }
+}
+* { box-sizing: border-box; }
+body { margin: 0; padding: 32px; background: var(--bg); color: var(--fg);
+       font: 14px/1.5 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif; }
+header { margin-bottom: 24px; }
+h1 { margin: 0 0 4px; font-size: 22px; }
+h2 { margin: 32px 0 12px; font-size: 16px; text-transform: uppercase; letter-spacing: .08em; color: var(--dim); }
+h3 { margin: 0 0 8px; font-size: 15px; }
+h4 { margin: 0 0 4px; font-size: 13px; }
+.sub { color: var(--dim); font-size: 13px; }
+code { font: 12px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace; }
+.diagram { overflow-x: auto; padding: 8px 0; }
+svg.er { max-width: 100%; height: auto; }
+.er rect { fill: var(--card); stroke: var(--line); stroke-width: 1.5; }
+.er text { text-anchor: middle; fill: var(--fg); font: 13px ui-sans-serif, system-ui, sans-serif; }
+.er .node-table { fill: var(--dim); font: 11px ui-monospace, Menlo, monospace; }
+.er .edge { fill: none; stroke: var(--accent); stroke-width: 1.5; }
+.er marker path { fill: var(--accent); }
+.entities { display: grid; gap: 16px; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); }
+.entity { background: var(--card); border: 1px solid var(--line); border-radius: 10px; padding: 14px 16px; }
+.meta { color: var(--dim); font-size: 12px; margin-bottom: 10px; }
+.meta-item { display: inline-block; margin-right: 12px; }
+.pill { display: inline-block; border: 1px solid var(--line); border-radius: 999px; padding: 0 8px; }
+table.fields { width: 100%; border-collapse: collapse; }
+table.fields td { border-top: 1px solid var(--line); padding: 4px 0; vertical-align: top; }
+td.field { font: 12px ui-monospace, Menlo, monospace; }
+td.type { color: var(--dim); font: 12px ui-monospace, Menlo, monospace; width: 30%; }
+td.marks { text-align: right; white-space: nowrap; }
+.opt { color: var(--dim); }
+.mark { font-size: 10px; letter-spacing: .06em; border-radius: 4px; padding: 1px 5px; margin-left: 4px;
+        border: 1px solid var(--line); color: var(--dim); }
+.mark.pk { color: var(--accent); border-color: var(--accent); }
+.mark.erasable { color: var(--warn); border-color: var(--warn); }
+.states { display: grid; gap: 10px; grid-template-columns: repeat(auto-fill, minmax(140px, 1fr)); }
+.state ul { margin: 0; padding-left: 16px; }
+.empty { color: var(--dim); }
+footer { margin-top: 32px; color: var(--dim); font-size: 12px; }
+`;
+/** The default `<title>` subject: the source path's parent directory name, as the CLI shows it. */
+function defaultTitle(source) {
+    const parts = source.split('/');
+    return parts.length >= 2 ? (parts[parts.length - 2] ?? '') : '';
+}
+/** Render the whole view. Pure — reading and writing files is the caller's half. */
+export function renderModelHtml(model, opts) {
+    const entities = model.entities;
+    const names = Object.keys(entities);
+    const cards = names.map((name) => renderEntity(name, entities[name]));
+    const lifecycles = model.lifecycles && Object.keys(model.lifecycles).length ? renderLifecycles(model.lifecycles) : '';
+    const erasable = names.filter((n) => (entities[n]?.erasable ?? []).length > 0).length;
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Entity model — ${escapeHtml(opts.title ?? (defaultTitle(opts.source) || 'substrat'))}</title>
+<style>${STYLE}</style>
+</head>
+<body>
+<!-- Rendered by @substrat-run/model-view from ${escapeHtml(opts.source)} — regenerate, do not edit. -->
+<header>
+<h1>Entity model</h1>
+<p class="sub">${names.length} entities · ${erasable} with erasable fields · from <code>${escapeHtml(opts.source)}</code></p>
+</header>
+<div class="diagram">${renderDiagram(entities)}</div>
+<h2>Entities</h2>
+<div class="entities">${cards.join('')}</div>
+${lifecycles}
+<footer>An arrow points from an entity to a parent it may hang off — the allowlist <code>ctx.link</code> checks.
+Marks: PK primary key · KEY natural key · ERASABLE reachable by an erasure. <code>?</code> marks an optional field.</footer>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@substrat-run/model-view",
+  "version": "0.2.2",
+  "description": "Render an emitted Substrat model.json as one self-contained HTML page — the ER diagram, the entity cards, the declared lifecycles",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/substrat-run/substrat.git",
+    "directory": "packages/model-view"
+  },
+  "homepage": "https://substrat.net/concepts/model",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@substrat-run/contracts": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.5"
+  }
+}