@sudajs/cli 0.9.4 → 0.10.1

package/bin/suda-dev.js

@@ -2,6 +2,7 @@
 
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import pc from "picocolors";
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const sourceEntry = path.resolve(scriptDir, "../src/index.ts");
@@ -10,6 +11,6 @@ try {
   const mod = await import(pathToFileURL(sourceEntry).href);
   await mod.main();
 } catch (error) {
-  console.error(error instanceof Error ? error.message : error);
+  console.error(pc.red(error instanceof Error ? error.message : String(error)));
   process.exitCode = 1;
 }

package/bin/suda.js

@@ -5,6 +5,7 @@ import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import pc from "picocolors";
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const sourceEntry = path.resolve(scriptDir, "../src/index.ts");
@@ -30,7 +31,7 @@ if (existsSync(sourceEntry)) {
   );
 
   if (result.error) {
-    console.error(result.error.message);
+    console.error(pc.red(result.error.message));
     process.exit(1);
   }
 
@@ -42,7 +43,7 @@ if (existsSync(sourceEntry)) {
 }
 
 if (!existsSync(distEntry)) {
-  console.error("@sudajs/cli is not built yet. Run `pnpm --filter @sudajs/cli build` first.");
+  console.error(pc.red("@sudajs/cli is not built yet. Run `pnpm --filter @sudajs/cli build` first."));
   process.exit(1);
 }
 
@@ -50,6 +51,6 @@ const mod = await import(pathToFileURL(distEntry).href);
 try {
   await mod.main();
 } catch (error) {
-  console.error(error instanceof Error ? error.message : error);
+  console.error(pc.red(error instanceof Error ? error.message : String(error)));
   process.exitCode = 1;
 }

package/dist/index.d.ts

@@ -90,6 +90,7 @@ declare function fetchJson<T>(url: string, options?: RequestInit & {
     token?: string;
 }): Promise<T>;
 declare function validateTheme(root: string): Promise<ValidatedTheme>;
+declare function validateThemeLocales(root: string): Promise<void>;
 declare function toViteModuleUrl(root: string, absolutePath: string): string;
 declare function buildTheme(root: string): Promise<ValidatedTheme>;
 declare function finalizeTheme(root: string): Promise<ValidatedTheme>;
@@ -110,6 +111,7 @@ declare const __testUtils: {
     slugifyThemeName: typeof slugifyThemeName;
     validateThemeKey: typeof validateThemeKey;
     validateThemeName: typeof validateThemeName;
+    validateThemeLocales: typeof validateThemeLocales;
     toViteModuleUrl: typeof toViteModuleUrl;
     updateRemotePageDraft: typeof updateRemotePageDraft;
 };

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createHash } from 'crypto';
-import fs, { writeFile, stat, readFile, readdir, mkdir, copyFile, rm } from 'fs/promises';
+import fs, { writeFile, stat, readdir, readFile, mkdir, copyFile, rm } from 'fs/promises';
 import { createRequire } from 'module';
 import path2 from 'path';
 import { createInterface } from 'readline/promises';
@@ -13,7 +13,35 @@ import { Command } from 'commander';
 import { build } from 'esbuild';
 import { z } from 'zod';
 import os from 'os';
+import pc from 'picocolors';
 
+var style = {
+  success: pc.green,
+  warning: pc.yellow,
+  error: pc.red,
+  info: pc.cyan,
+  url: pc.cyan,
+  code: pc.bold,
+  value: pc.bold,
+  path: pc.magenta
+};
+function success(message) {
+  return style.success(message);
+}
+function warning(message) {
+  return style.warning(message);
+}
+function error(message) {
+  return style.error(message);
+}
+function info(message) {
+  return style.info(message);
+}
+function themeRef(key, version) {
+  return style.value(`${key}@${version}`);
+}
+
+// src/auth.ts
 function getConfigPath() {
   return path2.join(os.homedir(), ".config", "suda", "config.json");
 }
@@ -78,7 +106,7 @@ async function cliAuthFetch(pathname, init = {}) {
 }
 async function login(host = "app.sudayun.cn") {
   const baseUrl = `${protocolForHost(host)}://${host}`;
-  console.log(`Requesting device authorization from ${baseUrl}...`);
+  console.log(`Requesting device authorization from ${style.url(baseUrl)}...`);
   const deviceRes = await fetch(`${baseUrl}/api/cli-auth/device`, {
     method: "POST"
   });
@@ -90,9 +118,9 @@ async function login(host = "app.sudayun.cn") {
   console.log(`
 Please open the following URL in your browser to authorize Suda CLI:
 `);
-  console.log(`  ${authUrl}
+  console.log(`  ${style.url(authUrl)}
 `);
-  console.log(`Your confirmation code is: ${userCode}
+  console.log(`Your confirmation code is: ${style.code(userCode)}
 `);
   try {
     const open = (await import('open')).default;
@@ -102,7 +130,7 @@ Please open the following URL in your browser to authorize Suda CLI:
   const pollInterval = (interval || 5) * 1e3;
   const timeoutSeconds = expiresIn || 300;
   const deadline = Date.now() + timeoutSeconds * 1e3;
-  console.log("Waiting for authorization...");
+  console.log(info("Waiting for authorization..."));
   while (Date.now() < deadline) {
     await new Promise((resolve) => setTimeout(resolve, pollInterval));
     const pollRes = await fetch(`${baseUrl}/api/cli-auth/poll`, {
@@ -113,7 +141,7 @@ Please open the following URL in your browser to authorize Suda CLI:
     const data = await pollRes.json();
     if (pollRes.ok && data.status === "approved" && data.token) {
       await writeAuthConfig({ sessionToken: data.token, host });
-      console.log("Successfully authorized!");
+      console.log(success("Successfully authorized!"));
       return;
     }
     if (data.error === "authorization_pending") {
@@ -126,7 +154,7 @@ Please open the following URL in your browser to authorize Suda CLI:
 async function status() {
   const config = await readAuthConfig();
   if (!config) {
-    console.log("Not logged in. Run `suda auth login` to authenticate.");
+    console.log(warning("Not logged in. Run `suda auth login` to authenticate."));
     return;
   }
   let res;
@@ -134,41 +162,43 @@ async function status() {
     res = await cliAuthFetch("/api/cli-auth/whoami");
   } catch (err) {
     if (err instanceof CliAuthExpiredError) {
-      console.log(err.message);
+      console.log(warning(err.message));
       return;
     }
-    console.error(`Failed to connect to ${config.host}.`);
+    console.error(error(`Failed to connect to ${config.host}.`));
     return;
   }
   if (!res.ok) {
     console.error(
-      `Failed to verify session (${res.status} ${res.statusText}). Try again later.`
+      error(`Failed to verify session (${res.status} ${res.statusText}). Try again later.`)
     );
     return;
   }
   const data = await res.json();
   const label = data.user?.email ?? data.user?.name ?? "your account";
-  console.log(`Logged in as ${label} on ${config.host}`);
+  console.log(success(`Logged in as ${style.value(label)} on ${style.url(config.host)}`));
 }
 async function logout() {
   const config = await readAuthConfig();
   if (!config) {
-    console.log("Not logged in.");
+    console.log(warning("Not logged in."));
     return;
   }
   try {
     await cliAuthFetch("/api/cli-auth/revoke", { method: "POST" });
   } catch (err) {
     if (err instanceof CliAuthExpiredError) {
-      console.log("Logged out (token was already invalid).");
+      console.log(warning("Logged out (token was already invalid)."));
       return;
     }
     console.warn(
-      `Could not contact ${config.host} to revoke token. The token will be cleared locally only.`
+      warning(
+        `Could not contact ${config.host} to revoke token. The token will be cleared locally only.`
+      )
     );
   }
   await clearAuthConfig();
-  console.log("Logged out successfully.");
+  console.log(success("Logged out successfully."));
 }
 
 // src/index.ts
@@ -538,6 +568,7 @@ async function validateTheme(root) {
   }
   const module = await loadThemeModule(serverEntryPath);
   validateThemeModule(module);
+  await validateThemeLocales(root);
   const result = {
     root,
     module,
@@ -553,6 +584,73 @@ async function validateTheme(root) {
   }
   return result;
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function collectLocaleKeys(value, pathSegments = [], keys = []) {
+  if (typeof value === "string") {
+    keys.push(pathSegments.join("."));
+    return keys;
+  }
+  if (!isRecord(value)) {
+    throw new Error(
+      `Theme locale value at ${pathSegments.join(".") || "<root>"} must be a string or object.`
+    );
+  }
+  for (const [key, child] of Object.entries(value)) {
+    collectLocaleKeys(child, [...pathSegments, key], keys);
+  }
+  return keys;
+}
+async function readLocaleJson(filePath) {
+  try {
+    return JSON.parse(await readFile(filePath, "utf8"));
+  } catch (error2) {
+    const reason = error2 instanceof Error ? error2.message : "invalid JSON";
+    throw new Error(`Invalid theme locale JSON at ${filePath}: ${reason}`);
+  }
+}
+async function listLocaleFiles(localesDir) {
+  if (!await pathExists(localesDir)) {
+    return [];
+  }
+  const entries = await readdir(localesDir, { withFileTypes: true });
+  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => entry.name).sort((a, b) => a.localeCompare(b));
+}
+async function validateThemeLocales(root) {
+  const localesDir = path2.join(root, "dist", "locales");
+  const files = await listLocaleFiles(localesDir);
+  if (!files.includes("en.json")) {
+    throw new Error("Theme locales must include dist/locales/en.json.");
+  }
+  const referenceFile = "en.json";
+  const referenceMessages = await readLocaleJson(path2.join(localesDir, referenceFile));
+  const reference = {
+    file: referenceFile,
+    keys: new Set(collectLocaleKeys(referenceMessages).sort())
+  };
+  for (const file of files) {
+    if (file === referenceFile) {
+      continue;
+    }
+    const filePath = path2.join(localesDir, file);
+    const messages = await readLocaleJson(filePath);
+    const keys = new Set(collectLocaleKeys(messages).sort());
+    const expected = reference;
+    const missing = [...expected.keys].filter((key) => !keys.has(key));
+    const extra = [...keys].filter((key) => !expected.keys.has(key));
+    if (missing.length > 0 || extra.length > 0) {
+      const details = [
+        ...missing.map((key) => `  - missing ${key}`),
+        ...extra.map((key) => `  - extra ${key}`)
+      ].join("\n");
+      throw new Error(
+        `Theme locale ${file} does not match ${expected.file} key set:
+${details}`
+      );
+    }
+  }
+}
 var VITE_CONFIG_FILES = [
   "vite.config.ts",
   "vite.config.mts",
@@ -651,6 +749,7 @@ async function buildViteTheme(root) {
     }
   });
   await copyThemeAssets(root);
+  await copyThemeLocales(root);
   const stylesheetEntry = path2.join(root, ".suda-build", "styles-entry.ts");
   await mkdir(path2.dirname(stylesheetEntry), { recursive: true });
   await writeFile(stylesheetEntry, 'import "../src/styles.css";\n', "utf8");
@@ -685,11 +784,20 @@ async function copyThemeAssets(root) {
   }
   await copyDirectory(sourceAssets, path2.join(root, "dist", "assets"));
 }
+async function copyThemeLocales(root) {
+  const sourceLocales = path2.join(root, "src", "locales");
+  if (!await pathExists(sourceLocales)) {
+    return;
+  }
+  await copyDirectory(sourceLocales, path2.join(root, "dist", "locales"));
+}
 async function buildClientRuntime(root, minify) {
   const entryPoint = await findClientEntry(root);
   if (!await pathExists(entryPoint)) {
     throw new Error(`Missing client entry: ${entryPoint}`);
   }
+  const packageJson = JSON.parse(await readFile(path2.join(root, "package.json"), "utf8"));
+  const themeVersion = typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
   await mkdir(path2.join(root, "dist"), { recursive: true });
   const hostReactShimPlugin = createHostReactShimPlugin();
   const themeEngineRuntimeAliasPlugin = createThemeEngineRuntimeAliasPlugin(root);
@@ -710,6 +818,9 @@ async function buildClientRuntime(root, minify) {
     minify,
     outfile: path2.join(root, "dist", "runtime.client.js"),
     platform: "browser",
+    define: {
+      __SUDA_THEME_VERSION__: JSON.stringify(themeVersion)
+    },
     plugins: [hostReactShimPlugin, themeEngineRuntimeAliasPlugin, themeDependencyResolverPlugin],
     sourcemap: false,
     target: "es2022",
@@ -862,6 +973,7 @@ var __testUtils = {
   slugifyThemeName,
   validateThemeKey,
   validateThemeName,
+  validateThemeLocales,
   toViteModuleUrl,
   updateRemotePageDraft
 };
@@ -872,20 +984,24 @@ async function runThemeCheck(theme) {
   const ok = result.ok && footerIssues.length === 0 && previewIssues.length === 0;
   const lines = [formatThemeCheckResult(result)];
   if (footerIssues.length === 0 && result.ok) {
-    lines.push("Footer contract check passed: whiteLabel and ICP metadata render correctly.");
+    lines.push(
+      success("Footer contract check passed: whiteLabel and ICP metadata render correctly.")
+    );
   } else if (footerIssues.length > 0) {
     for (const issue of footerIssues) {
-      lines.push(`  error  layoutConfig.footerContract: ${issue}`);
+      lines.push(`  ${error("error")}  layoutConfig.footerContract: ${issue}`);
     }
-    lines.push(`Footer contract check: ${footerIssues.length} error(s).`);
+    lines.push(error(`Footer contract check: ${footerIssues.length} error(s).`));
   }
   if (previewIssues.length === 0) {
-    lines.push("Preview contract check passed: desktop, tablet, and mobile screenshots exist.");
+    lines.push(
+      success("Preview contract check passed: desktop, tablet, and mobile screenshots exist.")
+    );
   } else {
     for (const issue of previewIssues) {
-      lines.push(`  error  assets.preview: ${issue}`);
+      lines.push(`  ${error("error")}  assets.preview: ${issue}`);
     }
-    lines.push(`Preview contract check: ${previewIssues.length} error(s).`);
+    lines.push(error(`Preview contract check: ${previewIssues.length} error(s).`));
   }
   const text = lines.join("\n");
   if (ok) {
@@ -900,8 +1016,8 @@ async function runPreviewContractCheck(theme) {
   for (const relativePath of REQUIRED_PREVIEW_ARTIFACTS) {
     const filePath = path2.join(theme.root, "dist", relativePath);
     try {
-      const info = await stat(filePath);
-      if (info.size <= 0) {
+      const info2 = await stat(filePath);
+      if (info2.size <= 0) {
         issues.push(`${relativePath} is empty. Run \`suda theme capture\` and rebuild.`);
       }
     } catch {
@@ -912,7 +1028,7 @@ async function runPreviewContractCheck(theme) {
 }
 async function watchTheme(root, port) {
   const handle = await startViteDevPreviewServer(root, port);
-  console.log(`previewing Vite theme at ${handle.url}`);
+  console.log(`previewing Vite theme at ${style.url(handle.url)}`);
   await new Promise(() => void 0);
 }
 async function startViteDevPreviewServer(root, port) {
@@ -990,9 +1106,9 @@ function createSudaPreviewVitePlugin(root) {
             );
             response.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
             response.end(html);
-          } catch (error) {
+          } catch (error2) {
             response.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" });
-            response.end(error instanceof Error ? error.stack : String(error));
+            response.end(error2 instanceof Error ? error2.stack : String(error2));
           }
         })();
       });
@@ -1238,7 +1354,7 @@ async function optimizePngIfAvailable(themeRoot, filePath) {
   const sharp = await loadOptionalSharp(themeRoot);
   if (!sharp) {
     if (!warnedMissingSharp) {
-      console.warn(formatMissingSharpWarning());
+      console.warn(warning(formatMissingSharpWarning()));
       warnedMissingSharp = true;
     }
     return;
@@ -1249,7 +1365,7 @@ async function optimizePngIfAvailable(themeRoot, filePath) {
   } catch {
     if (!warnedSharpOptimizeFailure) {
       console.warn(
-        "warning: PNG optimization failed. The screenshot was saved uncompressed."
+        warning("warning: PNG optimization failed. The screenshot was saved uncompressed.")
       );
       warnedSharpOptimizeFailure = true;
     }
@@ -1275,7 +1391,9 @@ async function captureScreenshot(root, options) {
           await context.close();
         }
         await optimizePngIfAvailable(root, target.outputPath);
-        console.log(`captured ${target.device} ${path2.relative(root, target.outputPath)}`);
+        console.log(
+          success(`captured ${target.device} ${style.path(path2.relative(root, target.outputPath))}`)
+        );
       }
     } finally {
       await browser.close();
@@ -1491,8 +1609,8 @@ async function performConfirmedPageOperation(auth, input, fetcher = fetchJson) {
   };
 }
 async function performActivateTheme(auth, input, fetcher = fetchJson) {
-  const themeRef = input.themeVersion ? `${input.themeKey}@${input.themeVersion}` : input.themeKey;
-  const impact = `This will activate theme "${themeRef}" for project "${input.projectId}". Public pages will render with this theme after activation.`;
+  const themeRef2 = input.themeVersion ? `${input.themeKey}@${input.themeVersion}` : input.themeKey;
+  const impact = `This will activate theme "${themeRef2}" for project "${input.projectId}". Public pages will render with this theme after activation.`;
   if (input.confirm !== true) {
     return {
       status: "needs_confirmation",
@@ -2059,7 +2177,9 @@ async function publishTheme(root, skipBuild, force) {
     if (forceRes.ok) {
       const { deletedObjects } = await forceRes.json();
       console.log(
-        `force-cleared ${key}@${version} (${deletedObjects ?? 0} objects removed). Republishing...`
+        warning(
+          `force-cleared ${themeRef(key, version)} (${deletedObjects ?? 0} objects removed). Republishing...`
+        )
       );
     }
   }
@@ -2098,7 +2218,9 @@ async function publishTheme(root, skipBuild, force) {
     if (!putRes.ok) {
       throw new Error(`Failed to upload ${file.relativePath}: ${putRes.statusText}`);
     }
-    console.log(`uploaded ${createThemeObjectKey(key, version, file.relativePath)}`);
+    console.log(
+      success(`uploaded ${style.path(createThemeObjectKey(key, version, file.relativePath))}`)
+    );
   }
   const bundleArtifactRelative = "index.js";
   const previewArtifactRelative = "assets/preview/desktop.png";
@@ -2122,7 +2244,7 @@ async function publishTheme(root, skipBuild, force) {
   if (!completeRes.ok) {
     throw new Error(`Failed to complete publish: ${await formatHttpErrorBody(completeRes)}`);
   }
-  console.log(`published ${key}@${version}`);
+  console.log(success(`published ${themeRef(key, version)}`));
 }
 var cachedCliPackageVersions;
 async function readCliPackageVersions() {
@@ -2222,22 +2344,22 @@ function createThemeInitPrompt(nameProvided) {
 async function promptThemeName(rl) {
   while (true) {
     const answer = (await rl.question("Theme name: ")).trim();
-    const error = validateThemeName(answer);
-    if (error === null) {
+    const error2 = validateThemeName(answer);
+    if (error2 === null) {
       return answer;
     }
-    console.error(error);
+    console.error(error(error2));
   }
 }
 async function promptThemeKey(rl, defaultKey) {
   while (true) {
     const answer = (await rl.question(`Theme key (${defaultKey}): `)).trim();
     const key = answer.length > 0 ? answer : defaultKey;
-    const error = validateThemeKey(key);
-    if (error === null) {
+    const error2 = validateThemeKey(key);
+    if (error2 === null) {
       return key;
     }
-    console.error(error);
+    console.error(error(error2));
   }
 }
 async function resolveThemeInitInput(name) {
@@ -2298,7 +2420,7 @@ async function initThemeWithKey(target, key) {
   for (const relativePath of filesToReplace) {
     await replaceTemplateTokens(path2.join(target, relativePath), replacements);
   }
-  console.log(`created theme scaffold at ${target}`);
+  console.log(success(`created theme scaffold at ${style.path(target)}`));
 }
 function buildProgram() {
   const program = new Command();
@@ -2310,16 +2432,22 @@ function buildProgram() {
   });
   theme.command("validate").description("Validate a built theme artifact.").option("--theme-root <path>", "Theme source/artifact root.").action(async (options) => {
     const result = await validateTheme(resolveThemeRoot(options));
-    console.log(`valid ${result.module.manifest.key}@${result.module.manifest.version}`);
+    console.log(
+      success(`valid ${themeRef(result.module.manifest.key, result.module.manifest.version)}`)
+    );
     if (!result.clientEntryPath) {
       console.warn(
-        "warning: runtime.client.js is missing; editor runtime will not load until `suda theme build` runs."
+        warning(
+          "warning: runtime.client.js is missing; editor runtime will not load until `suda theme build` runs."
+        )
       );
     }
   });
   theme.command("build").description("Build a Vite Suda theme artifact.").option("--theme-root <path>", "Theme source/artifact root.").action(async (options) => {
     const result = await buildTheme(resolveThemeRoot(options));
-    console.log(`built ${result.module.manifest.key}@${result.module.manifest.version}`);
+    console.log(
+      success(`built ${themeRef(result.module.manifest.key, result.module.manifest.version)}`)
+    );
     const ok = await runThemeCheck(result);
     if (!ok) {
       throw new Error("AI metadata check failed. Fix the errors above.");
@@ -2327,7 +2455,11 @@ function buildProgram() {
   });
   theme.command("finalize").description("Finalize an existing Vite build into the Suda theme artifact contract.").option("--theme-root <path>", "Theme source/artifact root.").action(async (options) => {
     const result = await finalizeTheme(resolveThemeRoot(options));
-    console.log(`finalized ${result.module.manifest.key}@${result.module.manifest.version}`);
+    console.log(
+      success(
+        `finalized ${themeRef(result.module.manifest.key, result.module.manifest.version)}`
+      )
+    );
   });
   theme.command("check").description(
     "Run AI metadata checks on a built theme without rebuilding. Reports missing component-level ai.instructions as errors and weak content as warnings."