@loomwork/blueprint-runtime 0.0.0-stage → 0.1.1

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EACL,MAAM,EACN,IAAI,EACJ,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAK3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAQ3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/irVersion.js

@@ -0,0 +1,150 @@
+// ── The Blueprint as a stable rendering IR (ADR 0096) ─────────────────────────
+//
+// A `Blueprint` used to be a value one app authored and one renderer drew. Once an external
+// framework COMPILES to it, its shape is an interface others depend on, and a field added or
+// renamed here is a breaking change in a repository nothing in this workspace builds.
+//
+// So the shape is declared twice, on purpose. The types below are the truth; the manifests are a
+// second spelling that `tsc` checks against them exhaustively — `AllKeys<T>` makes every key
+// required, and `satisfies` on an object literal rejects an excess key — so any change to
+// `Widget`, `Layout` or `Blueprint` fails the build until the manifest agrees. `irVersion.test.ts`
+// then pins a digest of the manifests to BLUEPRINT_IR_VERSION, so the manifest cannot change
+// without the version changing either. Neither half is sufficient alone.
+//
+// What this guards: field presence, field optionality (a required↔optional flip fails the
+// build), the WidgetKind literals, the layout `type` literals. What it does not: a field's type
+// being narrowed or widened, nor a `readonly` change. A consumer's typecheck catches those.
+//
+// Adding a Layout variant means adding its field manifest here too; `Record<Layout["type"], true>`
+// catches the variant, not its fields.
+export const BLUEPRINT_IR_VERSION = "2.5.0";
+const WIDGET = {
+    _tag: "required",
+    id: "required",
+    kind: "required",
+    title: "optional",
+    props: "required",
+    binding: "optional",
+    source: "optional",
+};
+const DATA_BINDING = {
+    projectionId: "required",
+    path: "required",
+    status: "optional",
+    sensitivity: "optional",
+};
+const BINDING_STATUS_REF = {
+    path: "required",
+};
+const BINDING_STATUS = {
+    state: "required",
+    seq: "optional",
+    finding: "optional",
+};
+// The NESTED shapes, manifested in their own right. `KeyShape<BindingStatus>` only records that
+// `finding` exists and is optional — a key added to, removed from or flipped inside the finding
+// (or a `degradedFrom` entry) is a change to the compile target that the parent manifest cannot
+// see. A consumer reads `finding.code`/`d.type`, so those key sets are part of the contract.
+const BINDING_FINDING = {
+    code: "required",
+    message: "required",
+};
+const WIDGET_SOURCE = {
+    type: "required",
+    version: "required",
+    degradedFrom: "optional",
+    redacted: "optional",
+};
+const DEGRADED_FROM = {
+    type: "required",
+    version: "required",
+};
+const GRID_CELL = {
+    span: "optional",
+    row: "optional",
+    rowSpan: "optional",
+    column: "optional",
+    node: "required",
+};
+const BINDING_STATES = {
+    pending: true,
+    ready: true,
+    stale: true,
+    error: true,
+    empty: true,
+};
+const GRID_LAYOUT = {
+    type: "required",
+    id: "optional",
+    columns: "required",
+    gap: "optional",
+    title: "optional",
+    role: "optional",
+    children: "required",
+};
+const FLEX_LAYOUT = {
+    type: "required",
+    id: "optional",
+    direction: "required",
+    gap: "optional",
+    title: "optional",
+    role: "optional",
+    children: "required",
+};
+const STACK_LAYOUT = {
+    type: "required",
+    id: "optional",
+    gap: "optional",
+    title: "optional",
+    role: "optional",
+    children: "required",
+};
+const BLUEPRINT = {
+    _tag: "required",
+    irVersion: "optional",
+    id: "required",
+    title: "required",
+    layout: "required",
+    projections: "required",
+    projectionVersions: "optional",
+};
+const WIDGET_KINDS = {
+    MetricCard: true,
+    Timeline: true,
+    ApprovalCard: true,
+    StatusBadge: true,
+    ProgressBar: true,
+    DataTable: true,
+    AlertCard: true,
+    StreamingText: true,
+};
+const LAYOUT_TYPES = { grid: true, flex: true, stack: true };
+// Field manifests emit `"<key>:<required|optional>"` so an optional↔required flip changes the
+// digest even though the key set itself is unchanged. The two literal-union manifests (kinds,
+// layout types) have no optionality to capture, so they stay plain key lists.
+const keysOf = (manifest) => Object.entries(manifest)
+    .map(([key, shape]) => `${key}:${shape}`)
+    .sort();
+const plainKeysOf = (manifest) => Object.keys(manifest).sort();
+/**
+ * The shape of the Blueprint IR at `BLUEPRINT_IR_VERSION`, as sorted key sets. Digest this
+ * (`fnv1a64(canonicalJson(BLUEPRINT_IR_SHAPE))`) to compare two builds' IR without a type checker.
+ */
+export const BLUEPRINT_IR_SHAPE = {
+    widget: keysOf(WIDGET),
+    dataBinding: keysOf(DATA_BINDING),
+    bindingStatusRef: keysOf(BINDING_STATUS_REF),
+    bindingStatus: keysOf(BINDING_STATUS),
+    bindingFinding: keysOf(BINDING_FINDING),
+    widgetSource: keysOf(WIDGET_SOURCE),
+    degradedFrom: keysOf(DEGRADED_FROM),
+    gridCell: keysOf(GRID_CELL),
+    gridLayout: keysOf(GRID_LAYOUT),
+    flexLayout: keysOf(FLEX_LAYOUT),
+    stackLayout: keysOf(STACK_LAYOUT),
+    blueprint: keysOf(BLUEPRINT),
+    widgetKinds: plainKeysOf(WIDGET_KINDS),
+    layoutTypes: plainKeysOf(LAYOUT_TYPES),
+    bindingStates: plainKeysOf(BINDING_STATES),
+};
+//# sourceMappingURL=irVersion.js.map

package/dist/esm/irVersion.js.map

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

package/dist/esm/layout.js

@@ -0,0 +1,63 @@
+import { asCell } from "./normalize";
+// ADR 0099 D2 — a role is a registry KEY, so it has a key's shape: a lowercase ASCII letter,
+// then lowercase letters, digits or hyphens, at most 64 characters in all. No `_`, `.` or
+// uppercase, so `__proto__`/`constructor` can never be one and a role never needs escaping in a
+// CSS attribute selector (`[data-container-role=stepped]`) or a log line.
+const LAYOUT_ROLE = /^[a-z][a-z0-9-]{0,63}$/;
+/**
+ * Whether `value` is a well-formed layout role (ADR 0099 D2): `/^[a-z][a-z0-9-]{0,63}$/`. A
+ * renderer looks a container's role up only when this holds; anything else — absent, empty,
+ * a non-string, `"Stepped"`, a 65-character string — draws the plain container, exactly as an
+ * unknown role does. It is the ONE spelling of the rule, so a compiler's schema and a
+ * renderer's lookup cannot drift apart.
+ */
+export function isLayoutRole(value) {
+    return typeof value === "string" && LAYOUT_ROLE.test(value);
+}
+/**
+ * Whether `value` is a well-formed layout id (IR 2.4.0, ADR 0101): the same rule as `Widget.id`,
+ * a non-empty string — no charset, no length cap. Anything else — absent, `""`, a number, `null`
+ * — is treated as ABSENT by every reader: the container is keyed positionally, the identity walk
+ * skips it, and it collides with nothing. It is the ONE spelling of the rule, so a compiler's
+ * schema and a renderer's keying cannot drift apart (as `isLayoutRole` is for roles).
+ */
+export function isLayoutId(value) {
+    return typeof value === "string" && value !== "";
+}
+/** `isLayoutId` on a node's `id`, narrowing the node. Internal. */
+export function hasLayoutId(layout) {
+    return isLayoutId(layout?.id);
+}
+export function grid(options) {
+    return {
+        type: "grid",
+        ...(options.id !== undefined && { id: options.id }),
+        columns: options.columns,
+        ...(options.gap !== undefined && { gap: options.gap }),
+        ...(options.title !== undefined && { title: options.title }),
+        ...(options.role !== undefined && { role: options.role }),
+        children: options.children.map(asCell),
+    };
+}
+export function flex(options) {
+    return {
+        type: "flex",
+        ...(options.id !== undefined && { id: options.id }),
+        direction: options.direction ?? "row",
+        ...(options.gap !== undefined && { gap: options.gap }),
+        ...(options.title !== undefined && { title: options.title }),
+        ...(options.role !== undefined && { role: options.role }),
+        children: options.children,
+    };
+}
+export function stack(options) {
+    return {
+        type: "stack",
+        ...(options.id !== undefined && { id: options.id }),
+        ...(options.gap !== undefined && { gap: options.gap }),
+        ...(options.title !== undefined && { title: options.title }),
+        ...(options.role !== undefined && { role: options.role }),
+        children: options.children,
+    };
+}
+//# sourceMappingURL=layout.js.map

package/dist/esm/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,6FAA6F;AAC7F,0FAA0F;AAC1F,gGAAgG;AAChG,0EAA0E;AAC1E,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO,UAAU,CAAE,MAA8C,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAcD,MAAM,UAAU,IAAI,CAAC,OAAoB;IACvC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QACnD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5D,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC;AAcD,MAAM,UAAU,IAAI,CAAC,OAAoB;IACvC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QACnD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;QACrC,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5D,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC;AAaD,MAAM,UAAU,KAAK,CAAC,OAAqB;IACzC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QACnD,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5D,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC"}

package/dist/esm/normalize.js

@@ -0,0 +1,115 @@
+import { BLUEPRINT_IR_VERSION } from "./irVersion";
+export const IR_VERSION_LEGACY = "1.0.0";
+// ── Path resolution ───────────────────────────────────────────────────────────
+//
+// Lives here (not traverseBlueprint.ts) to avoid an import cycle: traverseBlueprint imports
+// `asCell` from this module, and `resolveWidgetStatus` below needs `resolvePath`. Re-exported
+// from traverseBlueprint.ts unchanged for existing consumers.
+// Resolve a dot-path (e.g. "a.b.c") against a projection state. Null-safe and
+// generic — no widget/UI coupling — so any live rendering surface can build a
+// slice selector for `ProjectionRuntime.subscribeSelector` without duplicating
+// this traversal (see useWidgetValue). An empty path binds to the whole state.
+export function resolvePath(state, path) {
+    // An empty path binds the widget to the whole projection surface (the root),
+    // not a nested field — otherwise `"".split(".")` yields `[""]` and dereferences
+    // a non-existent "" key, silently returning undefined.
+    if (path === "")
+        return state;
+    const parts = path.split(".");
+    let current = state;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+export const isWidget = (n) => typeof n === "object" && n !== null && n._tag === "Widget";
+const isCell = (n) => typeof n === "object" && n !== null && "node" in n && !("_tag" in n) && !("type" in n);
+/** The one place a legacy bare grid child becomes a cell. Every walker calls this; nothing else branches on the union. */
+export function asCell(child) {
+    return isCell(child) ? child : { span: 1, node: child };
+}
+/** An explicit-span cell, optionally placed (IR 2.1.0). Only the placement fields given are written. */
+export function cell(span, node, placement = {}) {
+    return {
+        span,
+        node,
+        ...(placement.row !== undefined && { row: placement.row }),
+        ...(placement.rowSpan !== undefined && { rowSpan: placement.rowSpan }),
+        ...(placement.column !== undefined && { column: placement.column }),
+    };
+}
+export function blueprintIrVersion(bp) {
+    return bp.irVersion ?? IR_VERSION_LEGACY;
+}
+function upgradeLayout(layout) {
+    if (layout.type === "grid") {
+        return {
+            ...layout,
+            children: layout.children.map((c) => {
+                const k = asCell(c);
+                return isWidget(k.node) ? k : { ...k, node: upgradeLayout(k.node) };
+            }),
+        };
+    }
+    return { ...layout, children: layout.children.map((c) => (isWidget(c) ? c : upgradeLayout(c))) };
+}
+/**
+ * Every IR version this build reads AS-IS. 2.1.0 (ADR 0098) and 2.2.0 (ADR 0099) only added
+ * optional fields, and 2.3.0 (ADR 0100) only a `BindingState` literal (a runtime status value
+ * no artifact carries), 2.4.0 (ADR 0101) only an optional layout `id`, and 2.5.0 (ADR 0097
+ * amendment) only an optional `source.redacted`, so a 2.0.0 through 2.4.0 artifact is already a valid current-major artifact: re-stamping it would change its
+ * content address with no change to its shape.
+ *
+ * Add the outgoing version here on every minor bump.
+ */
+export const IR_VERSIONS_READ_AS_IS = new Set([
+    "2.0.0",
+    "2.1.0",
+    "2.2.0",
+    "2.3.0",
+    "2.4.0",
+    BLUEPRINT_IR_VERSION,
+]);
+/**
+ * A current-major artifact from any readable one. Identity (same reference) on 2.0.0, 2.1.0,
+ * 2.2.0, 2.3.0, 2.4.0 and 2.5.0 input; a 1.0.0 (or unstamped) artifact is wrapped and stamped. Never
+ * mutates its input.
+ */
+export function upgradeBlueprint(bp) {
+    if (bp.irVersion !== undefined && IR_VERSIONS_READ_AS_IS.has(bp.irVersion))
+        return bp;
+    return { ...bp, irVersion: BLUEPRINT_IR_VERSION, layout: upgradeLayout(bp.layout) };
+}
+// `empty` since IR 2.3.0 (ADR 0100). A reader built before it rejects `{ state: "empty" }` here,
+// so the status resolves to `undefined` and that reader's matrix falls back to loading/ready —
+// never to the error row (ADR 0100 D4).
+const STATES = new Set(["pending", "ready", "stale", "error", "empty"]);
+export function isBindingStatus(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const s = v;
+    if (typeof s.state !== "string" || !STATES.has(s.state))
+        return false;
+    if (s.seq !== undefined && typeof s.seq !== "number")
+        return false;
+    if (s.finding !== undefined) {
+        const f = s.finding;
+        if (typeof f !== "object" ||
+            f === null ||
+            typeof f.code !== "string" ||
+            typeof f.message !== "string")
+            return false;
+    }
+    return true;
+}
+/** Status lives in the SAME projection state as the value; a malformed value is `undefined`, never a throw. */
+export function resolveWidgetStatus(widget, stateMap) {
+    const b = widget.binding;
+    if (b?.status === undefined)
+        return undefined;
+    const raw = resolvePath(stateMap.get(b.projectionId), b.status.path);
+    return isBindingStatus(raw) ? raw : undefined;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/esm/normalize.js.map

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

package/dist/esm/pins.js

@@ -0,0 +1,82 @@
+import { checkVersionPins } from "@loomwork/core";
+// ── The blueprint spelling of the binding-semantics pin (ADR 0095) ────────────
+//
+// `validateBlueprint` checks a composition against a catalogue; `preservesNodes` checks one
+// tree against another. Neither can see the failure this covers, because it is not in the
+// tree at all: a `DataBinding` names a projection, the projection is live code registered
+// under that name, and the content address that makes a promoted view "the same view"
+// freezes the NAME.
+//
+// So a view can be byte-identical to the one an operator promoted, hydrate cleanly, validate
+// cleanly, and render a number that means something else — because the fold behind
+// `latency` was edited, or its window moved from rolling to fixed, since the day it was
+// composed.
+//
+// The comparison itself is `@loomwork/core`'s `checkVersionPins`, over `id -> version` maps
+// rather than blueprints: its other consumer (`ReadModelService.checkPins`) has no tree.
+// These two functions are the blueprint case spelled once, the way `blueprintNodeIds` /
+// `preservesBlueprintNodes` spell it for identity.
+/**
+ * The versions a blueprint recorded for the projections it binds to.
+ *
+ * Only ids the blueprint actually DECLARES are returned. A pin for an id absent from
+ * `projections` freezes nothing this view reads, and counting it would pad the comparison
+ * with agreements that carry no information — the denominator problem `PinReport.compared`
+ * exists to make visible.
+ */
+export function blueprintPins(blueprint) {
+    const recorded = blueprint.projectionVersions;
+    if (recorded === undefined)
+        return emptyPins();
+    const pins = emptyPins();
+    for (const projectionId of blueprint.projections) {
+        const version = recordedVersion(recorded, projectionId);
+        if (version !== undefined)
+            pins[projectionId] = version;
+    }
+    return pins;
+}
+/**
+ * Does this blueprint still mean what it meant when it was composed?
+ *
+ * `current` is what the runtime about to hydrate it declares —
+ * `projectionRuntime.pins?.() ?? {}`. Findings, never a throw: a drift can be a deliberate
+ * re-promotion or a silent re-definition, and only the caller can tell.
+ *
+ * The comparison is scoped to the blueprint's own `projections` in BOTH directions, and
+ * every declared projection is entered on the recorded side even when nothing pinned it
+ * (as `""`, which `checkVersionPins` reads as "declared nothing"). That is deliberate:
+ * projections this view never binds are none of its business, and a binding that nobody
+ * pinned must produce a visible `unpinned` finding rather than vanishing from a report that
+ * would then read `ok: true` over an empty comparison.
+ */
+export function checkBlueprintPins(blueprint, current) {
+    const recorded = emptyPins();
+    const scoped = emptyPins();
+    for (const projectionId of blueprint.projections) {
+        recorded[projectionId] = recordedVersion(blueprint.projectionVersions, projectionId) ?? "";
+        const now = recordedVersion(current, projectionId);
+        if (now !== undefined)
+            scoped[projectionId] = now;
+    }
+    return checkVersionPins(recorded, scoped);
+}
+/**
+ * A pin map with NO prototype, built rather than written into `{}`.
+ *
+ * A blueprint is data — the whole premise of ADR 0088 is that a model may have composed it
+ * — so a `projectionId` is an untrusted string, and `{}["__proto__"] = "1"` sets a
+ * prototype instead of a key: the pin vanishes, `Object.keys` never sees it, and the
+ * binding drops out of the report entirely with no finding. Silent omission is precisely
+ * what this seam exists to prevent, so the maps it builds cannot have a prototype to hit.
+ */
+function emptyPins() {
+    return Object.create(null);
+}
+/** An OWN-property read, so an inherited member never answers for a recorded version. */
+function recordedVersion(pins, id) {
+    if (pins === undefined || !Object.hasOwn(pins, id))
+        return undefined;
+    return pins[id];
+}
+//# sourceMappingURL=pins.js.map

package/dist/esm/pins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pins.js","sourceRoot":"","sources":["../../src/pins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIlD,iFAAiF;AACjF,EAAE;AACF,4FAA4F;AAC5F,0FAA0F;AAC1F,0FAA0F;AAC1F,sFAAsF;AACtF,oBAAoB;AACpB,EAAE;AACF,6FAA6F;AAC7F,mFAAmF;AACnF,wFAAwF;AACxF,YAAY;AACZ,EAAE;AACF,4FAA4F;AAC5F,yFAAyF;AACzF,wFAAwF;AACxF,mDAAmD;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,kBAAkB,CAAC;IAC9C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,KAAK,MAAM,YAAY,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACxD,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoB,EAAE,OAAoB;IAC3E,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,KAAK,MAAM,YAAY,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QACjD,QAAQ,CAAC,YAAY,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,kBAAkB,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC;QAC3F,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnD,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC;IACpD,CAAC;IACD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,SAAS;IAChB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAC;AACvD,CAAC;AAED,yFAAyF;AACzF,SAAS,eAAe,CAAC,IAA6B,EAAE,EAAU;IAChE,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IACrE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/esm/traverseBlueprint.js

@@ -0,0 +1,38 @@
+import { asCell, isWidget, resolvePath, resolveWidgetStatus } from "./normalize";
+// Re-exported unchanged for existing consumers; it now lives in normalize.ts to avoid an
+// import cycle (normalize.ts's `resolveWidgetStatus` needs it, and this module imports
+// `asCell`/`isWidget`/`resolveWidgetStatus` from normalize.ts as of Task 2).
+export { resolvePath };
+// ── Value resolution ──────────────────────────────────────────────────────────
+export function resolveWidgetValue(widget, stateMap) {
+    if (!widget.binding)
+        return undefined;
+    const state = stateMap.get(widget.binding.projectionId);
+    return resolvePath(state, widget.binding.path);
+}
+export function traverseBlueprint(node, stateMap, options) {
+    const { renderWidget, renderContainer, onAction } = options;
+    if (isWidget(node)) {
+        const status = resolveWidgetStatus(node, stateMap);
+        return renderWidget({
+            widget: node,
+            value: resolveWidgetValue(node, stateMap),
+            ...(status !== undefined && { status }),
+            ...(onAction !== undefined && { onAction }),
+        });
+    }
+    const layout = node;
+    if (layout.type === "grid") {
+        const cells = layout.children.map(asCell).map((c) => ({
+            span: c.span ?? 1,
+            ...(c.row !== undefined && { row: c.row }),
+            ...(c.rowSpan !== undefined && { rowSpan: c.rowSpan }),
+            ...(c.column !== undefined && { column: c.column }),
+            child: traverseBlueprint(c.node, stateMap, options),
+        }));
+        return renderContainer({ layout, children: cells.map((c) => c.child), cells });
+    }
+    const children = layout.children.map((child) => traverseBlueprint(child, stateMap, options));
+    return renderContainer({ layout, children });
+}
+//# sourceMappingURL=traverseBlueprint.js.map

package/dist/esm/traverseBlueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverseBlueprint.js","sourceRoot":"","sources":["../../src/traverseBlueprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGjF,yFAAyF;AACzF,uFAAuF;AACvF,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,CAAC;AAevB,iFAAiF;AAEjF,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,QAA8B;IAC/E,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAkCD,MAAM,UAAU,iBAAiB,CAC/B,IAAqB,EACrB,QAA8B,EAC9B,OAAyC;IAEzC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE5D,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,OAAO,YAAY,CAAC;YAClB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC;YACzC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;YACvC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;YACjB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YAC1C,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACtD,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;YACnD,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC;SACpD,CAAC,CAAC,CAAC;QACJ,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7F,OAAO,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/esm/traverseBlueprintAsync.js

@@ -0,0 +1,48 @@
+import { throwIfAborted, yieldControl } from "@loomwork/scheduler";
+import { asCell, isWidget, resolveWidgetStatus } from "./normalize";
+import { resolveWidgetValue } from "./traverseBlueprint";
+const DEFAULT_YIELD_EVERY = 64;
+export async function traverseBlueprintAsync(node, stateMap, options) {
+    const { renderer, onAction, signal } = options;
+    const yieldTo = options.yieldTo ?? yieldControl;
+    const shouldYield = options.shouldYield ?? ((n) => n >= DEFAULT_YIELD_EVERY);
+    // Counter-based budget (no clock) so behavior is deterministic and testable.
+    let nodesSinceYield = 0;
+    const tick = async () => {
+        throwIfAborted(signal);
+        nodesSinceYield++;
+        if (shouldYield(nodesSinceYield)) {
+            nodesSinceYield = 0;
+            await yieldTo();
+            throwIfAborted(signal);
+        }
+    };
+    const walk = async (current) => {
+        await tick();
+        if (isWidget(current)) {
+            const status = resolveWidgetStatus(current, stateMap);
+            return renderer.createWidget({
+                widget: current,
+                value: resolveWidgetValue(current, stateMap),
+                ...(status !== undefined && { status }),
+                ...(onAction !== undefined && { onAction }),
+            });
+        }
+        const layout = current;
+        // Create the container FIRST so children can be committed into it as they
+        // resolve (incremental commit / progressive paint between yields).
+        const container = renderer.createContainer(layout);
+        // Only the iteration source changes for a grid (unwrap each child via `asCell`) — this
+        // walker has no `cells`/span surface of its own: the container is created and committed
+        // to before its children resolve, so there is nowhere to hand spans alongside them. A
+        // renderer that needs them can read `layout.children` itself in `createContainer`.
+        const nodes = layout.type === "grid" ? layout.children.map((c) => asCell(c).node) : layout.children;
+        for (const child of nodes) {
+            const childNode = await walk(child);
+            renderer.appendChild(container, childNode);
+        }
+        return container;
+    };
+    return walk(node);
+}
+//# sourceMappingURL=traverseBlueprintAsync.js.map

package/dist/esm/traverseBlueprintAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverseBlueprintAsync.js","sourceRoot":"","sources":["../../src/traverseBlueprintAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAmCzD,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAqB,EACrB,QAA8B,EAC9B,OAAqC;IAErC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC;IAE7E,6EAA6E;IAC7E,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,eAAe,EAAE,CAAC;QAClB,IAAI,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,eAAe,GAAG,CAAC,CAAC;YACpB,MAAM,OAAO,EAAE,CAAC;YAChB,cAAc,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,EAAE,OAAwB,EAAkB,EAAE;QAC9D,MAAM,IAAI,EAAE,CAAC;QAEb,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,YAAY,CAAC;gBAC3B,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAC5C,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;gBACvC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC;QACvB,0EAA0E;QAC1E,mEAAmE;QACnE,MAAM,SAAS,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACnD,uFAAuF;QACvF,wFAAwF;QACxF,sFAAsF;QACtF,mFAAmF;QACnF,MAAM,KAAK,GACT,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACxF,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;YACpC,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}