@umituz/react-native-localization 1.0.0 → 1.2.0

package/lib/infrastructure/locales/zh-TW/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/locales/zh-TW/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAcH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASjB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/lib/infrastructure/locales/zh-TW/index.js

@@ -0,0 +1,43 @@
+/**
+ * Auto-generated translation loader for zh-TW
+ *
+ * This file is automatically generated by:
+ *   npm run localization:create-loaders
+ *
+ * DO NOT EDIT THIS FILE MANUALLY!
+ *
+ * Translation Modules:
+ * - branding: branding.json
+ * - datetime: datetime.json
+ * - errors: errors.json
+ * - flashcards: flashcards.json
+ * - general: general.json
+ * - navigation: navigation.json
+ * - onboarding: onboarding.json
+ * - settings: settings.json
+ *
+ * Generated: 2025-11-06T15:59:47.193Z
+ */
+// Import all translation modules
+import branding from './branding.json';
+import datetime from './datetime.json';
+import errors from './errors.json';
+import flashcards from './flashcards.json';
+import general from './general.json';
+import navigation from './navigation.json';
+import onboarding from './onboarding.json';
+import settings from './settings.json';
+// Merge all modules into a single translation object
+// Using nested structure for better namespace organization
+const translations = {
+    branding,
+    datetime,
+    errors,
+    flashcards,
+    general,
+    navigation,
+    onboarding,
+    settings,
+};
+export default translations;
+//# sourceMappingURL=index.js.map

package/lib/infrastructure/locales/zh-TW/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/infrastructure/locales/zh-TW/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iCAAiC;AACjC,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,MAAM,MAAM,eAAe,CAAC;AACnC,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAC3C,OAAO,OAAO,MAAM,gBAAgB,CAAC;AACrC,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAC3C,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAC3C,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,qDAAqD;AACrD,2DAA2D;AAC3D,MAAM,YAAY,GAAG;IACnB,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,UAAU;IACV,OAAO;IACP,UAAU;IACV,UAAU;IACV,QAAQ;CACT,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/lib/infrastructure/locales/zh-TW/navigation.json

@@ -0,0 +1,58 @@
+{
+    "home": "家",
+    "settings": "設定",
+    "about": "關於",
+    "back": "後退",
+    "explore": "探索",
+    "search": "搜尋",
+    "favorites": "收藏夾",
+    "activity": "活動",
+    "discover": "發現",
+    "library": "圖書館",
+    "stats": "統計數據",
+    "wellness": "健康",
+    "exercises": "練習",
+    "nutrition": "營養",
+    "progress": "進步",
+    "workouts": "鍛煉",
+    "dashboard": "儀表板",
+    "calendar": "日曆",
+    "tasks": "任務",
+    "notes": "筆記",
+    "projects": "專案",
+    "goals": "目標",
+    "habits": "習慣",
+    "budget": "預算",
+    "expenses": "開支",
+    "income": "收入",
+    "accounts": "賬戶",
+    "reports": "報告",
+    "courses": "課程",
+    "lessons": "教訓",
+    "practice": "實踐",
+    "learning": "學習",
+    "meditation": "冥想",
+    "journal": "雜誌",
+    "timer": "計時器",
+    "tracking": "追踪",
+    "analytics": "分析",
+    "community": "社區",
+    "feed": "餵養",
+    "browse": "瀏覽",
+    "categories": "類別",
+    "saved": "已保存",
+    "history": "歷史",
+    "achievements": "成就",
+    "leaderboard": "排行榜",
+    "challenges": "挑戰",
+    "rewards": "獎勵",
+    "today": "今天",
+    "medicines": "藥物",
+    "adherence": "依從性",
+    "decks": "甲板",
+    "cards": "牌",
+    "study": "學習",
+    "decksDescription": "Organize and manage your flashcard decks",
+    "cardsDescription": "View and edit all your flashcards",
+    "studyDescription": "Practice with spaced repetition system"
+}

package/lib/infrastructure/locales/zh-TW/onboarding.json

@@ -0,0 +1,76 @@
+{
+    "skip": "跳過",
+    "getStarted": "開始使用",
+    "welcome": {
+        "title": "歡迎！",
+        "subtitle": "您的旅程從這裡開始",
+        "getStarted": "開始使用",
+        "skip": "跳過"
+    },
+    "slides": {
+        "slide1": {
+            "title": "發現驚人的功能",
+            "description": "探索我們的應用程序提供的一切"
+        },
+        "slide2": {
+            "title": "保持井井有條",
+            "description": "跟踪最重要的事情"
+        },
+        "slide3": {
+            "title": "實現你的目標",
+            "description": "我們隨時幫助您取得成功"
+        }
+    },
+    "permissions": {
+        "title": "權限",
+        "subtitle": "我們需要一些權限才能提供最佳體驗",
+        "location": {
+            "title": "地點",
+            "description": "提供基於位置的功能",
+            "enable": "啟用位置"
+        },
+        "camera": {
+            "title": "相機",
+            "description": "拍照並掃描文件",
+            "enable": "啟用相機"
+        },
+        "photos": {
+            "title": "照片",
+            "description": "訪問您的照片庫",
+            "enable": "啟用照片"
+        },
+        "later": "我稍後會做這個",
+        "continue": "繼續"
+    },
+    "personalization": {
+        "title": "個性化您的體驗",
+        "subtitle": "告訴我們你自己",
+        "goals": {
+            "title": "你的目標是什麼？",
+            "options": [
+                "保持健康",
+                "保持高效",
+                "學習新技能",
+                "與他人聯繫",
+                "玩得開心"
+            ]
+        },
+        "preferences": {
+            "title": "設置您的偏好",
+            "theme": "選擇主題",
+            "language": "選擇語言"
+        },
+        "continue": "繼續"
+    },
+    "complete": {
+        "title": "一切就緒！",
+        "subtitle": "讓我們開始吧！",
+        "startButton": "開始使用應用程序"
+    },
+    "navigation": {
+        "next": "下一個",
+        "back": "後退",
+        "skip": "跳過",
+        "done": "完畢"
+    }
+}

package/lib/infrastructure/locales/zh-TW/settings.json

@@ -0,0 +1,53 @@
+{
+    "lightMode": "燈光模式",
+    "darkMode": "深色模式",
+    "language": "語言",
+    "aboutDescription": "應用程序信息和版本",
+    "about": {
+        "title": "關於",
+        "description": "應用程序信息和版本",
+        "appVersion": "應用程序版本",
+        "moreApps": "更多應用程序",
+        "moreAppsDescription": "查看我們的其他應用程序",
+        "contactEmail": "聯繫郵箱",
+        "website": "網站"
+    },
+    "disclaimer": {
+        "title": "健康免責聲明",
+        "shortMessage": "點擊即可閱讀重要健康信息",
+        "message": "此應用程序僅用於提供信息和健康支持目的。它不能替代專業的醫療或心理保健。\n\n如果您遇到健康危機或緊急情況，請立即聯繫當地的緊急服務機構或醫療保健提供者。\n\n請務必諮詢合格的醫療保健專業人員以獲得醫療建議、診斷或治療。此應用程序中的內容不應用作專業醫學判斷的替代品。\n\n您的隱私很重要。除非您明確選擇共享，否則所有數據在您的設備上均保持私密狀態。"
+    },
+    "legal": {
+        "title": "合法的",
+        "description": "隱私政策、使用條款和 EULA",
+        "privacy": "隱私政策",
+        "privacyDescription": "我們如何處理您的數據",
+        "terms": "使用條款",
+        "termsDescription": "條款和條件",
+        "eula": "最終用戶許可協議",
+        "eulaDescription": "許可協議"
+    },
+    "version": {
+        "title": "應用程序版本"
+    },
+    "languageSelection": {
+        "title": "選擇語言",
+        "description": "選擇您的首選語言",
+        "currentLanguage": "當前語言",
+        "searchPlaceholder": "搜索語言"
+    },
+    "appearance": {
+        "title": "外貌",
+        "darkMode": "深色模式",
+        "darkTheme": "黑暗主題",
+        "lightTheme": "淺色主題",
+        "themeDescription": "語言和主題設置"
+    },
+    "notifications": {
+        "title": "通知",
+        "description": "管理通知首選項",
+        "enableNotifications": "啟用通知",
+        "notificationPermission": "通知權限",
+        "notificationPermissionDescription": "允許應用發送通知"
+    }
+}

package/lib/infrastructure/storage/AsyncStorageWrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncStorageWrapper.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/AsyncStorageWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX,eAAO,MAAM,cAAc;mBACJ,MAAM,gBAAgB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;mBAU9C,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO3D,CAAC"}
+{"version":3,"file":"AsyncStorageWrapper.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/AsyncStorageWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX,eAAO,MAAM,cAAc;mBACJ,MAAM,gBAAgB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;mBAW9C,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ3D,CAAC"}

package/lib/infrastructure/storage/AsyncStorageWrapper.js

@@ -13,7 +13,9 @@ export const StorageWrapper = {
             return value ?? defaultValue;
         }
         catch (error) {
-            console.warn('[Localization] Failed to get storage value:', error);
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.warn('[Localization] Failed to get storage value:', error);
             return defaultValue;
         }
     },
@@ -22,7 +24,9 @@ export const StorageWrapper = {
             await AsyncStorage.setItem(key, value);
         }
         catch (error) {
-            console.warn('[Localization] Failed to set storage value:', error);
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.warn('[Localization] Failed to set storage value:', error);
         }
     },
 };

package/lib/infrastructure/storage/AsyncStorageWrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncStorageWrapper.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/AsyncStorageWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,YAAY,MAAM,2CAA2C,CAAC;AAErE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,wBAAwB;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,YAAoB;QAC/C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,OAAO,KAAK,IAAI,YAAY,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YACnE,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAa;QACxC,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"AsyncStorageWrapper.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/AsyncStorageWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,YAAY,MAAM,2CAA2C,CAAC;AAErE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,wBAAwB;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,YAAoB;QAC/C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,OAAO,KAAK,IAAI,YAAY,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,IAAI,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YAChF,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAa;QACxC,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,IAAI,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/infrastructure/storage/LocalizationStore.d.ts

@@ -1,8 +1,13 @@
 /**
  * Localization Store
  * Zustand state management for language preferences with AsyncStorage persistence
+ *
+ * REFACTORED: Now uses centralized AsyncStorageWrapper for DRY compliance
+ * - Eliminates duplicate AsyncStorage calls
+ * - Consistent error handling and logging
+ * - Type-safe storage operations
  */
-import type { Language } from '../../domain/repositories/ILocalizationRepository';
+import type { Language } from "../../domain/repositories/ILocalizationRepository";
 interface LocalizationState {
     currentLanguage: string;
     isRTL: boolean;
@@ -17,7 +22,7 @@ export declare const useLocalizationStore: import("zustand").UseBoundStore<impor
  * Provides current language, RTL state, language switching, and translation function
  */
 export declare const useLocalization: () => {
-    t: any;
+    t: (key: string, options?: any) => string;
     currentLanguage: string;
     currentLanguageObject: Language;
     isRTL: boolean;

package/lib/infrastructure/storage/LocalizationStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalizationStore.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/LocalizationStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mDAAmD,CAAC;AAElF,UAAU,iBAAiB;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,QAAQ,EAAE,CAAC;IAC/B,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,oBAAoB,gFAqE9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;gCA/EE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;sBAClC,OAAO,CAAC,IAAI,CAAC;CAoGhC,CAAC"}
+{"version":3,"file":"LocalizationStore.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/LocalizationStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mDAAmD,CAAC;AAElF,UAAU,iBAAiB;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,QAAQ,EAAE,CAAC;IAC/B,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,oBAAoB,gFAqJ9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,eAAe;aAaV,MAAM,YAAY,GAAG,KAAG,MAAM;;;;;;gCA5KlB,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;sBAClC,OAAO,CAAC,IAAI,CAAC;CA+LhC,CAAC"}

package/lib/infrastructure/storage/LocalizationStore.js

@@ -1,11 +1,16 @@
 /**
  * Localization Store
  * Zustand state management for language preferences with AsyncStorage persistence
+ *
+ * REFACTORED: Now uses centralized AsyncStorageWrapper for DRY compliance
+ * - Eliminates duplicate AsyncStorage calls
+ * - Consistent error handling and logging
+ * - Type-safe storage operations
  */
-import { create } from 'zustand';
-import { StorageWrapper, STORAGE_KEYS } from './AsyncStorageWrapper';
-import i18n from '../config/i18n';
-import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE, getLanguageByCode, getDeviceLocale } from '../config/languages';
+import { create } from "zustand";
+import { StorageWrapper, STORAGE_KEYS } from "./AsyncStorageWrapper";
+import i18n from "../config/i18n";
+import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE, getLanguageByCode, getDeviceLocale, } from "../config/languages";
 export const useLocalizationStore = create((set, get) => ({
     currentLanguage: DEFAULT_LANGUAGE,
     isRTL: false,
@@ -19,35 +24,99 @@ export const useLocalizationStore = create((set, get) => ({
      * - Fallback: English (en-US) if device locale not supported
      */
     initialize: async () => {
-        // ✅ CRITICAL FIX: Don't reset isInitialized if already initialized
-        // This prevents UI flash on re-initialization
-        const { isInitialized: alreadyInitialized } = get();
-        if (alreadyInitialized)
-            return;
-        // Get saved language preference
-        const savedLanguage = await StorageWrapper.getString(STORAGE_KEYS.LANGUAGE, DEFAULT_LANGUAGE);
-        // ✅ DEVICE LOCALE DETECTION: Use device locale on first launch
-        let languageCode;
-        if (savedLanguage && savedLanguage !== DEFAULT_LANGUAGE) {
-            // User has previously selected a language → Use their choice
-            languageCode = savedLanguage;
+        try {
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.log("[LocalizationStore] Starting initialization...");
+            // ✅ CRITICAL FIX: Don't reset isInitialized if already initialized
+            // This prevents UI flash on re-initialization
+            const { isInitialized: alreadyInitialized } = get();
+            if (alreadyInitialized) {
+                /* eslint-disable-next-line no-console */
+                if (__DEV__)
+                    console.log("[LocalizationStore] Already initialized, skipping");
+                return;
+            }
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.log("[LocalizationStore] Getting saved language preference...");
+            // ✅ Get saved language preference (returns null if not exists)
+            const savedLanguage = await StorageWrapper.getString(STORAGE_KEYS.LANGUAGE, DEFAULT_LANGUAGE);
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.log("[LocalizationStore] Saved language:", savedLanguage);
+            // ✅ DEVICE LOCALE DETECTION: Use device locale on first launch
+            let languageCode;
+            if (savedLanguage && savedLanguage !== DEFAULT_LANGUAGE) {
+                // User has previously selected a language → Use their choice
+                languageCode = savedLanguage;
+                /* eslint-disable-next-line no-console */
+                if (__DEV__)
+                    console.log("[LocalizationStore] Using saved language:", languageCode);
+            }
+            else {
+                /* eslint-disable-next-line no-console */
+                if (__DEV__)
+                    console.log("[LocalizationStore] First launch, detecting device locale...");
+                // First launch → Detect device locale automatically
+                languageCode = getDeviceLocale();
+                /* eslint-disable-next-line no-console */
+                if (__DEV__)
+                    console.log("[LocalizationStore] Detected device locale:", languageCode);
+                // Save detected locale for future launches
+                await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
+            }
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.log("[LocalizationStore] Validating language code...");
+            // ✅ DEFENSIVE: Validate language exists, fallback to default
+            const language = getLanguageByCode(languageCode);
+            const finalLanguage = language ? languageCode : DEFAULT_LANGUAGE;
+            const finalLanguageObj = getLanguageByCode(finalLanguage);
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.log("[LocalizationStore] Final language:", finalLanguage);
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.log("[LocalizationStore] Changing i18n language...");
+            // Only change language if i18n is available
+            if (i18n && typeof i18n.changeLanguage === "function") {
+                await i18n.changeLanguage(finalLanguage);
+                /* eslint-disable-next-line no-console */
+                if (__DEV__)
+                    console.log("[LocalizationStore] i18n language changed");
+            }
+            else {
+                /* eslint-disable-next-line no-console */
+                if (__DEV__)
+                    console.warn("[LocalizationStore] i18n not available, skipping language change");
+            }
+            set({
+                currentLanguage: finalLanguage,
+                isRTL: finalLanguageObj?.rtl || false,
+                isInitialized: true, // ✅ Always set true to unblock UI
+            });
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.log("[LocalizationStore] Initialization completed successfully");
         }
-        else {
-            // First launch → Detect device locale automatically
-            languageCode = getDeviceLocale();
-            // Save detected locale for future launches
-            await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
+        catch (error) {
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.error("[LocalizationStore] Initialization error:", error);
+            /* eslint-disable-next-line no-console */
+            if (__DEV__)
+                console.error("[LocalizationStore] Error details:", {
+                    message: error instanceof Error ? error.message : String(error),
+                    stack: error instanceof Error ? error.stack : "No stack",
+                    name: error instanceof Error ? error.name : "Unknown",
+                });
+            // Set initialized even on error to prevent blocking UI
+            set({
+                isInitialized: true,
+            });
+            throw error;
         }
-        // ✅ DEFENSIVE: Validate language exists, fallback to default
-        const language = getLanguageByCode(languageCode);
-        const finalLanguage = language ? languageCode : DEFAULT_LANGUAGE;
-        const finalLanguageObj = getLanguageByCode(finalLanguage);
-        await i18n.changeLanguage(finalLanguage);
-        set({
-            currentLanguage: finalLanguage,
-            isRTL: finalLanguageObj?.rtl || false,
-            isInitialized: true, // ✅ Always set true to unblock UI
-        });
     },
     /**
      * Change language
@@ -58,14 +127,16 @@ export const useLocalizationStore = create((set, get) => ({
         // ✅ DEFENSIVE: Early return if unsupported language
         if (!language)
             return;
-        // Update i18n
-        await i18n.changeLanguage(languageCode);
+        // Update i18n (only if available)
+        if (i18n && typeof i18n.changeLanguage === "function") {
+            await i18n.changeLanguage(languageCode);
+        }
         // Update state
         set({
             currentLanguage: languageCode,
             isRTL: language.rtl || false,
         });
-        // Persist language preference
+        // ✅ DRY: Single line replaces try/catch/logging
         await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
     },
 }));
@@ -76,8 +147,18 @@ export const useLocalizationStore = create((set, get) => ({
 export const useLocalization = () => {
     const { currentLanguage, isRTL, isInitialized, supportedLanguages, setLanguage, initialize, } = useLocalizationStore();
     const currentLanguageObject = getLanguageByCode(currentLanguage);
+    // Safe translation function - returns key if i18n not available
+    const t = (key, options) => {
+        if (i18n && typeof i18n.t === "function") {
+            const result = i18n.t(key, options);
+            // i18n.t can return string or object, ensure we return string
+            return typeof result === "string" ? result : key;
+        }
+        // Fallback: return key if i18n not available
+        return key;
+    };
     return {
-        t: i18n.t.bind(i18n), // Translation function
+        t,
         currentLanguage,
         currentLanguageObject,
         isRTL,

package/lib/infrastructure/storage/LocalizationStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalizationStore.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/LocalizationStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LocalizationStore.js","sourceRoot":"","sources":["../../../src/infrastructure/storage/LocalizationStore.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-localization",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Universal localization system for React Native apps with i18n support",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -11,9 +11,15 @@
     "clean": "rm -rf lib",
     "prebuild": "npm run clean",
     "prepublishOnly": "npm run build",
+    "locales:generate": "node scripts/createLocaleLoaders.js",
+    "locales:generate:lang": "node scripts/createLocaleLoaders.js",
     "version:patch": "npm version patch -m 'chore: release v%s'",
     "version:minor": "npm version minor -m 'chore: release v%s'",
-    "version:major": "npm version major -m 'chore: release v%s'"
+    "version:major": "npm version major -m 'chore: release v%s'",
+    "i18n:setup": "node scripts/setup-languages.js",
+    "i18n:translate": "node scripts/translate-missing.js",
+    "i18n:check": "node scripts/check-translations.js",
+    "i18n:remove-unused": "node scripts/remove-unused-keys.js"
   },
   "keywords": [
     "react-native",
@@ -58,6 +64,7 @@
   "files": [
     "lib",
     "src",
+    "scripts",
     "README.md",
     "LICENSE"
   ]