cf-yoyo 1.0.0

package/src/cli/commands/list.ts

@@ -0,0 +1,97 @@
+/**
+ * list 命令實現
+ * 負責列出可用的專案模板
+ */
+
+import { Command } from 'commander';
+import { logger } from '../../utils/logger';
+import { ProjectType, TemplateInfo, Language } from '../../types';
+import { getAllTemplates } from '../../core/template-manager';
+
+/**
+ * 建立 list 命令
+ */
+export function createListCommand(program: Command): void {
+  program
+    .command('list')
+    .description('列出可用的專案模板')
+    .option('--type <type>', '根據專案類型過濾')
+    .option('--language <language>', '根據語言過濾 (typescript, javascript)')
+    .action((options: { type?: string; language?: string }) => {
+      logger.empty();
+      logger.icon('📋', '可用的專案模板');
+      logger.divider();
+      logger.empty();
+
+      // 從 template-manager 獲取實際可用的模板
+      const allTemplates = getAllTemplates();
+      let templates: TemplateInfo[];
+
+      if (options.type) {
+        const normalizedType = options.type.toLowerCase();
+        // 驗證專案類型
+        const validTypes = Object.values(ProjectType);
+        if (!validTypes.includes(normalizedType as ProjectType)) {
+          logger.warn(`找不到符合類型 "${options.type}" 的模板`);
+          logger.empty();
+          logger.info(`可用的專案類型：${validTypes.join(', ')}`);
+          return;
+        }
+        templates = allTemplates.filter((t) => t.projectType === normalizedType);
+      } else {
+        templates = allTemplates;
+      }
+
+      // 根據語言過濾
+      if (options.language) {
+        const lang =
+          options.language.toLowerCase() === 'javascript'
+            ? Language.JAVASCRIPT
+            : Language.TYPESCRIPT;
+        templates = templates.filter((t) => t.language === lang);
+      }
+
+      if (templates.length === 0) {
+        logger.warn(`找不到符合條件的模板`);
+        logger.empty();
+        logger.info(`可用的專案類型：${Object.values(ProjectType).join(', ')}`);
+        return;
+      }
+
+      // 按照專案類型分組
+      const grouped: Record<string, TemplateInfo[]> = {};
+      for (const template of templates) {
+        const key = template.projectType;
+        if (!grouped[key]) {
+          grouped[key] = [];
+        }
+        grouped[key].push(template);
+      }
+
+      // 輸出分組信息
+      const icons: Record<string, string> = {
+        [ProjectType.WORKER]: '☁️',
+        [ProjectType.PAGES]: '📄',
+        [ProjectType.D1]: '🗄️',
+        [ProjectType.KV]: '📦',
+        [ProjectType.R2]: '🪣',
+      };
+
+      for (const [type, typeTemplates] of Object.entries(grouped)) {
+        logger.icon('🏷️', `專案類型：${type}`);
+        logger.divider('─', 30);
+        typeTemplates.forEach((template) => {
+          const icon = icons[type] || '📁';
+          const langTag = template.language === Language.JAVASCRIPT ? ' (JS)' : ' (TS)';
+          logger.info(` ${icon} ${template.name.padEnd(20)}${langTag} - ${template.description}`);
+        });
+        logger.empty();
+      }
+
+      logger.divider();
+      logger.empty();
+      logger.icon('💡', '使用方式：');
+      logger.info(' npx cf-yoyo create my-project --type <type>');
+      logger.empty();
+    });
+}

package/src/cli/index.ts

@@ -0,0 +1,71 @@
+/**
+ * CLI 入口模組
+ * 負責初始化 Commander.js 並註冊所有命令
+ */
+
+import { Command } from 'commander';
+import { createCommand } from './commands/create';
+import { createListCommand } from './commands/list';
+import { createGitCommand } from './commands/git';
+import { logger } from '../utils/logger';
+
+/**
+ * 初始化 CLI 應用
+ */
+export function initializeCLI(): Command {
+  const program = new Command();
+
+  // 設定 CLI 基本資訊
+  program
+    .name('cf-yoyo')
+    .description('Cloudflare 專案腳手架 CLI 工具 - 快速建立 Cloudflare Workers、Pages 等專案')
+    .version('1.0.0')
+    .helpOption('-h, --help', '顯示幫助信息')
+    .addHelpText(
+      'after',
+      `
+📚 使用範例：
+  $ cf-yoyo create              # 互動式建立專案
+  $ cf-yoyo create my-app       # 建立名為 my-app 的專案
+  $ cf-yoyo list                # 列出所有模板
+  $ cf-yoyo list --type worker  # 列出 Worker 相關模板
+  $ cf-yoyo git                 # 開啟 Git 操作互動選單
+
+💡 提示:
+  使用 create 命令建立新專案，使用 list 命令查看可用模板
+  使用 git 命令開啟 Git 操作互動選單（初始化、推送、克隆）
+`
+    );
+
+  // 註冊命令
+  createCommand(program);
+  createListCommand(program);
+  createGitCommand(program);
+
+  // 錯誤處理
+  program.showHelpAfterError();
+  program.showSuggestionAfterError();
+
+  return program;
+}
+
+/**
+ * 執行 CLI
+ */
+export async function runCLI(argv?: string[]): Promise<void> {
+  const program = initializeCLI();
+
+  // 如果沒有提供任何參數，顯示幫助
+  if (!argv || argv.length === 0) {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+      program.help();
+    }
+  }
+
+  // 解析命令行參數
+  program.parse(argv || process.argv);
+}
+
+// 預設匯出
+export default runCLI;

package/src/core/config.ts

@@ -0,0 +1,262 @@
+/**
+ * 專案配置解析模組
+ * 負責讀取用戶輸入、合併預設配置、生成最終配置物件
+ */
+
+import * as path from 'path';
+import { ProjectConfig, ProjectType, TemplateType, UserInput, Language } from '../types';
+import { logger } from '../utils/logger';
+
+/**
+ * 預設配置
+ */
+const DEFAULT_CONFIG: Omit<ProjectConfig, 'projectName' | 'targetDir'> = {
+  language: Language.TYPESCRIPT,
+  projectType: ProjectType.WORKER,
+  template: TemplateType.BASIC,
+  initGit: true,
+  installDeps: true,
+  nodeVersion: '18.0.0',
+  tsVersion: '5.0.0',
+};
+
+/**
+ * 專案類型映射表
+ */
+const PROJECT_TYPE_MAP: Record<string, ProjectType> = {
+  worker: ProjectType.WORKER,
+  pages: ProjectType.PAGES,
+  d1: ProjectType.D1,
+  kv: ProjectType.KV,
+  r2: ProjectType.R2,
+};
+
+/**
+ * 模板類型映射表
+ */
+const TEMPLATE_TYPE_MAP: Record<string, TemplateType> = {
+  basic: TemplateType.BASIC,
+  hono: TemplateType.HONO,
+  'itty-router': TemplateType.ITTY_ROUTER,
+  static: TemplateType.STATIC,
+  react: TemplateType.REACT,
+  vue: TemplateType.VUE,
+  nextjs: TemplateType.NEXTJS,
+};
+
+/**
+ * 驗證專案類型
+ */
+function validateProjectType(type: string): ProjectType {
+  const normalizedType = type.toLowerCase();
+  if (PROJECT_TYPE_MAP[normalizedType]) {
+    return PROJECT_TYPE_MAP[normalizedType];
+  }
+
+  // 如果無效，使用預設值
+  logger.warn(`無效的專案類型「${type}」，使用預設值「${DEFAULT_CONFIG.projectType}」`);
+  return DEFAULT_CONFIG.projectType;
+}
+
+/**
+ * 驗證模板類型
+ */
+function validateTemplateType(template: string, projectType: ProjectType): TemplateType {
+  const normalizedTemplate = template.toLowerCase();
+
+  // 檢查模板是否有效
+  if (TEMPLATE_TYPE_MAP[normalizedTemplate]) {
+    const templateType = TEMPLATE_TYPE_MAP[normalizedTemplate];
+
+    // 檢查模板是否與專案類型相容
+    if (isTemplateCompatible(templateType, projectType)) {
+      return templateType;
+    }
+  }
+
+  // 根據專案類型返回預設模板
+  return getDefaultTemplateForProjectType(projectType);
+}
+
+/**
+ * 檢查模板是否與專案類型相容
+ */
+function isTemplateCompatible(template: TemplateType, projectType: ProjectType): boolean {
+  switch (projectType) {
+    case ProjectType.WORKER:
+      return [TemplateType.BASIC, TemplateType.HONO, TemplateType.ITTY_ROUTER].includes(template);
+    case ProjectType.PAGES:
+      return [
+        TemplateType.STATIC,
+        TemplateType.REACT,
+        TemplateType.VUE,
+        TemplateType.NEXTJS,
+      ].includes(template);
+    case ProjectType.D1:
+    case ProjectType.KV:
+    case ProjectType.R2:
+      return template === TemplateType.BASIC;
+    default:
+      return false;
+  }
+}
+
+/**
+ * 獲取專案類型的預設模板
+ */
+function getDefaultTemplateForProjectType(projectType: ProjectType): TemplateType {
+  switch (projectType) {
+    case ProjectType.WORKER:
+      return TemplateType.BASIC;
+    case ProjectType.PAGES:
+      return TemplateType.STATIC;
+    case ProjectType.D1:
+    case ProjectType.KV:
+    case ProjectType.R2:
+      return TemplateType.BASIC;
+    default:
+      return TemplateType.BASIC;
+  }
+}
+
+/**
+ * 生成目標目錄路徑
+ */
+function generateTargetDir(projectName: string, cwd: string = process.cwd()): string {
+  return path.join(cwd, projectName);
+}
+
+/**
+ * 解析並合併用戶輸入與預設配置
+ */
+export function parseConfig(userInput: UserInput, options: { cwd?: string } = {}): ProjectConfig {
+  const { cwd = process.cwd() } = options;
+
+  // 驗證必填欄位
+  if (!userInput.projectName) {
+    throw new Error('專案名稱為必填欄位');
+  }
+
+  // 解析專案類型
+  const projectType = userInput.projectType || DEFAULT_CONFIG.projectType;
+
+  // 解析模板類型
+  const template = userInput.template
+    ? validateTemplateType(String(userInput.template), projectType)
+    : getDefaultTemplateForProjectType(projectType);
+
+  // 建立最終配置
+  const config: ProjectConfig = {
+    projectName: userInput.projectName.trim(),
+    language: userInput.language ?? DEFAULT_CONFIG.language,
+    projectType,
+    template,
+    initGit: userInput.initGit ?? DEFAULT_CONFIG.initGit,
+    installDeps: userInput.installDeps ?? DEFAULT_CONFIG.installDeps,
+    targetDir: generateTargetDir(userInput.projectName, cwd),
+    nodeVersion: DEFAULT_CONFIG.nodeVersion,
+    tsVersion: DEFAULT_CONFIG.tsVersion,
+  };
+
+  logger.debug(`配置解析完成：${JSON.stringify(config, null, 2)}`);
+
+  return config;
+}
+
+/**
+ * 語言類型映射表
+ */
+const LANGUAGE_MAP: Record<string, Language> = {
+  typescript: Language.TYPESCRIPT,
+  ts: Language.TYPESCRIPT,
+  javascript: Language.JAVASCRIPT,
+  js: Language.JAVASCRIPT,
+};
+
+/**
+ * 驗證語言類型
+ */
+function validateLanguage(lang: string): Language {
+  const normalizedLang = lang.toLowerCase();
+  if (LANGUAGE_MAP[normalizedLang]) {
+    return LANGUAGE_MAP[normalizedLang];
+  }
+
+  // 如果無效，使用預設值
+  logger.warn(`無效的語言「${lang}」，使用預設值「${DEFAULT_CONFIG.language}」`);
+  return DEFAULT_CONFIG.language;
+}
+
+/**
+ * 從命令行選項解析配置
+ */
+export function parseFromOptions(
+  projectName: string | undefined,
+  options: {
+    template?: string;
+    git?: boolean;
+    install?: boolean;
+    type?: string;
+    language?: string;
+  }
+): UserInput {
+  const userInput: UserInput = {};
+
+  // 專案名稱
+  if (projectName) {
+    userInput.projectName = projectName;
+  }
+
+  // 語言選擇
+  if (options.language) {
+    userInput.language = validateLanguage(options.language);
+  }
+
+  // 專案類型
+  if (options.type) {
+    userInput.projectType = validateProjectType(options.type);
+  }
+
+  // 模板
+  if (options.template) {
+    const projectType = userInput.projectType || DEFAULT_CONFIG.projectType;
+    userInput.template = validateTemplateType(options.template, projectType);
+  }
+
+  // Git 初始化
+  if (options.git !== undefined) {
+    userInput.initGit = options.git;
+  }
+
+  // 依賴安裝
+  if (options.install !== undefined) {
+    userInput.installDeps = options.install;
+  }
+
+  return userInput;
+}
+
+/**
+ * 獲取當前 Node.js 版本
+ */
+export function getCurrentNodeVersion(): string {
+  return process.version.substring(1); // 去掉開頭的 'v'
+}
+
+/**
+ * 檢查 Node.js 版本是否符合要求
+ */
+export function checkNodeVersion(requiredVersion: string): boolean {
+  const current = process.version;
+  const required = `v${requiredVersion}`;
+
+  try {
+    const semver = require('semver');
+    return semver.gte(current, required);
+  } catch {
+    // 如果沒有安裝 semver，使用簡單版本比較
+    return current >= required;
+  }
+}
+
+export { DEFAULT_CONFIG };