poly-lexis 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -118,8 +118,9 @@ interface ManageTranslationsOptions {
 /**
  * Smart translation management - handles init, validation, auto-fill, and type generation
  * based on the current state of the project
+ * @returns true if translations are valid, false otherwise
  */
-declare function manageTranslations(projectRoot?: string, options?: ManageTranslationsOptions): Promise<void>;
+declare function manageTranslations(projectRoot?: string, options?: ManageTranslationsOptions): Promise<boolean>;
 
 /**
  * Validate all translations against the source language
@@ -134,11 +135,27 @@ declare function getMissingForLanguage(projectRoot: string, language: string): A
 }>;
 
 /**
- * Supported language codes for translations
- * Based on Google Translate API supported languages (ISO 639-1 and regional variants)
- * Complete list of all languages supported by Google Cloud Translation API
+ * Translation provider types
  */
-declare const SUPPORTED_LANGUAGES: readonly ["af", "sq", "am", "ar", "hy", "as", "ay", "az", "bm", "eu", "be", "bn", "bho", "bs", "bg", "ca", "ceb", "ny", "zh", "zh_cn", "zh_tw", "co", "hr", "cs", "da", "dv", "doi", "nl", "en", "eo", "et", "ee", "tl", "fi", "fr", "gl", "ka", "de", "el", "gn", "gu", "ht", "ha", "haw", "iw", "he", "hi", "hmn", "hu", "is", "ig", "ilo", "id", "ga", "it", "ja", "jw", "kn", "kk", "km", "rw", "gom", "ko", "kri", "ku", "ckb", "ky", "lo", "la", "lv", "ln", "lt", "lg", "lb", "mk", "mai", "mg", "ms", "ml", "mt", "mi", "mr", "mni", "lus", "mn", "my", "ne", "no", "or", "om", "ps", "fa", "pl", "pt", "pt_br", "pa", "qu", "ro", "ru", "sm", "sa", "gd", "sr", "st", "sn", "sd", "si", "sk", "sl", "so", "es", "su", "sw", "sv", "tg", "ta", "tt", "te", "th", "ti", "ts", "tr", "tk", "ak", "uk", "ur", "ug", "uz", "vi", "cy", "xh", "yi", "yo", "zu"];
+declare const TRANSLATION_PROVIDERS: readonly ["deepl", "google"];
+type TranslationProviderType = (typeof TRANSLATION_PROVIDERS)[number];
+/**
+ * DeepL supported target languages
+ * Based on DeepL API v2 documentation
+ */
+declare const DEEPL_LANGUAGES: readonly ["ar", "bg", "cs", "da", "de", "el", "en", "en_gb", "en_us", "es", "es_419", "et", "fi", "fr", "he", "hu", "id", "it", "ja", "ko", "lt", "lv", "nb", "nl", "pl", "pt", "pt_br", "pt_pt", "ro", "ru", "sk", "sl", "sv", "th", "tr", "uk", "vi", "zh", "zh_hans", "zh_hant"];
+/**
+ * Google Translate supported languages
+ * Based on Google Cloud Translation API v2
+ * Reference: https://docs.cloud.google.com/translate/docs/languages
+ */
+declare const GOOGLE_LANGUAGES: readonly ["af", "sq", "am", "ar", "hy", "az", "eu", "be", "bn", "bs", "bg", "ca", "ceb", "zh", "zh_cn", "zh_tw", "co", "hr", "cs", "da", "nl", "en", "eo", "et", "fi", "fr", "fy", "gl", "ka", "de", "el", "gu", "ht", "ha", "haw", "he", "hi", "hmn", "hu", "is", "ig", "id", "ga", "it", "ja", "jv", "kn", "kk", "km", "rw", "ko", "ku", "ky", "lo", "la", "lv", "lt", "lb", "mk", "mg", "ms", "ml", "mt", "mi", "mr", "mn", "my", "ne", "no", "ny", "or", "ps", "fa", "pl", "pt", "pt_br", "pa", "ro", "ru", "sm", "gd", "sr", "st", "sn", "sd", "si", "sk", "sl", "so", "es", "su", "sw", "sv", "tl", "tg", "ta", "tt", "te", "th", "tr", "tk", "uk", "ur", "ug", "uz", "vi", "cy", "xh", "yi", "yo", "zu"];
+/**
+ * All supported language codes (union of DeepL and Google Translate)
+ */
+declare const SUPPORTED_LANGUAGES: readonly string[];
+type DeepLLanguage = (typeof DEEPL_LANGUAGES)[number];
+type GoogleLanguage = (typeof GOOGLE_LANGUAGES)[number];
 type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
 /**
  * JSON Schema for .translationsrc.json
@@ -159,7 +176,7 @@ declare const TRANSLATION_CONFIG_SCHEMA: {
             description: string;
             items: {
                 type: string;
-                enum: readonly ["af", "sq", "am", "ar", "hy", "as", "ay", "az", "bm", "eu", "be", "bn", "bho", "bs", "bg", "ca", "ceb", "ny", "zh", "zh_cn", "zh_tw", "co", "hr", "cs", "da", "dv", "doi", "nl", "en", "eo", "et", "ee", "tl", "fi", "fr", "gl", "ka", "de", "el", "gn", "gu", "ht", "ha", "haw", "iw", "he", "hi", "hmn", "hu", "is", "ig", "ilo", "id", "ga", "it", "ja", "jw", "kn", "kk", "km", "rw", "gom", "ko", "kri", "ku", "ckb", "ky", "lo", "la", "lv", "ln", "lt", "lg", "lb", "mk", "mai", "mg", "ms", "ml", "mt", "mi", "mr", "mni", "lus", "mn", "my", "ne", "no", "or", "om", "ps", "fa", "pl", "pt", "pt_br", "pa", "qu", "ro", "ru", "sm", "sa", "gd", "sr", "st", "sn", "sd", "si", "sk", "sl", "so", "es", "su", "sw", "sv", "tg", "ta", "tt", "te", "th", "ti", "ts", "tr", "tk", "ak", "uk", "ur", "ug", "uz", "vi", "cy", "xh", "yi", "yo", "zu"];
+                enum: readonly string[];
             };
             minItems: number;
             uniqueItems: boolean;
@@ -167,7 +184,7 @@ declare const TRANSLATION_CONFIG_SCHEMA: {
         sourceLanguage: {
             type: string;
             description: string;
-            enum: readonly ["af", "sq", "am", "ar", "hy", "as", "ay", "az", "bm", "eu", "be", "bn", "bho", "bs", "bg", "ca", "ceb", "ny", "zh", "zh_cn", "zh_tw", "co", "hr", "cs", "da", "dv", "doi", "nl", "en", "eo", "et", "ee", "tl", "fi", "fr", "gl", "ka", "de", "el", "gn", "gu", "ht", "ha", "haw", "iw", "he", "hi", "hmn", "hu", "is", "ig", "ilo", "id", "ga", "it", "ja", "jw", "kn", "kk", "km", "rw", "gom", "ko", "kri", "ku", "ckb", "ky", "lo", "la", "lv", "ln", "lt", "lg", "lb", "mk", "mai", "mg", "ms", "ml", "mt", "mi", "mr", "mni", "lus", "mn", "my", "ne", "no", "or", "om", "ps", "fa", "pl", "pt", "pt_br", "pa", "qu", "ro", "ru", "sm", "sa", "gd", "sr", "st", "sn", "sd", "si", "sk", "sl", "so", "es", "su", "sw", "sv", "tg", "ta", "tt", "te", "th", "ti", "ts", "tr", "tk", "ak", "uk", "ur", "ug", "uz", "vi", "cy", "xh", "yi", "yo", "zu"];
+            enum: readonly string[];
             default: string;
         };
         typesOutputPath: {
@@ -175,6 +192,12 @@ declare const TRANSLATION_CONFIG_SCHEMA: {
             description: string;
             default: string;
         };
+        provider: {
+            type: string;
+            description: string;
+            enum: readonly ["deepl", "google"];
+            default: string;
+        };
     };
     required: string[];
     additionalProperties: boolean;
@@ -183,6 +206,18 @@ declare const TRANSLATION_CONFIG_SCHEMA: {
  * Validate if a language code is supported
  */
 declare function isValidLanguage(lang: string): lang is SupportedLanguage;
+/**
+ * Validate if a language is supported by DeepL
+ */
+declare function isValidDeepLLanguage(lang: string): lang is DeepLLanguage;
+/**
+ * Validate if a language is supported by Google Translate
+ */
+declare function isValidGoogleLanguage(lang: string): lang is GoogleLanguage;
+/**
+ * Validate if a language is supported by a specific provider
+ */
+declare function isValidLanguageForProvider(lang: string, provider: TranslationProviderType): boolean;
 /**
  * Validate languages array
  */
@@ -190,6 +225,17 @@ declare function validateLanguages(languages: string[]): {
     valid: boolean;
     invalid: string[];
 };
+/**
+ * Validate languages array for a specific provider
+ */
+declare function validateLanguagesForProvider(languages: string[], provider: TranslationProviderType): {
+    valid: boolean;
+    invalid: string[];
+};
+/**
+ * Get supported languages for a specific provider
+ */
+declare function getSupportedLanguages(provider: TranslationProviderType): readonly string[];
 
 /**
  * Translation provider interface
@@ -344,4 +390,4 @@ declare function sortKeys<T extends Record<string, unknown>>(obj: T): T;
  */
 declare function ensureTranslationsStructure(translationsPath: string, languages: string[]): void;
 
-export { DEFAULT_CONFIG, DEFAULT_LANGUAGES, GoogleTranslateProvider, type ManageTranslationsOptions, type MissingTranslation, SUPPORTED_LANGUAGES, type SupportedLanguage, TRANSLATION_CONFIG_SCHEMA, type TranslateOptions, type TranslationConfig, type TranslationEntry, type TranslationFile, type TranslationFiles, type TranslationProvider, type TranslationProviderFactory, type TranslationResult, type ValidationResult, addTranslationKey, addTranslationKeys, autoFillTranslations, detectExistingTranslations, ensureTranslationsStructure, extractVariables, fillNamespace, generateTranslationTypes, getAvailableLanguages, getMissingForLanguage, getNamespaces, getTranslationProvider, hasInterpolation, initTranslations, initTranslationsInteractive, isValidLanguage, loadConfig, manageTranslations, readTranslations, resetTranslationProvider, setTranslationProvider, sortKeys, translateBatch, translateText, validateLanguages, validateTranslations, validateVariables, writeTranslation };
+export { DEEPL_LANGUAGES, DEFAULT_CONFIG, DEFAULT_LANGUAGES, type DeepLLanguage, GOOGLE_LANGUAGES, type GoogleLanguage, GoogleTranslateProvider, type ManageTranslationsOptions, type MissingTranslation, SUPPORTED_LANGUAGES, type SupportedLanguage, TRANSLATION_CONFIG_SCHEMA, TRANSLATION_PROVIDERS, type TranslateOptions, type TranslationConfig, type TranslationEntry, type TranslationFile, type TranslationFiles, type TranslationProvider, type TranslationProviderFactory, type TranslationProviderType, type TranslationResult, type ValidationResult, addTranslationKey, addTranslationKeys, autoFillTranslations, detectExistingTranslations, ensureTranslationsStructure, extractVariables, fillNamespace, generateTranslationTypes, getAvailableLanguages, getMissingForLanguage, getNamespaces, getSupportedLanguages, getTranslationProvider, hasInterpolation, initTranslations, initTranslationsInteractive, isValidDeepLLanguage, isValidGoogleLanguage, isValidLanguage, isValidLanguageForProvider, loadConfig, manageTranslations, readTranslations, resetTranslationProvider, setTranslationProvider, sortKeys, translateBatch, translateText, validateLanguages, validateLanguagesForProvider, validateTranslations, validateVariables, writeTranslation };

package/dist/index.js

@@ -93,6 +93,22 @@ var init_utils = __esm({
 function isValidLanguage(lang) {
   return SUPPORTED_LANGUAGES.includes(lang);
 }
+function isValidDeepLLanguage(lang) {
+  return DEEPL_LANGUAGES.includes(lang);
+}
+function isValidGoogleLanguage(lang) {
+  return GOOGLE_LANGUAGES.includes(lang);
+}
+function isValidLanguageForProvider(lang, provider) {
+  switch (provider) {
+    case "deepl":
+      return isValidDeepLLanguage(lang);
+    case "google":
+      return isValidGoogleLanguage(lang);
+    default:
+      return false;
+  }
+}
 function validateLanguages(languages) {
   const invalid = languages.filter((lang) => !isValidLanguage(lang));
   return {
@@ -100,11 +116,111 @@ function validateLanguages(languages) {
     invalid
   };
 }
-var SUPPORTED_LANGUAGES, TRANSLATION_CONFIG_SCHEMA;
+function validateLanguagesForProvider(languages, provider) {
+  const invalid = languages.filter((lang) => !isValidLanguageForProvider(lang, provider));
+  return {
+    valid: invalid.length === 0,
+    invalid
+  };
+}
+function getSupportedLanguages(provider) {
+  switch (provider) {
+    case "deepl":
+      return DEEPL_LANGUAGES;
+    case "google":
+      return GOOGLE_LANGUAGES;
+    default:
+      return [];
+  }
+}
+var TRANSLATION_PROVIDERS, DEEPL_LANGUAGES, GOOGLE_LANGUAGES, SUPPORTED_LANGUAGES, TRANSLATION_CONFIG_SCHEMA;
 var init_schema = __esm({
   "src/translations/core/schema.ts"() {
     "use strict";
-    SUPPORTED_LANGUAGES = [
+    TRANSLATION_PROVIDERS = ["deepl", "google"];
+    DEEPL_LANGUAGES = [
+      "ar",
+      // Arabic
+      "bg",
+      // Bulgarian
+      "cs",
+      // Czech
+      "da",
+      // Danish
+      "de",
+      // German
+      "el",
+      // Greek
+      "en",
+      // English (unspecified)
+      "en_gb",
+      // English (British)
+      "en_us",
+      // English (American)
+      "es",
+      // Spanish
+      "es_419",
+      // Spanish (Latin American)
+      "et",
+      // Estonian
+      "fi",
+      // Finnish
+      "fr",
+      // French
+      "he",
+      // Hebrew (next-gen models only)
+      "hu",
+      // Hungarian
+      "id",
+      // Indonesian
+      "it",
+      // Italian
+      "ja",
+      // Japanese
+      "ko",
+      // Korean
+      "lt",
+      // Lithuanian
+      "lv",
+      // Latvian
+      "nb",
+      // Norwegian Bokmål
+      "nl",
+      // Dutch
+      "pl",
+      // Polish
+      "pt",
+      // Portuguese (unspecified)
+      "pt_br",
+      // Portuguese (Brazilian)
+      "pt_pt",
+      // Portuguese (excluding Brazilian)
+      "ro",
+      // Romanian
+      "ru",
+      // Russian
+      "sk",
+      // Slovak
+      "sl",
+      // Slovenian
+      "sv",
+      // Swedish
+      "th",
+      // Thai (next-gen models only)
+      "tr",
+      // Turkish
+      "uk",
+      // Ukrainian
+      "vi",
+      // Vietnamese (next-gen models only)
+      "zh",
+      // Chinese (unspecified)
+      "zh_hans",
+      // Chinese (simplified)
+      "zh_hant"
+      // Chinese (traditional)
+    ];
+    GOOGLE_LANGUAGES = [
       "af",
       // Afrikaans
       "sq",
@@ -115,22 +231,14 @@ var init_schema = __esm({
       // Arabic
       "hy",
       // Armenian
-      "as",
-      // Assamese
-      "ay",
-      // Aymara
       "az",
       // Azerbaijani
-      "bm",
-      // Bambara
       "eu",
       // Basque
       "be",
       // Belarusian
       "bn",
       // Bengali
-      "bho",
-      // Bhojpuri
       "bs",
       // Bosnian
       "bg",
@@ -139,12 +247,10 @@ var init_schema = __esm({
       // Catalan
       "ceb",
       // Cebuano
-      "ny",
-      // Chichewa
       "zh",
-      // Chinese (Simplified) - Google uses 'zh' or 'zh-CN'
+      // Chinese (Simplified)
       "zh_cn",
-      // Chinese (Simplified) - alternative format
+      // Chinese (Simplified)
       "zh_tw",
       // Chinese (Traditional)
       "co",
@@ -155,10 +261,6 @@ var init_schema = __esm({
       // Czech
       "da",
       // Danish
-      "dv",
-      // Dhivehi
-      "doi",
-      // Dogri
       "nl",
       // Dutch
       "en",
@@ -167,14 +269,12 @@ var init_schema = __esm({
       // Esperanto
       "et",
       // Estonian
-      "ee",
-      // Ewe
-      "tl",
-      // Filipino (Tagalog)
       "fi",
       // Finnish
       "fr",
       // French
+      "fy",
+      // Frisian
       "gl",
       // Galician
       "ka",
@@ -183,8 +283,6 @@ var init_schema = __esm({
       // German
       "el",
       // Greek
-      "gn",
-      // Guarani
       "gu",
       // Gujarati
       "ht",
@@ -193,8 +291,6 @@ var init_schema = __esm({
       // Hausa
       "haw",
       // Hawaiian
-      "iw",
-      // Hebrew (legacy code, 'he' is preferred)
       "he",
       // Hebrew
       "hi",
@@ -207,8 +303,6 @@ var init_schema = __esm({
       // Icelandic
       "ig",
       // Igbo
-      "ilo",
-      // Ilocano
       "id",
       // Indonesian
       "ga",
@@ -217,7 +311,7 @@ var init_schema = __esm({
       // Italian
       "ja",
       // Japanese
-      "jw",
+      "jv",
       // Javanese
       "kn",
       // Kannada
@@ -227,16 +321,10 @@ var init_schema = __esm({
       // Khmer
       "rw",
       // Kinyarwanda
-      "gom",
-      // Konkani
       "ko",
       // Korean
-      "kri",
-      // Krio
       "ku",
-      // Kurdish (Kurmanji)
-      "ckb",
-      // Kurdish (Sorani)
+      // Kurdish
       "ky",
       // Kyrgyz
       "lo",
@@ -245,18 +333,12 @@ var init_schema = __esm({
       // Latin
       "lv",
       // Latvian
-      "ln",
-      // Lingala
       "lt",
       // Lithuanian
-      "lg",
-      // Luganda
       "lb",
       // Luxembourgish
       "mk",
       // Macedonian
-      "mai",
-      // Maithili
       "mg",
       // Malagasy
       "ms",
@@ -269,10 +351,6 @@ var init_schema = __esm({
       // Maori
       "mr",
       // Marathi
-      "mni",
-      // Meiteilon (Manipuri)
-      "lus",
-      // Mizo
       "mn",
       // Mongolian
       "my",
@@ -281,10 +359,10 @@ var init_schema = __esm({
       // Nepali
       "no",
       // Norwegian
+      "ny",
+      // Nyanja (Chichewa)
       "or",
-      // Odia
-      "om",
-      // Oromo
+      // Odia (Oriya)
       "ps",
       // Pashto
       "fa",
@@ -297,18 +375,14 @@ var init_schema = __esm({
       // Portuguese (Brazil)
       "pa",
       // Punjabi
-      "qu",
-      // Quechua
       "ro",
       // Romanian
       "ru",
       // Russian
       "sm",
       // Samoan
-      "sa",
-      // Sanskrit
       "gd",
-      // Scottish Gaelic
+      // Scots Gaelic
       "sr",
       // Serbian
       "st",
@@ -318,7 +392,7 @@ var init_schema = __esm({
       "sd",
       // Sindhi
       "si",
-      // Sinhala
+      // Sinhala (Sinhalese)
       "sk",
       // Slovak
       "sl",
@@ -333,6 +407,8 @@ var init_schema = __esm({
       // Swahili
       "sv",
       // Swedish
+      "tl",
+      // Tagalog (Filipino)
       "tg",
       // Tajik
       "ta",
@@ -343,16 +419,10 @@ var init_schema = __esm({
       // Telugu
       "th",
       // Thai
-      "ti",
-      // Tigrinya
-      "ts",
-      // Tsonga
       "tr",
       // Turkish
       "tk",
       // Turkmen
-      "ak",
-      // Twi
       "uk",
       // Ukrainian
       "ur",
@@ -374,6 +444,9 @@ var init_schema = __esm({
       "zu"
       // Zulu
     ];
+    SUPPORTED_LANGUAGES = Array.from(
+      /* @__PURE__ */ new Set([...DEEPL_LANGUAGES, ...GOOGLE_LANGUAGES])
+    ).sort();
     TRANSLATION_CONFIG_SCHEMA = {
       $schema: "http://json-schema.org/draft-07/schema#",
       title: "Translation Configuration",
@@ -405,6 +478,12 @@ var init_schema = __esm({
           type: "string",
           description: "Path to output TypeScript types file",
           default: "src/types/i18nTypes.ts"
+        },
+        provider: {
+          type: "string",
+          description: "Translation provider to use (deepl or google)",
+          enum: TRANSLATION_PROVIDERS,
+          default: "deepl"
         }
       },
       required: ["translationsPath", "languages", "sourceLanguage"],
@@ -580,7 +659,7 @@ function preserveVariables(text) {
   const variableMap = /* @__PURE__ */ new Map();
   let placeholderIndex = 0;
   const textWithPlaceholders = text.replace(/\{\{([^}]+)\}\}/g, (match) => {
-    const placeholder = `__PLACEHOLDER_${placeholderIndex}__`;
+    const placeholder = `XXX_${placeholderIndex}_XXX`;
     variableMap.set(placeholder, match);
     placeholderIndex++;
     return placeholder;
@@ -1185,7 +1264,7 @@ async function manageTranslations(projectRoot = process.cwd(), options = {}) {
   if (!fs5.existsSync(sourceLangPath)) {
     console.log(`\u26A0\uFE0F  Source language directory not found: ${sourceLangPath}`);
     console.log("Please add translation files to the source language directory.\n");
-    return;
+    return false;
   }
   console.log("\u{1F50D} Validating translations...\n");
   const validationResult = validateTranslations(projectRoot);
@@ -1249,6 +1328,11 @@ async function manageTranslations(projectRoot = process.cwd(), options = {}) {
     console.log("\n\u2705 All systems ready!");
   }
   console.log("=====\n");
+  if (autoFill && !dryRun && apiKey) {
+    const finalValidation = validateTranslations(projectRoot);
+    return finalValidation.valid;
+  }
+  return validationResult.valid;
 }
 
 // src/translations/index.ts
@@ -1256,11 +1340,14 @@ init_schema();
 init_types();
 init_utils();
 export {
+  DEEPL_LANGUAGES,
   DEFAULT_CONFIG,
   DEFAULT_LANGUAGES,
+  GOOGLE_LANGUAGES,
   GoogleTranslateProvider,
   SUPPORTED_LANGUAGES,
   TRANSLATION_CONFIG_SCHEMA,
+  TRANSLATION_PROVIDERS,
   addTranslationKey,
   addTranslationKeys,
   autoFillTranslations,
@@ -1272,11 +1359,15 @@ export {
   getAvailableLanguages,
   getMissingForLanguage,
   getNamespaces,
+  getSupportedLanguages,
   getTranslationProvider,
   hasInterpolation,
   initTranslations,
   initTranslationsInteractive,
+  isValidDeepLLanguage,
+  isValidGoogleLanguage,
   isValidLanguage,
+  isValidLanguageForProvider,
   loadConfig,
   manageTranslations,
   readTranslations,
@@ -1286,6 +1377,7 @@ export {
   translateBatch,
   translateText,
   validateLanguages,
+  validateLanguagesForProvider,
   validateTranslations,
   validateVariables,
   writeTranslation