@opensip-cli/cli-ui 0.1.0

package/dist/error-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.js","sourceRoot":"","sources":["../src/error-message.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAGhC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,MAAM,UAAU,YAAY,CAAC,EAAE,OAAO,EAAE,UAAU,EAAqB;IACrE,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IAEzB,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,WAAW,EAAE,CAAC,aACxC,MAAC,IAAI,eACH,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,YAAG,GAAG,GAAQ,OAAE,OAAO,IAC1C,EACN,UAAU,KAAK,SAAS,IAAI,CAC3B,MAAC,IAAI,IAAC,QAAQ,mBACX,MAAM,EACN,UAAU,IACN,CACR,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/fit-table-format.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared, renderer-agnostic helpers for the fitness results table.
+ *
+ * Used by BOTH the cli static view-model builder (`fit-done-view.ts`) and the
+ * fitness live Ink view (`fit-runner-views.tsx`), which previously each kept a
+ * byte-identical copy (flagged by graph:duplicated-function-body). Pure
+ * functions with structural parameter types so cli-ui stays free of any
+ * @opensip-cli dependency — contracts' `TableRow` structurally satisfies
+ * `FitRowSortKey`, so callers pass a `TableRow` directly.
+ */
+/** The fields {@link sortFitRowPriority} reads off a fit results row. */
+export interface FitRowSortKey {
+    readonly status: 'PASS' | 'FAIL' | 'TIMEOUT' | 'ERROR';
+    readonly warnings: number;
+}
+/**
+ * Sort priority for the fit results table: timed-out / errored checks first,
+ * then failures, then checks carrying warnings, then clean checks. Lower sorts
+ * earlier. (ERROR is the envelope-table status for a unit that threw — it sorts
+ * with TIMEOUT, the prior plain-table's "couldn't complete" rung.)
+ */
+export declare function sortFitRowPriority(r: FitRowSortKey): number;
+/**
+ * Parse the leading integer out of a "Validated" cell — e.g. `"171 files"` →
+ * `171`, `"—"` → `0`. Used to compute the ignored-ratio tone/colour.
+ */
+export declare function parseValidatedCount(validated: string): number;
+/**
+ * Render a "Validated" table cell: item count with a singular/plural noun
+ * (e.g. `450 → "450 files"`, `1 → "1 file"`, `0`/undefined → `"—"`). Shared by
+ * the fit static view-model and live Ink view so both render the column
+ * identically. `itemType` defaults to `"items"`.
+ */
+export declare function formatValidatedColumn(totalItems: number | undefined, itemType?: string): string;
+//# sourceMappingURL=fit-table-format.d.ts.map

package/dist/fit-table-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit-table-format.d.ts","sourceRoot":"","sources":["../src/fit-table-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAK3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAU,GAAG,MAAM,CAIhG"}

package/dist/fit-table-format.js

@@ -0,0 +1,48 @@
+/**
+ * Shared, renderer-agnostic helpers for the fitness results table.
+ *
+ * Used by BOTH the cli static view-model builder (`fit-done-view.ts`) and the
+ * fitness live Ink view (`fit-runner-views.tsx`), which previously each kept a
+ * byte-identical copy (flagged by graph:duplicated-function-body). Pure
+ * functions with structural parameter types so cli-ui stays free of any
+ * @opensip-cli dependency — contracts' `TableRow` structurally satisfies
+ * `FitRowSortKey`, so callers pass a `TableRow` directly.
+ */
+/**
+ * Sort priority for the fit results table: timed-out / errored checks first,
+ * then failures, then checks carrying warnings, then clean checks. Lower sorts
+ * earlier. (ERROR is the envelope-table status for a unit that threw — it sorts
+ * with TIMEOUT, the prior plain-table's "couldn't complete" rung.)
+ */
+export function sortFitRowPriority(r) {
+    if (r.status === 'TIMEOUT' || r.status === 'ERROR')
+        return 0;
+    if (r.status === 'FAIL')
+        return 1;
+    if (r.warnings > 0)
+        return 2;
+    return 3;
+}
+/**
+ * Parse the leading integer out of a "Validated" cell — e.g. `"171 files"` →
+ * `171`, `"—"` → `0`. Used to compute the ignored-ratio tone/colour.
+ */
+export function parseValidatedCount(validated) {
+    if (validated === '—')
+        return 0;
+    const match = /^(\d+)/.exec(validated);
+    return match ? Number.parseInt(match[1], 10) : 0;
+}
+/**
+ * Render a "Validated" table cell: item count with a singular/plural noun
+ * (e.g. `450 → "450 files"`, `1 → "1 file"`, `0`/undefined → `"—"`). Shared by
+ * the fit static view-model and live Ink view so both render the column
+ * identically. `itemType` defaults to `"items"`.
+ */
+export function formatValidatedColumn(totalItems, itemType = 'items') {
+    if (!totalItems)
+        return '—';
+    const singular = itemType.endsWith('s') ? itemType.slice(0, -1) : itemType;
+    return totalItems === 1 ? `${totalItems} ${singular}` : `${totalItems} ${itemType}`;
+}
+//# sourceMappingURL=fit-table-format.js.map

package/dist/fit-table-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit-table-format.js","sourceRoot":"","sources":["../src/fit-table-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAgB;IACjD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,IAAI,SAAS,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAA8B,EAAE,QAAQ,GAAG,OAAO;IACtF,IAAI,CAAC,UAAU;QAAE,OAAO,GAAG,CAAC;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3E,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;AACtF,CAAC"}

package/dist/format-duration.d.ts

@@ -0,0 +1,13 @@
+/**
+ * formatDuration — compact ms→human duration used by the shared run-summary and
+ * live-progress renderers. Extracted from run-summary.tsx so both consumers share
+ * one definition (cli-ui cannot import `@opensip-cli/core`'s formatDuration —
+ * the package depends on ink/react only).
+ *
+ * Format: `<1000ms → "Nms"`, sub-minute durations as `"N.Ys"` (one decimal),
+ * and minute-scale durations as `"Nm Y.Ys"`. Long stages render as e.g.
+ * "24m 31.6s" so graph runs that spend many minutes in a stage remain easy to
+ * scan.
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=format-duration.d.ts.map

package/dist/format-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-duration.d.ts","sourceRoot":"","sources":["../src/format-duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CASjD"}

package/dist/format-duration.js

@@ -0,0 +1,23 @@
+/**
+ * formatDuration — compact ms→human duration used by the shared run-summary and
+ * live-progress renderers. Extracted from run-summary.tsx so both consumers share
+ * one definition (cli-ui cannot import `@opensip-cli/core`'s formatDuration —
+ * the package depends on ink/react only).
+ *
+ * Format: `<1000ms → "Nms"`, sub-minute durations as `"N.Ys"` (one decimal),
+ * and minute-scale durations as `"Nm Y.Ys"`. Long stages render as e.g.
+ * "24m 31.6s" so graph runs that spend many minutes in a stage remain easy to
+ * scan.
+ */
+// @fitness-ignore-file duplicate-utility-functions -- intentional: cli-ui is deliberately ink/react-only (see docstring above) and must not depend on @opensip-cli/core, so this small formatter is duplicated by design rather than shared across the layer boundary.
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const totalTenths = Math.round(ms / 100);
+    if (totalTenths < 600)
+        return `${(totalTenths / 10).toFixed(1)}s`;
+    const minutes = Math.floor(totalTenths / 600);
+    const remainingTenths = totalTenths % 600;
+    return `${minutes}m ${(remainingTenths / 10).toFixed(1)}s`;
+}
+//# sourceMappingURL=format-duration.js.map

package/dist/format-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-duration.js","sourceRoot":"","sources":["../src/format-duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,uQAAuQ;AACvQ,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAEhC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;IACzC,IAAI,WAAW,GAAG,GAAG;QAAE,OAAO,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAElE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,WAAW,GAAG,GAAG,CAAC;IAC1C,OAAO,GAAG,OAAO,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @opensip-cli/cli-ui — shared Ink/React presentational primitives for
+ * OpenSIP CLI CLI tools.
+ *
+ * Tools that ship an Ink live view (fitness, graph, future audit/lint/etc.)
+ * import from this package instead of duplicating banner/spinner/header
+ * code in their own runner files. The CLI's static-render path (App.tsx)
+ * imports the same primitives so the live view and the post-run summary
+ * look consistent.
+ *
+ * This package depends on `ink` and `react` only; no opensip-cli deps,
+ * no Node-runtime side-effects beyond the theme's terminal-capability
+ * detection. Safe to import from any Layer 3 tool package.
+ */
+export { Banner, UpdateHint, normalizeBannerSize, type BannerSize, type BannerProps, } from './banner.js';
+export { ErrorMessage, type ErrorMessageProps } from './error-message.js';
+export { ProjectHeader, formatProjectHeader, viewProjectHeader, type ProjectHeaderInput, } from './project-header.js';
+export { RunHeader, type RunHeaderProps, type RunHeaderMeta } from './run-header.js';
+export { RunSummary, viewRunSummary, type RunSummaryProps } from './run-summary.js';
+export { RunTimingProvider, useRunTiming, useRunDuration, type RunTimingProviderProps, } from './run-timing-provider.js';
+export { RunFooterHints, viewFooterHints, type RunFooterHint, type RunFooterHintsProps, } from './run-footer-hints.js';
+export { sortFitRowPriority, parseValidatedCount, formatValidatedColumn, type FitRowSortKey, } from './fit-table-format.js';
+export { Spinner, type SpinnerProps, useSpinner, useStandaloneSpinner } from './spinner.js';
+export { ClockProvider, type ClockProviderProps, useClock, useTick } from './clock.js';
+export { formatDuration } from './format-duration.js';
+export { LiveProgress, useProgressState, type LiveProgressProps } from './live-progress.js';
+export type { ProgressEvent, ProgressCallback, ProgressShape, ProgressStageDescriptor, ProgressSurface, } from './progress-event.js';
+export { type ViewNode, type Span, type Tone, type HintItem, type TableColumnSpec, text, line, group, viewTable, } from './view-model.js';
+export { viewVerboseLines, viewFindingsGroups, viewVerboseHint, VERBOSE_DETAIL_HINT, type FindingLineView, type FindingGroupView, } from './verbose-detail.js';
+export { renderToText } from './render-to-text.js';
+export { renderToInk } from './render-to-ink.js';
+export { DEFAULT_THEME, ThemeContext, ThemeProvider, type Theme, type ThemeProviderProps, type TerminalCapabilities, detectTerminalCapabilities, useTheme, } from './theme.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,MAAM,EACN,UAAU,EACV,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,KAAK,KAAK,EACV,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @opensip-cli/cli-ui — shared Ink/React presentational primitives for
+ * OpenSIP CLI CLI tools.
+ *
+ * Tools that ship an Ink live view (fitness, graph, future audit/lint/etc.)
+ * import from this package instead of duplicating banner/spinner/header
+ * code in their own runner files. The CLI's static-render path (App.tsx)
+ * imports the same primitives so the live view and the post-run summary
+ * look consistent.
+ *
+ * This package depends on `ink` and `react` only; no opensip-cli deps,
+ * no Node-runtime side-effects beyond the theme's terminal-capability
+ * detection. Safe to import from any Layer 3 tool package.
+ */
+export { Banner, UpdateHint, normalizeBannerSize, } from './banner.js';
+export { ErrorMessage } from './error-message.js';
+export { ProjectHeader, formatProjectHeader, viewProjectHeader, } from './project-header.js';
+export { RunHeader } from './run-header.js';
+export { RunSummary, viewRunSummary } from './run-summary.js';
+export { RunTimingProvider, useRunTiming, useRunDuration, } from './run-timing-provider.js';
+export { RunFooterHints, viewFooterHints, } from './run-footer-hints.js';
+export { sortFitRowPriority, parseValidatedCount, formatValidatedColumn, } from './fit-table-format.js';
+export { Spinner, useSpinner, useStandaloneSpinner } from './spinner.js';
+export { ClockProvider, useClock, useTick } from './clock.js';
+export { formatDuration } from './format-duration.js';
+export { LiveProgress, useProgressState } from './live-progress.js';
+export { text, line, group, viewTable, } from './view-model.js';
+export { viewVerboseLines, viewFindingsGroups, viewVerboseHint, VERBOSE_DETAIL_HINT, } from './verbose-detail.js';
+export { renderToText } from './render-to-text.js';
+export { renderToInk } from './render-to-ink.js';
+export { DEFAULT_THEME, ThemeContext, ThemeProvider, detectTerminalCapabilities, useTheme, } from './theme.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,MAAM,EACN,UAAU,EACV,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAA0B,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAA2C,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAwB,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GAEf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,cAAc,EACd,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAqB,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,aAAa,EAA2B,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAA0B,MAAM,oBAAoB,CAAC;AAQ5F,OAAO,EAML,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EAIb,0BAA0B,EAC1B,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/live-progress.d.ts

@@ -0,0 +1,57 @@
+/**
+ * LiveProgress — the single live-run renderer shared by fit, graph, and sim
+ * (ADR-0016). Replaces graph's bespoke StageChecklist/StageLine/RunningStageLine
+ * and fit's inline Spinner wiring with one component driven by the
+ * {@link ProgressEvent} stream.
+ *
+ * Two presentation modes, chosen by the {@link ProgressSurface}:
+ *   - `phases` → a checklist: ✓ done rows (label + detail + duration), `(cached)`
+ *     rows, an active spinner row with a dim running sub-label + live elapsed, and
+ *     ○ dim pending rows. (Visual ported verbatim from graph's former checklist.)
+ *   - `pool` → the existing `<Spinner>` (frame + label + `completed/total (pct%)`).
+ *
+ * Presentational only: `useProgressState` folds the event stream into render
+ * state so the tool runners stay thin (they just wire `transport.onProgress`).
+ * Must be mounted inside a `<ThemeProvider>` + `<ClockProvider>` (the tool
+ * runners already provide both).
+ */
+import React from 'react';
+import type { ProgressCallback, ProgressStageDescriptor, ProgressSurface } from './progress-event.js';
+type PhaseStatus = {
+    readonly kind: 'pending';
+} | {
+    readonly kind: 'running';
+    readonly startedAt: number;
+} | {
+    readonly kind: 'done';
+    readonly durationMs: number;
+    readonly detail?: string;
+} | {
+    readonly kind: 'cached';
+};
+interface PhasesState {
+    readonly shape: 'phases';
+    readonly stages: readonly ProgressStageDescriptor[];
+    readonly status: Readonly<Record<string, PhaseStatus>>;
+}
+interface PoolState {
+    readonly shape: 'pool';
+    readonly label: string;
+    readonly completed: number;
+    readonly total: number;
+}
+type ProgressState = PhasesState | PoolState;
+/**
+ * Subscribe to a transport's event stream and fold it into render state. The
+ * `subscribe` function is the transport's `onProgress`; it is called exactly
+ * once on mount (the transport buffers any events emitted before subscription
+ * and flushes them on attach, so none are lost).
+ */
+export declare function useProgressState(surface: ProgressSurface, subscribe: (cb: ProgressCallback) => void): ProgressState;
+export interface LiveProgressProps {
+    readonly surface: ProgressSurface;
+    readonly subscribe: (cb: ProgressCallback) => void;
+}
+export declare function LiveProgress({ surface, subscribe }: LiveProgressProps): React.ReactElement;
+export {};
+//# sourceMappingURL=live-progress.d.ts.map

package/dist/live-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-progress.d.ts","sourceRoot":"","sources":["../src/live-progress.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAMnD,OAAO,KAAK,EACV,gBAAgB,EAEhB,uBAAuB,EACvB,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAM7B,KAAK,WAAW,GACZ;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEhC,UAAU,WAAW;IACnB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CACxD;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAwC7C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,GACxC,aAAa,CAQf;AAMD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAoB1F"}

package/dist/live-progress.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * LiveProgress — the single live-run renderer shared by fit, graph, and sim
+ * (ADR-0016). Replaces graph's bespoke StageChecklist/StageLine/RunningStageLine
+ * and fit's inline Spinner wiring with one component driven by the
+ * {@link ProgressEvent} stream.
+ *
+ * Two presentation modes, chosen by the {@link ProgressSurface}:
+ *   - `phases` → a checklist: ✓ done rows (label + detail + duration), `(cached)`
+ *     rows, an active spinner row with a dim running sub-label + live elapsed, and
+ *     ○ dim pending rows. (Visual ported verbatim from graph's former checklist.)
+ *   - `pool` → the existing `<Spinner>` (frame + label + `completed/total (pct%)`).
+ *
+ * Presentational only: `useProgressState` folds the event stream into render
+ * state so the tool runners stay thin (they just wire `transport.onProgress`).
+ * Must be mounted inside a `<ThemeProvider>` + `<ClockProvider>` (the tool
+ * runners already provide both).
+ */
+import { Box, Text } from 'ink';
+import { useEffect, useState } from 'react';
+import { formatDuration } from './format-duration.js';
+import { Spinner, useSpinner } from './spinner.js';
+import { useTheme } from './theme.js';
+function initState(surface) {
+    if (surface.shape === 'pool') {
+        return { shape: 'pool', label: surface.label, completed: 0, total: 0 };
+    }
+    const status = {};
+    for (const s of surface.stages)
+        status[s.id] = { kind: 'pending' };
+    return { shape: 'phases', stages: surface.stages, status };
+}
+function reduce(prev, event) {
+    if (prev.shape === 'pool') {
+        if (event.type === 'stage-progress') {
+            return { ...prev, completed: event.completed, total: event.total };
+        }
+        return prev;
+    }
+    // phases
+    const next = { ...prev.status };
+    switch (event.type) {
+        case 'stage-start': {
+            next[event.stage] = { kind: 'running', startedAt: Date.now() };
+            break;
+        }
+        case 'stage-done': {
+            next[event.stage] = { kind: 'done', durationMs: event.durationMs, detail: event.detail };
+            break;
+        }
+        case 'stage-cached': {
+            next[event.stage] = { kind: 'cached' };
+            break;
+        }
+        case 'stage-progress': {
+            break; // phases mode ignores pool counters
+        }
+    }
+    return { ...prev, status: next };
+}
+/**
+ * Subscribe to a transport's event stream and fold it into render state. The
+ * `subscribe` function is the transport's `onProgress`; it is called exactly
+ * once on mount (the transport buffers any events emitted before subscription
+ * and flushes them on attach, so none are lost).
+ */
+export function useProgressState(surface, subscribe) {
+    const [state, setState] = useState(() => initState(surface));
+    // Subscribe once on mount — the transport owns the listener lifetime and
+    // buffers/flushes any events emitted before this effect runs.
+    useEffect(() => {
+        subscribe((event) => setState((prev) => reduce(prev, event)));
+    }, []);
+    return state;
+}
+export function LiveProgress({ surface, subscribe }) {
+    const state = useProgressState(surface, subscribe);
+    if (state.shape === 'pool') {
+        return (_jsx(Box, { paddingLeft: 2, children: _jsx(Spinner, { total: state.total, completed: state.completed, label: state.label }) }));
+    }
+    return (_jsx(Box, { flexDirection: "column", paddingLeft: 2, paddingTop: 1, children: state.stages.map((stage) => (_jsx(PhaseLine, { stage: stage, status: state.status[stage.id] ?? { kind: 'pending' } }, stage.id))) }));
+}
+function PhaseLine({ stage, status, }) {
+    const theme = useTheme();
+    if (status.kind === 'pending') {
+        return (_jsxs(Text, { dimColor: true, children: ['  ', _jsx(Text, { children: "\u25CB" }), " ", stage.label] }));
+    }
+    if (status.kind === 'cached') {
+        return (_jsxs(Text, { children: [_jsx(Text, { color: theme.success, children: "\u2713" }), " ", _jsx(Text, { children: stage.label }), '   ', _jsx(Text, { dimColor: true, children: "(cached)" })] }));
+    }
+    if (status.kind === 'done') {
+        const dur = formatDuration(status.durationMs);
+        const detail = status.detail ? `${status.detail} (${dur})` : dur;
+        return (_jsxs(Text, { children: [_jsx(Text, { color: theme.success, children: "\u2713" }), " ", _jsx(Text, { children: stage.label }), '   ', _jsx(Text, { dimColor: true, children: detail })] }));
+    }
+    return _jsx(RunningPhaseLine, { stage: stage, startedAt: status.startedAt });
+}
+function RunningPhaseLine({ stage, startedAt, }) {
+    const theme = useTheme();
+    const frame = useSpinner();
+    // Re-render on each tick; derive wall-clock elapsed from Date.now() so it stays
+    // accurate regardless of how many ticks fired since startedAt.
+    const elapsed = formatDuration(Date.now() - startedAt);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { color: theme.brand, children: frame }), " ", _jsx(Text, { bold: true, children: stage.label })] }), _jsxs(Text, { children: ['    └─ ', stage.runningDetail ? _jsxs(Text, { dimColor: true, children: [stage.runningDetail, " "] }) : null, _jsxs(Text, { dimColor: true, children: ["(", elapsed, ")"] })] })] }));
+}
+//# sourceMappingURL=live-progress.js.map

package/dist/live-progress.js.map

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

package/dist/progress-event.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Progress currency — the universal live-run event vocabulary consumed by the
+ * shared `<LiveProgress>` renderer (ADR-0016). The run-time analogue of
+ * `@opensip-cli/contracts`' `SignalEnvelope` *output* currency.
+ *
+ * Why this lives in cli-ui (not contracts): progress is renderer-bound and
+ * ephemeral — it is never persisted or egressed the way a `SignalEnvelope` is.
+ * The renderer owns its input vocabulary, and cli-ui depends on ink/react only,
+ * so the pure presentational leaf carries no `@opensip-cli/*` dependency.
+ *
+ * One event union covers both tool shapes:
+ *   - `phases` — few, fixed, ordered, named stages (graph's 7-stage pipeline),
+ *     rendered as a checklist with one active spinner row.
+ *   - `pool`   — many, dynamic, possibly concurrent units (fit's checks, sim's
+ *     scenarios), rendered as a single spinner + `completed/total` counter.
+ *
+ * `stage` is a free-form string id: graph maps its `GraphStage`; pool-shape tools
+ * use one synthetic id (`'checks'`, `'scenarios'`).
+ */
+/** A single live-progress event emitted by a running tool. */
+export type ProgressEvent = {
+    readonly type: 'stage-start';
+    readonly stage: string;
+    readonly label: string;
+} | {
+    readonly type: 'stage-progress';
+    readonly stage: string;
+    readonly completed: number;
+    readonly total: number;
+} | {
+    readonly type: 'stage-done';
+    readonly stage: string;
+    readonly durationMs: number;
+    readonly detail?: string;
+}
+/** Phases-mode only: a cache hit satisfied this stage (graph parse/walk/resolve). */
+ | {
+    readonly type: 'stage-cached';
+    readonly stage: string;
+};
+/** Listener invoked with each {@link ProgressEvent} as a run progresses. */
+export type ProgressCallback = (event: ProgressEvent) => void;
+/** Which of the two presentation modes a tool's progress uses. */
+export type ProgressShape = 'phases' | 'pool';
+/** A fixed pipeline stage declared up front so the checklist can render the
+ *  pending (○) row before the stage starts. `id` matches the `stage` field of
+ *  this stage's events. `runningDetail` is the dim sub-label shown under the
+ *  active spinner row (e.g. "Binding symbols to edges..."). */
+export interface ProgressStageDescriptor {
+    readonly id: string;
+    readonly label: string;
+    readonly runningDetail?: string;
+}
+/**
+ * What the renderer needs up front to pick a mode and pre-render rows.
+ *   - `phases`: the fixed, ordered stage descriptors.
+ *   - `pool`: a label for the single running line (e.g. "Running checks...").
+ */
+export type ProgressSurface = {
+    readonly shape: 'phases';
+    readonly stages: readonly ProgressStageDescriptor[];
+} | {
+    readonly shape: 'pool';
+    readonly label: string;
+};
+//# sourceMappingURL=progress-event.d.ts.map

package/dist/progress-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-event.d.ts","sourceRoot":"","sources":["../src/progress-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChF;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AACH,qFAAqF;GACnF;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C;;;+DAG+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/progress-event.js

@@ -0,0 +1,21 @@
+/**
+ * Progress currency — the universal live-run event vocabulary consumed by the
+ * shared `<LiveProgress>` renderer (ADR-0016). The run-time analogue of
+ * `@opensip-cli/contracts`' `SignalEnvelope` *output* currency.
+ *
+ * Why this lives in cli-ui (not contracts): progress is renderer-bound and
+ * ephemeral — it is never persisted or egressed the way a `SignalEnvelope` is.
+ * The renderer owns its input vocabulary, and cli-ui depends on ink/react only,
+ * so the pure presentational leaf carries no `@opensip-cli/*` dependency.
+ *
+ * One event union covers both tool shapes:
+ *   - `phases` — few, fixed, ordered, named stages (graph's 7-stage pipeline),
+ *     rendered as a checklist with one active spinner row.
+ *   - `pool`   — many, dynamic, possibly concurrent units (fit's checks, sim's
+ *     scenarios), rendered as a single spinner + `completed/total` counter.
+ *
+ * `stage` is a free-form string id: graph maps its `GraphStage`; pool-shape tools
+ * use one synthetic id (`'checks'`, `'scenarios'`).
+ */
+export {};
+//# sourceMappingURL=progress-event.js.map

package/dist/progress-event.js.map

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

package/dist/project-header.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ProjectHeader — the single, canonical "Project: <root>" location marker.
+ *
+ * Rendered once per human-facing command, directly under the banner, by
+ * the CLI's App shell (static commands) and by each tool's live view
+ * (fit/graph). This is the ONLY renderer of the project line — RunHeader
+ * no longer carries it, and the imperative pre-action print is gone — so
+ * there is exactly one place the format lives.
+ *
+ * `--json` and `completion` never render UI, so they never reach here.
+ */
+import React from 'react';
+import { type ViewNode } from './view-model.js';
+export interface ProjectHeaderInput {
+    /** Absolute path to the project root. */
+    readonly root: string;
+    /** Ancestor steps walked from cwd to root. 0 == cwd is the root. */
+    readonly walkedUp?: number;
+}
+/**
+ * The project-line text (no trailing newline — Ink owns line breaks):
+ *   walkedUp 0  → `ℹ Project: <root>`
+ *   walkedUp 1  → `ℹ Project: <root>  (found 1 level up)`
+ *   walkedUp N  → `ℹ Project: <root>  (found N levels up)`
+ */
+export declare function formatProjectHeader(input: ProjectHeaderInput): string;
+/** The project line as a renderer-agnostic view-model node (rendered dim). */
+export declare function viewProjectHeader(input: ProjectHeaderInput): ViewNode;
+/** Ink view of {@link viewProjectHeader}. Indented to align with RunHeader. */
+export declare function ProjectHeader({ root, walkedUp }: ProjectHeaderInput): React.ReactElement;
+//# sourceMappingURL=project-header.d.ts.map

package/dist/project-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-header.d.ts","sourceRoot":"","sources":["../src/project-header.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAMrE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,CAErE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAMxF"}

package/dist/project-header.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ProjectHeader — the single, canonical "Project: <root>" location marker.
+ *
+ * Rendered once per human-facing command, directly under the banner, by
+ * the CLI's App shell (static commands) and by each tool's live view
+ * (fit/graph). This is the ONLY renderer of the project line — RunHeader
+ * no longer carries it, and the imperative pre-action print is gone — so
+ * there is exactly one place the format lives.
+ *
+ * `--json` and `completion` never render UI, so they never reach here.
+ */
+import { Box } from 'ink';
+import { renderToInk } from './render-to-ink.js';
+import { line } from './view-model.js';
+/**
+ * The project-line text (no trailing newline — Ink owns line breaks):
+ *   walkedUp 0  → `ℹ Project: <root>`
+ *   walkedUp 1  → `ℹ Project: <root>  (found 1 level up)`
+ *   walkedUp N  → `ℹ Project: <root>  (found N levels up)`
+ */
+export function formatProjectHeader(input) {
+    const walkedUp = input.walkedUp ?? 0;
+    const base = `ℹ Project: ${input.root}`;
+    if (walkedUp === 0)
+        return base;
+    const noun = walkedUp === 1 ? 'level' : 'levels';
+    return `${base}  (found ${walkedUp} ${noun} up)`;
+}
+/** The project line as a renderer-agnostic view-model node (rendered dim). */
+export function viewProjectHeader(input) {
+    return line([{ text: formatProjectHeader(input) }], true);
+}
+/** Ink view of {@link viewProjectHeader}. Indented to align with RunHeader. */
+export function ProjectHeader({ root, walkedUp }) {
+    return (_jsx(Box, { paddingLeft: 2, paddingTop: 1, children: renderToInk(viewProjectHeader({ root, walkedUp })) }));
+}
+//# sourceMappingURL=project-header.js.map

package/dist/project-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-header.js","sourceRoot":"","sources":["../src/project-header.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAiB,MAAM,iBAAiB,CAAC;AAStD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,cAAc,KAAK,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjD,OAAO,GAAG,IAAI,YAAY,QAAQ,IAAI,IAAI,MAAM,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,OAAO,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAsB;IAClE,OAAO,CACL,KAAC,GAAG,IAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,YAC/B,WAAW,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,GAC/C,CACP,CAAC;AACJ,CAAC"}

package/dist/render-to-ink.d.ts

@@ -0,0 +1,15 @@
+/**
+ * renderToInk — the interactive (TTY) interpreter.
+ *
+ * Walks the same `ViewNode` tree as `renderToText` and returns an Ink
+ * element, mapping each semantic `Tone` onto a `DEFAULT_THEME` token via
+ * `useTheme()` so the theme stays the single source of color truth. The
+ * visible text it produces is identical to `renderToText`'s output (the
+ * cross-renderer equivalence tests assert `stripAnsi(ink) === text`); the
+ * only thing Ink adds is color, weight, and dimming.
+ */
+import React from 'react';
+import type { ViewNode } from './view-model.js';
+/** Render a view-model node to an Ink element. */
+export declare function renderToInk(node: ViewNode): React.ReactElement;
+//# sourceMappingURL=render-to-ink.d.ts.map

package/dist/render-to-ink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-to-ink.d.ts","sourceRoot":"","sources":["../src/render-to-ink.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAkB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AA4KhE,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAE9D"}