create-for-yeyu 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ye Yu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+# create-for-yeyu
+
+一个用于快速创建项目的脚手架工具。
+
+## 功能特性
+
+- 快速克隆 Git 仓库模板
+- 支持 Vite 官方模板
+- 支持 Create Next App
+- 交互式命令行界面
+- Cowsay 风格的欢迎界面，显示用户名和当前日期
+- Clone 时显示 ASCII 火车动画
+
+## 安装
+
+```bash
+npm install -g create-for-yeyu
+```
+
+或者直接使用 npx：
+
+```bash
+npx create-for-yeyu
+```
+
+## 使用方法
+
+### 交互式创建
+
+```bash
+npx create-for-yeyu
+```
+
+### 指定项目名称
+
+```bash
+npx create-for-yeyu my-project
+```
+
+### 指定模板
+
+```bash
+# 使用 NestJS 模板
+npx create-for-yeyu my-project --template nest
+
+# 使用 EVM DApp 模板
+npx create-for-yeyu my-project --template evm-dapp
+
+# 使用 Vite 创建项目
+npx create-for-yeyu my-project --template vite
+
+# 使用 Create Next App 创建项目
+npx create-for-yeyu my-project --template next
+```
+
+## 可用模板
+
+| 模板名称         | 命令参数   | 说明                 |
+| ---------------- | ---------- | -------------------- |
+| NestJS Starter   | `nest`     | NestJS 应用启动模板  |
+| EVM DApp Starter | `evm-dapp` | EVM DApp 启动模板    |
+| Vite             | `vite`     | 使用 Vite 官方模板   |
+| Next.js          | `next`     | 使用 Create Next App |
+
+## 界面预览
+
+启动时会显示 Cowsay 风格的欢迎界面：
+
+```
+ ______________________________
+/ Hello, username!             \
+\ Today is 2024-12-23 Monday   /
+ ------------------------------
+        \   ^__^
+         \  (oo)\_______
+            (__)\       )\/ \
+                ||----w |
+                ||     ||
+```
+
+Clone 模板时会显示 ASCII 火车动画，灵感来自经典的 sl 命令。
+
+## 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 开发模式
+pnpm dev
+
+# 构建
+pnpm build
+
+# 本地测试运行
+pnpm start
+```
+
+## 项目结构
+
+```
+create-for-yeyu/
+├── src/
+│   ├── index.ts              # CLI 入口
+│   ├── cli.ts                # 命令行解析
+│   ├── prompts.ts            # 交互式问答
+│   ├── templates.ts          # 模板配置
+│   ├── actions/
+│   │   ├── clone-repo.ts     # Clone Git 仓库
+│   │   ├── create-vite.ts    # 调用 Vite
+│   │   └── create-next.ts    # 调用 Create Next App
+│   └── utils/
+│       ├── logger.ts         # 日志工具
+│       ├── spinner.ts        # 加载动画
+│       ├── cowsay.ts         # Cowsay 工具
+│       └── train-animation.ts # 火车动画
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 添加新模板
+
+在 `src/templates.ts` 文件中添加新的模板配置：
+
+```typescript
+{
+  name: '模板名称',
+  value: 'template-value',
+  description: '模板描述',
+  type: 'git',
+  repo: 'username/repo-name',
+}
+```
+
+## 技术栈
+
+- Node.js >= 18
+- TypeScript
+- Commander - 命令行参数解析
+- Inquirer - 交互式命令行界面
+- Chalk - 终端颜色输出
+- Degit - 快速 clone Git 仓库
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command } from "commander";
+import chalk2 from "chalk";
+import fs from "fs-extra";
+import path2 from "path";
+
+// src/prompts.ts
+import inquirer from "inquirer";
+
+// src/templates.ts
+var templates = [
+  {
+    name: "NestJS Starter",
+    value: "nest",
+    description: "NestJS application starter template",
+    type: "git",
+    repo: "NeilYeTAT/nest-app-starter-for-yeyu"
+  },
+  {
+    name: "EVM DApp Starter",
+    value: "evm-dapp",
+    description: "EVM DApp starter template",
+    type: "git",
+    repo: "NeilYeTAT/evm-dapp-starter-for-yeyu"
+  },
+  {
+    name: "Vite",
+    value: "vite",
+    description: "Create project with Vite official template",
+    type: "vite"
+  },
+  {
+    name: "Next.js",
+    value: "next",
+    description: "Create project with Create Next App",
+    type: "next"
+  }
+];
+function getTemplateByValue(value) {
+  return templates.find((t) => t.value === value);
+}
+
+// src/prompts.ts
+async function promptProjectName() {
+  const { projectName } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "projectName",
+      message: "Enter project name:",
+      default: "my-project",
+      validate: (input) => {
+        if (!input.trim()) {
+          return "Project name cannot be empty";
+        }
+        if (!/^[a-zA-Z0-9-_]+$/.test(input)) {
+          return "Project name can only contain letters, numbers, hyphens and underscores";
+        }
+        return true;
+      }
+    }
+  ]);
+  return projectName;
+}
+async function promptTemplate() {
+  const gitTemplates = templates.filter((t) => t.type === "git");
+  const officialTemplates = templates.filter((t) => t.type !== "git");
+  const choices = [
+    ...gitTemplates.map((t) => ({
+      name: `${t.name.padEnd(20)} - ${t.description}`,
+      value: t.value
+    })),
+    new inquirer.Separator("\u2500".repeat(50)),
+    ...officialTemplates.map((t) => ({
+      name: `${t.name.padEnd(20)} - ${t.description}`,
+      value: t.value
+    }))
+  ];
+  const { templateValue } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "templateValue",
+      message: "Select a project template:",
+      choices
+    }
+  ]);
+  const selectedTemplate = templates.find((t) => t.value === templateValue);
+  if (!selectedTemplate) {
+    throw new Error(`Template not found: ${templateValue}`);
+  }
+  return selectedTemplate;
+}
+
+// src/actions/clone-repo.ts
+import degit from "degit";
+import path from "path";
+
+// src/utils/train-animation.ts
+import readline from "readline";
+var TRAIN_FRAMES = [
+  [
+    "      ====        ________                ___________",
+    "  _D _|  |_______/        \\__I_I_____===__|_________|",
+    "   |(_)---  |   H\\________/ |   |        =|___ ___|",
+    "   /     |  |   H  |  |     |   |         ||_| |_||",
+    "  |      |  |   H  |__--------------------| [___] |",
+    "  | ________|___H__/__|_____/[][]~\\_______|       |",
+    "  |/ |   |-----------I_____I [][] []  D   |=======|__",
+    "__/ =| o |=-~~\\  /~~\\  /~~\\  /~~\\ ____Y___________|__",
+    " \\_/      \\__/  \\__/  \\__/  \\__/      \\_/"
+  ],
+  [
+    "      ====        ________                ___________",
+    "  _D _|  |_______/        \\__I_I_____===__|_________|",
+    "   |(_)---  |   H\\________/ |   |        =|___ ___|",
+    "   /     |  |   H  |  |     |   |         ||_| |_||",
+    "  |      |  |   H  |__--------------------| [___] |",
+    "  | ________|___H__/__|_____/[][]~\\_______|       |",
+    "  |/ |   |-----------I_____I [][] []  D   |=======|__",
+    "__/ =| o |=-~~\\  /~~\\  /~~\\  /~~\\ ____Y___________|__",
+    " \\_/      \\O/  \\O/  \\O/  \\O/      \\_/"
+  ]
+];
+var SMOKE_FRAMES = [
+  [
+    "                (  ) (@@) ( )  (@)  ()    @@    O     @     O     @      O"
+  ],
+  ["             (@@@)       (    )      (@@@)   ()      @    ()     @     ()"],
+  [
+    "         (   )      (@@@@)     (  )    @@     ()      @    ()     @      @"
+  ],
+  ["      (@@)              (@@@)           O        ()     @      ()    @"]
+];
+function createTrainAnimation(initialMessage) {
+  let isRunning = false;
+  let frameIndex = 0;
+  let smokeIndex = 0;
+  let position = 0;
+  let message = initialMessage;
+  let intervalId = null;
+  const terminalWidth = process.stdout.columns || 80;
+  const trainWidth = 55;
+  const startPosition = terminalWidth;
+  function clearLines(count) {
+    for (let i = 0; i < count; i++) {
+      readline.moveCursor(process.stdout, 0, -1);
+      readline.clearLine(process.stdout, 0);
+    }
+  }
+  function render() {
+    const train = TRAIN_FRAMES[frameIndex % TRAIN_FRAMES.length];
+    const smoke = SMOKE_FRAMES[smokeIndex % SMOKE_FRAMES.length];
+    const offset = startPosition - position;
+    const displayLines = [];
+    for (const line of smoke) {
+      const paddedLine = offset > 0 ? " ".repeat(Math.max(0, offset)) + line : line.slice(-offset);
+      displayLines.push(paddedLine.slice(0, terminalWidth));
+    }
+    for (const line of train) {
+      const paddedLine = offset > 0 ? " ".repeat(Math.max(0, offset)) + line : line.slice(-offset);
+      displayLines.push(paddedLine.slice(0, terminalWidth));
+    }
+    displayLines.push("");
+    displayLines.push(`  \u{1F682} ${message}`);
+    if (position > 0) {
+      clearLines(displayLines.length);
+    }
+    for (const line of displayLines) {
+      console.log(line);
+    }
+    frameIndex = (frameIndex + 1) % TRAIN_FRAMES.length;
+    smokeIndex = (smokeIndex + 1) % SMOKE_FRAMES.length;
+    position += 3;
+    if (position > startPosition + trainWidth + 10) {
+      position = 0;
+    }
+  }
+  return {
+    start() {
+      if (isRunning) return;
+      isRunning = true;
+      process.stdout.write("\x1B[?25l");
+      const totalLines = SMOKE_FRAMES[0].length + TRAIN_FRAMES[0].length + 2;
+      for (let i = 0; i < totalLines; i++) {
+        console.log("");
+      }
+      clearLines(totalLines);
+      intervalId = setInterval(render, 100);
+    },
+    stop(success, finalMessage) {
+      if (!isRunning) return;
+      isRunning = false;
+      if (intervalId) {
+        clearInterval(intervalId);
+        intervalId = null;
+      }
+      const totalLines = SMOKE_FRAMES[0].length + TRAIN_FRAMES[0].length + 2;
+      clearLines(totalLines);
+      process.stdout.write("\x1B[?25h");
+      const icon = success ? "\u2714" : "\u2716";
+      const color = success ? "\x1B[32m" : "\x1B[31m";
+      console.log(`${color}${icon}\x1B[0m ${finalMessage}`);
+    },
+    updateMessage(newMessage) {
+      message = newMessage;
+    }
+  };
+}
+
+// src/utils/logger.ts
+import chalk from "chalk";
+var logger = {
+  info: (message) => {
+    console.log(chalk.blue("\u2139"), message);
+  },
+  success: (message) => {
+    console.log(chalk.green("\u2714"), message);
+  },
+  warning: (message) => {
+    console.log(chalk.yellow("\u26A0"), message);
+  },
+  error: (message) => {
+    console.log(chalk.red("\u2716"), message);
+  },
+  log: (message) => {
+    console.log(message);
+  }
+};
+
+// src/actions/clone-repo.ts
+async function cloneRepo(repo, projectName) {
+  const targetPath = path.resolve(process.cwd(), projectName);
+  const train = createTrainAnimation(`Cloning template ${repo}...`);
+  train.start();
+  try {
+    const emitter = degit(repo, {
+      cache: false,
+      force: true,
+      verbose: false
+    });
+    await emitter.clone(targetPath);
+    train.stop(true, "Template cloned successfully!");
+  } catch (error) {
+    train.stop(false, "Failed to clone template");
+    if (error instanceof Error) {
+      logger.error(error.message);
+    }
+    throw error;
+  }
+}
+
+// src/actions/create-vite.ts
+import { execa } from "execa";
+async function createViteProject(projectName) {
+  logger.info("Creating project with Vite...");
+  logger.log("");
+  try {
+    await execa("npm", ["create", "vite@latest", projectName], {
+      stdio: "inherit",
+      cwd: process.cwd()
+    });
+  } catch (error) {
+    if (error instanceof Error) {
+      logger.error(`Failed to create Vite project: ${error.message}`);
+    }
+    throw error;
+  }
+}
+
+// src/actions/create-next.ts
+import { execa as execa2 } from "execa";
+async function createNextProject(projectName) {
+  logger.info("Creating project with Create Next App...");
+  logger.log("");
+  try {
+    await execa2("npx", ["create-next-app@latest", projectName], {
+      stdio: "inherit",
+      cwd: process.cwd()
+    });
+  } catch (error) {
+    if (error instanceof Error) {
+      logger.error(`Failed to create Next.js project: ${error.message}`);
+    }
+    throw error;
+  }
+}
+
+// src/utils/cowsay.ts
+import os from "os";
+function cowsay(text) {
+  const lines = text.split("\n");
+  const maxLength = Math.max(...lines.map((line) => line.length));
+  const paddedLines = lines.map((line) => line.padEnd(maxLength));
+  const top = " " + "_".repeat(maxLength + 2);
+  const bottom = " " + "-".repeat(maxLength + 2);
+  let bubble;
+  if (paddedLines.length === 1) {
+    bubble = [top, `< ${paddedLines[0]} >`, bottom];
+  } else {
+    bubble = [top];
+    paddedLines.forEach((line, index) => {
+      if (index === 0) {
+        bubble.push(`/ ${line} \\`);
+      } else if (index === paddedLines.length - 1) {
+        bubble.push(`\\ ${line} /`);
+      } else {
+        bubble.push(`| ${line} |`);
+      }
+    });
+    bubble.push(bottom);
+  }
+  const cow = [
+    "        \\   ^__^",
+    "         \\  (oo)\\_______",
+    "            (__)\\       )\\/\\",
+    "                ||----w |",
+    "                ||     ||"
+  ];
+  return [...bubble, ...cow].join("\n");
+}
+function getFormattedDate() {
+  const now = /* @__PURE__ */ new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, "0");
+  const day = String(now.getDate()).padStart(2, "0");
+  const weekdays = [
+    "Sunday",
+    "Monday",
+    "Tuesday",
+    "Wednesday",
+    "Thursday",
+    "Friday",
+    "Saturday"
+  ];
+  const weekday = weekdays[now.getDay()];
+  return `${year}-${month}-${day} ${weekday}`;
+}
+function getGreetingMessage() {
+  const username = os.userInfo().username;
+  const date = getFormattedDate();
+  return `Hello, ${username}!
+Today is ${date}`;
+}
+
+// src/cli.ts
+var VERSION = "1.0.0";
+async function executeTemplate(template, projectName) {
+  const targetPath = path2.resolve(process.cwd(), projectName);
+  if (template.type === "git") {
+    if (fs.existsSync(targetPath)) {
+      logger.error(`Directory ${projectName} already exists`);
+      process.exit(1);
+    }
+    if (!template.repo) {
+      logger.error("Template repository not configured");
+      process.exit(1);
+    }
+    await cloneRepo(template.repo, projectName);
+    printSuccessMessage(projectName);
+  } else if (template.type === "vite") {
+    await createViteProject(projectName);
+  } else if (template.type === "next") {
+    await createNextProject(projectName);
+  }
+}
+function printSuccessMessage(projectName) {
+  console.log();
+  logger.success(chalk2.green.bold("\u{1F389} Project created successfully!"));
+  console.log();
+  logger.log(chalk2.cyan("  Next steps:"));
+  logger.log(`    cd ${chalk2.yellow(projectName)}`);
+  logger.log(`    ${chalk2.yellow("pnpm install")}`);
+  logger.log(`    ${chalk2.yellow("pnpm dev")}`);
+  console.log();
+}
+function printBanner() {
+  console.log();
+  console.log(chalk2.cyan(cowsay(getGreetingMessage())));
+  console.log();
+}
+async function run() {
+  const program = new Command();
+  program.name("create-for-yeyu").description("A CLI tool to scaffold projects from templates").version(VERSION).argument("[project-name]", "Project name").option(
+    "-t, --template <template>",
+    "Specify template (nest, evm-dapp, vite, next)"
+  ).action(async (projectName, options) => {
+    printBanner();
+    try {
+      let finalProjectName = projectName;
+      let template;
+      if (!finalProjectName) {
+        finalProjectName = await promptProjectName();
+      }
+      if (options.template) {
+        const foundTemplate = getTemplateByValue(options.template);
+        if (!foundTemplate) {
+          logger.error(`Template not found: ${options.template}`);
+          logger.info("Available templates: nest, evm-dapp, vite, next");
+          process.exit(1);
+        }
+        template = foundTemplate;
+      } else {
+        template = await promptTemplate();
+      }
+      await executeTemplate(template, finalProjectName);
+    } catch (error) {
+      if (error instanceof Error) {
+        logger.error(error.message);
+      }
+      process.exit(1);
+    }
+  });
+  await program.parseAsync(process.argv);
+}
+
+// src/index.ts
+run();

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "create-for-yeyu",
+  "version": "2.0.0",
+  "description": "A CLI tool to scaffold projects from templates",
+  "type": "module",
+  "bin": {
+    "create-for-yeyu": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "cli",
+    "scaffold",
+    "template"
+  ],
+  "author": "yeyu",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "degit": "^2.8.4",
+    "execa": "^8.0.1",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.12",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/chalk": "^2.2.4",
+    "@types/degit": "^2.8.6",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "start": "node dist/index.js",
+    "release": "changeset publish"
+  }
+}