@appinternalleads/ui 0.2.0

package/dist/esm/widgets/output/catalog.js

@@ -0,0 +1,124 @@
+/**
+ * **The output catalogue — the one place that answers "what exists and can it be shown."**
+ *
+ * `tasks/OUTPUT-WIDGETS.md`'s "Build order" table as data, not prose. Before this file, the same
+ * fact — "only `stats`/`keyvalue` are catalogue-ready" — lived as a hand-maintained array in
+ * `site/lib/output-examples.ts` (`CATALOGUE_READY_WIDGETS`), disconnected from the package. This
+ * is the single source CompPack, the Playground and (via `storyId`/status) Storybook all read,
+ * per Phase 24's acceptance test: adding a renderer should not mean editing three hardcoded
+ * lists.
+ *
+ * **Status is a design fact, not an engineering one.** `implemented` requires both a
+ * design-complete type sheet *and* a shipped renderer with schema, fixtures, registry entry,
+ * tests and Storybook coverage — see `tasks/OUTPUT-WIDGETS.md`'s "Final status table" for the
+ * complete per-renderer breakdown. `design-complete` means the type sheet exists
+ * (`docs/output-type-sheets/<name>.md`) but engineering has not shipped yet — as of Phase 27,
+ * only `collection` remains here (its own engineering prerequisite — a shell/body-separation
+ * refactor — is disclosed on its own entry below). `blocked` is reserved for renderers with no
+ * implementation-depth type sheet, or an unresolved question specific to that renderer — none
+ * today: `tabbed` and `fallback` left it on 2026-09-25 (batch 4 PRD §6). Only this file's `status` gates the public
+ * `/components` catalogue (`getOutputComponents({ status: 'implemented' })`) — never a
+ * per-consumer guess.
+ *
+ * **`family` is a second, orthogonal axis — what kind of surface this is, not how finished it
+ * is.** `display`: read-only, the renderer presents something, nothing is written back.
+ * `decision`: the renderer's payload can carry the shared top-level `mount: 'read' | 'write'`
+ * and, in `write` mode, the reader is actually deciding something that gets lifted back to the
+ * run record (`comparison`'s single-select, `ranked`'s reorder, `deck`'s keep/pass) — a real
+ * three-way split alongside the input family (`question/1`), not a subcategory of `display`.
+ * `keyvalue`'s own correction flow is deliberately **not** `decision` — it uses a payload-scoped
+ * `mount: 'canvas' | 'dashboard'` (a different axis entirely, gating mutation, not choice) rather
+ * than the shared read/write field the three `decision` renderers share; see `document.ts`'s own
+ * comment on why those two `mount` concepts are unrelated.
+ */
+export const OUTPUT_CATALOGUE = [
+    {
+        type: 'stats', label: 'Stats', category: 'data', status: 'implemented', family: 'display',
+        fixtureDir: 'stats', storyId: 'Output/Stats',
+        note: 'X2 — full type sheet to implementation depth, both blockers-bundle corrections applied.',
+    },
+    {
+        type: 'keyvalue', label: 'KeyValue', category: 'data', status: 'implemented', family: 'display',
+        fixtureDir: 'keyvalue', storyId: 'Output/KeyValue',
+        note: 'X1 — rebuilt against the real spec (design_handoff_output_blockers §1), not the shallow variations doc the first pass used. Its field-correction flow is a `mount: canvas|dashboard` gate, not the shared read/write axis, so it stays `display`, not `decision` — see the module doc.',
+    },
+    {
+        type: 'delta', label: 'Delta', category: 'comparison', status: 'implemented', family: 'display',
+        fixtureDir: 'delta', storyId: 'Output/Delta',
+        note: 'X3 — design-complete (docs/output-type-sheets/delta.md, Phase 26); Phase 27 closed the fixture gap (loading/partial/no-changes) and added loading-state rendering to `DeltaCard`. No mount axis — pure read, so `display`, not `decision`.',
+    },
+    {
+        type: 'comparison', label: 'Comparison', category: 'comparison', status: 'implemented', family: 'decision',
+        fixtureDir: 'comparison', storyId: 'Output/Comparison',
+        note: 'X3 — design-complete (docs/output-type-sheets/comparison.md, Phase 26); Phase 27 closed the fixture gap (loading/partial/no-winner/error) and added loading/error-state rendering to `ComparisonCard`. `write` mode lets the reader pick one option — `decision`, not `display`.',
+    },
+    {
+        type: 'sequence', label: 'Sequence', category: 'narrative', status: 'implemented', family: 'display',
+        fixtureDir: 'sequence', storyId: 'Output/Sequence',
+        note: 'X3 — implemented Phase 27 per docs/output-type-sheets/sequence.md, variation A. Read-only, widget-local position — `display`.',
+    },
+    {
+        type: 'artifact', label: 'Artifact', category: 'narrative', status: 'implemented', family: 'display',
+        fixtureDir: 'artifact', storyId: 'Output/Artifact',
+        note: 'X3 — implemented Phase 27 per docs/output-type-sheets/artifact.md, variation B, with generic `{label,value}` row content (per-content-kind markup deferred, as the sheet itself calls for). Clip/fade uses a row-count threshold rather than real height measurement — disclosed simplification, see `ArtifactCard.tsx`. `display`.',
+    },
+    {
+        type: 'text', label: 'Text', category: 'narrative', status: 'implemented', family: 'display',
+        fixtureDir: 'text', storyId: 'Output/Text',
+        note: 'X4 — implemented Phase 27 per docs/output-type-sheets/text.md and quote.md; `quote` is a `treatment`, not its own `OutputWidgetKind` — never sky tokens (O3, closed). Streaming caret still open, interim default is no-caret. `display`.',
+    },
+    {
+        type: 'status', label: 'Status', category: 'data', status: 'implemented', family: 'display',
+        fixtureDir: 'status', storyId: 'Output/Status',
+        note: 'X4 — implemented Phase 27 per docs/output-type-sheets/status.md; the one renderer that never mounts the shared shell (see `registry.tsx`\'s own note). Corrects the source doc\'s own "clay for failure" to the system-wide apricot interim rule. `display`.',
+    },
+    {
+        type: 'ranked', label: 'Ranked', category: 'data', status: 'implemented', family: 'decision',
+        fixtureDir: 'ranked', storyId: 'Output/Ranked',
+        note: 'X4 — implemented Phase 27 per docs/output-type-sheets/ranked.md, variation A. `read` mode fully built; `write`-mode drag-to-reorder is a disclosed gap (needs a keyboard-accessible interaction, not a pointer-drag stand-in — see `RankedCard.tsx`). `decision`, not `display`.',
+    },
+    {
+        type: 'deck', label: 'Deck', category: 'narrative', status: 'implemented', family: 'decision',
+        fixtureDir: 'deck', storyId: 'Output/Deck',
+        note: 'X4 — implemented Phase 27 per docs/output-type-sheets/deck.md, variation B (default density). Compact/expanded densities accepted but render identically this pass — disclosed, see `DeckCard.tsx`. `decision`, not `display`.',
+    },
+    {
+        type: 'diff', label: 'Diff', category: 'comparison', status: 'implemented', family: 'display',
+        fixtureDir: 'diff', storyId: 'Output/Diff',
+        note: 'X4 — implemented Phase 27 per docs/output-type-sheets/diff.md; anatomy (A/B/C) derived from payload shape, never colour-coded. Read-only — `display`.',
+    },
+    {
+        type: 'findings', label: 'Findings', category: 'data', status: 'implemented', family: 'display',
+        fixtureDir: 'findings', storyId: 'Output/Findings',
+        note: 'X4 — implemented Phase 27 per docs/output-type-sheets/findings.md, variation A + the count-gated severity summary (C). Variation B ("anchored to the document") deliberately not built this pass — the sheet\'s own framing calls it "the expensive one." `display`.',
+    },
+    {
+        type: 'list', label: 'List', category: 'data', status: 'implemented', family: 'display',
+        fixtureDir: 'list', storyId: 'Output/List',
+        resource: { slug: 'list', defaultFixture: 'browse' },
+        note: 'X7 — design_handoff_output_list (Widget list.dc.html + README). The first query-backed renderer: owns its query lifecycle via `queryEngine.ts` (epoch-guarded, abortable) against a host `DataAdapter`; select → detail renders as `keyvalue`. Payload carries config, not rows. Decided 2026-09-18: X5 (containers hand each child shell + payload), C7 (global `alertSoft`/`alertInk` tokens), N1 (schema-driven filters; user and agent share one filter primitive), N2 (query state does not survive a remount), N5 (A–Z is one column-derived facet) — see docs/output-type-sheets/list.md. `display`: selection here opens a detail view, it is not a write-back decision.',
+    },
+    {
+        type: 'collection', label: 'Collection', category: 'container', status: 'design-complete', family: 'display',
+        note: 'X5 — DECIDED 2026-09-18 (option A, shell + payload): each child is a complete output/1 document — its own shell and its own payload (`OutputContainerChild`, `OutputChildren` in registry.tsx). Not implemented, and not buildable from the sources without a decision (audit 2026-09-25): the original handoff (design_handoff_output_widgets README § Containers, and every Output Blocks.dc.html) draws `collection` as `--well` ROWS — a 36px category IconTile, a title and a description, "N step outputs, read in sequence" — which are neither full documents (option A) nor renderer payloads in one shell (the option B text still in docs/output-type-sheets/containers-x5.md). Three incompatible readings; the output/1 contract owner must pick one before layout is built.',
+    },
+    {
+        type: 'tabbed', label: 'Tabbed', category: 'container', status: 'design-complete',
+        family: 'display',
+        note: 'Unblocked 2026-09-25 by the batch 4 PRD (design_handoff_data_components_batch4, §6.1), which closes O5: tabs are DECLARED up front, each with its own output type; a declared tab with no data shows that type\'s empty state, and a tab whose data fails its schema shows Fallback in that panel only. The component is built (`Tabbed`, New components, 3 case studies) on the prototype\'s simplified panel renderers. Not yet an output/1 renderer: the X5 decision (option A) makes every child a full document with its own shell, and mounting those inside a tab panel would nest cards — the output/1 payload for declared tabs, and whether panels take shell-less children, is the remaining decision. No toText is defined for Tabbed in the PRD.',
+    },
+    {
+        type: 'fallback', label: 'Fallback', category: 'container', status: 'design-complete',
+        family: 'display',
+        note: 'The source conflict is closed by the batch 4 PRD (§6.2): Fallback is error recovery, NOT an output type and not a container that picks a child — it renders only when data fails its declared type\'s schema, as label/value rows, never raw text or JSON, with a muted "Showing a simplified view" note. Built as the `Fallback` component (New components, 3 case studies); its `flatten()` and toText (`flatToText`) are pure exports. Not yet wired into the output/1 dispatch (`OutputRenderer` would need a validate-then-fallback step per renderer); until then it stays out of the implemented list.',
+    },
+];
+/** `getOutputComponents({ status: 'implemented' })` — the query CompPack's `/components` runs.
+    `family` narrows further — e.g. `getOutputComponents({ status: 'implemented', family:
+    'decision' })` is the query the Decision section of `/components` runs. */
+export function getOutputComponents(opts = {}) {
+    return OUTPUT_CATALOGUE
+        .filter(e => !opts.status || e.status === opts.status)
+        .filter(e => !opts.family || e.family === opts.family);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/esm/widgets/output/catalog.js.map

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

package/dist/esm/widgets/output/document.d.ts

@@ -0,0 +1,146 @@
+import type { StatsBehaviour, StatsMetric, StatsPhase } from './renderers/stats';
+import type { KeyValueField, KeyValueMount, KeyValueThresholds } from './renderers/keyvalue';
+import type { DeltaRow } from './renderers/delta';
+import type { ComparisonOption } from './renderers/comparison';
+import type { SequenceStep } from './renderers/sequence';
+import type { ArtifactRow } from './renderers/artifact';
+import type { TextPoint, TextTreatment } from './renderers/text';
+import type { StatusOutcome, StatusDensity, StatusChip } from './renderers/status';
+import type { RankedItem } from './renderers/ranked';
+import type { DeckItem, DeckDensity, DeckDecision } from './renderers/deck';
+import type { DiffField } from './renderers/diff';
+import type { Finding } from './renderers/findings';
+import type { ListConfig } from './renderers/list';
+/**
+ * **The output wire contract — `output/1`.** `tasks/OUTPUT-WIDGETS.md` Phase 4.
+ *
+ * **O1, resolved.** *"Does the agent pick the output type at runtime, or is the chip a generated
+ * label over a declared type?"* The first bundle's own wire shape already answers it —
+ * `{"widget": "ranked", "chip": "TECH TRENDS", ...}` — the producer **declares** `widget`
+ * (a closed enum the renderer dispatches on), and `chip` is a free-text label that never changes
+ * which component draws. This mirrors `question/1`'s own `type` + `control` pair, declared rather
+ * than inferred (`docs/DECISIONS.md` Q1), and is why `output/1` is versioned the same way
+ * `question/1` and `component/1` are rather than inventing a second scheme.
+ *
+ * Extend `OutputWidgetKind` and the payload union together when the next renderer ships — this
+ * file and `spec/output.schema.json` are the two places that change.
+ */
+export type OutputWidgetKind = 'stats' | 'keyvalue' | 'delta' | 'comparison' | 'sequence' | 'artifact' | 'text' | 'status' | 'ranked' | 'deck' | 'diff' | 'findings' | 'list';
+/**
+ * **The shell's menu — corrected from an earlier, invented action set.** `X0`/Phase 10 originally
+ * shipped `keep`/`pass`/`export`/`rerun`, guessed ahead of a real spec. `_shared/SHELL.md` (the
+ * `design_handoff_output_variations` bundle) states the actual, fixed content: *"Identical on
+ * every card, in order: Send as email · WhatsApp · Download PDF · (hairline) · Copy · Remove from
+ * chat (`--coral-deep`, the only coloured row)."* It is not a per-document choice — every card
+ * gets the same five, always (O6, whether Delete joins them, is still open, so it is not here).
+ */
+export type OutputActionId = 'email' | 'whatsapp' | 'pdf' | 'copy' | 'remove';
+export declare const OUTPUT_ACTION_LABELS: Record<OutputActionId, string>;
+/** The fixed order, with the hairline's position — `[0,1,2] · hairline · [3,4]`. */
+export declare const STANDARD_OUTPUT_ACTIONS: OutputActionId[];
+/** Row index the hairline sits after (0-based) — between `pdf` and `copy`. */
+export declare const OUTPUT_ACTIONS_HAIRLINE_AFTER = 2;
+/** The only coloured row. */
+export declare const OUTPUT_DESTRUCTIVE_ACTION: OutputActionId;
+export type StatsPayload = {
+    metrics: StatsMetric[];
+    behaviour?: StatsBehaviour;
+    heroId?: string;
+    loadingCount?: number;
+    selected?: string | null;
+};
+export type KeyValuePayload = {
+    fields: KeyValueField[];
+    /** Gates mutation entirely — distinct from the shared `OutputDocument.mount`, which this
+        renderer does not use: the type sheet's own state shape (§2.8) is `'canvas' | 'dashboard'`,
+        not `'read' | 'write'`. */
+    mount?: KeyValueMount;
+    thresholds?: Partial<KeyValueThresholds>;
+};
+export type DeltaPayload = {
+    rows: DeltaRow[];
+    /** How many skeleton rows while `phase === 'loading'` and no rows are known yet. */
+    loadingCount?: number;
+};
+export type ComparisonPayload = {
+    /** Variation A ("two cards") — attributes are per-option, not a shared table; they don't line up across cards. */
+    options: ComparisonOption[];
+    selected?: string | null;
+};
+export type SequencePayload = {
+    steps: SequenceStep[];
+    /** Widget-local, not persisted — a starting position, not a result. Defaults to 0. */
+    activeIndex?: number;
+};
+export type ArtifactPayload = {
+    /** `null` = unavailable (distinct from `[]`, a genuinely empty but resolved document). */
+    rows: ArtifactRow[] | null;
+};
+export type TextPayload = {
+    points: TextPoint[];
+    /** Only consulted when `points.length === 1` and no point carries its own `title` — see
+        `text.md`'s routing rule. `'quote'` uses `attribution` below. */
+    treatment?: TextTreatment;
+    attribution?: string;
+};
+export type StatusPayload = {
+    outcome: StatusOutcome;
+    action: string;
+    density: StatusDensity;
+    meta?: string;
+    chips?: StatusChip[];
+};
+export type RankedPayload = {
+    items: RankedItem[];
+    loadingCount?: number;
+};
+export type DeckPayload = {
+    items: DeckItem[];
+    density: DeckDensity;
+    /** Write-mode decisions so far, keyed by item id — lifted to the host, echoed back here the
+        same way `comparison.selected` round-trips. Absent/empty means nothing decided yet. */
+    decided?: Record<string, DeckDecision>;
+};
+export type DiffPayload = {
+    fields?: DiffField[];
+    before?: string | null;
+    after?: string | null;
+};
+export type FindingsPayload = {
+    findings: Finding[];
+};
+/** `list` — the query-backed renderer. Unlike every other payload, this carries CONFIG (columns,
+    filters, copy…), not rows: rows come from a `DataAdapter` the component queries itself. */
+export type ListPayload = ListConfig;
+export type OutputPayloadFor<K extends OutputWidgetKind> = K extends 'stats' ? StatsPayload : K extends 'keyvalue' ? KeyValuePayload : K extends 'delta' ? DeltaPayload : K extends 'comparison' ? ComparisonPayload : K extends 'sequence' ? SequencePayload : K extends 'artifact' ? ArtifactPayload : K extends 'text' ? TextPayload : K extends 'status' ? StatusPayload : K extends 'ranked' ? RankedPayload : K extends 'deck' ? DeckPayload : K extends 'diff' ? DiffPayload : K extends 'findings' ? FindingsPayload : K extends 'list' ? ListPayload : never;
+/**
+ * A naked `K` in a conditional distributes over a union, so `OutputDocument` (no type argument)
+ * is a real discriminated union — `{ widget: 'stats'; payload: StatsPayload } | ...` — and
+ * `switch (doc.widget)` narrows `doc.payload` correctly. A plain (non-distributive) object type
+ * parameterised by `K` does not: every member would share one `payload: OutputPayloadFor<K>`
+ * shape with `K` unresolved, which is what broke `outputToText`'s switch the first time this had
+ * more than one member.
+ */
+export type OutputDocument<K extends OutputWidgetKind = OutputWidgetKind> = K extends OutputWidgetKind ? {
+    schema: 'output/1';
+    slug: string;
+    /** The declared renderer. Dispatch key — see the module docblock's O1 note. */
+    widget: K;
+    title: string;
+    /** A label override. Defaults to `widget` uppercased by the shell's `KindChip`. Never a type. */
+    chip?: string;
+    meta?: string;
+    /**
+     * `read` | `write` — the four dual-mode widgets' own axis (`deck`, `ranked`, `keyvalue`,
+     * `comparison`), per the wire shape both bundles show directly (`"mount": "write"`). Distinct
+     * from the app-level Canvas(streaming)/Dashboard(replay) table in the READMEs, which is a
+     * host policy this document doesn't carry. Ignored by read-only widgets like `stats`, and by
+     * `keyvalue`, which carries its own `mount: 'canvas' | 'dashboard'` inside its own payload —
+     * see `KeyValuePayload`.
+     */
+    mount?: 'read' | 'write';
+    phase?: StatsPhase;
+    payload: OutputPayloadFor<K>;
+} : never;
+export declare function isOutputDocument(value: unknown): value is OutputDocument;
+//# sourceMappingURL=document.d.ts.map

package/dist/esm/widgets/output/document.d.ts.map

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

package/dist/esm/widgets/output/document.js

@@ -0,0 +1,17 @@
+export const OUTPUT_ACTION_LABELS = {
+    email: 'Send as email',
+    whatsapp: 'WhatsApp',
+    pdf: 'Download PDF',
+    copy: 'Copy',
+    remove: 'Remove from chat',
+};
+/** The fixed order, with the hairline's position — `[0,1,2] · hairline · [3,4]`. */
+export const STANDARD_OUTPUT_ACTIONS = ['email', 'whatsapp', 'pdf', 'copy', 'remove'];
+/** Row index the hairline sits after (0-based) — between `pdf` and `copy`. */
+export const OUTPUT_ACTIONS_HAIRLINE_AFTER = 2;
+/** The only coloured row. */
+export const OUTPUT_DESTRUCTIVE_ACTION = 'remove';
+export function isOutputDocument(value) {
+    return !!value && typeof value === 'object' && value.schema === 'output/1';
+}
+//# sourceMappingURL=document.js.map

package/dist/esm/widgets/output/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../../src/widgets/output/document.ts"],"names":[],"mappings":"AA2CA,MAAM,CAAC,MAAM,oBAAoB,GAAmC;IAClE,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,cAAc;IACnB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,kBAAkB;CAC3B,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACxG,8EAA8E;AAC9E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAC/C,6BAA6B;AAC7B,MAAM,CAAC,MAAM,yBAAyB,GAAmB,QAAQ,CAAC;AAmIlE,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAA8B,CAAC,MAAM,KAAK,UAAU,CAAC;AACvG,CAAC"}

package/dist/esm/widgets/output/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * **Output widgets — the second widget family, `tasks/OUTPUT-WIDGETS.md`.**
+ *
+ * ```
+ * document contract (document.ts)
+ *       ↓
+ * renderer registry (registry.tsx)   ← catalogue (catalog.ts) says what's allowed to appear
+ *       ↓
+ * renderer (renderers/<name>/)
+ *       ↓
+ * shared shell (OutputWidgetShell.tsx) + motion (motion.ts)
+ *       ↓
+ * presentation
+ * ```
+ *
+ * From `design_handoff_output_widgets`, `design_handoff_output_blocks_stats`, and
+ * `design_handoff_output_blockers` (the implementation-depth type sheets — the shallow
+ * `design_handoff_output_variations` doc is not one). Shell (X0), motion (X0.5), `stats` (X2) and
+ * `keyvalue` (X1) are implemented; `delta`/`comparison` (X3) are design-complete with a fixture
+ * gap short of `implemented` — see `catalog.ts` for the authoritative per-renderer status and
+ * family (`display` vs. `decision`), and `docs/OUTPUT-COMPONENTS.md` for how to add the next one.
+ */
+export { OutputWidgetShell, KindChip as OutputKindChip, type OutputWidgetShellProps } from './OutputWidgetShell';
+export { outputShell, outputStats, outputRow, outputKeyValue, outputDelta, outputComparison, outputSequence, outputArtifact, outputRanked, outputList, } from './tokens';
+export { OUTPUT_MOTION, useEntranceTracker, useEntrance, staggerDelay, type EntranceVariant, type StreamingContract, } from './motion';
+export { StatsCard, statsToText, STATS_STREAMING, type StatsCardProps, type StatsMetric, type StatsTrend, type StatsBehaviour, type StatsPhase, type TrendTone, } from './renderers/stats';
+export { KeyValueCard, keyValueToText, type KeyValueCardProps, type KeyValueField, type KeyValueSource, type KeyValueThresholds, type KeyValueMount, type KeyValueBehaviour, type KeyValuePhase, } from './renderers/keyvalue';
+export { DeltaCard, deltaToText, type DeltaCardProps, type DeltaRow, type DeltaTone, type DeltaPhase, } from './renderers/delta';
+export { ComparisonCard, comparisonToText, type ComparisonCardProps, type ComparisonOption, type ComparisonPhase, } from './renderers/comparison';
+export { SequenceCard, sequenceToText, type SequenceCardProps, type SequenceStep, type SequencePhase, } from './renderers/sequence';
+export { ArtifactCard, artifactToText, type ArtifactCardProps, type ArtifactRow, type ArtifactPhase, } from './renderers/artifact';
+export { TextCard, textToText, routeTreatment, type TextCardProps, type TextPoint, type TextTreatment, type TextPhase, } from './renderers/text';
+export { StatusCard, statusToText, type StatusCardProps, type StatusOutcome, type StatusDensity, type StatusChip, } from './renderers/status';
+export { RankedCard, rankedToText, type RankedCardProps, type RankedItem, type RankedPhase, } from './renderers/ranked';
+export { DeckCard, deckToText, type DeckCardProps, type DeckItem, type DeckDensity, type DeckDecision, type DeckPhase, } from './renderers/deck';
+export { DiffCard, diffToText, type DiffCardProps, type DiffField, type DiffPhase, } from './renderers/diff';
+export { FindingsCard, findingsToText, type FindingsCardProps, type Finding, type FindingSeverity, type FindingsPhase, } from './renderers/findings';
+export { ListCard, listToText, mockAdapterFor, validateListConfig, LIST_LETTERS, type ListCardProps, type ListRuntimeSnapshot, type ListConfig, type ListColumn, type ListFilterConfig, type ListSortOption, type ListMock, type ListMockScenario, type ListAgentFilter, type ListFilterControl, } from './renderers/list';
+export { useQueryMachine, createMockAdapter, createEpochGuard, toAppError, isPristine, validateFilter, FILTER_OPS, type AppError, type AsyncStatus, type QueryReason, type QueryFlags, type QueryFilter, type FilterOp, type FilterAuthor, type FilterCheck, type FilterRejection, type RejectedFilter, type QuerySort, type QueryPage, type QueryDescriptor, type QueryRecord, type QueryResponse, type AdapterCapabilities, type DataAdapter, type MockAdapterOptions, type QueryState, type QueryConfig, type QueryMachine, } from './queryEngine';
+export { OUTPUT_ACTION_LABELS, STANDARD_OUTPUT_ACTIONS, OUTPUT_ACTIONS_HAIRLINE_AFTER, OUTPUT_DESTRUCTIVE_ACTION, isOutputDocument, type OutputDocument, type OutputWidgetKind, type OutputActionId, type OutputPayloadFor, type StatsPayload, type KeyValuePayload, type DeltaPayload, type ComparisonPayload, type SequencePayload, type ArtifactPayload, type TextPayload, type StatusPayload, type RankedPayload, type DeckPayload, type DiffPayload, type FindingsPayload, type ListPayload, } from './document';
+export { OUTPUT_RENDERERS, OutputRenderer, OutputChildren, outputToText, type OutputHandlers, type OutputContainerChild } from './registry';
+export { OUTPUT_CATALOGUE, getOutputComponents, type OutputCatalogueEntry, type OutputImplementationStatus, type OutputComponentFamily, } from './catalog';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/widgets/output/index.d.ts.map

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

package/dist/esm/widgets/output/index.js

@@ -0,0 +1,46 @@
+/**
+ * **Output widgets — the second widget family, `tasks/OUTPUT-WIDGETS.md`.**
+ *
+ * ```
+ * document contract (document.ts)
+ *       ↓
+ * renderer registry (registry.tsx)   ← catalogue (catalog.ts) says what's allowed to appear
+ *       ↓
+ * renderer (renderers/<name>/)
+ *       ↓
+ * shared shell (OutputWidgetShell.tsx) + motion (motion.ts)
+ *       ↓
+ * presentation
+ * ```
+ *
+ * From `design_handoff_output_widgets`, `design_handoff_output_blocks_stats`, and
+ * `design_handoff_output_blockers` (the implementation-depth type sheets — the shallow
+ * `design_handoff_output_variations` doc is not one). Shell (X0), motion (X0.5), `stats` (X2) and
+ * `keyvalue` (X1) are implemented; `delta`/`comparison` (X3) are design-complete with a fixture
+ * gap short of `implemented` — see `catalog.ts` for the authoritative per-renderer status and
+ * family (`display` vs. `decision`), and `docs/OUTPUT-COMPONENTS.md` for how to add the next one.
+ */
+/* Exported as `OutputKindChip`, not `KindChip` — `src/ds/Button.tsx` already owns that name for
+   an unrelated general-purpose kind pill; `export * from './output'` one level up (in
+   `src/widgets/index.ts`) would otherwise collide with it. */
+export { OutputWidgetShell, KindChip as OutputKindChip } from './OutputWidgetShell';
+export { outputShell, outputStats, outputRow, outputKeyValue, outputDelta, outputComparison, outputSequence, outputArtifact, outputRanked, outputList, } from './tokens';
+export { OUTPUT_MOTION, useEntranceTracker, useEntrance, staggerDelay, } from './motion';
+export { StatsCard, statsToText, STATS_STREAMING, } from './renderers/stats';
+export { KeyValueCard, keyValueToText, } from './renderers/keyvalue';
+export { DeltaCard, deltaToText, } from './renderers/delta';
+export { ComparisonCard, comparisonToText, } from './renderers/comparison';
+export { SequenceCard, sequenceToText, } from './renderers/sequence';
+export { ArtifactCard, artifactToText, } from './renderers/artifact';
+export { TextCard, textToText, routeTreatment, } from './renderers/text';
+export { StatusCard, statusToText, } from './renderers/status';
+export { RankedCard, rankedToText, } from './renderers/ranked';
+export { DeckCard, deckToText, } from './renderers/deck';
+export { DiffCard, diffToText, } from './renderers/diff';
+export { FindingsCard, findingsToText, } from './renderers/findings';
+export { ListCard, listToText, mockAdapterFor, validateListConfig, LIST_LETTERS, } from './renderers/list';
+export { useQueryMachine, createMockAdapter, createEpochGuard, toAppError, isPristine, validateFilter, FILTER_OPS, } from './queryEngine';
+export { OUTPUT_ACTION_LABELS, STANDARD_OUTPUT_ACTIONS, OUTPUT_ACTIONS_HAIRLINE_AFTER, OUTPUT_DESTRUCTIVE_ACTION, isOutputDocument, } from './document';
+export { OUTPUT_RENDERERS, OutputRenderer, OutputChildren, outputToText } from './registry';
+export { OUTPUT_CATALOGUE, getOutputComponents, } from './catalog';
+//# sourceMappingURL=index.js.map

package/dist/esm/widgets/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/widgets/output/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;;8DAE8D;AAC9D,OAAO,EAAE,iBAAiB,EAAE,QAAQ,IAAI,cAAc,EAA+B,MAAM,qBAAqB,CAAC;AACjH,OAAO,EACL,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAClF,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,GACzD,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,GAE7D,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,SAAS,EAAE,WAAW,EAAE,eAAe,GAExC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EAAE,cAAc,GAG7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,SAAS,EAAE,WAAW,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EAAE,gBAAgB,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,YAAY,EAAE,cAAc,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EAAE,cAAc,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,QAAQ,EAAE,UAAU,EAAE,cAAc,GAErC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,UAAU,EAAE,YAAY,GAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EAAE,YAAY,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,QAAQ,EAAE,UAAU,GAErB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,QAAQ,EAAE,UAAU,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EAAE,cAAc,GAE7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,GAGvE,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,GAIzG,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,yBAAyB,EACvG,gBAAgB,GAKjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAkD,MAAM,YAAY,CAAC;AAC5I,OAAO,EACL,gBAAgB,EAAE,mBAAmB,GAEtC,MAAM,WAAW,CAAC"}

package/dist/esm/widgets/output/motion.d.ts

@@ -0,0 +1,106 @@
+import { Animated } from 'react-native';
+export declare const OUTPUT_MOTION: {
+    readonly rise: {
+        readonly duration: 220;
+        readonly easing: import("react-native").EasingFunction;
+        readonly distance: 9;
+        readonly transform: "translateY(9px) → none, opacity 0→1";
+    };
+    readonly countUp: {
+        readonly duration: 240;
+        readonly easing: import("react-native").EasingFunction;
+        readonly distance: 6;
+        readonly transform: "translateY(6px) → none, opacity 0→1";
+    };
+    readonly shimmer: {
+        readonly duration: 900;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "background-position sweep";
+    };
+    readonly pop: {
+        readonly duration: 260;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "scale(.84) → 1.06 → 1";
+    };
+    readonly sheetUp: {
+        readonly duration: 240;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "translateY(100%) → none";
+    };
+    readonly slideIn: {
+        readonly duration: 210;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "translateX(14px) → none";
+    };
+    readonly slideInBack: {
+        readonly duration: 210;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "translateX(-14px) → none";
+    };
+    readonly grow: {
+        readonly duration: 210;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "max-height 0 → open, opacity 0→1";
+    };
+    readonly fill: {
+        readonly duration: 320;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "scaleX(0 → 1), origin left";
+    };
+    readonly caret: {
+        readonly duration: 900;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "opacity 1/0";
+    };
+    readonly pulse: {
+        readonly duration: 1200;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "opacity 1 → .45 → 1";
+    };
+    /** Documentation only. Never call `useLoop`/`useEntrance` with this — it never ships. */
+    readonly countcycle: {
+        readonly duration: 2600;
+        readonly easing: import("react-native").EasingFunction;
+        readonly transform: "as countUp, looped";
+    };
+};
+/** **The rule.** Bind entrance to a stable item id, never to array index or render count. */
+export type EntranceVariant = 'rise' | 'countUp' | 'pop';
+/**
+ * One `Set` per list, shared by every item's `useEntrance` call, so a played entrance stays
+ * played across the list's re-renders — including the re-renders streaming causes on every
+ * partial payload.
+ */
+export declare function useEntranceTracker(): Set<string>;
+/**
+ * **Stagger arithmetic** — 70ms between rows, 80ms between `stats` tiles, capped at 8 items.
+ * Past the cap every item shares one un-delayed `rise`, because a twenty-row list staggered at
+ * 70ms takes 1.6s to finish arriving, which reads as slow loading rather than as motion.
+ */
+export declare function staggerDelay(index: number, stepMs?: number, cap?: number): number;
+/**
+ * Fires `rise` / `countUp` / `pop` once per item identity, on first appearance, never on
+ * re-render. `seen` is `useEntranceTracker()`'s `Set`, shared across the list.
+ *
+ * Reduced motion snaps straight to the settled value — the item still counts as "seen," so a
+ * later re-render (a streaming partial resolving the same id again) does not attempt to play it.
+ */
+export declare function useEntrance(id: string, seen: Set<string>, opts?: {
+    variant: EntranceVariant;
+    delayMs?: number;
+    enabled?: boolean;
+}): {
+    opacity: Animated.Value;
+    translateY: Animated.Value;
+    scale: Animated.Value;
+};
+/**
+ * **Two streaming numbers, declared before any renderer draws a partial payload.**
+ * `minimumViablePartial` is the smallest field set the renderer will draw at all;
+ * `reservedHeight` is fixed before the first partial arrives so content below never moves.
+ */
+export type StreamingContract = {
+    minimumViablePartial: string;
+    reservedHeight: number;
+};
+//# sourceMappingURL=motion.d.ts.map

package/dist/esm/widgets/output/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../../../src/widgets/output/motion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAU,MAAM,cAAc,CAAC;AAqBhD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYxB,yFAAyF;;;;;;CAEjF,CAAC;AAEX,6FAA6F;AAC7F,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,MAAM,CAAC,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAsB,EAAE,GAAG,GAAE,MAAqB,GAAG,MAAM,CAE9G;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,IAAI,GAAE;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAwB,GAC5F;IAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;IAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAA;CAAE,CAyChF;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC"}