@umituz/react-native-localization 2.4.0 → 2.6.0

package/package.json

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

package/src/infrastructure/hooks/useTranslation.ts

@@ -5,22 +5,51 @@
  * - React i18next integration
  * - Direct i18n fallback
  * - Type-safe translation function
+ * - Auto-namespace detection from dot notation
  */
 
-import { useTranslation } from 'react-i18next';
 import i18n from '../config/i18n';
 
 /**
  * Hook for translation functionality
+ * Supports both formats:
+ * - t('namespace:key.subkey') - explicit namespace
+ * - t('namespace.key.subkey') - auto-detected namespace (first segment before dot)
  */
 export const useTranslationFunction = (): ((key: string, options?: any) => string) => {
-  // Use direct i18n.t for reliability (no React context issues)
   return (key: string, options?: any): string => {
-    if (i18n.isInitialized && typeof i18n.t === 'function') {
+    if (!i18n.isInitialized || typeof i18n.t !== 'function') {
+      return key;
+    }
+
+    // If key already has namespace separator (:), use as-is
+    if (key.includes(':')) {
       const result = i18n.t(key, options);
       return typeof result === 'string' ? result : String(result);
     }
-    // Final fallback: return key
-    return key;
+
+    // Auto-detect namespace from first dot segment
+    // e.g., 'settings.appearance.title' -> namespace: 'settings', key: 'appearance.title'
+    const firstDotIndex = key.indexOf('.');
+    if (firstDotIndex > 0) {
+      const potentialNamespace = key.substring(0, firstDotIndex);
+      const restOfKey = key.substring(firstDotIndex + 1);
+
+      // Check if this namespace exists in i18n resources
+      const hasNamespace = i18n.hasResourceBundle(i18n.language, potentialNamespace);
+
+      if (hasNamespace) {
+        const namespacedKey = `${potentialNamespace}:${restOfKey}`;
+        const result = i18n.t(namespacedKey, options);
+        // If translation found (not same as key), return it
+        if (result !== namespacedKey && result !== restOfKey) {
+          return typeof result === 'string' ? result : String(result);
+        }
+      }
+    }
+
+    // Fallback: try original key as-is
+    const result = i18n.t(key, options);
+    return typeof result === 'string' ? result : String(result);
   };
 };