@farris/cli 2.0.3 → 2.1.0

package/lib/index.js

@@ -1,84 +1,178 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { getVersion } from "./common/get-version.js";
+import { getVersion } from './common/get-version.js';
 const program = new Command();
 program.version(`@farris/cli ${getVersion()}`);
+// ==========================================
+// 存量命令 (保持向后兼容)
+// ==========================================
 program
     .command('build')
-    .description('构建')
-    .option('-c --configFile [configFile]', 'config file path')
-    .option('-vc --viteConfigFile [viteConfigFile]', 'vite config file path')
+    .description('构建应用产物')
+    .option('-c, --configFile [configFile]', 'Farris 配置文件路径')
+    .option('-vc, --viteConfigFile [viteConfigFile]', 'Vite 配置文件路径')
+    .option('-b, --base [base]', '覆盖构建公共路径 Base (如 / 或 ./ 或 /apps/xxx/)')
     .action(async (options) => {
     process.env.BUILD_TYPE = 'app';
     const { buildCommon } = await import('./commands/build.js');
-    buildCommon(options);
+    await buildCommon(options);
 });
 program
     .command('build-lib')
-    .description('构建')
-    .option('-c --configFile [configFile]', 'config file path')
-    .option('-vc --viteConfigFile [viteConfigFile]', 'vite config file path')
-    .option('-f --format [format]', 'lib format')
-    .option('-d --dts', 'dts')
-    .option('-ep --emitPackage', 'createPackage')
+    .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');
-    return buildLib(options);
+    await buildLib(options);
 });
 program
     .command('build-components')
-    .description('构建')
-    .option('-c --configFile [configFile]', 'config file path')
-    .option('-vc --viteConfigFile [viteConfigFile]', 'vite config file path')
+    .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');
-    return buildComponents(options);
+    await buildComponents(options);
 });
 program
     .command('build-css')
-    .description('构建')
-    .option('-e --entry [entry]', 'entry file')
-    .option('-o --outfile [outfile]', 'outfile')
-    .option('-m --minify [minify]', 'minify')
+    .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');
-    return buildCss(options);
+    await buildCss(options);
 });
 program
     .command('create-app')
-    .description('新建 App 模板')
+    .description('新建 App 模板 (旧版单体模板向后兼容)')
     .action(async () => {
     const { createApp } = await import('./commands/create-app.js');
-    return createApp();
+    await createApp();
 });
 program
     .command('dev')
     .description('创建 Dev Server')
-    .option('-p --port [port]', 'Server Port')
+    .option('-p, --port [port]', '开发服务器端口')
     .action(async (options) => {
     process.env.BUILD_TYPE = 'app';
     const { devServe } = await import('./commands/dev-serve.js');
-    return devServe(options);
+    await devServe(options);
 });
 program
     .command('preview')
     .description('创建 Preview Server')
-    .option('-p --port [port]', 'Server Port')
+    .option('-p, --port [port]', '预览服务器端口')
     .action(async (options) => {
     process.env.BUILD_TYPE = 'app';
     const { previewServe } = await import('./commands/preview-serve.js');
-    return previewServe(options);
+    await previewServe(options);
 });
 program
     .command('extract-i18n')
-    .description('抽取国际化资源到JSON文件')
-    .option('-c --configFile [configFile]', 'config file path')
+    .description('抽取国际化资源到 JSON 文件')
+    .option('-c, --configFile [configFile]', '国际化配置文件路径')
     .action(async (options) => {
     const { extractI18n } = await import('./commands/extract-i18n.js');
-    return extractI18n(options);
+    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('--app-dir <dir>', '子应用目录名 (默认从 name 推导)')
+    .option('--router', '启用 Vue Router')
+    .option('--router-mode <mode>', '路由模式 (hash | history)', 'hash')
+    .option('--format <format>', '产物交付格式 (es | systemjs)', 'es')
+    .option('--style <style>', '应用全局样式 (none | css | scss)', 'css')
+    .option('--json', '以 JSON 格式输出结果')
+    .option('--force', '确认覆盖与模板同名的已有文件（非交互模式必须显式指定）')
+    .option('--no-install', '不自动安装依赖', true)
+    .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('在现有 Workspace 中添加新应用')
+    .option('-t, --title <title>', '应用展示标题')
+    .option('--app-dir <dir>', '子应用目录名 (默认从 name 推导)')
+    .option('--router', '启用 Vue Router')
+    .option('--router-mode <mode>', '路由模式 (hash | history)', 'hash')
+    .option('--format <format>', '产物交付格式 (es | systemjs)', 'es')
+    .option('--style <style>', '应用全局样式 (none | css | scss)', 'css')
+    .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.parse();
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,17 +1,19 @@
 {
     "name": "@farris/cli",
     "private": false,
-    "version": "2.0.3",
+    "version": "2.1.0",
     "type": "module",
     "typings": "lib/index.d.ts",
     "bin": {
         "farris-cli": "./bin/index.js"
     },
     "engines": {
-        "node": ">=16.0.0"
+        "node": "^18.0.0 || >=20.0.0",
+        "pnpm": ">=9.0.0"
     },
-    "scripts": {
-        "build": "rimraf ./lib && tsc"
+    "scripts": {
+        "build": "rimraf ./lib && tsc",
+        "test": "vitest run --config vitest.config.ts"
     },
     "files": [
         "lib",
@@ -26,17 +28,19 @@
         "commander": "^9.4.0",
         "esbuild": "^0.23.0",
         "esbuild-sass-plugin": "^3.3.1",
+        "fs-extra": "^11.2.0",
+        "glob": "^10.4.5",
         "inquirer": "^9.3.0",
         "ora": "^8.0.1",
-        "typescript": "^4.6.4",
-        "vite": "^4.5.10",
+        "typescript": "^5.7.3",
+        "vite": "^5.4.19",
         "vite-plugin-css-injected-by-js": "^3.5.2",
-        "vite-plugin-dts": "^3.9.1",
-        "glob": "11.0.3"
+        "vite-plugin-dts": "^3.9.1"
     },
     "devDependencies": {
+        "@types/fs-extra": "^11.0.4",
         "@types/inquirer": "^9.0.7",
         "rimraf": "^5.0.7",
-        "vue": "^3.2.37"
+        "vue": "^3.5.13"
     }
-}
+}

package/templates/workspace/app/farris.config.mjs

@@ -0,0 +1,13 @@
+import { fileURLToPath, URL } from 'node:url';
+
+export default {
+  base: '<%= base %>',
+  routerMode: '<%= routerMode %>',
+  format: '<%= format %>',
+  minify: true,
+  externalDependencies: false,
+  alias: [
+    { find: '@', replacement: fileURLToPath(new URL('./src', import.meta.url)) }
+  ],
+  viteConfig: {}
+};

package/templates/{lib → workspace/app}/index.html

@@ -1,12 +1,12 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Vite App</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.ts"></script>
-  </body>
-</html>
+<!DOCTYPE html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title><%= title %></title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/workspace/app/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "<%= appName %>",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "farris-cli dev",
+    "build": "farris-cli build",
+    "preview": "farris-cli preview",
+    "typecheck": "vue-tsc --noEmit"
+  },
+  "dependencies": {
+    "@farris/ui-vue": "catalog:",
+    "vue": "catalog:"<%= routerDependency %>
+  },
+  "devDependencies": {
+    "@farris/cli": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vue-tsc": "catalog:"<%= sassDevDependency %>
+  }
+}

package/templates/workspace/app/src/App.tsx

@@ -0,0 +1,11 @@
+import { defineComponent } from 'vue';<%= appRouterImport %>
+
+export default defineComponent({
+    name: 'App',
+    setup() {
+        return () => (
+<%= appTemplateBody %>
+        );
+    }
+});
+

package/templates/workspace/app/src/main.ts

@@ -0,0 +1,11 @@
+import { createApp } from 'vue';
+import FarrisUI from '@farris/ui-vue';
+import '@farris/ui-vue/style.css';<%= styleImport %><%= routerImport %><%= i18nImport %>
+import App from './App';
+
+const app = createApp(App);
+
+app.use(FarrisUI);<%= routerUse %><%= i18nUse %>
+
+app.mount('#app');
+

package/templates/workspace/app/src/router/index.ts

@@ -0,0 +1,16 @@
+import { createRouter, <%= routerHistoryFunction %>, type RouteRecordRaw } from 'vue-router';
+
+export const routes: RouteRecordRaw[] = [
+  {
+    path: '/',
+    name: 'Home',
+    component: () => import('../views/home')
+  }
+];
+
+const router = createRouter({
+  history: <%= routerHistoryCall %>,
+  routes
+});
+
+export default router;

package/templates/workspace/app/src/views/home/composables/use-home.ts

@@ -0,0 +1,7 @@
+export function useHome() {
+  const title = '<%= title %>';
+
+  return {
+    title
+  };
+}

package/templates/workspace/app/src/views/home/home.component.tsx

@@ -0,0 +1,15 @@
+import { defineComponent } from 'vue';
+import { useHome } from './composables/use-home';
+
+export default defineComponent({
+  name: 'HomeView',
+  setup() {
+    const { title } = useHome();
+
+    return () => (
+      <div class="f-page-home">
+        <h2>{title}</h2>
+      </div>
+    );
+  }
+});

package/templates/workspace/app/src/views/home/index.ts

@@ -0,0 +1,4 @@
+import HomeComponent from './home.component';
+
+export { HomeComponent };
+export default HomeComponent;

package/templates/workspace/app/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "strict": true,
+    "jsx": "preserve",
+    "jsxImportSource": "vue",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "lib": ["ESNext", "DOM"],
+    "skipLibCheck": true,
+    "types": ["vite/client"],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]
+}

package/templates/workspace/root/README.md

@@ -0,0 +1,28 @@
+# <%= title %>
+
+基于 Farris Vue 的前端工程 Workspace。
+
+## 目录结构
+
+```text
+├── packages/
+│   └── <%= appDir %>/          # 应用源码
+├── pnpm-workspace.yaml  # pnpm workspace 配置及 Catalog 依赖版本
+└── package.json         # 根工程脚本
+```
+
+## 快速上手
+
+```bash
+# 安装依赖
+pnpm install
+
+# 启动开发服务器
+pnpm --filter "<%= appName %>" dev
+
+# 执行全量类型检查
+pnpm typecheck
+
+# 构建生产产物
+pnpm build
+```

package/templates/workspace/root/package.json

@@ -0,0 +1,13 @@
+{
+  "private": true,
+  "packageManager": "pnpm@<%= pnpmVersion %>",
+  "engines": {
+    "node": "^18.0.0 || >=20.0.0",
+    "pnpm": ">=9.0.0 <10.0.0"
+  },
+  "scripts": {
+    "build": "pnpm --recursive --if-present run build",
+    "dev": "pnpm --recursive --if-present run dev",
+    "typecheck": "pnpm --recursive --if-present run typecheck"
+  }
+}

package/templates/workspace/root/pnpm-workspace.yaml

@@ -0,0 +1,12 @@
+packages:
+  - "packages/*"
+
+catalog:
+  "@farris/ui-vue": "<%= farrisUiVueVersion %>"
+  "@farris/cli": "<%= farrisCliVersion %>"
+  "typescript": "<%= typescriptVersion %>"
+  "vite": "<%= viteVersion %>"
+  "vue": "<%= vueVersion %>"
+  "vue-router": "<%= vueRouterVersion %>"
+  "vue-tsc": "<%= vueTscVersion %>"
+  "sass": "<%= sassVersion %>"

package/templates/lib/.eslintrc.cjs

@@ -1,15 +0,0 @@
-/* eslint-env node */
-require('@rushstack/eslint-patch/modern-module-resolution');
-
-module.exports = {
-  root: true,
-  'extends': [
-    'plugin:vue/vue3-essential',
-    'eslint:recommended',
-    '@vue/eslint-config-typescript',
-    '@vue/eslint-config-prettier/skip-formatting'
-  ],
-  parserOptions: {
-    ecmaVersion: 'latest'
-  }
-};

package/templates/lib/.prettierrc.json

@@ -1,8 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/prettierrc",
-  "semi": false,
-  "tabWidth": 2,
-  "singleQuote": true,
-  "printWidth": 100,
-  "trailingComma": "none"
-}

package/templates/lib/components/button/index.ts

@@ -1,7 +0,0 @@
-import { Plugin } from 'vue';
-import { withInstall } from '@components/common';
-import ButtonInstallless from './src/button.component';
-
-const Button = withInstall(ButtonInstallless);
-export { Button };
-export default Button as typeof Button & Plugin;

package/templates/lib/components/button/src/button.component.tsx

@@ -1,84 +0,0 @@
-import { CSSProperties, computed, defineComponent } from 'vue';
-import { useBem } from '@/components/common';
-import { BUTTON_NAME, ButtonProps, buttonProps } from './button.props';
-
-export default defineComponent({
-  name: BUTTON_NAME,
-  props: buttonProps,
-  emits: ['click'],
-  setup(props: ButtonProps, context) {
-    const { slots } = context;
-
-    const { bem, getModifierClass } = useBem(BUTTON_NAME);
-
-    const buttonClass = computed(() => {
-      const classList = [bem(), getModifierClass(props.type)];
-      props.disabled && classList.push(getModifierClass('disabled'));
-      props.block && classList.push(getModifierClass('block'));
-      props.round && classList.push(getModifierClass('round'));
-      props.plain && classList.push(getModifierClass('plain'));
-      props.noBorder && classList.push(getModifierClass('noborder'));
-      props.loading && classList.push(getModifierClass('loading'));
-      props.size && classList.push(getModifierClass(props.size));
-      return classList;
-    });
-
-    const applyGradientBorderBehavior = (style: CSSProperties, color: string) =>{
-      const isGradientColor = color.includes('gradient');
-      if (isGradientColor) {
-        style.border = 0;
-      } else {
-        style.borderColor = color;
-      }
-    };
-
-    const buttonStyle = computed(() => {
-      const textColor = props.plain ? props.color : '#fff';
-      const backgroundColor = !props.plain ? props.color : null;
-
-      const style: CSSProperties = {};
-      if (props.color) {
-        style.color = textColor;
-        style.boxShadow = 'none';
-        backgroundColor && (style.background = backgroundColor);
-        applyGradientBorderBehavior(style, props.color);
-      }
-      return style;
-    });
-
-    const onClickButton = ($event: Event) =>{
-      $event.stopPropagation();
-      if (!props.disabled) {
-        context.emit('click', $event);
-      }
-    };
-
-    const renderLoading = () => {
-      return (
-        props.loading && <>
-          <span class={bem('loading')}>
-            <svg viewBox="25 25 50 50" class={bem('loading-icon-circular')}>
-              <circle cx="50" cy="50" r="20" fill="none" />
-            </svg>
-          </span>
-          {props.loadingText && <span class={bem('loading-text')}>{props.loadingText}</span>}
-        </>
-      );
-    };
-
-    const renderText = ()=> {
-      return slots.default && <span class={bem('text')}>{slots.default()}</span>;
-    };
-
-    return () => (
-      <button
-        class={buttonClass.value}
-        style={buttonStyle.value}
-        onClick={onClickButton}
-      >
-        {renderLoading()}
-        {renderText()}
-      </button>
-    );
-  }
-});