create-csch5-monorepo 1.0.0

package/README.md

@@ -0,0 +1,87 @@
+# create-my-monorepo
+
+创建移动端 H5 Monorepo 项目的脚手架工具。
+
+## 使用方法
+
+### 创建新项目
+
+```bash
+npx create-my-monorepo my-project
+```
+
+### 交互式选项
+
+- 项目名称
+- 开发服务器端口
+- 是否包含神策埋点
+- 是否包含 VConsole 调试工具
+
+### 在现有目录初始化
+
+```bash
+mkdir my-project && cd my-project
+npx create-my-monorepo init
+```
+
+### 更新共享包
+
+在项目根目录运行：
+
+```bash
+npx create-my-monorepo update
+```
+
+这会更新 `packages/`、`scripts/` 和配置文件，但不会影响 `apps/` 下的项目代码。
+
+## 生成的项目结构
+
+```
+my-project/
+├── apps/
+│   └── my-project/         # 你的子项目
+│       ├── src/
+│       │   ├── views/      # 页面组件
+│       │   ├── router.js   # 路由配置
+│       │   ├── stores.js   # 状态管理
+│       │   ├── App.vue     # 根组件
+│       │   └── main.js     # 入口文件
+│       ├── index.html
+│       ├── vite.config.js
+│       └── package.json
+├── packages/               # 共享包
+│   ├── bridge/             # JSBridge 桥接
+│   ├── request/            # Axios 封装
+│   ├── sensors/            # 神策埋点
+│   ├── ui/                 # UI 组件
+│   ├── utils/              # 工具函数
+│   └── vconsole/           # 调试工具
+├── scripts/                # 脚本
+│   └── create-app.js       # 创建新子项目
+├── vite-plugin-root-env.js # 环境变量插件
+├── postcss.config.js       # PostCSS 配置
+├── turbo.json              # Turborepo 配置
+├── pnpm-workspace.yaml     # workspace 配置
+├── package.json
+└── .monoreporc             # 版本信息
+```
+
+## 下一步
+
+```bash
+cd my-project
+pnpm install
+pnpm --filter my-project dev
+```
+
+## 技术栈
+
+- Vue 3.5 + Vue Router 5 + Pinia 3
+- Vite 6
+- Turborepo 2.3
+- pnpm 9.15
+- 移动端适配（amfe-flexible + postcss-pxtorem）
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { create } from '../lib/commands/create.js';
+import { update } from '../lib/commands/update.js';
+import { init } from '../lib/commands/init.js';
+import pc from 'picocolors';
+
+program
+  .name('create-csch5-monorepo')
+  .description('Create a mobile H5 monorepo project')
+  .version('1.0.0');
+
+program
+  .command('create <project-name>')
+  .description('Create a new monorepo project')
+  .option('-p, --port <port>', 'Development server port', '3000')
+  .option('--no-sensors', 'Skip sensors analytics')
+  .option('--no-vconsole', 'Skip vconsole debugger')
+  .action(create);
+
+program
+  .command('update')
+  .description('Update shared packages and configurations')
+  .option('--check', 'Only check for updates')
+  .action(update);
+
+program
+  .command('init')
+  .description('Initialize monorepo in current directory')
+  .action(init);
+
+program.parse();

package/lib/commands/create.js

@@ -0,0 +1,212 @@
+import prompts from 'prompts';
+import path from 'path';
+import fs from 'fs-extra';
+import ora from 'ora';
+import { logger } from '../utils/logger.js';
+import { getTemplateDir, copyDir, renderTemplate, isDirEmpty } from '../utils/file.js';
+
+export async function create(projectName, options) {
+  const cwd = process.cwd();
+  const targetDir = path.resolve(cwd, projectName);
+
+  // 检查目录
+  if (fs.existsSync(targetDir)) {
+    if (!await isDirEmpty(targetDir)) {
+      const { overwrite } = await prompts({
+        type: 'confirm',
+        name: 'overwrite',
+        message: `目录 ${projectName} 已存在，是否覆盖？`,
+        initial: false
+      });
+      
+      if (!overwrite) {
+        logger.info('操作已取消');
+        return;
+      }
+      
+      await fs.emptyDir(targetDir);
+    }
+  }
+
+  // 交互式询问
+  const questions = [
+    {
+      type: options.port ? null : 'text',
+      name: 'port',
+      message: '开发服务器端口',
+      initial: '3000'
+    },
+    {
+      type: options.sensors === false ? null : 'confirm',
+      name: 'sensors',
+      message: '是否包含神策埋点？',
+      initial: true
+    },
+    {
+      type: options.vconsole === false ? null : 'confirm',
+      name: 'vconsole',
+      message: '是否包含 VConsole 调试工具？',
+      initial: true
+    }
+  ].filter(q => q.type !== null);
+
+  let answers = { port: options.port, sensors: true, vconsole: true };
+  
+  if (questions.length > 0) {
+    answers = await prompts(questions);
+    if (answers.port === undefined && options.port) answers.port = options.port;
+  }
+
+  const spinner = ora('正在创建项目...').start();
+
+  try {
+    // 创建目录
+    await fs.ensureDir(targetDir);
+    await fs.ensureDir(path.join(targetDir, 'apps', projectName));
+
+    // 复制共享包
+    spinner.text = '复制共享包...';
+    const templateDir = getTemplateDir();
+    await copyDir(
+      path.join(templateDir, 'packages'),
+      path.join(targetDir, 'packages')
+    );
+
+    // 复制 scripts
+    spinner.text = '复制脚本...';
+    await copyDir(
+      path.join(templateDir, 'scripts'),
+      path.join(targetDir, 'scripts')
+    );
+
+    // 渲染配置文件
+    spinner.text = '生成配置文件...';
+    const vars = {
+      projectName,
+      port: answers.port || options.port || '3000',
+      sensors: answers.sensors,
+      vconsole: answers.vconsole
+    };
+
+    await renderTemplate(
+      path.join(templateDir, '_package.json'),
+      path.join(targetDir, 'package.json'),
+      vars
+    );
+
+    await renderTemplate(
+      path.join(templateDir, 'pnpm-workspace.yaml'),
+      path.join(targetDir, 'pnpm-workspace.yaml'),
+      vars
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'turbo.json'),
+      path.join(targetDir, 'turbo.json')
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'postcss.config.js'),
+      path.join(targetDir, 'postcss.config.js')
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'vite-plugin-root-env.js'),
+      path.join(targetDir, 'vite-plugin-root-env.js')
+    );
+
+    // 生成子项目
+    spinner.text = '生成子项目...';
+    await generateApp(targetDir, projectName, vars);
+
+    // 写入版本信息
+    await fs.writeJson(path.join(targetDir, '.monoreporc'), {
+      version: '1.0.0',
+      createdAt: new Date().toISOString(),
+      apps: [projectName]
+    }, { spaces: 2 });
+
+    spinner.succeed('项目创建成功！');
+
+    // 输出后续步骤
+    console.log();
+    logger.success(`已创建项目 ${projectName}`);
+    console.log();
+    logger.dim('  下一步：');
+    console.log();
+    logger.dim(`  cd ${projectName}`);
+    logger.dim('  pnpm install');
+    logger.dim(`  pnpm --filter ${projectName} dev`);
+    console.log();
+
+  } catch (err) {
+    spinner.fail('创建失败');
+    logger.error(err.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * 生成子项目
+ */
+async function generateApp(targetDir, projectName, vars) {
+  const appDir = path.join(targetDir, 'apps', projectName);
+  const templateDir = getTemplateDir();
+  const appTemplateDir = path.join(templateDir, 'app');
+
+  // package.json
+  await renderTemplate(
+    path.join(appTemplateDir, '_package.json'),
+    path.join(appDir, 'package.json'),
+    vars
+  );
+
+  // vite.config.js
+  await renderTemplate(
+    path.join(appTemplateDir, 'vite.config.js'),
+    path.join(appDir, 'vite.config.js'),
+    vars
+  );
+
+  // index.html
+  await renderTemplate(
+    path.join(appTemplateDir, 'index.html'),
+    path.join(appDir, 'index.html'),
+    vars
+  );
+
+  // 环境变量
+  await fs.ensureDir(path.join(appDir, 'src'));
+  await renderTemplate(
+    path.join(appTemplateDir, '.env.development'),
+    path.join(appDir, '.env.development'),
+    vars
+  );
+  await renderTemplate(
+    path.join(appTemplateDir, '.env.staging'),
+    path.join(appDir, '.env.staging'),
+    vars
+  );
+  await renderTemplate(
+    path.join(appTemplateDir, '.env.production'),
+    path.join(appDir, '.env.production'),
+    vars
+  );
+
+  // src 目录
+  const srcFiles = ['main.js', 'App.vue', 'router.js', 'stores.js'];
+  for (const file of srcFiles) {
+    await renderTemplate(
+      path.join(appTemplateDir, 'src', file),
+      path.join(appDir, 'src', file),
+      vars
+    );
+  }
+
+  // views
+  await fs.ensureDir(path.join(appDir, 'src', 'views'));
+  await fs.copy(
+    path.join(appTemplateDir, 'src', 'views'),
+    path.join(appDir, 'src', 'views')
+  );
+}

package/lib/commands/init.js

@@ -0,0 +1,205 @@
+import prompts from 'prompts';
+import path from 'path';
+import fs from 'fs-extra';
+import ora from 'ora';
+import { logger } from '../utils/logger.js';
+import { getTemplateDir, copyDir, renderTemplate, isMonorepoRoot, isDirEmpty } from '../utils/file.js';
+
+export async function init() {
+  const cwd = process.cwd();
+
+  // 检查是否已经是 monorepo
+  if (isMonorepoRoot(cwd)) {
+    logger.error('当前目录已是 monorepo 项目');
+    process.exit(1);
+  }
+
+  // 检查目录是否为空
+  if (!await isDirEmpty(cwd)) {
+    const { confirm } = await prompts({
+      type: 'confirm',
+      name: 'confirm',
+      message: '当前目录不为空，是否继续初始化？',
+      initial: false
+    });
+
+    if (!confirm) {
+      logger.info('操作已取消');
+      return;
+    }
+  }
+
+  // 询问项目名
+  const { projectName } = await prompts({
+    type: 'text',
+    name: 'projectName',
+    message: '第一个子项目名称',
+    initial: path.basename(cwd)
+  });
+
+  if (!projectName) {
+    logger.info('操作已取消');
+    return;
+  }
+
+  // 其他询问
+  const answers = await prompts([
+    {
+      type: 'text',
+      name: 'port',
+      message: '开发服务器端口',
+      initial: '3000'
+    },
+    {
+      type: 'confirm',
+      name: 'sensors',
+      message: '是否包含神策埋点？',
+      initial: true
+    },
+    {
+      type: 'confirm',
+      name: 'vconsole',
+      message: '是否包含 VConsole 调试工具？',
+      initial: true
+    }
+  ]);
+
+  const spinner = ora('正在初始化...').start();
+
+  try {
+    const templateDir = getTemplateDir();
+    const vars = {
+      projectName,
+      port: answers.port,
+      sensors: answers.sensors,
+      vconsole: answers.vconsole
+    };
+
+    // 复制 packages
+    spinner.text = '复制共享包...';
+    await copyDir(
+      path.join(templateDir, 'packages'),
+      path.join(cwd, 'packages')
+    );
+
+    // 复制 scripts
+    spinner.text = '复制脚本...';
+    await copyDir(
+      path.join(templateDir, 'scripts'),
+      path.join(cwd, 'scripts')
+    );
+
+    // 渲染配置文件
+    spinner.text = '生成配置文件...';
+    await renderTemplate(
+      path.join(templateDir, '_package.json'),
+      path.join(cwd, 'package.json'),
+      vars
+    );
+
+    await renderTemplate(
+      path.join(templateDir, 'pnpm-workspace.yaml'),
+      path.join(cwd, 'pnpm-workspace.yaml'),
+      vars
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'turbo.json'),
+      path.join(cwd, 'turbo.json')
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'postcss.config.js'),
+      path.join(cwd, 'postcss.config.js')
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'vite-plugin-root-env.js'),
+      path.join(cwd, 'vite-plugin-root-env.js')
+    );
+
+    // 生成子项目
+    spinner.text = '生成子项目...';
+    await fs.ensureDir(path.join(cwd, 'apps', projectName));
+    await generateApp(cwd, projectName, vars);
+
+    // 写入版本信息
+    await fs.writeJson(path.join(cwd, '.monoreporc'), {
+      version: '1.0.0',
+      createdAt: new Date().toISOString(),
+      apps: [projectName]
+    }, { spaces: 2 });
+
+    spinner.succeed('初始化完成！');
+
+    console.log();
+    logger.success('Monorepo 项目初始化成功');
+    console.log();
+    logger.dim('  下一步：');
+    console.log();
+    logger.dim('  pnpm install');
+    logger.dim(`  pnpm --filter ${projectName} dev`);
+    console.log();
+
+  } catch (err) {
+    spinner.fail('初始化失败');
+    logger.error(err.message);
+    process.exit(1);
+  }
+}
+
+async function generateApp(targetDir, projectName, vars) {
+  const appDir = path.join(targetDir, 'apps', projectName);
+  const templateDir = getTemplateDir();
+  const appTemplateDir = path.join(templateDir, 'app');
+
+  await renderTemplate(
+    path.join(appTemplateDir, '_package.json'),
+    path.join(appDir, 'package.json'),
+    vars
+  );
+
+  await renderTemplate(
+    path.join(appTemplateDir, 'vite.config.js'),
+    path.join(appDir, 'vite.config.js'),
+    vars
+  );
+
+  await renderTemplate(
+    path.join(appTemplateDir, 'index.html'),
+    path.join(appDir, 'index.html'),
+    vars
+  );
+
+  await fs.ensureDir(path.join(appDir, 'src'));
+  await renderTemplate(
+    path.join(appTemplateDir, '.env.development'),
+    path.join(appDir, '.env.development'),
+    vars
+  );
+  await renderTemplate(
+    path.join(appTemplateDir, '.env.staging'),
+    path.join(appDir, '.env.staging'),
+    vars
+  );
+  await renderTemplate(
+    path.join(appTemplateDir, '.env.production'),
+    path.join(appDir, '.env.production'),
+    vars
+  );
+
+  const srcFiles = ['main.js', 'App.vue', 'router.js', 'stores.js'];
+  for (const file of srcFiles) {
+    await renderTemplate(
+      path.join(appTemplateDir, 'src', file),
+      path.join(appDir, 'src', file),
+      vars
+    );
+  }
+
+  await fs.ensureDir(path.join(appDir, 'src', 'views'));
+  await fs.copy(
+    path.join(appTemplateDir, 'src', 'views'),
+    path.join(appDir, 'src', 'views')
+  );
+}

package/lib/commands/update.js

@@ -0,0 +1,89 @@
+import fs from 'fs-extra';
+import path from 'path';
+import ora from 'ora';
+import { logger } from '../utils/logger.js';
+import { getTemplateDir, copyDir, isMonorepoRoot } from '../utils/file.js';
+
+const CURRENT_VERSION = '1.0.0';
+
+export async function update(options) {
+  const cwd = process.cwd();
+  
+  // 检查是否在 monorepo 根目录
+  if (!isMonorepoRoot(cwd)) {
+    logger.error('请在 monorepo 项目根目录执行此命令');
+    process.exit(1);
+  }
+
+  // 读取版本信息
+  const rcPath = path.join(cwd, '.monoreporc');
+  let rc = { version: '0.0.0', apps: [] };
+  
+  if (await fs.exists(rcPath)) {
+    rc = await fs.readJson(rcPath);
+  }
+
+  // 检查更新
+  if (options.check) {
+    if (rc.version === CURRENT_VERSION) {
+      logger.success('当前已是最新版本');
+    } else {
+      logger.info(`发现新版本: ${CURRENT_VERSION} (当前: ${rc.version})`);
+      logger.dim('运行 npx create-my-monorepo update 来更新');
+    }
+    return;
+  }
+
+  const spinner = ora('正在更新共享包...').start();
+
+  try {
+    const templateDir = getTemplateDir();
+
+    // 更新 packages
+    spinner.text = '更新 packages/...';
+    await copyDir(
+      path.join(templateDir, 'packages'),
+      path.join(cwd, 'packages')
+    );
+
+    // 更新 scripts
+    spinner.text = '更新 scripts/...';
+    await copyDir(
+      path.join(templateDir, 'scripts'),
+      path.join(cwd, 'scripts')
+    );
+
+    // 更新配置文件
+    spinner.text = '更新配置文件...';
+    await fs.copy(
+      path.join(templateDir, 'vite-plugin-root-env.js'),
+      path.join(cwd, 'vite-plugin-root-env.js')
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'postcss.config.js'),
+      path.join(cwd, 'postcss.config.js')
+    );
+
+    await fs.copy(
+      path.join(templateDir, 'turbo.json'),
+      path.join(cwd, 'turbo.json')
+    );
+
+    // 更新版本信息
+    rc.version = CURRENT_VERSION;
+    rc.updatedAt = new Date().toISOString();
+    await fs.writeJson(rcPath, rc, { spaces: 2 });
+
+    spinner.succeed('更新完成！');
+
+    console.log();
+    logger.success(`已更新到版本 ${CURRENT_VERSION}`);
+    logger.dim('请运行 pnpm install 安装可能新增的依赖');
+
+  } catch (err) {
+    spinner.fail('更新失败');
+    logger.error(err.message);
+    process.exit(1);
+  }
+}

package/lib/utils/file.js

@@ -0,0 +1,74 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * 获取模板目录路径
+ */
+export function getTemplateDir() {
+  return path.resolve(__dirname, '../../templates');
+}
+
+/**
+ * 检查目录是否为空
+ */
+export function isDirEmpty(dir) {
+  if (!fs.existsSync(dir)) return true;
+  const files = fs.readdirSync(dir);
+  return files.length === 0;
+}
+
+/**
+ * 复制目录，支持过滤
+ */
+export async function copyDir(src, dest, options = {}) {
+  const { exclude = [] } = options;
+  
+  await fs.ensureDir(dest);
+  const entries = await fs.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    // 检查是否在排除列表中
+    if (exclude.some(pattern => entry.name.match(pattern))) {
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath, options);
+    } else {
+      await fs.copy(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 读取并渲染模板文件
+ */
+export async function renderTemplate(src, dest, vars = {}) {
+  let content = await fs.readFile(src, 'utf-8');
+  
+  // 替换模板变量 {{varName}}
+  for (const [key, value] of Object.entries(vars)) {
+    const regex = new RegExp(`\\{\\{\\s*${key}\\s*\\}\\}`, 'g');
+    content = content.replace(regex, value);
+  }
+  
+  await fs.ensureDir(path.dirname(dest));
+  await fs.writeFile(dest, content);
+}
+
+/**
+ * 检查是否在 monorepo 项目中
+ */
+export function isMonorepoRoot(dir) {
+  const pnpmWorkspace = path.join(dir, 'pnpm-workspace.yaml');
+  const packageJson = path.join(dir, 'package.json');
+  
+  return fs.existsSync(pnpmWorkspace) && fs.existsSync(packageJson);
+}