@uofx/cli 1.0.0

package/dist/presentation/ui/output-builder.service.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * OutputBuilder Service
+ *
+ * Fluent API 風格的輸出建構器
+ * 提供統一的縮排管理和緩衝輸出機制
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputBuilder = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../di/tokens");
+const log_level_enum_1 = require("./log-level.enum");
+const output_symbols_1 = require("./constants/output-symbols");
+/**
+ * ANSI 顏色碼常數
+ */
+const ANSI = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    cyan: '\x1b[36m',
+};
+/**
+ * OutputBuilder 實作
+ *
+ * 提供 Fluent API 風格的輸出建構器：
+ * - 支援縮排管理（indent/outdent）
+ * - 緩衝輸出機制（render/flush）
+ * - 自動清空 buffer
+ */
+let OutputBuilder = class OutputBuilder {
+    constructor(formatter) {
+        this.formatter = formatter;
+        this.buffer = [];
+        this.currentIndent = 0;
+        this.logLevel = log_level_enum_1.OutputLogLevel.INFO;
+        this.suppressed = false;
+        this.tty = process.stdout.isTTY ?? false;
+        this.colorEnabled = this.detectColorSupport();
+        this.formatter.setColorEnabled(this.colorEnabled);
+    }
+    // ============================================================================
+    // 私有方法
+    // ============================================================================
+    /**
+     * 偵測顏色支援
+     */
+    detectColorSupport() {
+        if (process.env.NO_COLOR !== undefined) {
+            return false;
+        }
+        if (process.env.FORCE_COLOR !== undefined) {
+            return process.env.FORCE_COLOR !== '0';
+        }
+        if (process.env.CI && !process.env.FORCE_COLOR) {
+            return false;
+        }
+        return this.tty;
+    }
+    /**
+     * 取得縮排字串
+     */
+    getIndentString(level) {
+        const safeLevel = Math.min(Math.max(0, level), output_symbols_1.INDENT_CONFIG.MAX_LEVEL);
+        return output_symbols_1.INDENT_CONFIG.UNIT.repeat(safeLevel);
+    }
+    /**
+     * 取得基礎縮排空格數
+     * 根據輸出類型決定基礎縮排，讓視覺層級更清晰
+     */
+    getBaseIndentSpaces(_type, _itemType) {
+        // 所有類型統一 2 空格基礎縮排
+        return 2;
+    }
+    /**
+     * 套用顏色格式
+     */
+    applyColor(text, colorCode) {
+        if (!this.colorEnabled) {
+            return text;
+        }
+        return `${colorCode}${text}${ANSI.reset}`;
+    }
+    /**
+     * 檢查訊息是否應該被輸出
+     */
+    shouldOutput(level) {
+        return (0, log_level_enum_1.shouldOutputLevel)(level, this.logLevel);
+    }
+    /**
+     * 輸出到 stdout
+     */
+    write(message) {
+        process.stdout.write(message + '\n');
+    }
+    /**
+     * 輸出到 stderr
+     */
+    writeError(message) {
+        process.stderr.write(message + '\n');
+    }
+    /**
+     * 加入緩衝區
+     */
+    addToBuffer(item) {
+        // 抑制期間跳過非 section/success/error/warning 的輸出
+        if (this.suppressed) {
+            return;
+        }
+        this.buffer.push(item);
+    }
+    /**
+     * 渲染單一緩衝項目
+     */
+    renderItem(item) {
+        // 計算總縮排：基礎縮排 + 使用者指定的縮排
+        const baseIndentSpaces = this.getBaseIndentSpaces(item.type, item.itemType);
+        const userIndent = this.getIndentString(item.indent);
+        const baseIndent = ' '.repeat(baseIndentSpaces);
+        const totalIndent = baseIndent + userIndent;
+        switch (item.type) {
+            case 'line':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.INFO)) {
+                    const lineIndent = this.getIndentString(item.indent);
+                    this.write(`${lineIndent}${item.content}`);
+                }
+                break;
+            case 'info':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.INFO)) {
+                    this.write(`${totalIndent}${item.content}`);
+                }
+                break;
+            case 'section':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.INFO)) {
+                    const boldText = this.formatter.formatBold(item.content);
+                    this.write(`${totalIndent}${boldText}`);
+                }
+                break;
+            case 'success':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.INFO)) {
+                    const successText = this.applyColor(`${output_symbols_1.OUTPUT_SYMBOLS.SUCCESS} ${item.content}`, ANSI.green);
+                    this.write(`${totalIndent}${successText}`);
+                }
+                break;
+            case 'error':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.ERROR)) {
+                    const errorText = this.applyColor(`${output_symbols_1.OUTPUT_SYMBOLS.ERROR} ${item.content}`, ANSI.red);
+                    this.writeError(`${totalIndent}${errorText}`);
+                }
+                break;
+            case 'warning':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.WARN)) {
+                    const warningText = this.applyColor(`${output_symbols_1.OUTPUT_SYMBOLS.WARNING} ${item.content}`, ANSI.yellow);
+                    this.write(`${totalIndent}${warningText}`);
+                }
+                break;
+            case 'item':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.INFO) && item.itemType) {
+                    const symbol = (0, output_symbols_1.getSymbolForItem)(item.itemType);
+                    this.write(`${totalIndent}${symbol} ${item.content}`);
+                }
+                break;
+            case 'newline':
+                this.write('');
+                break;
+            case 'divider':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.INFO) && item.dividerData) {
+                    const dividerStr = this.formatter.formatDivider(item.dividerData.length, item.dividerData.char);
+                    this.write(`${totalIndent}${dividerStr}`);
+                }
+                break;
+            case 'table':
+                if (this.shouldOutput(log_level_enum_1.OutputLogLevel.INFO) && item.tableData) {
+                    const tableStr = this.formatter.formatTable(item.tableData.headers, item.tableData.rows, item.tableData.options);
+                    // 為表格的每一行加上縮排
+                    const indentedTable = tableStr
+                        .split('\n')
+                        .map(line => `${totalIndent}${line}`)
+                        .join('\n');
+                    this.write(indentedTable);
+                }
+                break;
+        }
+    }
+    // ============================================================================
+    // Fluent API - 文字輸出
+    // ============================================================================
+    line(message) {
+        this.addToBuffer({
+            type: 'line',
+            content: message,
+            indent: this.currentIndent,
+        });
+        return this;
+    }
+    section(message) {
+        this.addToBuffer({
+            type: 'section',
+            content: message,
+            indent: this.currentIndent,
+        });
+        return this;
+    }
+    info(message) {
+        this.addToBuffer({
+            type: 'info',
+            content: message,
+            indent: this.currentIndent,
+        });
+        return this;
+    }
+    success(message) {
+        this.addToBuffer({
+            type: 'success',
+            content: message,
+            indent: this.currentIndent,
+        });
+        return this;
+    }
+    error(message) {
+        this.addToBuffer({
+            type: 'error',
+            content: message,
+            indent: this.currentIndent,
+        });
+        return this;
+    }
+    warning(message) {
+        this.addToBuffer({
+            type: 'warning',
+            content: message,
+            indent: this.currentIndent,
+        });
+        return this;
+    }
+    item(type, message) {
+        this.addToBuffer({
+            type: 'item',
+            content: message,
+            indent: this.currentIndent,
+            itemType: type,
+        });
+        return this;
+    }
+    // ============================================================================
+    // Fluent API - 縮排管理
+    // ============================================================================
+    indent(levels = 1) {
+        this.currentIndent = Math.min(this.currentIndent + levels, output_symbols_1.INDENT_CONFIG.MAX_LEVEL);
+        return this;
+    }
+    outdent(levels = 1) {
+        this.currentIndent = Math.max(this.currentIndent - levels, 0);
+        return this;
+    }
+    resetIndent() {
+        this.currentIndent = 0;
+        return this;
+    }
+    // ============================================================================
+    // Fluent API - 格式化輸出
+    // ============================================================================
+    newline() {
+        this.addToBuffer({
+            type: 'newline',
+            content: '',
+            indent: 0,
+        });
+        return this;
+    }
+    divider(length = 60, char = output_symbols_1.OUTPUT_SYMBOLS.DIVIDER) {
+        this.addToBuffer({
+            type: 'divider',
+            content: '',
+            indent: this.currentIndent,
+            dividerData: { length, char },
+        });
+        return this;
+    }
+    table(headers, rows, options) {
+        this.addToBuffer({
+            type: 'table',
+            content: '',
+            indent: this.currentIndent,
+            tableData: { headers, rows, options },
+        });
+        return this;
+    }
+    // ============================================================================
+    // 渲染方法
+    // ============================================================================
+    render() {
+        for (const item of this.buffer) {
+            this.renderItem(item);
+        }
+        this.buffer = [];
+    }
+    flush() {
+        this.render();
+    }
+    // ============================================================================
+    // 輔助方法
+    // ============================================================================
+    getBufferSize() {
+        return this.buffer.length;
+    }
+    getIndentLevel() {
+        return this.currentIndent;
+    }
+    clear() {
+        this.buffer = [];
+        return this;
+    }
+    suppress() {
+        this.suppressed = true;
+        return this;
+    }
+    resume() {
+        this.suppressed = false;
+        return this;
+    }
+    // ============================================================================
+    // 配置方法（為了與現有系統相容）
+    // ============================================================================
+    /**
+     * 設定日誌等級
+     */
+    setLogLevel(level) {
+        this.logLevel = level;
+    }
+    /**
+     * 取得目前日誌等級
+     */
+    getLogLevel() {
+        return this.logLevel;
+    }
+    /**
+     * 啟用或停用顏色輸出
+     */
+    setColorEnabled(enabled) {
+        this.colorEnabled = enabled;
+        this.formatter.setColorEnabled(enabled);
+    }
+    /**
+     * 檢查顏色輸出是否啟用
+     */
+    isColorEnabled() {
+        return this.colorEnabled;
+    }
+    /**
+     * 檢查是否為 TTY 終端
+     */
+    isTTY() {
+        return this.tty;
+    }
+};
+exports.OutputBuilder = OutputBuilder;
+exports.OutputBuilder = OutputBuilder = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IOutputFormatter)),
+    __metadata("design:paramtypes", [Object])
+], OutputBuilder);
+//# sourceMappingURL=output-builder.service.js.map