poly-lexis 0.5.3 → 0.8.0

package/dist/index.d.ts

@@ -225,6 +225,16 @@ interface UnusedKeysResult {
     totalKeys: number;
     searchedFiles: number;
 }
+interface DuplicateTranslation {
+    namespace: string;
+    key: string;
+    commonKey: string;
+    value: string;
+}
+interface DuplicateKeysResult {
+    duplicates: DuplicateTranslation[];
+    totalKeysChecked: number;
+}
 declare const DEFAULT_CONFIG: Required<TranslationConfig>;
 declare const DEFAULT_LANGUAGES: readonly ["en", "fr", "it", "pl", "es", "pt", "de", "nl", "sv", "hu", "cs", "ja"];
 
@@ -282,6 +292,11 @@ declare function findUnusedKeys(projectRoot?: string): UnusedKeysResult;
  */
 declare function printUnusedKeysResult(result: UnusedKeysResult): void;
 
+/**
+ * Extract base keys from plural-suffixed keys (e.g., "items_one" -> "items")
+ * Follows CLDR plural categories used by i18next and similar libraries.
+ */
+declare function extractPluralBaseKeys(keys: string[]): string[];
 /**
  * Generate TypeScript types from translation files
  */
@@ -462,8 +477,29 @@ declare function translateText(text: string, targetLang: string, sourceLang?: st
  */
 declare function translateBatch(texts: string[], targetLang: string, sourceLang?: string, apiKey?: string, delayMs?: number): Promise<string[]>;
 
+/**
+ * Nested translation structure (allows nested objects)
+ */
+type NestedTranslationFile = {
+    [key: string]: string | NestedTranslationFile;
+};
+/**
+ * Flatten a nested object into a flat key-value structure using dot notation
+ * Example: { home: { title: "Hello" } } -> { "home.title": "Hello" }
+ */
+declare function flattenObject(obj: NestedTranslationFile, prefix?: string): TranslationFile;
+/**
+ * Unflatten a flat object with dot notation keys into a nested structure
+ * Example: { "home.title": "Hello" } -> { home: { title: "Hello" } }
+ */
+declare function unflattenObject(obj: TranslationFile): NestedTranslationFile;
+/**
+ * Check if an object is flat (all values are strings) or nested
+ */
+declare function isNestedObject(obj: Record<string, unknown>): boolean;
 /**
  * Read all translation files for a specific language
+ * Automatically flattens nested structures into dot notation
  */
 declare function readTranslations(translationsPath: string, language: string): TranslationFiles;
 /**
@@ -536,4 +572,4 @@ interface SyncResult {
  */
 declare function syncTranslationStructure(translationsPath: string, languages: string[], sourceLanguage: string): SyncResult;
 
-export { DEEPL_LANGUAGES, DEFAULT_CONFIG, DEFAULT_LANGUAGES, type DeepLLanguage, GOOGLE_LANGUAGES, type GoogleLanguage, GoogleTranslateProvider, type LanguageFallbackResult, type ManageTranslationsOptions, type MissingTranslation, type OrphanedTranslation, SUPPORTED_LANGUAGES, type SupportedLanguage, type SyncResult, TRANSLATION_CONFIG_SCHEMA, TRANSLATION_PROVIDERS, type TranslateOptions, type TranslationConfig, type TranslationEntry, type TranslationFile, type TranslationFiles, type TranslationProvider, type TranslationProviderFactory, type TranslationProviderType, type TranslationResult, type UnusedKeysResult, type UnusedTranslation, type ValidationResult, addTranslationKey, addTranslationKeys, autoFillTranslations, createEmptyTranslationStructure, detectExistingTranslations, ensureTranslationsStructure, extractVariables, fillNamespace, findUnusedKeys, generateTranslationTypes, getAvailableLanguages, getFallbackMappings, getMissingForLanguage, getNamespaces, getSupportedLanguages, getTranslationProvider, hasInterpolation, initTranslations, initTranslationsInteractive, isValidDeepLLanguage, isValidGoogleLanguage, isValidLanguage, isValidLanguageForProvider, loadConfig, logLanguageFallback, manageTranslations, printUnusedKeysResult, readTranslations, resetTranslationProvider, resolveLanguageWithFallback, setTranslationProvider, sortKeys, syncTranslationStructure, translateBatch, translateText, validateLanguages, validateLanguagesForProvider, validateTranslations, validateVariables, writeTranslation };
+export { DEEPL_LANGUAGES, DEFAULT_CONFIG, DEFAULT_LANGUAGES, type DeepLLanguage, type DuplicateKeysResult, type DuplicateTranslation, GOOGLE_LANGUAGES, type GoogleLanguage, GoogleTranslateProvider, type LanguageFallbackResult, type ManageTranslationsOptions, type MissingTranslation, type NestedTranslationFile, type OrphanedTranslation, SUPPORTED_LANGUAGES, type SupportedLanguage, type SyncResult, TRANSLATION_CONFIG_SCHEMA, TRANSLATION_PROVIDERS, type TranslateOptions, type TranslationConfig, type TranslationEntry, type TranslationFile, type TranslationFiles, type TranslationProvider, type TranslationProviderFactory, type TranslationProviderType, type TranslationResult, type UnusedKeysResult, type UnusedTranslation, type ValidationResult, addTranslationKey, addTranslationKeys, autoFillTranslations, createEmptyTranslationStructure, detectExistingTranslations, ensureTranslationsStructure, extractPluralBaseKeys, extractVariables, fillNamespace, findUnusedKeys, flattenObject, generateTranslationTypes, getAvailableLanguages, getFallbackMappings, getMissingForLanguage, getNamespaces, getSupportedLanguages, getTranslationProvider, hasInterpolation, initTranslations, initTranslationsInteractive, isNestedObject, isValidDeepLLanguage, isValidGoogleLanguage, isValidLanguage, isValidLanguageForProvider, loadConfig, logLanguageFallback, manageTranslations, printUnusedKeysResult, readTranslations, resetTranslationProvider, resolveLanguageWithFallback, setTranslationProvider, sortKeys, syncTranslationStructure, translateBatch, translateText, unflattenObject, validateLanguages, validateLanguagesForProvider, validateTranslations, validateVariables, writeTranslation };

package/dist/index.js

@@ -626,6 +626,37 @@ var init_language_fallback = __esm({
 // src/translations/utils/utils.ts
 import * as fs from "fs";
 import * as path from "path";
+function flattenObject(obj, prefix = "") {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const newKey = prefix ? `${prefix}.${key}` : key;
+    if (typeof value === "string") {
+      result[newKey] = value;
+    } else if (typeof value === "object" && value !== null) {
+      Object.assign(result, flattenObject(value, newKey));
+    }
+  }
+  return result;
+}
+function unflattenObject(obj) {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const parts = key.split(".");
+    let current = result;
+    for (let i = 0; i < parts.length - 1; i++) {
+      const part = parts[i];
+      if (!(part in current) || typeof current[part] === "string") {
+        current[part] = {};
+      }
+      current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+  }
+  return result;
+}
+function isNestedObject(obj) {
+  return Object.values(obj).some((value) => typeof value === "object" && value !== null);
+}
 function readTranslations(translationsPath, language) {
   const langPath = path.join(translationsPath, language);
   if (!fs.existsSync(langPath)) {
@@ -637,7 +668,12 @@ function readTranslations(translationsPath, language) {
     const namespace = path.basename(file, ".json");
     const filePath = path.join(langPath, file);
     const content = fs.readFileSync(filePath, "utf-8");
-    translations[namespace] = JSON.parse(content);
+    const parsed = JSON.parse(content);
+    if (isNestedObject(parsed)) {
+      translations[namespace] = flattenObject(parsed);
+    } else {
+      translations[namespace] = parsed;
+    }
   }
   return translations;
 }
@@ -1159,6 +1195,23 @@ init_init();
 import { execSync } from "child_process";
 import * as fs3 from "fs";
 import * as path3 from "path";
+var PLURAL_SUFFIXES = ["_zero", "_one", "_two", "_few", "_many", "_other"];
+function extractPluralBaseKeys(keys) {
+  const keySet = new Set(keys);
+  const baseKeys = /* @__PURE__ */ new Set();
+  for (const key of keys) {
+    for (const suffix of PLURAL_SUFFIXES) {
+      if (key.endsWith(suffix)) {
+        const baseKey = key.slice(0, -suffix.length);
+        if (baseKey && !keySet.has(baseKey)) {
+          baseKeys.add(baseKey);
+        }
+        break;
+      }
+    }
+  }
+  return Array.from(baseKeys);
+}
 var typeTemplate = (translationKeys, namespaceKeys) => `
   export const translationKeys = [${translationKeys.map((key) => `"${key}"`).join(", ")}] as const;
   export const namespaceKeys = [${namespaceKeys.map((key) => `"${key}"`).join(", ")}] as const;
@@ -1189,6 +1242,8 @@ function generateTranslationTypes(projectRoot = process.cwd()) {
     const keys = Object.keys(translations[namespace] || {});
     allKeys = allKeys.concat(keys);
   }
+  const pluralBaseKeys = extractPluralBaseKeys(allKeys);
+  allKeys = allKeys.concat(pluralBaseKeys);
   const outputDir = path3.dirname(outputFilePath);
   if (!fs3.existsSync(outputDir)) {
     fs3.mkdirSync(outputDir, { recursive: true });
@@ -2178,9 +2233,11 @@ export {
   createEmptyTranslationStructure,
   detectExistingTranslations,
   ensureTranslationsStructure,
+  extractPluralBaseKeys,
   extractVariables,
   fillNamespace,
   findUnusedKeys,
+  flattenObject,
   generateTranslationTypes,
   getAvailableLanguages,
   getFallbackMappings,
@@ -2191,6 +2248,7 @@ export {
   hasInterpolation,
   initTranslations,
   initTranslationsInteractive,
+  isNestedObject,
   isValidDeepLLanguage,
   isValidGoogleLanguage,
   isValidLanguage,
@@ -2207,6 +2265,7 @@ export {
   syncTranslationStructure,
   translateBatch,
   translateText,
+  unflattenObject,
   validateLanguages,
   validateLanguagesForProvider,
   validateTranslations,