@umituz/react-native-localization 1.12.0 → 1.14.0

package/README.md

@@ -243,6 +243,26 @@ function MyComponent() {
 }
 ```
 
+#### **Add Project Translations to Package i18n**
+
+For better integration, add your project translations to the package i18n instance:
+
+```typescript
+import { addTranslationResources } from '@umituz/react-native-localization';
+
+// In your project's i18n config
+const projectTranslations = require('./locales/en-US');
+
+addTranslationResources({
+  'en-US': {
+    translation: projectTranslations.default || projectTranslations,
+  },
+  // Add other languages as needed
+});
+```
+
+This ensures all translations work through the same i18n instance, preventing conflicts.
+
 ### Step 7: Translation Management
 
 #### Adding New Translations

package/package.json

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

package/src/index.ts

@@ -12,7 +12,7 @@ export { LanguageSwitcher } from './infrastructure/components/LanguageSwitcher';
 export { useLanguageNavigation } from './infrastructure/components/useLanguageNavigation';
 
 // Configuration
-export { default as i18n } from './infrastructure/config/i18n';
+export { default as i18n, addTranslationResources } from './infrastructure/config/i18n';
 export {
   SUPPORTED_LANGUAGES,
   LANGUAGES, // Alias for SUPPORTED_LANGUAGES (backward compatibility)

package/src/infrastructure/config/i18n.ts

@@ -197,4 +197,19 @@ const initializeI18n = () => {
 // CRITICAL: i18n.isInitialized check prevents multiple initializations
 initializeI18n();
 
+/**
+ * Add additional translation resources to the existing i18n instance
+ * This allows projects to add their own translations to the package translations
+ */
+export const addTranslationResources = (resources: Record<string, { translation: any }>) => {
+  for (const [langCode, resource] of Object.entries(resources)) {
+    if (resource.translation) {
+      // Merge with existing translations if any
+      const existingTranslations = i18n.getResourceBundle(langCode, 'translation') || {};
+      const mergedTranslations = { ...existingTranslations, ...resource.translation };
+      i18n.addResourceBundle(langCode, 'translation', mergedTranslations, true, true);
+    }
+  }
+};
+
 export default i18n;