poly-lexis 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -184,6 +184,8 @@ interface TranslationConfig {
     searchPaths?: string[];
     /** File extensions to search for key usage (default: ['.ts', '.tsx', '.js', '.jsx', '.vue', '.svelte']) */
     searchExtensions?: string[];
+    /** Words or phrases that should never be translated (e.g. brand names, product names) */
+    protectedTerms?: string[];
 }
 interface TranslationEntry {
     namespace: string;
@@ -376,6 +378,8 @@ interface TranslateOptions {
     apiKey?: string;
     /** Enable automatic language fallback for unsupported regional variants (default: true) */
     useFallbackLanguages?: boolean;
+    /** Words or phrases that should never be translated (e.g. brand names, product names) */
+    protectedTerms?: string[];
     /** Additional provider-specific options */
     [key: string]: unknown;
 }
@@ -464,7 +468,7 @@ declare function resetTranslationProvider(): void;
  * @param useFallbackLanguages - Enable automatic language fallback (default: true)
  * @returns Promise resolving to translated text
  */
-declare function translateText(text: string, targetLang: string, sourceLang?: string, apiKey?: string, useFallbackLanguages?: boolean): Promise<string>;
+declare function translateText(text: string, targetLang: string, sourceLang?: string, apiKey?: string, useFallbackLanguages?: boolean, protectedTerms?: string[]): Promise<string>;
 /**
  * Translate multiple texts in batch
  *

package/dist/index.js

@@ -834,7 +834,8 @@ var init_types = __esm({
       provider: "deepl",
       useFallbackLanguages: true,
       searchPaths: ["src", "app", "pages", "components"],
-      searchExtensions: [".ts", ".tsx", ".js", ".jsx", ".vue", ".svelte"]
+      searchExtensions: [".ts", ".tsx", ".js", ".jsx", ".vue", ".svelte"],
+      protectedTerms: []
     };
     DEFAULT_LANGUAGES = ["en", "fr", "it", "pl", "es", "pt", "de", "nl", "sv", "hu", "cs", "ja"];
   }
@@ -977,10 +978,20 @@ import * as path4 from "path";
 
 // src/translations/utils/deepl-translate-provider.ts
 init_language_fallback();
-function preserveVariables(text) {
+function preserveVariables(text, protectedTerms = []) {
   const variableMap = /* @__PURE__ */ new Map();
   let placeholderIndex = 0;
-  const textWithPlaceholders = text.replace(/\{\{([^}]+)\}\}/g, (match) => {
+  let result = text;
+  for (const term of protectedTerms) {
+    const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    result = result.replace(new RegExp(escaped, "g"), () => {
+      const placeholder = `XXX_${placeholderIndex}_XXX`;
+      variableMap.set(placeholder, term);
+      placeholderIndex++;
+      return placeholder;
+    });
+  }
+  const textWithPlaceholders = result.replace(/\{\{([^}]+)\}\}/g, (match) => {
     const placeholder = `XXX_${placeholderIndex}_XXX`;
     variableMap.set(placeholder, match);
     placeholderIndex++;
@@ -1012,7 +1023,7 @@ var DeepLTranslateProvider = class {
     return this.isFreeApi ? "https://api-free.deepl.com/v2/translate" : "https://api.deepl.com/v2/translate";
   }
   async translate(options) {
-    const { text, sourceLang, targetLang, apiKey, useFallbackLanguages = true } = options;
+    const { text, sourceLang, targetLang, apiKey, useFallbackLanguages = true, protectedTerms = [] } = options;
     if (!apiKey) {
       throw new Error(
         "DeepL API key is required. Set DEEPL_API_KEY environment variable or provide apiKey in options."
@@ -1026,7 +1037,7 @@ var DeepLTranslateProvider = class {
       logLanguageFallback(sourceLangResult, "deepl");
       resolvedSourceLang = sourceLangResult.resolvedLanguage;
     }
-    const { textWithPlaceholders, variableMap } = preserveVariables(text);
+    const { textWithPlaceholders, variableMap } = preserveVariables(text, protectedTerms);
     const body = {
       text: [textWithPlaceholders],
       target_lang: normalizeLanguageCode(targetLangResult.resolvedLanguage),
@@ -1075,10 +1086,20 @@ var DeepLTranslateProvider = class {
 
 // src/translations/utils/google-translate-provider.ts
 init_language_fallback();
-function preserveVariables2(text) {
+function preserveVariables2(text, protectedTerms = []) {
   const variableMap = /* @__PURE__ */ new Map();
   let placeholderIndex = 0;
-  const textWithPlaceholders = text.replace(/\{\{([^}]+)\}\}/g, (match) => {
+  let result = text;
+  for (const term of protectedTerms) {
+    const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    result = result.replace(new RegExp(escaped, "g"), () => {
+      const placeholder = `XXX_${placeholderIndex}_XXX`;
+      variableMap.set(placeholder, term);
+      placeholderIndex++;
+      return placeholder;
+    });
+  }
+  const textWithPlaceholders = result.replace(/\{\{([^}]+)\}\}/g, (match) => {
     const placeholder = `XXX_${placeholderIndex}_XXX`;
     variableMap.set(placeholder, match);
     placeholderIndex++;
@@ -1100,7 +1121,7 @@ function restoreVariables2(text, variableMap) {
 }
 var GoogleTranslateProvider = class {
   async translate(options) {
-    const { text, sourceLang, targetLang, apiKey, useFallbackLanguages = true } = options;
+    const { text, sourceLang, targetLang, apiKey, useFallbackLanguages = true, protectedTerms = [] } = options;
     if (!apiKey) {
       throw new Error(
         "Google Translate API key is required. Set GOOGLE_TRANSLATE_API_KEY environment variable or provide apiKey in options."
@@ -1114,7 +1135,7 @@ var GoogleTranslateProvider = class {
       logLanguageFallback(sourceLangResult, "google");
       resolvedSourceLang = sourceLangResult.resolvedLanguage;
     }
-    const { textWithPlaceholders, variableMap } = preserveVariables2(text);
+    const { textWithPlaceholders, variableMap } = preserveVariables2(text, protectedTerms);
     const url = `https://translation.googleapis.com/language/translate/v2?key=${apiKey}`;
     const sourceForGoogle = resolvedSourceLang?.includes("_") ? resolvedSourceLang.split("_")[0] : resolvedSourceLang;
     const targetForGoogle = targetLangResult.resolvedLanguage.includes("_") ? targetLangResult.resolvedLanguage.split("_")[0] : targetLangResult.resolvedLanguage;
@@ -1171,14 +1192,15 @@ function getTranslationProvider() {
 function resetTranslationProvider() {
   customProvider = null;
 }
-async function translateText(text, targetLang, sourceLang = "en", apiKey, useFallbackLanguages = true) {
+async function translateText(text, targetLang, sourceLang = "en", apiKey, useFallbackLanguages = true, protectedTerms = []) {
   const provider = getTranslationProvider();
   return provider.translate({
     text,
     sourceLang,
     targetLang,
     apiKey,
-    useFallbackLanguages
+    useFallbackLanguages,
+    protectedTerms
   });
 }
 async function translateBatch(texts, targetLang, sourceLang = "en", apiKey, delayMs = 100) {
@@ -1212,12 +1234,14 @@ function extractPluralBaseKeys(keys) {
   }
   return Array.from(baseKeys);
 }
-var typeTemplate = (translationKeys, namespaceKeys) => `
+var typeTemplate = (translationKeys, namespaceKeys, languages) => `
   export const translationKeys = [${translationKeys.map((key) => `"${key}"`).join(", ")}] as const;
   export const namespaceKeys = [${namespaceKeys.map((key) => `"${key}"`).join(", ")}] as const;
+  export const languages = [${languages.map((lang) => `"${lang}"`).join(", ")}] as const;
 
   export type TranslationKey = typeof translationKeys[number];
   export type TranslationNamespace = typeof namespaceKeys[number];
+  export type Language = typeof languages[number];
 `;
 function generateTranslationTypes(projectRoot = process.cwd()) {
   console.log("=====");
@@ -1248,7 +1272,7 @@ function generateTranslationTypes(projectRoot = process.cwd()) {
   if (!fs3.existsSync(outputDir)) {
     fs3.mkdirSync(outputDir, { recursive: true });
   }
-  const typeString = typeTemplate(allKeys, namespaces);
+  const typeString = typeTemplate(allKeys, namespaces, config.languages);
   fs3.writeFileSync(outputFilePath, typeString, "utf8");
   console.log(`Generated types with ${allKeys.length} keys and ${namespaces.length} namespaces`);
   console.log(`Output: ${outputFilePath}`);
@@ -1309,7 +1333,14 @@ async function addTranslationKey(projectRoot, options) {
           targetTranslations[namespace] = {};
         }
         if (!targetTranslations[namespace][key] || targetTranslations[namespace][key].trim() === "") {
-          const translated = await translateText(value, lang, sourceLang, apiKey, config.useFallbackLanguages ?? true);
+          const translated = await translateText(
+            value,
+            lang,
+            sourceLang,
+            apiKey,
+            config.useFallbackLanguages,
+            config.protectedTerms
+          );
           targetTranslations[namespace][key] = translated;
           const sorted = sortKeys(targetTranslations[namespace]);
           writeTranslation(translationsPath, lang, namespace, sorted);
@@ -1564,7 +1595,8 @@ Processing language: ${language}`);
           language,
           config.sourceLanguage,
           apiKey,
-          config.useFallbackLanguages ?? true
+          config.useFallbackLanguages,
+          config.protectedTerms
         );
         console.log(`    ${language.toUpperCase()}: "${translated}"`);
         if (!dryRun) {
@@ -1629,7 +1661,8 @@ async function fillNamespace(projectRoot, language, namespace, apiKey) {
       language,
       config.sourceLanguage,
       apiKey,
-      config.useFallbackLanguages ?? true
+      config.useFallbackLanguages ?? true,
+      config.protectedTerms ?? []
     );
     targetKeys[key] = translated;
     count++;