@uofx/cli 1.0.2 → 1.1.0

package/dist/application/dtos/logs/response/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./show-logs.response.dto"), exports);
+//# sourceMappingURL=index.js.map

package/dist/application/index.js

@@ -22,4 +22,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./use-cases"), exports);
 __exportStar(require("./dtos"), exports);
 __exportStar(require("./interfaces"), exports);
+__exportStar(require("./services"), exports);
 //# sourceMappingURL=index.js.map

package/dist/application/services/env/environment-validator.service.js

@@ -0,0 +1,120 @@
+"use strict";
+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.EnvironmentValidator = void 0;
+const tsyringe_1 = require("tsyringe");
+const errors_1 = require("../../../domain/errors");
+const runtime_environment_port_1 = require("../../../domain/ports/runtime-environment.port");
+const tokens_1 = require("../../../di/tokens");
+/**
+ * 環境驗證服務
+ *
+ * 負責安裝前的環境檢查，包含：
+ * - WSL 安裝狀態驗證
+ * - 記憶體可用性檢查
+ * - 運行中實例檢查
+ */
+let EnvironmentValidator = class EnvironmentValidator {
+    constructor(instanceManager, runtimeEnvironment, userInteraction) {
+        this.instanceManager = instanceManager;
+        this.runtimeEnvironment = runtimeEnvironment;
+        this.userInteraction = userInteraction;
+    }
+    /**
+     * 檢查 WSL 是否已安裝
+     * @param output - 輸出介面
+     * @throws AppError 若 WSL 未安裝
+     */
+    async checkWslInstalled(output) {
+        output?.section('[1/14] Checking WSL installation').flush();
+        output?.item('arrow', 'Verifying runtime environment...').flush();
+        const runtimeInfo = await this.runtimeEnvironment.getRuntimeInfo();
+        if (!runtimeInfo.isInstalled) {
+            throw new errors_1.AppError(`${runtimeInfo.type} is not installed on this system`, {
+                exitCode: errors_1.EXIT_CODES.ENVIRONMENT_ERROR,
+                solution: 'Please install WSL first. Run: uofx env setup',
+            });
+        }
+        output?.success(`${runtimeInfo.type} is installed (${runtimeInfo.version})`).flush();
+    }
+    /**
+     * 檢查記憶體可用性
+     * 綜合考量系統剩餘記憶體、WSL 限制、WSL 目前使用量
+     * @param output - 輸出介面
+     * @throws AppError 若記憶體不足且使用者取消
+     */
+    async checkMemoryAvailability(output) {
+        output?.section('[2/14] Checking remaining memory').flush();
+        const memoryInfo = await this.runtimeEnvironment.getMemoryAvailability();
+        // 顯示詳細資訊
+        for (const detail of memoryInfo.details) {
+            const suffix = detail.suffix ? ` (${detail.suffix})` : '';
+            output?.item('bullet', `${detail.label}: ${detail.valueGB.toFixed(2)} GB${suffix}`).flush();
+        }
+        if (memoryInfo.availableGB < runtime_environment_port_1.UOFX_REQUIRED_MEMORY_GB) {
+            output?.newline().flush();
+            output?.warning(`Available memory (${memoryInfo.availableGB.toFixed(2)} GB) is below recommended ${runtime_environment_port_1.UOFX_REQUIRED_MEMORY_GB} GB`).flush();
+            output?.info('Insufficient memory may cause:').flush();
+            output?.item('bullet', 'Kubernetes pods failing to start').flush();
+            output?.item('bullet', 'Services becoming unresponsive or crashing').flush();
+            output?.newline().flush();
+            const shouldContinue = await this.userInteraction.confirm('Do you want to continue installation anyway?', false);
+            if (!shouldContinue) {
+                throw new errors_1.AppError('Installation cancelled due to insufficient memory', {
+                    exitCode: errors_1.EXIT_CODES.BUSINESS_ERROR,
+                    solution: 'Close other applications or increase memory available for the runtime environment'
+                });
+            }
+        }
+        else {
+            output?.success('Memory check passed').flush();
+        }
+    }
+    /**
+     * 確保沒有其他實例正在運行
+     * 安裝新實例前必須停止所有現有實例
+     * @param output - 輸出介面
+     * @throws AppError 若有運行中的實例
+     */
+    async ensureNoRunningInstances(output) {
+        output?.section('[4/14] Checking for running instances').flush();
+        output?.item('arrow', 'Scanning running instances...').flush();
+        const runningInstances = await this.instanceManager.listRunningInstances();
+        if (runningInstances.length > 0) {
+            // 將全名轉換為顯示名稱（移除 uofx- 前綴）
+            const displayNames = runningInstances.map(name => name.replace('uofx-', ''));
+            const instanceList = displayNames
+                .map(name => `  - ${name}`)
+                .join('\n');
+            const stopCommand = displayNames.length === 1
+                ? `uofx env stop --name ${displayNames[0]}`
+                : 'uofx env stop --name <instance-name>';
+            throw new errors_1.AppError(`Cannot install: ${runningInstances.length} instance(s) currently running:\n${instanceList}`, {
+                exitCode: errors_1.EXIT_CODES.BUSINESS_ERROR,
+                solution: `Stop all running instances before installing a new one.\nRun: ${stopCommand}`,
+                context: { runningInstances }
+            });
+        }
+        output?.success('No running instances detected').flush();
+    }
+};
+exports.EnvironmentValidator = EnvironmentValidator;
+exports.EnvironmentValidator = EnvironmentValidator = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IInstanceManagerPort)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IRuntimeEnvironmentPort)),
+    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.IUserInteractionPort)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], EnvironmentValidator);
+//# sourceMappingURL=environment-validator.service.js.map

package/dist/application/services/env/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceCleanupService = exports.EnvironmentValidator = void 0;
+/**
+ * Application Services - Env 模組匯出
+ */
+var environment_validator_service_1 = require("./environment-validator.service");
+Object.defineProperty(exports, "EnvironmentValidator", { enumerable: true, get: function () { return environment_validator_service_1.EnvironmentValidator; } });
+var instance_cleanup_service_1 = require("./instance-cleanup.service");
+Object.defineProperty(exports, "InstanceCleanupService", { enumerable: true, get: function () { return instance_cleanup_service_1.InstanceCleanupService; } });
+//# sourceMappingURL=index.js.map

package/dist/application/services/env/instance-cleanup.service.js

@@ -0,0 +1,79 @@
+"use strict";
+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.InstanceCleanupService = void 0;
+const tsyringe_1 = require("tsyringe");
+const errors_1 = require("../../../domain/errors");
+const tokens_1 = require("../../../di/tokens");
+/**
+ * 實例清理服務
+ *
+ * 負責安裝失敗時的清理工作，包含：
+ * - 停止運行中的實例
+ * - 刪除不完整的實例
+ * - 刪除對應的 metadata
+ */
+let InstanceCleanupService = class InstanceCleanupService {
+    constructor(instanceManager, instanceStorage) {
+        this.instanceManager = instanceManager;
+        this.instanceStorage = instanceStorage;
+    }
+    /**
+     * 清理失敗的安裝
+     * 用於安裝中斷時的清理
+     * @param instanceName - 實例名稱
+     * @param output - 輸出介面
+     */
+    async cleanupFailedInstallation(instanceName, output) {
+        output?.item('arrow', `Removing incomplete instance: ${instanceName.toString()}`).flush();
+        try {
+            // 嘗試停止實體（如果正在運行）
+            const status = await this.instanceManager.getStatus(instanceName);
+            if (status.isRunning) {
+                output?.indent().item('arrow', 'Stopping instance...').outdent().flush();
+                await this.instanceManager.stop(instanceName, true);
+                output?.indent().success('Instance stopped').outdent().flush();
+            }
+        }
+        catch (error) {
+            output?.indent().warning(`Failed to stop instance: ${(0, errors_1.formatErrorMessage)(error)}`).outdent().flush();
+        }
+        try {
+            // 刪除實體
+            output?.indent().item('arrow', 'Deleting instance...').outdent().flush();
+            await this.instanceManager.delete(instanceName);
+            output?.indent().success('Instance deleted').outdent().flush();
+        }
+        catch (error) {
+            output?.indent().warning(`Failed to delete instance: ${(0, errors_1.formatErrorMessage)(error)}`).outdent().flush();
+        }
+        try {
+            // 刪除 metadata
+            output?.indent().item('arrow', 'Deleting metadata...').outdent().flush();
+            await this.instanceStorage.deleteInstance(instanceName);
+            output?.indent().success('Metadata deleted').outdent().flush();
+        }
+        catch (error) {
+            output?.indent().warning(`Failed to delete metadata: ${(0, errors_1.formatErrorMessage)(error)}`).outdent().flush();
+        }
+    }
+};
+exports.InstanceCleanupService = InstanceCleanupService;
+exports.InstanceCleanupService = InstanceCleanupService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IInstanceManagerPort)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IInstanceStoragePort)),
+    __metadata("design:paramtypes", [Object, Object])
+], InstanceCleanupService);
+//# sourceMappingURL=instance-cleanup.service.js.map

package/dist/application/services/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Application Services 匯出
+ */
+__exportStar(require("./env"), exports);
+//# sourceMappingURL=index.js.map

package/dist/application/use-cases/config/get-all-config.use-case.js

@@ -0,0 +1,54 @@
+"use strict";
+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.GetAllConfigUseCase = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../di/tokens");
+/**
+ * 取得所有配置 Use Case
+ *
+ * 使用 IAppConfigPort 讀取合併後的完整配置
+ * （default.json + ~/.uofx/config.json）
+ */
+let GetAllConfigUseCase = class GetAllConfigUseCase {
+    constructor(appConfigPort) {
+        this.appConfigPort = appConfigPort;
+    }
+    /**
+     * 取得所有配置
+     * @returns 完整配置資料
+     */
+    async execute() {
+        // 取得合併後的完整配置
+        const config = this.appConfigPort.getConfig();
+        // 取得 ACR credentials
+        const acrCreds = this.appConfigPort.getAcrCredentials();
+        return {
+            logLevel: config.logLevel,
+            defaultAcrCredentials: acrCreds
+                ? {
+                    name: acrCreds.name,
+                    account: acrCreds.account,
+                }
+                : null,
+        };
+    }
+};
+exports.GetAllConfigUseCase = GetAllConfigUseCase;
+exports.GetAllConfigUseCase = GetAllConfigUseCase = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.IAppConfigPort)),
+    __metadata("design:paramtypes", [Object])
+], GetAllConfigUseCase);
+//# sourceMappingURL=get-all-config.use-case.js.map

package/dist/application/use-cases/config/get-config.use-case.js

@@ -16,15 +16,20 @@ exports.GetConfigUseCase = void 0;
 const tsyringe_1 = require("tsyringe");
 const tokens_1 = require("../../../di/tokens");
 /**
- * 取得配置 Use Case
+ * 取得單一配置 Use Case
  *
  * 使用 IAppConfigPort 讀取合併後的配置
- * （default.json + ~/.uofx/config.json）
+ * 支援 dot notation 查詢（如 'acr.name'）
  */
 let GetConfigUseCase = class GetConfigUseCase {
     constructor(appConfigPort) {
         this.appConfigPort = appConfigPort;
     }
+    /**
+     * 取得指定 key 的配置值
+     * @param request - 包含要查詢的 key
+     * @returns 配置值，找不到時返回 null
+     */
     async execute(request) {
         const { key } = request;
         const config = this.appConfigPort.getConfig();
@@ -41,21 +46,6 @@ let GetConfigUseCase = class GetConfigUseCase {
         }
         return value;
     }
-    async getAll() {
-        // 取得合併後的完整配置
-        const config = this.appConfigPort.getConfig();
-        // 取得 ACR credentials
-        const acrCreds = this.appConfigPort.getAcrCredentials();
-        return {
-            logLevel: config.logLevel,
-            defaultAcrCredentials: acrCreds
-                ? {
-                    name: acrCreds.name,
-                    account: acrCreds.account,
-                }
-                : null,
-        };
-    }
 };
 exports.GetConfigUseCase = GetConfigUseCase;
 exports.GetConfigUseCase = GetConfigUseCase = __decorate([

package/dist/application/use-cases/config/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Config 指令群組 Use Cases
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./get-config.use-case"), exports);
+__exportStar(require("./get-all-config.use-case"), exports);
+__exportStar(require("./set-config.use-case"), exports);
+//# sourceMappingURL=index.js.map

package/dist/application/use-cases/config/set-config.use-case.js

@@ -15,23 +15,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SetConfigUseCase = void 0;
 const tsyringe_1 = require("tsyringe");
 const tokens_1 = require("../../../di/tokens");
+const errors_1 = require("../../../domain/errors");
 const acr_credentials_value_object_1 = require("../../../domain/value-objects/acr-credentials.value-object");
 const config_log_level_value_object_1 = require("../../../domain/value-objects/config-log-level.value-object");
 /**
  * 設定配置 Use Case
  *
  * 使用 IUserSettingsPort 寫入使用者配置到 ~/.uofx/config.json
+ * 包含輸入驗證邏輯（logLevel 有效性、ACR 憑證完整性、無變更檢查）
  */
 let SetConfigUseCase = class SetConfigUseCase {
     constructor(userSettings) {
         this.userSettings = userSettings;
     }
+    /**
+     * 執行設定配置
+     * @param request - 設定請求
+     * @throws AppError 當驗證失敗時
+     */
     async execute(request) {
+        // 驗證是否有任何配置變更
+        this.validateHasChanges(request);
+        // 驗證 ACR credentials 完整性
+        this.validateAcrCredentials(request);
         // 處理 logLevel
         if (request.logLevel !== undefined) {
-            // 使用 Value Object 驗證並轉換
-            const logLevel = config_log_level_value_object_1.ConfigLogLevelValue.create(request.logLevel);
-            await this.userSettings.setLogLevel(logLevel.toConfigType());
+            this.setLogLevel(request.logLevel);
         }
         // 處理 ACR credentials
         if (request.acrName && request.acrAccount && request.acrPassword) {
@@ -39,6 +48,43 @@ let SetConfigUseCase = class SetConfigUseCase {
             await this.userSettings.saveAcrCredentials(credentials);
         }
     }
+    /**
+     * 驗證是否有任何配置變更
+     */
+    validateHasChanges(request) {
+        const hasLogLevel = request.logLevel !== undefined;
+        const hasAcr = !!(request.acrName || request.acrAccount || request.acrPassword);
+        if (!hasLogLevel && !hasAcr) {
+            throw new errors_1.AppError('No configuration changes specified', {
+                exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+            });
+        }
+    }
+    /**
+     * 驗證 ACR 憑證完整性（三個欄位必須同時提供）
+     */
+    validateAcrCredentials(request) {
+        const hasAny = !!(request.acrName || request.acrAccount || request.acrPassword);
+        const hasAll = !!(request.acrName && request.acrAccount && request.acrPassword);
+        if (hasAny && !hasAll) {
+            throw new errors_1.AppError('ACR credentials require all three: --acr.name, --acr.account, --acr.password', { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
+        }
+    }
+    /**
+     * 驗證並設定 logLevel
+     */
+    setLogLevel(level) {
+        try {
+            const logLevel = config_log_level_value_object_1.ConfigLogLevelValue.create(level);
+            this.userSettings.setLogLevel(logLevel.toConfigType());
+        }
+        catch (error) {
+            throw new errors_1.AppError(`Invalid log level: "${level}". Valid values: ${config_log_level_value_object_1.ConfigLogLevelValue.VALID_LEVELS.join(', ')}`, {
+                exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
 };
 exports.SetConfigUseCase = SetConfigUseCase;
 exports.SetConfigUseCase = SetConfigUseCase = __decorate([

package/dist/application/use-cases/dev/generate-component.use-case.js

@@ -0,0 +1,138 @@
+"use strict";
+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.GenerateComponentUseCase = void 0;
+/**
+ * Generate Component Use Case
+ *
+ * 透過 @uofx/plugin-schematics 產生 Plugin 元件
+ */
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../di/tokens");
+const errors_1 = require("../../../domain/errors");
+/** 支援的 schematic 類型 */
+const SUPPORTED_TYPES = [
+    'field',
+    'mobile-field',
+    'admin-panel',
+    'user-panel',
+    'mobile-panel',
+    'admin-page',
+    'user-page',
+    'mobile-page',
+];
+/** 支援 --code 選項的類型清單 */
+const TYPES_SUPPORTING_CODE = [
+    'field',
+    'mobile-field',
+    'admin-panel',
+    'user-panel',
+    'mobile-panel',
+];
+/** 各 page 類型支援的 layout 清單 */
+const VALID_PAGE_LAYOUTS = {
+    'admin-page': ['basic', 'container', 'sider', 'tab'],
+    'user-page': ['basic', 'full', 'tab'],
+    'mobile-page': ['basic', 'tab'],
+};
+let GenerateComponentUseCase = class GenerateComponentUseCase {
+    constructor(schematicsRunner, logger) {
+        this.schematicsRunner = schematicsRunner;
+        this.logger = logger;
+    }
+    /**
+     * 執行元件產生流程
+     * @param request - 元件產生請求參數
+     * @param output - 輸出端口，用於回報進度
+     * @returns 元件產生結果
+     */
+    async execute(request, output) {
+        this.logger.debug('Generating component...', { request });
+        // 驗證類型
+        if (!SUPPORTED_TYPES.includes(request.type)) {
+            const msg = `Unsupported component type: "${request.type}". Supported types: ${SUPPORTED_TYPES.join(', ')}`;
+            output?.error(msg).flush();
+            return { success: false, message: msg };
+        }
+        // 驗證 layout（pageType）合法性
+        if (request.pageType) {
+            const validLayouts = VALID_PAGE_LAYOUTS[request.type];
+            if (!validLayouts) {
+                throw new errors_1.AppError(`Component type "${request.type}" does not support --layout option`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
+            }
+            if (!validLayouts.includes(request.pageType)) {
+                throw new errors_1.AppError(`Invalid layout "${request.pageType}" for type "${request.type}". Valid layouts: ${validLayouts.join(', ')}`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
+            }
+        }
+        // 使用當前目錄作為 ClientApp 路徑
+        const clientAppPath = process.cwd();
+        // 組裝額外參數
+        const extraArgs = {};
+        // --code 僅 field/mobile-field/panel 類型支援，page 類型靜默忽略
+        if (request.code && TYPES_SUPPORTING_CODE.includes(request.type)) {
+            extraArgs['code'] = request.code;
+        }
+        // --group 僅 field 類型支援，其他類型靜默忽略
+        if (request.group && request.type === 'field') {
+            extraArgs['group'] = request.group;
+        }
+        if (request.displayName) {
+            extraArgs['display-name'] = request.displayName;
+        }
+        if (request.pageType) {
+            extraArgs['type'] = request.pageType;
+        }
+        if (request.funcId) {
+            extraArgs['func-id'] = request.funcId;
+        }
+        // Field 專屬選項：僅在 type === 'field' 時傳遞
+        if (request.type === 'field') {
+            if (request.design === false)
+                extraArgs['design'] = false;
+            if (request.print === false)
+                extraArgs['print'] = false;
+            if (request.view === false)
+                extraArgs['view'] = false;
+        }
+        // 執行 schematics
+        output
+            ?.section(`Generating ${request.type}: ${request.name}`)
+            .flush();
+        if (request.dryRun) {
+            output?.info('Running in dry-run mode (no files will be written)').flush();
+        }
+        const result = await this.schematicsRunner.run({
+            projectPath: clientAppPath,
+            schematicName: request.type,
+            componentName: request.name,
+            extraArgs,
+            dryRun: request.dryRun || false,
+        }, output);
+        if (result.success && !request.dryRun) {
+            output?.newline().success('Component generated successfully!').flush();
+        }
+        return {
+            success: result.success,
+            message: result.message,
+        };
+    }
+};
+exports.GenerateComponentUseCase = GenerateComponentUseCase;
+exports.GenerateComponentUseCase = GenerateComponentUseCase = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.ISchematicsRunnerPort)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __metadata("design:paramtypes", [Object, Object])
+], GenerateComponentUseCase);
+//# sourceMappingURL=generate-component.use-case.js.map

package/dist/application/use-cases/dev/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Dev Use Cases
+ *
+ * 開發工具相關的 Use Cases
+ */
+__exportStar(require("./install-template.use-case"), exports);
+__exportStar(require("./list-templates.use-case"), exports);
+__exportStar(require("./uninstall-template.use-case"), exports);
+__exportStar(require("./new-project.use-case"), exports);
+__exportStar(require("./generate-component.use-case"), exports);
+__exportStar(require("./publish-plugin.use-case"), exports);
+//# sourceMappingURL=index.js.map