pan-stack-cli 0.2.1 → 0.2.2

package/lib/platform.js

@@ -1,140 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const { spawnSync } = require("child_process");
-
-const WINDOWS_RESERVED_NAMES = new Set([
-  "CON",
-  "PRN",
-  "AUX",
-  "NUL",
-  "COM1",
-  "COM2",
-  "COM3",
-  "COM4",
-  "COM5",
-  "COM6",
-  "COM7",
-  "COM8",
-  "COM9",
-  "LPT1",
-  "LPT2",
-  "LPT3",
-  "LPT4",
-  "LPT5",
-  "LPT6",
-  "LPT7",
-  "LPT8",
-  "LPT9",
-]);
-
-function isWindows() {
-  return process.platform === "win32";
-}
-
-function splitEnvList(value) {
-  if (!value) {
-    return [];
-  }
-  // On Windows, do not split on ":" — drive letters use "C:".
-  const parts = isWindows() ? value.split(/[;,]/) : value.split(/[:;,]/);
-  return parts.map((part) => part.trim()).filter(Boolean);
-}
-
-function findBash() {
-  const candidates = isWindows()
-    ? [
-        process.env.PAN_GIT_BASH,
-        process.env.PAN_BASH,
-        process.env.GIT_BASH,
-        process.env.PROGRAMFILES && path.join(process.env.PROGRAMFILES, "Git", "bin", "bash.exe"),
-        process.env["ProgramFiles(x86)"] &&
-          path.join(process.env["ProgramFiles(x86)"], "Git", "bin", "bash.exe"),
-        process.env.LOCALAPPDATA &&
-          path.join(process.env.LOCALAPPDATA, "Programs", "Git", "bin", "bash.exe"),
-      ]
-    : [process.env.PAN_BASH, process.env.BASH, "/usr/bin/bash", "/bin/bash"];
-
-  for (const candidate of candidates.filter(Boolean)) {
-    if (fs.existsSync(candidate)) {
-      return candidate;
-    }
-  }
-
-  return null;
-}
-
-/** @deprecated use findBash */
-function findGitBash() {
-  return findBash();
-}
-
-function spawnOptions(extra = {}) {
-  return isWindows() ? { windowsHide: true, ...extra } : extra;
-}
-
-function normalizeShellEnv(env) {
-  if (!isWindows()) {
-    return env;
-  }
-
-  const normalized = { ...env };
-  for (const key of ["PAN_WORKSPACE_ROOT", "PAN_REPO_ROOT", "PAN_PROJECT_ROOT"]) {
-    if (typeof normalized[key] === "string") {
-      normalized[key] = normalized[key].replace(/\\/g, "/");
-    }
-  }
-  return normalized;
-}
-
-function runShellScript(script, { cwd, env, stdio = "inherit" } = {}) {
-  const shellEnv = normalizeShellEnv(env);
-  const bash = findBash();
-
-  if (!bash) {
-    const hint = isWindows()
-      ? "Install Git for Windows (https://git-scm.com/download/win) or set PAN_GIT_BASH / PAN_BASH to bash.exe."
-      : "Install bash or set PAN_BASH to its path.";
-    throw new Error(
-      `Shell commands in .pan.yaml require bash. ${hint} Alternatively, use 'exec' instead of 'shell'.`
-    );
-  }
-
-  return spawnSync(bash, ["-lc", script], spawnOptions({ cwd, env: shellEnv, stdio }));
-}
-
-function runExecLine(execLine, { cwd, env, stdio = "inherit" } = {}) {
-  return spawnSync(
-    execLine,
-    spawnOptions({ cwd, env: normalizeShellEnv(env), stdio, shell: true })
-  );
-}
-
-function validateFolderName(name) {
-  if (!name || !/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(name)) {
-    throw new Error(
-      "Invalid folder name. Use letters, numbers, dots, hyphens, or underscores."
-    );
-  }
-
-  if (isWindows()) {
-    if (/[<>:"/\\|?*]/.test(name)) {
-      throw new Error("Invalid folder name for Windows (<>:\"/\\|?* are not allowed).");
-    }
-    const base = name.replace(/\.+$/, "").toUpperCase();
-    if (WINDOWS_RESERVED_NAMES.has(base)) {
-      throw new Error(`Invalid folder name for Windows (reserved name: ${base}).`);
-    }
-  }
-}
-
-module.exports = {
-  isWindows,
-  splitEnvList,
-  findBash,
-  findGitBash,
-  spawnOptions,
-  normalizeShellEnv,
-  runShellScript,
-  runExecLine,
-  validateFolderName,
-};

package/lib/run-command.js

@@ -1,334 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const { spawn, spawnSync } = require("child_process");
-const {
-  getCommandDefinition,
-  commandBaseDir,
-  resolveCommandName,
-  parseSequenceSteps,
-} = require("./manifest");
-const { sourceMatchesProject } = require("./discover");
-const { runShellScript, runExecLine, spawnOptions } = require("./platform");
-const { hasSelect, resolveChoices, runSelect, SELECT_BACK } = require("./select");
-const { t } = require("./i18n");
-
-function needDir(dir) {
-  if (!fs.existsSync(dir)) {
-    throw new Error(t("DIRECTORY_NOT_FOUND__DIR", { dir }));
-  }
-}
-
-function resolveCwd(source, cwd) {
-  const base = commandBaseDir(source);
-  if (!cwd) {
-    return base;
-  }
-  if (path.isAbsolute(cwd)) {
-    return cwd;
-  }
-  return path.resolve(base, cwd);
-}
-
-function buildPanEnv(source, forwardedArgs, selected, extraEnv) {
-  const panEnv = {
-    ...process.env,
-    PAN_REPO_ROOT: source.root,
-    PAN_WORKSPACE_ROOT: source.workspaceRoot,
-    PAN_PROJECT_ROOT: source.workspaceRoot,
-    PAN_ARGS: forwardedArgs.join(" "),
-  };
-  forwardedArgs.forEach((value, index) => {
-    panEnv[`PAN_ARG_${index + 1}`] = value;
-  });
-  // Kết quả picker (field select trong .pan.yaml) → script đọc qua $PAN_SELECTED (mỗi dòng 1 giá trị).
-  if (Array.isArray(selected)) {
-    panEnv.PAN_SELECTED = selected.join("\n");
-    panEnv.PAN_SELECTED_COUNT = String(selected.length);
-  }
-  // Biến riêng cho 1 bước trong `sequence` (vd "MODE=prod build-be") — đè lên env chung.
-  if (extraEnv && Object.keys(extraEnv).length) {
-    Object.assign(panEnv, extraEnv);
-  }
-  return panEnv;
-}
-
-// Core chạy `exec:` — SYNC, KHÔNG process.exit (để sequence gọi lặp được). Trả {status}.
-function runExecCore(source, def, forwardedArgs, selected, extraEnv) {
-  const cwd = resolveCwd(source, def.cwd);
-  needDir(cwd);
-
-  const execLine = [def.exec, ...forwardedArgs].filter(Boolean).join(" ").trim();
-  if (!execLine) {
-    throw new Error(t("COMMAND_MISSING_EXEC_OR_SHELL"));
-  }
-
-  return runExecLine(execLine, {
-    cwd,
-    stdio: "inherit",
-    env: buildPanEnv(source, forwardedArgs, selected, extraEnv),
-  });
-}
-
-// Core chạy `shell:` — SYNC, KHÔNG process.exit (để sequence gọi lặp được). Trả {status}.
-function runShellCore(source, def, forwardedArgs, selected, extraEnv) {
-  const cwd = resolveCwd(source, def.cwd || ".");
-  if (def.cwd) {
-    needDir(cwd);
-  }
-  return runShellScript(def.shell, {
-    cwd,
-    stdio: "inherit",
-    env: buildPanEnv(source, forwardedArgs, selected, extraEnv),
-  });
-}
-
-function runExec(source, def, forwardedArgs, selected) {
-  const result = runExecCore(source, def, forwardedArgs, selected);
-  process.exit(result.status ?? 1);
-}
-
-function runShell(source, def, forwardedArgs, selected) {
-  let result;
-  try {
-    result = runShellCore(source, def, forwardedArgs, selected);
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-  process.exit(result.status ?? 1);
-}
-
-// Chạy 1 command def (đã resolve target nếu có) mà KHÔNG process.exit — dùng trong sequence.
-// Trả {status} (0 = ok). Ném lỗi nếu command thiếu cả exec/shell.
-async function runOneStepDef(source, commandName, resolved, extraEnv) {
-  let selected = await resolveSelection(source, resolved, []);
-  // Bước trong sequence không có "menu cha" để quay lại — 'b' ở đây coi như bước này không chọn gì.
-  if (selected === SELECT_BACK) selected = [];
-  if (selected && selected.length === 0) {
-    console.error(t("NOTHING_SELECTED_EXITING"));
-    return { status: 0, skipped: true };
-  }
-  if (resolved.shell) {
-    return runShellCore(source, resolved, [], selected, extraEnv);
-  }
-  if (resolved.exec) {
-    return runExecCore(source, resolved, [], selected, extraEnv);
-  }
-  throw new Error(
-    t("COMMAND_MISSING_EXEC_OR_SHELL_IN_SOURCE__COMMAND_PATH", { command: commandName, path: source.path })
-  );
-}
-
-// `sequence:` — chạy nhiều command ĐÃ khai báo trong CÙNG file .pan.yaml, TUẦN TỰ theo thứ tự,
-// dừng ngay khi 1 bước lỗi (trừ bước có "?" cuối tên lệnh → cảnh báo rồi chạy tiếp).
-async function runSequence(source, def, commandName) {
-  const steps = parseSequenceSteps(def.sequence);
-  if (steps.length === 0) {
-    throw new Error(`Command '${commandName}' has an empty sequence.`);
-  }
-
-  console.log(`▶ ${commandName}: ${steps.length} step(s)`);
-  for (let index = 0; index < steps.length; index += 1) {
-    const step = steps[index];
-    if (!source.commands[step.name]) {
-      throw new Error(
-        `sequence step ${index + 1}/${steps.length} in '${commandName}': command '${step.name}' not found in ${source.path}`
-      );
-    }
-    const resolved = getCommandDefinition(source, step.name, step.target);
-    const label = step.target ? `${step.name}:${step.target}` : step.name;
-    const envHint = Object.keys(step.env).length ? ` (${Object.entries(step.env).map(([k, v]) => `${k}=${v}`).join(" ")})` : "";
-    console.log(`\n── [${index + 1}/${steps.length}] ${label}${envHint} ──`);
-
-    let result;
-    try {
-      result = await runOneStepDef(source, step.name, resolved, step.env);
-    } catch (error) {
-      result = { status: 1, error };
-    }
-
-    const status = result.status ?? 1;
-    if (status !== 0) {
-      if (step.optional) {
-        console.warn(`⚠️  [${index + 1}/${steps.length}] ${label} failed (exit ${status}) — optional, continuing.${result.error ? " " + result.error.message : ""}`);
-        continue;
-      }
-      if (result.error) console.error(result.error.message);
-      console.error(`✗ sequence '${commandName}' stopped at step ${index + 1}/${steps.length} (${label}), exit ${status}.`);
-      return status;
-    }
-  }
-  console.log(`\n✓ sequence '${commandName}' — ${steps.length} step(s) done.`);
-  return 0;
-}
-
-// Nếu command khai báo select (selectFrom/selectChoices) → render picker, trả mảng value.
-// 'all' arg / PAN_ALL=1 / non-TTY ⇒ chọn hết. Trả null nếu command không có select.
-async function resolveSelection(source, def, forwardedArgs) {
-  if (!hasSelect(def)) return null;
-  const cwd = resolveCwd(source, def.cwd || ".");
-  const env = buildPanEnv(source, forwardedArgs);
-  const choices = resolveChoices(def, { cwd, env });
-  const forceAll =
-    forwardedArgs.includes("all") || process.env.PAN_ALL === "1" || !process.stdin.isTTY;
-  return runSelect(
-    {
-      message: def.selectMessage || "Chọn:",
-      multi: def.selectMulti !== "false",
-      all: def.selectAll !== "false",
-      choices,
-    },
-    { forceAll }
-  );
-}
-
-async function runProjectCommand(source, commandName, args) {
-  let subArg = "";
-  let forwardedArgs = [...args];
-
-  const def = source.commands[commandName];
-  if (def?.targets) {
-    if (forwardedArgs.length > 0 && def.targets[forwardedArgs[0]]) {
-      subArg = forwardedArgs.shift();
-    }
-  }
-
-  const resolved = getCommandDefinition(source, commandName, subArg);
-  if (!resolved) {
-    throw new Error(t("COMMAND_NOT_FOUND_IN_SOURCE__COMMAND_PATH", { command: commandName, path: source.path }));
-  }
-
-  if (resolved.sequence) {
-    const status = await runSequence(source, resolved, commandName);
-    process.exit(status);
-    return;
-  }
-
-  const selected = await resolveSelection(source, resolved, forwardedArgs);
-  // 'b' ở bước chọn (selectFrom/selectChoices) — KHÔNG thoát hẳn tiến trình: trả tín hiệu để
-  // caller (menu tương tác `pan` trống) quay lại bước chọn TRƯỚC đó thay vì chạy lệnh/thoát.
-  // Lời gọi trực tiếp không qua menu (`pan <command>` / runWithProjectResolution) không có "menu
-  // cha" để quay lại nên coi tín hiệu này như huỷ lệnh êm (xem runWithProjectResolution bên dưới).
-  if (selected === SELECT_BACK) {
-    return { backed: true };
-  }
-  if (selected && selected.length === 0) {
-    console.error(t("NOTHING_SELECTED_EXITING"));
-    process.exit(0);
-  }
-
-  if (resolved.shell) {
-    runShell(source, resolved, forwardedArgs, selected);
-    return;
-  }
-
-  if (resolved.exec) {
-    runExec(source, resolved, forwardedArgs, selected);
-    return;
-  }
-
-  throw new Error(
-    t("COMMAND_MISSING_EXEC_OR_SHELL_IN_SOURCE__COMMAND_PATH", { command: commandName, path: source.path })
-  );
-}
-
-function sourceLabel(source) {
-  if (source.scope === "workspace") {
-    return `${source.project} (workspace)`;
-  }
-  return source.repoName || source.project;
-}
-
-async function promptProjectChoice(matches, commandName) {
-  const choices = matches.map((source) => {
-    const def = source.commands[commandName];
-    const desc = def?.description ? ` — ${def.description}` : "";
-    return { name: `${sourceLabel(source)}${desc}`, value: source };
-  });
-  const picked = await runSelect(
-    {
-      message: t("COMMAND_MULTIPLE_PLACES_SELECT_PROJECT__COMMAND", { command: commandName }),
-      multi: false,
-      all: false,
-      choices,
-    },
-    { forceAll: false }
-  );
-  const source = Array.isArray(picked) ? picked[0] : picked;
-  if (!source || source === SELECT_BACK) {
-    throw new Error(t("NOTHING_SELECTED_EXITING"));
-  }
-  return source;
-}
-
-async function runWithProjectResolution(
-  matches,
-  commandName,
-  args,
-  projectFlag,
-  allSources = matches
-) {
-  const resolvedName = resolveCommandName(allSources, commandName);
-
-  if (matches.length === 0) {
-    throw new Error(t("COMMAND_NOT_FOUND_ANYWHERE__COMMAND", { command: commandName }));
-  }
-
-  let source = null;
-  if (projectFlag) {
-    source = matches.find((item) => sourceMatchesProject(item, projectFlag));
-    if (!source) {
-      const names = matches.map((item) => sourceLabel(item)).join(", ");
-      throw new Error(t("PROJECT_NOT_FOUND__PROJECT_NAMES", { project: projectFlag, names }));
-    }
-  } else if (matches.length === 1) {
-    source = matches[0];
-  } else {
-    const withTargetArg = matches.filter((item) => {
-      const def = item.commands[resolvedName];
-      return def?.targets && args[0] && def.targets[args[0]];
-    });
-    if (withTargetArg.length === 1) {
-      source = withTargetArg[0];
-    } else if (process.stdin.isTTY) {
-      source = await promptProjectChoice(matches, commandName);
-    } else {
-      const lines = matches.map(
-        (item, index) => `${index + 1}. ${sourceLabel(item)} (${item.root})`
-      );
-      throw new Error(
-        t("COMMAND_MULTIPLE_PROJECTS__COMMAND_LINES", { command: commandName, lines: lines.join("\n") })
-      );
-    }
-  }
-
-  // Lời gọi trực tiếp (không qua menu tương tác) không có "bước trước" để quay lại — 'b' ở đây
-  // chỉ đơn giản là huỷ êm (giống 'không chọn gì'), KHÔNG lỗi.
-  const result = await runProjectCommand(source, resolvedName, args);
-  if (result && result.backed) {
-    console.log(t("NOTHING_SELECTED_EXITING"));
-  }
-}
-
-function runGitScript(scriptName, args) {
-  const scriptPath = path.join(__dirname, "git", scriptName);
-  if (!fs.existsSync(scriptPath)) {
-    throw new Error(t("SCRIPT_NOT_FOUND__PATH", { path: scriptPath }));
-  }
-
-  const child = spawn(process.execPath, [scriptPath, ...args], spawnOptions({
-    stdio: "inherit",
-    env: process.env,
-  }));
-
-  child.on("exit", (code) => {
-    process.exit(code ?? 1);
-  });
-}
-
-module.exports = {
-  runProjectCommand,
-  runWithProjectResolution,
-  runGitScript,
-  sourceLabel,
-};

package/lib/serve.js

@@ -1,75 +0,0 @@
-// pan serve — chạy static HTTP server cho 1 thư mục build (vd output `panui:gen`).
-// Bọc package `serve` (npm). Ưu tiên bin local (đã cài trong pan-stack-cli); nếu chưa có
-// thì fallback `npx --yes serve` (tự tải). SPA mode (-s) để refresh/route sâu vẫn trả index.html.
-const { spawn } = require("child_process");
-const fs = require("fs");
-const path = require("path");
-
-function printServeHelp() {
-  console.log(`usage: pan serve [dir] [options]
-
-Chạy static server cho thư mục build (mặc định thư mục hiện tại).
-Ví dụ:
-  pnpm panui:gen examples/blog-project -o panui-demo   # build web demo tĩnh
-  pan serve panui-demo                                 # xem demo (http://localhost:3000)
-  pan serve panui-demo -p 8080
-
-options:
-  -p, --port <port>   Cổng lắng nghe (mặc định 3000)
-  -h, --help          Hiện trợ giúp này`);
-}
-
-function parseServeArgs(args) {
-  let dir = ".";
-  let port = "";
-  let dirSet = false;
-  for (let i = 0; i < args.length; i += 1) {
-    const a = args[i];
-    if (a === "-h" || a === "--help") {
-      printServeHelp();
-      process.exit(0);
-    } else if (a === "-p" || a === "--port") {
-      port = args[i + 1] || "";
-      i += 1;
-    } else if (a.startsWith("--port=")) {
-      port = a.slice("--port=".length);
-    } else if (!dirSet) {
-      dir = a;
-      dirSet = true;
-    }
-  }
-  return { dir, port };
-}
-
-/** Bin `serve` cài cục bộ trong pan-stack-cli (nếu có). */
-function localServeBin() {
-  const bin = path.join(__dirname, "..", "node_modules", ".bin", "serve");
-  return fs.existsSync(bin) ? bin : null;
-}
-
-function runServe(args) {
-  const { dir, port } = parseServeArgs(args);
-  const target = path.resolve(dir);
-  if (!fs.existsSync(target)) {
-    console.error(`\n✗ Không tồn tại thư mục: ${target}\n`);
-    process.exit(1);
-  }
-
-  // `serve <dir> -s [-l <port>]` — `-s` single-page (fallback index.html).
-  const serveArgs = [target, "-s"];
-  if (port) serveArgs.push("-l", String(port));
-
-  const local = localServeBin();
-  const cmd = local || "npx";
-  const spawnArgs = local ? serveArgs : ["--yes", "serve", ...serveArgs];
-
-  const child = spawn(cmd, spawnArgs, { stdio: "inherit" });
-  child.on("error", (err) => {
-    console.error(`\n✗ Không chạy được 'serve': ${err.message}`);
-    console.error("  Cài: cd apps/pan-stack-tools/pan-stack-cli && pnpm install (hoặc dùng npx serve).\n");
-    process.exit(1);
-  });
-  child.on("close", (code) => process.exit(code || 0));
-}
-
-module.exports = { runServe };