@farris/cli 2.3.8 → 2.3.11

package/lib/config/vite-lib.js

@@ -1,27 +1,27 @@
-import { mergeConfig } from 'vite';
-import { resolve } from "node:path";
-import { CWD, getPackageName } from '../common/constant.js';
-import { systemjsBundle } from '../plugins/systemjs-bundle.js';
-import CommonConfig from "./vite-common.js";
-export default mergeConfig(CommonConfig, {
-    logLevel: 'silent',
-    plugins: [systemjsBundle()],
-    build: {
-        lib: {
-            entry: resolve(CWD, `./src/main.ts`),
-            fileName: "index",
-        },
-        target: 'es2019',
-        outDir: resolve(CWD, `./dist`),
-        rollupOptions: {
-            output: {
-                exports: "named",
-                globals: {
-                    vue: "Vue",
-                    [getPackageName()]: getPackageName()
-                }
-            }
-        },
-    }
-});
+import { mergeConfig } from 'vite';
+import { resolve } from "node:path";
+import { CWD, getPackageName } from '../common/constant.js';
+import { systemjsBundle } from '../plugins/systemjs-bundle.js';
+import CommonConfig from "./vite-common.js";
+export default mergeConfig(CommonConfig, {
+    logLevel: 'silent',
+    plugins: [systemjsBundle()],
+    build: {
+        lib: {
+            entry: resolve(CWD, `./src/main.ts`),
+            fileName: "index",
+        },
+        target: 'es2019',
+        outDir: resolve(CWD, `./dist`),
+        rollupOptions: {
+            output: {
+                exports: "named",
+                globals: {
+                    vue: "Vue",
+                    [getPackageName()]: getPackageName()
+                }
+            }
+        },
+    }
+});
 //# sourceMappingURL=vite-lib.js.map

package/lib/index.js

@@ -1,262 +1,281 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-import { getVersion } from './common/get-version.js';
-import { PROJECT_CONTAINERS } from './common/project-layout.js';
-const program = new Command();
-program.version(`@farris/cli ${getVersion()}`);
-// ==========================================
-// 存量命令 (保持向后兼容)
-// ==========================================
-program
-    .command('build')
-    .description('构建应用产物')
-    .option('-c, --configFile [configFile]', 'Farris 配置文件路径')
-    .option('-vc, --viteConfigFile [viteConfigFile]', 'Vite 配置文件路径')
-    .option('-b, --base [base]', '覆盖构建公共路径 Base (如 / 或 ./ 或 /apps/xxx/)')
-    .option('-ep, --emitPackage', '是否生成 dist/package.json 发布清单')
-    .option('-f, --format <format>', '覆盖产物交付格式 (es | umd | systemjs | iife)')
-    .option('-o, --outDir <outDir>', '覆盖产物输出目录 (默认 ./dist)')
-    .action(async (options) => {
-    process.env.BUILD_TYPE = 'app';
-    const { buildCommon } = await import('./commands/build.js');
-    await buildCommon({ ...options, type: 'app' });
-});
-program
-    .command('build-lib')
-    .description('构建 Library 产物')
-    .option('-c, --configFile [configFile]', 'Farris 配置文件路径')
-    .option('-vc, --viteConfigFile [viteConfigFile]', 'Vite 配置文件路径')
-    .option('-f, --format [format]', '产物格式 (es | umd | systemjs)')
-    .option('-d, --dts', '是否生成类型声明文件')
-    .option('-ep, --emitPackage', '是否生成 package.json')
-    .action(async (options) => {
-    process.env.BUILD_TYPE = 'lib';
-    const { buildLib } = await import('./commands/build-lib.js');
-    await buildLib(options);
-});
-program
-    .command('build-components')
-    .description('构建组件库产物')
-    .option('-c, --configFile [configFile]', 'Farris 配置文件路径')
-    .option('-vc, --viteConfigFile [viteConfigFile]', 'Vite 配置文件路径')
-    .action(async (options) => {
-    process.env.BUILD_TYPE = 'components';
-    const { buildComponents } = await import('./commands/build-components.js');
-    await buildComponents(options);
-});
-program
-    .command('build-css')
-    .description('构建样式产物')
-    .option('-e, --entry [entry]', '样式入口文件')
-    .option('-o, --outfile [outfile]', '样式输出文件')
-    .option('-m, --minify [minify]', '是否压缩')
-    .action(async (options) => {
-    process.env.BUILD_TYPE = 'css';
-    const { buildCss } = await import('./commands/build-css.js');
-    await buildCss(options);
-});
-program
-    .command('create [name]')
-    .description('新建 pnpm workspace，可选创建一个工程')
-    .option('-y, --yes', '使用默认值，跳过问答')
-    .option('--json', '以 JSON 格式输出结果')
-    .option('--project <name>', '非交互时指定工程名（旧名 --app 仍可用）')
-    .option('--no-project', '不创建工程')
-    .option('--type <type>', '工程类型 (app | lib | micro)', 'app')
-    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
-    .option('--platform <platform>', '应用平台 (web | mobile)', 'web')
-    .option('--format <format>', '应用默认交付格式 (es | umd | systemjs | iife)', 'es')
-    .option('--formats <formats>', 'lib 产物格式，逗号分隔 (es,cjs,umd,systemjs)')
-    .option('--install', '生成后执行 pnpm install')
-    .option('--force', '确认覆盖与模板同名的已有文件（非交互模式必须显式指定）')
-    .action(async (name, options) => {
-    const { create } = await import('./commands/create.js');
-    const noProject = options.noProject === true || options.project === false;
-    const project = typeof options.project === 'string' ? options.project : undefined;
-    await create(name, {
-        yes: options.yes,
-        json: options.json,
-        install: options.install,
-        project,
-        noProject,
-        type: options.type,
-        style: options.style,
-        platform: options.platform,
-        format: options.format,
-        formats: options.formats,
-        force: options.force
-    });
-});
-program
-    .command('add-app [name]')
-    .description(`向当前 workspace 添加应用 → ${PROJECT_CONTAINERS.app}/<name>`)
-    .option('-t, --title <title>', '应用展示标题')
-    .option('--platform <platform>', '应用平台 (web | mobile)', 'web')
-    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
-    .option('--format <format>', '产物交付格式 (es | systemjs)', 'es')
-    .option('--json', '以 JSON 格式输出结果')
-    .option('--force', '确认覆盖与模板同名的已有文件')
-    .option('--install', '添加后执行 pnpm install', false)
-    .action(async (name, options) => {
-    const { addApp } = await import('./commands/add-app.js');
-    await addApp(name, options);
-});
-program
-    .command('add-lib [name]')
-    .description(`向当前 workspace 添加组件库 → ${PROJECT_CONTAINERS.lib}/<name>`)
-    .option('-t, --title <title>', '组件库展示标题')
-    .option('--formats <formats>', 'lib 产物格式，逗号分隔 (es,cjs,umd,systemjs)')
-    .option('--json', '以 JSON 格式输出结果')
-    .option('--force', '确认覆盖与模板同名的已有文件')
-    .option('--install', '添加后执行 pnpm install', false)
-    .action(async (name, options) => {
-    const { addLib } = await import('./commands/add-lib.js');
-    await addLib(name, options);
-});
-program
-    .command('add-micro [name]')
-    .description(`向当前 workspace 添加微应用 → ${PROJECT_CONTAINERS.app}/<name>`)
-    .option('-t, --title <title>', '微应用展示标题')
-    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
-    .option('--format <format>', '产物交付格式 (iife | es | systemjs)', 'iife')
-    .option('--json', '以 JSON 格式输出结果')
-    .option('--force', '确认覆盖与模板同名的已有文件')
-    .option('--install', '添加后执行 pnpm install', false)
-    .action(async (name, options) => {
-    const { addMicro } = await import('./commands/add-micro.js');
-    await addMicro(name, options);
-});
-program
-    .command('create-app [name]')
-    .description('新建 App / Lib 模板')
-    .option('--type <type>', '工程类型 (app | lib)')
-    .option('--platform <platform>', '应用平台 (web | mobile)')
-    .option('--formats <formats>', 'lib 产物格式，逗号分隔 (es,cjs,umd,systemjs)')
-    .option('--format <format>', 'app 产物格式 (iife | es | umd | systemjs)')
-    .option('-y, --yes', '使用默认值，跳过问答')
-    .option('--json', '以 JSON 格式输出结果')
-    .action(async (name, options) => {
-    const { createApp } = await import('./commands/create-app.js');
-    await createApp(name, options);
-});
-program
-    .command('dev')
-    .description('创建 Dev Server')
-    .option('-p, --port [port]', '开发服务器端口')
-    .option('--no-mock', '关闭开发期 mock，接口请求全部走代理')
-    .action(async (options) => {
-    process.env.BUILD_TYPE = 'app';
-    const { devServe } = await import('./commands/dev-serve.js');
-    await devServe(options);
-});
-program
-    .command('preview')
-    .description('创建 Preview Server')
-    .option('-p, --port [port]', '预览服务器端口')
-    .action(async (options) => {
-    process.env.BUILD_TYPE = 'app';
-    const { previewServe } = await import('./commands/preview-serve.js');
-    await previewServe(options);
-});
-program
-    .command('extract-i18n')
-    .description('抽取国际化资源到 JSON 文件')
-    .option('-c, --configFile [configFile]', '国际化配置文件路径')
-    .action(async (options) => {
-    const { extractI18n } = await import('./commands/extract-i18n.js');
-    await extractI18n(options);
-});
-// ==========================================
-// Workspace 命令组
-// ==========================================
-const workspaceCmd = program.command('workspace').description('Farris pnpm workspace 规范管理');
-workspaceCmd
-    .command('inspect [target]')
-    .description('检查目标目录安全状态')
-    .option('--json', '以 JSON 格式输出结果')
-    .action(async (target = '.', options) => {
-    const { inspectWorkspace } = await import('./commands/workspace/inspect.js');
-    await inspectWorkspace(target, options);
-});
-workspaceCmd
-    .command('create [target]')
-    .description('初始化标准 Farris Vue pnpm workspace')
-    .option('-n, --name <name>', '应用名称 (package name)')
-    .option('-t, --title <title>', '应用展示标题')
-    .option('--router', '启用 Vue Router')
-    .option('--router-mode <mode>', '路由模式 (hash | history)', 'hash')
-    .option('--format <format>', '产物交付格式 (iife | es | systemjs)', 'iife')
-    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
-    .option('--json', '以 JSON 格式输出结果')
-    .option('--force', '确认覆盖与模板同名的已有文件（非交互模式必须显式指定）')
-    .option('--install', '是否在初始化完成后自动安装依赖 (pnpm install)', false)
-    .option('-y, --yes', '接受默认配置')
-    .action(async (target = '.', options) => {
-    const { createWorkspace } = await import('./commands/workspace/create.js');
-    await createWorkspace(target, options);
-});
-workspaceCmd
-    .command('add-app <name>')
-    .description('[已废弃] 请改用 farris-cli add-app')
-    .option('-t, --title <title>', '应用展示标题')
-    .option('--router', '启用 Vue Router')
-    .option('--router-mode <mode>', '路由模式 (hash | history)', 'hash')
-    .option('--format <format>', '产物交付格式 (iife | es | systemjs)', 'iife')
-    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
-    .option('--json', '以 JSON 格式输出结果')
-    .action(async (name, options) => {
-    const { addAppToWorkspace } = await import('./commands/workspace/add-app.js');
-    await addAppToWorkspace(name, options);
-});
-workspaceCmd
-    .command('verify [target]')
-    .description('验证 Workspace 结构与规范合规性')
-    .option('--json', '以 JSON 格式输出结果')
-    .action(async (target = '.', options) => {
-    const { verifyWorkspaceCommand } = await import('./commands/workspace/verify.js');
-    await verifyWorkspaceCommand(target, options);
-});
-// ==========================================
-// Generate 命令组
-// ==========================================
-const generateCmd = program.command('generate').alias('g').description('应用级代码生成器');
-generateCmd
-    .command('view <name>')
-    .description('生成 View 页面 (含必须调用的 composable)')
-    .option('-t, --title <title>', '页面展示标题')
-    .option('--with-route', '自动在路由中注册页面')
-    .option('--with-props', '生成页面 Props 文件')
-    .option('--json', '以 JSON 格式输出结果')
-    .action(async (name, options) => {
-    const { generateView } = await import('./commands/generate/view.js');
-    await generateView(name, options);
-});
-generateCmd
-    .command('component <name>')
-    .description('生成通用组件（按需创建 src/components/）')
-    .option('--with-props', '生成组件 Props 文件')
-    .option('--no-props', '不生成组件 Props 文件')
-    .option('--style <style>', '组件样式方案 (none | css | scss)', 'none')
-    .option('--json', '以 JSON 格式输出结果')
-    .action(async (name, options) => {
-    const { generateComponent } = await import('./commands/generate/component.js');
-    await generateComponent(name, options);
-});
-generateCmd
-    .command('api <name>')
-    .description('生成 API 模块 (位于 src/api/)')
-    .option('-e, --endpoint <endpoint>', 'API 请求路径 (如 /api/v1/orders)')
-    .option('-m, --method <method>', 'HTTP 请求方法 (get | post | put | patch | delete)', 'get')
-    .option('--client <client>', '指定已有 HTTP 客户端路径')
-    .option('--init-client', '若不存在则初始化标准 HTTP 客户端')
-    .option('--json', '以 JSON 格式输出结果')
-    .action(async (name, options) => {
-    const { generateApi } = await import('./commands/generate/api.js');
-    await generateApi(name, options);
-});
-program.parseAsync(process.argv).catch((err) => {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(message);
-    process.exit(1);
-});
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { getVersion } from './common/get-version.js';
+import { PROJECT_CONTAINERS } from './common/project-layout.js';
+const program = new Command();
+program.version(`@farris/cli ${getVersion()}`);
+// ==========================================
+// 存量命令 (保持向后兼容)
+// ==========================================
+program
+    .command('build')
+    .description('构建应用产物')
+    .option('-c, --configFile [configFile]', 'Farris 配置文件路径')
+    .option('-vc, --viteConfigFile [viteConfigFile]', 'Vite 配置文件路径')
+    .option('-b, --base [base]', '覆盖构建公共路径 Base (如 / 或 ./ 或 /apps/xxx/)')
+    .option('-ep, --emitPackage', '是否生成 dist/package.json 发布清单')
+    .option('-f, --format <format>', '覆盖产物交付格式 (es | umd | systemjs | iife)')
+    .option('-o, --outDir <outDir>', '覆盖产物输出目录 (默认 ./dist)')
+    .action(async (options) => {
+    process.env.BUILD_TYPE = 'app';
+    const { buildCommon } = await import('./commands/build.js');
+    await buildCommon({ ...options, type: 'app' });
+});
+program
+    .command('build-lib')
+    .description('构建 Library 产物')
+    .option('-c, --configFile [configFile]', 'Farris 配置文件路径')
+    .option('-vc, --viteConfigFile [viteConfigFile]', 'Vite 配置文件路径')
+    .option('-f, --format [format]', '产物格式 (es | umd | systemjs)')
+    .option('-d, --dts', '是否生成类型声明文件')
+    .option('-ep, --emitPackage', '是否生成 package.json')
+    .action(async (options) => {
+    process.env.BUILD_TYPE = 'lib';
+    const { buildLib } = await import('./commands/build-lib.js');
+    await buildLib(options);
+});
+program
+    .command('build-components')
+    .description('构建组件库产物')
+    .option('-c, --configFile [configFile]', 'Farris 配置文件路径')
+    .option('-vc, --viteConfigFile [viteConfigFile]', 'Vite 配置文件路径')
+    .action(async (options) => {
+    process.env.BUILD_TYPE = 'components';
+    const { buildComponents } = await import('./commands/build-components.js');
+    await buildComponents(options);
+});
+program
+    .command('build-css')
+    .description('构建样式产物')
+    .option('-e, --entry [entry]', '样式入口文件')
+    .option('-o, --outfile [outfile]', '样式输出文件')
+    .option('-m, --minify [minify]', '是否压缩')
+    .action(async (options) => {
+    process.env.BUILD_TYPE = 'css';
+    const { buildCss } = await import('./commands/build-css.js');
+    await buildCss(options);
+});
+program
+    .command('create [name] [extra...]')
+    // 多余的位置参数由 action 统一报错（commander 默认会静默忽略，导致误进交互）
+    .usage('[options] [name]')
+    .description('新建 pnpm workspace，可选创建一个工程')
+    .option('-y, --yes', '使用默认值，跳过问答')
+    .option('--json', '以 JSON 格式输出结果')
+    .option('--project <name>', '非交互时指定工程名（旧名 --app 仍可用）')
+    .option('--no-project', '不创建工程')
+    .option('--type <type>', '工程类型 (app | lib | micro)', 'app')
+    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
+    .option('--platform <platform>', '应用平台 (web | mobile)', 'web')
+    .option('--format <format>', '应用默认交付格式 (es | umd | systemjs | iife)', 'es')
+    .option('--formats <formats>', 'lib 产物格式，逗号分隔 (es,cjs,umd,systemjs)')
+    .option('--install', '生成后执行 pnpm install')
+    .option('--force', '确认覆盖与模板同名的已有文件（非交互模式必须显式指定）')
+    .addHelpText('after', [
+    '',
+    '示例：',
+    '  # 一键生成（npm create 会把 --type/--project 当成 npm 配置吞掉，选项必须写在 -- 之后）',
+    '  npm create farris@latest my-workspace -- --yes --type app --project shop --install',
+    '  # 指定版本（npx 会复用旧缓存，用 @latest 或 @x.y.z 强制取新版）',
+    '  npm create farris@0.1.9 my-workspace -- --yes --type app --project shop',
+    '  # 直接用 CLI（不需要 -- 分隔）',
+    '  farris-cli create my-workspace --yes --type app --project shop --install',
+    '  # 只建 workspace 外壳，不建工程',
+    '  farris-cli create my-workspace --yes --no-project',
+    ''
+].join('\n'))
+    .action(async (name, extra, options) => {
+    const { create, excessArgumentMessage } = await import('./commands/create.js');
+    if (Array.isArray(extra) && extra.length > 0) {
+        // 典型场景：npm create 吞掉选项后只剩取值（ws app shop），必须报错而不是静默交互
+        throw new Error(excessArgumentMessage(extra[0]));
+    }
+    const noProject = options.noProject === true || options.project === false;
+    const project = typeof options.project === 'string' ? options.project : undefined;
+    await create(name, {
+        yes: options.yes,
+        json: options.json,
+        install: options.install,
+        project,
+        noProject,
+        type: options.type,
+        style: options.style,
+        platform: options.platform,
+        format: options.format,
+        formats: options.formats,
+        force: options.force
+    });
+});
+program
+    .command('add-app [name]')
+    .description(`向当前 workspace 添加应用 → ${PROJECT_CONTAINERS.app}/<name>`)
+    .option('-t, --title <title>', '应用展示标题')
+    .option('--platform <platform>', '应用平台 (web | mobile)', 'web')
+    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
+    .option('--format <format>', '产物交付格式 (es | systemjs)', 'es')
+    .option('--json', '以 JSON 格式输出结果')
+    .option('--force', '确认覆盖与模板同名的已有文件')
+    .option('--install', '添加后执行 pnpm install', false)
+    .action(async (name, options) => {
+    const { addApp } = await import('./commands/add-app.js');
+    await addApp(name, options);
+});
+program
+    .command('add-lib [name]')
+    .description(`向当前 workspace 添加组件库 → ${PROJECT_CONTAINERS.lib}/<name>`)
+    .option('-t, --title <title>', '组件库展示标题')
+    .option('--formats <formats>', 'lib 产物格式，逗号分隔 (es,cjs,umd,systemjs)')
+    .option('--json', '以 JSON 格式输出结果')
+    .option('--force', '确认覆盖与模板同名的已有文件')
+    .option('--install', '添加后执行 pnpm install', false)
+    .action(async (name, options) => {
+    const { addLib } = await import('./commands/add-lib.js');
+    await addLib(name, options);
+});
+program
+    .command('add-micro [name]')
+    .description(`向当前 workspace 添加微应用 → ${PROJECT_CONTAINERS.app}/<name>`)
+    .option('-t, --title <title>', '微应用展示标题')
+    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
+    .option('--format <format>', '产物交付格式 (iife | es | systemjs)', 'iife')
+    .option('--json', '以 JSON 格式输出结果')
+    .option('--force', '确认覆盖与模板同名的已有文件')
+    .option('--install', '添加后执行 pnpm install', false)
+    .action(async (name, options) => {
+    const { addMicro } = await import('./commands/add-micro.js');
+    await addMicro(name, options);
+});
+program
+    .command('create-app [name]')
+    .description('新建 App / Lib 模板')
+    .option('--type <type>', '工程类型 (app | lib)')
+    .option('--platform <platform>', '应用平台 (web | mobile)')
+    .option('--formats <formats>', 'lib 产物格式，逗号分隔 (es,cjs,umd,systemjs)')
+    .option('--format <format>', 'app 产物格式 (iife | es | umd | systemjs)')
+    .option('-y, --yes', '使用默认值，跳过问答')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (name, options) => {
+    const { createApp } = await import('./commands/create-app.js');
+    await createApp(name, options);
+});
+program
+    .command('dev')
+    .description('创建 Dev Server')
+    .option('-p, --port [port]', '开发服务器端口')
+    .option('--no-mock', '关闭开发期 mock，接口请求全部走代理')
+    .action(async (options) => {
+    process.env.BUILD_TYPE = 'app';
+    const { devServe } = await import('./commands/dev-serve.js');
+    await devServe(options);
+});
+program
+    .command('preview')
+    .description('创建 Preview Server')
+    .option('-p, --port [port]', '预览服务器端口')
+    .action(async (options) => {
+    process.env.BUILD_TYPE = 'app';
+    const { previewServe } = await import('./commands/preview-serve.js');
+    await previewServe(options);
+});
+program
+    .command('extract-i18n')
+    .description('抽取国际化资源到 JSON 文件')
+    .option('-c, --configFile [configFile]', '国际化配置文件路径')
+    .action(async (options) => {
+    const { extractI18n } = await import('./commands/extract-i18n.js');
+    await extractI18n(options);
+});
+// ==========================================
+// Workspace 命令组
+// ==========================================
+const workspaceCmd = program.command('workspace').description('Farris pnpm workspace 规范管理');
+workspaceCmd
+    .command('inspect [target]')
+    .description('检查目标目录安全状态')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (target = '.', options) => {
+    const { inspectWorkspace } = await import('./commands/workspace/inspect.js');
+    await inspectWorkspace(target, options);
+});
+workspaceCmd
+    .command('create [target]')
+    .description('初始化标准 Farris Vue pnpm workspace')
+    .option('-n, --name <name>', '应用名称 (package name)')
+    .option('-t, --title <title>', '应用展示标题')
+    .option('--router', '启用 Vue Router')
+    .option('--router-mode <mode>', '路由模式 (hash | history)', 'hash')
+    .option('--format <format>', '产物交付格式 (iife | es | systemjs)', 'iife')
+    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
+    .option('--json', '以 JSON 格式输出结果')
+    .option('--force', '确认覆盖与模板同名的已有文件（非交互模式必须显式指定）')
+    .option('--install', '是否在初始化完成后自动安装依赖 (pnpm install)', false)
+    .option('-y, --yes', '接受默认配置')
+    .action(async (target = '.', options) => {
+    const { createWorkspace } = await import('./commands/workspace/create.js');
+    await createWorkspace(target, options);
+});
+workspaceCmd
+    .command('add-app <name>')
+    .description('[已废弃] 请改用 farris-cli add-app')
+    .option('-t, --title <title>', '应用展示标题')
+    .option('--router', '启用 Vue Router')
+    .option('--router-mode <mode>', '路由模式 (hash | history)', 'hash')
+    .option('--format <format>', '产物交付格式 (iife | es | systemjs)', 'iife')
+    .option('--style <style>', '应用全局样式 (none | scss)', 'scss')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (name, options) => {
+    const { addAppToWorkspace } = await import('./commands/workspace/add-app.js');
+    await addAppToWorkspace(name, options);
+});
+workspaceCmd
+    .command('verify [target]')
+    .description('验证 Workspace 结构与规范合规性')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (target = '.', options) => {
+    const { verifyWorkspaceCommand } = await import('./commands/workspace/verify.js');
+    await verifyWorkspaceCommand(target, options);
+});
+// ==========================================
+// Generate 命令组
+// ==========================================
+const generateCmd = program.command('generate').alias('g').description('应用级代码生成器');
+generateCmd
+    .command('view <name>')
+    .description('生成 View 页面 (含必须调用的 composable)')
+    .option('-t, --title <title>', '页面展示标题')
+    .option('--with-route', '自动在路由中注册页面')
+    .option('--with-props', '生成页面 Props 文件')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (name, options) => {
+    const { generateView } = await import('./commands/generate/view.js');
+    await generateView(name, options);
+});
+generateCmd
+    .command('component <name>')
+    .description('生成通用组件（按需创建 src/components/）')
+    .option('--with-props', '生成组件 Props 文件')
+    .option('--no-props', '不生成组件 Props 文件')
+    .option('--style <style>', '组件样式方案 (none | css | scss)', 'none')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (name, options) => {
+    const { generateComponent } = await import('./commands/generate/component.js');
+    await generateComponent(name, options);
+});
+generateCmd
+    .command('api <name>')
+    .description('生成 API 模块 (位于 src/api/)')
+    .option('-e, --endpoint <endpoint>', 'API 请求路径 (如 /api/v1/orders)')
+    .option('-m, --method <method>', 'HTTP 请求方法 (get | post | put | patch | delete)', 'get')
+    .option('--client <client>', '指定已有 HTTP 客户端路径')
+    .option('--init-client', '若不存在则初始化标准 HTTP 客户端')
+    .option('--json', '以 JSON 格式输出结果')
+    .action(async (name, options) => {
+    const { generateApi } = await import('./commands/generate/api.js');
+    await generateApi(name, options);
+});
+program.parseAsync(process.argv).catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(message);
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map