@umituz/react-native-localization 1.2.0 → 1.2.1

package/lib/infrastructure/storage/LocalizationStore.js

@@ -1,16 +1,11 @@
 /**
  * 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,
@@ -24,99 +19,35 @@ export const useLocalizationStore = create((set, get) => ({
      * - Fallback: English (en-US) if device locale not supported
      */
     initialize: async () => {
-        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");
+        // ✅ 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;
         }
-        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;
+        else {
+            // First launch → Detect device locale automatically
+            languageCode = getDeviceLocale();
+            // Save detected locale for future launches
+            await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
         }
+        // ✅ 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
@@ -127,16 +58,14 @@ export const useLocalizationStore = create((set, get) => ({
         // ✅ DEFENSIVE: Early return if unsupported language
         if (!language)
             return;
-        // Update i18n (only if available)
-        if (i18n && typeof i18n.changeLanguage === "function") {
-            await i18n.changeLanguage(languageCode);
-        }
+        // Update i18n
+        await i18n.changeLanguage(languageCode);
         // Update state
         set({
             currentLanguage: languageCode,
             isRTL: language.rtl || false,
         });
-        // ✅ DRY: Single line replaces try/catch/logging
+        // Persist language preference
         await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
     },
 }));
@@ -147,18 +76,8 @@ 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,
+        t: i18n.t.bind(i18n), // Translation function
         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.2.0",
+  "version": "1.2.1",
   "description": "Universal localization system for React Native apps with i18n support",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -37,15 +37,17 @@
     "type": "git",
     "url": "https://github.com/umituz/react-native-localization"
   },
-  "peerDependencies": {
-    "react": ">=18.2.0",
-    "react-native": ">=0.74.0",
-    "zustand": "^5.0.2",
+  "dependencies": {
     "i18next": "^23.0.0",
     "react-i18next": "^14.0.0",
+    "zustand": "^5.0.2",
     "expo-localization": "~15.0.0",
     "@react-native-async-storage/async-storage": "^1.21.0"
   },
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-native": ">=0.74.0"
+  },
   "devDependencies": {
     "typescript": "^5.3.3",
     "@types/react": "^18.2.45",

package/src/infrastructure/config/i18n.ts

@@ -1,225 +1,57 @@
 /**
  * i18next Configuration
  * Nested translation structure - common translations spread, domain translations nested
- * 
- * CRITICAL: Package must be installed for i18n to work
- * If package is not installed, i18n will gracefully degrade
  */
 
-import i18n from "i18next";
-import { initReactI18next } from "react-i18next";
-import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE } from "./languages";
-
-/**
- * Check if required dependencies are available
- */
-const checkDependencies = (): boolean => {
-  try {
-    // Check if i18next and react-i18next are available
-    if (!i18n || !initReactI18next) {
-      /* eslint-disable-next-line no-console */
-      if (__DEV__) console.warn("[i18n] Required dependencies not found. i18n will not work.");
-      return false;
-    }
-    return true;
-  } catch (error) {
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.warn("[i18n] Error checking dependencies:", error);
-    return false;
-  }
-};
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import { SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE } from './languages';
 
 /**
  * Import all translations from modular folder structure
  * Each locale has an index.ts that merges all JSON files
  *
- * Structure:
+ * Structure (OFFLINE-ONLY):
  * locales/
  *   en-US/  (universal translations in localization domain)
- *     index.ts (merges branding.json, datetime.json, errors.json, flashcards.json, general.json, navigation.json, onboarding.json, settings.json)
- *   tr-TR/
- *     index.ts (merges all translation modules)
- *   ... (all 39 languages)
+ *     index.ts (merges common.json, navigation.json, settings.json, onboarding.json, errors.json)
+ *
+ * All translations are offline-compatible and work without backend.
  */
 
-// Import all locale translations
-import arSA from "../locales/ar-SA";
-import bgBG from "../locales/bg-BG";
-import csCZ from "../locales/cs-CZ";
-import daDK from "../locales/da-DK";
-import deDE from "../locales/de-DE";
-import elGR from "../locales/el-GR";
-import enAU from "../locales/en-AU";
-import enCA from "../locales/en-CA";
-import enGB from "../locales/en-GB";
-import enUS from "../locales/en-US";
-import esES from "../locales/es-ES";
-import esMX from "../locales/es-MX";
-import fiFI from "../locales/fi-FI";
-import frCA from "../locales/fr-CA";
-import frFR from "../locales/fr-FR";
-import hiIN from "../locales/hi-IN";
-import hrHR from "../locales/hr-HR";
-import huHU from "../locales/hu-HU";
-import idID from "../locales/id-ID";
-import itIT from "../locales/it-IT";
-import jaJP from "../locales/ja-JP";
-import koKR from "../locales/ko-KR";
-import msMY from "../locales/ms-MY";
-import nlNL from "../locales/nl-NL";
-import noNO from "../locales/no-NO";
-import plPL from "../locales/pl-PL";
-import ptBR from "../locales/pt-BR";
-import ptPT from "../locales/pt-PT";
-import roRO from "../locales/ro-RO";
-import ruRU from "../locales/ru-RU";
-import skSK from "../locales/sk-SK";
-import svSE from "../locales/sv-SE";
-import thTH from "../locales/th-TH";
-import tlPH from "../locales/tl-PH";
-import trTR from "../locales/tr-TR";
-import ukUA from "../locales/uk-UA";
-import viVN from "../locales/vi-VN";
-import zhCN from "../locales/zh-CN";
-import zhTW from "../locales/zh-TW";
+// Import universal translations from localization domain
+import localizationEnUS from '../locales/en-US';
 
 /**
  * Translation Resources
- * All 39 supported languages loaded
  * Nested structure - domain-based organization with direct key access
- * Example: settings.theme.title, onboarding.welcome.title, flashcards.home.welcome
+ * Example: settings.theme.title, onboarding.welcome.title
  */
 const resources = {
-  "ar-SA": { translation: arSA },
-  "bg-BG": { translation: bgBG },
-  "cs-CZ": { translation: csCZ },
-  "da-DK": { translation: daDK },
-  "de-DE": { translation: deDE },
-  "el-GR": { translation: elGR },
-  "en-AU": { translation: enAU },
-  "en-CA": { translation: enCA },
-  "en-GB": { translation: enGB },
-  "en-US": { translation: enUS },
-  "es-ES": { translation: esES },
-  "es-MX": { translation: esMX },
-  "fi-FI": { translation: fiFI },
-  "fr-CA": { translation: frCA },
-  "fr-FR": { translation: frFR },
-  "hi-IN": { translation: hiIN },
-  "hr-HR": { translation: hrHR },
-  "hu-HU": { translation: huHU },
-  "id-ID": { translation: idID },
-  "it-IT": { translation: itIT },
-  "ja-JP": { translation: jaJP },
-  "ko-KR": { translation: koKR },
-  "ms-MY": { translation: msMY },
-  "nl-NL": { translation: nlNL },
-  "no-NO": { translation: noNO },
-  "pl-PL": { translation: plPL },
-  "pt-BR": { translation: ptBR },
-  "pt-PT": { translation: ptPT },
-  "ro-RO": { translation: roRO },
-  "ru-RU": { translation: ruRU },
-  "sk-SK": { translation: skSK },
-  "sv-SE": { translation: svSE },
-  "th-TH": { translation: thTH },
-  "tl-PH": { translation: tlPH },
-  "tr-TR": { translation: trTR },
-  "uk-UA": { translation: ukUA },
-  "vi-VN": { translation: viVN },
-  "zh-CN": { translation: zhCN },
-  "zh-TW": { translation: zhTW },
+  'en-US': {
+    translation: {
+      ...localizationEnUS,
+    },
+  },
 };
 
 /**
  * Initialize i18next
- * Deferred initialization to avoid React Native renderer conflicts
- * Only initializes if dependencies are available
  */
-let isInitialized = false;
-
-const initializeI18n = () => {
-  if (isInitialized) return;
-
-  // Check if dependencies are available
-  if (!checkDependencies()) {
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.warn("[i18n] Dependencies not available. Skipping initialization.");
-    return;
-  }
+i18n.use(initReactI18next).init({
+  resources,
+  lng: DEFAULT_LANGUAGE,
+  fallbackLng: DEFAULT_LANGUAGE,
 
-  try {
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] Initializing i18next...");
-    /* eslint-disable-next-line no-console */
-    if (__DEV__)
-      console.log("[i18n] Resources count:", Object.keys(resources).length);
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] Default language:", DEFAULT_LANGUAGE);
+  interpolation: {
+    escapeValue: false, // React already escapes values
+  },
 
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] Checking initReactI18next...");
-    if (!initReactI18next) {
-      throw new Error("initReactI18next is undefined");
-    }
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] initReactI18next found");
-
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] Using initReactI18next...");
-    i18n.use(initReactI18next);
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] initReactI18next applied");
-
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] Calling i18n.init...");
-    i18n.init({
-      resources,
-      lng: DEFAULT_LANGUAGE,
-      fallbackLng: DEFAULT_LANGUAGE,
-
-      interpolation: {
-        escapeValue: false, // React already escapes values
-      },
-
-      react: {
-        useSuspense: false, // Disable suspense for React Native
-      },
-
-      compatibilityJSON: "v4", // Use i18next v4 JSON format
-    });
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] i18n.init completed");
-
-    isInitialized = true;
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.log("[i18n] i18next initialized successfully");
-  } catch (error) {
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.error("[i18n] Initialization error:", error);
-    /* eslint-disable-next-line no-console */
-    if (__DEV__)
-      console.error("[i18n] 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",
-      });
-    // Don't throw - allow app to continue without i18n
-    /* eslint-disable-next-line no-console */
-    if (__DEV__) console.warn("[i18n] Continuing without i18n initialization");
-  }
-};
+  react: {
+    useSuspense: false, // Disable suspense for React Native
+  },
 
-// Defer initialization until React is ready
-// React Native doesn't have window, so we check for global
-if (typeof global !== "undefined") {
-  // Use setTimeout to defer initialization
-  setTimeout(() => {
-    initializeI18n();
-  }, 0);
-} else {
-  // Fallback: initialize immediately
-  initializeI18n();
-}
+  compatibilityJSON: 'v4', // Use i18next v4 JSON format
+});
 
 export default i18n;

package/src/infrastructure/config/languages.ts

@@ -15,7 +15,7 @@
 
 import * as Localization from 'expo-localization';
 import { LANGUAGES } from './languagesData';
-import type { Language } from '../../domain/repositories/ILocalizationRepository';
+import { Language } from '../../domain/repositories/ILocalizationRepository';
 
 // Single source of truth for supported languages
 export const SUPPORTED_LANGUAGES: Language[] = LANGUAGES;
@@ -211,8 +211,7 @@ export const getDefaultLanguage = (): Language => {
 export const getDeviceLocale = (): string => {
   try {
     // Get device locale (e.g., "en-US", "tr-TR", or just "en")
-    const locales = Localization.getLocales();
-    const deviceLocale = locales[0]?.languageTag;
+    const deviceLocale = Localization.locale;
 
     if (!deviceLocale) {
       return DEFAULT_LANGUAGE;
@@ -240,6 +239,7 @@ export const getDeviceLocale = (): string => {
     return DEFAULT_LANGUAGE;
   } catch (error) {
     // If any error occurs, fallback to default
+    console.warn('[Localization] Failed to detect device locale:', error);
     return DEFAULT_LANGUAGE;
   }
 };

package/src/infrastructure/config/languagesData.ts

@@ -1,39 +1,71 @@
 /**
- * Languages Data
- * Complete list of supported languages with metadata
+ * Language Configuration
+ * Strategic language support with 29 languages (top revenue markets only)
+ * Optimized for maximum monetization with minimal maintenance cost
+ * Generated from App Factory language_config.yaml
  */
 
-import type { Language } from '../../domain/repositories/ILocalizationRepository';
+export interface Language {
+  code: string;
+  name: string;
+  nativeName: string;
+  flag: string;
+}
 
 export const LANGUAGES: Language[] = [
-  { code: 'ar-SA', name: 'Arabic', nativeName: 'العربية', flag: '🇸🇦', rtl: true },
-  { code: 'bg-BG', name: 'Bulgarian', nativeName: 'Български', flag: '🇧🇬', rtl: false },
-  { code: 'cs-CZ', name: 'Czech', nativeName: 'Čeština', flag: '🇨🇿', rtl: false },
-  { code: 'da-DK', name: 'Danish', nativeName: 'Dansk', flag: '🇩🇰', rtl: false },
-  { code: 'de-DE', name: 'German', nativeName: 'Deutsch', flag: '🇩🇪', rtl: false },
-  { code: 'en-US', name: 'English', nativeName: 'English', flag: '🇺🇸', rtl: false },
-  { code: 'es-ES', name: 'Spanish', nativeName: 'Español', flag: '🇪🇸', rtl: false },
-  { code: 'fi-FI', name: 'Finnish', nativeName: 'Suomi', flag: '🇫🇮', rtl: false },
-  { code: 'fr-FR', name: 'French', nativeName: 'Français', flag: '🇫🇷', rtl: false },
-  { code: 'hi-IN', name: 'Hindi', nativeName: 'हिन्दी', flag: '🇮🇳', rtl: false },
-  { code: 'hu-HU', name: 'Hungarian', nativeName: 'Magyar', flag: '🇭🇺', rtl: false },
-  { code: 'id-ID', name: 'Indonesian', nativeName: 'Bahasa Indonesia', flag: '🇮🇩', rtl: false },
-  { code: 'it-IT', name: 'Italian', nativeName: 'Italiano', flag: '🇮🇹', rtl: false },
-  { code: 'ja-JP', name: 'Japanese', nativeName: '日本語', flag: '🇯🇵', rtl: false },
-  { code: 'ko-KR', name: 'Korean', nativeName: '한국어', flag: '🇰🇷', rtl: false },
-  { code: 'ms-MY', name: 'Malay', nativeName: 'Bahasa Melayu', flag: '🇲🇾', rtl: false },
-  { code: 'nl-NL', name: 'Dutch', nativeName: 'Nederlands', flag: '🇳🇱', rtl: false },
-  { code: 'no-NO', name: 'Norwegian', nativeName: 'Norsk', flag: '🇳🇴', rtl: false },
-  { code: 'pl-PL', name: 'Polish', nativeName: 'Polski', flag: '🇵🇱', rtl: false },
-  { code: 'pt-PT', name: 'Portuguese', nativeName: 'Português', flag: '🇵🇹', rtl: false },
-  { code: 'ro-RO', name: 'Romanian', nativeName: 'Română', flag: '🇷🇴', rtl: false },
-  { code: 'ru-RU', name: 'Russian', nativeName: 'Русский', flag: '🇷🇺', rtl: false },
-  { code: 'sv-SE', name: 'Swedish', nativeName: 'Svenska', flag: '🇸🇪', rtl: false },
-  { code: 'th-TH', name: 'Thai', nativeName: 'ไทย', flag: '🇹🇭', rtl: false },
-  { code: 'tl-PH', name: 'Filipino', nativeName: 'Filipino', flag: '🇵🇭', rtl: false },
-  { code: 'tr-TR', name: 'Turkish', nativeName: 'Türkçe', flag: '🇹🇷', rtl: false },
-  { code: 'uk-UA', name: 'Ukrainian', nativeName: 'Українська', flag: '🇺🇦', rtl: false },
-  { code: 'vi-VN', name: 'Vietnamese', nativeName: 'Tiếng Việt', flag: '🇻🇳', rtl: false },
-  { code: 'zh-CN', name: 'Chinese (Simplified)', nativeName: '简体中文', flag: '🇨🇳', rtl: false },
+  { code: 'ar-SA', name: 'Arabic', nativeName: 'العربية', flag: '🇸🇦' },
+  { code: 'bg-BG', name: 'Bulgarian', nativeName: 'Български', flag: '🇧🇬' },
+  { code: 'cs-CZ', name: 'Czech', nativeName: 'Čeština', flag: '🇨🇿' },
+  { code: 'da-DK', name: 'Danish', nativeName: 'Dansk', flag: '🇩🇰' },
+  { code: 'de-DE', name: 'German', nativeName: 'Deutsch', flag: '🇩🇪' },
+  { code: 'en-US', name: 'English', nativeName: 'English', flag: '🇺🇸' },
+  { code: 'es-ES', name: 'Spanish', nativeName: 'Español', flag: '🇪🇸' },
+  { code: 'fi-FI', name: 'Finnish', nativeName: 'Suomi', flag: '🇫🇮' },
+  { code: 'fr-FR', name: 'French', nativeName: 'Français', flag: '🇫🇷' },
+  { code: 'hi-IN', name: 'Hindi', nativeName: 'हिन्दी', flag: '🇮🇳' },
+  { code: 'hu-HU', name: 'Hungarian', nativeName: 'Magyar', flag: '🇭🇺' },
+  { code: 'id-ID', name: 'Indonesian', nativeName: 'Bahasa Indonesia', flag: '🇮🇩' },
+  { code: 'it-IT', name: 'Italian', nativeName: 'Italiano', flag: '🇮🇹' },
+  { code: 'ja-JP', name: 'Japanese', nativeName: '日本語', flag: '🇯🇵' },
+  { code: 'ko-KR', name: 'Korean', nativeName: '한국어', flag: '🇰🇷' },
+  { code: 'ms-MY', name: 'Malay', nativeName: 'Bahasa Melayu', flag: '🇲🇾' },
+  { code: 'nl-NL', name: 'Dutch', nativeName: 'Nederlands', flag: '🇳🇱' },
+  { code: 'no-NO', name: 'Norwegian', nativeName: 'Norsk', flag: '🇳🇴' },
+  { code: 'pl-PL', name: 'Polish', nativeName: 'Polski', flag: '🇵🇱' },
+  { code: 'pt-PT', name: 'Portuguese', nativeName: 'Português', flag: '🇵🇹' },
+  { code: 'ro-RO', name: 'Romanian', nativeName: 'Română', flag: '🇷🇴' },
+  { code: 'ru-RU', name: 'Russian', nativeName: 'Русский', flag: '🇷🇺' },
+  { code: 'sv-SE', name: 'Swedish', nativeName: 'Svenska', flag: '🇸🇪' },
+  { code: 'th-TH', name: 'Thai', nativeName: 'ไทย', flag: '🇹🇭' },
+  { code: 'tl-PH', name: 'Filipino', nativeName: 'Filipino', flag: '🇵🇭' },
+  { code: 'tr-TR', name: 'Turkish', nativeName: 'Türkçe', flag: '🇹🇷' },
+  { code: 'uk-UA', name: 'Ukrainian', nativeName: 'Українська', flag: '🇺🇦' },
+  { code: 'vi-VN', name: 'Vietnamese', nativeName: 'Tiếng Việt', flag: '🇻🇳' },
+  { code: 'zh-CN', name: 'Chinese (Simplified)', nativeName: '简体中文', flag: '🇨🇳' },
 ];
 
+/**
+ * Get language by code
+ */
+export const getLanguageByCode = (code: string): Language | undefined => {
+  return LANGUAGES.find(lang => lang.code === code);
+};
+
+/**
+ * Get default language (en-US)
+ */
+export const getDefaultLanguage = (): Language => {
+  return LANGUAGES.find(lang => lang.code === 'en-US')!;
+};
+
+/**
+ * Search languages by name or native name
+ */
+export const searchLanguages = (query: string): Language[] => {
+  const lowerQuery = query.toLowerCase();
+  return LANGUAGES.filter(
+    lang =>
+      lang.name.toLowerCase().includes(lowerQuery) ||
+      lang.nativeName.toLowerCase().includes(lowerQuery)
+  );
+};

package/src/infrastructure/storage/AsyncStorageWrapper.ts

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