@umituz/react-native-localization 1.0.0

package/src/index.ts

@@ -0,0 +1,24 @@
+/**
+ * React Native Localization
+ * Universal localization system with i18n support for React Native apps
+ */
+
+// Hooks
+export { useLocalization, useLocalizationStore } from './infrastructure/storage/LocalizationStore';
+
+// Components
+export { LocalizationProvider } from './infrastructure/components/LocalizationProvider';
+
+// Configuration
+export { default as i18n } from './infrastructure/config/i18n';
+export {
+  SUPPORTED_LANGUAGES,
+  DEFAULT_LANGUAGE,
+  getLanguageByCode,
+  isLanguageSupported,
+  getDefaultLanguage,
+  getDeviceLocale,
+} from './infrastructure/config/languages';
+
+// Types
+export type { Language, ILocalizationRepository } from './domain/repositories/ILocalizationRepository';

package/src/infrastructure/components/LocalizationProvider.tsx

@@ -0,0 +1,21 @@
+/**
+ * LocalizationProvider Component
+ * Initializes localization system on mount
+ */
+
+import React, { useEffect, ReactNode } from 'react';
+import { useLocalizationStore } from '../storage/LocalizationStore';
+
+interface LocalizationProviderProps {
+  children: ReactNode;
+}
+
+export const LocalizationProvider: React.FC<LocalizationProviderProps> = ({ children }) => {
+  const initialize = useLocalizationStore((state) => state.initialize);
+
+  useEffect(() => {
+    initialize();
+  }, [initialize]);
+
+  return <>{children}</>;
+};

package/src/infrastructure/config/i18n.ts

@@ -0,0 +1,57 @@
+/**
+ * i18next Configuration
+ * Nested translation structure - common translations spread, domain translations nested
+ */
+
+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 (OFFLINE-ONLY):
+ * locales/
+ *   en-US/  (universal translations in localization domain)
+ *     index.ts (merges common.json, navigation.json, settings.json, onboarding.json, errors.json)
+ *
+ * All translations are offline-compatible and work without backend.
+ */
+
+// Import universal translations from localization domain
+import localizationEnUS from '../locales/en-US';
+
+/**
+ * Translation Resources
+ * Nested structure - domain-based organization with direct key access
+ * Example: settings.theme.title, onboarding.welcome.title
+ */
+const resources = {
+  'en-US': {
+    translation: {
+      ...localizationEnUS,
+    },
+  },
+};
+
+/**
+ * Initialize i18next
+ */
+i18n.use(initReactI18next).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
+});
+
+export default i18n;

package/src/infrastructure/config/languages.ts

@@ -0,0 +1,245 @@
+/**
+ * Supported Languages Configuration
+ * Complete list of 29 languages supported by the app
+ *
+ * SINGLE SOURCE OF TRUTH: Imports from constants/languages.ts
+ * - All language definitions come from one central location
+ * - Ensures consistency across app.json, i18n config, and UI
+ * - Automatic synchronization between all language configurations
+ *
+ * DEVICE LOCALE DETECTION:
+ * - First launch: Automatically detects device locale
+ * - Fallback: English (en-US) if device locale not supported
+ * - User choice: Persists after manual language selection
+ */
+
+import * as Localization from 'expo-localization';
+import { LANGUAGES } from './languagesData';
+import { Language } from '../../domain/repositories/ILocalizationRepository';
+
+// Single source of truth for supported languages
+export const SUPPORTED_LANGUAGES: Language[] = LANGUAGES;
+
+export const DEFAULT_LANGUAGE = 'en-US';
+
+/**
+ * Locale mapping for device locales to supported app locales
+ * Maps short codes (e.g., "en") and iOS variants (e.g., "en-GB", "zh-Hans") to our supported locales
+ *
+ * COMPREHENSIVE MAPPING:
+ * - Short codes (ar, bg, cs, da, de, etc.) → Full locale codes (ar-SA, bg-BG, etc.)
+ * - iOS regional variants → Our standard locales
+ * - All 29 supported languages included
+ */
+const LOCALE_MAPPING: Record<string, string> = {
+  // Arabic
+  'ar': 'ar-SA',
+  'ar-SA': 'ar-SA',
+  'ar-AE': 'ar-SA',
+  'ar-EG': 'ar-SA',
+
+  // Bulgarian
+  'bg': 'bg-BG',
+  'bg-BG': 'bg-BG',
+
+  // Czech
+  'cs': 'cs-CZ',
+  'cs-CZ': 'cs-CZ',
+
+  // Danish
+  'da': 'da-DK',
+  'da-DK': 'da-DK',
+
+  // German
+  'de': 'de-DE',
+  'de-DE': 'de-DE',
+  'de-AT': 'de-DE',
+  'de-CH': 'de-DE',
+
+  // Greek (iOS has el, we map to en-US fallback since we don't support Greek)
+  'el': 'en-US',
+
+  // English variants
+  'en': 'en-US',
+  'en-US': 'en-US',
+  'en-GB': 'en-US',
+  'en-AU': 'en-US',
+  'en-CA': 'en-US',
+  'en-NZ': 'en-US',
+  'en-IE': 'en-US',
+  'en-ZA': 'en-US',
+
+  // Spanish
+  'es': 'es-ES',
+  'es-ES': 'es-ES',
+  'es-MX': 'es-ES',
+  'es-AR': 'es-ES',
+
+  // Finnish
+  'fi': 'fi-FI',
+  'fi-FI': 'fi-FI',
+
+  // French
+  'fr': 'fr-FR',
+  'fr-FR': 'fr-FR',
+  'fr-CA': 'fr-FR',
+  'fr-BE': 'fr-FR',
+  'fr-CH': 'fr-FR',
+
+  // Hindi
+  'hi': 'hi-IN',
+  'hi-IN': 'hi-IN',
+
+  // Croatian (iOS has hr, we map to en-US fallback since we don't support Croatian)
+  'hr': 'en-US',
+
+  // Hungarian
+  'hu': 'hu-HU',
+  'hu-HU': 'hu-HU',
+
+  // Indonesian
+  'id': 'id-ID',
+  'id-ID': 'id-ID',
+
+  // Italian
+  'it': 'it-IT',
+  'it-IT': 'it-IT',
+
+  // Japanese
+  'ja': 'ja-JP',
+  'ja-JP': 'ja-JP',
+
+  // Korean
+  'ko': 'ko-KR',
+  'ko-KR': 'ko-KR',
+
+  // Malay
+  'ms': 'ms-MY',
+  'ms-MY': 'ms-MY',
+
+  // Norwegian (iOS uses nb for Norwegian Bokmål)
+  'nb': 'no-NO',
+  'no': 'no-NO',
+  'no-NO': 'no-NO',
+
+  // Dutch
+  'nl': 'nl-NL',
+  'nl-NL': 'nl-NL',
+  'nl-BE': 'nl-NL',
+
+  // Polish
+  'pl': 'pl-PL',
+  'pl-PL': 'pl-PL',
+
+  // Portuguese
+  'pt': 'pt-PT',
+  'pt-PT': 'pt-PT',
+  'pt-BR': 'pt-PT',
+
+  // Romanian
+  'ro': 'ro-RO',
+  'ro-RO': 'ro-RO',
+
+  // Russian
+  'ru': 'ru-RU',
+  'ru-RU': 'ru-RU',
+
+  // Slovak (iOS has sk, we map to en-US fallback since we don't support Slovak)
+  'sk': 'en-US',
+
+  // Swedish
+  'sv': 'sv-SE',
+  'sv-SE': 'sv-SE',
+
+  // Thai
+  'th': 'th-TH',
+  'th-TH': 'th-TH',
+
+  // Filipino/Tagalog
+  'tl': 'tl-PH',
+  'tl-PH': 'tl-PH',
+  'fil': 'tl-PH',
+
+  // Turkish
+  'tr': 'tr-TR',
+  'tr-TR': 'tr-TR',
+
+  // Ukrainian
+  'uk': 'uk-UA',
+  'uk-UA': 'uk-UA',
+
+  // Vietnamese
+  'vi': 'vi-VN',
+  'vi-VN': 'vi-VN',
+
+  // Chinese Simplified (iOS uses zh-Hans)
+  'zh': 'zh-CN',
+  'zh-CN': 'zh-CN',
+  'zh-Hans': 'zh-CN',
+  'zh-Hans-CN': 'zh-CN',
+
+  // Chinese Traditional (iOS uses zh-Hant, we map to zh-CN since we only support Simplified)
+  'zh-Hant': 'zh-CN',
+  'zh-TW': 'zh-CN',
+  'zh-HK': 'zh-CN',
+};
+
+export const getLanguageByCode = (code: string): Language | undefined => {
+  return SUPPORTED_LANGUAGES.find((lang) => lang.code === code);
+};
+
+export const isLanguageSupported = (code: string): boolean => {
+  return SUPPORTED_LANGUAGES.some((lang) => lang.code === code);
+};
+
+export const getDefaultLanguage = (): Language => {
+  return SUPPORTED_LANGUAGES[0]; // en-US
+};
+
+/**
+ * Get device locale and map it to supported language
+ * Called ONLY on first launch (when no saved language preference exists)
+ *
+ * @returns Supported language code or DEFAULT_LANGUAGE
+ *
+ * Examples:
+ * - Device: "en" → Returns: "en-US"
+ * - Device: "en-GB" → Returns: "en-US"
+ * - Device: "tr" → Returns: "tr-TR" (if supported)
+ * - Device: "de" → Returns: "en-US" (not supported, fallback)
+ */
+export const getDeviceLocale = (): string => {
+  try {
+    // Get device locale (e.g., "en-US", "tr-TR", or just "en")
+    const deviceLocale = Localization.locale;
+
+    if (!deviceLocale) {
+      return DEFAULT_LANGUAGE;
+    }
+
+    // Check if exact match exists in LOCALE_MAPPING
+    if (LOCALE_MAPPING[deviceLocale]) {
+      return LOCALE_MAPPING[deviceLocale];
+    }
+
+    // Extract language code (e.g., "en" from "en-US")
+    const languageCode = deviceLocale.split('-')[0];
+
+    // Check if language code exists in LOCALE_MAPPING
+    if (LOCALE_MAPPING[languageCode]) {
+      return LOCALE_MAPPING[languageCode];
+    }
+
+    // Check if device locale is directly supported
+    if (isLanguageSupported(deviceLocale)) {
+      return deviceLocale;
+    }
+
+    // Fallback to default language
+    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

@@ -0,0 +1,38 @@
+/**
+ * Languages Data
+ * Complete list of supported languages with metadata
+ */
+
+import type { Language } from '../../domain/repositories/ILocalizationRepository';
+
+export const LANGUAGES: Language[] = [
+  { code: 'en-US', name: 'English', nativeName: 'English', flag: '🇺🇸', rtl: false },
+  { 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: '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: 'Tagalog', 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 },
+];

package/src/infrastructure/locales/en-US/animation.json

@@ -0,0 +1,30 @@
+{
+  "presets": {
+    "fadeIn": "Fade In",
+    "fadeOut": "Fade Out",
+    "slideInUp": "Slide In Up",
+    "slideInDown": "Slide In Down",
+    "slideInLeft": "Slide In Left",
+    "slideInRight": "Slide In Right",
+    "scaleIn": "Scale In",
+    "scaleOut": "Scale Out",
+    "bounce": "Bounce",
+    "shake": "Shake"
+  },
+  "gestures": {
+    "tap": "Tap",
+    "pan": "Pan",
+    "pinch": "Pinch",
+    "rotation": "Rotation",
+    "longPress": "Long Press"
+  },
+  "actions": {
+    "animate": "Animate",
+    "reset": "Reset Animation"
+  },
+  "labels": {
+    "duration": "Duration",
+    "damping": "Damping",
+    "stiffness": "Stiffness"
+  }
+}

package/src/infrastructure/locales/en-US/audio.json

@@ -0,0 +1,56 @@
+{
+  "recording": {
+    "start": "Start Recording",
+    "stop": "Stop Recording",
+    "pause": "Pause Recording",
+    "resume": "Resume Recording",
+    "save": "Save Recording",
+    "delete": "Delete Recording",
+    "recording": "Recording...",
+    "paused": "Paused",
+    "duration": "Duration"
+  },
+  "playback": {
+    "play": "Play",
+    "pause": "Pause",
+    "stop": "Stop",
+    "replay": "Replay",
+    "forward": "Forward",
+    "backward": "Backward",
+    "speed": "Speed",
+    "volume": "Volume",
+    "mute": "Mute",
+    "unmute": "Unmute",
+    "loop": "Loop",
+    "playing": "Playing",
+    "buffering": "Buffering",
+    "finished": "Finished"
+  },
+  "permissions": {
+    "microphoneTitle": "Microphone Permission",
+    "microphoneMessage": "This app needs microphone access to record audio",
+    "deniedTitle": "Permission Denied",
+    "deniedMessage": "Please enable microphone permissions in Settings",
+    "openSettings": "Open Settings"
+  },
+  "quality": {
+    "low": "Low Quality",
+    "high": "High Quality"
+  },
+  "errors": {
+    "recordFailed": "Failed to start recording",
+    "stopFailed": "Failed to stop recording",
+    "playFailed": "Failed to play audio",
+    "loadFailed": "Failed to load audio",
+    "saveFailed": "Failed to save recording",
+    "permissionDenied": "Microphone permission denied",
+    "noRecording": "No recording available",
+    "invalidFile": "Invalid audio file"
+  },
+  "formats": {
+    "aac": "AAC",
+    "mp3": "MP3",
+    "m4a": "M4A",
+    "wav": "WAV"
+  }
+}

package/src/infrastructure/locales/en-US/datetime.json

@@ -0,0 +1,140 @@
+{
+  "days": {
+    "full": {
+      "monday": "Monday",
+      "tuesday": "Tuesday",
+      "wednesday": "Wednesday",
+      "thursday": "Thursday",
+      "friday": "Friday",
+      "saturday": "Saturday",
+      "sunday": "Sunday"
+    },
+    "short": {
+      "mon": "Mon",
+      "tue": "Tue",
+      "wed": "Wed",
+      "thu": "Thu",
+      "fri": "Fri",
+      "sat": "Sat",
+      "sun": "Sun"
+    },
+    "abbreviated": {
+      "m": "M",
+      "t": "T",
+      "w": "W",
+      "th": "Th",
+      "f": "F",
+      "sa": "Sa",
+      "su": "Su"
+    }
+  },
+  "months": {
+    "full": {
+      "january": "January",
+      "february": "February",
+      "march": "March",
+      "april": "April",
+      "may": "May",
+      "june": "June",
+      "july": "July",
+      "august": "August",
+      "september": "September",
+      "october": "October",
+      "november": "November",
+      "december": "December"
+    },
+    "short": {
+      "jan": "Jan",
+      "feb": "Feb",
+      "mar": "Mar",
+      "apr": "Apr",
+      "may": "May",
+      "jun": "Jun",
+      "jul": "Jul",
+      "aug": "Aug",
+      "sep": "Sep",
+      "oct": "Oct",
+      "nov": "Nov",
+      "dec": "Dec"
+    }
+  },
+  "relative": {
+    "now": "Now",
+    "justNow": "Just now",
+    "today": "Today",
+    "yesterday": "Yesterday",
+    "tomorrow": "Tomorrow",
+    "thisWeek": "This week",
+    "lastWeek": "Last week",
+    "nextWeek": "Next week",
+    "thisMonth": "This month",
+    "lastMonth": "Last month",
+    "nextMonth": "Next month",
+    "thisYear": "This year",
+    "lastYear": "Last year",
+    "nextYear": "Next year",
+    "ago": "ago",
+    "fromNow": "from now",
+    "in": "in"
+  },
+  "units": {
+    "singular": {
+      "second": "second",
+      "minute": "minute",
+      "hour": "hour",
+      "day": "day",
+      "week": "week",
+      "month": "month",
+      "year": "year"
+    },
+    "plural": {
+      "seconds": "seconds",
+      "minutes": "minutes",
+      "hours": "hours",
+      "days": "days",
+      "weeks": "weeks",
+      "months": "months",
+      "years": "years"
+    },
+    "short": {
+      "s": "s",
+      "m": "m",
+      "h": "h",
+      "d": "d",
+      "w": "w",
+      "mo": "mo",
+      "y": "y"
+    }
+  },
+  "periods": {
+    "am": "AM",
+    "pm": "PM",
+    "morning": "Morning",
+    "afternoon": "Afternoon",
+    "evening": "Evening",
+    "night": "Night",
+    "midnight": "Midnight",
+    "noon": "Noon"
+  },
+  "formats": {
+    "date": "Date",
+    "time": "Time",
+    "datetime": "Date & Time",
+    "duration": "Duration",
+    "startDate": "Start Date",
+    "endDate": "End Date",
+    "startTime": "Start Time",
+    "endTime": "End Time",
+    "selectDate": "Select Date",
+    "selectTime": "Select Time"
+  },
+  "actions": {
+    "setDate": "Set Date",
+    "setTime": "Set Time",
+    "clearDate": "Clear Date",
+    "clearTime": "Clear Time",
+    "confirmDate": "Confirm Date",
+    "confirmTime": "Confirm Time",
+    "cancel": "Cancel"
+  }
+}

package/src/infrastructure/locales/en-US/emoji.json

@@ -0,0 +1,29 @@
+{
+  "picker": {
+    "title": "Select Emoji",
+    "search": "Search emojis...",
+    "searchPlaceholder": "Search",
+    "noResults": "No emojis found",
+    "recentlyUsed": "Recently Used"
+  },
+  "categories": {
+    "smileys_emotion": "Smileys & Emotion",
+    "people_body": "People & Body",
+    "animals_nature": "Animals & Nature",
+    "food_drink": "Food & Drink",
+    "travel_places": "Travel & Places",
+    "activities": "Activities",
+    "objects": "Objects",
+    "symbols": "Symbols",
+    "flags": "Flags"
+  },
+  "actions": {
+    "select": "Select",
+    "cancel": "Cancel",
+    "clear": "Clear Emoji"
+  },
+  "validation": {
+    "required": "Please select an emoji",
+    "invalid": "Invalid emoji"
+  }
+}

package/src/infrastructure/locales/en-US/errors.json

@@ -0,0 +1,43 @@
+{
+  "validation": {
+    "required": "This field is required",
+    "invalidEmail": "Invalid email format",
+    "invalidPhone": "Invalid phone number",
+    "invalidUrl": "Invalid URL format",
+    "minLength": "Minimum length is {{min}} characters",
+    "maxLength": "Maximum length is {{max}} characters",
+    "minValue": "Minimum value is {{min}}",
+    "maxValue": "Maximum value is {{max}}",
+    "mustMatch": "Fields must match",
+    "invalidFormat": "Invalid format",
+    "invalidDate": "Invalid date",
+    "futureDate": "Date must be in the future",
+    "pastDate": "Date must be in the past"
+  },
+  "storage": {
+    "saveFailed": "Failed to save data",
+    "loadFailed": "Failed to load data",
+    "deleteFailed": "Failed to delete data",
+    "notFound": "Data not found"
+  },
+  "permission": {
+    "denied": "Permission denied",
+    "notGranted": "Permission not granted",
+    "cameraNotAvailable": "Camera not available",
+    "locationNotAvailable": "Location services not available",
+    "microphoneNotAvailable": "Microphone not available",
+    "photosNotAvailable": "Photo library not available"
+  },
+  "common": {
+    "somethingWentWrong": "Something went wrong",
+    "tryAgainLater": "Please try again later",
+    "unexpectedError": "An unexpected error occurred"
+  },
+  "actions": {
+    "dismiss": "Dismiss",
+    "retry": "Retry",
+    "cancel": "Cancel",
+    "goBack": "Go Back",
+    "contactSupport": "Contact Support"
+  }
+}