@metaobjectsdev/docs-site 0.15.8-rc.1

package/dist/link-graph.js

@@ -0,0 +1,198 @@
+import { deriveM2MFields, stripPackage } from "@metaobjectsdev/metadata";
+import { treeOf } from "./load";
+export function pkgOf(node) {
+    return (node.package ?? node.fileDefaultPackage ?? "");
+}
+export function fqnOf(node) {
+    const p = pkgOf(node);
+    return p ? `${p}::${node.name}` : node.name;
+}
+export class LinkGraph {
+    _nodes = new Map();
+    _from = new Map();
+    _to = new Map();
+    _extBy = new Map();
+    _origins = new Map();
+    constructor(model) {
+        for (const o of model.root.ownChildren()) {
+            let kind;
+            if (o.type === "object")
+                kind = "object";
+            else if (o.type === "template")
+                kind = o.subType === "prompt" ? "prompt" : "output";
+            if (!kind)
+                continue;
+            const pkg = pkgOf(o);
+            const pkgPath = pkg.split("::").join("/");
+            this._nodes.set(fqnOf(o), {
+                kind, name: o.name, pkg, pkgPath,
+                href: `${pkgPath}/${o.name}.html`, node: o, tree: treeOf(o, model),
+            });
+        }
+        const addRef = (r) => {
+            (this._from.get(r.from) ?? this._from.set(r.from, []).get(r.from)).push(r);
+            (this._to.get(r.to) ?? this._to.set(r.to, []).get(r.to)).push(r);
+        };
+        const resolveRef = (raw, ctxPkg) => {
+            const cand = raw.includes("::") ? raw : `${ctxPkg}::${raw}`;
+            return this._nodes.has(cand) ? cand : (this._nodes.has(raw) ? raw : undefined);
+        };
+        // M:N through-junction edge. Derives the junction FK fields via the metadata
+        // SSOT (deriveM2MFields) — hetero, directed (@sourceRefField), or symmetric
+        // (@symmetric). On a derivation failure (ambiguous self-join) the edge is
+        // SKIPPED — generation never fails.
+        const addM2mEdge = (from, to, rel, obj, ctxPkg, onDelete, subtype) => {
+            const through = rel.through ? (resolveRef(rel.through, ctxPkg) ?? rel.through) : undefined;
+            let sourceJoinField, targetJoinField;
+            try {
+                const f = deriveM2MFields(rel, obj, model.root);
+                sourceJoinField = f.sourceField;
+                targetJoinField = f.targetField;
+            }
+            catch {
+                return; // ambiguous junction — skip the logical edge (the two FK edges still show)
+            }
+            addRef({ from, to, via: rel.name, kind: "relationship", cardinality: "many", through, sourceJoinField, targetJoinField, symmetric: rel.symmetric, onDelete, subtype });
+        };
+        for (const dn of this._nodes.values()) {
+            const fqn = fqnOf(dn.node);
+            if (dn.kind === "object") {
+                for (const f of dn.node.childrenOfType("field")) {
+                    const ref = f.attr("objectRef");
+                    if (typeof ref === "string") {
+                        const to = resolveRef(ref, dn.pkg);
+                        if (to)
+                            addRef({ from: fqn, to, via: f.name, kind: "field" });
+                    }
+                }
+                // dn.node is typed MetaData; the enclosing dn.kind === "object" guard
+                // guarantees it is a MetaObject at runtime. The `unknown` bridge is needed
+                // because MetaData does not structurally narrow to MetaObject for tsc.
+                const obj = dn.node;
+                // Relationship edges FIRST, so we can suppress the bare FK edge a belongs-to
+                // relationship supersedes. Dedupe is keyed by `${targetFqn}::${fkField}`
+                // (a string, robust to node-instance identity) — the FK loop skips any
+                // reference whose (target, first-field) a belongs-to relationship covered.
+                const coveredFk = new Set();
+                for (const rel of obj.relationships()) {
+                    const objectRef = rel.objectRef;
+                    if (typeof objectRef !== "string")
+                        continue;
+                    const to = resolveRef(objectRef, dn.pkg);
+                    if (!to)
+                        continue;
+                    const cardinality = rel.cardinality === "many" ? "many" : rel.cardinality === "one" ? "one" : undefined;
+                    const onDelete = rel.onDelete;
+                    const subtype = rel.subType;
+                    if (cardinality === "many" && rel.through !== undefined) {
+                        addM2mEdge(fqn, to, rel, obj, dn.pkg, onDelete, subtype); // Task 3 helper
+                        continue;
+                    }
+                    // belongs-to (1:N, one) — find the matching identity.reference to dedupe (mirrors
+                    // relation-resolver: first reference whose target matches, package-stripped).
+                    const target = stripPackage(objectRef);
+                    const match = obj.referenceIdentities().find((r) => stripPackage(r.targetEntity ?? "") === target);
+                    const fkField = match?.fields?.[0];
+                    if (fkField)
+                        coveredFk.add(`${to}::${fkField}`);
+                    addRef({ from: fqn, to, via: rel.name, kind: "relationship", cardinality, onDelete, subtype });
+                }
+                for (const id of dn.node.childrenOfType("identity")) {
+                    if (id.subType !== "reference")
+                        continue;
+                    const ref = id.attr("references");
+                    if (typeof ref === "string") {
+                        const to = resolveRef(ref, dn.pkg);
+                        if (to) {
+                            const fieldsValue = id.attr("fields") ?? id.name;
+                            const firstField = Array.isArray(fieldsValue) ? String(fieldsValue[0] ?? "") : String(fieldsValue);
+                            if (coveredFk.has(`${to}::${firstField}`))
+                                continue; // superseded by a relationship edge
+                            const via = Array.isArray(fieldsValue) ? fieldsValue.join(", ") : String(fieldsValue);
+                            addRef({ from: fqn, to, via, kind: "fk" });
+                        }
+                    }
+                }
+                for (const f of dn.node.childrenOfType("field")) {
+                    for (const org of f.childrenOfType("origin")) {
+                        const from = String(org.attr("from") ?? ""), via = String(org.attr("via") ?? "");
+                        (this._origins.get(fqn) ?? this._origins.set(fqn, []).get(fqn)).push({ field: f.name, from, via });
+                        // connect a projection to its source object so it is not orphaned on diagrams:
+                        // `from` is "pkg::Entity.field" — strip the trailing ".field" to get the source object ref.
+                        const dot = from.lastIndexOf(".");
+                        const srcRef = dot > 0 ? from.slice(0, dot) : "";
+                        const to = srcRef ? resolveRef(srcRef, dn.pkg) : undefined;
+                        if (to && to !== fqn)
+                            addRef({ from: fqn, to, via: `${f.name} (origin)`, kind: "origin" });
+                    }
+                }
+                const sup = dn.node.superResolved;
+                if (sup) {
+                    const supFqn = fqnOf(sup);
+                    addRef({ from: fqn, to: supFqn, via: "extends", kind: "extends" });
+                    (this._extBy.get(supFqn) ?? this._extBy.set(supFqn, []).get(supFqn)).push(dn);
+                }
+            }
+            else {
+                const p = dn.node.attr("payloadRef");
+                if (typeof p === "string") {
+                    const to = resolveRef(p, dn.pkg);
+                    if (to)
+                        addRef({ from: fqn, to, via: "payloadRef", kind: "payload" });
+                }
+            }
+        }
+    }
+    nodes() { return [...this._nodes.values()]; }
+    byFqn(fqn) { return this._nodes.get(fqn); }
+    refsFrom(fqn) { return this._from.get(fqn) ?? []; }
+    refsTo(fqn) { return this._to.get(fqn) ?? []; }
+    degree(fqn) {
+        const n = (rs) => rs.filter((r) => r.kind !== "extends").length;
+        return n(this.refsFrom(fqn)) + n(this.refsTo(fqn));
+    }
+    extendedBy(fqn) { return this._extBy.get(fqn) ?? []; }
+    originsOf(fqn) { return this._origins.get(fqn) ?? []; }
+    ancestors(fqn) {
+        const out = [];
+        const start = this._nodes.get(fqn);
+        if (!start)
+            return out;
+        for (let s = start.node.superResolved; s; s = s.superResolved) {
+            const t = this._nodes.get(fqnOf(s));
+            if (!t)
+                break;
+            out.push(t);
+        }
+        return out;
+    }
+    relationshipsOf(fqn) {
+        return this.refsFrom(fqn).filter((r) => r.kind === "relationship")
+            .map((r) => ({ name: r.via, toFqn: r.to, cardinality: r.cardinality ?? "" }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    relHref(fromHref, toHref) {
+        const fromParts = fromHref.split("/");
+        const toParts = toHref.split("/");
+        // Remove the filename from fromHref to get the directory
+        fromParts.pop();
+        // Find the common prefix length
+        // Note: toParts.length - 1 excludes the filename segment, comparing only directories
+        let commonLen = 0;
+        for (let i = 0; i < Math.min(fromParts.length, toParts.length - 1); i++) {
+            if (fromParts[i] === toParts[i]) {
+                commonLen++;
+            }
+            else {
+                break;
+            }
+        }
+        // Calculate levels to go up
+        const up = fromParts.length - commonLen;
+        // Get the remaining path from the common ancestor
+        const remaining = toParts.slice(commonLen).join("/");
+        // Construct the relative path
+        return up > 0 ? "../".repeat(up) + remaining : remaining;
+    }
+}
+//# sourceMappingURL=link-graph.js.map

package/dist/link-graph.js.map

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

package/dist/load.d.ts

@@ -0,0 +1,11 @@
+import type { MetaData, MetaRoot } from "@metaobjectsdev/metadata";
+export interface LoadedModel {
+    root: MetaRoot;
+    warnings: string[];
+    sourceDirs: string[];
+}
+/** Load N metadata source dirs into ONE root via a staging dir of symlinks. */
+export declare function loadModel(sourceDirs: string[]): Promise<LoadedModel>;
+/** Which top-level source dir a node came from (first file path segment of its source envelope). */
+export declare function treeOf(node: MetaData, model: LoadedModel): string;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,+EAA+E;AAC/E,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAyB1E;AAED,oGAAoG;AACpG,wBAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAKjE"}

package/dist/load.js

@@ -0,0 +1,40 @@
+import { mkdtempSync, rmSync, symlinkSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { MetaDataLoader, composeRegistry, coreTypesProvider, dbProvider, docProvider, promptProvider, uiProvider } from "@metaobjectsdev/metadata";
+/** Load N metadata source dirs into ONE root via a staging dir of symlinks. */
+export async function loadModel(sourceDirs) {
+    const staging = mkdtempSync(join(tmpdir(), "metadocs-"));
+    try {
+        const usedBasenames = new Set();
+        for (const dir of sourceDirs) {
+            const baseName = basename(dir);
+            if (usedBasenames.has(baseName)) {
+                throw new Error(`duplicate source dir basename: ${baseName}`);
+            }
+            usedBasenames.add(baseName);
+            symlinkSync(resolve(dir), join(staging, baseName));
+        }
+        const registry = composeRegistry([coreTypesProvider, dbProvider, docProvider, promptProvider, uiProvider]);
+        const result = await MetaDataLoader.fromDirectory(staging, { registry, strict: false });
+        if (result.errors.length > 0) {
+            throw new Error(`metadata load failed:\n${result.errors.map((e) => String(e)).join("\n")}`);
+        }
+        return {
+            root: result.root,
+            warnings: result.warnings.map((w) => w.message),
+            sourceDirs: sourceDirs.map((d) => basename(resolve(d))),
+        };
+    }
+    finally {
+        rmSync(staging, { recursive: true, force: true });
+    }
+}
+/** Which top-level source dir a node came from (first file path segment of its source envelope). */
+export function treeOf(node, model) {
+    const src = node.source;
+    const f = src.files?.[0] ?? "";
+    const seg = f.replace(/\\/g, "/").split("/")[0] ?? "";
+    return model.sourceDirs.includes(seg) ? seg : (model.sourceDirs[0] ?? "");
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

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

package/dist/mermaid.d.ts

@@ -0,0 +1,56 @@
+export interface ErEdge {
+    parent: string;
+    child: string;
+    label: string;
+    cardinality?: "one" | "many" | undefined;
+}
+export declare const THEME_INIT: string;
+export declare function packageFlowchart(edges: {
+    from: string;
+    to: string;
+    n: number;
+}[], counts: Map<string, number>): string;
+export declare function inheritanceTree(rows: {
+    name: string;
+    level: number;
+    self?: boolean;
+}[]): string;
+export declare const RICH_MAX = 8;
+export declare function domainColor(pkg: string): {
+    fill: string;
+    stroke: string;
+    text: string;
+};
+export interface ErAttr {
+    type: string;
+    name: string;
+    key: "PK" | "FK" | "UK" | "";
+    note: string;
+}
+export interface ErNode {
+    name: string;
+    pkg: string;
+    role: "focal" | "view" | "external" | "normal";
+    kind?: string;
+    attrs: ErAttr[];
+    more: number;
+}
+export declare function erDiagramRich(nodes: ErNode[], edges: ErEdge[]): string;
+export declare function flowchartDomain(nodes: {
+    name: string;
+    pkg: string;
+    kind?: string;
+}[], edges: {
+    from: string;
+    to: string;
+    label?: string;
+    style?: "dashed" | undefined;
+}[]): {
+    mermaid: string;
+    legend: {
+        pkg: string;
+        fill: string;
+        stroke: string;
+    }[];
+};
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../src/mermaid.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;CAAE;AAInH,eAAO,MAAM,UAAU,QAIK,CAAC;AAO7B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAOtH;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,MAAM,CAgB/F;AAGD,eAAO,MAAM,QAAQ,IAAI,CAAC;AAiB1B,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKvF;AAGD,MAAM,WAAW,MAAM;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AACnG,MAAM,WAAW,MAAM;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AAMpJ,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAsBtE;AAWD,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACrD,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CAAE,EAAE,GAClF;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CA8B9E"}

package/dist/mermaid.js

@@ -0,0 +1,136 @@
+// base theme is the only theme that honors custom themeVariables; the built-in `dark`
+// theme renders attribute-bearing ERDs unreadably. Surfaces match the site's dark palette.
+export const THEME_INIT = `%%{init: {'theme':'base','themeVariables':{'darkMode':true,'background':'#0b1220',` +
+    `'primaryColor':'#1e2a3a','primaryTextColor':'#cbd5e1','primaryBorderColor':'#4a7fa5',` +
+    `'lineColor':'#64748b','secondaryColor':'#1a2535','tertiaryColor':'#0f1826',` +
+    `'fontSize':'13px'}}}%%\n`;
+const safe = (s) => s.replace(/"/g, "'");
+const nodeId = (s) => s.replace(/[^a-zA-Z0-9_]/g, "_");
+const edgeSort = (a, b) => a.parent.localeCompare(b.parent) || a.child.localeCompare(b.child) || a.label.localeCompare(b.label);
+export function packageFlowchart(edges, counts) {
+    const lines = [THEME_INIT + "flowchart LR"];
+    const used = new Set(edges.flatMap((e) => [e.from, e.to]));
+    for (const p of [...used].sort())
+        lines.push(`  ${p}["${safe(p)} · ${counts.get(p) ?? 0}"]`);
+    for (const e of [...edges].sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to)))
+        lines.push(`  ${e.from} -->|${e.n}| ${e.to}`);
+    return lines.join("\n");
+}
+export function inheritanceTree(rows) {
+    const lines = [THEME_INIT + "flowchart TD"];
+    const ordered = [...rows].sort((a, b) => a.level - b.level || a.name.localeCompare(b.name));
+    for (const r of ordered)
+        lines.push(`  ${nodeId(r.name)}["${safe(r.name)}"]${r.self ? ":::self" : ""}`);
+    // connect each node to the alphabetically-first node one level below it whose ancestor it is:
+    // for a simple chain+children, link consecutive levels deterministically.
+    const byLevel = new Map();
+    for (const r of ordered)
+        (byLevel.get(r.level) ?? byLevel.set(r.level, []).get(r.level)).push(nodeId(r.name));
+    const levels = [...byLevel.keys()].sort((a, b) => a - b);
+    for (let i = 1; i < levels.length; i++) {
+        const parents = byLevel.get(levels[i - 1]);
+        const parent = parents[parents.length - 1]; // the chain node at the shallower level
+        for (const child of byLevel.get(levels[i]).sort())
+            lines.push(`  ${parent} --> ${child}`);
+    }
+    lines.push("  classDef self fill:#1e3a5f,stroke:#60a5fa,color:#e2e8f0,font-weight:bold");
+    return lines.join("\n");
+}
+// ---- v2 diagram system: domain palette + rich/simple emitters ----
+export const RICH_MAX = 8;
+const ROLE_STROKE = { focal: "#60a5fa", view: "#2dd4bf", external: "#334155", normal: "#3b5170" };
+// Deterministic domain palette — a fixed set of dark-surface color slots. Every
+// package's leaf name hashes into a slot, so the same package always renders the
+// same color, with no hardcoded domain→color vocabulary baked in.
+const PALETTE = [
+    { fill: "#1e3a5f", stroke: "#60a5fa", text: "#93c5fd" },
+    { fill: "#3b2f1e", stroke: "#fbbf24", text: "#fde68a" },
+    { fill: "#3f2d5c", stroke: "#a78bfa", text: "#ede9fe" },
+    { fill: "#3f1f2e", stroke: "#fb7185", text: "#fecdd3" },
+    { fill: "#14342b", stroke: "#34d399", text: "#a7f3d0" },
+    { fill: "#1f2937", stroke: "#94a3b8", text: "#e2e8f0" },
+    { fill: "#2a2440", stroke: "#818cf8", text: "#e0e7ff" },
+    { fill: "#1a2e35", stroke: "#22d3ee", text: "#cffafe" },
+    { fill: "#332018", stroke: "#fb923c", text: "#fed7aa" },
+    { fill: "#1c2431", stroke: "#64748b", text: "#cbd5e1" },
+];
+export function domainColor(pkg) {
+    const leaf = pkg.split("::").pop() ?? pkg;
+    // stable slot: hash the leaf name deterministically into the palette
+    let h = 0;
+    for (let i = 0; i < leaf.length; i++)
+        h = (h * 31 + leaf.charCodeAt(i)) >>> 0;
+    return PALETTE[h % PALETTE.length];
+}
+const cls = (pkg) => `d_${(pkg.split("::").pop() ?? pkg).replace(/[^a-zA-Z0-9]/g, "_")}`;
+// erDiagram can't vary box shape, so KIND is encoded as a border dash + a glyph prefix in the box title.
+const KIND_DASH = { value: ",stroke-dasharray:5 3", projection: ",stroke-dasharray:2 2" };
+const KIND_GLYPH = { entity: "▭", value: "⬭", projection: "▱" };
+const kindGlyph = (kind) => KIND_GLYPH[kind ?? ""] ?? "▭";
+export function erDiagramRich(nodes, edges) {
+    const lines = [THEME_INIT + "erDiagram"];
+    for (const n of [...nodes].sort((a, b) => a.name.localeCompare(b.name))) {
+        lines.push(`  ${nodeId(n.name)}["${kindGlyph(n.kind)} ${safe(n.name)}"] {`);
+        for (const a of n.attrs) {
+            const keyPart = a.key ? ` ${a.key}` : "";
+            lines.push(`    ${a.type} ${a.name}${keyPart} "${safe(a.note)}"`);
+        }
+        if (n.more > 0)
+            lines.push(`    _ plus "+${n.more} more"`);
+        lines.push("  }");
+    }
+    for (const e of [...edges].sort(edgeSort)) {
+        const conn = e.cardinality === "many" ? "}o--o{" : "||--o{";
+        lines.push(`  ${nodeId(e.parent)} ${conn} ${nodeId(e.child)} : "${safe(e.label)}"`);
+    }
+    // one classDef per entity: fill = domain, stroke = role
+    for (const n of [...nodes].sort((a, b) => a.name.localeCompare(b.name))) {
+        const dc = domainColor(n.pkg);
+        lines.push(`  ${nodeId(n.name)}:::c_${nodeId(n.name)}`);
+        lines.push(`  classDef c_${nodeId(n.name)} fill:${dc.fill},stroke:${ROLE_STROKE[n.role]},color:#cbd5e1${KIND_DASH[n.kind ?? ""] ?? ""}`);
+    }
+    return lines.join("\n");
+}
+// node shape encodes object KIND: entity = rectangle, value object = stadium (rounded ends),
+// projection/view = parallelogram. Domain is the fill color; kind is the silhouette.
+function shapeDecl(id, label, kind) {
+    const l = `"${label}"`;
+    if (kind === "value")
+        return `${id}([${l}])`;
+    if (kind === "projection")
+        return `${id}[/${l}/]`;
+    return `${id}[${l}]`; // entity / default
+}
+export function flowchartDomain(nodes, edges) {
+    const lines = [THEME_INIT + "flowchart LR"];
+    const kindByName = new Map(nodes.map((n) => [n.name, n.kind]));
+    // collect all node names (from node list + edge endpoints), deduplicate, declare with explicit labels
+    const allNodeNames = new Set([
+        ...nodes.map((n) => n.name),
+        ...edges.flatMap((e) => [e.from, e.to]),
+    ]);
+    for (const name of [...allNodeNames].sort())
+        lines.push(`  ${shapeDecl(nodeId(name), safe(name), kindByName.get(name))}`);
+    // edge labels must not contain flowchart-breaking chars (parens, pipes, brackets, braces)
+    const edgeLabel = (s) => s.replace(/["|(){}\[\]]/g, "").replace(/\s+/g, " ").trim();
+    for (const e of [...edges].sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to))) {
+        const lbl = e.label ? edgeLabel(e.label) : "";
+        const arrow = e.style === "dashed" ? "-.->" : "-->";
+        lines.push(lbl ? `  ${nodeId(e.from)} ${arrow}|${lbl}| ${nodeId(e.to)}` : `  ${nodeId(e.from)} ${arrow} ${nodeId(e.to)}`);
+    }
+    // group node names by domain class, assign, and emit one classDef per used domain
+    const byCls = new Map();
+    for (const n of [...nodes].sort((a, b) => a.name.localeCompare(b.name))) {
+        const c = cls(n.pkg);
+        (byCls.get(c) ?? byCls.set(c, { pkg: n.pkg, ids: [] }).get(c)).ids.push(nodeId(n.name));
+    }
+    for (const [c, g] of [...byCls.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+        const dc = domainColor(g.pkg);
+        lines.push(`  class ${g.ids.sort().join(",")} ${c}`);
+        lines.push(`  classDef ${c} fill:${dc.fill},stroke:${dc.stroke},color:${dc.text}`);
+    }
+    const legend = [...new Map(nodes.map((n) => [n.pkg, n.pkg])).keys()].sort()
+        .map((pkg) => ({ pkg, fill: domainColor(pkg).fill, stroke: domainColor(pkg).stroke }));
+    return { mermaid: lines.join("\n"), legend };
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/mermaid.js.map

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

package/dist/mustache-highlight.d.ts

@@ -0,0 +1,10 @@
+export interface HighlightResult {
+    html: string;
+    toc: {
+        name: string;
+        anchor: string;
+    }[];
+    refs: string[];
+}
+export declare function highlightMustache(src: string, resolveHref: (p: string) => string | undefined): HighlightResult;
+//# sourceMappingURL=mustache-highlight.d.ts.map

package/dist/mustache-highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mustache-highlight.d.ts","sourceRoot":"","sources":["../src/mustache-highlight.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;CAAE;AAI3G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,eAAe,CAsC9G"}

package/dist/mustache-highlight.js

@@ -0,0 +1,55 @@
+const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+export function highlightMustache(src, resolveHref) {
+    let out = "";
+    const toc = [];
+    const refs = [];
+    let depth = 0;
+    let i = 0;
+    while (i < src.length) {
+        const open = src.indexOf("{{", i);
+        if (open === -1) {
+            out += esc(src.slice(i));
+            break;
+        }
+        out += esc(src.slice(i, open));
+        const triple = src.startsWith("{{{", open);
+        const close = src.indexOf(triple ? "}}}" : "}}", open);
+        if (close === -1) {
+            out += esc(src.slice(open));
+            break;
+        }
+        const end = close + (triple ? 3 : 2);
+        const rawTok = src.slice(open, end);
+        const inner = src.slice(open + (triple ? 3 : 2), close).trim();
+        const sigil = triple ? "{" : inner[0] ?? "";
+        const name = triple ? inner : inner.replace(/^[#^\/>!&]\s*/, "");
+        const span = (cls, extra = "") => `<span class="${cls}"${extra}>${esc(rawTok)}</span>`;
+        if (!triple && sigil === "!")
+            out += span("mu-com");
+        else if (!triple && sigil === ">")
+            out += span("mu-par");
+        else if (!triple && (sigil === "#" || sigil === "^")) {
+            refs.push(name);
+            const href = resolveHref(name);
+            if (depth === 0 && sigil === "#") {
+                toc.push({ name, anchor: `sec-${name}` });
+            }
+            const idAttr = depth === 0 && sigil === "#" ? ` id="sec-${esc(name)}"` : "";
+            out += href ? `<a href="${esc(href)}" class="mu-sec"${idAttr}>${esc(rawTok)}</a>` : span("mu-sec mu-unresolved", idAttr);
+            depth++;
+        }
+        else if (!triple && sigil === "/") {
+            depth = Math.max(0, depth - 1);
+            out += span("mu-sec");
+        }
+        else {
+            refs.push(name);
+            const cls = triple || sigil === "&" ? "mu-raw" : "mu-var";
+            const href = resolveHref(name);
+            out += href ? `<a href="${esc(href)}" class="${cls}">${esc(rawTok)}</a>` : span(`${cls} mu-unresolved`);
+        }
+        i = end;
+    }
+    return { html: out, toc, refs };
+}
+//# sourceMappingURL=mustache-highlight.js.map

package/dist/mustache-highlight.js.map

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

package/dist/package-docs.d.ts

@@ -0,0 +1,12 @@
+import { LinkGraph } from "./link-graph";
+export interface PackageDoc {
+    title: string;
+    description: string;
+}
+export declare function harvestPackageDocs(sourceDirs: string[]): Map<string, PackageDoc>;
+export declare function keyEntities(pkg: string, g: LinkGraph, n?: number): {
+    name: string;
+    href: string;
+    inbound: number;
+}[];
+//# sourceMappingURL=package-docs.d.ts.map

package/dist/package-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-docs.d.ts","sourceRoot":"","sources":["../src/package-docs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAS,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,UAAU;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;CAAE;AAEnE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAiBhF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,SAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAM/G"}

package/dist/package-docs.js

@@ -0,0 +1,34 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parse } from "yaml";
+import { LinkGraph, fqnOf } from "./link-graph";
+export function harvestPackageDocs(sourceDirs) {
+    const out = new Map();
+    const walk = (d) => {
+        for (const e of readdirSync(d)) {
+            const p = join(d, e);
+            if (statSync(p).isDirectory())
+                walk(p);
+            else if (e === "_package.yaml") {
+                try {
+                    const y = parse(readFileSync(p, "utf8"));
+                    const m = y?.metadata;
+                    if (m?.package)
+                        out.set(m.package, { title: String(m.title ?? ""), description: String(m.description ?? "") });
+                }
+                catch { /* malformed _package.yaml is skipped; coverage/anomalies surface it elsewhere */ }
+            }
+        }
+    };
+    for (const d of sourceDirs)
+        walk(d);
+    return out;
+}
+export function keyEntities(pkg, g, n = 4) {
+    return g.nodes()
+        .filter((dn) => dn.kind === "object" && dn.pkg === pkg && !dn.node.isAbstract)
+        .map((dn) => ({ name: dn.name, href: dn.href, inbound: g.refsTo(fqnOf(dn.node)).filter((r) => r.kind !== "extends").length }))
+        .sort((a, b) => b.inbound - a.inbound || a.name.localeCompare(b.name))
+        .slice(0, n);
+}
+//# sourceMappingURL=package-docs.js.map