@cleocode/contracts 2026.5.104 → 2026.5.105

package/dist/release/ship-e2e-smoke.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Ship E2E Smoke contracts — types for the `cleo release ship-e2e-smoke`
+ * one-shot walker that exercises the full release lifecycle end-to-end.
+ *
+ * The smoke runs `plan` → `open` → wait-for-PR-merge → wait-for-tag →
+ * verify-npm-published. Each step records its status, duration, and any
+ * side-effect identifier (PR number, tag SHA, npm version) for downstream
+ * inspection. The aggregate envelope reports the final lifecycle state
+ * reached so failures can be resumed.
+ *
+ * Dry-run is the default; `--execute` flips the runner to perform real
+ * mutations. Both modes return the same envelope shape so consumers can
+ * diff a dry-run preview against a real run.
+ *
+ * @task T10103
+ * @epic E-CLEO-RELEASE-VERBS
+ * @saga T10099
+ */
+/**
+ * The discrete steps the smoke walker executes, in order. The aggregate
+ * envelope records one entry per step with status + duration.
+ */
+export type ShipE2eSmokeStepName = 'plan' | 'open' | 'wait-for-pr' | 'wait-for-tag' | 'verify-npm-published';
+/** Outcome of a single smoke step. */
+export type ShipE2eSmokeStepStatus = 
+/** Step completed successfully (or, in dry-run, would have run). */
+'ok'
+/** Step was skipped — e.g. dry-run mode shortcuts post-plan. */
+ | 'skipped'
+/** Step failed; the smoke envelope's success flag will be false. */
+ | 'failed';
+/** Per-step result attached to the smoke envelope. */
+export interface ShipE2eSmokeStep {
+    /** The step name. */
+    name: ShipE2eSmokeStepName;
+    /** Outcome. */
+    status: ShipE2eSmokeStepStatus;
+    /** Wall-clock duration in milliseconds. */
+    durationMs: number;
+    /**
+     * Optional human-readable detail string captured at step completion
+     * (e.g. "plan written to .cleo/release/v2026.5.104.plan.json",
+     * "PR #524 merged", "tag v2026.5.104 found", "npm @cleocode/cleo@…
+     * published").
+     */
+    detail?: string;
+    /**
+     * Optional error message when `status === 'failed'`. Single-line so
+     * the envelope stays compact for CLI consumers.
+     */
+    error?: string;
+}
+/**
+ * Final lifecycle state the smoke reached. Mirrors the `releases.status`
+ * column values plus a synthetic `npm-published` terminal state captured
+ * by the verify step.
+ */
+export type ShipE2eSmokeFinalState = 'not-started' | 'planned' | 'pr-opened' | 'pr-merged' | 'tag-pushed' | 'npm-published';
+/** Parameters accepted by the smoke walker. */
+export interface ShipE2eSmokeParams {
+    /** Candidate release version (e.g. "v2026.6.0" or "2026.6.0"). */
+    version: string;
+    /** Epic task ID that scopes the release (forwarded to `release plan`). */
+    epicId: string;
+    /**
+     * When false (default), no side effects — every step reports what it
+     * WOULD do. When true, each step performs its real mutation.
+     */
+    execute: boolean;
+    /**
+     * Total wall-clock budget across all polling waits, in milliseconds.
+     * Default 30 minutes when omitted. Per-step waits MUST respect this
+     * shared budget so a stuck PR doesn't hang the whole smoke.
+     */
+    totalTimeoutMs?: number;
+    /**
+     * Poll interval for wait-* steps, in milliseconds. Default 5_000.
+     * Lowered in tests via DI to keep the suite fast.
+     */
+    pollIntervalMs?: number;
+}
+/** Top-level envelope returned by the smoke walker. */
+export interface ShipE2eSmokeResult {
+    /** True when every step completed (or was intentionally skipped). */
+    success: boolean;
+    /** Echo of the version under smoke. */
+    version: string;
+    /** True when --execute was passed; false for dry-run preview. */
+    executed: boolean;
+    /** Ordered step log. */
+    steps: ShipE2eSmokeStep[];
+    /** Lifecycle state at smoke termination. */
+    finalState: ShipE2eSmokeFinalState;
+    /** Total wall-clock duration across all steps, in milliseconds. */
+    totalDurationMs: number;
+}
+//# sourceMappingURL=ship-e2e-smoke.d.ts.map

package/dist/release/ship-e2e-smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship-e2e-smoke.d.ts","sourceRoot":"","sources":["../../src/release/ship-e2e-smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,MAAM,GACN,aAAa,GACb,cAAc,GACd,sBAAsB,CAAC;AAE3B,sCAAsC;AACtC,MAAM,MAAM,sBAAsB;AAChC,oEAAoE;AAClE,IAAI;AACN,gEAAgE;GAC9D,SAAS;AACX,oEAAoE;GAClE,QAAQ,CAAC;AAEb,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,eAAe;IACf,MAAM,EAAE,sBAAsB,CAAC;IAC/B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,SAAS,GACT,WAAW,GACX,WAAW,GACX,YAAY,GACZ,eAAe,CAAC;AAEpB,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,wBAAwB;IACxB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,UAAU,EAAE,sBAAsB,CAAC;IACnC,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/release/ship-e2e-smoke.js

@@ -0,0 +1,20 @@
+/**
+ * Ship E2E Smoke contracts — types for the `cleo release ship-e2e-smoke`
+ * one-shot walker that exercises the full release lifecycle end-to-end.
+ *
+ * The smoke runs `plan` → `open` → wait-for-PR-merge → wait-for-tag →
+ * verify-npm-published. Each step records its status, duration, and any
+ * side-effect identifier (PR number, tag SHA, npm version) for downstream
+ * inspection. The aggregate envelope reports the final lifecycle state
+ * reached so failures can be resumed.
+ *
+ * Dry-run is the default; `--execute` flips the runner to perform real
+ * mutations. Both modes return the same envelope shape so consumers can
+ * diff a dry-run preview against a real run.
+ *
+ * @task T10103
+ * @epic E-CLEO-RELEASE-VERBS
+ * @saga T10099
+ */
+export {};
+//# sourceMappingURL=ship-e2e-smoke.js.map

package/dist/release/ship-e2e-smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship-e2e-smoke.js","sourceRoot":"","sources":["../../src/release/ship-e2e-smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/render/__tests__/envelope.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Compile-time + runtime narrowing tests for `RenderableEnvelope<T>` and the
+ * per-kind type guards.
+ *
+ * Each test constructs a valid envelope of a single `kind` and asserts that
+ * the matching guard narrows it correctly while every other guard returns
+ * `false`. This catches both schema drift and accidental short-circuits in
+ * the guards.
+ *
+ * @epic T10114
+ * @task T10141
+ */
+export {};
+//# sourceMappingURL=envelope.test.d.ts.map

package/dist/render/__tests__/envelope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.test.d.ts","sourceRoot":"","sources":["../../../src/render/__tests__/envelope.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/render/__tests__/envelope.test.js

@@ -0,0 +1,178 @@
+/**
+ * Compile-time + runtime narrowing tests for `RenderableEnvelope<T>` and the
+ * per-kind type guards.
+ *
+ * Each test constructs a valid envelope of a single `kind` and asserts that
+ * the matching guard narrows it correctly while every other guard returns
+ * `false`. This catches both schema drift and accidental short-circuits in
+ * the guards.
+ *
+ * @epic T10114
+ * @task T10141
+ */
+import { describe, expect, it } from 'vitest';
+import { isGenericEnvelope, isGroupedListEnvelope, isListEnvelope, isSectionEnvelope, isSingleEnvelope, isTableEnvelope, isTreeEnvelope, } from '../envelope.js';
+import { isGroupedListResponse, isListResponse } from '../list.js';
+import { isTableResponse } from '../table.js';
+import { isTreeResponse } from '../tree.js';
+describe('RenderableEnvelope<T> discriminated-union narrowing', () => {
+    it('narrows the tree variant and rejects all others', () => {
+        const env = {
+            kind: 'tree',
+            data: { tree: [], root: 'T1', totalNodes: 0, maxDepth: 0 },
+        };
+        expect(isTreeEnvelope(env)).toBe(true);
+        expect(isTableEnvelope(env)).toBe(false);
+        expect(isListEnvelope(env)).toBe(false);
+        expect(isGroupedListEnvelope(env)).toBe(false);
+        expect(isSectionEnvelope(env)).toBe(false);
+        expect(isSingleEnvelope(env)).toBe(false);
+        expect(isGenericEnvelope(env)).toBe(false);
+        if (isTreeEnvelope(env)) {
+            expect(env.data.root).toBe('T1');
+        }
+        else {
+            throw new Error('expected tree narrowing');
+        }
+    });
+    it('narrows the table variant and rejects all others', () => {
+        const env = {
+            kind: 'table',
+            data: {
+                rows: [{ x: 1 }],
+                schema: { columns: [{ key: 'x', header: 'X' }] },
+                total: 1,
+            },
+        };
+        expect(isTableEnvelope(env)).toBe(true);
+        expect(isTreeEnvelope(env)).toBe(false);
+        if (isTableEnvelope(env)) {
+            expect(env.data.rows[0]?.x).toBe(1);
+        }
+        else {
+            throw new Error('expected table narrowing');
+        }
+    });
+    it('narrows the flat list variant', () => {
+        const env = {
+            kind: 'list',
+            data: { items: [{ x: 7 }], total: 1, renderItem: 'kv' },
+        };
+        expect(isListEnvelope(env)).toBe(true);
+        expect(isGroupedListEnvelope(env)).toBe(false);
+        if (isListEnvelope(env)) {
+            expect(env.data.items[0]?.x).toBe(7);
+            expect(env.data.renderItem).toBe('kv');
+        }
+        else {
+            throw new Error('expected list narrowing');
+        }
+    });
+    it('narrows the grouped-list variant', () => {
+        const env = {
+            kind: 'grouped-list',
+            data: {
+                groups: [{ key: 'a', label: 'A', items: [{ x: 2 }] }],
+                total: 1,
+            },
+        };
+        expect(isGroupedListEnvelope(env)).toBe(true);
+        expect(isListEnvelope(env)).toBe(false);
+        if (isGroupedListEnvelope(env)) {
+            expect(env.data.groups[0]?.items[0]?.x).toBe(2);
+        }
+        else {
+            throw new Error('expected grouped-list narrowing');
+        }
+    });
+    it('narrows the section variant', () => {
+        const env = {
+            kind: 'section',
+            data: { header: 'Summary', icon: 'i', items: ['a', 'b'] },
+        };
+        expect(isSectionEnvelope(env)).toBe(true);
+        if (isSectionEnvelope(env)) {
+            expect(env.data.items).toEqual(['a', 'b']);
+        }
+        else {
+            throw new Error('expected section narrowing');
+        }
+    });
+    it('narrows the single variant', () => {
+        const env = {
+            kind: 'single',
+            data: { x: 42 },
+        };
+        expect(isSingleEnvelope(env)).toBe(true);
+        if (isSingleEnvelope(env)) {
+            expect(env.data.x).toBe(42);
+        }
+        else {
+            throw new Error('expected single narrowing');
+        }
+    });
+    it('narrows the generic variant', () => {
+        const env = {
+            kind: 'generic',
+            data: { foo: 'bar', count: 3 },
+        };
+        expect(isGenericEnvelope(env)).toBe(true);
+        if (isGenericEnvelope(env)) {
+            expect(env.data.foo).toBe('bar');
+        }
+        else {
+            throw new Error('expected generic narrowing');
+        }
+    });
+    it('exhaustively switches on kind without falling through', () => {
+        const envelopes = [
+            { kind: 'tree', data: { tree: [], root: 'r', totalNodes: 0, maxDepth: 0 } },
+            {
+                kind: 'table',
+                data: { rows: [], schema: { columns: [] }, total: 0 },
+            },
+            { kind: 'list', data: { items: [], total: 0 } },
+            { kind: 'grouped-list', data: { groups: [], total: 0 } },
+            { kind: 'section', data: { header: 'h', items: [] } },
+            { kind: 'single', data: { x: 0 } },
+            { kind: 'generic', data: {} },
+        ];
+        const seen = new Set();
+        for (const env of envelopes) {
+            switch (env.kind) {
+                case 'tree':
+                case 'table':
+                case 'list':
+                case 'grouped-list':
+                case 'section':
+                case 'single':
+                case 'generic':
+                    seen.add(env.kind);
+                    break;
+                default: {
+                    const _exhaustive = env;
+                    throw new Error(`unreachable: ${JSON.stringify(_exhaustive)}`);
+                }
+            }
+        }
+        expect(seen.size).toBe(7);
+    });
+});
+describe('per-response type guards', () => {
+    it('accepts valid response shapes', () => {
+        expect(isTreeResponse({ tree: [], root: 'r', totalNodes: 0, maxDepth: 0 })).toBe(true);
+        expect(isTableResponse({ rows: [], schema: { columns: [] }, total: 0 })).toBe(true);
+        expect(isListResponse({ items: [], total: 0 })).toBe(true);
+        expect(isGroupedListResponse({ groups: [], total: 0 })).toBe(true);
+    });
+    it('rejects invalid response shapes', () => {
+        expect(isTreeResponse(null)).toBe(false);
+        expect(isTreeResponse({})).toBe(false);
+        expect(isTreeResponse({ tree: 'nope', root: 'r', totalNodes: 0, maxDepth: 0 })).toBe(false);
+        expect(isTableResponse({ rows: [], total: 0 })).toBe(false);
+        expect(isTableResponse({ rows: [], schema: 'nope', total: 0 })).toBe(false);
+        expect(isListResponse({ items: 'nope', total: 0 })).toBe(false);
+        expect(isGroupedListResponse({ groups: 'nope', total: 0 })).toBe(false);
+    });
+});
+//# sourceMappingURL=envelope.test.js.map

package/dist/render/__tests__/envelope.test.js.map

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

package/dist/render/envelope.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Typed render contracts — top-level `RenderableEnvelope<T>` discriminated union.
+ *
+ * Part of the Human Render Contract (Epic T10114, ADR-077). Every renderable
+ * value flowing from CLEO commands to presenters MUST be wrapped in one of the
+ * variants below. Presenters dispatch on `kind` to pick the right renderer.
+ *
+ * @epic T10114
+ * @task T10141
+ */
+import type { GroupedListResponse, ListResponse } from './list.js';
+import type { TableResponse } from './table.js';
+import type { TreeResponse } from './tree.js';
+/**
+ * Free-form section block — a labelled header with an ordered set of
+ * pre-formatted item strings. Used for ad-hoc human output that doesn't fit
+ * the structured `tree` / `table` / `list` shapes.
+ */
+export interface SectionResponse {
+    /** Heading rendered above the items. */
+    readonly header: string;
+    /** Optional icon hint — presenters MAY prepend it to the header. */
+    readonly icon?: string;
+    /** Pre-formatted item strings rendered as a bulleted block. */
+    readonly items: ReadonlyArray<string>;
+}
+/**
+ * Discriminated union of every renderable envelope variant CLEO presenters
+ * understand.
+ *
+ * The `kind` field is the discriminator — narrow on it inside a `switch`
+ * statement or via the per-kind type guards exported below.
+ *
+ * @typeParam T — caller-defined payload shape. For `single` it is the entire
+ *                payload; for the collection variants it parameterises the
+ *                inner response type. `section` and `generic` are independent
+ *                of `T`.
+ */
+export type RenderableEnvelope<T> = {
+    readonly kind: 'tree';
+    readonly data: TreeResponse<T>;
+} | {
+    readonly kind: 'table';
+    readonly data: TableResponse<T>;
+} | {
+    readonly kind: 'list';
+    readonly data: ListResponse<T>;
+} | {
+    readonly kind: 'grouped-list';
+    readonly data: GroupedListResponse<T>;
+} | {
+    readonly kind: 'section';
+    readonly data: SectionResponse;
+} | {
+    readonly kind: 'single';
+    readonly data: T;
+} | {
+    readonly kind: 'generic';
+    readonly data: Record<string, unknown>;
+};
+/**
+ * Type guard — narrows to the `tree` variant.
+ */
+export declare function isTreeEnvelope<T>(env: RenderableEnvelope<T>): env is Extract<RenderableEnvelope<T>, {
+    kind: 'tree';
+}>;
+/**
+ * Type guard — narrows to the `table` variant.
+ */
+export declare function isTableEnvelope<T>(env: RenderableEnvelope<T>): env is Extract<RenderableEnvelope<T>, {
+    kind: 'table';
+}>;
+/**
+ * Type guard — narrows to the flat `list` variant.
+ */
+export declare function isListEnvelope<T>(env: RenderableEnvelope<T>): env is Extract<RenderableEnvelope<T>, {
+    kind: 'list';
+}>;
+/**
+ * Type guard — narrows to the `grouped-list` variant.
+ */
+export declare function isGroupedListEnvelope<T>(env: RenderableEnvelope<T>): env is Extract<RenderableEnvelope<T>, {
+    kind: 'grouped-list';
+}>;
+/**
+ * Type guard — narrows to the `section` variant.
+ */
+export declare function isSectionEnvelope<T>(env: RenderableEnvelope<T>): env is Extract<RenderableEnvelope<T>, {
+    kind: 'section';
+}>;
+/**
+ * Type guard — narrows to the `single` variant.
+ */
+export declare function isSingleEnvelope<T>(env: RenderableEnvelope<T>): env is Extract<RenderableEnvelope<T>, {
+    kind: 'single';
+}>;
+/**
+ * Type guard — narrows to the `generic` variant.
+ */
+export declare function isGenericEnvelope<T>(env: RenderableEnvelope<T>): env is Extract<RenderableEnvelope<T>, {
+    kind: 'generic';
+}>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/render/envelope.d.ts.map

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

package/dist/render/envelope.js

@@ -0,0 +1,53 @@
+/**
+ * Typed render contracts — top-level `RenderableEnvelope<T>` discriminated union.
+ *
+ * Part of the Human Render Contract (Epic T10114, ADR-077). Every renderable
+ * value flowing from CLEO commands to presenters MUST be wrapped in one of the
+ * variants below. Presenters dispatch on `kind` to pick the right renderer.
+ *
+ * @epic T10114
+ * @task T10141
+ */
+/**
+ * Type guard — narrows to the `tree` variant.
+ */
+export function isTreeEnvelope(env) {
+    return env.kind === 'tree';
+}
+/**
+ * Type guard — narrows to the `table` variant.
+ */
+export function isTableEnvelope(env) {
+    return env.kind === 'table';
+}
+/**
+ * Type guard — narrows to the flat `list` variant.
+ */
+export function isListEnvelope(env) {
+    return env.kind === 'list';
+}
+/**
+ * Type guard — narrows to the `grouped-list` variant.
+ */
+export function isGroupedListEnvelope(env) {
+    return env.kind === 'grouped-list';
+}
+/**
+ * Type guard — narrows to the `section` variant.
+ */
+export function isSectionEnvelope(env) {
+    return env.kind === 'section';
+}
+/**
+ * Type guard — narrows to the `single` variant.
+ */
+export function isSingleEnvelope(env) {
+    return env.kind === 'single';
+}
+/**
+ * Type guard — narrows to the `generic` variant.
+ */
+export function isGenericEnvelope(env) {
+    return env.kind === 'generic';
+}
+//# sourceMappingURL=envelope.js.map

package/dist/render/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/render/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAyCH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAA0B;IAE1B,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,GAA0B;IAE1B,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAA0B;IAE1B,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAA0B;IAE1B,OAAO,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAA0B;IAE1B,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAA0B;IAE1B,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAA0B;IAE1B,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;AAChC,CAAC"}

package/dist/render/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Barrel for the typed render contracts (Epic T10114, ADR-077).
+ *
+ * Icon enums are intentionally omitted — they ship with T10127 (B2).
+ *
+ * @epic T10114
+ */
+export type { RenderableEnvelope, SectionResponse } from './envelope.js';
+export { isGenericEnvelope, isGroupedListEnvelope, isListEnvelope, isSectionEnvelope, isSingleEnvelope, isTableEnvelope, isTreeEnvelope, } from './envelope.js';
+export type { GroupedListResponse, ListGroup, ListItemStyle, ListResponse, } from './list.js';
+export { isGroupedListResponse, isListResponse } from './list.js';
+export type { ColumnAlign, TableColumn, TableResponse, TableSchema, } from './table.js';
+export { isTableResponse } from './table.js';
+export type { FlatTreeNode, RenderTreeOptions, TreeNodeKind, TreeNodeStatus, TreeResponse, } from './tree.js';
+export { isTreeResponse } from './tree.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClE,YAAY,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/render/index.js

@@ -0,0 +1,12 @@
+/**
+ * Barrel for the typed render contracts (Epic T10114, ADR-077).
+ *
+ * Icon enums are intentionally omitted — they ship with T10127 (B2).
+ *
+ * @epic T10114
+ */
+export { isGenericEnvelope, isGroupedListEnvelope, isListEnvelope, isSectionEnvelope, isSingleEnvelope, isTableEnvelope, isTreeEnvelope, } from './envelope.js';
+export { isGroupedListResponse, isListResponse } from './list.js';
+export { isTableResponse } from './table.js';
+export { isTreeResponse } from './tree.js';
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC;AAOvB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOlE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ7C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/render/list.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Typed render contracts — list (flat) and grouped-list.
+ *
+ * Part of the Human Render Contract (Epic T10114, ADR-077). The list shape is
+ * the canonical wire format for ordered or grouped sequential output —
+ * presenters render each item according to `renderItem` (or a default).
+ *
+ * @epic T10114
+ * @task T10140
+ */
+/**
+ * Per-item rendering style hint for list responses.
+ *
+ * - `'text'`   — render the item as a plain string (default presenter behaviour).
+ * - `'badge'`  — render with status / category styling.
+ * - `'kv'`     — render as a key/value pair block.
+ */
+export type ListItemStyle = 'text' | 'badge' | 'kv';
+/**
+ * Flat list response — items rendered in `items` order.
+ *
+ * @typeParam T — caller-defined item payload shape.
+ */
+export interface ListResponse<T> {
+    /** Item payloads in render order. */
+    readonly items: ReadonlyArray<T>;
+    /**
+     * Total item count. May exceed `items.length` when the response is paginated
+     * or truncated.
+     */
+    readonly total: number;
+    /** Optional per-item rendering style hint. */
+    readonly renderItem?: ListItemStyle;
+}
+/**
+ * One labelled bucket inside a grouped list response.
+ *
+ * @typeParam T — caller-defined item payload shape.
+ */
+export interface ListGroup<T> {
+    /** Stable group identifier — used for diff / equality, not display. */
+    readonly key: string;
+    /** Human-readable group label rendered above its items. */
+    readonly label: string;
+    /** Item payloads inside this group, in render order. */
+    readonly items: ReadonlyArray<T>;
+}
+/**
+ * Grouped list response — items split across labelled buckets.
+ *
+ * @typeParam T — caller-defined item payload shape.
+ */
+export interface GroupedListResponse<T> {
+    /** Ordered list of labelled groups. */
+    readonly groups: ReadonlyArray<ListGroup<T>>;
+    /** Total item count across all groups. */
+    readonly total: number;
+}
+/**
+ * Runtime type guard for `ListResponse<T>`.
+ *
+ * Checks the envelope shape only — does not inspect item payloads against `T`.
+ *
+ * @param value — candidate value to inspect.
+ * @returns `true` iff `value` matches the `ListResponse<T>` envelope shape.
+ */
+export declare function isListResponse<T>(value: unknown): value is ListResponse<T>;
+/**
+ * Runtime type guard for `GroupedListResponse<T>`.
+ *
+ * Checks the envelope shape only — does not inspect item payloads against `T`.
+ *
+ * @param value — candidate value to inspect.
+ * @returns `true` iff `value` matches the `GroupedListResponse<T>` envelope shape.
+ */
+export declare function isGroupedListResponse<T>(value: unknown): value is GroupedListResponse<T>;
+//# sourceMappingURL=list.d.ts.map

package/dist/render/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/render/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAI1E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAIxF"}