@farris/cli 2.1.1 → 2.1.3

package/lib/commands/workspace/create.js

@@ -1,380 +1,380 @@
-import { resolve, join } from 'node:path';
-import { existsSync, mkdirSync } from 'node:fs';
-import { spawn } from 'node:child_process';
-import inquirer from 'inquirer';
-import { DEFAULT_CATALOG_VERSIONS, CLI_VERSION, ExitCode, } from '../../common/constant.js';
-import { inspectTarget, checkPlannedConflicts } from '../../common/safety.js';
-import { collectTemplateOutputPaths, renderTemplateDir } from '../../common/template-renderer.js';
-import { Transaction } from '../../common/transaction.js';
-import { verifyWorkspace } from '../../common/verifier.js';
-import { sendJson, logInfo, logWarn, fail, setJsonMode, createSpinner } from '../../common/output.js';
-import { getDirname } from '../../common/constant.js';
-/**
- * 从包名推导目录名（去掉 scope 并转为合法 kebab-case）
- */
-export function deriveAppDir(name) {
-    const withoutScope = name.replace(/^@[^/]+\//, '');
-    return withoutScope
-        .toLowerCase()
-        .replace(/[^a-z0-9-_]/g, '-')
-        .replace(/^-+|-+$/g, '');
-}
-/**
- * 校验 npm 包名有效性
- */
-export function validatePackageName(name) {
-    if (!name || typeof name !== 'string') {
-        return false;
-    }
-    return /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name);
-}
-/**
- * 执行 pnpm install 安装依赖
- */
-export function runPnpmInstall(targetDir, isJson = false) {
-    return new Promise((resolve) => {
-        const child = spawn('pnpm', ['install'], {
-            cwd: targetDir,
-            shell: true,
-            stdio: isJson ? ['ignore', 'pipe', 'pipe'] : 'inherit'
-        });
-        let stderrData = '';
-        if (isJson && child.stderr) {
-            child.stderr.on('data', (chunk) => {
-                stderrData += chunk.toString();
-                process.stderr.write(chunk);
-            });
-        }
-        child.on('close', (code) => {
-            if (code === 0) {
-                resolve({ success: true });
-            }
-            else {
-                resolve({ success: false, error: `pnpm install 退出码: ${code}` });
-            }
-        });
-        child.on('error', (err) => {
-            resolve({ success: false, error: err.message });
-        });
-    });
-}
-/* eslint-disable complexity */
-export async function createWorkspace(target = '.', options = {}) {
-    const isJson = !!options.json;
-    setJsonMode(isJson);
-    const inspect = inspectTarget(target);
-    if (!inspect.canCreate) {
-        fail({
-            command: 'workspace.create',
-            error: `目标目录无法创建 Workspace，状态: ${inspect.status}。${inspect.conflicts.length > 0 ? `冲突项: ${inspect.conflicts.join(', ')}` : ''}`,
-            exitCode: ExitCode.TARGET_CONFLICT,
-            extra: { status: inspect.status, conflicts: inspect.conflicts }
-        });
-    }
-    let { name, title, appDir } = options;
-    let router = options.router ?? false;
-    let routerMode = options.routerMode || 'hash';
-    let format = options.format || 'es';
-    let style = options.style || 'css';
-    let install = options.install ?? false;
-    // 非 JSON 模式下若缺失必填项，进行交互询问
-    if (!isJson && !options.yes && !name) {
-        const prompt = inquirer.createPromptModule();
-        const answers = await prompt([
-            {
-                type: 'input',
-                name: 'name',
-                message: '请输入应用名称 (package name):',
-                default: 'my-app',
-                validate: (input) => (validatePackageName(input) ? true : '请输入合法的 npm 包名 (如 my-app 或 @scope/my-app)')
-            },
-            {
-                type: 'input',
-                name: 'title',
-                message: '请输入展示标题 (title):',
-                default: (ans) => ans.name
-            },
-            {
-                type: 'confirm',
-                name: 'router',
-                message: '是否启用 Vue Router?',
-                default: false
-            },
-            {
-                type: 'list',
-                name: 'routerMode',
-                message: '选择路由模式:',
-                choices: ['hash', 'history'],
-                default: 'hash',
-                when: (ans) => ans.router
-            },
-            {
-                type: 'list',
-                name: 'style',
-                message: '选择应用样式方案:',
-                choices: ['css', 'scss', 'none'],
-                default: 'css'
-            },
-            {
-                type: 'list',
-                name: 'format',
-                message: '选择交付格式:',
-                choices: ['es', 'systemjs'],
-                default: 'es'
-            },
-            {
-                type: 'confirm',
-                name: 'install',
-                message: '是否在创建完成后自动安装依赖 (pnpm install)?',
-                default: false
-            }
-        ]);
-        ({ name } = answers);
-        title = answers.title || name;
-        router = !!answers.router;
-        if (answers.routerMode) {
-            ({ routerMode } = answers);
-        }
-        if (answers.style) {
-            ({ style } = answers);
-        }
-        if (answers.format) {
-            ({ format } = answers);
-        }
-        if (answers.install !== undefined) {
-            install = !!answers.install;
-        }
-    }
-    if (!name) {
-        fail({
-            command: 'workspace.create',
-            error: '必须指定应用名称 (--name <name>)',
-            exitCode: ExitCode.GENERAL_ERROR
-        });
-    }
-    if (!validatePackageName(name)) {
-        fail({
-            command: 'workspace.create',
-            error: `非法的应用包名: "${name}"`,
-            exitCode: ExitCode.GENERAL_ERROR
-        });
-    }
-    title = title || name;
-    appDir = appDir || deriveAppDir(name);
-    if (!appDir || !/^[a-z0-9-_]+$/.test(appDir)) {
-        fail({
-            command: 'workspace.create',
-            error: `非法的子目录名: "${appDir}"，仅支持小写字母、数字、短横线与下划线`,
-            exitCode: ExitCode.GENERAL_ERROR
-        });
-    }
-    const targetDir = inspect.target;
-    const templatesBase = resolve(getDirname(import.meta.url), '../../../templates/workspace');
-    const rootTemplateDir = join(templatesBase, 'root');
-    const appTemplateDir = join(templatesBase, 'app');
-    const rootVariables = {
-        pnpmVersion: DEFAULT_CATALOG_VERSIONS['pnpm'] || '9.15.4',
-        farrisUiVueVersion: DEFAULT_CATALOG_VERSIONS['@farris/ui-vue'] || '1.8.3',
-        farrisCliVersion: CLI_VERSION,
-        typescriptVersion: DEFAULT_CATALOG_VERSIONS['typescript'] || '5.7.3',
-        viteVersion: DEFAULT_CATALOG_VERSIONS['vite'] || '5.4.19',
-        vueVersion: DEFAULT_CATALOG_VERSIONS['vue'] || '3.5.13',
-        vueRouterVersion: DEFAULT_CATALOG_VERSIONS['vue-router'] || '4.5.0',
-        vueTscVersion: DEFAULT_CATALOG_VERSIONS['vue-tsc'] || '2.2.0',
-        sassVersion: DEFAULT_CATALOG_VERSIONS['sass'] || '1.90.0',
-        title,
-        appDir,
-        appName: name
-    };
-    const appTargetDir = join(targetDir, 'packages', appDir);
-    // 组装条件变量
-    const routerDependency = router ? ',\n    "vue-router": "catalog:"' : '';
-    const sassDevDependency = style === 'scss' ? ',\n    "sass": "catalog:"' : '';
-    let styleImport = '';
-    if (style === 'css') {
-        styleImport = "\nimport './styles/index.css';";
-    }
-    else if (style === 'scss') {
-        styleImport = "\nimport './styles/index.scss';";
-    }
-    const routerImport = router ? "\nimport router from './router';" : '';
-    const routerUse = router ? '\napp.use(router);' : '';
-    // 模板保留扩展点，但通用 CLI 不再内置 i18n 运行时契约。
-    const i18nImport = '';
-    const i18nUse = '';
-    const appRouterImport = router ? "\nimport { RouterView } from 'vue-router';" : '';
-    const appTemplateBody = router
-        ? '        <RouterView />'
-        : `        <h1>{${JSON.stringify(title)}}</h1>`;
-    const appVariables = {
-        appName: name,
-        title,
-        appDir,
-        base: './',
-        routerMode: router ? routerMode : 'none',
-        format,
-        routerDependency,
-        sassDevDependency,
-        styleImport,
-        routerImport,
-        routerUse,
-        i18nImport,
-        i18nUse,
-        appRouterImport,
-        appTemplateBody,
-        routerHistoryFunction: routerMode === 'history' ? 'createWebHistory' : 'createWebHashHistory',
-        routerHistoryCall: routerMode === 'history'
-            ? 'createWebHistory(import.meta.env.BASE_URL)'
-            : 'createWebHashHistory()'
-    };
-    // 模板文件过滤规则
-    const appFilter = (relPath) => {
-        const normalized = relPath.replace(/\\/g, '/');
-        // 样式过滤
-        if (style === 'none' && normalized.startsWith('src/styles')) {
-            return false;
-        }
-        if (style === 'css' && (normalized === 'src/styles/index.scss' || normalized === 'src/styles/index.scss.tpl')) {
-            return false;
-        }
-        if (style === 'scss' && (normalized === 'src/styles/index.css' || normalized === 'src/styles/index.css.tpl')) {
-            return false;
-        }
-        // Router 与 Views 过滤
-        if (!router) {
-            if (normalized.startsWith('src/router') || normalized.startsWith('src/views')) {
-                return false;
-            }
-        }
-        return true;
-    };
-    const plannedRelativeFiles = [
-        ...collectTemplateOutputPaths(rootTemplateDir),
-        ...collectTemplateOutputPaths(appTemplateDir, appFilter).map((path) => join('packages', appDir, path))
-    ];
-    const conflicts = checkPlannedConflicts(targetDir, plannedRelativeFiles);
-    if (conflicts.length > 0 && !options.force) {
-        const shouldOverwrite = !isJson &&
-            !options.yes &&
-            (await inquirer.createPromptModule()([
-                {
-                    type: 'confirm',
-                    name: 'overwrite',
-                    message: `以下 ${conflicts.length} 个文件已存在，是否覆盖？\n${conflicts.join('\n')}`,
-                    default: false
-                }
-            ])).overwrite;
-        if (!shouldOverwrite) {
-            fail({
-                command: 'workspace.create',
-                error: `目标目录包含将被模板写入的文件: ${conflicts.join(', ')}。请交互确认，或显式传入 --force 覆盖。`,
-                exitCode: ExitCode.TARGET_CONFLICT,
-                extra: { conflicts }
-            });
-        }
-    }
-    const transaction = new Transaction();
-    plannedRelativeFiles.forEach((path) => transaction.prepareWrite(join(targetDir, path)));
-    const spinner = createSpinner('正在生成 Workspace 工程模板...');
-    spinner.start();
-    try {
-        if (!existsSync(targetDir)) {
-            mkdirSync(targetDir, { recursive: true });
-            transaction.recordCreatedDir(targetDir);
-        }
-        // 1. 渲染根目录模板
-        const rootRender = renderTemplateDir({
-            sourceDir: rootTemplateDir,
-            targetDir,
-            variables: rootVariables,
-            skipExisting: false
-        });
-        if (rootRender.unreplacedPlaceholders.length > 0) {
-            throw new Error(`根模板渲染出现未替换占位符: ${rootRender.unreplacedPlaceholders.map((p) => `${p.file} (${p.placeholder})`).join(', ')}`);
-        }
-        // 2. 渲染子应用目录 (packages/<appDir>/)
-        mkdirSync(appTargetDir, { recursive: true });
-        transaction.recordCreatedDir(appTargetDir);
-        const appRender = renderTemplateDir({
-            sourceDir: appTemplateDir,
-            targetDir: appTargetDir,
-            variables: appVariables,
-            skipExisting: false,
-            filter: appFilter
-        });
-        if (appRender.unreplacedPlaceholders.length > 0) {
-            throw new Error(`应用模板渲染出现未替换占位符: ${appRender.unreplacedPlaceholders.map((p) => `${p.file} (${p.placeholder})`).join(', ')}`);
-        }
-        // 3. 执行 Verify
-        const verifyResult = verifyWorkspace(targetDir, inspect.preservedInputEntries);
-        if (!verifyResult.ok) {
-            throw new Error(`Workspace 校验失败: ${verifyResult.errors.join('; ')}`);
-        }
-        // 4. 提交事务
-        transaction.commit();
-        spinner.succeed('Workspace 工程生成并校验通过！');
-        // 5. 若启用 --install，自动执行依赖安装
-        let installed = false;
-        let installError;
-        if (install) {
-            const installSpinner = createSpinner('正在安装依赖 (pnpm install)...');
-            installSpinner.start();
-            const installRes = await runPnpmInstall(targetDir, isJson);
-            if (installRes.success) {
-                installed = true;
-                installSpinner.succeed('依赖安装成功！');
-            }
-            else {
-                installed = false;
-                installError = installRes.error;
-                installSpinner.fail('依赖安装失败');
-                logWarn(`\n提示: 依赖安装出现异常 (${installError})，您可以稍后进入目录手动执行 "pnpm install"`);
-            }
-        }
-        const allCreated = [...rootRender.filesCreated, ...appRender.filesCreated];
-        if (isJson) {
-            sendJson({
-                command: 'workspace.create',
-                ok: true,
-                target: targetDir,
-                appDir,
-                appName: name,
-                title,
-                router,
-                routerMode: router ? routerMode : 'none',
-                format,
-                style,
-                installed,
-                ...(installError ? { installError } : {}),
-                filesCreated: allCreated,
-                preservedInputVerified: inspect.preservedInputEntries.length > 0
-            });
-            return;
-        }
-        logInfo(`\n✨ Workspace 已就绪: ${targetDir}`);
-        logInfo(`- 应用: ${name} (目录: packages/${appDir})`);
-        logInfo(`- 路由: ${router ? routerMode : '未启用'}`);
-        logInfo(`- 样式: ${style}`);
-        logInfo(`- 交付格式: ${format}`);
-        logInfo(`- 依赖安装: ${installed ? '已完成' : '未执行 (可通过 pnpm install 安装)'}`);
-        logInfo('\n下一步 (Next Steps):');
-        logInfo(`  1. cd ${target}`);
-        if (!installed) {
-            logInfo('  2. pnpm install');
-            logInfo(`  3. pnpm --filter "${name}" dev\n`);
-        }
-        else {
-            logInfo(`  2. pnpm --filter "${name}" dev\n`);
-        }
-    }
-    catch (err) {
-        spinner.fail('Workspace 生成失败，正在回滚...');
-        transaction.rollback();
-        fail({
-            command: 'workspace.create',
-            error: `生成 Workspace 失败: ${err.message}`,
-            exitCode: ExitCode.GENERAL_ERROR
-        });
-    }
-}
+import { resolve, join } from 'node:path';
+import { existsSync, mkdirSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import inquirer from 'inquirer';
+import { DEFAULT_CATALOG_VERSIONS, ExitCode, } from '../../common/constant.js';
+import { inspectTarget, checkPlannedConflicts } from '../../common/safety.js';
+import { collectTemplateOutputPaths, renderTemplateDir } from '../../common/template-renderer.js';
+import { Transaction } from '../../common/transaction.js';
+import { verifyWorkspace } from '../../common/verifier.js';
+import { sendJson, logInfo, logWarn, fail, setJsonMode, createSpinner } from '../../common/output.js';
+import { getDirname } from '../../common/constant.js';
+/**
+ * 从包名推导目录名（去掉 scope 并转为合法 kebab-case）
+ */
+export function deriveAppDir(name) {
+    const withoutScope = name.replace(/^@[^/]+\//, '');
+    return withoutScope
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * 校验 npm 包名有效性
+ */
+export function validatePackageName(name) {
+    if (!name || typeof name !== 'string') {
+        return false;
+    }
+    return /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name);
+}
+/**
+ * 执行 pnpm install 安装依赖
+ */
+export function runPnpmInstall(targetDir, isJson = false) {
+    return new Promise((resolve) => {
+        const child = spawn('pnpm', ['install'], {
+            cwd: targetDir,
+            shell: true,
+            stdio: isJson ? ['ignore', 'pipe', 'pipe'] : 'inherit'
+        });
+        let stderrData = '';
+        if (isJson && child.stderr) {
+            child.stderr.on('data', (chunk) => {
+                stderrData += chunk.toString();
+                process.stderr.write(chunk);
+            });
+        }
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve({ success: true });
+            }
+            else {
+                resolve({ success: false, error: `pnpm install 退出码: ${code}` });
+            }
+        });
+        child.on('error', (err) => {
+            resolve({ success: false, error: err.message });
+        });
+    });
+}
+/* eslint-disable complexity */
+export async function createWorkspace(target = '.', options = {}) {
+    const isJson = !!options.json;
+    setJsonMode(isJson);
+    const inspect = inspectTarget(target);
+    if (!inspect.canCreate) {
+        fail({
+            command: 'workspace.create',
+            error: `目标目录无法创建 Workspace，状态: ${inspect.status}。${inspect.conflicts.length > 0 ? `冲突项: ${inspect.conflicts.join(', ')}` : ''}`,
+            exitCode: ExitCode.TARGET_CONFLICT,
+            extra: { status: inspect.status, conflicts: inspect.conflicts }
+        });
+    }
+    let { name, title } = options;
+    let router = options.router ?? false;
+    let routerMode = options.routerMode || 'hash';
+    let format = options.format || 'es';
+    let style = options.style || 'css';
+    let install = options.install ?? false;
+    // 非 JSON 模式下若缺失必填项，进行交互询问
+    if (!isJson && !options.yes && !name) {
+        const prompt = inquirer.createPromptModule();
+        const answers = await prompt([
+            {
+                type: 'input',
+                name: 'name',
+                message: '请输入应用名称 (package name):',
+                default: 'my-app',
+                validate: (input) => (validatePackageName(input) ? true : '请输入合法的 npm 包名 (如 my-app 或 @scope/my-app)')
+            },
+            {
+                type: 'input',
+                name: 'title',
+                message: '请输入展示标题 (title):',
+                default: (ans) => ans.name
+            },
+            {
+                type: 'confirm',
+                name: 'router',
+                message: '是否启用 Vue Router?',
+                default: false
+            },
+            {
+                type: 'list',
+                name: 'routerMode',
+                message: '选择路由模式:',
+                choices: ['hash', 'history'],
+                default: 'hash',
+                when: (ans) => ans.router
+            },
+            {
+                type: 'list',
+                name: 'style',
+                message: '选择应用样式方案:',
+                choices: ['css', 'scss', 'none'],
+                default: 'css'
+            },
+            {
+                type: 'list',
+                name: 'format',
+                message: '选择交付格式:',
+                choices: ['es', 'systemjs'],
+                default: 'es'
+            },
+            {
+                type: 'confirm',
+                name: 'install',
+                message: '是否在创建完成后自动安装依赖 (pnpm install)?',
+                default: false
+            }
+        ]);
+        ({ name } = answers);
+        title = answers.title || name;
+        router = !!answers.router;
+        if (answers.routerMode) {
+            ({ routerMode } = answers);
+        }
+        if (answers.style) {
+            ({ style } = answers);
+        }
+        if (answers.format) {
+            ({ format } = answers);
+        }
+        if (answers.install !== undefined) {
+            install = !!answers.install;
+        }
+    }
+    if (!name) {
+        fail({
+            command: 'workspace.create',
+            error: '必须指定应用名称 (--name <name>)',
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+    if (!validatePackageName(name)) {
+        fail({
+            command: 'workspace.create',
+            error: `非法的应用包名: "${name}"`,
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+    title = title || name;
+    const appDir = deriveAppDir(name);
+    if (!appDir || !/^[a-z0-9-_]+$/.test(appDir)) {
+        fail({
+            command: 'workspace.create',
+            error: `无法从应用名 "${name}" 推导出合法的子目录名`,
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+    const targetDir = inspect.target;
+    const templatesBase = resolve(getDirname(import.meta.url), '../../../templates/workspace');
+    const rootTemplateDir = join(templatesBase, 'root');
+    const appTemplateDir = join(templatesBase, 'app');
+    const rootVariables = {
+        pnpmVersion: DEFAULT_CATALOG_VERSIONS['pnpm'],
+        farrisUiVueVersion: DEFAULT_CATALOG_VERSIONS['@farris/ui-vue'],
+        farrisCliVersion: DEFAULT_CATALOG_VERSIONS['@farris/cli'],
+        typescriptVersion: DEFAULT_CATALOG_VERSIONS['typescript'],
+        viteVersion: DEFAULT_CATALOG_VERSIONS['vite'],
+        vueVersion: DEFAULT_CATALOG_VERSIONS['vue'],
+        vueRouterVersion: DEFAULT_CATALOG_VERSIONS['vue-router'],
+        vueTscVersion: DEFAULT_CATALOG_VERSIONS['vue-tsc'],
+        sassVersion: DEFAULT_CATALOG_VERSIONS['sass'],
+        title,
+        appDir,
+        appName: name
+    };
+    const appTargetDir = join(targetDir, 'packages', appDir);
+    // 组装条件变量
+    const routerDependency = router ? ',\n    "vue-router": "catalog:"' : '';
+    const sassDevDependency = style === 'scss' ? ',\n    "sass": "catalog:"' : '';
+    let styleImport = '';
+    if (style === 'css') {
+        styleImport = "\nimport './styles/index.css';";
+    }
+    else if (style === 'scss') {
+        styleImport = "\nimport './styles/index.scss';";
+    }
+    const routerImport = router ? "\nimport router from './router';" : '';
+    const routerUse = router ? '\napp.use(router);' : '';
+    // 模板保留扩展点，但通用 CLI 不再内置 i18n 运行时契约。
+    const i18nImport = '';
+    const i18nUse = '';
+    const appRouterImport = router ? "\nimport { RouterView } from 'vue-router';" : '';
+    const appTemplateBody = router
+        ? '        <RouterView />'
+        : `        <h1>{${JSON.stringify(title)}}</h1>`;
+    const appVariables = {
+        appName: name,
+        title,
+        appDir,
+        base: './',
+        routerMode: router ? routerMode : 'none',
+        format,
+        routerDependency,
+        sassDevDependency,
+        styleImport,
+        routerImport,
+        routerUse,
+        i18nImport,
+        i18nUse,
+        appRouterImport,
+        appTemplateBody,
+        routerHistoryFunction: routerMode === 'history' ? 'createWebHistory' : 'createWebHashHistory',
+        routerHistoryCall: routerMode === 'history'
+            ? 'createWebHistory(import.meta.env.BASE_URL)'
+            : 'createWebHashHistory()'
+    };
+    // 模板文件过滤规则
+    const appFilter = (relPath) => {
+        const normalized = relPath.replace(/\\/g, '/');
+        // 样式过滤
+        if (style === 'none' && normalized.startsWith('src/styles')) {
+            return false;
+        }
+        if (style === 'css' && (normalized === 'src/styles/index.scss' || normalized === 'src/styles/index.scss.tpl')) {
+            return false;
+        }
+        if (style === 'scss' && (normalized === 'src/styles/index.css' || normalized === 'src/styles/index.css.tpl')) {
+            return false;
+        }
+        // Router 与 Views 过滤
+        if (!router) {
+            if (normalized.startsWith('src/router') || normalized.startsWith('src/views')) {
+                return false;
+            }
+        }
+        return true;
+    };
+    const plannedRelativeFiles = [
+        ...collectTemplateOutputPaths(rootTemplateDir),
+        ...collectTemplateOutputPaths(appTemplateDir, appFilter).map((path) => join('packages', appDir, path))
+    ];
+    const conflicts = checkPlannedConflicts(targetDir, plannedRelativeFiles);
+    if (conflicts.length > 0 && !options.force) {
+        const shouldOverwrite = !isJson &&
+            !options.yes &&
+            (await inquirer.createPromptModule()([
+                {
+                    type: 'confirm',
+                    name: 'overwrite',
+                    message: `以下 ${conflicts.length} 个文件已存在，是否覆盖？\n${conflicts.join('\n')}`,
+                    default: false
+                }
+            ])).overwrite;
+        if (!shouldOverwrite) {
+            fail({
+                command: 'workspace.create',
+                error: `目标目录包含将被模板写入的文件: ${conflicts.join(', ')}。请交互确认，或显式传入 --force 覆盖。`,
+                exitCode: ExitCode.TARGET_CONFLICT,
+                extra: { conflicts }
+            });
+        }
+    }
+    const transaction = new Transaction();
+    plannedRelativeFiles.forEach((path) => transaction.prepareWrite(join(targetDir, path)));
+    const spinner = createSpinner('正在生成 Workspace 工程模板...');
+    spinner.start();
+    try {
+        if (!existsSync(targetDir)) {
+            mkdirSync(targetDir, { recursive: true });
+            transaction.recordCreatedDir(targetDir);
+        }
+        // 1. 渲染根目录模板
+        const rootRender = renderTemplateDir({
+            sourceDir: rootTemplateDir,
+            targetDir,
+            variables: rootVariables,
+            skipExisting: false
+        });
+        if (rootRender.unreplacedPlaceholders.length > 0) {
+            throw new Error(`根模板渲染出现未替换占位符: ${rootRender.unreplacedPlaceholders.map((p) => `${p.file} (${p.placeholder})`).join(', ')}`);
+        }
+        // 2. 渲染子应用目录 (packages/<appDir>/)
+        mkdirSync(appTargetDir, { recursive: true });
+        transaction.recordCreatedDir(appTargetDir);
+        const appRender = renderTemplateDir({
+            sourceDir: appTemplateDir,
+            targetDir: appTargetDir,
+            variables: appVariables,
+            skipExisting: false,
+            filter: appFilter
+        });
+        if (appRender.unreplacedPlaceholders.length > 0) {
+            throw new Error(`应用模板渲染出现未替换占位符: ${appRender.unreplacedPlaceholders.map((p) => `${p.file} (${p.placeholder})`).join(', ')}`);
+        }
+        // 3. 执行 Verify
+        const verifyResult = verifyWorkspace(targetDir, inspect.preservedInputEntries);
+        if (!verifyResult.ok) {
+            throw new Error(`Workspace 校验失败: ${verifyResult.errors.join('; ')}`);
+        }
+        // 4. 提交事务
+        transaction.commit();
+        spinner.succeed('Workspace 工程生成并校验通过！');
+        // 5. 若启用 --install，自动执行依赖安装
+        let installed = false;
+        let installError;
+        if (install) {
+            const installSpinner = createSpinner('正在安装依赖 (pnpm install)...');
+            installSpinner.start();
+            const installRes = await runPnpmInstall(targetDir, isJson);
+            if (installRes.success) {
+                installed = true;
+                installSpinner.succeed('依赖安装成功！');
+            }
+            else {
+                installed = false;
+                installError = installRes.error;
+                installSpinner.fail('依赖安装失败');
+                logWarn(`\n提示: 依赖安装出现异常 (${installError})，您可以稍后进入目录手动执行 "pnpm install"`);
+            }
+        }
+        const allCreated = [...rootRender.filesCreated, ...appRender.filesCreated];
+        if (isJson) {
+            sendJson({
+                command: 'workspace.create',
+                ok: true,
+                target: targetDir,
+                appDir,
+                appName: name,
+                title,
+                router,
+                routerMode: router ? routerMode : 'none',
+                format,
+                style,
+                installed,
+                ...(installError ? { installError } : {}),
+                filesCreated: allCreated,
+                preservedInputVerified: inspect.preservedInputEntries.length > 0
+            });
+            return;
+        }
+        logInfo(`\n✨ Workspace 已就绪: ${targetDir}`);
+        logInfo(`- 应用: ${name} (目录: packages/${appDir})`);
+        logInfo(`- 路由: ${router ? routerMode : '未启用'}`);
+        logInfo(`- 样式: ${style}`);
+        logInfo(`- 交付格式: ${format}`);
+        logInfo(`- 依赖安装: ${installed ? '已完成' : '未执行 (可通过 pnpm install 安装)'}`);
+        logInfo('\n下一步 (Next Steps):');
+        logInfo(`  1. cd ${target}`);
+        if (!installed) {
+            logInfo('  2. pnpm install');
+            logInfo(`  3. pnpm --filter "${name}" dev\n`);
+        }
+        else {
+            logInfo(`  2. pnpm --filter "${name}" dev\n`);
+        }
+    }
+    catch (err) {
+        spinner.fail('Workspace 生成失败，正在回滚...');
+        transaction.rollback();
+        fail({
+            command: 'workspace.create',
+            error: `生成 Workspace 失败: ${err.message}`,
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+}
 //# sourceMappingURL=create.js.map