pan-stack-cli 0.2.1 → 0.2.3

package/lib/ui/palettes.js

@@ -1,103 +0,0 @@
-// lib/ui/palettes.js — bảng màu cho `pan ui init` scaffold.
-// Mục tiêu: chỉ đổi màu chủ đạo (primary/secondary/accent...) — panui theme + inline HTML
-// của template dùng placeholder __PRIMARY__ / __PRIMARY_DARK__ / ... init thay bằng hex bên dưới.
-//
-// theme app.panui.yaml chỉ nhận primary/sidebar/accent; các sắc còn lại (primaryDark, secondary,
-// primarySoft, onPrimary) dùng cho gradient/nền trong HTML inline (html-ui) của template landing.
-
-/** @typedef {{ id, label, primary, primaryDark, secondary, accent, sidebar, primarySoft, onPrimary }} Palette */
-
-/** Danh sách placeholder init sẽ thay trong MỌI file template. */
-const PALETTE_TOKENS = [
-  "primary",
-  "primaryDark",
-  "secondary",
-  "accent",
-  "sidebar",
-  "primarySoft",
-  "onPrimary",
-];
-
-/** @type {Palette[]} */
-const PALETTES = [
-  {
-    id: "indigo",
-    label: "Indigo — Xanh tím than (mặc định, hiện đại)",
-    primary: "#4f46e5",
-    primaryDark: "#4338ca",
-    secondary: "#0ea5e9",
-    accent: "#f59e0b",
-    sidebar: "#1e1b4b",
-    primarySoft: "#eef2ff",
-    onPrimary: "#ffffff",
-  },
-  {
-    id: "emerald",
-    label: "Emerald — Xanh lá (tươi, tin cậy)",
-    primary: "#059669",
-    primaryDark: "#047857",
-    secondary: "#14b8a6",
-    accent: "#f59e0b",
-    sidebar: "#064e3b",
-    primarySoft: "#ecfdf5",
-    onPrimary: "#ffffff",
-  },
-  {
-    id: "rose",
-    label: "Rose — Đỏ hồng (nổi bật, năng lượng)",
-    primary: "#e11d48",
-    primaryDark: "#be123c",
-    secondary: "#f43f5e",
-    accent: "#fb7185",
-    sidebar: "#4c0519",
-    primarySoft: "#fff1f2",
-    onPrimary: "#ffffff",
-  },
-  {
-    id: "violet",
-    label: "Violet — Tím (sáng tạo, cao cấp)",
-    primary: "#7c3aed",
-    primaryDark: "#6d28d9",
-    secondary: "#a855f7",
-    accent: "#ec4899",
-    sidebar: "#2e1065",
-    primarySoft: "#f5f3ff",
-    onPrimary: "#ffffff",
-  },
-  {
-    id: "amber",
-    label: "Amber — Cam hổ phách (ấm, thân thiện)",
-    primary: "#ea580c",
-    primaryDark: "#c2410c",
-    secondary: "#f59e0b",
-    accent: "#fbbf24",
-    sidebar: "#431407",
-    primarySoft: "#fff7ed",
-    onPrimary: "#ffffff",
-  },
-  {
-    id: "graphite",
-    label: "Graphite — Xám than (tối giản, sang trọng)",
-    primary: "#0f172a",
-    primaryDark: "#020617",
-    secondary: "#334155",
-    accent: "#38bdf8",
-    sidebar: "#020617",
-    primarySoft: "#f1f5f9",
-    onPrimary: "#ffffff",
-  },
-];
-
-const PALETTE_BY_ID = new Map(PALETTES.map((p) => [p.id, p]));
-
-/** Bản đồ placeholder `__TOKEN__` → hex cho 1 palette (dùng khi thay thế template). */
-function paletteReplacements(palette) {
-  const map = {};
-  for (const token of PALETTE_TOKENS) {
-    const upper = token.replace(/([a-z])([A-Z])/g, "$1_$2").toUpperCase();
-    map[`__${upper}__`] = palette[token];
-  }
-  return map; // vd { "__PRIMARY__": "#4f46e5", "__PRIMARY_DARK__": "#4338ca", ... }
-}
-
-module.exports = { PALETTES, PALETTE_BY_ID, PALETTE_TOKENS, paletteReplacements };

package/lib/ui/published-html.js

@@ -1,24 +0,0 @@
-// lib/ui/published-html.js — GATE sync (§4.6, OD-U2) rồi POST /projects/:id/export/html,
-// poll export/versions tới done, in URL công khai <apiBase>/p/<urlPublicPrefix>.
-const { ensureSynced, pollExportDone } = require("./export-gate");
-
-async function run(_args) {
-  const { api, project, backend } = await ensureSynced();
-
-  console.log(`Đang build & publish HTML cho '${project.name || project.id}'...`);
-  await api.exportHtml(backend.id);
-  console.log("Đang chờ build hoàn tất...");
-  const version = await pollExportDone(api, backend.id);
-
-  const prefix = project.urlPublicPrefix || (version && version.urlPublicPrefix);
-  if (!prefix) {
-    console.log(
-      "\nBuild xong nhưng không xác định được urlPublicPrefix — kiểm tra thủ công trên `GET /projects/:id`."
-    );
-    return;
-  }
-  const url = `${backend.apiUrl}/p/${prefix}`;
-  console.log(`\nĐã publish: ${url}`);
-}
-
-module.exports = { run };

package/lib/ui/sync.js

@@ -1,137 +0,0 @@
-// lib/ui/sync.js — push local→backend + diff + cảnh báo tên/id dự án + xác nhận (§4.5,
-// OD-U3). Xuất thêm `resolveProject`/`diffProject`/`pushDiff` để published-html.js và
-// gen-react-web-code.js tái dùng làm GATE (§4.6, OD-U2) qua lib/ui/export-gate.js.
-const fs = require("fs");
-const path = require("path");
-const { createApiClient } = require("./api");
-const { getApiConfig, loadCredential, isExpired } = require("./config");
-const {
-  findWorkspaceRoot,
-  scanPanuiProjects,
-  selectProject,
-  readBackendId,
-} = require("./workspace");
-const { computeDiff, isDiffClean, printDiff } = require("./diff");
-
-async function loadInquirer() {
-  const inq = await import("@inquirer/prompts").catch(() => null);
-  if (!inq) {
-    throw new Error("Cần TTY (@inquirer/prompts) cho lệnh này.");
-  }
-  return inq;
-}
-
-function toList(res) {
-  if (Array.isArray(res)) return res;
-  if (res && Array.isArray(res.items)) return res.items;
-  if (res && Array.isArray(res.data)) return res.data;
-  return [];
-}
-
-/**
- * Monorepo scan (§4.7) → chọn dự án panui → đọc backend.id. Thiếu backend.id → gợi ý clone.
- * @returns {Promise<{ projectDir: string, appYamlPath: string, backend: {id:string, apiUrl:string} }>}
- */
-async function resolveProject() {
-  const workspaceRoot = findWorkspaceRoot() || process.cwd();
-  const candidates = scanPanuiProjects(workspaceRoot);
-  const picked = await selectProject(candidates);
-  const backend = readBackendId(picked.appYamlPath);
-  if (!backend || !backend.id || !backend.apiUrl) {
-    throw new Error(
-      `Dự án '${picked.name}' chưa liên kết backend (thiếu backend.id/apiUrl trong app.panui.yaml) — chạy \`pan ui clone\` để tạo liên kết.`
-    );
-  }
-  return { projectDir: picked.dir, appYamlPath: picked.appYamlPath, backend };
-}
-
-/**
- * Chạy diff local↔backend cho 1 dự án đã resolve (yêu cầu credential hợp lệ).
- * @param {{ projectDir: string, backend: {id:string, apiUrl:string} }} resolved
- * @returns {Promise<{ api, project, backend, projectDir, diff }>}
- */
-async function diffProject({ projectDir, backend }) {
-  const cred = loadCredential(backend.apiUrl);
-  if (!cred || isExpired(cred)) {
-    throw new Error("Chưa đăng nhập hoặc key đã hết hạn — chạy `pan ui init` trước.");
-  }
-  const api = createApiClient({ apiUrl: backend.apiUrl, token: cred.token });
-  const project = await api.getProject(backend.id);
-  const treeRes = await api.listFiles(backend.id);
-  const backendFiles = toList(treeRes);
-  const diff = await computeDiff(projectDir, backendFiles, async (relPath) => {
-    const res = await api.getContent(backend.id, relPath);
-    return typeof res === "string" ? res : res && res.content;
-  });
-  return { api, project, backend, projectDir, diff };
-}
-
-/**
- * Đẩy thay đổi lên backend theo kết quả diffProject(). Hỏi riêng trước khi xóa.
- * @param {{ api, backend, projectDir, diff }} state
- */
-async function pushDiff({ api, backend, projectDir, diff }) {
-  for (const relPath of [...diff.added, ...diff.changed]) {
-    const content = fs.readFileSync(path.join(projectDir, relPath), "utf8");
-    await api.putFile(backend.id, {
-      path: relPath,
-      content,
-      editNote: "pan-cli sync",
-    });
-    console.log(`  đã đẩy: ${relPath}`);
-  }
-
-  if (diff.removed.length) {
-    const inq = await loadInquirer();
-    const ok = await inq.confirm({
-      message: `Xóa ${diff.removed.length} file trên backend không còn ở local?`,
-      default: false,
-    });
-    if (ok) {
-      for (const relPath of diff.removed) {
-        await api.deleteFile(backend.id, relPath);
-        console.log(`  đã xóa: ${relPath}`);
-      }
-    } else {
-      console.log("Bỏ qua xóa file trên backend.");
-    }
-  }
-}
-
-async function run(_args) {
-  const resolved = await resolveProject();
-  const state = await diffProject(resolved);
-  const { project, backend, diff } = state;
-
-  const inq = await loadInquirer();
-  console.log(
-    `Đồng bộ lên dự án '${project.name || project.id}' (id ${backend.id}) — đúng dự án?`
-  );
-  const proceed = await inq.confirm({ message: "Tiếp tục?", default: false });
-  if (!proceed) {
-    console.log("Đã hủy.");
-    return;
-  }
-
-  if (isDiffClean(diff)) {
-    console.log("Không có thay đổi để đồng bộ — local đã khớp backend.");
-    return;
-  }
-
-  console.log("Thay đổi phát hiện:");
-  printDiff(diff);
-
-  const ok = await inq.confirm({
-    message: "Đẩy các thay đổi trên lên backend?",
-    default: false,
-  });
-  if (!ok) {
-    console.log("Đã hủy.");
-    return;
-  }
-
-  await pushDiff(state);
-  console.log("Đồng bộ hoàn tất.");
-}
-
-module.exports = { run, resolveProject, diffProject, pushDiff };

package/lib/ui/workspace.js

@@ -1,213 +0,0 @@
-// lib/ui/workspace.js — monorepo scan cho `pan ui` (§4.7): tìm workspace root, quét
-// mọi app.panui.yaml (KHÔNG dùng `repositories:` trong .project.yaml), chọn dự án,
-// đọc/ghi khối `backend: { id, apiUrl }` trong app.panui.yaml.
-const fs = require("fs");
-const path = require("path");
-const { findNearestProjectManifest } = require("../discover");
-const { menuSelect } = require("../menu-prompt");
-const { t } = require("../i18n");
-
-const IGNORE_DIRS = new Set(["node_modules", ".git", "dist", ".codegen-check"]);
-const MAX_DEPTH = 5;
-const APP_YAML_NAME = "app.panui.yaml";
-
-/**
- * Tìm workspace root bằng walkUp `.project.yaml` (tái dùng lib/discover.js).
- * @param {string} [cwd]
- * @returns {string|null}
- */
-function findWorkspaceRoot(cwd = process.cwd()) {
-  const manifestPath = findNearestProjectManifest(cwd);
-  return manifestPath ? path.dirname(manifestPath) : null;
-}
-
-/**
- * Quét đệ quy tối đa MAX_DEPTH cấp từ root, tìm mọi app.panui.yaml.
- * @param {string} root
- * @returns {Array<{ appYamlPath: string, dir: string, name: string }>}
- */
-function scanPanuiProjects(root) {
-  const results = [];
-
-  function walk(dir, depth) {
-    if (depth > MAX_DEPTH) {
-      return;
-    }
-    let entries;
-    try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-
-    for (const entry of entries) {
-      if (entry.name.startsWith(".") && entry.name !== ".") {
-        // vẫn cho phép quét vào các thư mục ẩn không nằm trong IGNORE_DIRS? Không —
-        // giữ đơn giản: bỏ mọi thư mục ẩn để tránh .git, .cache, ... rơi vào quét.
-        if (entry.isDirectory()) {
-          continue;
-        }
-      }
-      const fullPath = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (IGNORE_DIRS.has(entry.name)) {
-          continue;
-        }
-        walk(fullPath, depth + 1);
-        continue;
-      }
-      if (entry.isFile() && entry.name === APP_YAML_NAME) {
-        results.push({
-          appYamlPath: fullPath,
-          dir,
-          name: path.basename(dir),
-        });
-      }
-    }
-  }
-
-  walk(root, 0);
-  return results;
-}
-
-/**
- * @param {Array<{ appYamlPath: string, dir: string, name: string }>} projects
- * @returns {Promise<{ appYamlPath: string, dir: string, name: string }>}
- */
-async function selectProject(projects) {
-  if (!projects || projects.length === 0) {
-    throw new Error(
-      `Không tìm thấy dự án panui nào (không có ${APP_YAML_NAME} trong workspace, quét tối đa ${MAX_DEPTH} cấp).`
-    );
-  }
-  if (projects.length === 1) {
-    return projects[0];
-  }
-
-  const message = `Chọn dự án panui (${projects.length} dự án):`;
-  const choices = projects.map((p) => ({
-    name: `${p.name}  (${path.relative(process.cwd(), p.appYamlPath)})`,
-    value: p.appYamlPath,
-  }));
-  const hotkeys = [{ key: "x", label: t("EXIT_LABEL"), value: "__exit__" }];
-
-  let choice;
-  try {
-    choice = await menuSelect({ message, choices, hotkeys });
-  } catch (err) {
-    if (String(err && err.message) !== "no-core") throw err;
-    const inq = await import("@inquirer/prompts").catch(() => null);
-    if (!inq || typeof inq.select !== "function") {
-      throw new Error(
-        "Nhiều dự án panui — cần TTY để chọn (không tìm thấy @inquirer/prompts)."
-      );
-    }
-    choice = await inq.select({
-      message,
-      choices: [...choices, new inq.Separator(), { name: `x  ${t("EXIT_LABEL")}`, value: "__exit__" }],
-      loop: false,
-    });
-  }
-  if (choice === "__exit__") {
-    console.log(t("EXITED"));
-    process.exit(0);
-  }
-  return projects.find((p) => p.appYamlPath === choice);
-}
-
-/**
- * Đọc khối `backend: { id, apiUrl }` trong app.panui.yaml (parser tối thiểu —
- * chỉ hỗ trợ khối phẳng 2 dòng con `id:`/`apiUrl:` thụt lề 2 khoảng trắng).
- * @param {string} appYamlPath
- * @returns {{ id: string, apiUrl: string } | null}
- */
-function readBackendId(appYamlPath) {
-  if (!fs.existsSync(appYamlPath)) {
-    return null;
-  }
-  const lines = fs.readFileSync(appYamlPath, "utf8").split(/\r?\n/);
-  let inBackend = false;
-  const result = {};
-  for (const rawLine of lines) {
-    if (!rawLine.trim()) {
-      continue;
-    }
-    const indent = rawLine.length - rawLine.trimStart().length;
-    const text = rawLine.trim();
-    if (indent === 0) {
-      inBackend = text.replace(/:$/, "") === "backend";
-      continue;
-    }
-    if (inBackend && indent === 2) {
-      const idx = text.indexOf(":");
-      if (idx < 0) continue;
-      const key = text.slice(0, idx).trim();
-      let value = text.slice(idx + 1).trim();
-      if (
-        (value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))
-      ) {
-        value = value.slice(1, -1);
-      }
-      if (key === "id" || key === "apiUrl") {
-        result[key] = value;
-      }
-    }
-  }
-  return result.id || result.apiUrl ? result : null;
-}
-
-/**
- * Ghi/cập nhật khối `backend: { id, apiUrl }` trong app.panui.yaml, giữ nguyên
- * mọi nội dung khác của file (thay thế khối backend cũ nếu có, nếu không thì
- * append vào cuối file).
- * @param {string} appYamlPath
- * @param {{ id: string, apiUrl: string }} backend
- */
-function writeBackendId(appYamlPath, { id, apiUrl }) {
-  const original = fs.existsSync(appYamlPath)
-    ? fs.readFileSync(appYamlPath, "utf8")
-    : "";
-  const lines = original.length ? original.split(/\r?\n/) : [];
-
-  const newBlock = ["backend:", `  id: ${id}`, `  apiUrl: ${apiUrl}`];
-
-  let start = -1;
-  let end = -1;
-  for (let i = 0; i < lines.length; i += 1) {
-    const trimmed = lines[i].trim();
-    const indent = lines[i].length - lines[i].trimStart().length;
-    if (indent === 0 && trimmed.replace(/:$/, "") === "backend") {
-      start = i;
-      end = i + 1;
-      while (end < lines.length) {
-        const nextIndent = lines[end].length - lines[end].trimStart().length;
-        if (!lines[end].trim() || nextIndent > 0) {
-          end += 1;
-          continue;
-        }
-        break;
-      }
-      break;
-    }
-  }
-
-  let updatedLines;
-  if (start >= 0) {
-    updatedLines = [...lines.slice(0, start), ...newBlock, ...lines.slice(end)];
-  } else {
-    updatedLines = lines.length ? [...lines, "", ...newBlock] : [...newBlock];
-  }
-
-  fs.mkdirSync(path.dirname(appYamlPath), { recursive: true });
-  fs.writeFileSync(appYamlPath, `${updatedLines.join("\n")}\n`, "utf8");
-}
-
-module.exports = {
-  APP_YAML_NAME,
-  findWorkspaceRoot,
-  scanPanuiProjects,
-  selectProject,
-  readBackendId,
-  writeBackendId,
-};