feat(i18n): 21-language pipeline, landing/docs/API wiring, landing+API translations

Shared Claude Code translation pipeline (scripts/i18n, no API key) plus Astro/VitePress/Scalar i18n wiring. Landing and API reference translated into all 20 languages; docs i18n wiring + English source anchors. The translated docs markdown (apps/docs/<locale>/**, 3,620 files) follows in a companion PR because it exceeds GitHub's per-PR CI file limit.
2026-08-03 07:46:42 +02:00 · 2026-07-11 13:01:55 +08:00
parent 2e91368816
commit 00b651c9f8
353 changed files with 564607 additions and 2594 deletions
@@ -0,0 +1,75 @@
+// scripts/i18n/adapters/landing-ui.mjs
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_DIR = join(__dirname, "../../../apps/landing/src/i18n");
+
+async function readJson(path) {
+  try {
+    return JSON.parse(await readFile(path, "utf8"));
+  } catch (err) {
+    if (err && err.code === "ENOENT") return null;
+    throw err;
+  }
+}
+
+/**
+ * Build the landing UI catalog adapter.
+ * Runtime catalog: `<locale>.json` (flat { key: text }).
+ * Sidecar metadata: `<locale>.meta.json` ({ key: { sourceHash, provenance, outputHash, stale } }).
+ * @param {{ dir?: string }} [opts]
+ */
+export function makeLandingUiAdapter({ dir = DEFAULT_DIR } = {}) {
+  const enPath = join(dir, "en.json");
+  return {
+    name: "landing-ui",
+
+    async extract() {
+      const en = (await readJson(enPath)) ?? {};
+      return Object.entries(en).map(([id, sourceText]) => ({
+        id,
+        sourceText: String(sourceText),
+        kind: "text",
+      }));
+    },
+
+    async load(locale) {
+      const catalog = (await readJson(join(dir, `${locale}.json`))) ?? {};
+      const meta = (await readJson(join(dir, `${locale}.meta.json`))) ?? {};
+      const out = new Map();
+      for (const [id, text] of Object.entries(catalog)) {
+        const m = meta[id] ?? {};
+        out.set(id, {
+          text: String(text),
+          sourceHash: m.sourceHash ?? "",
+          provenance: m.provenance ?? "machine",
+          outputHash: m.outputHash ?? "",
+          stale: Boolean(m.stale),
+        });
+      }
+      return out;
+    },
+
+    async write(locale, entries) {
+      const catalog = {};
+      const meta = {};
+      // Stable key order for reviewable diffs.
+      for (const id of [...entries.keys()].sort()) {
+        const e = entries.get(id);
+        catalog[id] = e.text;
+        meta[id] = {
+          sourceHash: e.sourceHash,
+          provenance: e.provenance,
+          outputHash: e.outputHash,
+          stale: Boolean(e.stale),
+        };
+      }
+      await writeFile(join(dir, `${locale}.json`), `${JSON.stringify(catalog, null, 2)}\n`);
+      await writeFile(join(dir, `${locale}.meta.json`), `${JSON.stringify(meta, null, 2)}\n`);
+    },
+  };
+}
+
+export const adapter = makeLandingUiAdapter();