poly-lexis 0.2.2 → 0.3.1

package/dist/index.d.ts

@@ -135,46 +135,74 @@ 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", "zh_hk", "co", "hr", "cs", "da", "dv", "doi", "nl", "en", "eo", "et", "ee", "tl", "fi", "fr", "gl", "ka", "de", "de_at", "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
  */
 declare const TRANSLATION_CONFIG_SCHEMA: {
-    $schema: string;
     title: string;
     description: string;
     type: string;
     properties: {
+        $schema: {
+            type: string;
+            description: string;
+        };
         translationsPath: {
             type: string;
             description: string;
             default: string;
+            examples: string[];
         };
         languages: {
             type: string;
             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", "zh_hk", "co", "hr", "cs", "da", "dv", "doi", "nl", "en", "eo", "et", "ee", "tl", "fi", "fr", "gl", "ka", "de", "de_at", "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;
+            default: string[];
         };
         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", "zh_hk", "co", "hr", "cs", "da", "dv", "doi", "nl", "en", "eo", "et", "ee", "tl", "fi", "fr", "gl", "ka", "de", "de_at", "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: {
             type: string;
             description: string;
             default: string;
+            examples: string[];
+        };
+        provider: {
+            type: string;
+            description: string;
+            enum: readonly ["deepl", "google"];
+            default: string;
         };
     };
     required: string[];
@@ -184,6 +212,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
  */
@@ -191,6 +231,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
@@ -345,4 +396,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,16 +247,12 @@ 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)
-      "zh_hk",
-      // Chinese (Hong Kong)
       "co",
       // Corsican
       "hr",
@@ -157,10 +261,6 @@ var init_schema = __esm({
       // Czech
       "da",
       // Danish
-      "dv",
-      // Dhivehi
-      "doi",
-      // Dogri
       "nl",
       // Dutch
       "en",
@@ -169,26 +269,20 @@ var init_schema = __esm({
       // Esperanto
       "et",
       // Estonian
-      "ee",
-      // Ewe
-      "tl",
-      // Filipino (Tagalog)
       "fi",
       // Finnish
       "fr",
       // French
+      "fy",
+      // Frisian
       "gl",
       // Galician
       "ka",
       // Georgian
       "de",
       // German
-      "de_at",
-      // German (Austria)
       "el",
       // Greek
-      "gn",
-      // Guarani
       "gu",
       // Gujarati
       "ht",
@@ -197,8 +291,6 @@ var init_schema = __esm({
       // Hausa
       "haw",
       // Hawaiian
-      "iw",
-      // Hebrew (legacy code, 'he' is preferred)
       "he",
       // Hebrew
       "hi",
@@ -211,8 +303,6 @@ var init_schema = __esm({
       // Icelandic
       "ig",
       // Igbo
-      "ilo",
-      // Ilocano
       "id",
       // Indonesian
       "ga",
@@ -221,7 +311,7 @@ var init_schema = __esm({
       // Italian
       "ja",
       // Japanese
-      "jw",
+      "jv",
       // Javanese
       "kn",
       // Kannada
@@ -231,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",
@@ -249,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",
@@ -273,10 +351,6 @@ var init_schema = __esm({
       // Maori
       "mr",
       // Marathi
-      "mni",
-      // Meiteilon (Manipuri)
-      "lus",
-      // Mizo
       "mn",
       // Mongolian
       "my",
@@ -285,10 +359,10 @@ var init_schema = __esm({
       // Nepali
       "no",
       // Norwegian
+      "ny",
+      // Nyanja (Chichewa)
       "or",
-      // Odia
-      "om",
-      // Oromo
+      // Odia (Oriya)
       "ps",
       // Pashto
       "fa",
@@ -301,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",
@@ -322,7 +392,7 @@ var init_schema = __esm({
       "sd",
       // Sindhi
       "si",
-      // Sinhala
+      // Sinhala (Sinhalese)
       "sk",
       // Slovak
       "sl",
@@ -337,6 +407,8 @@ var init_schema = __esm({
       // Swahili
       "sv",
       // Swedish
+      "tl",
+      // Tagalog (Filipino)
       "tg",
       // Tajik
       "ta",
@@ -347,16 +419,10 @@ var init_schema = __esm({
       // Telugu
       "th",
       // Thai
-      "ti",
-      // Tigrinya
-      "ts",
-      // Tsonga
       "tr",
       // Turkish
       "tk",
       // Turkmen
-      "ak",
-      // Twi
       "uk",
       // Ukrainian
       "ur",
@@ -378,16 +444,23 @@ 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",
       description: "Configuration for the translation management system",
       type: "object",
       properties: {
+        $schema: {
+          type: "string",
+          description: "JSON Schema reference"
+        },
         translationsPath: {
           type: "string",
           description: "Path to the translations directory relative to project root",
-          default: "public/static/locales"
+          default: "public/static/locales",
+          examples: ["public/static/locales", "src/locales", "locales"]
         },
         languages: {
           type: "array",
@@ -397,7 +470,8 @@ var init_schema = __esm({
             enum: SUPPORTED_LANGUAGES
           },
           minItems: 1,
-          uniqueItems: true
+          uniqueItems: true,
+          default: ["en"]
         },
         sourceLanguage: {
           type: "string",
@@ -408,7 +482,14 @@ var init_schema = __esm({
         typesOutputPath: {
           type: "string",
           description: "Path to output TypeScript types file",
-          default: "src/types/i18nTypes.ts"
+          default: "src/types/i18nTypes.ts",
+          examples: ["src/types/i18nTypes.ts", "src/types/translations.ts"]
+        },
+        provider: {
+          type: "string",
+          description: "Translation provider to use (deepl or google)",
+          enum: TRANSLATION_PROVIDERS,
+          default: "deepl"
         }
       },
       required: ["translationsPath", "languages", "sourceLanguage"],
@@ -584,7 +665,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;
@@ -1265,11 +1346,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,
@@ -1281,11 +1365,15 @@ export {
   getAvailableLanguages,
   getMissingForLanguage,
   getNamespaces,
+  getSupportedLanguages,
   getTranslationProvider,
   hasInterpolation,
   initTranslations,
   initTranslationsInteractive,
+  isValidDeepLLanguage,
+  isValidGoogleLanguage,
   isValidLanguage,
+  isValidLanguageForProvider,
   loadConfig,
   manageTranslations,
   readTranslations,
@@ -1295,6 +1383,7 @@ export {
   translateBatch,
   translateText,
   validateLanguages,
+  validateLanguagesForProvider,
   validateTranslations,
   validateVariables,
   writeTranslation