create-arenapro-vite.cjs

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');

// 模板复制时需要忽略的文件/目录（包内部用，不会复制到目标项目）
// 其余的目录与文件一律按层级递归复制
const INTERNAL_IGNORE = new Set([
  'node_modules',
  '.git',
  '.turbo',
  '.idea',
  '.DS_Store',
  'dist',
  'coverage',
  'npm-debug.log',
  'create-arenapro-vite.cjs',
  'pnpm-lock.yaml',
  'bun.lock',
  'LICENSE',
  '.husky',
  'cli',
]);

// 当前一次执行时的目标目录，用于避免把历史生成结果再次当作模板复制
let CURRENT_TARGET_DIR = '';

// 校验 npm 包名是否符合规范
function isValidPackageName(name) {
  const pkgNamePattern =
    /^(?:(?:@(?:[a-z0-9-*~][a-z0-9-*._~]*)?\/[a-z0-9-._~])|[a-z0-9-~])[a-z0-9-._~]*$/;
  return pkgNamePattern.test(name);
}

function resolveTemplateRoot() {
  // 当前包根目录即模板根目录
  return path.resolve(__dirname);
}

function ensureDir(dir) {
  if (!fs.existsSync(dir)) {
    fs.mkdirSync(dir, { recursive: true });
  }
}

function copyDirRecursive(srcDir, destDir) {
  if (!fs.existsSync(srcDir)) {
    return;
  }

  // 避免把已经生成过的目标目录当成模板再次复制，造成无限嵌套
  if (CURRENT_TARGET_DIR && srcDir.startsWith(CURRENT_TARGET_DIR)) {
    return;
  }

  ensureDir(destDir);

  const entries = fs.readdirSync(srcDir, { withFileTypes: true });

  for (const entry of entries) {
    const srcPath = path.join(srcDir, entry.name);
    const destPath = path.join(destDir, entry.name);

    if (INTERNAL_IGNORE.has(entry.name)) {
      continue;
    }

    // 同样避免进入目标目录下的任何内容
    if (CURRENT_TARGET_DIR && srcPath.startsWith(CURRENT_TARGET_DIR)) {
      continue;
    }

    if (entry.isDirectory()) {
      copyDirRecursive(srcPath, destPath);
    } else if (entry.isFile()) {
      fs.copyFileSync(srcPath, destPath);
    }
  }
}

function adjustPackageJson(targetDir, projectName) {
  const targetPkgPath = path.join(targetDir, 'package.json');
  if (!fs.existsSync(targetPkgPath)) {
    return;
  }

  try {
    const raw = fs.readFileSync(targetPkgPath, 'utf8');
    const pkg = JSON.parse(raw);
    pkg.name = projectName;

    // 生成的项目不再作为 CLI 包发布，移除 bin 字段
    if (pkg.bin) {
      delete pkg.bin;
    }
    pkg.dependencies = {
      i18next: '^25.8.0',
    };
    if (pkg.keywords) {
      delete pkg.keywords;
    }
    if (pkg.author) {
      delete pkg.author;
    }
    // 为生成的项目补充 npm 包导出配置，暴露 dist 下的 client/server bundle
    pkg.exports = {
      '.': {
        import: './dist/server/src/App.js',
        types: './dist/server/src/App.d.ts',
      },
      './client': {
        import: './dist/client/src/App.js',
        types: './dist/client/src/App.d.ts',
      },
      './server': {
        import: './dist/server/src/App.js',
        types: './dist/server/src/App.d.ts',
      },
      './shares': {
        import: './dist/shares/src/App.js',
        types: './dist/shares/src/App.d.ts',
      },
    };

    pkg.files = ['dist/**/*'];

    fs.writeFileSync(
      targetPkgPath,
      `${JSON.stringify(pkg, null, 2)}\n`,
      'utf8'
    );
  } catch (err) {
    console.warn('调整目标 package.json 失败：', err);
  }
}

function writeGitignore(targetDir) {
  const gitignorePath = path.join(targetDir, '.gitignore');
  const content = [
    'node_modules/',
    '**/.log/',
    '**/dist/',
    '.env',
    '.env.*',
    '!.env.example',
    '.DS_Store',
    '*.tmp',
    '*.swp',
    '',
  ].join('\n');

  fs.writeFileSync(gitignorePath, content, 'utf8');
}

function main() {
  const args = process.argv.slice(2);
  const projectName = args[0];
  if (!projectName) {
    console.error('\n[创建中止] 未指定项目目录。');
    process.exit(1);
  }
  const cwd = process.cwd();
  const targetDir = path.resolve(cwd, projectName);

  // if (fs.existsSync(targetDir)) {
  //   console.error('\n[创建失败] 目标目录已存在');
  //   console.error(`- 目录名称：${projectName}`);
  //   console.error(`- 目录路径：${targetDir}`);
  //   console.error('\n请尝试：');
  //   console.error('1. 更换一个项目名称重新执行命令；');
  //   console.error('2. 或者先删除/备份该目录后再重新创建。\n');
  //   process.exit(1);
  // }

  CURRENT_TARGET_DIR = targetDir;

  // 对 package.json 中的 name 字段做校验，不合规时回退为 my-arena-project
  const packageName = isValidPackageName(projectName)
    ? projectName
    : 'my-arena-project';
  console.log('\n==========================================');
  console.log('  ArenaPro Vite 项目创建向导');
  console.log('==========================================');
  console.log(`项目名称：${packageName}`);
  console.log(`目标目录：${targetDir}`);
  console.log('------------------------------------------');

  const templateRoot = resolveTemplateRoot();
  copyDirRecursive(templateRoot, targetDir);
  adjustPackageJson(targetDir, packageName);
  writeGitignore(targetDir);

  console.log('\n项目文件已生成并完成基础配置。');
  console.log('\n下一步操作建议：');
  console.log(`  1. 进入项目目录：cd ${projectName}`);
  console.log('  2. 安装依赖：npm install');
  console.log('  3. 启动开发服务器：npm run dev');
}

main();