solid-translate 1.4.2 → 1.4.3

package/dist/chunk-P6RTZPHZ.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+
+// src/translate.ts
+import { z } from "zod";
+async function loadGenerateObject() {
+  const { generateObject } = await import("ai");
+  return generateObject;
+}
+async function loadGenerateText() {
+  const { generateText } = await import("ai");
+  return generateText;
+}
+function extractJsonObject(text) {
+  const start = text.indexOf("{");
+  const end = text.lastIndexOf("}");
+  if (start === -1 || end <= start) {
+    throw new Error("model response contained no JSON object");
+  }
+  const parsed = JSON.parse(text.slice(start, end + 1));
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error("model response was not a JSON object");
+  }
+  return parsed;
+}
+function collectBatchTranslations(parsed, requestedKeys) {
+  let dict = parsed;
+  const inner = parsed["translations"];
+  if (typeof inner === "object" && inner !== null && !Array.isArray(inner) && // Only unwrap when the envelope key is not itself a requested key
+  !requestedKeys.includes("translations")) {
+    dict = inner;
+  }
+  const translations = {};
+  const missing = [];
+  for (const key of requestedKeys) {
+    const value = dict[key];
+    if (typeof value === "string" && value.length > 0) {
+      translations[key] = value;
+    } else {
+      missing.push(key);
+    }
+  }
+  return { translations, missing };
+}
+async function translateBatch(model, entries, targetLocale, sourceLocale, systemPrompt, contexts) {
+  const keys = Object.keys(entries);
+  if (keys.length === 0) return {};
+  const defaultSystem = [
+    `You are a professional translator specializing in software localization.`,
+    `Translate text from "${sourceLocale}" to "${targetLocale}".`,
+    `Rules:`,
+    `- Preserve the original tone and meaning`,
+    `- Keep placeholders like {{variable}}, {variable}, {0}, {1} unchanged`,
+    `- Keep HTML tags unchanged`,
+    `- Do not add or remove content`,
+    `- Return natural, idiomatic translations`
+  ].join("\n");
+  let contextSection = "";
+  if (contexts && Object.keys(contexts).length > 0) {
+    const contextLines = Object.entries(contexts).filter(([key]) => key in entries).map(([key, ctx]) => `  "${key}": ${ctx}`);
+    if (contextLines.length > 0) {
+      contextSection = [
+        ``,
+        `Context hints for disambiguation:`,
+        ...contextLines,
+        ``
+      ].join("\n");
+    }
+  }
+  const generateText = await loadGenerateText();
+  const basePrompt = [
+    `Translate each value in this JSON object from "${sourceLocale}" to "${targetLocale}".`,
+    `Respond with ONLY a JSON object \u2014 no prose, no code fences \u2014 containing the exact same keys and the translated values.`,
+    contextSection,
+    JSON.stringify(entries, null, 2)
+  ].join("\n");
+  const attempt = async (prompt) => {
+    const { text } = await generateText({
+      model,
+      system: systemPrompt || defaultSystem,
+      prompt
+    });
+    return collectBatchTranslations(extractJsonObject(text), keys);
+  };
+  let { translations, missing } = await attempt(basePrompt);
+  if (missing.length > 0) {
+    const retryEntries = {};
+    for (const key of missing) retryEntries[key] = entries[key];
+    const retry = await attempt(
+      [
+        `Translate each value in this JSON object from "${sourceLocale}" to "${targetLocale}".`,
+        `Respond with ONLY a JSON object \u2014 no prose, no code fences \u2014 containing the exact same keys and the translated values.`,
+        contextSection,
+        JSON.stringify(retryEntries, null, 2)
+      ].join("\n")
+    );
+    translations = { ...translations, ...retry.translations };
+    missing = retry.missing;
+  }
+  if (missing.length > 0) {
+    const sample = missing.slice(0, 3).join('", "');
+    throw new Error(
+      `model returned no translation for ${missing.length} of ${keys.length} keys (e.g. "${sample}")`
+    );
+  }
+  return translations;
+}
+async function translateMarkdown(model, content, targetLocale, sourceLocale, systemPrompt) {
+  const defaultSystem = [
+    `You are a professional translator specializing in documentation.`,
+    `Translate Markdown/MDX content from "${sourceLocale}" to "${targetLocale}".`,
+    `Rules:`,
+    `- Preserve all Markdown formatting (headers, lists, bold, italic, links, etc.)`,
+    `- Preserve code blocks and inline code unchanged`,
+    `- Preserve frontmatter YAML keys (only translate values)`,
+    `- Preserve MDX component syntax and JSX expressions`,
+    `- Preserve URLs and file paths unchanged`,
+    `- Return natural, idiomatic translations`
+  ].join("\n");
+  const generateObject = await loadGenerateObject();
+  const { object } = await generateObject({
+    model,
+    schema: z.object({
+      translated: z.string()
+    }),
+    system: systemPrompt || defaultSystem,
+    prompt: [
+      `Translate this Markdown/MDX content from "${sourceLocale}" to "${targetLocale}".`,
+      `Return the complete translated document.`,
+      ``,
+      content
+    ].join("\n")
+  });
+  return object.translated;
+}
+
+export {
+  extractJsonObject,
+  collectBatchTranslations,
+  translateBatch,
+  translateMarkdown
+};

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   translateBatch
-} from "./chunk-2BKJUY37.js";
+} from "./chunk-P6RTZPHZ.js";
 import {
   __commonJS,
   __toESM
@@ -15106,7 +15106,16 @@ async function syncLocaleFiles(options) {
     delete lock.keys[key];
   }
   const changedCount = Object.keys(changedKeys).length;
-  if (changedCount === 0 && deletedKeys.length === 0) {
+  const missingByLocale = {};
+  for (const targetLocale of targetLocales) {
+    const existing = readTargetFile(join(localesDir, `${targetLocale}.json`));
+    const missing = Object.keys(sourceDict).filter(
+      (key) => !(key in changedKeys) && !(key in existing)
+    );
+    if (missing.length > 0) missingByLocale[targetLocale] = missing;
+  }
+  const missingLocaleCount = Object.keys(missingByLocale).length;
+  if (changedCount === 0 && deletedKeys.length === 0 && missingLocaleCount === 0) {
     log("No changes detected in locale files.");
     return {
       status: "no-changes",
@@ -15115,7 +15124,7 @@ async function syncLocaleFiles(options) {
       failures: []
     };
   }
-  if (changedCount === 0) {
+  if (changedCount === 0 && missingLocaleCount === 0) {
     for (const targetLocale of targetLocales) {
       const targetFilePath = join(localesDir, `${targetLocale}.json`);
       const existing = readTargetFile(targetFilePath);
@@ -15128,27 +15137,43 @@ async function syncLocaleFiles(options) {
     );
     return { status: "synced", translatedKeys: [], deletedKeys, failures: [] };
   }
-  log(
-    `Translating ${changedCount} key${changedCount > 1 ? "s" : ""} to ${targetLocales.length} locale${targetLocales.length > 1 ? "s" : ""}...`
-  );
-  const changedContexts = {};
-  for (const key of Object.keys(changedKeys)) {
-    const ctx = pendingEntries[key]?.context;
-    if (ctx) changedContexts[key] = ctx;
+  if (changedCount > 0) {
+    log(
+      `Translating ${changedCount} key${changedCount > 1 ? "s" : ""} to ${targetLocales.length} locale${targetLocales.length > 1 ? "s" : ""}...`
+    );
   }
+  if (missingLocaleCount > 0) {
+    const healTotal = Object.values(missingByLocale).reduce(
+      (sum, keys) => sum + keys.length,
+      0
+    );
+    log(
+      `Healing ${healTotal} key${healTotal > 1 ? "s" : ""} missing from ${missingLocaleCount} locale file${missingLocaleCount > 1 ? "s" : ""}...`
+    );
+  }
+  const contextFor = (key) => pendingEntries[key]?.context ?? lock.keys[key]?.context;
   const failures = [];
   const failedKeys = /* @__PURE__ */ new Set();
   for (const targetLocale of targetLocales) {
     const targetFilePath = join(localesDir, `${targetLocale}.json`);
     const existing = readTargetFile(targetFilePath);
-    const entries = Object.entries(changedKeys);
+    const localeEntries = { ...changedKeys };
+    for (const key of missingByLocale[targetLocale] ?? []) {
+      localeEntries[key] = sourceDict[key];
+    }
+    const localeContexts = {};
+    for (const key of Object.keys(localeEntries)) {
+      const ctx = contextFor(key);
+      if (ctx) localeContexts[key] = ctx;
+    }
+    const entries = Object.entries(localeEntries);
     for (let i = 0; i < entries.length; i += batchSize) {
       const batch = Object.fromEntries(entries.slice(i, i + batchSize));
       try {
         const translated = await translate(
           batch,
           targetLocale,
-          changedContexts
+          localeContexts
         );
         Object.assign(existing, translated);
       } catch (err) {
@@ -15545,7 +15570,7 @@ Run \`solid-translate translate\` to refresh ${sourceLocale} \u2192 targets.`
   );
 }
 async function runTranslate() {
-  const { translateBatch: translateBatch2, translateMarkdown: translateMarkdown2 } = await import("./translate-M737VQHG.js");
+  const { translateBatch: translateBatch2, translateMarkdown: translateMarkdown2 } = await import("./translate-SWLCBQ5Y.js");
   const config = await loadConfig();
   const root = process.cwd();
   const sourceLocale = config.sourceLocale || "en";

package/dist/{translate-M737VQHG.js → translate-SWLCBQ5Y.js}

@@ -1,10 +1,14 @@
 #!/usr/bin/env node
 import {
+  collectBatchTranslations,
+  extractJsonObject,
   translateBatch,
   translateMarkdown
-} from "./chunk-2BKJUY37.js";
+} from "./chunk-P6RTZPHZ.js";
 import "./chunk-FYS2JH42.js";
 export {
+  collectBatchTranslations,
+  extractJsonObject,
   translateBatch,
   translateMarkdown
 };

package/dist/vite.js

@@ -14617,9 +14617,40 @@ function hashContent(content) {
 
 // src/translate.ts
 import { z } from "zod";
-async function loadGenerateObject() {
-  const { generateObject } = await import("ai");
-  return generateObject;
+async function loadGenerateText() {
+  const { generateText } = await import("ai");
+  return generateText;
+}
+function extractJsonObject(text) {
+  const start = text.indexOf("{");
+  const end = text.lastIndexOf("}");
+  if (start === -1 || end <= start) {
+    throw new Error("model response contained no JSON object");
+  }
+  const parsed = JSON.parse(text.slice(start, end + 1));
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error("model response was not a JSON object");
+  }
+  return parsed;
+}
+function collectBatchTranslations(parsed, requestedKeys) {
+  let dict = parsed;
+  const inner = parsed["translations"];
+  if (typeof inner === "object" && inner !== null && !Array.isArray(inner) && // Only unwrap when the envelope key is not itself a requested key
+  !requestedKeys.includes("translations")) {
+    dict = inner;
+  }
+  const translations = {};
+  const missing = [];
+  for (const key of requestedKeys) {
+    const value = dict[key];
+    if (typeof value === "string" && value.length > 0) {
+      translations[key] = value;
+    } else {
+      missing.push(key);
+    }
+  }
+  return { translations, missing };
 }
 async function translateBatch(model, entries, targetLocale, sourceLocale, systemPrompt, contexts) {
   const keys = Object.keys(entries);
@@ -14646,21 +14677,43 @@ async function translateBatch(model, entries, targetLocale, sourceLocale, system
       ].join("\n");
     }
   }
-  const generateObject = await loadGenerateObject();
-  const { object } = await generateObject({
-    model,
-    schema: z.object({
-      translations: z.record(z.string(), z.string())
-    }),
-    system: systemPrompt || defaultSystem,
-    prompt: [
-      `Translate each value in this JSON object from "${sourceLocale}" to "${targetLocale}".`,
-      `Return a JSON object with the exact same keys and the translated values.`,
-      contextSection,
-      JSON.stringify(entries, null, 2)
-    ].join("\n")
-  });
-  return object.translations;
+  const generateText = await loadGenerateText();
+  const basePrompt = [
+    `Translate each value in this JSON object from "${sourceLocale}" to "${targetLocale}".`,
+    `Respond with ONLY a JSON object \u2014 no prose, no code fences \u2014 containing the exact same keys and the translated values.`,
+    contextSection,
+    JSON.stringify(entries, null, 2)
+  ].join("\n");
+  const attempt = async (prompt) => {
+    const { text } = await generateText({
+      model,
+      system: systemPrompt || defaultSystem,
+      prompt
+    });
+    return collectBatchTranslations(extractJsonObject(text), keys);
+  };
+  let { translations, missing } = await attempt(basePrompt);
+  if (missing.length > 0) {
+    const retryEntries = {};
+    for (const key of missing) retryEntries[key] = entries[key];
+    const retry = await attempt(
+      [
+        `Translate each value in this JSON object from "${sourceLocale}" to "${targetLocale}".`,
+        `Respond with ONLY a JSON object \u2014 no prose, no code fences \u2014 containing the exact same keys and the translated values.`,
+        contextSection,
+        JSON.stringify(retryEntries, null, 2)
+      ].join("\n")
+    );
+    translations = { ...translations, ...retry.translations };
+    missing = retry.missing;
+  }
+  if (missing.length > 0) {
+    const sample = missing.slice(0, 3).join('", "');
+    throw new Error(
+      `model returned no translation for ${missing.length} of ${keys.length} keys (e.g. "${sample}")`
+    );
+  }
+  return translations;
 }
 
 // src/extract.ts
@@ -15172,7 +15225,16 @@ async function syncLocaleFiles(options) {
     delete lock.keys[key];
   }
   const changedCount = Object.keys(changedKeys).length;
-  if (changedCount === 0 && deletedKeys.length === 0) {
+  const missingByLocale = {};
+  for (const targetLocale of targetLocales) {
+    const existing = readTargetFile(join(localesDir, `${targetLocale}.json`));
+    const missing = Object.keys(sourceDict).filter(
+      (key) => !(key in changedKeys) && !(key in existing)
+    );
+    if (missing.length > 0) missingByLocale[targetLocale] = missing;
+  }
+  const missingLocaleCount = Object.keys(missingByLocale).length;
+  if (changedCount === 0 && deletedKeys.length === 0 && missingLocaleCount === 0) {
     log("No changes detected in locale files.");
     return {
       status: "no-changes",
@@ -15181,7 +15243,7 @@ async function syncLocaleFiles(options) {
       failures: []
     };
   }
-  if (changedCount === 0) {
+  if (changedCount === 0 && missingLocaleCount === 0) {
     for (const targetLocale of targetLocales) {
       const targetFilePath = join(localesDir, `${targetLocale}.json`);
       const existing = readTargetFile(targetFilePath);
@@ -15194,27 +15256,43 @@ async function syncLocaleFiles(options) {
     );
     return { status: "synced", translatedKeys: [], deletedKeys, failures: [] };
   }
-  log(
-    `Translating ${changedCount} key${changedCount > 1 ? "s" : ""} to ${targetLocales.length} locale${targetLocales.length > 1 ? "s" : ""}...`
-  );
-  const changedContexts = {};
-  for (const key of Object.keys(changedKeys)) {
-    const ctx = pendingEntries[key]?.context;
-    if (ctx) changedContexts[key] = ctx;
+  if (changedCount > 0) {
+    log(
+      `Translating ${changedCount} key${changedCount > 1 ? "s" : ""} to ${targetLocales.length} locale${targetLocales.length > 1 ? "s" : ""}...`
+    );
   }
+  if (missingLocaleCount > 0) {
+    const healTotal = Object.values(missingByLocale).reduce(
+      (sum, keys) => sum + keys.length,
+      0
+    );
+    log(
+      `Healing ${healTotal} key${healTotal > 1 ? "s" : ""} missing from ${missingLocaleCount} locale file${missingLocaleCount > 1 ? "s" : ""}...`
+    );
+  }
+  const contextFor = (key) => pendingEntries[key]?.context ?? lock.keys[key]?.context;
   const failures = [];
   const failedKeys = /* @__PURE__ */ new Set();
   for (const targetLocale of targetLocales) {
     const targetFilePath = join(localesDir, `${targetLocale}.json`);
     const existing = readTargetFile(targetFilePath);
-    const entries = Object.entries(changedKeys);
+    const localeEntries = { ...changedKeys };
+    for (const key of missingByLocale[targetLocale] ?? []) {
+      localeEntries[key] = sourceDict[key];
+    }
+    const localeContexts = {};
+    for (const key of Object.keys(localeEntries)) {
+      const ctx = contextFor(key);
+      if (ctx) localeContexts[key] = ctx;
+    }
+    const entries = Object.entries(localeEntries);
     for (let i = 0; i < entries.length; i += batchSize) {
       const batch = Object.fromEntries(entries.slice(i, i + batchSize));
       try {
         const translated = await translate(
           batch,
           targetLocale,
-          changedContexts
+          localeContexts
         );
         Object.assign(existing, translated);
       } catch (err) {