@farris/cli 2.3.7 → 2.3.9

package/lib/commands/create.js

@@ -1,332 +1,342 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync } from 'node:fs';
-import { basename, isAbsolute, join, relative, resolve } from 'node:path';
-import inquirer from 'inquirer';
-import { DEFAULT_CATALOG_VERSIONS, ExitCode, getDirname, renderCatalogEntries } from '../common/constant.js';
-import { applyCatalogDeps } from '../common/apply-catalog-deps.js';
-import { checkPlannedConflicts, inspectTarget } from '../common/safety.js';
-import { collectTemplateOutputPaths, renderTemplateDir } from '../common/template-renderer.js';
-import { CreateAppError } from '../common/create-app-target.js';
-import { generateApp } from '../common/generate-app.js';
-import { fail, printNextSteps, printSuccess, sendJson, setJsonMode } from '../common/output.js';
-import { PROJECT_CONTAINERS, containerFor, deriveAppDir } from '../common/project-layout.js';
-import { renderCommandTable, renderProjectList, renderProjectOverview, renderTechStack } from '../common/workspace-contract.js';
-import { ALLOWED_TYPES, DEFAULT_APP_FORMAT, DEFAULT_LIB_FORMATS, resolvePackageName } from './create-app-options.js';
-export { parseCreateArgv } from './create-options.js';
-const DEFAULT_WORKSPACE = 'my-workspace';
-const DEFAULT_APP = 'app';
-function createTemplateDir() {
-    return resolve(getDirname(import.meta.url), '../../templates/create');
-}
-function catalogVariables() {
-    return {
-        pnpmVersion: DEFAULT_CATALOG_VERSIONS.pnpm,
-        catalogEntries: renderCatalogEntries()
-    };
-}
-function assertAppName(appName) {
-    const trimmed = appName.trim();
-    if (!trimmed || trimmed === '.' || trimmed === '..') {
-        throw new CreateAppError('应用名称不能为空或为 . / ..');
-    }
-    if (trimmed.includes('\0') || trimmed.includes('\\')) {
-        throw new CreateAppError(`应用名称必须是单段目录名或带 scope 的包名: ${appName}`);
-    }
-    // 允许 @scope/name（包名保留 scope，目录名由 deriveAppDir 推导），其余多段路径一律拒绝
-    if (trimmed.includes('/') && !/^@[^/]+\/[^/]+$/.test(trimmed)) {
-        throw new CreateAppError(`应用名称必须是单段目录名或带 scope 的包名: ${appName}`);
-    }
-}
-function assertProjectType(type) {
-    if (!ALLOWED_TYPES.includes(type)) {
-        throw new CreateAppError(`非法的工程类型: ${type}，允许值为 ${ALLOWED_TYPES.join(', ')}`);
-    }
-    return type;
-}
-/**
- * create 的目标路径：允许 `.`（就地生成，见设计文档 §9.2），仍禁止逃出 cwd。
- */
-function resolveCreateTarget(target, cwd = process.cwd()) {
-    const trimmed = (target ?? '').trim();
-    if (trimmed.includes('\0')) {
-        throw new CreateAppError('目标路径包含非法字符');
-    }
-    const resolved = resolve(cwd, trimmed);
-    const rel = relative(cwd, resolved);
-    if (rel.startsWith('..') || isAbsolute(rel)) {
-        throw new CreateAppError(`目标目录必须位于当前工作目录内: ${target}`);
-    }
-    return resolved;
-}
-function rootTemplateVariables(createApp, appRel, pkgType = 'app') {
-    if (createApp && appRel) {
-        const artifactDir = pkgType === 'lib' ? `${appRel}/lib` : `${appRel}/dist`;
-        return {
-            ciBuildSteps: [
-                `    - pnpm --filter ./${appRel} run build`,
-                '    - mkdir -p dist',
-                `    - cp -r ${artifactDir}/. dist/`
-            ].join('\n'),
-            ciPublishSteps: ['    - cd dist', '    - npm publish'].join('\n'),
-            readmeBody: `pnpm workspace，包含一个 Farris ${pkgType}（\`${appRel}\`）。`
-        };
-    }
-    return {
-        ciBuildSteps: '',
-        ciPublishSteps: '    - echo "no app to publish"',
-        readmeBody: `pnpm workspace，可在 \`${PROJECT_CONTAINERS.app}\` / \`${PROJECT_CONTAINERS.lib}\` 下添加工程。`
-    };
-}
-/** 交互模式收集 workspace 名、是否建工程、工程类型与工程名；非交互直接用默认值。 */
-async function resolveCreateInputs(nameArg, options) {
-    let name = (nameArg ?? options.name ?? '').trim();
-    let createApp = options.noApp ? false : !!(options.yes || options.json || options.app != null);
-    let appName = (options.app ?? '').trim() || DEFAULT_APP;
-    let pkgType = 'app';
-    if (options.yes || options.json) {
-        return {
-            name: name || DEFAULT_WORKSPACE,
-            createApp: options.noApp ? false : createApp,
-            appName,
-            pkgType
-        };
-    }
-    const prompt = inquirer.createPromptModule();
-    if (!name) {
-        const answers = await prompt([
-            {
-                type: 'input',
-                name: 'name',
-                message: '请输入 workspace 名称',
-                default: DEFAULT_WORKSPACE
-            }
-        ]);
-        name = String(answers.name).trim() || DEFAULT_WORKSPACE;
-    }
-    if (!options.noApp && options.app == null) {
-        const answers = await prompt([
-            {
-                type: 'confirm',
-                name: 'createApp',
-                message: '是否现在创建一个工程?',
-                default: true
-            }
-        ]);
-        createApp = !!answers.createApp;
-        if (createApp) {
-            const typeAnswers = await prompt([
-                {
-                    type: 'list',
-                    name: 'type',
-                    message: '请选择工程类型',
-                    choices: [...ALLOWED_TYPES],
-                    default: 'app'
-                }
-            ]);
-            pkgType = assertProjectType(String(typeAnswers.type));
-            const appAnswers = await prompt([
-                {
-                    type: 'input',
-                    name: 'appName',
-                    message: '请输入工程名称',
-                    default: DEFAULT_APP
-                }
-            ]);
-            appName = String(appAnswers.appName).trim() || DEFAULT_APP;
-        }
-    }
-    return { name, createApp, appName, pkgType };
-}
-/** 校验工程名并推导包名与容器内相对目录；不建工程时返回空对象。 */
-function resolveAppTargets(createApp, appName, pkgType) {
-    if (!createApp) {
-        return {};
-    }
-    assertAppName(appName);
-    const appPackageName = resolvePackageName(appName);
-    assertAppName(appPackageName);
-    const appDir = deriveAppDir(appPackageName);
-    if (!appDir || !/^[a-z0-9-_]+$/.test(appDir)) {
-        throw new CreateAppError(`无法从工程名 "${appPackageName}" 推导出合法的子目录名`);
-    }
-    return { appPackageName, appDir, appRel: `${containerFor(pkgType)}/${appDir}` };
-}
-/** 写入前冲突预检（设计文档 §9.1）：非交互必须显式 --force，交互可确认覆盖。 */
-async function confirmRootOverwrite(conflicts, options, isJson) {
-    if (conflicts.length === 0 || options.force) {
-        return;
-    }
-    const interactive = !isJson && !(options.yes || options.json);
-    const shouldOverwrite = interactive &&
-        (await inquirer.createPromptModule()([
-            {
-                type: 'confirm',
-                name: 'overwrite',
-                message: `以下 ${conflicts.length} 个文件已存在，是否覆盖？\n${conflicts.join('\n')}`,
-                default: false
-            }
-        ])).overwrite;
-    if (!shouldOverwrite) {
-        throw new CreateAppError(`目标目录包含将被模板写入的文件: ${conflicts.join(', ')}。请交互确认，或显式传入 --force 覆盖。`, ExitCode.TARGET_CONFLICT);
-    }
-}
-/** 渲染根模板并补齐两个容器目录。 */
-function scaffoldWorkspaceRoot(targetPath, context) {
-    const rootRender = renderTemplateDir({
-        sourceDir: createTemplateDir(),
-        targetDir: targetPath,
-        variables: {
-            ...catalogVariables(),
-            ...rootTemplateVariables(context.createApp, context.appRel, context.pkgType),
-            appContainer: PROJECT_CONTAINERS.app,
-            libContainer: PROJECT_CONTAINERS.lib,
-            commandTable: renderCommandTable(),
-            projectOverview: renderProjectOverview(context.workspaceTitle),
-            projectList: renderProjectList(context.plannedProjects),
-            techStack: renderTechStack(),
-            title: context.workspaceTitle
-        }
-    });
-    if (rootRender.unreplacedPlaceholders.length > 0) {
-        throw new Error(`根模板未替换: ${rootRender.unreplacedPlaceholders.map((p) => p.placeholder).join(', ')}`);
-    }
-    // 容器按需创建：只建「真的有工程」的那一类，空容器目录不出现。
-    // 另一类在首次 add-app / add-lib 时自动生成；pnpm 的 `container/*` glob 在目录不存在时
-    // 只是匹配为空，不影响安装，因此无需 .gitkeep 占位。
-    const containers = new Set(context.plannedProjects.map((project) => containerFor(project.type)));
-    for (const container of containers) {
-        mkdirSync(join(targetPath, container), { recursive: true });
-    }
-}
-/** 渲染子工程模板、去掉子工程内的 CI 文件并把可入 catalog 的依赖改写为 catalog:。 */
-function scaffoldAppProject(targetPath, context) {
-    const { appRel, appPackageName, pkgType, workspaceTitle, options } = context;
-    generateApp({
-        name: join(targetPath, appRel).replace(/\\/g, '/'),
-        packageName: appPackageName,
-        title: workspaceTitle,
-        type: pkgType,
-        ...(pkgType === 'lib'
-            ? { formats: [...DEFAULT_LIB_FORMATS] }
-            : {
-                platform: options.platform ?? 'web',
-                format: options.format ?? DEFAULT_APP_FORMAT,
-                style: options.style ?? 'css'
-            }),
-        hints: false
-    });
-    // 根目录只保留一份 .gitlab-ci.yml
-    const appGitlab = join(targetPath, appRel, '.gitlab-ci.yml');
-    if (existsSync(appGitlab)) {
-        unlinkSync(appGitlab);
-    }
-    const appPkgPath = join(targetPath, appRel, 'package.json');
-    const appPkg = JSON.parse(readFileSync(appPkgPath, 'utf8'));
-    applyCatalogDeps(appPkg);
-    writeFileSync(appPkgPath, JSON.stringify(appPkg, null, 2) + '\n');
-}
-async function installDependenciesIfRequested(options, targetPath, isJson) {
-    if (!options.install) {
-        return;
-    }
-    const { runPnpmInstall } = await import('./workspace/create.js');
-    const result = await runPnpmInstall(targetPath, isJson);
-    if (!result.success) {
-        throw new CreateAppError(result.error || 'pnpm install 失败');
-    }
-}
-function reportCreate(result) {
-    if (result.isJson) {
-        sendJson({
-            command: 'create',
-            ok: true,
-            name: result.workspaceTitle,
-            createdApp: result.createApp,
-            ...(result.createApp
-                ? {
-                    packageName: result.targets.appPackageName,
-                    appDir: result.targets.appRel,
-                    type: result.targets.pkgType
-                }
-                : {}),
-            target: result.targetPath
-        });
-        return;
-    }
-    printSuccess(`工作空间已创建 ${result.targetPath}`);
-    printNextSteps({
-        targetArg: result.targetArg,
-        targetDir: result.targetPath,
-        cwd: result.cwd,
-        installed: result.installed,
-        appPackageName: result.targets.appPackageName
-    });
-}
-export async function create(nameArg, options = {}) {
-    const isJson = !!options.json;
-    setJsonMode(isJson);
-    try {
-        const inputs = await resolveCreateInputs(nameArg, options);
-        const cwd = process.cwd();
-        const targetArg = inputs.name;
-        const targetPath = resolveCreateTarget(inputs.name, cwd);
-        const workspaceTitle = targetArg === '.' ? basename(targetPath) : targetArg;
-        const inspect = inspectTarget(targetPath);
-        if (!inspect.canCreate) {
-            throw new CreateAppError(`目标目录不能用于创建 workspace，状态: ${inspect.status}${inspect.conflicts.length > 0 ? `，冲突项: ${inspect.conflicts.join(', ')}` : ''}`, ExitCode.TARGET_CONFLICT);
-        }
-        const created = !existsSync(targetPath);
-        const targets = {
-            ...resolveAppTargets(inputs.createApp, inputs.appName, inputs.pkgType),
-            pkgType: inputs.pkgType
-        };
-        const plannedProjects = targets.appRel && targets.appDir
-            ? [{ type: inputs.pkgType, dir: targets.appRel, name: targets.appDir }]
-            : [];
-        // create 的子工程落在全新容器内，因此只需预检根模板。
-        await confirmRootOverwrite(checkPlannedConflicts(targetPath, collectTemplateOutputPaths(createTemplateDir())), options, isJson);
-        try {
-            scaffoldWorkspaceRoot(targetPath, {
-                createApp: inputs.createApp,
-                appRel: targets.appRel,
-                pkgType: inputs.pkgType,
-                workspaceTitle,
-                plannedProjects
-            });
-            if (inputs.createApp && targets.appRel && targets.appPackageName) {
-                scaffoldAppProject(targetPath, {
-                    appRel: targets.appRel,
-                    appPackageName: targets.appPackageName,
-                    pkgType: inputs.pkgType,
-                    workspaceTitle,
-                    options
-                });
-            }
-            await installDependenciesIfRequested(options, targetPath, isJson);
-            reportCreate({
-                isJson,
-                workspaceTitle,
-                createApp: inputs.createApp,
-                targets,
-                targetPath,
-                targetArg,
-                cwd,
-                installed: !!options.install
-            });
-        }
-        catch (inner) {
-            if (created && existsSync(targetPath)) {
-                rmSync(targetPath, { recursive: true, force: true });
-            }
-            throw inner;
-        }
-    }
-    catch (error) {
-        if (isJson) {
-            const message = error instanceof Error ? error.message : String(error);
-            const exitCode = error instanceof CreateAppError ? error.exitCode : ExitCode.GENERAL_ERROR;
-            fail({ command: 'create', error: message, exitCode });
-        }
-        throw error;
-    }
-}
+import { existsSync, mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync } from 'node:fs';
+import { basename, isAbsolute, join, relative, resolve } from 'node:path';
+import inquirer from 'inquirer';
+import { DEFAULT_CATALOG_VERSIONS, ExitCode, getDirname, renderCatalogEntries } from '../common/constant.js';
+import { applyCatalogDeps } from '../common/apply-catalog-deps.js';
+import { checkPlannedConflicts, inspectTarget } from '../common/safety.js';
+import { collectTemplateOutputPaths, renderTemplateDir } from '../common/template-renderer.js';
+import { CreateAppError } from '../common/create-app-target.js';
+import { generateApp } from '../common/generate-app.js';
+import { fail, printNextSteps, printSuccess, sendJson, setJsonMode } from '../common/output.js';
+import { PROJECT_CONTAINERS, containerFor, deriveAppDir } from '../common/project-layout.js';
+import { renderCommandTable, renderProjectList, renderProjectOverview, renderTechStack } from '../common/workspace-contract.js';
+import { ALLOWED_TYPES, DEFAULT_APP_FORMAT, DEFAULT_LIB_FORMATS, DEFAULT_MICRO_FORMAT, parseFormatsFlag, resolvePackageName, validateCliInput } from './create-app-options.js';
+export { parseCreateArgv } from './create-options.js';
+const DEFAULT_WORKSPACE = 'my-workspace';
+const DEFAULT_APP = 'app';
+function createTemplateDir() {
+    return resolve(getDirname(import.meta.url), '../../templates/create');
+}
+function catalogVariables() {
+    return {
+        pnpmVersion: DEFAULT_CATALOG_VERSIONS.pnpm,
+        catalogEntries: renderCatalogEntries()
+    };
+}
+function assertAppName(appName) {
+    const trimmed = appName.trim();
+    if (!trimmed || trimmed === '.' || trimmed === '..') {
+        throw new CreateAppError('应用名称不能为空或为 . / ..');
+    }
+    if (trimmed.includes('\0') || trimmed.includes('\\')) {
+        throw new CreateAppError(`应用名称必须是单段目录名或带 scope 的包名: ${appName}`);
+    }
+    // 允许 @scope/name（包名保留 scope，目录名由 deriveAppDir 推导），其余多段路径一律拒绝
+    if (trimmed.includes('/') && !/^@[^/]+\/[^/]+$/.test(trimmed)) {
+        throw new CreateAppError(`应用名称必须是单段目录名或带 scope 的包名: ${appName}`);
+    }
+}
+function assertProjectType(type) {
+    if (!ALLOWED_TYPES.includes(type)) {
+        throw new CreateAppError(`非法的工程类型: ${type}，允许值为 ${ALLOWED_TYPES.join(', ')}`);
+    }
+    return type;
+}
+/**
+ * create 的目标路径：允许 `.`（就地生成，见设计文档 §9.2），仍禁止逃出 cwd。
+ */
+function resolveCreateTarget(target, cwd = process.cwd()) {
+    const trimmed = (target ?? '').trim();
+    if (trimmed.includes('\0')) {
+        throw new CreateAppError('目标路径包含非法字符');
+    }
+    const resolved = resolve(cwd, trimmed);
+    const rel = relative(cwd, resolved);
+    if (rel.startsWith('..') || isAbsolute(rel)) {
+        throw new CreateAppError(`目标目录必须位于当前工作目录内: ${target}`);
+    }
+    return resolved;
+}
+function rootTemplateVariables(createApp, appRel, pkgType = 'app') {
+    if (createApp && appRel) {
+        // 事项 F 收尾：app 与 lib 的交付物目录都是 dist/
+        const artifactDir = `${appRel}/dist`;
+        const kindLabel = pkgType === 'lib' ? '组件库' : pkgType === 'micro' ? '微应用' : '应用';
+        return {
+            ciBuildSteps: [
+                `    - pnpm --filter ./${appRel} run build`,
+                '    - mkdir -p dist',
+                `    - cp -r ${artifactDir}/. dist/`
+            ].join('\n'),
+            ciPublishSteps: ['    - cd dist', '    - npm publish'].join('\n'),
+            readmeBody: `pnpm workspace，包含一个 Farris ${kindLabel}（\`${appRel}\`）。`
+        };
+    }
+    return {
+        ciBuildSteps: '',
+        ciPublishSteps: '    - echo "no app to publish"',
+        readmeBody: `pnpm workspace，可在 \`${PROJECT_CONTAINERS.app}\` / \`${PROJECT_CONTAINERS.lib}\` 下添加工程。`
+    };
+}
+/** 交互模式收集 workspace 名、是否建工程、工程类型与工程名；非交互直接用默认值。 */
+async function resolveCreateInputs(nameArg, options) {
+    let name = (nameArg ?? options.name ?? '').trim();
+    let createApp = options.noProject ? false : !!(options.yes || options.json || options.project != null);
+    let appName = (options.project ?? '').trim() || DEFAULT_APP;
+    let pkgType = assertProjectType(options.type ?? 'app');
+    if (options.yes || options.json) {
+        // 非交互路径：非法值直接报错，不等生成到一半才失败
+        validateCliInput({
+            type: options.type,
+            platform: options.platform,
+            format: options.format,
+            formats: options.formats
+        });
+        return {
+            name: name || DEFAULT_WORKSPACE,
+            createApp: options.noProject ? false : createApp,
+            appName,
+            pkgType
+        };
+    }
+    const prompt = inquirer.createPromptModule();
+    if (!name) {
+        const answers = await prompt([
+            {
+                type: 'input',
+                name: 'name',
+                message: '请输入 workspace 名称',
+                default: DEFAULT_WORKSPACE
+            }
+        ]);
+        name = String(answers.name).trim() || DEFAULT_WORKSPACE;
+    }
+    if (!options.noProject && options.project == null) {
+        const answers = await prompt([
+            {
+                type: 'confirm',
+                name: 'createApp',
+                message: '是否现在创建一个工程?',
+                default: true
+            }
+        ]);
+        createApp = !!answers.createApp;
+        if (createApp) {
+            const typeAnswers = await prompt([
+                {
+                    type: 'list',
+                    name: 'type',
+                    message: '请选择工程类型',
+                    choices: [...ALLOWED_TYPES],
+                    default: 'app'
+                }
+            ]);
+            pkgType = assertProjectType(String(typeAnswers.type));
+            const appAnswers = await prompt([
+                {
+                    type: 'input',
+                    name: 'appName',
+                    message: '请输入工程名称',
+                    default: DEFAULT_APP
+                }
+            ]);
+            appName = String(appAnswers.appName).trim() || DEFAULT_APP;
+        }
+    }
+    return { name, createApp, appName, pkgType };
+}
+/** 校验工程名并推导包名与容器内相对目录；不建工程时返回空对象。 */
+function resolveAppTargets(createApp, appName, pkgType) {
+    if (!createApp) {
+        return {};
+    }
+    assertAppName(appName);
+    const appPackageName = resolvePackageName(appName);
+    assertAppName(appPackageName);
+    const appDir = deriveAppDir(appPackageName);
+    if (!appDir || !/^[a-z0-9-_]+$/.test(appDir)) {
+        throw new CreateAppError(`无法从工程名 "${appPackageName}" 推导出合法的子目录名`);
+    }
+    return { appPackageName, appDir, appRel: `${containerFor(pkgType)}/${appDir}` };
+}
+/** 写入前冲突预检（设计文档 §9.1）：非交互必须显式 --force，交互可确认覆盖。 */
+async function confirmRootOverwrite(conflicts, options, isJson) {
+    if (conflicts.length === 0 || options.force) {
+        return;
+    }
+    const interactive = !isJson && !(options.yes || options.json);
+    const shouldOverwrite = interactive &&
+        (await inquirer.createPromptModule()([
+            {
+                type: 'confirm',
+                name: 'overwrite',
+                message: `以下 ${conflicts.length} 个文件已存在，是否覆盖？\n${conflicts.join('\n')}`,
+                default: false
+            }
+        ])).overwrite;
+    if (!shouldOverwrite) {
+        throw new CreateAppError(`目标目录包含将被模板写入的文件: ${conflicts.join(', ')}。请交互确认，或显式传入 --force 覆盖。`, ExitCode.TARGET_CONFLICT);
+    }
+}
+/** 渲染根模板并补齐两个容器目录。 */
+function scaffoldWorkspaceRoot(targetPath, context) {
+    const rootRender = renderTemplateDir({
+        sourceDir: createTemplateDir(),
+        targetDir: targetPath,
+        variables: {
+            ...catalogVariables(),
+            ...rootTemplateVariables(context.createApp, context.appRel, context.pkgType),
+            appContainer: PROJECT_CONTAINERS.app,
+            libContainer: PROJECT_CONTAINERS.lib,
+            commandTable: renderCommandTable(),
+            projectOverview: renderProjectOverview(context.workspaceTitle),
+            projectList: renderProjectList(context.plannedProjects),
+            techStack: renderTechStack(),
+            title: context.workspaceTitle
+        }
+    });
+    if (rootRender.unreplacedPlaceholders.length > 0) {
+        throw new Error(`根模板未替换: ${rootRender.unreplacedPlaceholders.map((p) => p.placeholder).join(', ')}`);
+    }
+    // 容器按需创建：只建「真的有工程」的那一类，空容器目录不出现。
+    // 另一类在首次 add-app / add-lib 时自动生成；pnpm 的 `container/*` glob 在目录不存在时
+    // 只是匹配为空，不影响安装，因此无需 .gitkeep 占位。
+    const containers = new Set(context.plannedProjects.map((project) => containerFor(project.type)));
+    for (const container of containers) {
+        mkdirSync(join(targetPath, container), { recursive: true });
+    }
+}
+/** 渲染子工程模板、去掉子工程内的 CI 文件并把可入 catalog 的依赖改写为 catalog:。 */
+function scaffoldAppProject(targetPath, context) {
+    const { appRel, appPackageName, pkgType, workspaceTitle, options } = context;
+    generateApp({
+        name: join(targetPath, appRel).replace(/\\/g, '/'),
+        packageName: appPackageName,
+        title: workspaceTitle,
+        type: pkgType,
+        ...(pkgType === 'lib'
+            ? { formats: parseFormatsFlag(options.formats) ?? [...DEFAULT_LIB_FORMATS] }
+            : {
+                platform: options.platform ?? 'web',
+                // 微应用默认 iife 单文件（设计文档 §3.3）
+                format: options.format ?? (pkgType === 'micro' ? DEFAULT_MICRO_FORMAT : DEFAULT_APP_FORMAT),
+                style: options.style ?? 'scss'
+            }),
+        hints: false
+    });
+    // 根目录只保留一份 .gitlab-ci.yml
+    const appGitlab = join(targetPath, appRel, '.gitlab-ci.yml');
+    if (existsSync(appGitlab)) {
+        unlinkSync(appGitlab);
+    }
+    const appPkgPath = join(targetPath, appRel, 'package.json');
+    const appPkg = JSON.parse(readFileSync(appPkgPath, 'utf8'));
+    applyCatalogDeps(appPkg);
+    writeFileSync(appPkgPath, JSON.stringify(appPkg, null, 2) + '\n');
+}
+async function installDependenciesIfRequested(options, targetPath, isJson) {
+    if (!options.install) {
+        return;
+    }
+    const { runPnpmInstall } = await import('./workspace/create.js');
+    const result = await runPnpmInstall(targetPath, isJson);
+    if (!result.success) {
+        throw new CreateAppError(result.error || 'pnpm install 失败');
+    }
+}
+function reportCreate(result) {
+    if (result.isJson) {
+        sendJson({
+            command: 'create',
+            ok: true,
+            name: result.workspaceTitle,
+            createdApp: result.createApp,
+            ...(result.createApp
+                ? {
+                    packageName: result.targets.appPackageName,
+                    appDir: result.targets.appRel,
+                    type: result.targets.pkgType
+                }
+                : {}),
+            target: result.targetPath
+        });
+        return;
+    }
+    printSuccess(`工作空间已创建 ${result.targetPath}`);
+    printNextSteps({
+        targetArg: result.targetArg,
+        targetDir: result.targetPath,
+        cwd: result.cwd,
+        installed: result.installed,
+        appPackageName: result.targets.appPackageName
+    });
+}
+export async function create(nameArg, options = {}) {
+    const isJson = !!options.json;
+    setJsonMode(isJson);
+    try {
+        const inputs = await resolveCreateInputs(nameArg, options);
+        const cwd = process.cwd();
+        const targetArg = inputs.name;
+        const targetPath = resolveCreateTarget(inputs.name, cwd);
+        const workspaceTitle = targetArg === '.' ? basename(targetPath) : targetArg;
+        const inspect = inspectTarget(targetPath);
+        if (!inspect.canCreate) {
+            throw new CreateAppError(`目标目录不能用于创建 workspace，状态: ${inspect.status}${inspect.conflicts.length > 0 ? `，冲突项: ${inspect.conflicts.join(', ')}` : ''}`, ExitCode.TARGET_CONFLICT);
+        }
+        const created = !existsSync(targetPath);
+        const targets = {
+            ...resolveAppTargets(inputs.createApp, inputs.appName, inputs.pkgType),
+            pkgType: inputs.pkgType
+        };
+        const plannedProjects = targets.appRel && targets.appDir
+            ? [{ type: inputs.pkgType, dir: targets.appRel, name: targets.appDir }]
+            : [];
+        // create 的子工程落在全新容器内，因此只需预检根模板。
+        await confirmRootOverwrite(checkPlannedConflicts(targetPath, collectTemplateOutputPaths(createTemplateDir())), options, isJson);
+        try {
+            scaffoldWorkspaceRoot(targetPath, {
+                createApp: inputs.createApp,
+                appRel: targets.appRel,
+                pkgType: inputs.pkgType,
+                workspaceTitle,
+                plannedProjects
+            });
+            if (inputs.createApp && targets.appRel && targets.appPackageName) {
+                scaffoldAppProject(targetPath, {
+                    appRel: targets.appRel,
+                    appPackageName: targets.appPackageName,
+                    pkgType: inputs.pkgType,
+                    workspaceTitle,
+                    options
+                });
+            }
+            await installDependenciesIfRequested(options, targetPath, isJson);
+            reportCreate({
+                isJson,
+                workspaceTitle,
+                createApp: inputs.createApp,
+                targets,
+                targetPath,
+                targetArg,
+                cwd,
+                installed: !!options.install
+            });
+        }
+        catch (inner) {
+            if (created && existsSync(targetPath)) {
+                rmSync(targetPath, { recursive: true, force: true });
+            }
+            throw inner;
+        }
+    }
+    catch (error) {
+        if (isJson) {
+            const message = error instanceof Error ? error.message : String(error);
+            const exitCode = error instanceof CreateAppError ? error.exitCode : ExitCode.GENERAL_ERROR;
+            fail({ command: 'create', error: message, exitCode });
+        }
+        throw error;
+    }
+}
 //# sourceMappingURL=create.js.map