@umituz/react-native-localization 3.5.44 → 3.5.48

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-localization",
-  "version": "3.5.44",
+  "version": "3.5.48",
   "description": "Generic localization system for React Native apps with i18n support",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/infrastructure/config/I18nInitializer.ts

@@ -38,7 +38,6 @@ export class I18nInitializer {
         fallbackLng: DEFAULT_LANGUAGE,
         ns: namespaces,
         defaultNS: defaultNamespace,
-
         fallbackNS: defaultNamespace,
         interpolation: { escapeValue: false },
         react: { useSuspense: false },
@@ -49,6 +48,8 @@ export class I18nInitializer {
         saveMissing: false,
         missingKeyHandler: false,
         debug: false,
+        returnEmptyString: false,
+        returnNull: false,
       });
     } catch {
       // Silent error handling

package/src/infrastructure/config/ResourceBuilder.ts

@@ -18,10 +18,8 @@ export class ResourceBuilder {
     // Initialize with package translations
     const resources: Record<string, Record<string, any>> = { ...packageTranslations };
 
-    // Ensure initial language exists
-    if (!resources[languageCode]) {
-      resources[languageCode] = {};
-    }
+    // Note: Do NOT create empty resources for unsupported languages
+    // i18next will properly fallback to fallbackLng when language not in resources
 
     // Process app translations
     for (const [key, value] of Object.entries(appTranslations)) {
@@ -31,22 +29,36 @@ export class ResourceBuilder {
       if (isLanguageKey) {
         // It's a language key (e.g., "en-US")
         const lang = key;
-        if (!resources[lang]) {
-          resources[lang] = {};
-        }
 
-        // Merge namespaces for this language
-        if (value && typeof value === 'object') {
-          for (const [namespace, translations] of Object.entries(value)) {
-            resources[lang][namespace] = TranslationLoader.mergeTranslations(
-              resources[lang][namespace] || {},
-              translations
+        // Only process if value has actual content
+        if (value && typeof value === 'object' && Object.keys(value).length > 0) {
+          if (!resources[lang]) {
+            resources[lang] = {};
+          }
+          const namespaces = Object.keys(value);
+          const isFlatMap = namespaces.every(nsKey => typeof value[nsKey] === 'string');
+          
+          if (isFlatMap) {
+            // It's a flat map (e.g. { hello: 'Hello' }), wrap in 'common'
+            const defaultNs = 'common';
+            resources[lang][defaultNs] = TranslationLoader.mergeTranslations(
+              resources[lang][defaultNs] || {},
+              value
             );
+          } else {
+            // It's already namespaced (e.g. { auth: {...} })
+            for (const [namespace, translations] of Object.entries(value)) {
+              resources[lang][namespace] = TranslationLoader.mergeTranslations(
+                resources[lang][namespace] || {},
+                translations as Record<string, any>
+              );
+            }
           }
         }
       } else {
         // It's a namespace for the default/current language (backward compatibility)
-        if (value && typeof value === 'object') {
+        // Only add if the language exists in resources (to prevent creating empty resources)
+        if (value && typeof value === 'object' && resources[languageCode]) {
           resources[languageCode][key] = TranslationLoader.mergeTranslations(
             resources[languageCode][key] || {},
             value

package/src/infrastructure/hooks/useTranslation.ts

@@ -87,6 +87,10 @@ export const useTranslationFunction = () => {
       }
     }
 
+    if (__DEV__ && !translationFound) {
+      console.warn(`[Localization] Translation missing for key: "${key}" in language: "${i18n.language}"`);
+    }
+
     return finalResult;
   }, [i18nextT, ready]);
 

package/src/presentation/screens/LanguageSelectionScreen.tsx

@@ -30,7 +30,7 @@ interface LanguageSelectionScreenProps {
     clearButton?: any;
     listContent?: any;
   };
-  searchPlaceholder: string;
+  searchPlaceholder?: string;
   testID?: string;
 }
 
@@ -39,7 +39,7 @@ export const LanguageSelectionScreen: React.FC<LanguageSelectionScreenProps> = (
   renderSearchInput,
   containerComponent: Container,
   styles: customStyles,
-  searchPlaceholder,
+  searchPlaceholder = "settings.languageSelection.searchPlaceholder",
   testID = 'language-selection-screen',
 }) => {
   const navigation = useNavigation();