solid-translate 0.2.0

package/dist/vite.js

@@ -0,0 +1,339 @@
+// src/vite.ts
+import {
+  readFileSync,
+  writeFileSync,
+  existsSync,
+  mkdirSync,
+  readdirSync
+} from "fs";
+import { resolve, join, relative } from "path";
+
+// src/hash.ts
+import { createHash } from "crypto";
+function hashContent(content) {
+  return createHash("sha256").update(content).digest("hex").slice(0, 16);
+}
+
+// src/translate.ts
+import { generateObject } from "ai";
+import { z } from "zod";
+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 { 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;
+}
+
+// src/extract.ts
+function extractStringsFromSource(code, filePath) {
+  const results = [];
+  const seen = /* @__PURE__ */ new Set();
+  const tComponentRegex = /<T(\s[^>]*)?>([^]*?)<\/T>/g;
+  let match;
+  while ((match = tComponentRegex.exec(code)) !== null) {
+    const attrs = match[1] || "";
+    const rawChildren = match[2];
+    const line = code.substring(0, match.index).split("\n").length;
+    const idMatch = attrs.match(/id=["']([^"']+)["']/);
+    const contextMatch = attrs.match(/context=["']([^"']+)["']/);
+    let slotIndex = 0;
+    const source = rawChildren.replace(
+      /<(?:Var|Num|Currency|DateTime)(?:\s[^>]*)?>([^]*?)<\/(?:Var|Num|Currency|DateTime)>/g,
+      () => `{${slotIndex++}}`
+    ).trim();
+    const key = idMatch ? idMatch[1] : source;
+    if (!key || seen.has(key)) continue;
+    seen.add(key);
+    results.push({
+      key,
+      source,
+      file: filePath,
+      line,
+      context: contextMatch ? contextMatch[1] : void 0
+    });
+  }
+  const msgRegex = /\bmsg\(\s*["']([^"']+)["']\s*(?:,\s*\{[^}]*\})?\s*\)/g;
+  while ((match = msgRegex.exec(code)) !== null) {
+    const source = match[1];
+    if (seen.has(source)) continue;
+    seen.add(source);
+    const line = code.substring(0, match.index).split("\n").length;
+    results.push({ key: source, source, file: filePath, line });
+  }
+  return results;
+}
+
+// src/vite.ts
+var VIRTUAL_MODULE_ID = "virtual:solid-translate";
+var RESOLVED_VIRTUAL_MODULE_ID = "\0" + VIRTUAL_MODULE_ID;
+function solidTranslate(config) {
+  const {
+    sourceLocale = "en",
+    targetLocales,
+    localesDir = "./src/locales",
+    model,
+    systemPrompt,
+    batchSize = 50,
+    autoExtract = false,
+    include = ["src/**/*.tsx", "src/**/*.ts", "src/**/*.jsx"]
+  } = config;
+  let root;
+  let resolvedLocalesDir;
+  let lockFilePath;
+  return {
+    name: "solid-translate",
+    configResolved(resolvedConfig) {
+      root = resolvedConfig.root;
+      resolvedLocalesDir = resolve(root, localesDir);
+      lockFilePath = join(resolvedLocalesDir, ".solid-translate.lock");
+    },
+    async buildStart() {
+      if (!existsSync(resolvedLocalesDir)) {
+        mkdirSync(resolvedLocalesDir, { recursive: true });
+      }
+      const sourceFilePath = join(
+        resolvedLocalesDir,
+        `${sourceLocale}.json`
+      );
+      let contexts = {};
+      if (autoExtract) {
+        const extracted = await autoExtractStrings(root, include);
+        contexts = extracted.contexts;
+        let existingSource = {};
+        if (existsSync(sourceFilePath)) {
+          try {
+            existingSource = JSON.parse(
+              readFileSync(sourceFilePath, "utf-8")
+            );
+          } catch {
+          }
+        }
+        let changed = false;
+        for (const [key, value] of Object.entries(extracted.strings)) {
+          if (!(key in existingSource)) {
+            existingSource[key] = value;
+            changed = true;
+          }
+        }
+        if (changed) {
+          const sorted = Object.fromEntries(
+            Object.entries(existingSource).sort(
+              ([a], [b]) => a.localeCompare(b)
+            )
+          );
+          writeFileSync(
+            sourceFilePath,
+            JSON.stringify(sorted, null, 2) + "\n"
+          );
+          console.log(
+            `[solid-translate] Auto-extracted ${Object.keys(extracted.strings).length} strings from source`
+          );
+        }
+      }
+      if (!existsSync(sourceFilePath)) {
+        console.warn(
+          `[solid-translate] Source locale file not found: ${relative(root, sourceFilePath)}`
+        );
+        console.warn(
+          `[solid-translate] Create it with your source strings, or enable autoExtract`
+        );
+        return;
+      }
+      const sourceDict = JSON.parse(
+        readFileSync(sourceFilePath, "utf-8")
+      );
+      let lock = { version: 1, sourceLocale, keys: {} };
+      if (existsSync(lockFilePath)) {
+        try {
+          lock = JSON.parse(readFileSync(lockFilePath, "utf-8"));
+        } catch {
+        }
+      }
+      const changedKeys = {};
+      for (const [key, value] of Object.entries(sourceDict)) {
+        const hash = hashContent(value);
+        const existing = lock.keys[key];
+        const existingContext = existing?.context;
+        const newContext = contexts[key];
+        if (!existing || existing.hash !== hash || existingContext !== newContext) {
+          changedKeys[key] = value;
+          lock.keys[key] = { hash, source: value, context: newContext };
+        }
+      }
+      for (const key of Object.keys(lock.keys)) {
+        if (!(key in sourceDict)) {
+          delete lock.keys[key];
+        }
+      }
+      if (Object.keys(changedKeys).length === 0) {
+        console.log(
+          "[solid-translate] No changes detected, skipping translation."
+        );
+        return;
+      }
+      const count = Object.keys(changedKeys).length;
+      console.log(
+        `[solid-translate] Translating ${count} key${count > 1 ? "s" : ""} to ${targetLocales.length} locale${targetLocales.length > 1 ? "s" : ""}...`
+      );
+      const changedContexts = {};
+      for (const key of Object.keys(changedKeys)) {
+        const ctx = lock.keys[key]?.context;
+        if (ctx) changedContexts[key] = ctx;
+      }
+      for (const targetLocale of targetLocales) {
+        const targetFilePath = join(
+          resolvedLocalesDir,
+          `${targetLocale}.json`
+        );
+        let existing = {};
+        if (existsSync(targetFilePath)) {
+          try {
+            existing = JSON.parse(readFileSync(targetFilePath, "utf-8"));
+          } catch {
+          }
+        }
+        const entries = Object.entries(changedKeys);
+        for (let i = 0; i < entries.length; i += batchSize) {
+          const batch = Object.fromEntries(
+            entries.slice(i, i + batchSize)
+          );
+          try {
+            const translated = await translateBatch(
+              model,
+              batch,
+              targetLocale,
+              sourceLocale,
+              systemPrompt,
+              changedContexts
+            );
+            Object.assign(existing, translated);
+          } catch (err) {
+            console.error(
+              `[solid-translate] Failed to translate batch for ${targetLocale}:`,
+              err
+            );
+          }
+        }
+        for (const key of Object.keys(existing)) {
+          if (!(key in sourceDict)) {
+            delete existing[key];
+          }
+        }
+        const sorted = Object.fromEntries(
+          Object.entries(existing).sort(([a], [b]) => a.localeCompare(b))
+        );
+        writeFileSync(
+          targetFilePath,
+          JSON.stringify(sorted, null, 2) + "\n"
+        );
+        console.log(
+          `[solid-translate] ${targetLocale}: ${Object.keys(sorted).length} keys`
+        );
+      }
+      writeFileSync(lockFilePath, JSON.stringify(lock, null, 2) + "\n");
+      console.log("[solid-translate] Translation complete.");
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_MODULE_ID) {
+        return RESOLVED_VIRTUAL_MODULE_ID;
+      }
+    },
+    load(id) {
+      if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+        const translations = {};
+        if (existsSync(resolvedLocalesDir)) {
+          for (const file of readdirSync(resolvedLocalesDir)) {
+            if (!file.endsWith(".json")) continue;
+            if (file.startsWith(".")) continue;
+            const locale = file.replace(".json", "");
+            const filePath = join(resolvedLocalesDir, file);
+            try {
+              translations[locale] = JSON.parse(
+                readFileSync(filePath, "utf-8")
+              );
+            } catch {
+            }
+          }
+        }
+        return `export default ${JSON.stringify(translations)};`;
+      }
+    },
+    // HMR: reload translations when locale files change
+    handleHotUpdate({ file, server }) {
+      if (file.startsWith(resolvedLocalesDir) && file.endsWith(".json")) {
+        const mod = server.moduleGraph.getModuleById(
+          RESOLVED_VIRTUAL_MODULE_ID
+        );
+        if (mod) {
+          server.moduleGraph.invalidateModule(mod);
+          return [mod];
+        }
+      }
+    }
+  };
+}
+var vite_default = solidTranslate;
+async function autoExtractStrings(root, patterns) {
+  const strings = {};
+  const contexts = {};
+  const { glob } = await import("glob");
+  for (const pattern of patterns) {
+    const files = await glob(pattern, { cwd: root, absolute: true });
+    for (const file of files) {
+      try {
+        const code = readFileSync(file, "utf-8");
+        const extracted = extractStringsFromSource(
+          code,
+          relative(root, file)
+        );
+        for (const entry of extracted) {
+          strings[entry.key] = entry.source;
+          if (entry.context) {
+            contexts[entry.key] = entry.context;
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  return { strings, contexts };
+}
+export {
+  vite_default as default,
+  solidTranslate
+};
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts","../src/hash.ts","../src/translate.ts","../src/extract.ts"],"sourcesContent":["import type { Plugin, ResolvedConfig } from \"vite\";\nimport {\n  readFileSync,\n  writeFileSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n} from \"node:fs\";\nimport { resolve, join, relative } from \"node:path\";\nimport { hashContent } from \"./hash.js\";\nimport { translateBatch } from \"./translate.js\";\nimport { extractStringsFromSource } from \"./extract.js\";\nimport type { SolidTranslatePluginConfig, LockFile } from \"./types.js\";\n\nexport type { SolidTranslatePluginConfig };\n\nconst VIRTUAL_MODULE_ID = \"virtual:solid-translate\";\nconst RESOLVED_VIRTUAL_MODULE_ID = \"\\0\" + VIRTUAL_MODULE_ID;\n\n/**\n * Vite plugin for solid-translate.\n *\n * Handles:\n * 1. Optional extraction of <T>, msg() strings from source files\n * 2. AI translation of source locale to target locales (with context support)\n * 3. Lock file management for efficient re-translation\n * 4. Virtual module serving translations at runtime\n */\nexport function solidTranslate(config: SolidTranslatePluginConfig): Plugin {\n  const {\n    sourceLocale = \"en\",\n    targetLocales,\n    localesDir = \"./src/locales\",\n    model,\n    systemPrompt,\n    batchSize = 50,\n    autoExtract = false,\n    include = [\"src/**/*.tsx\", \"src/**/*.ts\", \"src/**/*.jsx\"],\n  } = config;\n\n  let root: string;\n  let resolvedLocalesDir: string;\n  let lockFilePath: string;\n\n  return {\n    name: \"solid-translate\",\n\n    configResolved(resolvedConfig: ResolvedConfig) {\n      root = resolvedConfig.root;\n      resolvedLocalesDir = resolve(root, localesDir);\n      lockFilePath = join(resolvedLocalesDir, \".solid-translate.lock\");\n    },\n\n    async buildStart() {\n      // Ensure locales directory exists\n      if (!existsSync(resolvedLocalesDir)) {\n        mkdirSync(resolvedLocalesDir, { recursive: true });\n      }\n\n      const sourceFilePath = join(\n        resolvedLocalesDir,\n        `${sourceLocale}.json`,\n      );\n\n      // Auto-extraction: scan source files for <T> and msg() strings\n      let contexts: Record<string, string> = {};\n      if (autoExtract) {\n        const extracted = await autoExtractStrings(root, include);\n        contexts = extracted.contexts;\n\n        // Merge into source locale file\n        let existingSource: Record<string, string> = {};\n        if (existsSync(sourceFilePath)) {\n          try {\n            existingSource = JSON.parse(\n              readFileSync(sourceFilePath, \"utf-8\"),\n            );\n          } catch {\n            // start fresh\n          }\n        }\n\n        let changed = false;\n        for (const [key, value] of Object.entries(extracted.strings)) {\n          if (!(key in existingSource)) {\n            existingSource[key] = value;\n            changed = true;\n          }\n        }\n\n        if (changed) {\n          const sorted = Object.fromEntries(\n            Object.entries(existingSource).sort(([a], [b]) =>\n              a.localeCompare(b),\n            ),\n          );\n          writeFileSync(\n            sourceFilePath,\n            JSON.stringify(sorted, null, 2) + \"\\n\",\n          );\n          console.log(\n            `[solid-translate] Auto-extracted ${Object.keys(extracted.strings).length} strings from source`,\n          );\n        }\n      }\n\n      // Read source locale file\n      if (!existsSync(sourceFilePath)) {\n        console.warn(\n          `[solid-translate] Source locale file not found: ${relative(root, sourceFilePath)}`,\n        );\n        console.warn(\n          `[solid-translate] Create it with your source strings, or enable autoExtract`,\n        );\n        return;\n      }\n\n      const sourceDict: Record<string, string> = JSON.parse(\n        readFileSync(sourceFilePath, \"utf-8\"),\n      );\n\n      // Read or initialize lock file\n      let lock: LockFile = { version: 1, sourceLocale, keys: {} };\n      if (existsSync(lockFilePath)) {\n        try {\n          lock = JSON.parse(readFileSync(lockFilePath, \"utf-8\"));\n        } catch {\n          // Corrupted lock file — start fresh\n        }\n      }\n\n      // Determine which keys have changed or are new\n      const changedKeys: Record<string, string> = {};\n      for (const [key, value] of Object.entries(sourceDict)) {\n        const hash = hashContent(value);\n        const existing = lock.keys[key];\n        const existingContext = existing?.context;\n        const newContext = contexts[key];\n\n        // Re-translate if content changed OR context changed\n        if (\n          !existing ||\n          existing.hash !== hash ||\n          existingContext !== newContext\n        ) {\n          changedKeys[key] = value;\n          lock.keys[key] = { hash, source: value, context: newContext };\n        }\n      }\n\n      // Remove keys that no longer exist in source\n      for (const key of Object.keys(lock.keys)) {\n        if (!(key in sourceDict)) {\n          delete lock.keys[key];\n        }\n      }\n\n      if (Object.keys(changedKeys).length === 0) {\n        console.log(\n          \"[solid-translate] No changes detected, skipping translation.\",\n        );\n        return;\n      }\n\n      const count = Object.keys(changedKeys).length;\n      console.log(\n        `[solid-translate] Translating ${count} key${count > 1 ? \"s\" : \"\"} to ${targetLocales.length} locale${targetLocales.length > 1 ? \"s\" : \"\"}...`,\n      );\n\n      // Build context map for changed keys\n      const changedContexts: Record<string, string> = {};\n      for (const key of Object.keys(changedKeys)) {\n        const ctx = lock.keys[key]?.context;\n        if (ctx) changedContexts[key] = ctx;\n      }\n\n      // Translate for each target locale\n      for (const targetLocale of targetLocales) {\n        const targetFilePath = join(\n          resolvedLocalesDir,\n          `${targetLocale}.json`,\n        );\n\n        // Load existing translations to preserve unchanged keys\n        let existing: Record<string, string> = {};\n        if (existsSync(targetFilePath)) {\n          try {\n            existing = JSON.parse(readFileSync(targetFilePath, \"utf-8\"));\n          } catch {\n            // Corrupted file — regenerate\n          }\n        }\n\n        // Batch translate changed keys\n        const entries = Object.entries(changedKeys);\n        for (let i = 0; i < entries.length; i += batchSize) {\n          const batch = Object.fromEntries(\n            entries.slice(i, i + batchSize),\n          );\n          try {\n            const translated = await translateBatch(\n              model,\n              batch,\n              targetLocale,\n              sourceLocale,\n              systemPrompt,\n              changedContexts,\n            );\n            Object.assign(existing, translated);\n          } catch (err) {\n            console.error(\n              `[solid-translate] Failed to translate batch for ${targetLocale}:`,\n              err,\n            );\n          }\n        }\n\n        // Remove keys that no longer exist in source\n        for (const key of Object.keys(existing)) {\n          if (!(key in sourceDict)) {\n            delete existing[key];\n          }\n        }\n\n        // Sort keys for stable, diff-friendly output\n        const sorted = Object.fromEntries(\n          Object.entries(existing).sort(([a], [b]) => a.localeCompare(b)),\n        );\n\n        writeFileSync(\n          targetFilePath,\n          JSON.stringify(sorted, null, 2) + \"\\n\",\n        );\n        console.log(\n          `[solid-translate] ${targetLocale}: ${Object.keys(sorted).length} keys`,\n        );\n      }\n\n      // Write updated lock file\n      writeFileSync(lockFilePath, JSON.stringify(lock, null, 2) + \"\\n\");\n      console.log(\"[solid-translate] Translation complete.\");\n    },\n\n    resolveId(id: string) {\n      if (id === VIRTUAL_MODULE_ID) {\n        return RESOLVED_VIRTUAL_MODULE_ID;\n      }\n    },\n\n    load(id: string) {\n      if (id === RESOLVED_VIRTUAL_MODULE_ID) {\n        // Load all locale JSON files and export as a single object\n        const translations: Record<string, Record<string, string>> = {};\n\n        if (existsSync(resolvedLocalesDir)) {\n          for (const file of readdirSync(resolvedLocalesDir)) {\n            if (!file.endsWith(\".json\")) continue;\n            if (file.startsWith(\".\")) continue;\n            const locale = file.replace(\".json\", \"\");\n            const filePath = join(resolvedLocalesDir, file);\n            try {\n              translations[locale] = JSON.parse(\n                readFileSync(filePath, \"utf-8\"),\n              );\n            } catch {\n              // Skip malformed files\n            }\n          }\n        }\n\n        return `export default ${JSON.stringify(translations)};`;\n      }\n    },\n\n    // HMR: reload translations when locale files change\n    handleHotUpdate({ file, server }) {\n      if (\n        file.startsWith(resolvedLocalesDir) &&\n        file.endsWith(\".json\")\n      ) {\n        const mod = server.moduleGraph.getModuleById(\n          RESOLVED_VIRTUAL_MODULE_ID,\n        );\n        if (mod) {\n          server.moduleGraph.invalidateModule(mod);\n          return [mod];\n        }\n      }\n    },\n  };\n}\n\nexport default solidTranslate;\n\n// ---------------------------------------------------------------------------\n// Auto-extraction helper\n// ---------------------------------------------------------------------------\n\nasync function autoExtractStrings(\n  root: string,\n  patterns: string[],\n): Promise<{ strings: Record<string, string>; contexts: Record<string, string> }> {\n  const strings: Record<string, string> = {};\n  const contexts: Record<string, string> = {};\n\n  // Dynamically import glob for file matching\n  const { glob } = await import(\"glob\");\n\n  for (const pattern of patterns) {\n    const files = await glob(pattern, { cwd: root, absolute: true });\n    for (const file of files) {\n      try {\n        const code = readFileSync(file, \"utf-8\");\n        const extracted = extractStringsFromSource(\n          code,\n          relative(root, file),\n        );\n        for (const entry of extracted) {\n          strings[entry.key] = entry.source;\n          if (entry.context) {\n            contexts[entry.key] = entry.context;\n          }\n        }\n      } catch {\n        // Skip unreadable files\n      }\n    }\n  }\n\n  return { strings, contexts };\n}\n","import { createHash } from \"node:crypto\";\n\n/** Create a short content hash for change detection */\nexport function hashContent(content: string): string {\n  return createHash(\"sha256\").update(content).digest(\"hex\").slice(0, 16);\n}\n","import { generateObject } from \"ai\";\nimport { z } from \"zod\";\nimport type { LanguageModelV1 } from \"ai\";\n\n/**\n * Translate a batch of key-value pairs from one locale to another using AI.\n * Supports optional per-key context hints for disambiguation.\n */\nexport async function translateBatch(\n  model: LanguageModelV1,\n  entries: Record<string, string>,\n  targetLocale: string,\n  sourceLocale: string,\n  systemPrompt?: string,\n  contexts?: Record<string, string>,\n): Promise<Record<string, string>> {\n  const keys = Object.keys(entries);\n  if (keys.length === 0) return {};\n\n  const defaultSystem = [\n    `You are a professional translator specializing in software localization.`,\n    `Translate text from \"${sourceLocale}\" to \"${targetLocale}\".`,\n    `Rules:`,\n    `- Preserve the original tone and meaning`,\n    `- Keep placeholders like {{variable}}, {variable}, {0}, {1} unchanged`,\n    `- Keep HTML tags unchanged`,\n    `- Do not add or remove content`,\n    `- Return natural, idiomatic translations`,\n  ].join(\"\\n\");\n\n  // Build context section if any keys have context hints\n  let contextSection = \"\";\n  if (contexts && Object.keys(contexts).length > 0) {\n    const contextLines = Object.entries(contexts)\n      .filter(([key]) => key in entries)\n      .map(([key, ctx]) => `  \"${key}\": ${ctx}`);\n    if (contextLines.length > 0) {\n      contextSection = [\n        ``,\n        `Context hints for disambiguation:`,\n        ...contextLines,\n        ``,\n      ].join(\"\\n\");\n    }\n  }\n\n  const { object } = await generateObject({\n    model,\n    schema: z.object({\n      translations: z.record(z.string(), z.string()),\n    }),\n    system: systemPrompt || defaultSystem,\n    prompt: [\n      `Translate each value in this JSON object from \"${sourceLocale}\" to \"${targetLocale}\".`,\n      `Return a JSON object with the exact same keys and the translated values.`,\n      contextSection,\n      JSON.stringify(entries, null, 2),\n    ].join(\"\\n\"),\n  });\n\n  return object.translations;\n}\n\n/**\n * Translate a markdown or MDX string from one locale to another.\n * Preserves code blocks, frontmatter, and MDX components.\n */\nexport async function translateMarkdown(\n  model: LanguageModelV1,\n  content: string,\n  targetLocale: string,\n  sourceLocale: string,\n  systemPrompt?: string,\n): Promise<string> {\n  const defaultSystem = [\n    `You are a professional translator specializing in documentation.`,\n    `Translate Markdown/MDX content from \"${sourceLocale}\" to \"${targetLocale}\".`,\n    `Rules:`,\n    `- Preserve all Markdown formatting (headers, lists, bold, italic, links, etc.)`,\n    `- Preserve code blocks and inline code unchanged`,\n    `- Preserve frontmatter YAML keys (only translate values)`,\n    `- Preserve MDX component syntax and JSX expressions`,\n    `- Preserve URLs and file paths unchanged`,\n    `- Return natural, idiomatic translations`,\n  ].join(\"\\n\");\n\n  const { object } = await generateObject({\n    model,\n    schema: z.object({\n      translated: z.string(),\n    }),\n    system: systemPrompt || defaultSystem,\n    prompt: [\n      `Translate this Markdown/MDX content from \"${sourceLocale}\" to \"${targetLocale}\".`,\n      `Return the complete translated document.`,\n      ``,\n      content,\n    ].join(\"\\n\"),\n  });\n\n  return object.translated;\n}\n","/** Extracted translatable string from source code */\nexport interface ExtractedString {\n  key: string;\n  source: string;\n  file: string;\n  line: number;\n  /** AI context hint from the `context` prop */\n  context?: string;\n}\n\n/**\n * Extract translatable strings from source code by finding:\n * - `<T>text</T>` — source text is used as the key\n * - `<T id=\"key\">fallback</T>` — explicit key\n * - `<T context=\"hint\">text</T>` — with AI context\n * - `<T id=\"key\" context=\"hint\">text</T>` — both\n * - `<T>text <Var>...</Var> more</T>` — builds template with {0} placeholders\n * - `msg(\"text\")` — shared string marker\n */\nexport function extractStringsFromSource(\n  code: string,\n  filePath: string,\n): ExtractedString[] {\n  const results: ExtractedString[] = [];\n  const seen = new Set<string>();\n\n  // Match <T ...props>children</T>\n  const tComponentRegex = /<T(\\s[^>]*)?>([^]*?)<\\/T>/g;\n  let match: RegExpExecArray | null;\n\n  while ((match = tComponentRegex.exec(code)) !== null) {\n    const attrs = match[1] || \"\";\n    const rawChildren = match[2]!;\n    const line = code.substring(0, match.index).split(\"\\n\").length;\n\n    // Parse id attribute\n    const idMatch = attrs.match(/id=[\"']([^\"']+)[\"']/);\n    // Parse context attribute\n    const contextMatch = attrs.match(/context=[\"']([^\"']+)[\"']/);\n\n    // Build source text: replace <Var>, <Num>, <Currency>, <DateTime> with {n} placeholders\n    // Single-pass replacement to preserve document order\n    let slotIndex = 0;\n    const source = rawChildren\n      .replace(\n        /<(?:Var|Num|Currency|DateTime)(?:\\s[^>]*)?>([^]*?)<\\/(?:Var|Num|Currency|DateTime)>/g,\n        () => `{${slotIndex++}}`,\n      )\n      .trim();\n\n    const key = idMatch ? idMatch[1]! : source;\n    if (!key || seen.has(key)) continue;\n    seen.add(key);\n\n    results.push({\n      key,\n      source,\n      file: filePath,\n      line,\n      context: contextMatch ? contextMatch[1] : undefined,\n    });\n  }\n\n  // Match msg(\"text\") and msg('text') calls\n  const msgRegex = /\\bmsg\\(\\s*[\"']([^\"']+)[\"']\\s*(?:,\\s*\\{[^}]*\\})?\\s*\\)/g;\n  while ((match = msgRegex.exec(code)) !== null) {\n    const source = match[1]!;\n    if (seen.has(source)) continue;\n    seen.add(source);\n    const line = code.substring(0, match.index).split(\"\\n\").length;\n    results.push({ key: source, source, file: filePath, line });\n  }\n\n  return results;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "solid-translate",
+  "version": "0.2.0",
+  "description": "AI-powered build-time translations for SolidJS. Full i18n with <T>, <Var>, <Num>, <Currency>, <Plural>, <DateTime>, locale detection, and a CLI — all BYOK.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "solid-translate": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "solid",
+    "solidjs",
+    "i18n",
+    "translate",
+    "translation",
+    "internationalization",
+    "localization",
+    "ai",
+    "vite",
+    "vite-plugin",
+    "build-time",
+    "openrouter",
+    "vercel-ai-sdk",
+    "general-translation",
+    "gt-react",
+    "pluralization",
+    "intl",
+    "locale",
+    "currency",
+    "datetime"
+  ],
+  "license": "MIT",
+  "author": "omniaura",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omniaura/solid-translate.git"
+  },
+  "homepage": "https://github.com/omniaura/solid-translate#readme",
+  "bugs": {
+    "url": "https://github.com/omniaura/solid-translate/issues"
+  },
+  "peerDependencies": {
+    "solid-js": ">=1.7.0",
+    "vite": ">=4.0.0",
+    "ai": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "glob": "^11.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^16.0.0",
+    "@types/bun": "latest",
+    "ai": "^4.0.0",
+    "semantic-release": "25",
+    "solid-js": "^1.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vite": "^5.0.0"
+  }
+}