@opensip-cli/cli-ui 0.1.0

package/dist/spinner.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Spinner — animated progress indicator. Renders one braille frame per tick
+ * plus an optional `completed/total (pct%)` suffix.
+ *
+ * Two modes:
+ *  - Inside a `<ClockProvider>`: consumes the provider's tick via
+ *    `useClock()`. Multiple spinners share the same timer.
+ *  - Outside a provider (default): owns its own interval via `useTick()`.
+ *    Convenient for single-spinner screens where setting up a provider
+ *    is unnecessary.
+ */
+import { Text } from 'ink';
+import { useClock, useTick } from './clock.js';
+import { useTheme } from './theme.js';
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/** Spinner frame keyed off the surrounding `<ClockProvider>`. */
+export function useSpinner() {
+    const tick = useClock();
+    return SPINNER_FRAMES[tick % SPINNER_FRAMES.length] ?? '';
+}
+/** Spinner frame from a self-owned interval — provider-free. */
+export function useStandaloneSpinner(intervalMs) {
+    const tick = useTick(intervalMs);
+    return SPINNER_FRAMES[tick % SPINNER_FRAMES.length] ?? '';
+}
+export function Spinner({ total, completed, label = 'Running...', standalone = false, }) {
+    return standalone ? (_jsx(SpinnerStandalone, { total: total, completed: completed, label: label })) : (_jsx(SpinnerCtx, { total: total, completed: completed, label: label }));
+}
+function SpinnerCtx({ total, completed, label, }) {
+    const theme = useTheme();
+    const frame = useSpinner();
+    return (_jsx(SpinnerLine, { frame: frame, brand: theme.brand, total: total, completed: completed, label: label }));
+}
+function SpinnerStandalone({ total, completed, label, }) {
+    const theme = useTheme();
+    const frame = useStandaloneSpinner();
+    return (_jsx(SpinnerLine, { frame: frame, brand: theme.brand, total: total, completed: completed, label: label }));
+}
+function SpinnerLine({ frame, brand, total, completed, label, }) {
+    const pct = total > 0 ? Math.round((completed / total) * 100) : 0;
+    return (_jsxs(Text, { children: [_jsx(Text, { color: brand, children: frame }), " ", label, total > 0 ? (_jsxs(Text, { children: [' ', completed, "/", total, " (", pct, "%)"] })) : null] }));
+}
+//# sourceMappingURL=spinner.js.map

package/dist/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../src/spinner.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1E,iEAAiE;AACjE,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,OAAO,cAAc,CAAC,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,cAAc,CAAC,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC;AAcD,MAAM,UAAU,OAAO,CAAC,EACtB,KAAK,EACL,SAAS,EACT,KAAK,GAAG,YAAY,EACpB,UAAU,GAAG,KAAK,GACL;IACb,OAAO,UAAU,CAAC,CAAC,CAAC,CAClB,KAAC,iBAAiB,IAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAI,CACxE,CAAC,CAAC,CAAC,CACF,KAAC,UAAU,IAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAI,CACjE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,EAClB,KAAK,EACL,SAAS,EACT,KAAK,GAKN;IACC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,OAAO,CACL,KAAC,WAAW,IACV,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,EACzB,KAAK,EACL,SAAS,EACT,KAAK,GAKN;IACC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC;IACrC,OAAO,CACL,KAAC,WAAW,IACV,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,EACnB,KAAK,EACL,KAAK,EACL,KAAK,EACL,SAAS,EACT,KAAK,GAON;IACC,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,CACL,MAAC,IAAI,eACH,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,YAAG,KAAK,GAAQ,OAAE,KAAK,EACxC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CACX,MAAC,IAAI,eACF,GAAG,EACH,SAAS,OAAG,KAAK,QAAI,GAAG,UACpB,CACR,CAAC,CAAC,CAAC,IAAI,IACH,CACR,CAAC;AACJ,CAAC"}

package/dist/theme.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Theme system for Ink UI components.
+ *
+ * Provides color tokens, terminal capability detection, and a React context
+ * so every component can access the theme via useTheme().
+ */
+import React from 'react';
+export interface Theme {
+    /** OpenSIP brand color — warm amber */
+    readonly brand: string;
+    readonly success: string;
+    readonly error: string;
+    readonly warning: string;
+    readonly info: string;
+    readonly muted: string;
+    /** Score color thresholds */
+    readonly scoreHigh: string;
+    readonly scoreMid: string;
+    readonly scoreLow: string;
+    /** Check status colors */
+    readonly statusPass: string;
+    readonly statusFail: string;
+    readonly statusTimeout: string;
+    /** Whether color output is enabled */
+    readonly colorsEnabled: boolean;
+}
+export declare const DEFAULT_THEME: Theme;
+export interface TerminalCapabilities {
+    readonly isTTY: boolean;
+    readonly supportsColor: boolean;
+    readonly supports256Color: boolean;
+    readonly supportsTrueColor: boolean;
+}
+export declare function detectTerminalCapabilities(): TerminalCapabilities;
+export declare const ThemeContext: React.Context<Theme>;
+export interface ThemeProviderProps {
+    readonly theme?: Theme;
+    readonly children: React.ReactNode;
+}
+export declare function ThemeProvider({ theme, children }: ThemeProviderProps): React.ReactElement;
+export declare function useTheme(): Theme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,MAAM,WAAW,KAAK;IACpB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,sCAAsC;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAMD,eAAO,MAAM,aAAa,EAAE,KAiB3B,CAAC;AA4BF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAED,wBAAgB,0BAA0B,IAAI,oBAAoB,CAgCjE;AAMD,eAAO,MAAM,YAAY,sBAA4C,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAezF;AAED,wBAAgB,QAAQ,IAAI,KAAK,CAEhC"}

package/dist/theme.js

@@ -0,0 +1,96 @@
+/**
+ * Theme system for Ink UI components.
+ *
+ * Provides color tokens, terminal capability detection, and a React context
+ * so every component can access the theme via useTheme().
+ */
+import React from 'react';
+// ---------------------------------------------------------------------------
+// Default theme
+// ---------------------------------------------------------------------------
+export const DEFAULT_THEME = {
+    brand: '#C8956C',
+    success: 'green',
+    error: 'red',
+    warning: 'yellow',
+    info: 'cyan',
+    muted: 'gray',
+    scoreHigh: 'green',
+    scoreMid: 'yellow',
+    scoreLow: 'red',
+    statusPass: 'green',
+    statusFail: 'red',
+    statusTimeout: 'yellow',
+    colorsEnabled: true,
+};
+// In a no-color theme, all color tokens are zeroed out: Ink does not read
+// `colorsEnabled` itself, so handing it any non-empty color string (`'red'`,
+// `'#C8956C'`) would still emit ANSI escapes even with `NO_COLOR=1`. Empty
+// strings cause Ink's `<Text color={...}>` to no-op, honoring the NO_COLOR
+// convention without forcing every component to guard `theme.colorsEnabled`
+// at every call site.
+const NO_COLOR_THEME = {
+    brand: '',
+    success: '',
+    error: '',
+    warning: '',
+    info: '',
+    muted: '',
+    scoreHigh: '',
+    scoreMid: '',
+    scoreLow: '',
+    statusPass: '',
+    statusFail: '',
+    statusTimeout: '',
+    colorsEnabled: false,
+};
+export function detectTerminalCapabilities() {
+    const isTTY = !!process.stdout.isTTY;
+    const noColor = !!process.env.NO_COLOR;
+    const colorTerm = process.env.COLORTERM ?? '';
+    const termProgram = process.env.TERM_PROGRAM ?? '';
+    const term = process.env.TERM ?? '';
+    if (noColor) {
+        return { isTTY, supportsColor: false, supports256Color: false, supportsTrueColor: false };
+    }
+    const envSuggestsTrueColor = colorTerm === 'truecolor' ||
+        colorTerm === '24bit' ||
+        termProgram === 'iTerm.app' ||
+        termProgram === 'WezTerm' ||
+        termProgram === 'Hyper';
+    const envSuggests256Color = envSuggestsTrueColor || term.includes('256color') || termProgram === 'Apple_Terminal';
+    // All capability flags MUST be gated on `isTTY`. When stdout is piped to a
+    // file or CI log, ANSI truecolor escapes still leak in if callers inspect
+    // `supports256Color` / `supportsTrueColor` to decide whether to emit hex
+    // color values — even though `supportsColor` itself is correctly false.
+    // Treating capability as a single coherent gate (`isTTY && env signal`)
+    // prevents the exported surface from contradicting itself.
+    const supportsTrueColor = isTTY && envSuggestsTrueColor;
+    const supports256Color = isTTY && envSuggests256Color;
+    const supportsColor = isTTY && (envSuggests256Color || term !== 'dumb');
+    return { isTTY, supportsColor, supports256Color, supportsTrueColor };
+}
+// ---------------------------------------------------------------------------
+// React context + provider + hook
+// ---------------------------------------------------------------------------
+export const ThemeContext = React.createContext(DEFAULT_THEME);
+export function ThemeProvider({ theme, children }) {
+    // Memoize the resolved theme so the context value reference is stable
+    // across re-renders. Ink's ClockProvider tick re-renders ThemeProvider
+    // on every frame; without useMemo, every render would re-read
+    // process.env, allocate a new `resolved` object, and force every
+    // `useTheme()` subscriber (Banner, Spinner, RunHeader, …) to re-render
+    // unnecessarily. Capability detection reads stable process state, so
+    // recomputing only when `theme` changes is correct.
+    const resolved = React.useMemo(() => {
+        if (theme)
+            return theme;
+        const caps = detectTerminalCapabilities();
+        return caps.supportsColor ? DEFAULT_THEME : NO_COLOR_THEME;
+    }, [theme]);
+    return React.createElement(ThemeContext.Provider, { value: resolved }, children);
+}
+export function useTheme() {
+    return React.useContext(ThemeContext);
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

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

package/dist/verbose-detail.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared verbose-detail view producers (ADR-0021).
+ *
+ * `--verbose` is an output-currency concern: a tool's verbose detail body is
+ * carried as data on its `*DoneResult` and rendered ONCE through these
+ * producers, so the detail is identical in a TTY (`renderToInk`) and a pipe
+ * (`renderToText`). They replace the three hand-copied "Use --verbose…" hints
+ * and the fitness-local `FindingsBlock` Ink component.
+ *
+ * cli-ui must never import `@opensip-cli/contracts` (keystone boundary), so
+ * these take plain structural inputs ({@link FindingGroupView}) — the cli
+ * `resultToView` seam passes the contracts `FindingGroup` *values* straight in
+ * (the shapes are structurally identical; a type-compat test pins that).
+ *
+ * Pure data + types: no `ink`/`react` imports (same rule as view-model.ts).
+ */
+import { type HintItem, type ViewNode } from './view-model.js';
+/** One displayed finding (structural twin of contracts' `FindingLine`). */
+export interface FindingLineView {
+    readonly severity: 'error' | 'warning';
+    readonly message: string;
+    readonly location?: string;
+    readonly suggestion?: string;
+}
+/** A verbose findings block (structural twin of contracts' `FindingGroup`). */
+export interface FindingGroupView {
+    readonly title: string;
+    readonly error?: string;
+    readonly errorCount: number;
+    readonly warningCount: number;
+    readonly findings: readonly FindingLineView[];
+}
+/** The single canonical "Use --verbose…" hint item. Tools that compose their
+ *  own footer (e.g. graph, which also shows a report hint) reuse THIS item so
+ *  the string is never re-typed. */
+export declare const VERBOSE_DETAIL_HINT: HintItem;
+/** The canonical next-step hint shown when a run was NOT verbose. */
+export declare function viewVerboseHint(): ViewNode;
+/** Render a line-oriented verbose body verbatim (graph's catalog/findings dump). */
+export declare function viewVerboseLines(lines: readonly string[]): ViewNode;
+/** Render a verbose findings body — header + one block per group. */
+export declare function viewFindingsGroups(groups: readonly FindingGroupView[]): ViewNode;
+//# sourceMappingURL=verbose-detail.d.ts.map

package/dist/verbose-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-detail.d.ts","sourceRoot":"","sources":["../src/verbose-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAe,KAAK,QAAQ,EAAa,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAKvF,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED;;oCAEoC;AACpC,eAAO,MAAM,mBAAmB,EAAE,QAGjC,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAEnE;AAkED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,QAAQ,CAchF"}

package/dist/verbose-detail.js

@@ -0,0 +1,104 @@
+/**
+ * Shared verbose-detail view producers (ADR-0021).
+ *
+ * `--verbose` is an output-currency concern: a tool's verbose detail body is
+ * carried as data on its `*DoneResult` and rendered ONCE through these
+ * producers, so the detail is identical in a TTY (`renderToInk`) and a pipe
+ * (`renderToText`). They replace the three hand-copied "Use --verbose…" hints
+ * and the fitness-local `FindingsBlock` Ink component.
+ *
+ * cli-ui must never import `@opensip-cli/contracts` (keystone boundary), so
+ * these take plain structural inputs ({@link FindingGroupView}) — the cli
+ * `resultToView` seam passes the contracts `FindingGroup` *values* straight in
+ * (the shapes are structurally identical; a type-compat test pins that).
+ *
+ * Pure data + types: no `ink`/`react` imports (same rule as view-model.ts).
+ */
+import { viewFooterHints } from './run-footer-hints.js';
+import { group, line } from './view-model.js';
+/** Per-check cap on rendered findings — mirrors the prior FindingsBlock limit. */
+const DEFAULT_VIOLATIONS_PER_GROUP = 25;
+/** The single canonical "Use --verbose…" hint item. Tools that compose their
+ *  own footer (e.g. graph, which also shows a report hint) reuse THIS item so
+ *  the string is never re-typed. */
+export const VERBOSE_DETAIL_HINT = {
+    text: 'Use --verbose for detailed results',
+    bold: ['--verbose'],
+};
+/** The canonical next-step hint shown when a run was NOT verbose. */
+export function viewVerboseHint() {
+    return viewFooterHints([VERBOSE_DETAIL_HINT]);
+}
+/** Render a line-oriented verbose body verbatim (graph's catalog/findings dump). */
+export function viewVerboseLines(lines) {
+    return group(lines.map((l) => line([{ text: l }])));
+}
+/** Render one finding row: `      error  <message> <location>` + optional suggestion. */
+function findingNode(f) {
+    const spans = [
+        { text: '      ' },
+        {
+            text: f.severity === 'error' ? 'error' : 'warn',
+            tone: f.severity === 'error' ? 'error' : 'warning',
+        },
+        { text: '  ' },
+        { text: f.message },
+    ];
+    if (f.location !== undefined && f.location !== '') {
+        spans.push({ text: ' ' }, { text: f.location, dim: true });
+    }
+    const rows = [line(spans)];
+    if (f.suggestion !== undefined && f.suggestion !== '') {
+        rows.push(line([{ text: '            ' }, { text: f.suggestion, dim: true }]));
+    }
+    return group(rows);
+}
+/** Render one findings group: a check title + count, an optional error line, the
+ *  capped findings, and a "+N more" line when truncated. */
+function groupNode(g) {
+    const count = g.errorCount + g.warningCount + (g.error === undefined ? 0 : 1);
+    const visible = g.findings.slice(0, DEFAULT_VIOLATIONS_PER_GROUP);
+    const hidden = Math.max(0, g.findings.length - visible.length);
+    const children = [
+        line([
+            { text: g.title, tone: 'brand' },
+            { text: ` (${String(count)})`, dim: true },
+        ]),
+    ];
+    if (g.error !== undefined) {
+        children.push(line([
+            { text: '      ' },
+            { text: 'error', tone: 'error' },
+            { text: '  ' },
+            { text: g.error },
+        ]));
+    }
+    for (const f of visible)
+        children.push(findingNode(f));
+    if (hidden > 0) {
+        children.push(line([
+            { text: '      … ' },
+            { text: `${String(hidden)} more hidden (use ` },
+            { text: '--json', bold: true },
+            { text: ' or ' },
+            { text: 'opensip report', bold: true },
+            { text: ' for all)' },
+        ], true));
+    }
+    children.push({ kind: 'spacer' });
+    return group(children, 2);
+}
+/** Render a verbose findings body — header + one block per group. */
+export function viewFindingsGroups(groups) {
+    const total = groups.reduce((sum, g) => sum + g.errorCount + g.warningCount + (g.error === undefined ? 0 : 1), 0);
+    const children = [
+        line([
+            { text: 'Findings', bold: true },
+            { text: ` (${String(total)}):`, dim: true },
+        ]),
+        { kind: 'spacer' },
+        ...groups.map((g) => groupNode(g)),
+    ];
+    return group(children, 2);
+}
+//# sourceMappingURL=verbose-detail.js.map

package/dist/verbose-detail.js.map

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

package/dist/view-model.d.ts

@@ -0,0 +1,132 @@
+/**
+ * View-model — the renderer-agnostic vocabulary that decouples *what* a
+ * command shows from *how* it is rendered.
+ *
+ * A `ViewNode` describes output as a tree of line-oriented blocks. Two
+ * interpreters consume the same tree: `renderToInk` (TTY, themed) and
+ * `renderToText` (pipe/CI, zero ANSI). Because each piece of output is
+ * expressed once as a `ViewNode`, the interactive and non-interactive
+ * forms cannot structurally drift — there is no second definition to fall
+ * out of sync. This generalizes the existing `formatProjectHeader` +
+ * `ProjectHeader` pattern (format once, render twice) to all CLI output.
+ *
+ * Deliberately NOT a general layout engine: there is no flexbox, no
+ * multi-column flow beyond the simple `table` node. Keep it line-oriented;
+ * if a node needs richer layout, that is a signal to reconsider rather
+ * than to grow this vocabulary.
+ *
+ * This module is pure data + types. It must stay free of `ink`/`react`
+ * imports so `renderToText` (and its consumers on the piped path) never
+ * pull React into the process.
+ */
+/**
+ * Semantic color intent. The Ink interpreter maps each tone onto a
+ * `DEFAULT_THEME` token; the text interpreter ignores tones entirely. The
+ * theme remains the single source of color truth — producers never name
+ * raw colors.
+ */
+export type Tone = 'brand' | 'success' | 'error' | 'warning' | 'info' | 'muted' | 'default';
+/** An inline run of text within a line, optionally toned, bold, and/or dimmed. */
+export interface Span {
+    readonly text: string;
+    readonly tone?: Tone;
+    readonly bold?: boolean;
+    /** Render this span muted (Ink `dimColor`). Dropped by the text interpreter. */
+    readonly dim?: boolean;
+}
+/** A single hint in a footer strip: its text and which substrings to bold. */
+export interface HintItem {
+    readonly text: string;
+    readonly bold?: readonly string[];
+}
+/**
+ * Block-level output node. The interpreters switch on `kind`; every kind
+ * is total in both interpreters (no node may render in one and throw in
+ * the other).
+ */
+export type ViewNode = 
+/** One line of styled spans. `dim` renders the whole line muted. */
+{
+    readonly kind: 'line';
+    readonly spans: readonly Span[];
+    readonly dim?: boolean;
+}
+/** A section heading (e.g. `== Findings ==`). */
+ | {
+    readonly kind: 'heading';
+    readonly text: string;
+    readonly tone?: Tone;
+}
+/** A block of `label: value` pairs, one per line. */
+ | {
+    readonly kind: 'keyValues';
+    readonly pairs: readonly {
+        readonly label: string;
+        readonly value: string;
+    }[];
+}
+/**
+ * A column-aligned table. Each row is a list of cell spans — one span per
+ * column (cell N styles column N). Both interpreters pad every cell to its
+ * column's width (the max of the header and all cells in that column), so the
+ * columns line up in a TTY and a pipe alike. `align` is per-column
+ * (`'right'` pads on the left — for numeric/duration columns); default left.
+ */
+ | {
+    readonly kind: 'table';
+    readonly columns: readonly string[];
+    readonly rows: readonly (readonly Span[])[];
+    readonly align?: readonly ('left' | 'right')[];
+    /** When false, suppress the header row (a bare aligned grid). Default true. */
+    readonly showHeader?: boolean;
+}
+/** A next-step hint strip, ` | `-joined, with bolded flag substrings. */
+ | {
+    readonly kind: 'hints';
+    readonly items: readonly HintItem[];
+}
+/** A horizontal rule. */
+ | {
+    readonly kind: 'separator';
+}
+/** A single blank line. */
+ | {
+    readonly kind: 'spacer';
+}
+/** A container; children render in order, optionally indented. */
+ | {
+    readonly kind: 'group';
+    readonly children: readonly ViewNode[];
+    readonly indent?: number;
+};
+/** A line from plain text (single default-toned span). */
+export declare function text(value: string): Span;
+/** A line node from spans (or a single string). */
+export declare function line(spans: readonly Span[] | string, dim?: boolean): ViewNode;
+/** A group node from children, optionally indented. */
+export declare function group(children: readonly ViewNode[], indent?: number): ViewNode;
+/**
+ * Per-column display widths for a `table` node — the max of each column's header
+ * and all its cells. Shared by both interpreters so the TTY and pipe forms pad
+ * identically. Pure (no react), so `render-to-text` can use it too.
+ */
+export declare function tableColumnWidths(columns: readonly string[], rows: readonly (readonly Span[])[]): number[];
+/** Pad `value` to `width`; `'right'` pads on the left (numeric/duration columns). */
+export declare function padTableCell(value: string, width: number, align: 'left' | 'right'): string;
+/** Per-column spec for {@link viewTable}: a header label and optional alignment. */
+export interface TableColumnSpec {
+    readonly header: string;
+    readonly align?: 'left' | 'right';
+}
+/**
+ * Build a column-aligned `table` node. Columns may be plain header strings or
+ * {@link TableColumnSpec}s (to right-align numeric columns). Each row is one
+ * span per column (cell N styles column N); the interpreters pad every cell to
+ * its column width so the grid lines up in a TTY and a pipe. This is the shared,
+ * reusable table primitive — producers (history, session replay, per-unit
+ * results) build one of these instead of hand-padding lines.
+ */
+export declare function viewTable(columns: readonly (string | TableColumnSpec)[], rows: readonly (readonly Span[])[], opts?: {
+    readonly showHeader?: boolean;
+}): ViewNode;
+//# sourceMappingURL=view-model.d.ts.map

package/dist/view-model.d.ts.map

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

package/dist/view-model.js

@@ -0,0 +1,71 @@
+/**
+ * View-model — the renderer-agnostic vocabulary that decouples *what* a
+ * command shows from *how* it is rendered.
+ *
+ * A `ViewNode` describes output as a tree of line-oriented blocks. Two
+ * interpreters consume the same tree: `renderToInk` (TTY, themed) and
+ * `renderToText` (pipe/CI, zero ANSI). Because each piece of output is
+ * expressed once as a `ViewNode`, the interactive and non-interactive
+ * forms cannot structurally drift — there is no second definition to fall
+ * out of sync. This generalizes the existing `formatProjectHeader` +
+ * `ProjectHeader` pattern (format once, render twice) to all CLI output.
+ *
+ * Deliberately NOT a general layout engine: there is no flexbox, no
+ * multi-column flow beyond the simple `table` node. Keep it line-oriented;
+ * if a node needs richer layout, that is a signal to reconsider rather
+ * than to grow this vocabulary.
+ *
+ * This module is pure data + types. It must stay free of `ink`/`react`
+ * imports so `renderToText` (and its consumers on the piped path) never
+ * pull React into the process.
+ */
+// ---------------------------------------------------------------------------
+// Constructor helpers — keep producers terse without hiding the data shape.
+// ---------------------------------------------------------------------------
+/** A line from plain text (single default-toned span). */
+export function text(value) {
+    return { text: value };
+}
+/** A line node from spans (or a single string). */
+export function line(spans, dim) {
+    const resolved = typeof spans === 'string' ? [text(spans)] : spans;
+    return dim === undefined
+        ? { kind: 'line', spans: resolved }
+        : { kind: 'line', spans: resolved, dim };
+}
+/** A group node from children, optionally indented. */
+export function group(children, indent) {
+    return indent === undefined ? { kind: 'group', children } : { kind: 'group', children, indent };
+}
+/**
+ * Per-column display widths for a `table` node — the max of each column's header
+ * and all its cells. Shared by both interpreters so the TTY and pipe forms pad
+ * identically. Pure (no react), so `render-to-text` can use it too.
+ */
+export function tableColumnWidths(columns, rows) {
+    const colCount = Math.max(columns.length, ...rows.map((r) => r.length), 0);
+    return Array.from({ length: colCount }, (_, i) => Math.max(columns[i]?.length ?? 0, ...rows.map((r) => r[i]?.text.length ?? 0), 0));
+}
+/** Pad `value` to `width`; `'right'` pads on the left (numeric/duration columns). */
+export function padTableCell(value, width, align) {
+    return align === 'right' ? value.padStart(width) : value.padEnd(width);
+}
+/**
+ * Build a column-aligned `table` node. Columns may be plain header strings or
+ * {@link TableColumnSpec}s (to right-align numeric columns). Each row is one
+ * span per column (cell N styles column N); the interpreters pad every cell to
+ * its column width so the grid lines up in a TTY and a pipe. This is the shared,
+ * reusable table primitive — producers (history, session replay, per-unit
+ * results) build one of these instead of hand-padding lines.
+ */
+export function viewTable(columns, rows, opts) {
+    const specs = columns.map((c) => (typeof c === 'string' ? { header: c } : c));
+    return {
+        kind: 'table',
+        columns: specs.map((s) => s.header),
+        rows,
+        align: specs.map((s) => s.align ?? 'left'),
+        ...(opts?.showHeader === undefined ? {} : { showHeader: opts.showHeader }),
+    };
+}
+//# sourceMappingURL=view-model.js.map

package/dist/view-model.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@opensip-cli/cli-ui",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Shared Ink/React presentational primitives for OpenSIP CLI CLI tools — banner, spinner, run header, theme. Used by every tool that ships an Ink live view.",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality",
+    "cli",
+    "terminal",
+    "ink",
+    "react"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/cli-ui"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "ink": "^7.0.5",
+    "react": "^19.2.7"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "@types/react": "^19.2.17",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}