@umituz/react-native-localization 2.4.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-localization",
-  "version": "2.4.0",
+  "version": "2.5.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

@@ -1,6 +1,6 @@
 /**
  * React Native Localization
- * Universal localization system with i18n support for React Native apps
+ * i18n with namespace support for React Native apps
  */
 
 // Hooks
@@ -13,10 +13,11 @@ export { LanguageSwitcher } from './infrastructure/components/LanguageSwitcher';
 export { useLanguageNavigation } from './infrastructure/components/useLanguageNavigation';
 
 // Configuration
-export { default as i18n, addTranslationResources } from './infrastructure/config/i18n';
+export { default as i18n } from './infrastructure/config/i18n';
+export { I18nInitializer } from './infrastructure/config/I18nInitializer';
 export {
   SUPPORTED_LANGUAGES,
-  LANGUAGES, // Alias for SUPPORTED_LANGUAGES (backward compatibility)
+  LANGUAGES,
   DEFAULT_LANGUAGE,
   getLanguageByCode,
   isLanguageSupported,

package/src/infrastructure/config/I18nInitializer.ts

@@ -1,10 +1,8 @@
 /**
  * i18n Initializer
  *
- * Handles i18n configuration with namespace support
- * - Loads package translations
- * - Loads app translations (merges with package)
- * - Namespace-based organization (common, auth, etc.)
+ * Namespace-based i18n configuration
+ * Usage: t('namespace:key') e.g., t('common:cancel')
  */
 
 import i18n from 'i18next';
@@ -16,13 +14,20 @@ const DEFAULT_NAMESPACE = 'common';
 
 export class I18nInitializer {
   private static reactI18nextInitialized = false;
+  private static appTranslations: Record<string, any> = {};
 
   /**
-   * Build resources with package + app translations merged
+   * Register app translations (call before initialize)
+   */
+  static registerAppTranslations(translations: Record<string, any>): void {
+    this.appTranslations = translations;
+  }
+
+  /**
+   * Build resources with package + registered app translations
    */
   private static buildResources(): Record<string, Record<string, any>> {
     const packageTranslations = TranslationLoader.loadPackageTranslations();
-    const appTranslations = TranslationLoader.loadAppTranslations();
 
     const resources: Record<string, Record<string, any>> = {
       'en-US': {},
@@ -35,8 +40,8 @@ export class I18nInitializer {
       resources['en-US'][namespace] = translations;
     }
 
-    // Merge app namespaces (app overrides package)
-    for (const [namespace, translations] of Object.entries(appTranslations)) {
+    // Merge app translations (app overrides package)
+    for (const [namespace, translations] of Object.entries(this.appTranslations)) {
       if (resources['en-US'][namespace]) {
         resources['en-US'][namespace] = TranslationLoader.mergeTranslations(
           resources['en-US'][namespace],
@@ -52,12 +57,11 @@ export class I18nInitializer {
 
   private static getNamespaces(): string[] {
     const packageTranslations = TranslationLoader.loadPackageTranslations();
-    const appTranslations = TranslationLoader.loadAppTranslations();
-
     const enUSPackage = packageTranslations['en-US'] || {};
+
     const namespaces = new Set([
       ...Object.keys(enUSPackage),
-      ...Object.keys(appTranslations),
+      ...Object.keys(this.appTranslations),
     ]);
 
     if (!namespaces.has(DEFAULT_NAMESPACE)) {
@@ -106,9 +110,9 @@ export class I18nInitializer {
   }
 
   /**
-   * Add translation resources at runtime
+   * Add translations at runtime
    */
-  static addTranslationResources(
+  static addTranslations(
     languageCode: string,
     namespaceResources: Record<string, any>
   ): void {

package/src/infrastructure/config/TranslationLoader.ts

@@ -1,7 +1,7 @@
 /**
  * Translation Loader
  *
- * Loads translations from package and app
+ * Loads package translations
  */
 
 export class TranslationLoader {
@@ -19,30 +19,7 @@ export class TranslationLoader {
   }
 
   /**
-   * Load app translations from common paths
-   */
-  static loadAppTranslations(): Record<string, any> {
-    const paths = [
-      '@/domains/localization/infrastructure/locales/en-US',
-      './src/domains/localization/infrastructure/locales/en-US',
-      '../../../src/domains/localization/infrastructure/locales/en-US',
-    ];
-
-    for (const path of paths) {
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const translations = require(path);
-        return translations.default || translations;
-      } catch {
-        continue;
-      }
-    }
-
-    return {};
-  }
-
-  /**
-   * Deep merge translations (app overrides package)
+   * Deep merge translations (override wins)
    */
   static mergeTranslations(base: any, override: any): any {
     if (!override || Object.keys(override).length === 0) {

package/src/infrastructure/config/i18n.ts

@@ -1,14 +1,9 @@
 /**
- * i18n Configuration
+ * i18n Instance
  *
- * Auto-initializes i18n with namespace support
- * Usage: t('namespace:key') e.g., t('common:cancel')
+ * Raw i18n instance - use I18nInitializer for configuration
  */
 
-import { I18nInitializer } from './I18nInitializer';
 import i18n from 'i18next';
 
-I18nInitializer.initialize();
-
-export const addTranslationResources = I18nInitializer.addTranslationResources;
 export default i18n;