@mangtre/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,524 @@
+#!/usr/bin/env node
+import {
+  APP_SLUG,
+  ApiError,
+  apiFetch,
+  checkBundle,
+  getFlag,
+  loadAuth,
+  resolveApiBase,
+  saveAuth,
+  scaffoldApp,
+  titleFromSlug
+} from "./chunk-2ZQJSRHJ.js";
+import {
+  extractManifestComment
+} from "./chunk-MLWT65G7.js";
+
+// src/commands/build.ts
+import { spawnSync } from "child_process";
+import { existsSync as existsSync2 } from "fs";
+import { readFile as readFile2 } from "fs/promises";
+import { createRequire } from "module";
+import { dirname, join, resolve as resolve2 } from "path";
+
+// src/commands/check.ts
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import { resolve } from "path";
+var DEFAULT_BUNDLE = "dist/app.js";
+function reportCheck(result) {
+  if (!result.manifestFound) {
+    console.error(
+      "\u26A0\uFE0F  Kh\xF4ng t\xECm th\u1EA5y manifest (d\xF2ng `// mang-manifest:` \u1EDF \u0111\u1EA7u bundle). Ch\u1EA1y `mang build` tr\u01B0\u1EDBc."
+    );
+  }
+  const fails = result.findings.filter((f) => f.severity === "fail");
+  const warns = result.findings.filter((f) => f.severity === "warn");
+  for (const f of fails) console.error(`  \u2716 [${f.check}] ${f.message}`);
+  for (const f of warns) console.warn(`  \u26A0 [${f.check}] ${f.message}`);
+  const kb = (result.bytes / 1024).toFixed(0);
+  if (result.passed) {
+    console.log(`\u2705 \u0110\u1EA1t "chu\u1EA9n M\u0103ng" (${kb} KB \xB7 ${warns.length} c\u1EA3nh b\xE1o). S\u1EB5n s\xE0ng \u0111\u0103ng.`);
+  } else {
+    console.error(`\u274C Ch\u01B0a \u0111\u1EA1t (${fails.length} l\u1ED7i \xB7 ${warns.length} c\u1EA3nh b\xE1o \xB7 ${kb} KB).`);
+  }
+}
+async function runCheck(argv) {
+  const path = argv.find((a) => !a.startsWith("-")) ?? DEFAULT_BUNDLE;
+  const abs = resolve(process.cwd(), path);
+  if (!existsSync(abs)) {
+    console.error(`Kh\xF4ng th\u1EA5y bundle: ${path}. Ch\u1EA1y \`mang build\` tr\u01B0\u1EDBc, ho\u1EB7c truy\u1EC1n \u0111\u01B0\u1EDDng d\u1EABn.`);
+    process.exitCode = 1;
+    return;
+  }
+  const source = await readFile(abs, "utf8");
+  const result = checkBundle({ source, appId: getFlag(argv, "app") });
+  reportCheck(result);
+  if (!result.passed) process.exitCode = 1;
+}
+
+// src/commands/build.ts
+var OUTPUT = "dist/app.js";
+function resolveViteBin(cwd) {
+  try {
+    const require2 = createRequire(resolve2(cwd, "package.json"));
+    const pkgPath = require2.resolve("vite/package.json");
+    return join(dirname(pkgPath), "bin", "vite.js");
+  } catch {
+    return null;
+  }
+}
+async function runBuild(_argv) {
+  const cwd = process.cwd();
+  if (!existsSync2(resolve2(cwd, "vite.config.ts"))) {
+    console.error("Kh\xF4ng th\u1EA5y vite.config.ts trong th\u01B0 m\u1EE5c n\xE0y. Ch\u1EA1y trong th\u01B0 m\u1EE5c mini-app.");
+    process.exitCode = 1;
+    return;
+  }
+  const viteBin = resolveViteBin(cwd);
+  if (!viteBin) {
+    console.error("Kh\xF4ng t\xECm th\u1EA5y vite. Ch\u1EA1y `pnpm install` trong th\u01B0 m\u1EE5c app tr\u01B0\u1EDBc.");
+    process.exitCode = 1;
+    return;
+  }
+  console.log("\u{1F528} \u0110ang build (vite)\u2026");
+  const res = spawnSync(process.execPath, [viteBin, "build"], { stdio: "inherit", cwd });
+  if (res.status !== 0) {
+    console.error("\u274C Vite build th\u1EA5t b\u1EA1i.");
+    process.exitCode = res.status ?? 1;
+    return;
+  }
+  const out = resolve2(cwd, OUTPUT);
+  if (!existsSync2(out)) {
+    console.error(`Build xong nh\u01B0ng kh\xF4ng th\u1EA5y ${OUTPUT}. Ki\u1EC3m tra c\u1EA5u h\xECnh mangLibConfig.`);
+    process.exitCode = 1;
+    return;
+  }
+  const source = await readFile2(out, "utf8");
+  console.log("\n\u{1F50E} Preflight (chu\u1EA9n M\u0103ng):");
+  const result = checkBundle({ source });
+  reportCheck(result);
+  if (!result.passed) process.exitCode = 1;
+}
+
+// src/commands/login.ts
+import { spawn } from "child_process";
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function openBrowser(url) {
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return;
+    if (process.platform === "darwin") {
+      spawn("open", [parsed.href], { stdio: "ignore", detached: true }).unref();
+    } else if (process.platform === "win32") {
+      spawn("cmd", ["/c", "start", "", parsed.href], { stdio: "ignore", detached: true }).unref();
+    } else {
+      spawn("xdg-open", [parsed.href], { stdio: "ignore", detached: true }).unref();
+    }
+  } catch {
+  }
+}
+async function runLogin(argv) {
+  const base = resolveApiBase(argv);
+  let start;
+  try {
+    start = await apiFetch("/v1/auth/device/start", { base, method: "POST" });
+  } catch (err) {
+    const is404 = err instanceof ApiError && err.status === 404;
+    console.error(`Kh\xF4ng b\u1EAFt \u0111\u1EA7u \u0111\u01B0\u1EE3c \u0111\u0103ng nh\u1EADp: ${err.message}`);
+    if (is404) {
+      console.error(
+        `   API ${base} ch\u01B0a h\u1ED7 tr\u1EE3 \u0111\u0103ng nh\u1EADp thi\u1EBFt b\u1ECB (c\xF3 th\u1EC3 ch\u01B0a deploy Phase 2).
+   Th\u1EED: mang login --api https://api-dev.mang.rumitx.com  (ho\u1EB7c export MANG_API=\u2026)`
+      );
+    }
+    process.exitCode = 1;
+    return;
+  }
+  console.log("\n\u{1F511} \u0110\u0103ng nh\u1EADp M\u1ECDc");
+  console.log(`   M\xE3 c\u1EE7a b\u1EA1n: \x1B[1m${start.userCode}\x1B[0m`);
+  console.log(`   M\u1EDF: ${start.verificationUriComplete}
+`);
+  openBrowser(start.verificationUriComplete);
+  const deadline = Date.now() + start.expiresIn * 1e3;
+  const intervalMs = Math.max(2, start.interval) * 1e3;
+  process.stdout.write("   \u0110ang ch\u1EDD duy\u1EC7t");
+  while (Date.now() < deadline) {
+    await sleep(intervalMs);
+    process.stdout.write(".");
+    let poll;
+    try {
+      poll = await apiFetch("/v1/auth/device/poll", {
+        base,
+        method: "POST",
+        body: { deviceCode: start.deviceCode }
+      });
+    } catch {
+      continue;
+    }
+    if (poll.status === "approved" && poll.token) {
+      saveAuth({ token: poll.token, api: base, handle: poll.handle });
+      console.log(`
+\u2705 \u0110\xE3 \u0111\u0103ng nh\u1EADp${poll.handle ? ` (@${poll.handle})` : ""}.`);
+      return;
+    }
+    if (poll.status === "denied") {
+      console.error("\n\u274C Y\xEAu c\u1EA7u b\u1ECB t\u1EEB ch\u1ED1i.");
+      process.exitCode = 1;
+      return;
+    }
+  }
+  console.error("\n\u274C H\u1EBFt h\u1EA1n. Ch\u1EA1y l\u1EA1i `mang login`.");
+  process.exitCode = 1;
+}
+
+// src/commands/new.ts
+import { resolve as resolve3 } from "path";
+async function runNew(argv) {
+  const slug = argv.find((a) => !a.startsWith("-"));
+  if (!slug) {
+    console.error("Thi\u1EBFu slug. D\xF9ng: mang new <slug>");
+    process.exitCode = 1;
+    return;
+  }
+  if (!APP_SLUG.test(slug)) {
+    console.error(`Slug kh\xF4ng h\u1EE3p l\u1EC7: "${slug}" \u2014 ph\u1EA3i l\xE0 ch\u1EEF th\u01B0\u1EDDng, 3\u201340 k\xFD t\u1EF1 (a-z, 0-9, -).`);
+    process.exitCode = 1;
+    return;
+  }
+  const name = getFlag(argv, "name") ?? titleFromSlug(slug);
+  const icon = getFlag(argv, "icon") ?? "\u{1F331}";
+  const dir = getFlag(argv, "dir") ?? slug;
+  const targetDir = resolve3(process.cwd(), dir);
+  try {
+    const written = await scaffoldApp({ slug, name, icon, targetDir });
+    console.log(`\u2705 T\u1EA1o mini-app "${name}" (${slug}) t\u1EA1i ${dir}`);
+    console.log(`   ${written.length} t\u1EC7p.`);
+    console.log("\nTi\u1EBFp theo:");
+    console.log(`   cd ${dir} && pnpm install`);
+    console.log("   mang build      # build \u2192 dist/app.js + t\u1EF1 check");
+    console.log("   mang check      # preflight offline (gi\u1ED1ng c\u1ED5ng duy\u1EC7t c\u1EE7a server)");
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/publish.ts
+import { existsSync as existsSync3 } from "fs";
+import { readFile as readFile3 } from "fs/promises";
+import { resolve as resolve4 } from "path";
+var DEFAULT_BUNDLE2 = "dist/app.js";
+function asManifest(v) {
+  if (v && typeof v === "object" && !Array.isArray(v)) {
+    const m = v;
+    if (typeof m.id === "string" && typeof m.name === "string" && typeof m.icon === "string" && typeof m.version === "string") {
+      return m;
+    }
+  }
+  return null;
+}
+async function runPublish(argv) {
+  const auth = loadAuth();
+  if (!auth) {
+    console.error("Ch\u01B0a \u0111\u0103ng nh\u1EADp. Ch\u1EA1y `mang login` tr\u01B0\u1EDBc.");
+    process.exitCode = 1;
+    return;
+  }
+  const path = argv.find((a) => !a.startsWith("-")) ?? DEFAULT_BUNDLE2;
+  const abs = resolve4(process.cwd(), path);
+  if (!existsSync3(abs)) {
+    console.error(`Kh\xF4ng th\u1EA5y bundle: ${path}. Ch\u1EA1y \`mang build\` tr\u01B0\u1EDBc.`);
+    process.exitCode = 1;
+    return;
+  }
+  const source = await readFile3(abs, "utf8");
+  const manifest = asManifest(extractManifestComment(source));
+  if (!manifest) {
+    console.error("Bundle thi\u1EBFu manifest h\u1EE3p l\u1EC7 (d\xF2ng `// mang-manifest:`). Ch\u1EA1y `mang build`.");
+    process.exitCode = 1;
+    return;
+  }
+  console.log("\u{1F50E} Preflight (chu\u1EA9n M\u0103ng):");
+  const result = checkBundle({ source, manifest });
+  reportCheck(result);
+  if (!result.passed) {
+    console.error("S\u1EEDa c\xE1c l\u1ED7i tr\xEAn r\u1ED3i `mang publish` l\u1EA1i.");
+    process.exitCode = 1;
+    return;
+  }
+  const base = auth.api;
+  try {
+    await apiFetch("/v1/apps", {
+      base,
+      token: auth.token,
+      body: { id: manifest.id, nameVi: manifest.name, icon: manifest.icon }
+    });
+    console.log(`\u{1F4E6} \u0110\xE3 t\u1EA1o app "${manifest.id}".`);
+  } catch (err) {
+    if (!(err instanceof ApiError) || err.status !== 409) {
+      console.error(`Kh\xF4ng t\u1EA1o \u0111\u01B0\u1EE3c app: ${err.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    const mine = await apiFetch("/v1/apps/mine", {
+      base,
+      token: auth.token
+    }).catch(() => ({ apps: [] }));
+    if (!mine.apps.some((a) => a.id === manifest.id)) {
+      console.error(`Slug "${manifest.id}" \u0111\xE3 thu\u1ED9c v\u1EC1 creator kh\xE1c.`);
+      process.exitCode = 1;
+      return;
+    }
+  }
+  const form = new FormData();
+  form.set("bundle", new Blob([source], { type: "text/javascript" }), "app.js");
+  form.set("version", manifest.version);
+  form.set("manifest", JSON.stringify(manifest));
+  try {
+    const res = await apiFetch(
+      `/v1/apps/${manifest.id}/versions`,
+      { base, token: auth.token, body: form }
+    );
+    console.log(`
+\u{1F680} \u0110\xE3 \u0111\u0103ng v${manifest.version} (${res.status}). Version: ${res.versionId}`);
+    console.log("   Theo d\xF5i duy\u1EC7t: `mang status`.");
+  } catch (err) {
+    console.error(`\u0110\u0103ng th\u1EA5t b\u1EA1i: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/run.ts
+import { spawn as spawn2, spawnSync as spawnSync2 } from "child_process";
+import { existsSync as existsSync4 } from "fs";
+import { readFile as readFile4, writeFile } from "fs/promises";
+import { createServer } from "http";
+import { createRequire as createRequire2 } from "module";
+import { dirname as dirname2, join as join2, resolve as resolve5 } from "path";
+var FIRST_PORT = 5174;
+function resolveViteBin2(cwd) {
+  try {
+    const require2 = createRequire2(resolve5(cwd, "package.json"));
+    return join2(dirname2(require2.resolve("vite/package.json")), "bin", "vite.js");
+  } catch {
+    return null;
+  }
+}
+function openBrowser2(url) {
+  try {
+    const u = new URL(url);
+    if (u.protocol !== "http:" && u.protocol !== "https:") return;
+    if (process.platform === "darwin")
+      spawn2("open", [u.href], { stdio: "ignore", detached: true }).unref();
+    else if (process.platform === "win32")
+      spawn2("cmd", ["/c", "start", "", u.href], { stdio: "ignore", detached: true }).unref();
+    else spawn2("xdg-open", [u.href], { stdio: "ignore", detached: true }).unref();
+  } catch {
+  }
+}
+var PREVIEW_THEME = JSON.stringify({
+  color: {
+    mangGreen: "#37B693",
+    shoot: "#8FE3B8",
+    bamboo: "#1F7A5C",
+    soil: "#B5793A",
+    sun: "#E8C547",
+    paper: "#F4F1E8",
+    dark: "#14201C"
+  },
+  font: { heading: "Quicksand", body: "Inter" }
+});
+function harnessHtml() {
+  return `<!doctype html>
+<html lang="vi"><head><meta charset="utf-8"/>
+<meta name="viewport" content="width=device-width,initial-scale=1"/>
+<title>M\u1ECDc preview</title><style>body{margin:0}</style></head>
+<body><div id="root"></div>
+<script type="module">
+import { mount, prepareDemo } from "./app.js";
+const NS = "mang:preview:";
+const storage = {
+  get: async (k) => { const v = localStorage.getItem(NS + k); return v == null ? null : JSON.parse(v); },
+  set: async (k, val) => { localStorage.setItem(NS + k, JSON.stringify(val)); },
+  list: async (p = "") => Object.keys(localStorage).filter((k) => k.startsWith(NS + p)).map((k) => k.slice(NS.length)),
+};
+const sdk = { storage, theme: ${PREVIEW_THEME}, locale: "vi" };
+try { if (prepareDemo) await prepareDemo(sdk); } catch (e) { console.warn("prepareDemo:", e); }
+mount(document.getElementById("root"), sdk);
+</script></body></html>`;
+}
+function contentType(file) {
+  if (file.endsWith(".html")) return "text/html; charset=utf-8";
+  if (file.endsWith(".js")) return "text/javascript; charset=utf-8";
+  if (file.endsWith(".css")) return "text/css; charset=utf-8";
+  return "application/octet-stream";
+}
+async function runRun(_argv) {
+  const cwd = process.cwd();
+  if (!existsSync4(resolve5(cwd, "vite.config.ts"))) {
+    console.error("Kh\xF4ng th\u1EA5y vite.config.ts. Ch\u1EA1y trong th\u01B0 m\u1EE5c mini-app.");
+    process.exitCode = 1;
+    return;
+  }
+  const viteBin = resolveViteBin2(cwd);
+  if (!viteBin) {
+    console.error("Kh\xF4ng t\xECm th\u1EA5y vite. Ch\u1EA1y `pnpm install` trong th\u01B0 m\u1EE5c app tr\u01B0\u1EDBc.");
+    process.exitCode = 1;
+    return;
+  }
+  console.log("\u{1F528} \u0110ang build \u0111\u1EC3 xem tr\u01B0\u1EDBc\u2026");
+  const res = spawnSync2(process.execPath, [viteBin, "build"], { stdio: "inherit", cwd });
+  if (res.status !== 0) {
+    console.error("\u274C Build th\u1EA5t b\u1EA1i.");
+    process.exitCode = res.status ?? 1;
+    return;
+  }
+  const distDir = resolve5(cwd, "dist");
+  if (!existsSync4(join2(distDir, "app.js"))) {
+    console.error("Build xong nh\u01B0ng kh\xF4ng th\u1EA5y dist/app.js.");
+    process.exitCode = 1;
+    return;
+  }
+  await writeFile(join2(distDir, "index.html"), harnessHtml(), "utf8");
+  const server = createServer(async (req, res2) => {
+    const path = (req.url ?? "/").split("?")[0] ?? "/";
+    const file = path === "/" ? "index.html" : path.replace(/^\/+/, "");
+    try {
+      const buf = await readFile4(join2(distDir, file));
+      res2.setHeader("Content-Type", contentType(file));
+      res2.end(buf);
+    } catch {
+      res2.statusCode = 404;
+      res2.end("not found");
+    }
+  });
+  let port = FIRST_PORT;
+  server.on("error", (err) => {
+    if (err.code === "EADDRINUSE" && port < FIRST_PORT + 10) {
+      port += 1;
+      server.listen(port);
+    } else {
+      console.error(`Kh\xF4ng m\u1EDF \u0111\u01B0\u1EE3c server: ${err.message}`);
+      process.exitCode = 1;
+    }
+  });
+  server.listen(port, () => {
+    const url = `http://localhost:${port}/`;
+    console.log(`
+\u{1F331} Xem tr\u01B0\u1EDBc: ${url}`);
+    console.log("   sdk = storage(local) + theme + locale gi\u1EA3 l\u1EADp \xB7 Ctrl+C \u0111\u1EC3 d\u1EEBng.");
+    console.log("   S\u1EEDa code \u2192 ch\u1EA1y l\u1EA1i `mang run` \u0111\u1EC3 build + xem l\u1EA1i.");
+    openBrowser2(url);
+  });
+}
+
+// src/commands/status.ts
+var STATUS_ICON = {
+  live: "\u{1F7E2}",
+  approved: "\u{1F7E2}",
+  pending_review: "\u{1F7E1}",
+  validating: "\u{1F7E1}",
+  in_review: "\u{1F7E1}",
+  rejected: "\u{1F534}",
+  draft: "\u26AA",
+  delisted: "\u26AB"
+};
+async function runStatus(_argv) {
+  const auth = loadAuth();
+  if (!auth) {
+    console.error("Ch\u01B0a \u0111\u0103ng nh\u1EADp. Ch\u1EA1y `mang login` tr\u01B0\u1EDBc.");
+    process.exitCode = 1;
+    return;
+  }
+  let data;
+  try {
+    data = await apiFetch("/v1/apps/mine", {
+      base: auth.api,
+      token: auth.token
+    });
+  } catch (err) {
+    console.error(`Kh\xF4ng l\u1EA5y \u0111\u01B0\u1EE3c tr\u1EA1ng th\xE1i: ${err.message}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (data.apps.length === 0) {
+    console.log("Ch\u01B0a c\xF3 app n\xE0o. T\u1EA1o b\u1EB1ng `mang new`, r\u1ED3i `mang publish`.");
+    return;
+  }
+  for (const app of data.apps) {
+    const latest = app.versions[0];
+    const icon = STATUS_ICON[app.status] ?? "\u2022";
+    console.log(`
+${icon} ${app.icon} ${app.nameVi} (${app.id}) \u2014 ${app.status}`);
+    if (latest) {
+      const fails = latest.findings?.filter((f) => f.severity === "fail").length ?? 0;
+      const warns = latest.findings?.filter((f) => f.severity === "warn").length ?? 0;
+      console.log(`   v${latest.version}: ${latest.status} \xB7 ${fails} l\u1ED7i \xB7 ${warns} c\u1EA3nh b\xE1o`);
+      if (latest.reason) console.log(`   L\xFD do: ${latest.reason}`);
+    }
+  }
+}
+
+// src/index.ts
+var VERSION = "0.1.0";
+function printHelp() {
+  console.log(`M\u1ECDc \u2014 b\u1ED9 c\xF4ng c\u1EE5 creator c\u1EE7a M\u0103ng (CLI: mang v${VERSION})
+
+C\xE1ch d\xF9ng:
+  mang new <slug> [--dir <path>] [--name <t\xEAn>] [--icon <emoji>]
+      T\u1EA1o m\u1ED9t mini-app m\u1EDBi \u0111\xFAng "chu\u1EA9n M\u0103ng" (React + Vite + @mangtre/ui).
+  mang build
+      Build mini-app trong th\u01B0 m\u1EE5c hi\u1EC7n t\u1EA1i \u2192 dist/app.js, r\u1ED3i t\u1EF1 preflight.
+  mang run
+      Build + xem tr\u01B0\u1EDBc app ngay tr\xEAn tr\xECnh duy\u1EC7t (sdk gi\u1EA3 l\u1EADp) \u2014 kh\xF4ng c\u1EA7n \u0111\u0103ng.
+  mang check [bundlePath] [--app <id>]
+      Preflight offline m\u1ED9t bundle \u0111\xE3 build (gi\u1ED1ng c\u1ED5ng duy\u1EC7t c\u1EE7a server).
+  mang login [--api <url>]
+      \u0110\u0103ng nh\u1EADp (device flow) \u2014 duy\u1EC7t m\xE3 tr\xEAn tr\xECnh duy\u1EC7t, l\u01B0u token c\u1EE5c b\u1ED9.
+  mang publish [bundlePath]
+      Preflight + \u0111\u0103ng bundle l\xEAn M\u0103ng (t\u1EA1o app n\u1EBFu ch\u01B0a c\xF3). C\u1EA7n \u0111\u0103ng nh\u1EADp.
+  mang status
+      Xem app c\u1EE7a b\u1EA1n + tr\u1EA1ng th\xE1i duy\u1EC7t m\u1ED7i version. C\u1EA7n \u0111\u0103ng nh\u1EADp.
+
+  mang help | --version`);
+}
+async function main() {
+  const [cmd, ...rest] = process.argv.slice(2);
+  switch (cmd) {
+    case "new":
+      return runNew(rest);
+    case "check":
+      return runCheck(rest);
+    case "build":
+      return runBuild(rest);
+    case "run":
+      return runRun(rest);
+    case "login":
+      return runLogin(rest);
+    case "publish":
+      return runPublish(rest);
+    case "status":
+      return runStatus(rest);
+    case "-v":
+    case "--version":
+      console.log(VERSION);
+      return;
+    case void 0:
+    case "help":
+    case "-h":
+    case "--help":
+      printHelp();
+      return;
+    default:
+      console.error(`L\u1EC7nh kh\xF4ng r\xF5: ${cmd}
+`);
+      printHelp();
+      process.exitCode = 1;
+  }
+}
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exitCode = 1;
+});

package/dist/lib.js

@@ -0,0 +1,28 @@
+import {
+  ApiError,
+  DEFAULT_API_BASE,
+  apiFetch,
+  authFilePath,
+  checkBundle,
+  clearAuth,
+  loadAuth,
+  saveAuth,
+  scaffoldApp
+} from "./chunk-2ZQJSRHJ.js";
+import {
+  MANIFEST_COMMENT_PREFIX,
+  extractManifestComment
+} from "./chunk-MLWT65G7.js";
+export {
+  ApiError,
+  DEFAULT_API_BASE,
+  MANIFEST_COMMENT_PREFIX,
+  apiFetch,
+  authFilePath,
+  checkBundle,
+  clearAuth,
+  extractManifestComment,
+  loadAuth,
+  saveAuth,
+  scaffoldApp
+};

package/dist/vite.js

@@ -0,0 +1,36 @@
+import {
+  MANIFEST_COMMENT_PREFIX
+} from "./chunk-MLWT65G7.js";
+
+// src/vite.ts
+function mangLibConfig(opts) {
+  const entry = opts.entry ?? "src/index.tsx";
+  const banner = `${MANIFEST_COMMENT_PREFIX}${JSON.stringify(opts.manifest)}`;
+  const manifestBannerPlugin = {
+    name: "mang:manifest-banner",
+    generateBundle(_options, bundle) {
+      for (const file of Object.values(bundle)) {
+        if (file.type === "chunk" && file.isEntry && typeof file.code === "string") {
+          file.code = `${banner}
+${file.code}`;
+        }
+      }
+    }
+  };
+  return {
+    build: {
+      target: "es2022",
+      emptyOutDir: true,
+      lib: { entry, formats: ["es"], fileName: () => "app.js" }
+    },
+    // The mini-app runs in a browser sandbox with no `process`; bake the prod NODE_ENV in so React
+    // (and other libs that branch on it) don't reference a missing `process` global at runtime.
+    define: {
+      "process.env.NODE_ENV": JSON.stringify("production")
+    },
+    plugins: [manifestBannerPlugin]
+  };
+}
+export {
+  mangLibConfig
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@mangtre/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "mang": "./dist/index.js"
+  },
+  "exports": {
+    "./vite": {
+      "types": "./src/vite.ts",
+      "default": "./dist/vite.js"
+    },
+    "./lib": {
+      "types": "./src/lib/index.ts",
+      "default": "./dist/lib.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "src"
+  ],
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "tsup": "^8.3.5",
+    "vitest": "^2.1.8",
+    "@mangtre/standard": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/src/commands/args.ts

@@ -0,0 +1,22 @@
+/** Tiny argv helpers — a 3-command CLI doesn't need a parser dependency. */
+
+/** Read `--flag value` or `--flag=value` from argv, or undefined. */
+export function getFlag(argv: string[], name: string): string | undefined {
+  const eq = argv.find((a) => a.startsWith(`--${name}=`));
+  if (eq) return eq.slice(name.length + 3);
+  const idx = argv.indexOf(`--${name}`);
+  if (idx >= 0 && idx + 1 < argv.length) {
+    const next = argv[idx + 1];
+    if (next && !next.startsWith("-")) return next;
+  }
+  return undefined;
+}
+
+/** "chia-tien-nhom" → "Chia Tien Nhom" (a sensible default display name). */
+export function titleFromSlug(slug: string): string {
+  return slug
+    .split("-")
+    .filter(Boolean)
+    .map((w) => w[0]?.toUpperCase() + w.slice(1))
+    .join(" ");
+}