@loomwork/blueprint-runtime 0.0.0-stage → 0.1.1

package/dist/traverseBlueprint.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePath = void 0;
+exports.resolveWidgetValue = resolveWidgetValue;
+exports.traverseBlueprint = traverseBlueprint;
+const normalize_1 = require("./normalize");
+Object.defineProperty(exports, "resolvePath", { enumerable: true, get: function () { return normalize_1.resolvePath; } });
+// ── Value resolution ──────────────────────────────────────────────────────────
+function resolveWidgetValue(widget, stateMap) {
+    if (!widget.binding)
+        return undefined;
+    const state = stateMap.get(widget.binding.projectionId);
+    return (0, normalize_1.resolvePath)(state, widget.binding.path);
+}
+function traverseBlueprint(node, stateMap, options) {
+    const { renderWidget, renderContainer, onAction } = options;
+    if ((0, normalize_1.isWidget)(node)) {
+        const status = (0, normalize_1.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(normalize_1.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/traverseBlueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverseBlueprint.js","sourceRoot":"","sources":["../src/traverseBlueprint.ts"],"names":[],"mappings":";;;AAuBA,gDAIC;AAkCD,8CAgCC;AA7FD,2CAAiF;AAMxE,4FANkB,uBAAW,OAMlB;AAepB,iFAAiF;AAEjF,SAAgB,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,IAAA,uBAAW,EAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAkCD,SAAgB,iBAAiB,CAC/B,IAAqB,EACrB,QAA8B,EAC9B,OAAyC;IAEzC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE5D,IAAI,IAAA,oBAAQ,EAAC,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAA,+BAAmB,EAAC,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,kBAAM,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/traverseBlueprintAsync.d.ts

@@ -0,0 +1,18 @@
+import type { Layout, Widget, WidgetAction, WidgetRendererProps } from "./types";
+export interface IncrementalRenderer<TNode> {
+    createContainer(layout: Layout): TNode;
+    createWidget(ctx: WidgetRendererProps): TNode;
+    appendChild(parent: TNode, child: TNode): void;
+}
+export interface AsyncTraversalOptions<TNode> {
+    renderer: IncrementalRenderer<TNode>;
+    onAction?: (action: WidgetAction) => void;
+    /** Abort a stale/interrupted render; checked at every node. */
+    signal?: AbortSignal;
+    /** Whether to yield before processing the next node. Default: every 64 nodes. */
+    shouldYield?: (nodesSinceYield: number) => boolean;
+    /** How to yield. Default: @loomwork/scheduler yieldControl (macrotask). */
+    yieldTo?: () => Promise<void>;
+}
+export declare function traverseBlueprintAsync<TNode>(node: Layout | Widget, stateMap: Map<string, unknown>, options: AsyncTraversalOptions<TNode>): Promise<TNode>;
+//# sourceMappingURL=traverseBlueprintAsync.d.ts.map

package/dist/traverseBlueprintAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverseBlueprintAsync.d.ts","sourceRoot":"","sources":["../src/traverseBlueprintAsync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAiBjF,MAAM,WAAW,mBAAmB,CAAC,KAAK;IACxC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvC,YAAY,CAAC,GAAG,EAAE,mBAAmB,GAAG,KAAK,CAAC;IAC9C,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB,CAAC,KAAK;IAC1C,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,WAAW,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAID,wBAAsB,sBAAsB,CAAC,KAAK,EAChD,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,GACpC,OAAO,CAAC,KAAK,CAAC,CAgDhB"}

package/dist/traverseBlueprintAsync.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traverseBlueprintAsync = traverseBlueprintAsync;
+const scheduler_1 = require("@loomwork/scheduler");
+const normalize_1 = require("./normalize");
+const traverseBlueprint_1 = require("./traverseBlueprint");
+const DEFAULT_YIELD_EVERY = 64;
+async function traverseBlueprintAsync(node, stateMap, options) {
+    const { renderer, onAction, signal } = options;
+    const yieldTo = options.yieldTo ?? scheduler_1.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 () => {
+        (0, scheduler_1.throwIfAborted)(signal);
+        nodesSinceYield++;
+        if (shouldYield(nodesSinceYield)) {
+            nodesSinceYield = 0;
+            await yieldTo();
+            (0, scheduler_1.throwIfAborted)(signal);
+        }
+    };
+    const walk = async (current) => {
+        await tick();
+        if ((0, normalize_1.isWidget)(current)) {
+            const status = (0, normalize_1.resolveWidgetStatus)(current, stateMap);
+            return renderer.createWidget({
+                widget: current,
+                value: (0, traverseBlueprint_1.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) => (0, normalize_1.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/traverseBlueprintAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverseBlueprintAsync.js","sourceRoot":"","sources":["../src/traverseBlueprintAsync.ts"],"names":[],"mappings":";;AAuCA,wDAoDC;AA3FD,mDAAmE;AACnE,2CAAoE;AACpE,2DAAyD;AAmCzD,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAExB,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,wBAAY,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,IAAA,0BAAc,EAAC,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,IAAA,0BAAc,EAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,EAAE,OAAwB,EAAkB,EAAE;QAC9D,MAAM,IAAI,EAAE,CAAC;QAEb,IAAI,IAAA,oBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAA,+BAAmB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC,YAAY,CAAC;gBAC3B,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,IAAA,sCAAkB,EAAC,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,IAAA,kBAAM,EAAC,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/types.d.ts

@@ -0,0 +1,176 @@
+export type WidgetKind = "MetricCard" | "Timeline" | "ApprovalCard" | "StatusBadge" | "ProgressBar" | "DataTable" | "AlertCard" | "StreamingText";
+import type { DataClass } from "@loomwork/classify";
+/**
+ * `empty` (IR 2.3.0, ADR 0100): delivery succeeded and the upstream answered with NO subject to
+ * show (e.g. a template indexed past the end of an empty array). It is not an error and triggers
+ * nothing; a value written beside it is ignored by every renderer.
+ */
+export type BindingState = "pending" | "ready" | "stale" | "error" | "empty";
+/** A binding's delivery state, read from the same projection state as its value (IR 2.0.0). */
+export interface BindingStatus {
+    state: BindingState;
+    /** Monotonic per binding; lets a renderer coalesce out-of-order updates. */
+    seq?: number;
+    finding?: {
+        code: string;
+        message: string;
+    };
+}
+export interface DataBinding {
+    projectionId: string;
+    path: string;
+    /** Where, in the SAME projection state, this binding's status lives. Absent ⇒ no status channel. */
+    status?: {
+        path: string;
+    };
+    /** `@loomwork/classify` DataClass. Read by compilers and delivery; never by renderers. */
+    sensitivity?: DataClass;
+}
+/** What a widget stands for: the semantic type it renders and the degradations that led to `kind`. */
+export interface WidgetSource {
+    type: string;
+    version: string;
+    /** Outermost first. */
+    degradedFrom?: Array<{
+        type: string;
+        version: string;
+    }>;
+    /**
+     * IR 2.5.0 (ADR 0097, amendment 2026-10-11): `true` asserts this widget's content was WITHHELD
+     * for the audience the surface was compiled for. A renderer draws NO value and NO label from a
+     * redacted widget (not `title`, `props`, `binding` or `kind`) and draws a redaction marker
+     * instead. The compiler records the RESULT of resolving audience, never the audience itself.
+     * Only `true` is legal (absent = not redacted); with it `binding` and `degradedFrom` MUST be
+     * absent, and `type`/`version` are a generic placeholder (`"redacted"`/`"1"`) — the original
+     * widget's type may itself be sensitive.
+     */
+    redacted?: true;
+}
+export interface Widget {
+    readonly _tag: "Widget";
+    id: string;
+    kind: string;
+    title?: string;
+    props: Record<string, unknown>;
+    binding?: DataBinding;
+    source?: WidgetSource;
+}
+/**
+ * One child of a grid: the columns it occupies (`span`, default 1) and, since IR 2.1.0
+ * (ADR 0098), an optional explicit placement. Every placement field is independently optional;
+ * all absent = flow placement (the grid's auto-placement, exactly as under 2.0.0). Coordinates
+ * are 1-based grid lines: `column` is the start column (the cell occupies `column..column+span-1`),
+ * `row` the start row, `rowSpan` the rows occupied (default 1).
+ */
+export interface GridCell {
+    span?: number;
+    row?: number;
+    rowSpan?: number;
+    column?: number;
+    node: Widget | Layout;
+}
+export interface GridLayout {
+    type: "grid";
+    /**
+     * This container's stable identity (IR 2.4.0, ADR 0101) — the same rule as `Widget.id`: a
+     * non-empty string, no charset, no length cap, and ONE namespace with widget ids
+     * (`duplicate-node-id` spans both). A renderer that reconciles keys the container by it, so a
+     * sibling inserted or moved around it keeps its subtree's state. A renderer uses it only as a
+     * `Map` key — never markup. Absent or malformed (`layout-id-invalid`) ⇒ keyed positionally, as
+     * under 2.3.0.
+     */
+    id?: string;
+    columns: number;
+    gap?: number;
+    /** A section heading for this container (IR 2.1.0). Absent ⇒ no heading. */
+    title?: string;
+    /**
+     * What this container IS to a renderer that knows it (IR 2.2.0, ADR 0099) — the open,
+     * app-defined axis for containers that `Widget.kind` is for widgets (`"stepped"`, `"tabbed"`,
+     * …). `type` stays the geometry. Absent, malformed (see `isLayoutRole`) or unknown to the
+     * renderer in use ⇒ the plain container. Never an ARIA role, never display text.
+     */
+    role?: string;
+    children: GridCell[];
+}
+export interface FlexLayout {
+    type: "flex";
+    /**
+     * This container's stable identity (IR 2.4.0, ADR 0101) — the same rule as `Widget.id`: a
+     * non-empty string, no charset, no length cap, and ONE namespace with widget ids
+     * (`duplicate-node-id` spans both). A renderer that reconciles keys the container by it, so a
+     * sibling inserted or moved around it keeps its subtree's state. A renderer uses it only as a
+     * `Map` key — never markup. Absent or malformed (`layout-id-invalid`) ⇒ keyed positionally, as
+     * under 2.3.0.
+     */
+    id?: string;
+    direction: "row" | "column";
+    gap?: number;
+    /** A section heading for this container (IR 2.1.0). Absent ⇒ no heading. */
+    title?: string;
+    /**
+     * What this container IS to a renderer that knows it (IR 2.2.0, ADR 0099) — the open,
+     * app-defined axis for containers that `Widget.kind` is for widgets (`"stepped"`, `"tabbed"`,
+     * …). `type` stays the geometry. Absent, malformed (see `isLayoutRole`) or unknown to the
+     * renderer in use ⇒ the plain container. Never an ARIA role, never display text.
+     */
+    role?: string;
+    children: Array<Widget | Layout>;
+}
+export interface StackLayout {
+    type: "stack";
+    /**
+     * This container's stable identity (IR 2.4.0, ADR 0101) — the same rule as `Widget.id`: a
+     * non-empty string, no charset, no length cap, and ONE namespace with widget ids
+     * (`duplicate-node-id` spans both). A renderer that reconciles keys the container by it, so a
+     * sibling inserted or moved around it keeps its subtree's state. A renderer uses it only as a
+     * `Map` key — never markup. Absent or malformed (`layout-id-invalid`) ⇒ keyed positionally, as
+     * under 2.3.0.
+     */
+    id?: string;
+    gap?: number;
+    /** A section heading for this container (IR 2.1.0). Absent ⇒ no heading. */
+    title?: string;
+    /**
+     * What this container IS to a renderer that knows it (IR 2.2.0, ADR 0099) — the open,
+     * app-defined axis for containers that `Widget.kind` is for widgets (`"stepped"`, `"tabbed"`,
+     * …). `type` stays the geometry. Absent, malformed (see `isLayoutRole`) or unknown to the
+     * renderer in use ⇒ the plain container. Never an ARIA role, never display text.
+     */
+    role?: string;
+    children: Array<Widget | Layout>;
+}
+export type Layout = GridLayout | FlexLayout | StackLayout;
+export interface Blueprint {
+    readonly _tag: "Blueprint";
+    /** The IR shape this artifact was written in. Absent ⇒ "1.0.0". Writers always set it. */
+    irVersion?: string;
+    id: string;
+    title: string;
+    layout: Layout;
+    projections: string[];
+    /**
+     * ADR 0095 — the declared semantics of the projections this view binds to, by id, as they
+     * were at composition.
+     *
+     * It lives on the blueprint rather than beside it because a composed surface is
+     * content-addressed: a field of the value is part of the address, so this is what makes
+     * "the meaning of a view never changes silently" a property of the artifact instead of a
+     * paragraph. A binding freezes a NAME; this freezes what that name meant.
+     *
+     * Read it with `blueprintPins`, compare it with `checkBlueprintPins`.
+     */
+    projectionVersions?: Readonly<Record<string, string>>;
+}
+export interface WidgetAction {
+    type: string;
+    widgetId: string;
+    payload?: unknown;
+}
+export interface WidgetRendererProps {
+    widget: Widget;
+    value: unknown;
+    status?: BindingStatus;
+    onAction?: (action: WidgetAction) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/widgetStatus.d.ts

@@ -0,0 +1,66 @@
+import type { BindingStatus, Widget } from "./types";
+/** A caller-supplied value-contract check — the slot the matrix leaves between `empty` and `stale`. */
+export type WidgetValueCheck = (widget: Widget, value: unknown) => {
+    code: string;
+    message: string;
+} | undefined;
+/** What a widget with a declared status channel is showing. */
+export type WidgetShownState = "redacted" | "error" | "empty" | "stale" | "pending" | "loading" | "ready";
+/** The decided status of one widget. `inert` = no status channel declared (IR 1.0.0 behaviour). */
+export type WidgetStatusDescriptor = {
+    /** The widget (or its `source`) is malformed; draw the error placeholder, never the cause. */
+    readonly tag: "invalid";
+    readonly reason: string;
+} | {
+    readonly tag: "inert" | WidgetShownState;
+    /** The finding message (a failed contract check wins), with the matrix default applied. */
+    readonly message: string;
+    /** The raw finding message, no default: what a `stale` marker carries as its tooltip. */
+    readonly finding: string | undefined;
+    /** Whether a value is present beside the status. */
+    readonly hasValue: boolean;
+    /** Whether the widget's own body is drawn (inert, ready, pending, or stale with a value). */
+    readonly showBody: boolean;
+    /** `type@version › …`, outermost first; undefined when the widget is not degraded. */
+    readonly degradedChain: string | undefined;
+};
+/**
+ * Decide what a widget shows. `check` is the optional caller value-contract check; it runs only
+ * for a widget whose binding declares a status channel, and only when there is a subject to check
+ * (not under `error` or `empty`). A finding outranks `stale`, `pending` and `ready`.
+ */
+export declare function describeWidgetStatus(widget: Widget, value: unknown, status: BindingStatus | undefined, check?: WidgetValueCheck): WidgetStatusDescriptor;
+/** The marker one status draws. `text` is the whole line for the markers that carry one. */
+export interface WidgetStatusMarker {
+    /** `data-binding-marker`. */
+    readonly name: Exclude<WidgetShownState, "ready">;
+    /** `alert` for error; `status` for empty and redacted (a polite live region); otherwise none. */
+    readonly role: "alert" | "status" | undefined;
+    readonly glyph: string;
+    /** `glyph title: message` (error, empty), `… — no value` (stale, no value); else undefined. */
+    readonly text: string | undefined;
+    /** A stale marker beside a drawn value is glyph-only and carries the finding as its tooltip. */
+    readonly tooltip: string | undefined;
+    /** Block-level (a row) vs inline (a glyph beside the body). */
+    readonly block: boolean;
+}
+export interface WidgetStatusFrame {
+    /** `data-binding-state`; undefined for an inert widget. */
+    readonly state: WidgetShownState | undefined;
+    readonly sourceType: string | undefined;
+    readonly sourceVersion: string | undefined;
+    /** `data-degraded`: the chain, outermost first. */
+    readonly degraded: string | undefined;
+    /** The `title` attribute of a degraded widget. */
+    readonly tooltip: string | undefined;
+    /** The marker to draw before the body, or undefined (inert, ready). */
+    readonly marker: WidgetStatusMarker | undefined;
+}
+/**
+ * The surface-independent facts of a decided status. A redacted widget yields the constant marker
+ * and no source/degraded facts (nothing of the widget may reach the output).
+ */
+export declare function describeWidgetFrame(widget: Widget, d: Exclude<WidgetStatusDescriptor, {
+    tag: "invalid";
+}>): WidgetStatusFrame;
+//# sourceMappingURL=widgetStatus.d.ts.map

package/dist/widgetStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetStatus.d.ts","sourceRoot":"","sources":["../src/widgetStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAYrD,uGAAuG;AACvG,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,KACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AAEnD,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,OAAO,GACP,OAAO,GACP,OAAO,GACP,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,mGAAmG;AACnG,MAAM,MAAM,sBAAsB,GAC9B;IACE,8FAA8F;IAC9F,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,CAAC;AA2BN;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,KAAK,CAAC,EAAE,gBAAgB,GACvB,sBAAsB,CAyCxB;AAUD,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAClD,iGAAiG;IACjG,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,OAAO,CAAC,sBAAsB,EAAE;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,CAAC,GACrD,iBAAiB,CA4DnB"}

package/dist/widgetStatus.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeWidgetStatus = describeWidgetStatus;
+exports.describeWidgetFrame = describeWidgetFrame;
+const DEFAULT_MESSAGE = {
+    redacted: "redacted",
+    error: "error",
+    empty: "no data",
+    stale: "stale",
+    pending: "",
+    loading: "",
+    ready: "",
+};
+const INVALID = Symbol("invalid");
+const degradedChainOf = (widget) => {
+    const degraded = widget.source?.degradedFrom;
+    if (degraded === undefined)
+        return undefined;
+    if (!Array.isArray(degraded))
+        return INVALID;
+    const parts = [];
+    for (const d of degraded) {
+        if (typeof d !== "object" || d === null)
+            return INVALID;
+        const { type, version } = d;
+        parts.push(`${String(type)}@${String(version)}`);
+    }
+    return parts.join(" › ") || undefined;
+};
+/**
+ * Decide what a widget shows. `check` is the optional caller value-contract check; it runs only
+ * for a widget whose binding declares a status channel, and only when there is a subject to check
+ * (not under `error` or `empty`). A finding outranks `stale`, `pending` and `ready`.
+ */
+function describeWidgetStatus(widget, value, status, check) {
+    // IR 2.5.0: a redacted widget outranks everything — it is decided before `value`, `status`,
+    // `check`, `binding`, `title` or a malformed `source.degradedFrom` is looked at, so none of them
+    // can reach a renderer's output. The message is the constant, never data from the widget.
+    if (widget.source?.redacted === true) {
+        return {
+            tag: "redacted",
+            message: DEFAULT_MESSAGE.redacted,
+            finding: undefined,
+            hasValue: false,
+            showBody: false,
+            degradedChain: undefined,
+        };
+    }
+    const chain = degradedChainOf(widget);
+    if (chain === INVALID)
+        return { tag: "invalid", reason: "source.degradedFrom is not an array of objects" };
+    const hasValue = value !== undefined;
+    const base = { hasValue, degradedChain: chain };
+    if (widget.binding?.status === undefined) {
+        return { tag: "inert", message: "", finding: undefined, showBody: true, ...base };
+    }
+    const noValue = status?.state === "error" || status?.state === "empty";
+    const contract = noValue ? undefined : check?.(widget, value);
+    const finding = contract ? contract.message : status?.finding?.message;
+    let tag;
+    if (status?.state === "error")
+        tag = "error";
+    else if (status?.state === "empty")
+        tag = "empty";
+    else if (contract)
+        tag = "error";
+    else if (status?.state === "stale")
+        tag = "stale";
+    // `status` undefined (not yet written, or malformed) is treated like `ready`: a value that
+    // already exists is shown rather than hidden behind a spinner.
+    else if (!hasValue)
+        tag = "loading";
+    else
+        tag = status?.state === "pending" ? "pending" : "ready";
+    return {
+        tag,
+        message: finding ?? DEFAULT_MESSAGE[tag],
+        finding,
+        showBody: tag === "ready" || tag === "pending" || (tag === "stale" && hasValue),
+        ...base,
+    };
+}
+/**
+ * The surface-independent facts of a decided status. A redacted widget yields the constant marker
+ * and no source/degraded facts (nothing of the widget may reach the output).
+ */
+function describeWidgetFrame(widget, d) {
+    if (d.tag === "redacted") {
+        return {
+            state: "redacted",
+            sourceType: undefined,
+            sourceVersion: undefined,
+            degraded: undefined,
+            tooltip: undefined,
+            marker: {
+                name: "redacted",
+                role: "status",
+                glyph: "⊘",
+                text: `⊘ ${d.message}`,
+                tooltip: undefined,
+                block: true,
+            },
+        };
+    }
+    const label = widget.title ?? widget.kind;
+    const degraded = d.degradedChain;
+    let marker;
+    const row = (name, role, glyph, text, block, tooltip) => ({ name, role, glyph, text, tooltip, block });
+    switch (d.tag) {
+        case "error":
+            marker = row("error", "alert", "✗", `✗ ${label}: ${d.message}`, true);
+            break;
+        case "empty":
+            marker = row("empty", "status", "○", `○ ${label}: ${d.message}`, true);
+            break;
+        case "stale":
+            marker = d.hasValue
+                ? row("stale", undefined, "~", undefined, false, d.finding)
+                : row("stale", undefined, "~", `~ ${label}: ${d.message} — no value`, true);
+            break;
+        case "pending":
+            marker = row("pending", undefined, "⋯", undefined, false);
+            break;
+        case "loading":
+            marker = row("loading", undefined, "…", undefined, true);
+            break;
+        default:
+            marker = undefined;
+    }
+    return {
+        state: d.tag === "inert" ? undefined : d.tag,
+        sourceType: widget.source?.type,
+        sourceVersion: widget.source?.version,
+        degraded,
+        tooltip: degraded
+            ? `${widget.source?.type}@${widget.source?.version} shown as ${widget.kind} (degraded from ${degraded})`
+            : undefined,
+        marker,
+    };
+}
+//# sourceMappingURL=widgetStatus.js.map

package/dist/widgetStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetStatus.js","sourceRoot":"","sources":["../src/widgetStatus.ts"],"names":[],"mappings":";;AA+EA,oDA8CC;AA0CD,kDA+DC;AArLD,MAAM,eAAe,GAAqC;IACxD,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAElC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAuC,EAAE;IAC9E,MAAM,QAAQ,GAAY,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IACtD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,QAAqB,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;QACxD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAwC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AACxC,CAAC,CAAC;AAEF;;;;GAIG;AACH,SAAgB,oBAAoB,CAClC,MAAc,EACd,KAAc,EACd,MAAiC,EACjC,KAAwB;IAExB,4FAA4F;IAC5F,iGAAiG;IACjG,0FAA0F;IAC1F,IAAK,MAAM,CAAC,MAA6C,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7E,OAAO;YACL,GAAG,EAAE,UAAU;YACf,OAAO,EAAE,eAAe,CAAC,QAAQ;YACjC,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,KAAK;YACf,aAAa,EAAE,SAAS;SACzB,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,OAAO;QACnB,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,gDAAgD,EAAE,CAAC;IACtF,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC;IACrC,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAChD,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,KAAK,OAAO,IAAI,MAAM,EAAE,KAAK,KAAK,OAAO,CAAC;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;IACvE,IAAI,GAAqB,CAAC;IAC1B,IAAI,MAAM,EAAE,KAAK,KAAK,OAAO;QAAE,GAAG,GAAG,OAAO,CAAC;SACxC,IAAI,MAAM,EAAE,KAAK,KAAK,OAAO;QAAE,GAAG,GAAG,OAAO,CAAC;SAC7C,IAAI,QAAQ;QAAE,GAAG,GAAG,OAAO,CAAC;SAC5B,IAAI,MAAM,EAAE,KAAK,KAAK,OAAO;QAAE,GAAG,GAAG,OAAO,CAAC;IAClD,2FAA2F;IAC3F,+DAA+D;SAC1D,IAAI,CAAC,QAAQ;QAAE,GAAG,GAAG,SAAS,CAAC;;QAC/B,GAAG,GAAG,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,OAAO;QACL,GAAG;QACH,OAAO,EAAE,OAAO,IAAI,eAAe,CAAC,GAAG,CAAC;QACxC,OAAO;QACP,QAAQ,EAAE,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,KAAK,OAAO,IAAI,QAAQ,CAAC;QAC/E,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAsCD;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,MAAc,EACd,CAAsD;IAEtD,IAAI,CAAC,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,SAAS;YACrB,aAAa,EAAE,SAAS;YACxB,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE;gBACN,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;gBACV,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE;gBACtB,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE,IAAI;aACZ;SACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC;IAC1C,MAAM,QAAQ,GAAG,CAAC,CAAC,aAAa,CAAC;IACjC,IAAI,MAAsC,CAAC;IAC3C,MAAM,GAAG,GAAG,CACV,IAAgC,EAChC,IAAgC,EAChC,KAAa,EACb,IAAwB,EACxB,KAAc,EACd,OAAgB,EACI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;QACd,KAAK,OAAO;YACV,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;YACtE,MAAM;QACR,KAAK,OAAO;YACV,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;YACvE,MAAM;QACR,KAAK,OAAO;YACV,MAAM,GAAG,CAAC,CAAC,QAAQ;gBACjB,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;gBAC3D,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,KAAK,KAAK,CAAC,CAAC,OAAO,aAAa,EAAE,IAAI,CAAC,CAAC;YAC9E,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAC1D,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YACzD,MAAM;QACR;YACE,MAAM,GAAG,SAAS,CAAC;IACvB,CAAC;IACD,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI;QAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO;QACrC,QAAQ;QACR,OAAO,EAAE,QAAQ;YACf,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,aAAa,MAAM,CAAC,IAAI,mBAAmB,QAAQ,GAAG;YACxG,CAAC,CAAC,SAAS;QACb,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/widgets.d.ts

@@ -0,0 +1,101 @@
+import type { DataBinding, Widget } from "./types";
+export interface MetricCardProps {
+    title: string;
+    binding: DataBinding;
+    unit?: string;
+    format?: "number" | "percent" | "bytes";
+    /**
+     * Stable node id. Supply it when a composer will REVISE this view: the derived
+     * id is a hash of kind + props, so editing any prop re-identifies the node —
+     * remounting it, and breaking anything keyed on it (a pin, an annotation, an
+     * agent's reference to it).
+     */
+    id?: string;
+}
+export declare function MetricCard(props: MetricCardProps): Widget;
+export interface TimelineProps {
+    title?: string;
+    binding: DataBinding;
+    maxItems?: number;
+    /**
+     * Stable node id. Supply it when a composer will REVISE this view: the derived
+     * id is a hash of kind + props, so editing any prop re-identifies the node —
+     * remounting it, and breaking anything keyed on it (a pin, an annotation, an
+     * agent's reference to it).
+     */
+    id?: string;
+}
+export declare function Timeline(props: TimelineProps): Widget;
+export interface ApprovalCardProps {
+    title: string;
+    binding: DataBinding;
+    approveLabel?: string;
+    rejectLabel?: string;
+    /**
+     * Stable node id. Supply it when a composer will REVISE this view: the derived
+     * id is a hash of kind + props, so editing any prop re-identifies the node —
+     * remounting it, and breaking anything keyed on it (a pin, an annotation, an
+     * agent's reference to it).
+     */
+    id?: string;
+}
+export declare function ApprovalCard(props: ApprovalCardProps): Widget;
+export interface StatusBadgeProps {
+    title?: string;
+    binding: DataBinding;
+    /**
+     * Stable node id. Supply it when a composer will REVISE this view: the derived
+     * id is a hash of kind + props, so editing any prop re-identifies the node —
+     * remounting it, and breaking anything keyed on it (a pin, an annotation, an
+     * agent's reference to it).
+     */
+    id?: string;
+}
+export declare function StatusBadge(props: StatusBadgeProps): Widget;
+export interface ProgressBarProps {
+    title?: string;
+    binding: DataBinding;
+    max?: number;
+    /**
+     * Stable node id. Supply it when a composer will REVISE this view: the derived
+     * id is a hash of kind + props, so editing any prop re-identifies the node —
+     * remounting it, and breaking anything keyed on it (a pin, an annotation, an
+     * agent's reference to it).
+     */
+    id?: string;
+}
+export declare function ProgressBar(props: ProgressBarProps): Widget;
+export interface DataTableProps {
+    title?: string;
+    binding: DataBinding;
+    columns?: string[];
+    /**
+     * Stable node id. Supply it when a composer will REVISE this view: the derived
+     * id is a hash of kind + props, so editing any prop re-identifies the node —
+     * remounting it, and breaking anything keyed on it (a pin, an annotation, an
+     * agent's reference to it).
+     */
+    id?: string;
+}
+export declare function DataTable(props: DataTableProps): Widget;
+export interface AlertCardProps {
+    title?: string;
+    binding: DataBinding;
+    severity?: "info" | "warning" | "error" | "critical";
+    /**
+     * Stable node id. Supply it when a composer will REVISE this view: the derived
+     * id is a hash of kind + props, so editing any prop re-identifies the node —
+     * remounting it, and breaking anything keyed on it (a pin, an annotation, an
+     * agent's reference to it).
+     */
+    id?: string;
+}
+export declare function AlertCard(props: AlertCardProps): Widget;
+export interface StreamingTextProps {
+    title?: string;
+    binding: DataBinding;
+    placeholder?: string;
+    id?: string;
+}
+export declare function StreamingText(props: StreamingTextProps): Widget;
+//# sourceMappingURL=widgets.d.ts.map

package/dist/widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../src/widgets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAmBnD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAUzD;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAUrD;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAU7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAU3D;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAU3D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAUvD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACrD;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAUvD;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAU/D"}