eff-u-code 2.0.0

package/dist/utils/markdown.js

@@ -0,0 +1,303 @@
+/**
+ * Terminal Markdown renderer
+ *
+ * Converts Markdown to chalk-styled terminal output with block-level state
+ * machine (code fences, tables, normal text) and placeholder-based inline
+ * formatting to prevent bold/italic matching inside code spans.
+ */
+import chalk from 'chalk';
+import { getTerminalWidth, displayWidth, padEndByWidth, wrapAnsiLine } from './terminal.js';
+/**
+ * Render a Markdown string to chalk-styled terminal output.
+ *
+ * @param markdown - Raw Markdown text
+ * @param indent - Number of spaces to prepend to every output line (default: 0)
+ * @returns Chalk-styled string ready for console.log
+ */
+export function renderMarkdownToTerminal(markdown, indent = 0) {
+    const lines = markdown.split('\n');
+    const output = [];
+    let state = 0 /* BlockState.Normal */;
+    let codeFence = '';
+    let tableBuffer = [];
+    const indentStr = indent > 0 ? ' '.repeat(indent) : '';
+    const contentWidth = Math.max(20, getTerminalWidth() - indent);
+    let prevBlank = false;
+    for (const raw of lines) {
+        if (state === 1 /* BlockState.FencedCode */) {
+            prevBlank = false;
+            if (isClosingFence(raw, codeFence)) {
+                state = 0 /* BlockState.Normal */;
+                codeFence = '';
+            }
+            else {
+                const wrapped = wrapAnsiLine(chalk.gray(`  ${raw}`), contentWidth);
+                for (const seg of wrapped)
+                    output.push(indentStr + seg);
+            }
+            continue;
+        }
+        const fenceMatch = /^(\s*)(```+|~~~+)(.*)/.exec(raw);
+        if (fenceMatch) {
+            prevBlank = false;
+            if (state === 2 /* BlockState.Table */ && tableBuffer.length > 0) {
+                output.push(...renderTable(tableBuffer, indentStr));
+                tableBuffer = [];
+            }
+            state = 1 /* BlockState.FencedCode */;
+            codeFence = fenceMatch[2] ?? '';
+            const lang = (fenceMatch[3] ?? '').trim();
+            if (lang) {
+                output.push(indentStr + chalk.gray.dim(`  [${lang}]`));
+            }
+            continue;
+        }
+        const trimmed = raw.trimStart();
+        if (trimmed.startsWith('|') && trimmed.endsWith('|')) {
+            prevBlank = false;
+            if (state !== 2 /* BlockState.Table */) {
+                state = 2 /* BlockState.Table */;
+                tableBuffer = [];
+            }
+            tableBuffer.push(raw);
+            continue;
+        }
+        if (state === 2 /* BlockState.Table */) {
+            if (tableBuffer.length > 0) {
+                output.push(...renderTable(tableBuffer, indentStr));
+                tableBuffer = [];
+            }
+            state = 0 /* BlockState.Normal */;
+        }
+        if (raw.trim() === '') {
+            if (prevBlank)
+                continue;
+            prevBlank = true;
+        }
+        else {
+            prevBlank = false;
+        }
+        const rendered = renderBlockLine(raw, contentWidth);
+        const wrapped = wrapAnsiLine(rendered.text, contentWidth, rendered.hangingIndent);
+        for (const seg of wrapped)
+            output.push(indentStr + seg);
+    }
+    if (state === 2 /* BlockState.Table */ && tableBuffer.length > 0) {
+        output.push(...renderTable(tableBuffer, indentStr));
+    }
+    return output.join('\n');
+}
+/** Check if a line closes the current fenced code block */
+function isClosingFence(line, openFence) {
+    const trimmed = line.trim();
+    const fenceChar = openFence[0] ?? '`';
+    const minLen = openFence.length;
+    if (!trimmed.startsWith(fenceChar.repeat(minLen)))
+        return false;
+    return /^(`{3,}|~{3,})\s*$/.test(trimmed);
+}
+/** Parse a table row into cells, stripping leading/trailing pipes and whitespace */
+function parseTableCells(row) {
+    const trimmed = row.trim();
+    const inner = trimmed.startsWith('|') ? trimmed.slice(1) : trimmed;
+    const stripped = inner.endsWith('|') ? inner.slice(0, -1) : inner;
+    return stripped.split('|').map((cell) => cell.trim());
+}
+/** Check if a row is a separator row (|---|---|) */
+function isSeparatorRow(row) {
+    return /^\|[\s:|-]+\|$/.test(row.trim());
+}
+/**
+ * Render a Markdown table with proper column alignment and borders.
+ *
+ * Calculates the display width of each column (accounting for CJK characters),
+ * then renders with box-drawing characters. Columns are truncated if the table
+ * would exceed terminal width.
+ */
+function renderTable(rows, indentStr) {
+    if (rows.length === 0)
+        return [];
+    // Parse data rows (skip separator rows)
+    const dataRows = [];
+    for (const row of rows) {
+        if (!isSeparatorRow(row)) {
+            dataRows.push(parseTableCells(row));
+        }
+    }
+    if (dataRows.length === 0)
+        return rows.map((r) => indentStr + chalk.gray(r));
+    const firstRow = dataRows[0];
+    if (!firstRow)
+        return rows.map((r) => indentStr + chalk.gray(r));
+    const colCount = firstRow.length;
+    // Calculate max display width per column
+    const colWidths = new Array(colCount).fill(0);
+    for (const row of dataRows) {
+        for (let c = 0; c < colCount; c++) {
+            const cell = row[c] ?? '';
+            const width = displayWidth(cell);
+            if (width > (colWidths[c] ?? 0))
+                colWidths[c] = width;
+        }
+    }
+    // Clamp total width to terminal width
+    const termWidth = getTerminalWidth();
+    const indentWidth = displayWidth(indentStr);
+    const overhead = 3 * colCount + 1;
+    const availableWidth = termWidth - indentWidth - overhead;
+    const totalContentWidth = colWidths.reduce((sum, w) => sum + w, 0);
+    if (totalContentWidth > availableWidth && availableWidth > colCount) {
+        // Proportionally shrink columns, minimum 3 chars each
+        const scale = availableWidth / totalContentWidth;
+        for (let c = 0; c < colCount; c++) {
+            colWidths[c] = Math.max(3, Math.floor((colWidths[c] ?? 0) * scale));
+        }
+    }
+    const output = [];
+    // Build horizontal separator
+    const hLine = '├' + colWidths.map((w) => '─'.repeat(w + 2)).join('┼') + '┤';
+    const topLine = '┌' + colWidths.map((w) => '─'.repeat(w + 2)).join('┬') + '┐';
+    const bottomLine = '└' + colWidths.map((w) => '─'.repeat(w + 2)).join('┴') + '┘';
+    output.push(indentStr + chalk.gray(topLine));
+    let isHeader = true;
+    for (const row of rows) {
+        if (isSeparatorRow(row)) {
+            output.push(indentStr + chalk.gray(hLine));
+            isHeader = false;
+            continue;
+        }
+        const cells = parseTableCells(row);
+        const formattedCells = cells.slice(0, colCount).map((cell, c) => {
+            const maxW = colWidths[c] ?? 0;
+            const cellWidth = displayWidth(cell);
+            const formatted = renderInline(cell);
+            if (cellWidth > maxW) {
+                const truncated = truncatePlainText(cell, maxW);
+                return padEndByWidth(renderInline(truncated), maxW);
+            }
+            return padEndByWidth(formatted, maxW + (displayWidth(formatted) - cellWidth));
+        });
+        const line = chalk.gray('│') +
+            formattedCells
+                .map((cell, c) => {
+                const maxW = colWidths[c] ?? 0;
+                const content = ` ${padEndByWidth(cell, maxW)} `;
+                return isHeader ? chalk.bold(content) : content;
+            })
+                .join(chalk.gray('│')) +
+            chalk.gray('│');
+        output.push(indentStr + line);
+    }
+    output.push(indentStr + chalk.gray(bottomLine));
+    return output;
+}
+/** Truncate plain text (no ANSI) to fit within maxWidth display columns */
+function truncatePlainText(text, maxWidth) {
+    if (displayWidth(text) <= maxWidth)
+        return text;
+    let width = 0;
+    let result = '';
+    for (const char of text) {
+        const codePoint = char.codePointAt(0) || 0;
+        const charWidth = (codePoint >= 0x1100 && codePoint <= 0x115f) ||
+            (codePoint >= 0x2e80 && codePoint <= 0x9fff) ||
+            (codePoint >= 0xac00 && codePoint <= 0xd7af) ||
+            (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+            (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+            (codePoint >= 0xff01 && codePoint <= 0xff60) ||
+            (codePoint >= 0x20000 && codePoint <= 0x3134f)
+            ? 2
+            : 1;
+        if (width + charWidth > maxWidth - 1)
+            break;
+        result += char;
+        width += charWidth;
+    }
+    return result + '…';
+}
+/** Render a single non-code, non-table line with block-level detection */
+function renderBlockLine(line, contentWidth) {
+    // Horizontal rule — must come before list detection (--- could be confused)
+    if (/^(\s*)([-*_])\s*(\2\s*){2,}$/.test(line)) {
+        return { text: chalk.gray('─'.repeat(contentWidth)), hangingIndent: 0 };
+    }
+    // ATX headings (# through ######)
+    const headingMatch = /^(#{1,6})\s+(.*?)(?:\s+#+\s*)?$/.exec(line);
+    if (headingMatch) {
+        const level = (headingMatch[1] ?? '').length;
+        const text = renderInline(headingMatch[2] ?? '');
+        if (level === 1)
+            return { text: chalk.bold.yellow(text), hangingIndent: 0 };
+        if (level === 2)
+            return { text: chalk.bold.cyan(text), hangingIndent: 0 };
+        if (level === 3)
+            return { text: chalk.bold.magenta(text), hangingIndent: 0 };
+        if (level === 4)
+            return { text: chalk.bold.blue(text), hangingIndent: 0 };
+        return { text: chalk.bold(text), hangingIndent: 0 };
+    }
+    // Blockquote (supports nested `>>`)
+    const bqMatch = /^(\s*>)+\s?(.*)/.exec(line);
+    if (bqMatch) {
+        const depth = (line.match(/>/g) || []).length;
+        const prefix = chalk.gray('  │ '.repeat(depth));
+        const content = bqMatch[2] ?? '';
+        return { text: prefix + chalk.gray(renderInline(content)), hangingIndent: depth * 4 };
+    }
+    // Unordered list item (-, *, +) with indent awareness
+    const ulMatch = /^(\s*)([-*+])\s+(.*)/.exec(line);
+    if (ulMatch) {
+        const listIndent = ulMatch[1] ?? '';
+        return {
+            text: `${listIndent}  • ${renderInline(ulMatch[3] ?? '')}`,
+            hangingIndent: listIndent.length + 4,
+        };
+    }
+    // Ordered list item
+    const olMatch = /^(\s*)(\d+)[.)]\s+(.*)/.exec(line);
+    if (olMatch) {
+        const listIndent = olMatch[1] ?? '';
+        const numStr = olMatch[2] ?? '';
+        return {
+            text: `${listIndent}  ${numStr}. ${renderInline(olMatch[3] ?? '')}`,
+            hangingIndent: listIndent.length + 2 + numStr.length + 2,
+        };
+    }
+    // Plain paragraph / text
+    return { text: renderInline(line), hangingIndent: 0 };
+}
+// Inline code placeholders — extracted first so bold/italic won't match inside code
+const PLACEHOLDER_PREFIX = '\x00CODE';
+const PLACEHOLDER_SUFFIX = '\x00';
+/** Apply inline Markdown formatting (code, links, bold, italic, strikethrough) */
+function renderInline(text) {
+    // Extract inline code spans into placeholders to protect from further formatting
+    const codeSpans = [];
+    let processed = text.replace(/`([^`]+)`/g, (_, code) => {
+        const idx = codeSpans.length;
+        codeSpans.push(chalk.cyan(code));
+        return `${PLACEHOLDER_PREFIX}${idx}${PLACEHOLDER_SUFFIX}`;
+    });
+    // Links: [text](url)
+    processed = processed.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, linkText, url) => `${chalk.cyan(linkText)} ${chalk.gray.dim(`(${url})`)}`);
+    // Images: ![alt](url)
+    processed = processed.replace(/!\[([^\]]*)\]\([^)]+\)/g, (_, alt) => chalk.dim(`[${alt || 'image'}]`));
+    // Bold + italic (***text*** or ___text___)
+    processed = processed.replace(/(\*{3}|_{3})(.+?)\1/g, (_, _marker, content) => chalk.bold.dim(content));
+    // Bold (**text** or __text__)
+    processed = processed.replace(/(\*{2}|_{2})(.+?)\1/g, (_, _marker, content) => chalk.bold(content));
+    // Italic (*text* or _text_) — dim as terminal italic fallback
+    // Negative lookbehind/ahead prevents matching inside ** pairs
+    processed = processed.replace(/(?<![*_])([*_])(?!\1)(.+?)(?<!\1)\1(?!\1)/g, (_, _marker, content) => chalk.dim(content));
+    // Strikethrough (~~text~~)
+    processed = processed.replace(/~~(.+?)~~/g, (_, content) => chalk.strikethrough(content));
+    // Restore inline code placeholders
+    for (let i = 0; i < codeSpans.length; i++) {
+        const span = codeSpans[i];
+        if (span === undefined)
+            continue;
+        processed = processed.replace(`${PLACEHOLDER_PREFIX}${i}${PLACEHOLDER_SUFFIX}`, span);
+    }
+    return processed;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/utils/markdown.js.map

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

package/dist/utils/progress.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Progress display utilities
+ */
+import { type Ora } from 'ora';
+export declare function createSpinner(text: string): Ora;
+export declare function createProgressBar(total: number, label: string): ProgressBar;
+export declare class ProgressBar {
+    private current;
+    private total;
+    private label;
+    private spinner;
+    private startTime;
+    private barWidth;
+    constructor(total: number, label: string);
+    start(): void;
+    increment(): void;
+    update(current: number): void;
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    private formatText;
+    private renderBar;
+    private getETA;
+}
+//# sourceMappingURL=progress.d.ts.map

package/dist/utils/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAGpC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAM/C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAE3E;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAM;gBAEV,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAUxC,KAAK,IAAI,IAAI;IAKb,SAAS,IAAI,IAAI;IAKjB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,MAAM;CAYf"}

package/dist/utils/progress.js

@@ -0,0 +1,79 @@
+/**
+ * Progress display utilities
+ */
+import ora from 'ora';
+import chalk from 'chalk';
+export function createSpinner(text) {
+    return ora({
+        text,
+        spinner: 'dots',
+        color: 'cyan',
+    });
+}
+export function createProgressBar(total, label) {
+    return new ProgressBar(total, label);
+}
+export class ProgressBar {
+    current = 0;
+    total;
+    label;
+    spinner;
+    startTime = 0;
+    barWidth = 20;
+    constructor(total, label) {
+        this.total = total;
+        this.label = label;
+        this.spinner = ora({
+            text: this.formatText(),
+            spinner: 'dots',
+            color: 'cyan',
+        });
+    }
+    start() {
+        this.startTime = Date.now();
+        this.spinner.start();
+    }
+    increment() {
+        this.current++;
+        this.spinner.text = this.formatText();
+    }
+    update(current) {
+        this.current = current;
+        this.spinner.text = this.formatText();
+    }
+    succeed(text) {
+        this.spinner.succeed(text || this.formatText());
+    }
+    fail(text) {
+        this.spinner.fail(text);
+    }
+    formatText() {
+        const percent = this.total > 0 ? Math.round((this.current / this.total) * 100) : 0;
+        const bar = this.renderBar(percent);
+        const stats = chalk.gray(`[${this.current}/${this.total}]`);
+        const percentStr = chalk.cyan(`${percent}%`);
+        const eta = this.getETA();
+        return `${this.label} ${bar} ${stats} ${percentStr}${eta}`;
+    }
+    renderBar(percent) {
+        const filled = Math.round((percent / 100) * this.barWidth);
+        const empty = this.barWidth - filled;
+        const filledBar = chalk.cyan('█'.repeat(filled));
+        const emptyBar = chalk.gray('░'.repeat(empty));
+        return `${filledBar}${emptyBar}`;
+    }
+    getETA() {
+        if (this.current === 0 || this.startTime === 0)
+            return '';
+        const elapsed = Date.now() - this.startTime;
+        const rate = this.current / elapsed;
+        const remaining = this.total - this.current;
+        const eta = remaining / rate;
+        if (eta < 1000)
+            return '';
+        if (eta < 60000)
+            return chalk.gray(` ~${Math.round(eta / 1000)}s`);
+        return chalk.gray(` ~${Math.round(eta / 60000)}m`);
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/utils/progress.js.map

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

package/dist/utils/terminal.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Terminal display utilities
+ *
+ * Provides terminal width detection, Unicode-aware string width calculation,
+ * and display-width-based string padding/truncation for proper CJK alignment.
+ */
+/**
+ * Get current terminal width.
+ *
+ * Falls back to 80 columns when stdout is not a TTY (e.g. piped output, CI).
+ * Clamped to [60, 200] to prevent degenerate layouts on extremely narrow
+ * or wide terminals.
+ */
+export declare function getTerminalWidth(): number;
+/**
+ * Calculate the display width of a string in terminal columns.
+ *
+ * Strips ANSI escape codes before measuring. CJK and other East Asian
+ * wide characters count as 2 columns; all other printable characters
+ * count as 1 column. Control characters (except ANSI sequences) are
+ * counted as 0 columns.
+ *
+ * @param str - Input string, may contain ANSI escape codes
+ * @returns Number of terminal columns the string occupies
+ */
+export declare function displayWidth(str: string): number;
+/**
+ * Pad a string with trailing spaces to reach the target display width.
+ *
+ * Unlike `String.prototype.padEnd`, this accounts for CJK characters
+ * that occupy 2 terminal columns. If the string already meets or exceeds
+ * the target width, it is returned unchanged.
+ *
+ * @param str - Input string to pad
+ * @param targetWidth - Desired display width in terminal columns
+ * @returns Padded string
+ */
+export declare function padEndByWidth(str: string, targetWidth: number): string;
+/**
+ * Truncate a string to fit within a maximum display width.
+ *
+ * If the string exceeds `maxWidth`, it is truncated and an ellipsis suffix
+ * is appended. CJK characters are handled correctly — truncation never
+ * splits a wide character. ANSI escape codes are preserved for characters
+ * that remain in the output.
+ *
+ * @param str - Input string (plain text, no ANSI codes expected)
+ * @param maxWidth - Maximum display width in terminal columns
+ * @param suffix - Suffix to append when truncated (default: "..")
+ * @returns Truncated string fitting within maxWidth columns
+ */
+/**
+ * Wrap a string containing ANSI escape codes to fit within maxWidth display columns.
+ *
+ * Splits the line into segments that each fit within maxWidth. ANSI style state
+ * is tracked and replayed on continuation lines so colors/bold carry over correctly.
+ *
+ * @returns Array of line segments (at least one element)
+ */
+export declare function wrapAnsiLine(line: string, maxWidth: number, hangingIndent?: number): string[];
+export declare function truncateByWidth(str: string, maxWidth: number, suffix?: string): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/utils/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/utils/terminal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4DH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAItE;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,SAAI,GAAG,MAAM,EAAE,CA8CxF;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAsBpF"}