@uofx/cli 1.0.0

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

@@ -0,0 +1,393 @@
+"use strict";
+/**
+ * Output Formatter Service
+ *
+ * 提供統一的輸出格式化功能，支援顏色輸出和表格格式化
+ * 可根據 TTY 狀態或配置啟用/停用顏色輸出
+ */
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputFormatter = void 0;
+const tsyringe_1 = require("tsyringe");
+const output_formatter_interface_1 = require("./interfaces/output-formatter.interface");
+/**
+ * ANSI 顏色碼
+ */
+const ANSI = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    // 前景色
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+};
+/**
+ * OutputFormatter 實作
+ */
+let OutputFormatter = class OutputFormatter {
+    constructor() {
+        // 預設根據 TTY 狀態決定是否啟用顏色
+        this.colorEnabled = process.stdout.isTTY ?? false;
+    }
+    /**
+     * 套用顏色格式
+     */
+    applyColor(text, colorCode) {
+        if (!this.colorEnabled) {
+            return text;
+        }
+        return `${colorCode}${text}${ANSI.reset}`;
+    }
+    /**
+     * 根據顏色名稱取得對應的 ANSI 碼
+     */
+    getColorCode(colorName) {
+        const colorMap = {
+            green: ANSI.green,
+            red: ANSI.red,
+            yellow: ANSI.yellow,
+            blue: ANSI.blue,
+            cyan: ANSI.cyan,
+            white: ANSI.white,
+            dim: ANSI.dim,
+        };
+        return colorMap[colorName.toLowerCase()] || '';
+    }
+    /**
+     * 檢查字串是否為數字（用於自動對齊）
+     */
+    isNumericValue(value) {
+        if (!value || value.trim() === '')
+            return false;
+        // 移除千分位符號和貨幣符號後檢查
+        const cleaned = value.replace(/[,$\s]/g, '');
+        return !isNaN(Number(cleaned)) && cleaned.length > 0;
+    }
+    /**
+     * 對齊文字
+     */
+    alignText(text, width, alignment) {
+        const strippedText = this.stripAnsi(text);
+        const textLength = strippedText.length;
+        const padding = width - textLength;
+        if (padding <= 0) {
+            return text;
+        }
+        switch (alignment) {
+            case 'right':
+                return ' '.repeat(padding) + text;
+            case 'center': {
+                // 使用 round 讓置中更精準，奇數時平均分配
+                const leftPad = Math.round(padding / 2);
+                const rightPad = padding - leftPad;
+                return ' '.repeat(leftPad) + text + ' '.repeat(rightPad);
+            }
+            case 'left':
+            default:
+                return text + ' '.repeat(padding);
+        }
+    }
+    /**
+     * 移除 ANSI 控制碼（用於計算實際文字長度）
+     */
+    stripAnsi(text) {
+        // eslint-disable-next-line no-control-regex
+        return text.replace(/\x1b\[[0-9;]*m/g, '');
+    }
+    /**
+     * 計算文字實際顯示長度（不包含 ANSI 碼）
+     */
+    getDisplayLength(text) {
+        return this.stripAnsi(text).length;
+    }
+    /**
+     * 格式化表格
+     */
+    formatTable(headers, rows, options) {
+        // 提取選項
+        const padding = options?.padding ?? 2;
+        const headerSeparator = options?.headerSeparator ?? true;
+        const borders = options?.borders ?? false;
+        const colorize = options?.colorize ?? true;
+        const statusColumn = options?.statusColumn;
+        const statusColors = options?.statusColors ?? output_formatter_interface_1.DEFAULT_STATUS_COLORS;
+        const emptyMessage = options?.emptyMessage ?? 'No data found';
+        // 處理空表格
+        if (rows.length === 0) {
+            return this.formatDim(emptyMessage);
+        }
+        // 找出狀態欄位的索引
+        const statusColumnIndex = statusColumn
+            ? headers.findIndex((h) => h.toLowerCase() === statusColumn.toLowerCase())
+            : -1;
+        // 計算欄位對齊方式和寬度
+        const columnAlignments = this.determineColumnAlignments(headers, rows, options);
+        const columnWidths = this.calculateColumnWidths(headers, rows);
+        // 根據邊框模式選擇格式化方法
+        if (borders) {
+            return this.formatTableWithBorders(headers, rows, columnWidths, columnAlignments, padding, headerSeparator, statusColumnIndex, colorize, statusColors);
+        }
+        else {
+            return this.formatTableWithoutBorders(headers, rows, columnWidths, columnAlignments, padding, headerSeparator, statusColumnIndex, colorize, statusColors);
+        }
+    }
+    /**
+     * 格式化成功訊息
+     */
+    formatSuccess(message) {
+        const icon = this.colorEnabled ? '✓' : '[OK]';
+        return this.applyColor(`${icon} ${message}`, ANSI.green);
+    }
+    /**
+     * 格式化錯誤訊息
+     */
+    formatError(message) {
+        const icon = this.colorEnabled ? '✗' : '[ERROR]';
+        return this.applyColor(`${icon} ${message}`, ANSI.red);
+    }
+    /**
+     * 格式化警告訊息
+     */
+    formatWarning(message) {
+        const icon = this.colorEnabled ? '⚠' : '[WARN]';
+        return this.applyColor(`${icon} ${message}`, ANSI.yellow);
+    }
+    /**
+     * 格式化資訊訊息
+     */
+    formatInfo(message) {
+        const icon = this.colorEnabled ? 'ℹ' : '[INFO]';
+        return this.applyColor(`${icon} ${message}`, ANSI.cyan);
+    }
+    /**
+     * 格式化淡化文字
+     */
+    formatDim(message) {
+        return this.applyColor(message, ANSI.dim);
+    }
+    /**
+     * 格式化粗體文字
+     */
+    formatBold(message) {
+        return this.applyColor(message, ANSI.bold);
+    }
+    /**
+     * 格式化帶有前綴圖示的訊息
+     */
+    formatWithIcon(icon, message) {
+        return `${icon} ${message}`;
+    }
+    /**
+     * 格式化分隔線
+     */
+    formatDivider(length = 60, char = '─') {
+        return this.applyColor(char.repeat(length), ANSI.dim);
+    }
+    /**
+     * 格式化縮排文字
+     */
+    formatIndent(message, level = 1) {
+        const indent = '  '.repeat(level);
+        return message
+            .split('\n')
+            .map((line) => `${indent}${line}`)
+            .join('\n');
+    }
+    /**
+     * 啟用或停用顏色輸出
+     */
+    setColorEnabled(enabled) {
+        this.colorEnabled = enabled;
+    }
+    /**
+     * 檢查顏色輸出是否啟用
+     */
+    isColorEnabled() {
+        return this.colorEnabled;
+    }
+    // ============================================================================
+    // Private 方法 - 表格格式化輔助方法
+    // ============================================================================
+    /**
+     * 格式化有邊框的表格
+     */
+    formatTableWithBorders(headers, rows, columnWidths, columnAlignments, padding, headerSeparator, statusColumnIndex, colorize, statusColors) {
+        const lines = [];
+        const actualPadding = Math.max(1, padding - 1); // 邊框模式下調整間距
+        // 頂部邊框
+        lines.push(this.drawTopBorder(columnWidths, actualPadding));
+        // 表頭行
+        lines.push(this.formatHeaderRowWithBorders(headers, columnWidths, columnAlignments, actualPadding));
+        // 分隔線
+        if (headerSeparator) {
+            lines.push(this.drawMiddleSeparator(columnWidths, actualPadding));
+        }
+        // 資料行
+        for (const row of rows) {
+            lines.push(this.formatDataRowWithBorders(row, columnWidths, columnAlignments, actualPadding, statusColumnIndex, colorize, statusColors));
+        }
+        // 底部邊框
+        lines.push(this.drawBottomBorder(columnWidths, actualPadding));
+        return lines.join('\n');
+    }
+    /**
+     * 格式化無邊框的表格
+     */
+    formatTableWithoutBorders(headers, rows, columnWidths, columnAlignments, padding, headerSeparator, statusColumnIndex, colorize, statusColors) {
+        const lines = [];
+        // 表頭行
+        lines.push(this.formatHeaderRowWithoutBorders(headers, columnWidths, columnAlignments, padding));
+        // 分隔線
+        if (headerSeparator) {
+            lines.push(this.drawSeparatorWithoutBorders(columnWidths, padding));
+        }
+        // 資料行
+        for (const row of rows) {
+            lines.push(this.formatDataRowWithoutBorders(row, columnWidths, columnAlignments, padding, statusColumnIndex, colorize, statusColors));
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 決定每欄的對齊方式
+     */
+    determineColumnAlignments(headers, rows, options) {
+        if (options?.columnAlignments) {
+            return options.columnAlignments;
+        }
+        const autoAlignNumbers = options?.autoAlignNumbers ?? true;
+        return headers.map((_, colIndex) => {
+            if (!autoAlignNumbers)
+                return 'left';
+            // 檢查此欄是否所有值都是數字
+            const allNumeric = rows.every((row) => colIndex < row.length && this.isNumericValue(row[colIndex]));
+            return allNumeric ? 'right' : 'left';
+        });
+    }
+    /**
+     * 計算每欄的最大寬度
+     */
+    calculateColumnWidths(headers, rows) {
+        const columnWidths = headers.map((h) => h.length);
+        for (const row of rows) {
+            row.forEach((cell, i) => {
+                if (i < columnWidths.length) {
+                    columnWidths[i] = Math.max(columnWidths[i], this.getDisplayLength(cell));
+                }
+            });
+        }
+        return columnWidths;
+    }
+    /**
+     * 繪製頂部邊框 ┌─┬─┐
+     */
+    drawTopBorder(columnWidths, padding) {
+        const border = '┌' + columnWidths
+            .map((w, i) => '─'.repeat(w + padding * 2) + (i < columnWidths.length - 1 ? '┬' : ''))
+            .join('') + '┐';
+        return this.applyColor(border, ANSI.dim);
+    }
+    /**
+     * 繪製中間分隔線 ├─┼─┤
+     */
+    drawMiddleSeparator(columnWidths, padding) {
+        const separator = '├' + columnWidths
+            .map((w, i) => '─'.repeat(w + padding * 2) + (i < columnWidths.length - 1 ? '┼' : ''))
+            .join('') + '┤';
+        return this.applyColor(separator, ANSI.dim);
+    }
+    /**
+     * 繪製底部邊框 └─┴─┘
+     */
+    drawBottomBorder(columnWidths, padding) {
+        const border = '└' + columnWidths
+            .map((w, i) => '─'.repeat(w + padding * 2) + (i < columnWidths.length - 1 ? '┴' : ''))
+            .join('') + '┘';
+        return this.applyColor(border, ANSI.dim);
+    }
+    /**
+     * 格式化表頭行（有邊框）
+     */
+    formatHeaderRowWithBorders(headers, columnWidths, columnAlignments, padding) {
+        const headerCells = headers.map((h, i) => {
+            const cell = ' '.repeat(padding) + this.alignText(h, columnWidths[i], columnAlignments[i] || 'left') + ' '.repeat(padding);
+            return this.applyColor(cell, ANSI.bold);
+        });
+        return this.applyColor('│', ANSI.dim) + headerCells.join(this.applyColor('│', ANSI.dim)) + this.applyColor('│', ANSI.dim);
+    }
+    /**
+     * 格式化資料行（有邊框）
+     */
+    formatDataRowWithBorders(row, columnWidths, columnAlignments, padding, statusColumnIndex, colorize, statusColors) {
+        const formattedCells = row.map((cell, i) => {
+            const width = i < columnWidths.length ? columnWidths[i] : this.getDisplayLength(cell);
+            const alignment = columnAlignments[i] || 'left';
+            const formattedCell = this.formatCellWithStatus(cell, i, statusColumnIndex, colorize, statusColors, width, alignment);
+            return ' '.repeat(padding) + formattedCell + ' '.repeat(padding);
+        });
+        return this.applyColor('│', ANSI.dim) + formattedCells.join(this.applyColor('│', ANSI.dim)) + this.applyColor('│', ANSI.dim);
+    }
+    /**
+     * 格式化表頭行（無邊框）
+     */
+    formatHeaderRowWithoutBorders(headers, columnWidths, columnAlignments, padding) {
+        const headerCells = headers.map((h, i) => this.alignText(h, columnWidths[i], columnAlignments[i] || 'left'));
+        const headerLine = headerCells.map((cell, i) => i < headerCells.length - 1 ? cell + ' '.repeat(padding) : cell).join('');
+        return this.applyColor(headerLine, ANSI.bold);
+    }
+    /**
+     * 格式化資料行（無邊框）
+     */
+    formatDataRowWithoutBorders(row, columnWidths, columnAlignments, padding, statusColumnIndex, colorize, statusColors) {
+        const formattedCells = row.map((cell, i) => {
+            const width = i < columnWidths.length ? columnWidths[i] : this.getDisplayLength(cell);
+            const alignment = columnAlignments[i] || 'left';
+            return this.formatCellWithStatus(cell, i, statusColumnIndex, colorize, statusColors, width, alignment);
+        });
+        const rowLine = formattedCells.map((cell, i) => i < formattedCells.length - 1 ? cell + ' '.repeat(padding) : cell).join('');
+        return rowLine;
+    }
+    /**
+     * 繪製無邊框分隔線
+     */
+    drawSeparatorWithoutBorders(columnWidths, padding) {
+        const separator = columnWidths
+            .map((w, i) => i < columnWidths.length - 1 ? '─'.repeat(w + padding) : '─'.repeat(w))
+            .join('');
+        return this.applyColor(separator, ANSI.dim);
+    }
+    /**
+     * 格式化帶狀態顏色的儲存格
+     */
+    formatCellWithStatus(cell, columnIndex, statusColumnIndex, colorize, statusColors, width, alignment) {
+        // 狀態欄位顏色編碼
+        if (colorize && columnIndex === statusColumnIndex && this.colorEnabled) {
+            const colorName = statusColors[cell];
+            if (colorName) {
+                const colorCode = this.getColorCode(colorName);
+                if (colorCode) {
+                    const coloredCell = this.applyColor(cell, colorCode);
+                    return this.alignText(coloredCell, width, alignment);
+                }
+            }
+        }
+        return this.alignText(cell, width, alignment);
+    }
+};
+exports.OutputFormatter = OutputFormatter;
+exports.OutputFormatter = OutputFormatter = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], OutputFormatter);
+//# sourceMappingURL=output-formatter.service.js.map

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@uofx/cli",
+  "version": "1.0.0",
+  "description": "CLI tool for installing and managing the UOFX development environment on WSL",
+  "main": "dist/index.js",
+  "bin": {
+    "uofx": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=18.20.0"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "build": "tsc -p tsconfig.prod.json && tsc-alias -p tsconfig.prod.json",
+    "build:prod": "tsc -p tsconfig.prod.json && tsc-alias -p tsconfig.prod.json && javascript-obfuscator dist --output dist --config obfuscator.config.js --exclude '**/di/tokens.js'",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "UOF X"
+  ],
+  "author": "e-Excellence Inc.",
+  "license": "SEE LICENSE IN LICENSE",
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.ts",
+    "README.md",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.txt"
+  ],
+  "devDependencies": {
+    "@types/cli-progress": "^3.11.6",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^18.19.0",
+    "@types/prompts": "^2.4.9",
+    "@types/semver": "^7.7.1",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^10.1.8",
+    "generate-license-file": "^3.8.1",
+    "javascript-obfuscator": "4.1.1",
+    "jest": "^29.7.0",
+    "jest-junit": "^16.0.0",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.4.5",
+    "tsc-alias": "^1.8.16",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "axios": "^1.13.2",
+    "chalk": "^4.1.2",
+    "cli-progress": "^3.12.0",
+    "commander": "^12.1.0",
+    "prompts": "^2.4.2",
+    "reflect-metadata": "^0.2.2",
+    "semver": "^7.7.3",
+    "tsyringe": "^4.10.0"
+  }
+}