@loomwork/blueprint-runtime 0.0.0-stage → 0.1.0

package/dist/esm/catalog.js

@@ -0,0 +1,430 @@
+import { hasLayoutId, isLayoutRole } from "./layout";
+import { IR_VERSIONS_READ_AS_IS, IR_VERSION_LEGACY, asCell, isWidget } from "./normalize";
+/** Identity helper — declare a catalogue with inferred types. */
+export function defineWidgetCatalog(catalog) {
+    return catalog;
+}
+export const BUILTIN_CATALOG_ID = "loom.builtin.v1";
+/**
+ * The eight widgets `@loomwork/blueprint-runtime` ships, as a catalogue.
+ *
+ * `props` mirrors each builder's props interface minus `title` (hoisted onto
+ * `Widget.title`) and minus `binding` (reserved). Every built-in requires a
+ * binding — none of them render anything without one.
+ */
+export const builtinCatalog = {
+    id: BUILTIN_CATALOG_ID,
+    entries: [
+        { kind: "MetricCard", props: ["unit", "format"], binding: "required" },
+        { kind: "Timeline", props: ["maxItems"], binding: "required" },
+        { kind: "ApprovalCard", props: ["approveLabel", "rejectLabel"], binding: "required" },
+        { kind: "StatusBadge", props: [], binding: "required" },
+        { kind: "ProgressBar", props: ["max"], binding: "required" },
+        { kind: "DataTable", props: ["columns"], binding: "required" },
+        { kind: "AlertCard", props: ["severity"], binding: "required" },
+        { kind: "StreamingText", props: ["placeholder"], binding: "required" },
+    ],
+};
+/** Duplicated into `props` by every built-in builder; never a payload. */
+const RESERVED_PROPS = new Set(["binding"]);
+const KNOWN_IR_VERSIONS = new Set([IR_VERSION_LEGACY, ...IR_VERSIONS_READ_AS_IS]);
+const DATA_CLASSES = new Set(["secret", "sensitive", "internal"]);
+const DOTTED = /^[^.\s]+(\.[^.\s]+)*$/;
+/**
+ * A blueprint is DATA a model may have composed, so the walk cannot assume its own types hold.
+ * A `Layout` here is structural: an object with a `type` and an array of `children`. Anything
+ * else reaching the stack — `null`, a string, a `GridCell` stranded in a flex/stack — is a
+ * `malformed-node` finding, never a property access on a non-object.
+ */
+const isLayoutNode = (n) => typeof n === "object" &&
+    n !== null &&
+    "type" in n &&
+    Array.isArray(n.children);
+/**
+ * Iterative walk — an explicit stack, so a deep tree cannot blow the call stack.
+ * Visits widgets (pre-order) and grid cells. A grid's cells are visited in
+ * forward sibling order (so findings on them read in document order) before
+ * their nodes are pushed onto the stack in reverse, which keeps the overall
+ * widget walk pre-order.
+ *
+ * The loop is length-driven rather than `pop() !== undefined`: a literal `undefined` child is
+ * one of the malformed shapes this walk must REPORT, and a sentinel loop would silently end the
+ * walk on it instead.
+ */
+function eachNode(root, visit) {
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (isWidget(node)) {
+            visit({ widget: node });
+            continue;
+        }
+        if (!isLayoutNode(node)) {
+            visit({ malformed: { node } });
+            continue;
+        }
+        // `undefined` is absent (it does not survive serialisation, and every builder omits it).
+        // A malformed id is ABSENT for every other purpose: it names nothing and collides with nothing.
+        const id = node.id;
+        const nodeId = hasLayoutId(node) ? node.id : "<layout>";
+        if (hasLayoutId(node))
+            visit({ layoutId: { id: node.id } });
+        else if (id !== undefined)
+            visit({ layoutIdInvalid: { id } });
+        const role = node.role;
+        if (role !== undefined && !isLayoutRole(role))
+            visit({ roleInvalid: { role, nodeId } });
+        if (node.type === "grid") {
+            const children = node.children;
+            const columns = node.columns;
+            // A grid with no usable column count cannot place ANY cell, so every span would be
+            // "out of range" against it. Report the cause once and skip the cascade.
+            const columnsOk = Number.isInteger(columns) && columns >= 1;
+            if (!columnsOk) {
+                visit({ columnsInvalid: { columns, nodeId } });
+            }
+            else {
+                for (let i = 0; i < children.length; i++) {
+                    const c = asCell(children[i]);
+                    visit({
+                        cell: {
+                            span: c.span ?? 1,
+                            columns: columns,
+                            cellNodeId: isWidget(c.node)
+                                ? c.node.id
+                                : hasLayoutId(c.node)
+                                    ? c.node.id
+                                    : undefined,
+                            row: c.row,
+                            rowSpan: c.rowSpan,
+                            column: c.column,
+                        },
+                    });
+                }
+            }
+            for (let i = children.length - 1; i >= 0; i--) {
+                stack.push(asCell(children[i]).node);
+            }
+        }
+        else {
+            const children = node.children;
+            for (let i = children.length - 1; i >= 0; i--) {
+                stack.push(children[i]);
+            }
+        }
+    }
+}
+/** A bounded description of a malformed role or id: a model-composed value can be any size. */
+function describeValue(value) {
+    if (typeof value !== "string") {
+        if (value === null)
+            return "null";
+        return Array.isArray(value) ? "(an array)" : `(a ${typeof value})`;
+    }
+    return value.length > 64
+        ? `${JSON.stringify(value.slice(0, 64))}… (${value.length} chars)`
+        : JSON.stringify(value);
+}
+/** A short, safe description of a malformed node for a finding message. */
+function describeNode(node) {
+    if (node === null)
+        return "null";
+    if (Array.isArray(node))
+        return "an array";
+    const t = typeof node;
+    if (t !== "object")
+        return `a ${t}`;
+    if ("node" in node)
+        return "a GridCell outside a grid";
+    return "an object with no layout `type` or `children`";
+}
+const isPositiveInt = (v) => Number.isInteger(v) && v >= 1;
+const show = (v) => JSON.stringify(v) ?? String(v);
+/**
+ * Why a cell's placement cannot be laid out — empty when it can. `spanOk` gates the overflow
+ * test so an invalid span is reported once (as `span-out-of-range`), not again as an overflow.
+ */
+function placementProblems(c) {
+    const out = [];
+    if (c.row !== undefined && !isPositiveInt(c.row))
+        out.push(`row ${show(c.row)} is not a positive integer`);
+    if (c.rowSpan !== undefined && !isPositiveInt(c.rowSpan))
+        out.push(`rowSpan ${show(c.rowSpan)} is not a positive integer`);
+    if (c.column !== undefined) {
+        if (!isPositiveInt(c.column) || c.column > c.columns)
+            out.push(`column ${show(c.column)} is outside 1..${c.columns}`);
+        else if (c.spanOk && c.column + c.span - 1 > c.columns)
+            out.push(`column ${c.column} + span ${c.span} overflows the ${c.columns}-column grid`);
+    }
+    return out;
+}
+/**
+ * Check a blueprint against a catalogue. Never throws; returns every finding it
+ * can see in one pass, so a caller degrades or records a gap on the whole report
+ * rather than on the first failure.
+ */
+export function validateBlueprint(blueprint, catalog) {
+    const entries = new Map();
+    for (const entry of catalog.entries)
+        entries.set(entry.kind, entry);
+    const projections = new Set(blueprint.projections);
+    const findings = [];
+    // ONE namespace: widget ids and layout ids (IR 2.4.0) are both node identity.
+    // The value records which kind of node claimed the id first, so a widget↔widget collision keeps
+    // its message and a collision involving a layout says so.
+    const seenIds = new Map();
+    let widgets = 0;
+    if (blueprint.irVersion !== undefined && !KNOWN_IR_VERSIONS.has(blueprint.irVersion)) {
+        findings.push({
+            code: "ir-version-unknown",
+            severity: "error",
+            nodeId: "<layout>",
+            kind: "<layout>",
+            message: `irVersion "${blueprint.irVersion}" is not a version this module recognizes — a reader may not know how to interpret the artifact`,
+        });
+    }
+    eachNode(blueprint.layout, (v) => {
+        if (v.layoutId) {
+            const { id } = v.layoutId;
+            if (seenIds.has(id)) {
+                findings.push({
+                    code: "duplicate-node-id",
+                    severity: "error",
+                    nodeId: id,
+                    kind: "<layout>",
+                    message: `a layout shares the id "${id}" with an earlier node — widget and layout ids are one namespace, so node identity and the renderer's key collide`,
+                });
+            }
+            if (!seenIds.has(id))
+                seenIds.set(id, "layout");
+            return;
+        }
+        if (v.layoutIdInvalid) {
+            findings.push({
+                code: "layout-id-invalid",
+                severity: "warn",
+                nodeId: "<layout>",
+                kind: "<layout>",
+                message: `layout id ${describeValue(v.layoutIdInvalid.id)} is not a non-empty string — renderers treat it as absent and key this container by position, so its state is not kept across a recompose`,
+            });
+            return;
+        }
+        if (v.columnsInvalid) {
+            findings.push({
+                code: "columns-invalid",
+                severity: "error",
+                nodeId: v.columnsInvalid.nodeId,
+                kind: "<layout>",
+                message: `grid columns ${JSON.stringify(v.columnsInvalid.columns) ?? "undefined"} is not a positive integer — there is no column count to place cells into, so this grid's spans are not checked`,
+            });
+            return;
+        }
+        if (v.roleInvalid) {
+            findings.push({
+                code: "role-invalid",
+                severity: "warn",
+                nodeId: v.roleInvalid.nodeId,
+                kind: "<layout>",
+                message: `layout role ${describeValue(v.roleInvalid.role)} is not a well-formed role (a lowercase letter, then lowercase letters, digits or hyphens, at most 64 characters) — renderers draw the plain container`,
+            });
+            return;
+        }
+        if (v.malformed) {
+            findings.push({
+                code: "malformed-node",
+                severity: "error",
+                nodeId: "<layout>",
+                kind: "<layout>",
+                message: `a layout child is neither a Widget nor a Layout (${describeNode(v.malformed.node)}) — it renders nothing, and the subtree below it is not validated`,
+            });
+            return;
+        }
+        if (v.cell) {
+            const { span, columns, cellNodeId, row, rowSpan, column } = v.cell;
+            const spanOk = Number.isInteger(span) && span >= 1 && span <= columns;
+            if (!spanOk) {
+                findings.push({
+                    code: "span-out-of-range",
+                    severity: "error",
+                    nodeId: cellNodeId ?? "<layout>",
+                    kind: "<layout>",
+                    message: `cell span ${span} is outside 1..${columns} — a renderer cannot lay this cell out`,
+                });
+            }
+            const problems = placementProblems({ row, rowSpan, column, span, spanOk, columns });
+            if (problems.length > 0) {
+                findings.push({
+                    code: "placement-out-of-range",
+                    severity: "error",
+                    nodeId: cellNodeId ?? "<layout>",
+                    kind: "<layout>",
+                    message: `cell placement cannot be laid out — ${problems.join("; ")}`,
+                });
+            }
+            return;
+        }
+        const widget = v.widget;
+        if (!widget)
+            return;
+        widgets++;
+        const { id, kind } = widget;
+        const earlier = seenIds.get(id);
+        if (earlier !== undefined) {
+            findings.push({
+                code: "duplicate-node-id",
+                severity: "error",
+                nodeId: id,
+                kind,
+                message: earlier === "widget"
+                    ? `two widgets share the id "${id}" — node identity and the renderer's key collide, so one silently replaces the other`
+                    : `a widget shares the id "${id}" with an earlier layout — widget and layout ids are one namespace, so node identity and the renderer's key collide`,
+            });
+        }
+        else {
+            seenIds.set(id, "widget");
+        }
+        // IR 2.5.0: `source.redacted` is `true` or absent (an explicit `undefined` is absent), and a
+        // redacted widget carries nothing it withheld: no binding, no title, no props, no degradedFrom,
+        // and the constant source type/version. Runs BEFORE the unknown-kind return, so a redacted
+        // widget of an unknown kind that still carries data is caught too.
+        {
+            const rs = widget.source;
+            if (rs !== null && typeof rs === "object" && rs.redacted !== undefined) {
+                const bad = (message) => findings.push({ code: "redacted-invalid", severity: "error", nodeId: id, kind, message });
+                if (rs.redacted !== true) {
+                    bad(`widget.source.redacted must be true or absent, got ${JSON.stringify(rs.redacted)}`);
+                }
+                else {
+                    const leaks = [];
+                    if (widget.binding !== undefined)
+                        leaks.push("binding");
+                    if (widget.title !== undefined)
+                        leaks.push("title");
+                    if (widget.props && Object.keys(widget.props).length > 0)
+                        leaks.push("props");
+                    if (rs.degradedFrom !== undefined)
+                        leaks.push("source.degradedFrom");
+                    if (rs.type !== "redacted" || rs.version !== "1")
+                        leaks.push(`original source type/version (must be "redacted"/"1")`);
+                    if (leaks.length > 0)
+                        bad(`a redacted widget must carry no ${leaks.join(" and no ")} — it would leave the withheld content on the artifact`);
+                }
+            }
+        }
+        const entry = entries.get(kind);
+        if (!entry) {
+            findings.push({
+                code: "unknown-kind",
+                severity: "error",
+                nodeId: id,
+                kind,
+                message: `"${kind}" is not in catalogue "${catalog.id}" — a composer may only assemble from the audited set`,
+            });
+            // Nothing further is checkable without an entry: the allow-list and the
+            // binding requirement both come from it. Reporting invented follow-on
+            // findings here would inflate the count for one real defect.
+            return;
+        }
+        if (entry.binding === "required" && !widget.binding) {
+            findings.push({
+                code: "missing-binding",
+                severity: "error",
+                nodeId: id,
+                kind,
+                message: `"${kind}" renders bound data but carries no binding — it would render blank with no error`,
+            });
+        }
+        if (entry.binding === "none" && widget.binding) {
+            findings.push({
+                code: "unexpected-binding",
+                severity: "warn",
+                nodeId: id,
+                kind,
+                message: `"${kind}" is declared as taking no binding, but this widget carries one`,
+            });
+        }
+        if (widget.binding && !projections.has(widget.binding.projectionId)) {
+            findings.push({
+                code: "undeclared-projection",
+                severity: "error",
+                nodeId: id,
+                kind,
+                message: `binds to projection "${widget.binding.projectionId}", which the blueprint does not declare — renderers hydrate only declared projections, so this widget resolves to undefined and renders blank`,
+            });
+        }
+        const allowed = new Set(entry.props);
+        for (const prop of Object.keys(widget.props)) {
+            if (RESERVED_PROPS.has(prop) || allowed.has(prop))
+                continue;
+            findings.push({
+                code: "undeclared-prop",
+                severity: "error",
+                nodeId: id,
+                kind,
+                message: `prop "${prop}" is not declared by "${kind}" in catalogue "${catalog.id}" — a blueprint carries bindings, never fetched data, and an undeclared prop is how data gets inlined into a shared artifact`,
+            });
+        }
+        // `binding` and `source` are typed, but a blueprint is data a model can compose —
+        // a malformed value (null, a string, ...) must be a finding, never a property
+        // access on a non-object, so every read below goes through a typeof guard first.
+        const status = widget.binding?.status;
+        if (status !== undefined) {
+            const path = status !== null && typeof status === "object"
+                ? status.path
+                : undefined;
+            if (typeof path !== "string" || path === "" || !DOTTED.test(path)) {
+                findings.push({
+                    code: "status-path-invalid",
+                    severity: "error",
+                    nodeId: id,
+                    kind,
+                    message: `binding.status.path ${JSON.stringify(path)} is not a non-empty dotted path`,
+                });
+            }
+        }
+        const sensitivity = widget.binding?.sensitivity;
+        if (sensitivity !== undefined && !DATA_CLASSES.has(sensitivity)) {
+            findings.push({
+                code: "sensitivity-unknown",
+                severity: "error",
+                nodeId: id,
+                kind,
+                message: `binding.sensitivity ${JSON.stringify(sensitivity)} is not a @loomwork/classify DataClass`,
+            });
+        }
+        const source = widget.source;
+        if (source !== undefined) {
+            const src = source !== null && typeof source === "object"
+                ? source
+                : undefined;
+            const degradedFrom = Array.isArray(src?.degradedFrom) ? src.degradedFrom : undefined;
+            // Typed as `string`, so a NON-string is exactly what a hand-assembled artifact gets wrong.
+            // A truthiness test would accept `type: 123` and `version: {}` — both render as garbage.
+            const notAName = (v) => typeof v !== "string" || v === "";
+            const invalid = src === undefined ||
+                notAName(src.type) ||
+                notAName(src.version) ||
+                (src.degradedFrom !== undefined && degradedFrom === undefined) ||
+                (degradedFrom?.some((d) => typeof d !== "object" ||
+                    d === null ||
+                    notAName(d.type) ||
+                    notAName(d.version)) ??
+                    false);
+            if (invalid) {
+                findings.push({
+                    code: "source-invalid",
+                    severity: "error",
+                    nodeId: id,
+                    kind,
+                    message: `widget.source is missing a non-empty string "type" or "version" — either on the source itself or a degradedFrom entry (which must be an array)`,
+                });
+            }
+        }
+    });
+    return {
+        ok: findings.every((f) => f.severity !== "error"),
+        findings,
+        widgets,
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/esm/catalog.js.map

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

package/dist/esm/coverage.js

@@ -0,0 +1,19 @@
+/**
+ * Which of a catalogue's components this registry can actually render.
+ *
+ * Use it as a test in any package that ships a renderer, so adding a kind to the
+ * vocabulary without a renderer fails the build rather than the viewer.
+ */
+export function catalogCoverage(catalog, registry) {
+    const registered = new Set(registry.kinds());
+    const missing = [];
+    const declared = new Set();
+    for (const entry of catalog.entries) {
+        declared.add(entry.kind);
+        if (!registered.has(entry.kind))
+            missing.push(entry.kind);
+    }
+    const extra = [...registered].filter((kind) => !declared.has(kind));
+    return { ok: missing.length === 0, missing, extra };
+}
+//# sourceMappingURL=coverage.js.map

package/dist/esm/coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.js","sourceRoot":"","sources":["../../src/coverage.ts"],"names":[],"mappings":"AA6BA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAsB,EACtB,QAAmC;IAEnC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC"}

package/dist/esm/customWidget.js

@@ -0,0 +1,31 @@
+function stableId(kind, props) {
+    const str = kind + JSON.stringify(props, Object.keys(props).sort());
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        hash = (Math.imul(31, hash) + str.charCodeAt(i)) | 0;
+    }
+    return `${kind}-${(hash >>> 0).toString(16)}`;
+}
+// Builder for user-defined widget kinds that live outside the WidgetKind union.
+// Register a matching renderer in your RendererRegistry under the same `kind` string.
+//
+//   const HeatmapWidget = customWidget$({
+//     kind: "Heatmap",
+//     title: "CPU Heatmap",
+//     binding: { projectionId: "metrics", path: "cpu.history" },
+//     props: { buckets: 20 },
+//   });
+//   registry.register("Heatmap", HeatmapComponent);
+export function customWidget$(config) {
+    const propsRecord = config.props ?? {};
+    return {
+        _tag: "Widget",
+        id: config.id ??
+            stableId(config.kind, { title: config.title, binding: config.binding, ...propsRecord }),
+        kind: config.kind,
+        ...(config.title !== undefined && { title: config.title }),
+        props: propsRecord,
+        ...(config.binding !== undefined && { binding: config.binding }),
+    };
+}
+//# sourceMappingURL=customWidget.js.map

package/dist/esm/customWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customWidget.js","sourceRoot":"","sources":["../../src/customWidget.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/F,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAChD,CAAC;AAUD,gFAAgF;AAChF,sFAAsF;AACtF,EAAE;AACF,0CAA0C;AAC1C,uBAAuB;AACvB,4BAA4B;AAC5B,iEAAiE;AACjE,8BAA8B;AAC9B,QAAQ;AACR,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACvC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,EAAE,EACA,MAAM,CAAC,EAAE;YACT,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;QACzF,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,KAAK,EAAE,WAAW;QAClB,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/esm/identity.js

@@ -0,0 +1,116 @@
+import { hasLayoutId } from "./layout";
+import { asCell } from "./normalize";
+/**
+ * The one total, iterative, pre-order walk behind every id list below. `onWidget` sees each
+ * widget id; `onLayout` each WELL-FORMED layout id (IR 2.4.0, ADR 0101) — an absent or malformed
+ * one is skipped, exactly as a renderer treats it as absent.
+ */
+function walkNodeIds(blueprint, onWidget, onLayout) {
+    // Iterative, matching `eachNode` in catalog.ts: a deep composed tree must not be able
+    // to blow the call stack.
+    //
+    // Length-driven, not `pop() !== undefined`: a blueprint is data an agent or a composer
+    // may have authored, so a layout child CAN legitimately be `undefined` (a malformed
+    // `cell(6, undefined)`, a hole from a revision) — and `stack.pop()` returns `undefined`
+    // both for "the stack is empty" and for "the next element IS `undefined`". A sentinel
+    // loop conflates the two and stops early, silently dropping every id not yet visited.
+    // Rejecting the hole is `validateBlueprint`'s job (`malformed-node`); this walk stays
+    // total and skips only the one non-object child.
+    const stack = [blueprint.layout];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (typeof node !== "object" || node === null)
+            continue;
+        if ("_tag" in node && node._tag === "Widget") {
+            onWidget?.(node.id);
+            continue;
+        }
+        const layout = node;
+        if (!Array.isArray(layout.children))
+            continue;
+        if (onLayout !== undefined && hasLayoutId(layout))
+            onLayout(layout.id);
+        for (let i = layout.children.length - 1; i >= 0; i--) {
+            stack.push(layout.type === "grid"
+                ? asCell(layout.children[i]).node
+                : layout.children[i]);
+        }
+    }
+}
+/**
+ * Every WIDGET id in a blueprint, in pre-order. Duplicates are `validateBlueprint`'s job.
+ *
+ * Widget-only by contract, also after IR 2.4.0: callers read its output as widget ids (a
+ * renderer's remount report, the a2ui bridge's `identityDiff`). Layout ids are
+ * `blueprintLayoutIds`; `preservesBlueprintNodes` compares both.
+ */
+export function blueprintNodeIds(blueprint) {
+    const ids = [];
+    walkNodeIds(blueprint, (id) => ids.push(id), undefined);
+    return ids;
+}
+/**
+ * Every well-formed LAYOUT id in a blueprint (IR 2.4.0, ADR 0101), in pre-order, the root
+ * included. Absent and malformed ids are skipped. Duplicates are `validateBlueprint`'s job.
+ */
+export function blueprintLayoutIds(blueprint) {
+    const ids = [];
+    walkNodeIds(blueprint, undefined, (id) => ids.push(id));
+    return ids;
+}
+/**
+ * Which of `before`'s node ids survive into `after`.
+ *
+ * Two readings, one function:
+ * - *"did this revision keep the nodes it kept?"* — `before` is the previous tree;
+ * - *"does this variant contain the floor?"* — `before` is the floor's ids, and any finding
+ *   is a floor violation. Nodes above the floor land in `added`, which is exactly right:
+ *   a variant may add, never subtract.
+ *
+ * One pass over each side, `Set`-backed: O(|before| + |after|).
+ */
+export function preservesNodes(before, after) {
+    const afterIds = new Set(after);
+    const findings = [];
+    const seen = new Set();
+    for (const id of before) {
+        // A repeated id in `before` is one node's worth of identity, so report it once —
+        // otherwise a duplicated id inflates the finding count for a single lost node.
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        if (!afterIds.has(id)) {
+            findings.push({
+                code: "dropped-node-id",
+                severity: "error",
+                nodeId: id,
+                message: `node "${id}" is present before the change and absent after — either it was removed, or a prop edit re-identified it (ids are derived from kind + props unless supplied explicitly)`,
+            });
+        }
+    }
+    const added = [];
+    for (const id of afterIds) {
+        if (!seen.has(id))
+            added.push(id);
+    }
+    return { ok: findings.length === 0, findings, added, compared: seen.size };
+}
+/** Widget ids and layout ids together, in one pre-order (document) walk. */
+function allNodeIds(blueprint) {
+    const ids = [];
+    const push = (id) => {
+        ids.push(id);
+    };
+    walkNodeIds(blueprint, push, push);
+    return ids;
+}
+/**
+ * `preservesNodes` over two blueprints — the common case, spelled once. Compares widget ids AND
+ * layout ids (IR 2.4.0, ADR 0101): they are one identity axis, so a re-identified container is a
+ * `dropped-node-id` finding rather than a silent loss of the state under it. A `before` with no
+ * layout ids (any pre-2.4.0 artifact) contributes none, so upgrading only adds to `added`.
+ */
+export function preservesBlueprintNodes(before, after) {
+    return preservesNodes(allNodeIds(before), allNodeIds(after));
+}
+//# sourceMappingURL=identity.js.map

package/dist/esm/identity.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,15 @@
+export { blueprint$ } from "./Blueprint";
+export { grid, flex, stack, isLayoutId, isLayoutRole } from "./layout";
+export { asCell, cell, upgradeBlueprint, blueprintIrVersion, isBindingStatus, isWidget, resolveWidgetStatus, IR_VERSION_LEGACY, } from "./normalize";
+export { MetricCard, Timeline, ApprovalCard, StatusBadge, ProgressBar, DataTable, AlertCard, StreamingText, } from "./widgets";
+export { customWidget$ } from "./customWidget";
+export { BLUEPRINT_IR_SHAPE, BLUEPRINT_IR_VERSION } from "./irVersion";
+export { validateBlueprint, defineWidgetCatalog, builtinCatalog, BUILTIN_CATALOG_ID, } from "./catalog";
+export { catalogCoverage } from "./coverage";
+export { blueprintLayoutIds, blueprintNodeIds, preservesBlueprintNodes, preservesNodes, } from "./identity";
+export { blueprintPins, checkBlueprintPins } from "./pins";
+export { RendererRegistry } from "./RendererRegistry";
+export { traverseBlueprint, resolveWidgetValue, resolvePath } from "./traverseBlueprint";
+export { describeWidgetFrame, describeWidgetStatus } from "./widgetStatus";
+export { traverseBlueprintAsync } from "./traverseBlueprintAsync";
+//# sourceMappingURL=index.js.map