@lightfish/cli 0.0.5 → 0.0.7

package/dist/create-lightfish.js

@@ -4,17 +4,46 @@
 import cac from "cac";
 
 // src/commands/create.ts
-import path4 from "path";
+import path6 from "path";
 import { execa as execa2 } from "execa";
-import fs4 from "fs-extra";
+import fs6 from "fs-extra";
 import prompts3 from "prompts";
 
-// src/utils/download-template.ts
+// src/utils/copy-template.ts
 import path from "path";
+import fs from "fs-extra";
+var SKIP_NAMES = /* @__PURE__ */ new Set([".git", "node_modules", "dist"]);
+var RESTORE_MAP = {
+  _gitignore: ".gitignore",
+  _gitattributes: ".gitattributes",
+  _npmignore: ".npmignore",
+  _gitkeep: ".gitkeep"
+};
+async function copyLocalTemplate(srcDir, targetDir) {
+  await fs.ensureDir(targetDir);
+  const entries = await fs.readdir(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (SKIP_NAMES.has(entry.name)) continue;
+    const src = path.join(srcDir, entry.name);
+    const destName = RESTORE_MAP[entry.name] ?? entry.name;
+    const dest = path.join(targetDir, destName);
+    if (entry.isDirectory()) {
+      await copyLocalTemplate(src, dest);
+    } else if (entry.isSymbolicLink()) {
+      const linkTarget = await fs.readlink(src);
+      await fs.symlink(linkTarget, dest);
+    } else {
+      await fs.copy(src, dest);
+    }
+  }
+}
+
+// src/utils/download-template.ts
+import path2 from "path";
 import { tmpdir } from "os";
 import { randomUUID } from "crypto";
 import { execa } from "execa";
-import fs from "fs-extra";
+import fs2 from "fs-extra";
 function parseRepo(repo) {
   const [repoPart, branch] = repo.split("#");
   let url;
@@ -28,8 +57,8 @@ function parseRepo(repo) {
   return { url, branch: branch || void 0 };
 }
 async function gitClone(url, branch, targetDir) {
-  const tmpDir = path.join(tmpdir(), `lightfish-template-${randomUUID()}`);
-  await fs.ensureDir(tmpDir);
+  const tmpDir = path2.join(tmpdir(), `lightfish-template-${randomUUID()}`);
+  await fs2.ensureDir(tmpDir);
   const args = ["clone", "--depth", "1"];
   if (branch) {
     args.push("--branch", branch);
@@ -38,30 +67,30 @@ async function gitClone(url, branch, targetDir) {
   try {
     await execa("git", args, { stdio: "inherit" });
   } catch (error) {
-    await fs.remove(tmpDir).catch(() => {
+    await fs2.remove(tmpDir).catch(() => {
     });
     const detail = error instanceof Error ? error.message : String(error);
     throw new Error(`Git \u514B\u9686\u5931\u8D25\uFF08${url}\uFF09\uFF1A${detail}`);
   }
-  const entries = await fs.readdir(tmpDir);
+  const entries = await fs2.readdir(tmpDir);
   for (const entry of entries) {
     if (entry === ".git") continue;
-    const src = path.join(tmpDir, entry);
-    const dest = path.join(targetDir, entry);
-    await fs.move(src, dest, { overwrite: true });
+    const src = path2.join(tmpDir, entry);
+    const dest = path2.join(targetDir, entry);
+    await fs2.move(src, dest, { overwrite: true });
   }
-  await fs.remove(tmpDir).catch(() => {
+  await fs2.remove(tmpDir).catch(() => {
   });
 }
 async function downloadTemplate(repo, targetDir) {
-  await fs.ensureDir(targetDir);
+  await fs2.ensureDir(targetDir);
   const { url, branch } = parseRepo(repo);
   console.log(`\u6B63\u5728\u62C9\u53D6\u6A21\u677F: ${url}${branch ? ` (\u5206\u652F: ${branch})` : ""}`);
   await gitClone(url, branch, targetDir);
   console.log("\u6A21\u677F\u62C9\u53D6\u5B8C\u6210");
-  const gitDir = path.join(targetDir, ".git");
-  if (await fs.pathExists(gitDir)) {
-    await fs.remove(gitDir);
+  const gitDir = path2.join(targetDir, ".git");
+  if (await fs2.pathExists(gitDir)) {
+    await fs2.remove(gitDir);
     console.log("\u5DF2\u5220\u9664 .git \u76EE\u5F55");
   }
 }
@@ -85,26 +114,26 @@ function installCommand(packageManager) {
 }
 
 // src/utils/project.ts
-import path2 from "path";
-import fs2 from "fs-extra";
+import path3 from "path";
+import fs3 from "fs-extra";
 import prompts from "prompts";
 function normalizeProjectName(name) {
   return name.trim();
 }
 function resolveTargetDir(cwd, projectName) {
-  return path2.resolve(cwd, projectName);
+  return path3.resolve(cwd, projectName);
 }
 async function assertCanCreateProject(targetDir, yes) {
-  if (!await fs2.pathExists(targetDir)) {
+  if (!await fs3.pathExists(targetDir)) {
     return true;
   }
-  const files = await fs2.readdir(targetDir);
+  const files = await fs3.readdir(targetDir);
   if (files.length === 0) {
     return true;
   }
   if (yes) {
-    await fs2.remove(targetDir);
-    await fs2.ensureDir(targetDir);
+    await fs3.remove(targetDir);
+    await fs3.ensureDir(targetDir);
     return true;
   }
   const { overwrite } = await prompts(
@@ -123,8 +152,8 @@ async function assertCanCreateProject(targetDir, yes) {
   if (!overwrite) {
     return false;
   }
-  await fs2.remove(targetDir);
-  await fs2.ensureDir(targetDir);
+  await fs3.remove(targetDir);
+  await fs3.ensureDir(targetDir);
   return true;
 }
 function toPackageName(projectName) {
@@ -132,8 +161,8 @@ function toPackageName(projectName) {
 }
 
 // src/utils/replace-token.ts
-import path3 from "path";
-import fs3 from "fs-extra";
+import path4 from "path";
+import fs4 from "fs-extra";
 var SKIP_DIRS = /* @__PURE__ */ new Set([
   ".git",
   "node_modules",
@@ -165,22 +194,22 @@ var SKIP_EXTS = /* @__PURE__ */ new Set([
   ".lock"
 ]);
 async function replaceToken(targetDir, token, value) {
-  const entries = await fs3.readdir(targetDir);
+  const entries = await fs4.readdir(targetDir);
   for (const entry of entries) {
-    const fullPath = path3.join(targetDir, entry);
-    const stat = await fs3.stat(fullPath);
+    const fullPath = path4.join(targetDir, entry);
+    const stat = await fs4.stat(fullPath);
     if (stat.isDirectory()) {
       if (SKIP_DIRS.has(entry)) continue;
       await replaceToken(fullPath, token, value);
       continue;
     }
-    const ext = path3.extname(entry).toLowerCase();
+    const ext = path4.extname(entry).toLowerCase();
     if (SKIP_EXTS.has(ext)) continue;
     try {
-      const content = await fs3.readFile(fullPath, "utf8");
+      const content = await fs4.readFile(fullPath, "utf8");
       if (content.includes(token)) {
         const replaced = content.replaceAll(token, value);
-        await fs3.writeFile(fullPath, replaced, "utf8");
+        await fs4.writeFile(fullPath, replaced, "utf8");
         console.log(`  [replace] ${entry}`);
       }
     } catch {
@@ -196,6 +225,7 @@ var BUILTIN_TEMPLATES = [
   {
     id: "react-vite",
     label: "React + Vite",
+    localDir: "react-vite",
     repo: "QGtiger/template-vite-server#main"
   }
 ];
@@ -207,6 +237,21 @@ function listTemplateIds() {
   return BUILTIN_TEMPLATES.map((entry) => entry.id);
 }
 
+// src/utils/builtin-template-dir.ts
+import path5 from "path";
+import fs5 from "fs";
+import { fileURLToPath } from "url";
+var dirname = path5.dirname(fileURLToPath(import.meta.url));
+function resolveBuiltinTemplateDir(localDir) {
+  const candidates = [
+    // 产物模式：dirname=dist -> dist/templates/<localDir>
+    path5.resolve(dirname, "templates", localDir),
+    // 源码模式：dirname=src/utils -> packages/cli/templates/<localDir>
+    path5.resolve(dirname, "..", "..", "templates", localDir)
+  ];
+  return candidates.find((candidate) => fs5.existsSync(candidate));
+}
+
 // src/utils/resolve-template.ts
 async function promptTemplateId() {
   const { templateId } = await prompts2(
@@ -230,41 +275,59 @@ async function promptTemplateId() {
   }
   return templateId;
 }
-async function resolveTemplateRepo(options) {
-  if (options.templateRepo) {
-    return options.templateRepo;
-  }
+async function selectEntry(options) {
   if (options.template) {
     const entry2 = getTemplateById(options.template);
     if (!entry2) {
       throw new Error(`\u672A\u77E5\u6A21\u677F\uFF1A${options.template}\u3002\u53EF\u9009\uFF1A${listTemplateIds().join("\u3001")}`);
     }
-    return entry2.repo;
+    return entry2;
+  }
+  if (BUILTIN_TEMPLATES.length === 1) {
+    const entry2 = getTemplateById(DEFAULT_TEMPLATE_ID ?? BUILTIN_TEMPLATES[0].id);
+    if (!entry2) {
+      throw new Error("\u5185\u7F6E\u6A21\u677F\u5217\u8868\u4E3A\u7A7A");
+    }
+    return entry2;
   }
   if (options.yes) {
     const entry2 = getTemplateById(DEFAULT_TEMPLATE_ID ?? BUILTIN_TEMPLATES[0].id);
     if (!entry2) {
       throw new Error("\u5185\u7F6E\u6A21\u677F\u5217\u8868\u4E3A\u7A7A");
     }
-    return entry2.repo;
+    return entry2;
   }
   const templateId = await promptTemplateId();
   const entry = getTemplateById(templateId);
   if (!entry) {
     throw new Error(`\u672A\u77E5\u6A21\u677F\uFF1A${templateId}`);
   }
-  return entry.repo;
+  return entry;
+}
+async function resolveTemplate(options) {
+  const entry = await selectEntry(options);
+  if (!options.remote && entry.localDir) {
+    const dir = resolveBuiltinTemplateDir(entry.localDir);
+    if (dir) {
+      return { type: "local", dir, id: entry.id };
+    }
+    console.warn(`[template] \u5185\u7F6E\u6A21\u677F\u526F\u672C\u7F3A\u5931\uFF08${entry.localDir}\uFF09\uFF0C\u56DE\u9000\u5230 git \u62C9\u53D6\u3002`);
+  }
+  if (!entry.repo) {
+    throw new Error(`\u6A21\u677F ${entry.id} \u672A\u914D\u7F6E git \u6E90\uFF0C\u4E14\u672C\u5730\u526F\u672C\u4E0D\u53EF\u7528`);
+  }
+  return { type: "git", repo: entry.repo, id: entry.id };
 }
 
 // src/commands/create.ts
 async function patchPackageJsonName(targetDir, projectName) {
-  const packageJsonPath = path4.join(targetDir, "package.json");
-  if (!await fs4.pathExists(packageJsonPath)) {
+  const packageJsonPath = path6.join(targetDir, "package.json");
+  if (!await fs6.pathExists(packageJsonPath)) {
     throw new Error("\u6A21\u677F\u7F3A\u5C11 package.json");
   }
-  const packageJson = await fs4.readJson(packageJsonPath);
+  const packageJson = await fs6.readJson(packageJsonPath);
   packageJson.name = toPackageName(projectName);
-  await fs4.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+  await fs6.writeJson(packageJsonPath, packageJson, { spaces: 2 });
 }
 async function resolveCreateOptions(options) {
   const cwd = options.cwd ?? process.cwd();
@@ -304,9 +367,9 @@ async function resolveCreateOptions(options) {
   if (!isPackageManager(packageManager)) {
     throw new Error(`\u4E0D\u652F\u6301\u7684\u5305\u7BA1\u7406\u5668\uFF1A${String(packageManager)}`);
   }
-  const templateRepo = await resolveTemplateRepo({
+  const template = await resolveTemplate({
     template: options.template,
-    templateRepo: options.templateRepo,
+    remote: options.remote,
     yes: options.yes
   });
   const yesMode = options.yes === true;
@@ -315,7 +378,7 @@ async function resolveCreateOptions(options) {
     projectName,
     targetDir: resolveTargetDir(cwd, projectName),
     packageManager,
-    templateRepo,
+    template,
     install: options.skipInstall ? false : options.install ?? (yesMode ? true : answers.install ?? false),
     git: options.git ?? (yesMode ? true : answers.git ?? false)
   };
@@ -339,15 +402,25 @@ async function maybeInitGit(options) {
     stdio: "inherit"
   });
 }
+async function writeTemplate(template, targetDir) {
+  if (template.type === "local") {
+    console.log(`[create] \u4F7F\u7528\u5185\u7F6E\u6A21\u677F\uFF1A${template.id}`);
+    await copyLocalTemplate(template.dir, targetDir);
+    console.log("[create] \u5185\u7F6E\u6A21\u677F\u62F7\u8D1D\u5B8C\u6210");
+    return;
+  }
+  console.log(`[create] \u4F7F\u7528 git \u6A21\u677F\uFF1A${template.id}`);
+  await downloadTemplate(template.repo, targetDir);
+}
 async function createProject(options = {}) {
   const resolvedOptions = await resolveCreateOptions(options);
   const canCreate = await assertCanCreateProject(resolvedOptions.targetDir, options.yes);
   if (!canCreate) {
     throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
   }
-  console.log("[create] \u5F00\u59CB\u4E0B\u8F7D\u6A21\u677F...");
-  await downloadTemplate(resolvedOptions.templateRepo, resolvedOptions.targetDir);
-  console.log("[create] \u6A21\u677F\u4E0B\u8F7D\u5B8C\u6210");
+  console.log("[create] \u5F00\u59CB\u5199\u5165\u6A21\u677F...");
+  await writeTemplate(resolvedOptions.template, resolvedOptions.targetDir);
+  console.log("[create] \u6A21\u677F\u5199\u5165\u5B8C\u6210");
   console.log("[create] \u5F00\u59CB\u4FEE\u6539 package.json...");
   await patchPackageJsonName(resolvedOptions.targetDir, resolvedOptions.projectName);
   console.log("[create] package.json \u4FEE\u6539\u5B8C\u6210");
@@ -364,28 +437,28 @@ async function createProject(options = {}) {
 }
 
 // src/utils/package-info.ts
-import fs5 from "fs";
-import path5 from "path";
-import { fileURLToPath } from "url";
-var dirname = path5.dirname(fileURLToPath(import.meta.url));
+import fs7 from "fs";
+import path7 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var dirname2 = path7.dirname(fileURLToPath2(import.meta.url));
 function readPackageVersion() {
   const packageJsonPathCandidates = [
     // 源码模式：src/utils/package-info.ts -> packages/cli/package.json
-    path5.resolve(dirname, "../../package.json"),
+    path7.resolve(dirname2, "../../package.json"),
     // 构建产物模式：dist/lightfish.js -> packages/cli/package.json
-    path5.resolve(dirname, "../package.json")
+    path7.resolve(dirname2, "../package.json")
   ];
-  const packageJsonPath = packageJsonPathCandidates.find((candidate) => fs5.existsSync(candidate));
+  const packageJsonPath = packageJsonPathCandidates.find((candidate) => fs7.existsSync(candidate));
   if (!packageJsonPath) {
     return "0.0.0";
   }
-  const packageJson = JSON.parse(fs5.readFileSync(packageJsonPath, "utf8"));
+  const packageJson = JSON.parse(fs7.readFileSync(packageJsonPath, "utf8"));
   return packageJson.version ?? "0.0.0";
 }
 
 // src/create-lightfish.ts
 var cli = cac("create-lightfish");
-cli.command("[projectName]", "\u521B\u5EFA Lightfish React Vite \u9879\u76EE").option("--pm <pm>", "\u5305\u7BA1\u7406\u5668\uFF1Anpm\u3001yarn\u3001pnpm\u3001bun", { default: "pnpm" }).option("--template <id>", "\u5185\u7F6E\u6A21\u677F id\uFF0C\u4F8B\u5982 react-vite").option("--template-repo <repo>", "\u76F4\u63A5\u6307\u5B9A git \u4ED3\u5E93\u6E90\uFF0C\u5982 QGtiger/template-vite-server#main\uFF08\u4F18\u5148\u4E8E --template\uFF09").option("--skip-install", "\u8DF3\u8FC7\u4F9D\u8D56\u5B89\u88C5").option("--git", "\u521B\u5EFA\u540E\u521D\u59CB\u5316 git").option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u9009\u9879\u5E76\u8DF3\u8FC7\u786E\u8BA4").action(async (projectName, options) => {
+cli.command("[projectName]", "\u521B\u5EFA Lightfish React Vite \u9879\u76EE").option("--pm <pm>", "\u5305\u7BA1\u7406\u5668\uFF1Anpm\u3001yarn\u3001pnpm\u3001bun", { default: "pnpm" }).option("--template <id>", "\u5185\u7F6E\u6A21\u677F id\uFF0C\u4F8B\u5982 react-vite").option("--remote", "\u5F3A\u5236\u8D70 git \u62C9\u53D6\u5185\u7F6E\u6A21\u677F\uFF08\u5FFD\u7565\u672C\u5730\u526F\u672C\uFF09").option("--skip-install", "\u8DF3\u8FC7\u4F9D\u8D56\u5B89\u88C5").option("--git", "\u521B\u5EFA\u540E\u521D\u59CB\u5316 git").option("-y, --yes", "\u4F7F\u7528\u9ED8\u8BA4\u9009\u9879\u5E76\u8DF3\u8FC7\u786E\u8BA4").action(async (projectName, options) => {
   try {
     const packageManager = options.pm ?? "pnpm";
     if (!isPackageManager(packageManager)) {
@@ -395,7 +468,7 @@ cli.command("[projectName]", "\u521B\u5EFA Lightfish React Vite \u9879\u76EE").o
       projectName,
       packageManager,
       template: options.template,
-      templateRepo: options.templateRepo,
+      remote: options.remote,
       skipInstall: options.skipInstall,
       git: options.git,
       yes: options.yes