@msn-control/liftoff 0.4.0 → 0.4.1

package/dist/terminal.js

@@ -1,40 +1,146 @@
 import picocolors, { createColors } from 'picocolors';
+export const TERMINAL_LAYOUT = {
+    compactColumns: 64,
+    fullColumns: 96,
+    maximumContentColumns: 92,
+    minimumColumns: 20,
+    indent: 2,
+    sectionSpacing: 1
+};
+export const TERMINAL_GLYPHS = {
+    topLeft: '┌',
+    topRight: '┐',
+    bottomLeft: '└',
+    bottomRight: '┘',
+    horizontal: '─',
+    vertical: '│',
+    leftJunction: '├',
+    rightJunction: '┤',
+    bullet: '•',
+    choice: '›',
+    selected: '●',
+    unselected: '○'
+};
 export const LIFTOFF_WORDMARK = [
-    ' _     ___ _____ _____ ___  _____ _____',
-    '| |   |_ _|  ___|_   _/ _ \\|  ___|  ___|',
-    '| |    | || |_    | || | | | |_  | |_',
-    '| |___ | ||  _|   | || |_| |  _| |  _|',
-    '|_____|___|_|     |_| \\___/|_|   |_|'
+    '██╗     ██╗███████╗████████╗ ██████╗ ███████╗███████╗',
+    '██║     ██║██╔════╝╚══██╔══╝██╔═══██╗██╔════╝██╔════╝',
+    '██║     ██║█████╗     ██║   ██║   ██║█████╗  █████╗',
+    '██║     ██║██╔══╝     ██║   ██║   ██║██╔══╝  ██╔══╝',
+    '███████╗██║██║        ██║   ╚██████╔╝██║     ██║',
+    '╚══════╝╚═╝╚═╝        ╚═╝    ╚═════╝ ╚═╝     ╚═╝'
+];
+export const LIFTOFF_COMPACT_WORDMARK = [
+    '╻  ╻┏━╸╺┳╸┏━┓┏━╸┏━╸',
+    '┃  ┃┣╸  ┃ ┃ ┃┣╸ ┣╸',
+    '┗━╸╹╹   ╹ ┗━┛╹  ╹'
 ];
 const ANSI_PATTERN = /\u001B\[[0-?]*[ -/]*[@-~]/g;
+const ANSI_ANY_PATTERN = /\u001B\[[0-?]*[ -/]*[@-~]/;
+const ANSI_AT_START_PATTERN = /^\u001B\[[0-?]*[ -/]*[@-~]/;
+export function stripAnsi(value) {
+    return value.replace(ANSI_PATTERN, '');
+}
+function codePointWidth(character) {
+    const codePoint = character.codePointAt(0);
+    if (codePoint === undefined || codePoint === 0) {
+        return 0;
+    }
+    if (codePoint < 32 ||
+        codePoint >= 0x7f && codePoint < 0xa0 ||
+        codePoint >= 0x300 && codePoint <= 0x36f ||
+        codePoint >= 0x1ab0 && codePoint <= 0x1aff ||
+        codePoint >= 0x1dc0 && codePoint <= 0x1dff ||
+        codePoint >= 0x20d0 && codePoint <= 0x20ff ||
+        codePoint >= 0xfe20 && codePoint <= 0xfe2f ||
+        codePoint >= 0xfe00 && codePoint <= 0xfe0f ||
+        codePoint >= 0x1f3fb && codePoint <= 0x1f3ff) {
+        return 0;
+    }
+    if (codePoint >= 0x1100 && (codePoint <= 0x115f ||
+        codePoint === 0x2329 ||
+        codePoint === 0x232a ||
+        codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f ||
+        codePoint >= 0xac00 && codePoint <= 0xd7a3 ||
+        codePoint >= 0xf900 && codePoint <= 0xfaff ||
+        codePoint >= 0xfe10 && codePoint <= 0xfe19 ||
+        codePoint >= 0xfe30 && codePoint <= 0xfe6f ||
+        codePoint >= 0xff00 && codePoint <= 0xff60 ||
+        codePoint >= 0xffe0 && codePoint <= 0xffe6 ||
+        codePoint >= 0x1f300 && codePoint <= 0x1faff ||
+        codePoint >= 0x20000 && codePoint <= 0x3fffd)) {
+        return 2;
+    }
+    return 1;
+}
 export function visibleLength(value) {
-    return value.replace(ANSI_PATTERN, '').length;
+    return Array.from(stripAnsi(value)).reduce((total, character) => total + (character === '\t' ? 4 : codePointWidth(character)), 0);
 }
-function padVisible(value, width) {
+export function padVisible(value, width) {
     return `${value}${' '.repeat(Math.max(0, width - visibleLength(value)))}`;
 }
-function wrapLine(value, width) {
-    if (value.length <= width) {
+function takeVisible(value, width) {
+    let output = '';
+    let used = 0;
+    for (const character of Array.from(value)) {
+        const characterWidth = codePointWidth(character);
+        if (used + characterWidth > width) {
+            break;
+        }
+        output += character;
+        used += characterWidth;
+    }
+    return output;
+}
+function truncateVisible(value, width) {
+    const plain = stripAnsi(value);
+    if (visibleLength(plain) <= width) {
+        return plain;
+    }
+    if (width <= 1) {
+        return takeVisible(plain, width);
+    }
+    return `${takeVisible(plain, width - 1)}…`;
+}
+function splitLongWord(word, width) {
+    const chunks = [];
+    let remaining = word;
+    while (remaining) {
+        const chunk = takeVisible(remaining, width);
+        if (!chunk) {
+            break;
+        }
+        chunks.push(chunk);
+        remaining = remaining.slice(chunk.length);
+    }
+    return chunks.length > 0 ? chunks : [''];
+}
+function wrapPlainLine(value, width, breakLongWords) {
+    if (visibleLength(value) <= width) {
         return [value];
     }
-    const words = value.split(/\s+/);
+    const words = value.trim().split(/\s+/);
     const lines = [];
     let current = '';
     for (const word of words) {
-        if (word.length > width) {
+        if (visibleLength(word) > width) {
             if (current) {
                 lines.push(current);
                 current = '';
             }
-            for (let index = 0; index < word.length; index += width) {
-                lines.push(word.slice(index, index + width));
+            if (breakLongWords) {
+                const chunks = splitLongWord(word, width);
+                lines.push(...chunks.slice(0, -1));
+                current = chunks.at(-1) ?? '';
+            }
+            else {
+                current = word;
             }
             continue;
         }
         if (!current) {
             current = word;
         }
-        else if (current.length + word.length + 1 <= width) {
+        else if (visibleLength(`${current} ${word}`) <= width) {
             current += ` ${word}`;
         }
         else {
@@ -42,10 +148,68 @@ function wrapLine(value, width) {
             current = word;
         }
     }
-    if (current) {
+    if (current || lines.length === 0) {
         lines.push(current);
     }
-    return lines.length > 0 ? lines : [''];
+    return lines;
+}
+function wrapStyledLine(value, width) {
+    const lines = [];
+    let line = '';
+    let used = 0;
+    let index = 0;
+    while (index < value.length) {
+        const ansi = value.slice(index).match(ANSI_AT_START_PATTERN)?.[0];
+        if (ansi) {
+            line += ansi;
+            index += ansi.length;
+            continue;
+        }
+        const codePoint = value.codePointAt(index);
+        if (codePoint === undefined) {
+            break;
+        }
+        const character = String.fromCodePoint(codePoint);
+        const characterWidth = character === '\t' ? 4 : codePointWidth(character);
+        if (used > 0 && used + characterWidth > width) {
+            lines.push(line.trimEnd());
+            line = '';
+            used = 0;
+            if (/\s/.test(character)) {
+                index += character.length;
+                continue;
+            }
+        }
+        line += character;
+        used += characterWidth;
+        index += character.length;
+    }
+    if (line || lines.length === 0) {
+        lines.push(line.trimEnd());
+    }
+    return lines;
+}
+export function wrapVisible(value, width, breakLongWords = false) {
+    const safeWidth = Math.max(1, width);
+    return value.split(/\r?\n/).flatMap((line) => ANSI_ANY_PATTERN.test(line)
+        ? wrapStyledLine(line, safeWidth)
+        : wrapPlainLine(line, safeWidth, breakLongWords));
+}
+function fitColumnWidths(natural, available) {
+    const widths = natural.map((width) => Math.max(4, width));
+    while (widths.reduce((total, width) => total + width, 0) > available) {
+        let largestIndex = -1;
+        for (let index = 0; index < widths.length; index += 1) {
+            if (widths[index] > 4 && (largestIndex === -1 || widths[index] > widths[largestIndex])) {
+                largestIndex = index;
+            }
+        }
+        if (largestIndex === -1) {
+            break;
+        }
+        widths[largestIndex] -= 1;
+    }
+    return widths;
 }
 export class TerminalRenderer {
     options;
@@ -58,20 +222,20 @@ export class TerminalRenderer {
         this.options = options;
         const stream = options.stream;
         const env = options.env ?? process.env;
-        this.columns = Math.max(20, options.columns ?? stream.columns ?? 80);
+        this.columns = Math.max(TERMINAL_LAYOUT.minimumColumns, options.columns ?? stream.columns ?? 80);
         this.jsonMode = options.json ?? false;
         const tty = stream.isTTY === true;
         const noColor = Object.hasOwn(env, 'NO_COLOR');
         this.colorEnabled = !this.jsonMode && !options.snapshot && !noColor &&
-            (options.color ?? (tty && !noColor && picocolors.isColorSupported));
+            (options.color ?? (tty && picocolors.isColorSupported));
         this.colors = createColors(this.colorEnabled);
-        this.layout = this.jsonMode || (!tty && !options.snapshot)
+        this.layout = options.layout ?? (this.jsonMode || (!tty && !options.snapshot)
             ? 'plain'
-            : this.columns >= 96
+            : this.columns >= TERMINAL_LAYOUT.fullColumns
                 ? 'full'
-                : this.columns >= 64
+                : this.columns >= TERMINAL_LAYOUT.compactColumns
                     ? 'compact'
-                    : 'plain';
+                    : 'plain');
     }
     write(value) {
         if (value) {
@@ -81,102 +245,354 @@ export class TerminalRenderer {
     json(value) {
         return `${JSON.stringify(value, null, 2)}\n`;
     }
+    style(kind, value) {
+        switch (kind) {
+            case 'brand':
+            case 'info':
+                return this.colors.cyan(value);
+            case 'success':
+                return this.colors.green(value);
+            case 'warning':
+                return this.colors.yellow(value);
+            case 'error':
+                return this.colors.red(value);
+            case 'command':
+                return this.colors.magenta(value);
+            case 'pending':
+            case 'metadata':
+                return this.colors.dim(value);
+        }
+    }
+    contentWidth() {
+        return Math.max(1, Math.min(this.columns - 4, TERMINAL_LAYOUT.maximumContentColumns));
+    }
+    normalize(value) {
+        return this.options.normalize?.(value) ?? value;
+    }
     banner(subtitle = 'Project workstation and scaffold initializer') {
         if (this.jsonMode) {
             return '';
         }
         if (this.layout === 'plain') {
-            return `${this.colors.bold('Liftoff')} - ${subtitle}\n`;
+            return `${this.colors.bold('Liftoff')} - ${subtitle}\n\n`;
         }
         if (this.layout === 'compact') {
-            return `${this.colors.bold(this.colors.cyan('LIFTOFF'))}\n${this.colors.dim(subtitle)}\n`;
+            return [
+                ...LIFTOFF_COMPACT_WORDMARK.map((line) => this.colors.bold(this.style('brand', line))),
+                ...wrapVisible(subtitle, this.columns).map((line) => this.style('metadata', line)),
+                ''
+            ].join('\n');
         }
-        const contentWidth = Math.min(this.columns - 4, 92);
-        const border = `+${'-'.repeat(contentWidth + 2)}+`;
+        const width = this.contentWidth();
+        const border = `${TERMINAL_GLYPHS.topLeft}${TERMINAL_GLYPHS.horizontal.repeat(width + 2)}${TERMINAL_GLYPHS.topRight}`;
         const lines = [
-            ...LIFTOFF_WORDMARK.map((line) => this.colors.cyan(this.colors.bold(line))),
+            ...LIFTOFF_WORDMARK.map((line) => this.colors.bold(this.style('brand', line))),
             '',
-            this.colors.dim(subtitle)
+            ...wrapVisible(subtitle, width, true).map((line) => this.style('metadata', line))
         ];
         return [
             border,
-            ...lines.map((line) => `| ${padVisible(line, contentWidth)} |`),
-            border,
+            ...lines.map((line) => `${TERMINAL_GLYPHS.vertical} ${padVisible(line, width)} ${TERMINAL_GLYPHS.vertical}`),
+            `${TERMINAL_GLYPHS.bottomLeft}${TERMINAL_GLYPHS.horizontal.repeat(width + 2)}${TERMINAL_GLYPHS.bottomRight}`,
             ''
         ].join('\n');
     }
+    commandIdentity(command, description) {
+        if (this.jsonMode) {
+            return '';
+        }
+        const identity = `LIFTOFF / ${command.toUpperCase()}`;
+        if (this.layout === 'plain') {
+            return `${identity} - ${description}\n\n`;
+        }
+        if (this.layout === 'compact') {
+            return `${[
+                this.colors.bold(this.style('brand', identity)),
+                ...wrapVisible(description, this.columns).map((line) => this.style('metadata', line)),
+                ''
+            ].join('\n')}\n`;
+        }
+        return this.panel(identity, [this.style('metadata', description)]);
+    }
     heading(value) {
         if (this.jsonMode) {
             return '';
         }
-        return this.layout === 'plain'
-            ? `${this.colors.bold(value)}\n`
-            : `${this.colors.bold(this.colors.cyan(value))}\n${this.colors.dim('-'.repeat(Math.min(visibleLength(value), this.columns)))}\n`;
+        if (this.layout === 'plain') {
+            return `${this.colors.bold(value)}\n`;
+        }
+        const title = this.colors.bold(this.style('brand', value));
+        return `${title}\n${this.style('metadata', TERMINAL_GLYPHS.horizontal.repeat(Math.min(visibleLength(value), this.columns)))}\n`;
+    }
+    stage(value, detail) {
+        if (this.jsonMode) {
+            return '';
+        }
+        const prefix = this.layout === 'plain' ? 'Stage' : '◆';
+        const label = this.colors.bold(this.style('info', `${prefix}: ${value}`));
+        return `${label}${detail ? `\n${this.style('metadata', detail)}` : ''}\n`;
     }
     panel(title, lines) {
         if (this.jsonMode) {
             return '';
         }
-        if (this.layout !== 'full') {
-            return `${this.heading(title)}${lines.map((line) => `${line}\n`).join('')}`;
+        const normalizedTitle = this.normalize(title);
+        const bodyLines = (lines.length > 0 ? lines : ['']).map((line) => this.normalize(line));
+        if (this.layout === 'plain') {
+            return `${this.heading(normalizedTitle)}${bodyLines.flatMap((line) => line.split(/\r?\n/)).map((line) => `${line}\n`).join('')}\n`;
+        }
+        if (this.layout === 'compact') {
+            return `${this.heading(normalizedTitle)}${bodyLines.flatMap((line) => wrapVisible(line, this.columns)).map((line) => `${line}\n`).join('')}\n`;
         }
-        const width = Math.min(this.columns - 4, 92);
-        const body = lines.flatMap((line) => wrapLine(line, width));
-        const topLabel = ` ${title} `;
-        const top = `+${this.colors.bold(this.colors.cyan(topLabel))}${'-'.repeat(Math.max(0, width + 2 - topLabel.length))}+`;
+        const width = this.contentWidth();
+        const wrapped = bodyLines.flatMap((line) => wrapVisible(line, width, true));
+        const safeTitle = truncateVisible(normalizedTitle, Math.max(1, width - 2));
+        const styledTitle = this.colors.bold(this.style('brand', safeTitle));
+        const topPrefix = `${TERMINAL_GLYPHS.horizontal} ${styledTitle} `;
+        const top = `${TERMINAL_GLYPHS.topLeft}${topPrefix}${TERMINAL_GLYPHS.horizontal.repeat(Math.max(0, width + 2 - visibleLength(topPrefix)))}${TERMINAL_GLYPHS.topRight}`;
         return [
             top,
-            ...body.map((line) => `| ${padVisible(line, width)} |`),
-            `+${'-'.repeat(width + 2)}+`,
+            ...wrapped.map((line) => `${TERMINAL_GLYPHS.vertical} ${padVisible(line, width)} ${TERMINAL_GLYPHS.vertical}`),
+            `${TERMINAL_GLYPHS.bottomLeft}${TERMINAL_GLYPHS.horizontal.repeat(width + 2)}${TERMINAL_GLYPHS.bottomRight}`,
             ''
         ].join('\n');
     }
-    table(headers, rows) {
-        if (this.jsonMode) {
-            return '';
+    section(title, lines) {
+        return this.panel(title, lines);
+    }
+    definitionList(title, items) {
+        const labelWidth = Math.min(24, Math.max(0, ...items.map((item) => visibleLength(item.label))));
+        const lines = items.map((item) => {
+            return `${padVisible(item.label, labelWidth)}  ${item.value}`;
+        });
+        if (this.layout === 'plain') {
+            return `${this.heading(title)}${items.map((item) => `${item.label}: ${item.value}\n`).join('')}\n`;
         }
-        if (headers.length === 0) {
+        return this.panel(title, lines);
+    }
+    bulletList(title, items) {
+        const marker = this.layout === 'full' ? TERMINAL_GLYPHS.bullet : '-';
+        return this.panel(title, items.map((item) => `${marker} ${item}`));
+    }
+    choiceList(title, choices) {
+        const lines = choices.map((choice, index) => {
+            const marker = choice.selected
+                ? TERMINAL_GLYPHS.selected
+                : this.layout === 'full'
+                    ? TERMINAL_GLYPHS.unselected
+                    : `${index + 1}.`;
+            const number = this.layout === 'full' ? `${index + 1}.` : '';
+            const value = choice.value && choice.value !== choice.label
+                ? this.style('metadata', ` (${choice.value})`)
+                : '';
+            const state = [
+                choice.default ? this.style('info', 'default') : '',
+                choice.disabled ? this.style('warning', 'unavailable') : ''
+            ].filter(Boolean).join(', ');
+            return `${marker} ${number ? `${number} ` : ''}${choice.label}${value}${state ? ` [${state}]` : ''}`;
+        });
+        return this.panel(title, lines);
+    }
+    table(headers, rows) {
+        if (this.jsonMode || headers.length === 0) {
             return '';
         }
-        if (this.layout === 'plain' || this.columns < headers.length * 18) {
-            return rows.map((row) => row.map((cell, index) => `${headers[index] ?? `Column ${index + 1}`}: ${cell}`).join(' | ')).join('\n') + (rows.length ? '\n' : '');
+        const normalizedHeaders = headers.map((header) => this.normalize(header));
+        const normalizedRows = rows.map((row) => row.map((cell) => this.normalize(cell)));
+        if (this.layout === 'plain') {
+            return normalizedRows.map((row) => row.map((cell, index) => `${normalizedHeaders[index] ?? `Column ${index + 1}`}: ${cell}`).join(' | ')).join('\n') + (rows.length > 0 ? '\n' : '');
         }
-        const natural = headers.map((header, index) => Math.max(visibleLength(header), ...rows.map((row) => visibleLength(row[index] ?? ''))));
-        const separators = (headers.length - 1) * 3;
-        const available = Math.max(headers.length * 8, this.columns - separators);
-        const capped = natural.map((width) => Math.min(width, Math.floor(available / headers.length)));
-        const renderRow = (row) => row.map((cell, index) => padVisible(cell, capped[index] ?? 8)).join(' | ');
+        const natural = normalizedHeaders.map((header, index) => Math.max(visibleLength(header), ...normalizedRows.map((row) => visibleLength(row[index] ?? ''))));
+        const separator = '  ';
+        const available = (this.layout === 'full' ? this.contentWidth() : this.columns) -
+            separator.length * (headers.length - 1);
+        const widths = fitColumnWidths(natural, Math.max(headers.length * 4, available));
+        const renderPhysicalRow = (row) => {
+            const wrapped = widths.map((width, index) => wrapVisible(row[index] ?? '', width, true));
+            const height = Math.max(...wrapped.map((cell) => cell.length));
+            return Array.from({ length: height }, (_, lineIndex) => wrapped.map((cell, index) => padVisible(cell[lineIndex] ?? '', widths[index])).join(separator).trimEnd());
+        };
+        const header = renderPhysicalRow(normalizedHeaders).map((line) => this.colors.bold(line));
+        const separatorLine = widths.map((width) => TERMINAL_GLYPHS.horizontal.repeat(width)).join(separator);
         return [
-            this.colors.bold(renderRow(headers)),
-            renderRow(capped.map((width) => '-'.repeat(width))),
-            ...rows.map(renderRow),
+            ...header,
+            this.style('metadata', separatorLine),
+            ...normalizedRows.flatMap(renderPhysicalRow),
             ''
         ].join('\n');
     }
+    tableSection(title, headers, rows) {
+        const lines = this.table(headers, rows).trimEnd().split('\n');
+        return this.layout === 'full'
+            ? this.panel(title, lines)
+            : `${this.heading(title)}${lines.join('\n')}\n\n`;
+    }
     status(kind, label, detail) {
         if (this.jsonMode) {
             return '';
         }
-        const tokens = {
-            success: this.colors.green('[ok]'),
-            info: this.colors.cyan('[info]'),
-            warning: this.colors.yellow('[warn]'),
-            error: this.colors.red('[error]'),
-            pending: this.colors.dim('[....]')
+        const plainTokens = {
+            success: '[ok]',
+            info: '[info]',
+            warning: '[warn]',
+            error: '[error]',
+            pending: '[....]'
         };
-        return `${tokens[kind]} ${this.colors.bold(label)}${detail ? ` - ${detail}` : ''}\n`;
+        const richTokens = {
+            success: '✓',
+            info: 'i',
+            warning: '!',
+            error: '×',
+            pending: '…'
+        };
+        const token = this.layout === 'plain' ? plainTokens[kind] : richTokens[kind];
+        return `${this.style(kind === 'pending' ? 'pending' : kind, token)} ${this.colors.bold(label)}${detail ? `: ${detail}` : ''}\n`;
     }
     command(value) {
-        return this.jsonMode ? '' : `${this.colors.magenta('$')} ${this.colors.bold(value)}\n`;
+        return this.jsonMode
+            ? ''
+            : `${this.style('command', '$')} ${this.colors.bold(value)}\n`;
+    }
+    prompt(label, defaultValue) {
+        if (this.jsonMode) {
+            return '';
+        }
+        const suffix = defaultValue ? ` [${defaultValue}]` : '';
+        return `${this.style('warning', '?')} ${this.colors.bold(label)}${this.style('metadata', suffix)}: `;
+    }
+    promptContext(label, detail) {
+        return this.panel(label, detail ? [detail] : []);
+    }
+    remedy(value) {
+        if (this.jsonMode) {
+            return '';
+        }
+        return `${this.style('info', 'Remedy:')} ${value}\n`;
+    }
+    compactError(message, remedy) {
+        if (this.jsonMode) {
+            return '';
+        }
+        const lines = message.split(/\r?\n/).filter(Boolean);
+        if (this.layout === 'full') {
+            return this.panel('Error', [
+                ...lines.map((line) => this.style('error', line)),
+                ...(remedy ? [`${this.style('info', 'Remedy:')} ${remedy}`] : [])
+            ]);
+        }
+        return [
+            this.status('error', 'Error', lines[0] ?? message).trimEnd(),
+            ...lines.slice(1).map((line) => `  ${line}`),
+            ...(remedy ? [this.remedy(remedy).trimEnd()] : []),
+            ''
+        ].join('\n');
     }
     warning(value) {
         return this.status('warning', 'Warning', value);
     }
-    error(value) {
-        return this.status('error', 'Error', value);
+    error(value, remedy) {
+        return this.compactError(value, remedy);
+    }
+    cancellation(value) {
+        return this.status('info', 'Cancelled', value);
+    }
+    completion(label, detail, items = [], nextCommand) {
+        return [
+            this.status('success', label, detail),
+            ...(items.length > 0 ? [this.definitionList('Completion', items)] : []),
+            ...(nextCommand ? [this.command(nextCommand)] : [])
+        ].join('');
     }
     confirmation(value) {
-        return this.jsonMode ? '' : `${this.colors.yellow('?')} ${this.colors.bold(value)}\n`;
+        return this.jsonMode ? '' : `${this.style('warning', '?')} ${this.colors.bold(value)}\n`;
+    }
+}
+export class PresentationSession {
+    stdout;
+    stderr;
+    stdoutStream;
+    stderrStream;
+    constructor(options) {
+        this.stdoutStream = options.stdout;
+        this.stderrStream = options.stderr;
+        const rendererOptions = {
+            columns: options.columns,
+            color: options.color,
+            snapshot: options.snapshot,
+            json: options.json,
+            env: options.env,
+            layout: options.layout,
+            normalize: options.normalize
+        };
+        this.stdout = new TerminalRenderer({ stream: options.stdout, ...rendererOptions });
+        this.stderr = new TerminalRenderer({ stream: options.stderr, ...rendererOptions });
+    }
+    identity(subtitle) {
+        this.stdout.write(this.stdout.banner(subtitle));
+    }
+    commandIdentity(command, description) {
+        this.stdout.write(this.stdout.commandIdentity(command, description));
+    }
+    stage(title, detail) {
+        this.stdout.write(this.stdout.stage(title, detail));
+    }
+    section(title, lines) {
+        this.stdout.write(this.stdout.section(title, lines));
+    }
+    definitions(title, items) {
+        this.stdout.write(this.stdout.definitionList(title, items));
+    }
+    bullets(title, items) {
+        this.stdout.write(this.stdout.bulletList(title, items));
+    }
+    choices(title, choices) {
+        this.stdout.write(this.stdout.choiceList(title, choices));
+    }
+    prompt(label, defaultValue) {
+        this.stdout.write(this.stdout.prompt(label, defaultValue));
+    }
+    table(title, headers, rows) {
+        this.stdout.write(this.stdout.tableSection(title, headers, rows));
+    }
+    status(kind, label, detail) {
+        this.stdout.write(this.stdout.status(kind, label, detail));
+    }
+    warning(value) {
+        this.stdout.write(this.stdout.warning(value));
+    }
+    command(value) {
+        this.stdout.write(this.stdout.command(value));
+    }
+    remedy(value) {
+        this.stdout.write(this.stdout.remedy(value));
+    }
+    cancellation(value) {
+        this.stdout.write(this.stdout.cancellation(value));
+    }
+    completion(label, detail, items = [], nextCommand) {
+        this.stdout.write(this.stdout.completion(label, detail, items, nextCommand));
+    }
+    error(message, remedy) {
+        if (this.stderr.jsonMode) {
+            this.stderrStream.write([
+                message.trimEnd(),
+                ...(remedy ? [`Remedy: ${remedy}`] : [])
+            ].join('\n') + '\n');
+            return;
+        }
+        this.stderr.write(this.stderr.compactError(message, remedy));
+    }
+    rawStdout(value) {
+        this.stdoutStream.write(value);
+    }
+    rawStderr(value) {
+        this.stderrStream.write(value);
+    }
+    childStreams() {
+        return {
+            stdout: this.stdoutStream,
+            stderr: this.stderrStream
+        };
     }
 }
 //# sourceMappingURL=terminal.js.map