@cleocode/animations 2026.5.106 → 2026.5.108

package/dist/src/render/table.js

@@ -0,0 +1,176 @@
+/**
+ * Static table rendering — column-aligned rows with terminal-width awareness.
+ *
+ * @remarks
+ * Part of the Human Render Contract (Epic T10114, ADR-077). Consumes a typed
+ * {@link TableResponse} (schema + rows + total) and emits an aligned monospace
+ * table that fits within the active terminal width. Wide string columns shrink
+ * proportionally when the total width exceeds the budget; narrow numeric
+ * columns are preserved.
+ *
+ * @epic T10114
+ * @task T10128
+ * @subtask T10143
+ */
+/** Unicode horizontal rule used between header and data. */
+const HRULE_UNICODE = '─';
+/** ASCII fallback horizontal rule. */
+const HRULE_ASCII = '-';
+/** Unicode ellipsis used for truncated cell values. */
+const ELLIPSIS_UNICODE = '…';
+/** ASCII fallback ellipsis. */
+const ELLIPSIS_ASCII = '...';
+/** Two-space column separator. */
+const COLUMN_GAP = '  ';
+/** Minimum width retained for any string column after proportional shrink. */
+const MIN_COLUMN_WIDTH = 4;
+/**
+ * Render a {@link TableResponse} as an aligned columnar string.
+ *
+ * @param resp - Typed table response (schema + rows + total).
+ * @param opts - Render gate + width / ASCII overrides.
+ * @returns Multi-line aligned table. Empty when `opts.ctx.enabled` is `false`.
+ *
+ * @example
+ * ```ts
+ * renderTable(
+ *   {
+ *     rows: [{ id: 'T1', title: 'Implement', status: 'done' }],
+ *     schema: {
+ *       columns: [
+ *         { key: 'id', header: 'ID' },
+ *         { key: 'title', header: 'Title' },
+ *         { key: 'status', header: 'Status' },
+ *       ],
+ *     },
+ *     total: 1,
+ *   },
+ *   { ctx },
+ * );
+ * ```
+ */
+export function renderTable(resp, opts) {
+    if (!opts.ctx.enabled)
+        return '';
+    const useAscii = opts.asciiBoxDrawing ?? opts.ctx.inputs.noColor;
+    const hrule = useAscii ? HRULE_ASCII : HRULE_UNICODE;
+    const ellipsis = useAscii ? ELLIPSIS_ASCII : ELLIPSIS_UNICODE;
+    const columns = resp.schema.columns;
+    if (columns.length === 0) {
+        return `(${resp.total} rows)`;
+    }
+    const formatted = resp.rows.map((row) => columns.map((col) => formatCell(row, col)));
+    // 1. Natural widths — max(header, every-cell).
+    const naturalWidths = columns.map((col, idx) => {
+        let max = col.header.length;
+        for (const fmtRow of formatted) {
+            const cell = fmtRow[idx] ?? '';
+            if (cell.length > max)
+                max = cell.length;
+        }
+        if (typeof col.width === 'number' && col.width > 0) {
+            return Math.min(max, col.width);
+        }
+        return max;
+    });
+    // 2. Apply max-width shrink if needed (string columns only).
+    const maxWidth = opts.maxWidth ?? process.stdout.columns ?? 80;
+    const finalWidths = applyMaxWidth(naturalWidths, columns, maxWidth);
+    // 3. Render header.
+    const headerRow = renderRow(columns.map((col) => col.header), columns, finalWidths, ellipsis);
+    // 4. Render separator.
+    const separatorRow = finalWidths.map((w) => hrule.repeat(w)).join(COLUMN_GAP);
+    // 5. Render data rows.
+    const dataRows = formatted.map((row) => renderRow(row, columns, finalWidths, ellipsis));
+    // 6. Footer.
+    const footer = `(${resp.total} ${resp.total === 1 ? 'row' : 'rows'})`;
+    return [headerRow, separatorRow, ...dataRows, footer].join('\n');
+}
+/** Extract the cell value for `column` from `row` and run it through `format`. */
+function formatCell(row, column) {
+    const raw = row[column.key];
+    if (column.format !== undefined)
+        return column.format(raw);
+    if (raw === null || raw === undefined)
+        return '';
+    return String(raw);
+}
+/**
+ * Compute the final per-column widths.
+ *
+ * @remarks
+ * The total width budget is `maxWidth - (columns.length - 1) * COLUMN_GAP`.
+ * If the naturally-required widths fit, return them unchanged. Otherwise
+ * shrink columns whose `align` is unset or `'left'` (treated as string
+ * columns) proportionally to their natural width. Numeric / right-aligned /
+ * center-aligned columns and any column with an explicit `width` are not
+ * shrunk.
+ */
+function applyMaxWidth(naturalWidths, columns, maxWidth) {
+    const totalGap = (columns.length - 1) * COLUMN_GAP.length;
+    const budget = Math.max(MIN_COLUMN_WIDTH * columns.length, maxWidth - totalGap);
+    const natural = naturalWidths.reduce((a, b) => a + b, 0);
+    if (natural <= budget)
+        return [...naturalWidths];
+    const isShrinkable = columns.map((col) => (col.align === undefined || col.align === 'left') && col.width === undefined);
+    const fixedSum = naturalWidths.reduce((sum, w, idx) => sum + (isShrinkable[idx] ? 0 : w), 0);
+    const shrinkableSum = naturalWidths.reduce((sum, w, idx) => sum + (isShrinkable[idx] ? w : 0), 0);
+    const shrinkBudget = Math.max(0, budget - fixedSum);
+    if (shrinkableSum === 0 || shrinkBudget === 0)
+        return [...naturalWidths];
+    return naturalWidths.map((w, idx) => {
+        if (!isShrinkable[idx])
+            return w;
+        const scaled = Math.floor((w * shrinkBudget) / shrinkableSum);
+        return Math.max(MIN_COLUMN_WIDTH, scaled);
+    });
+}
+/** Render one aligned row joined by {@link COLUMN_GAP}. */
+function renderRow(cells, columns, widths, ellipsis) {
+    // The trailing column is rendered without padding — there is no neighbour
+    // to align to, and pad-right whitespace makes snapshot diffs noisy.
+    const lastIdx = cells.length - 1;
+    return cells
+        .map((cell, idx) => {
+        const width = widths[idx] ?? cell.length;
+        const align = columns[idx]?.align ?? 'left';
+        const truncated = truncate(cell, width, ellipsis);
+        if (idx === lastIdx && align === 'left')
+            return truncated;
+        return alignCell(truncated, width, align);
+    })
+        .join(COLUMN_GAP);
+}
+/**
+ * Truncate `text` to `width` characters by replacing the tail with `ellipsis`.
+ *
+ * @remarks
+ * No-op when `text.length <= width`. When `width <= ellipsis.length`, returns
+ * the leading slice of `text` without an ellipsis to avoid producing output
+ * wider than the budget.
+ */
+function truncate(text, width, ellipsis) {
+    if (text.length <= width)
+        return text;
+    if (width <= ellipsis.length)
+        return text.slice(0, width);
+    return text.slice(0, width - ellipsis.length) + ellipsis;
+}
+/** Pad `text` to `width` characters according to `align`. */
+function alignCell(text, width, align) {
+    if (text.length >= width)
+        return text;
+    const padding = width - text.length;
+    switch (align) {
+        case 'right':
+            return ' '.repeat(padding) + text;
+        case 'center': {
+            const left = Math.floor(padding / 2);
+            const right = padding - left;
+            return ' '.repeat(left) + text + ' '.repeat(right);
+        }
+        default:
+            return text + ' '.repeat(padding);
+    }
+}
+//# sourceMappingURL=table.js.map

package/dist/src/render/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/render/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsBH,4DAA4D;AAC5D,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,sCAAsC;AACtC,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,uDAAuD;AACvD,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,+BAA+B;AAC/B,MAAM,cAAc,GAAG,KAAK,CAAC;AAE7B,kCAAkC;AAClC,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,8EAA8E;AAC9E,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,WAAW,CAAI,IAAsB,EAAE,IAAwB;IAC7E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;IACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;IACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAE9D,MAAM,OAAO,GAAkC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,IAAI,CAAC,KAAK,QAAQ,CAAC;IAChC,CAAC;IAED,MAAM,SAAS,GAAe,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAM,EAAY,EAAE,CAC/D,OAAO,CAAC,GAAG,CAAC,CAAC,GAAmB,EAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CACnE,CAAC;IAEF,+CAA+C;IAC/C,MAAM,aAAa,GAAa,OAAO,CAAC,GAAG,CAAC,CAAC,GAAmB,EAAE,GAAW,EAAU,EAAE;QACvF,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;QAC5B,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;gBAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3C,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAG,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEpE,oBAAoB;IACpB,MAAM,SAAS,GAAG,SAAS,CACzB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAmB,EAAU,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EACxD,OAAO,EACP,WAAW,EACX,QAAQ,CACT,CAAC;IAEF,uBAAuB;IACvB,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE9E,uBAAuB;IACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAExF,aAAa;IACb,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;IAEtE,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,kFAAkF;AAClF,SAAS,UAAU,CAAI,GAAM,EAAE,MAAsB;IACnD,MAAM,GAAG,GAAI,GAA+B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CACpB,aAAuB,EACvB,OAAsC,EACtC,QAAgB;IAEhB,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;IAEjD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAC9B,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,CACtF,CAAC;IACF,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7F,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAElG,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACpD,IAAI,aAAa,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;IAEzE,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,aAAa,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2DAA2D;AAC3D,SAAS,SAAS,CAChB,KAA4B,EAC5B,OAAsC,EACtC,MAA6B,EAC7B,QAAgB;IAEhB,0EAA0E;IAC1E,oEAAoE;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;QACzC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI,MAAM,CAAC;QAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,GAAG,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,SAAS,CAAC;QAC1D,OAAO,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC;SACD,IAAI,CAAC,UAAU,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa,EAAE,QAAgB;IAC7D,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;AAC3D,CAAC;AAED,6DAA6D;AAC7D,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,KAAkB;IAChE,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QACpC,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;YAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QACD;YACE,OAAO,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/src/render/tree.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Static tree rendering — box-drawing hierarchy with depth, fold, and icons.
+ *
+ * @remarks
+ * Part of the Human Render Contract (Epic T10114, ADR-077). Consumes a
+ * {@link TreeResponse} (flat, pre-order list of {@link FlatTreeNode}s) and
+ * emits a box-drawing tree that mirrors the canonical Saga → Epic → Task →
+ * Subtask layout.
+ *
+ * Connector glyphs:
+ * - `├─` non-last child
+ * - `└─` last child
+ * - `│ ` vertical continuation across a non-last ancestor
+ * - `   ` last-sibling ancestor (no vertical bar)
+ *
+ * Each rendered row carries the matching {@link KindIcon} prefix and a
+ * trailing {@link StatusIcon}. When the {@link AnimateContext} indicates
+ * `noColor` mode (or `opts.asciiBoxDrawing === true`) glyphs collapse to
+ * ASCII fallbacks (`+-`, `| `, `   `) and icons resolve via {@link ascii}.
+ *
+ * @epic T10114
+ * @task T10128
+ * @subtask T10142
+ */
+import type { TreeResponse } from '@cleocode/contracts/render/tree.js';
+import type { AnimateContext } from '../animate-context.js';
+/** Options for {@link renderTree}. */
+export interface RenderTreeViewOptions {
+    /** Render gate — primitive returns `''` when `enabled === false`. */
+    readonly ctx: AnimateContext;
+    /**
+     * When a node has more direct children than this threshold, only the first
+     * `foldAt - 1` are rendered and a `…` summary line replaces the rest.
+     *
+     * @defaultValue `50`
+     */
+    readonly foldAt?: number;
+    /**
+     * When `true`, force ASCII box-drawing glyphs regardless of the context's
+     * `noColor` signal. When `false`, force Unicode. When omitted, defer to
+     * `ctx.inputs.noColor`.
+     */
+    readonly asciiBoxDrawing?: boolean;
+}
+/**
+ * Render a {@link TreeResponse} as a multi-line box-drawing tree.
+ *
+ * @param resp - The flattened tree response to render.
+ * @param opts - Render gate + fold + ASCII overrides.
+ * @returns The formatted tree. Empty when `opts.ctx.enabled` is `false`.
+ *
+ * @example
+ * ```ts
+ * renderTree(saga, { ctx });
+ * // 🌲 SG-WORKTRUNK-OWN ✅
+ * // ├─ 📋 T9977 Worktree native ownership ✅
+ * // │  ├─ • T9983 Reader cache 🚧
+ * // │  └─ • T9984 NAPI shim ✅
+ * // └─ 📋 T9981 Doctor budget ⏳
+ * ```
+ */
+export declare function renderTree<T>(resp: TreeResponse<T>, opts: RenderTreeViewOptions): string;
+//# sourceMappingURL=tree.d.ts.map

package/dist/src/render/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/render/tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAIV,YAAY,EACb,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAwCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAiCxF"}

package/dist/src/render/tree.js

@@ -0,0 +1,164 @@
+/**
+ * Static tree rendering — box-drawing hierarchy with depth, fold, and icons.
+ *
+ * @remarks
+ * Part of the Human Render Contract (Epic T10114, ADR-077). Consumes a
+ * {@link TreeResponse} (flat, pre-order list of {@link FlatTreeNode}s) and
+ * emits a box-drawing tree that mirrors the canonical Saga → Epic → Task →
+ * Subtask layout.
+ *
+ * Connector glyphs:
+ * - `├─` non-last child
+ * - `└─` last child
+ * - `│ ` vertical continuation across a non-last ancestor
+ * - `   ` last-sibling ancestor (no vertical bar)
+ *
+ * Each rendered row carries the matching {@link KindIcon} prefix and a
+ * trailing {@link StatusIcon}. When the {@link AnimateContext} indicates
+ * `noColor` mode (or `opts.asciiBoxDrawing === true`) glyphs collapse to
+ * ASCII fallbacks (`+-`, `| `, `   `) and icons resolve via {@link ascii}.
+ *
+ * @epic T10114
+ * @task T10128
+ * @subtask T10142
+ */
+import { ascii, KindIcon, StatusIcon } from '@cleocode/contracts/render/icon.js';
+/** Default fold threshold — match ADR-077 §3 guidance. */
+const DEFAULT_FOLD_AT = 50;
+/** Unicode connector glyphs. */
+const CONNECTOR_UNICODE = Object.freeze({
+    branch: '├─ ',
+    leaf: '└─ ',
+    vertical: '│  ',
+    blank: '   ',
+});
+/** ASCII fallback connector glyphs. */
+const CONNECTOR_ASCII = Object.freeze({
+    branch: '+- ',
+    leaf: '+- ',
+    vertical: '|  ',
+    blank: '   ',
+});
+/** Pretty kind label appended to the fold summary line. */
+const KIND_LABEL = {
+    saga: 'sagas',
+    epic: 'epics',
+    task: 'tasks',
+    subtask: 'subtasks',
+};
+/**
+ * Render a {@link TreeResponse} as a multi-line box-drawing tree.
+ *
+ * @param resp - The flattened tree response to render.
+ * @param opts - Render gate + fold + ASCII overrides.
+ * @returns The formatted tree. Empty when `opts.ctx.enabled` is `false`.
+ *
+ * @example
+ * ```ts
+ * renderTree(saga, { ctx });
+ * // 🌲 SG-WORKTRUNK-OWN ✅
+ * // ├─ 📋 T9977 Worktree native ownership ✅
+ * // │  ├─ • T9983 Reader cache 🚧
+ * // │  └─ • T9984 NAPI shim ✅
+ * // └─ 📋 T9981 Doctor budget ⏳
+ * ```
+ */
+export function renderTree(resp, opts) {
+    if (!opts.ctx.enabled)
+        return '';
+    if (resp.tree.length === 0)
+        return '';
+    const useAscii = opts.asciiBoxDrawing ?? opts.ctx.inputs.noColor;
+    const connectors = useAscii ? CONNECTOR_ASCII : CONNECTOR_UNICODE;
+    const foldAt = opts.foldAt ?? DEFAULT_FOLD_AT;
+    // Build the parent → ordered-children map from the pre-order flat list.
+    // Preserves the input order — callers control sibling order via the wire
+    // payload, this primitive must not re-sort.
+    const childrenByParent = new Map();
+    let rootNode;
+    for (const node of resp.tree) {
+        if (node.parentId === null) {
+            if (node.id === resp.root)
+                rootNode = node;
+            continue;
+        }
+        const bucket = childrenByParent.get(node.parentId);
+        if (bucket)
+            bucket.push(node);
+        else
+            childrenByParent.set(node.parentId, [node]);
+    }
+    if (rootNode === undefined)
+        return '';
+    const lines = [];
+    // Root line — no connector prefix.
+    lines.push(formatRow(rootNode, '', useAscii));
+    emitChildren(rootNode.id, [], childrenByParent, connectors, foldAt, useAscii, lines);
+    return lines.join('\n');
+}
+/**
+ * Recursively emit children of `parentId` with the correct ancestor prefix.
+ *
+ * @param ancestorIsLast - For each ancestor, whether it was the last sibling
+ *   in its parent's child list. Drives the `│ ` vs `   ` continuation glyph.
+ * @param connectors - Resolved connector set (Unicode or ASCII).
+ */
+function emitChildren(parentId, ancestorIsLast, childrenByParent, connectors, foldAt, useAscii, out) {
+    const children = childrenByParent.get(parentId);
+    if (children === undefined || children.length === 0)
+        return;
+    const ancestorPrefix = ancestorIsLast
+        .map((isLast) => (isLast ? connectors.blank : connectors.vertical))
+        .join('');
+    const shouldFold = children.length > foldAt;
+    const visibleCount = shouldFold ? foldAt - 1 : children.length;
+    const visible = children.slice(0, visibleCount);
+    for (let i = 0; i < visible.length; i++) {
+        const child = visible[i];
+        if (child === undefined)
+            continue;
+        const isLastInBatch = !shouldFold && i === children.length - 1;
+        const connector = isLastInBatch ? connectors.leaf : connectors.branch;
+        out.push(formatRow(child, `${ancestorPrefix}${connector}`, useAscii));
+        emitChildren(child.id, [...ancestorIsLast, isLastInBatch], childrenByParent, connectors, foldAt, useAscii, out);
+    }
+    if (shouldFold) {
+        const hidden = children.length - visibleCount;
+        const sampleKind = children[0]?.kind ?? 'task';
+        const label = KIND_LABEL[sampleKind];
+        out.push(`${ancestorPrefix}${connectors.leaf}… and ${hidden} more ${label} (run cleo tree ${parentId} to expand)`);
+    }
+}
+/** Build a single tree row: `<connectors><kind icon> <title> <status icon>`. */
+function formatRow(node, prefix, useAscii) {
+    const kindIcon = resolveKindIcon(node.kind, useAscii);
+    const statusIcon = resolveStatusIcon(node.status, useAscii);
+    return `${prefix}${kindIcon} ${node.title} ${statusIcon}`.trimEnd();
+}
+/** Pick the {@link KindIcon} for a node kind, falling back to ASCII when asked. */
+function resolveKindIcon(kind, useAscii) {
+    const icon = KIND_BY_NODE_KIND[kind];
+    return useAscii ? ascii(icon) : icon;
+}
+/** Pick the {@link StatusIcon} for a node status, falling back to ASCII. */
+function resolveStatusIcon(status, useAscii) {
+    const icon = STATUS_BY_NODE_STATUS[status];
+    return useAscii ? ascii(icon) : icon;
+}
+/** Node-kind → KindIcon. Subtask uses bullet-like glyph per ADR-077. */
+const KIND_BY_NODE_KIND = {
+    saga: KindIcon.SAGA,
+    epic: KindIcon.EPIC,
+    task: KindIcon.TASK,
+    subtask: KindIcon.SUBTASK,
+};
+/** Node-status → StatusIcon. */
+const STATUS_BY_NODE_STATUS = {
+    pending: StatusIcon.PENDING,
+    in_progress: StatusIcon.ACTIVE,
+    done: StatusIcon.DONE,
+    blocked: StatusIcon.BLOCKED,
+    cancelled: StatusIcon.CANCELLED,
+    archived: StatusIcon.ARCHIVED,
+};
+//# sourceMappingURL=tree.js.map

package/dist/src/render/tree.js.map

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