@umituz/react-native-localization 1.0.0

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

@@ -0,0 +1,38 @@
+{
+  "validation": {
+    "required": "This field is required",
+    "invalidEmail": "Invalid email address",
+    "invalidPhone": "Invalid phone number",
+    "passwordTooShort": "Password must be at least 8 characters",
+    "passwordTooLong": "Password must be at most 128 characters",
+    "passwordsDontMatch": "Passwords do not match",
+    "nameTooShort": "Name must be at least 2 characters",
+    "nameTooLong": "Name must be at most 50 characters"
+  },
+  "fields": {
+    "email": "Email",
+    "password": "Password",
+    "passwordConfirmation": "Confirm Password",
+    "name": "Name",
+    "phone": "Phone Number",
+    "currentPassword": "Current Password",
+    "newPassword": "New Password",
+    "newPasswordConfirmation": "Confirm New Password",
+    "subject": "Subject",
+    "message": "Message"
+  },
+  "actions": {
+    "submit": "Submit",
+    "cancel": "Cancel",
+    "reset": "Reset",
+    "save": "Save",
+    "update": "Update"
+  },
+  "schemas": {
+    "login": "Login Form",
+    "register": "Registration Form",
+    "profile": "Profile Form",
+    "changePassword": "Change Password",
+    "contact": "Contact Form"
+  }
+}

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

@@ -0,0 +1,56 @@
+{
+  "back": "Back",
+  "cancel": "Cancel",
+  "confirm": "Confirm",
+  "continue": "Continue",
+  "delete": "Delete",
+  "edit": "Edit",
+  "error": "Error",
+  "loading": "Loading...",
+  "notNow": "Not Now",
+  "ok": "OK",
+  "optional": "Optional",
+  "save": "Save",
+  "something_went_wrong": "Something went wrong",
+  "success": "Success",
+  "close": "Close",
+  "done": "Done",
+  "next": "Next",
+  "previous": "Previous",
+  "skip": "Skip",
+  "retry": "Retry",
+  "refresh": "Refresh",
+  "search": "Search",
+  "filter": "Filter",
+  "sort": "Sort",
+  "add": "Add",
+  "remove": "Remove",
+  "update": "Update",
+  "create": "Create",
+  "view": "View",
+  "details": "Details",
+  "share": "Share",
+  "download": "Download",
+  "upload": "Upload",
+  "submit": "Submit",
+  "reset": "Reset",
+  "clear": "Clear",
+  "apply": "Apply",
+  "yes": "Yes",
+  "no": "No",
+  "all": "All",
+  "none": "None",
+  "of": "of",
+  "select": "Select",
+  "selected": "Selected",
+  "required": "Required",
+  "empty": "Empty",
+  "noData": "No data available",
+  "noResults": "No results found",
+  "tryAgain": "Try again",
+  "learnMore": "Learn more",
+  "getStarted": "Get started",
+  "viewAll": "View all",
+  "showMore": "Show more",
+  "showLess": "Show less"
+}

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

@@ -0,0 +1,34 @@
+{
+  "libraries": {
+    "lucide": "Lucide Icons",
+    "material": "Material Design",
+    "fontawesome": "FontAwesome",
+    "ionicons": "Ionicons"
+  },
+  "categories": {
+    "all": "All Icons",
+    "navigation": "Navigation",
+    "action": "Action",
+    "social": "Social",
+    "communication": "Communication",
+    "media": "Media",
+    "business": "Business",
+    "weather": "Weather",
+    "symbols": "Symbols",
+    "emoji": "Emoji"
+  },
+  "picker": {
+    "title": "Select Icon",
+    "search": "Search icons...",
+    "searchPlaceholder": "Search",
+    "noResults": "No icons found",
+    "selected": "Selected",
+    "selectLibrary": "Select Library",
+    "selectCategory": "Select Category"
+  },
+  "actions": {
+    "select": "Select",
+    "cancel": "Cancel",
+    "clear": "Clear Selection"
+  }
+}

package/src/infrastructure/locales/en-US/index.ts

@@ -0,0 +1,36 @@
+/**
+ * en-US translation modules
+ * All common translations for English (US)
+ */
+
+import animation from './animation.json';
+import audio from './audio.json';
+import datetime from './datetime.json';
+import emoji from './emoji.json';
+import errors from './errors.json';
+import forms from './forms.json';
+import general from './general.json';
+import icons from './icons.json';
+import location from './location.json';
+import media from './media.json';
+import navigation from './navigation.json';
+import onboarding from './onboarding.json';
+import settings from './settings.json';
+import toast from './toast.json';
+
+export default {
+  animation,
+  audio,
+  datetime,
+  emoji,
+  errors,
+  forms,
+  general,
+  icons,
+  location,
+  media,
+  navigation,
+  onboarding,
+  settings,
+  toast,
+};

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

@@ -0,0 +1,49 @@
+{
+  "permission": {
+    "title": "Location Permission",
+    "message": "This app needs access to your location to provide location-based features.",
+    "request": "Grant Location Permission",
+    "denied": "Location permission denied",
+    "granted": "Location permission granted",
+    "unknown": "Location permission status unknown"
+  },
+  "status": {
+    "loading": "Getting your location...",
+    "success": "Location retrieved successfully",
+    "failed": "Unable to get location",
+    "unavailable": "Location services not available",
+    "cached": "Using cached location",
+    "timeout": "Location request timed out"
+  },
+  "accuracy": {
+    "high": "High accuracy",
+    "balanced": "Balanced accuracy",
+    "low": "Low accuracy",
+    "lowest": "Lowest accuracy"
+  },
+  "errors": {
+    "notAvailable": "Location services not available on this platform",
+    "permissionDenied": "Location permission denied. Please enable location access in settings.",
+    "timeout": "Location request timed out. Please try again.",
+    "unknown": "An unknown error occurred while getting location",
+    "noLocation": "Unable to determine your location"
+  },
+  "actions": {
+    "getCurrentLocation": "Get Current Location",
+    "refreshLocation": "Refresh Location",
+    "clearLocation": "Clear Location",
+    "openSettings": "Open Settings"
+  },
+  "labels": {
+    "latitude": "Latitude",
+    "longitude": "Longitude",
+    "accuracy": "Accuracy",
+    "address": "Address",
+    "timestamp": "Time",
+    "coordinates": "Coordinates"
+  },
+  "units": {
+    "meters": "meters",
+    "kilometers": "kilometers"
+  }
+}

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

@@ -0,0 +1,49 @@
+{
+  "picker": {
+    "selectImage": "Select Image",
+    "selectImages": "Select Images",
+    "selectVideo": "Select Video",
+    "takePhoto": "Take Photo",
+    "chooseFromLibrary": "Choose from Library",
+    "cancel": "Cancel"
+  },
+  "permissions": {
+    "cameraTitle": "Camera Permission",
+    "cameraMessage": "This app needs camera access to take photos",
+    "libraryTitle": "Photo Library Permission",
+    "libraryMessage": "This app needs access to your photo library",
+    "deniedTitle": "Permission Denied",
+    "deniedMessage": "Please enable permissions in Settings",
+    "openSettings": "Open Settings"
+  },
+  "actions": {
+    "resize": "Resize",
+    "crop": "Crop",
+    "rotate": "Rotate",
+    "flip": "Flip",
+    "compress": "Compress",
+    "save": "Save",
+    "delete": "Delete",
+    "edit": "Edit"
+  },
+  "errors": {
+    "pickFailed": "Failed to pick image",
+    "cameraFailed": "Failed to launch camera",
+    "saveFailed": "Failed to save image",
+    "manipulateFailed": "Failed to edit image",
+    "permissionDenied": "Permission denied",
+    "noImage": "No image selected",
+    "invalidImage": "Invalid image file",
+    "tooLarge": "File size too large"
+  },
+  "quality": {
+    "low": "Low",
+    "medium": "Medium",
+    "high": "High"
+  },
+  "format": {
+    "jpeg": "JPEG",
+    "png": "PNG",
+    "webp": "WebP"
+  }
+}

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

@@ -0,0 +1,52 @@
+{
+  "home": "Home",
+  "settings": "Settings",
+  "about": "About",
+  "back": "Back",
+  "explore": "Explore",
+  "search": "Search",
+  "favorites": "Favorites",
+  "activity": "Activity",
+  "discover": "Discover",
+  "library": "Library",
+  "stats": "Stats",
+  "wellness": "Wellness",
+  "exercises": "Exercises",
+  "nutrition": "Nutrition",
+  "progress": "Progress",
+  "workouts": "Workouts",
+  "dashboard": "Dashboard",
+  "calendar": "Calendar",
+  "tasks": "Tasks",
+  "notes": "Notes",
+  "projects": "Projects",
+  "goals": "Goals",
+  "habits": "Habits",
+  "budget": "Budget",
+  "expenses": "Expenses",
+  "income": "Income",
+  "accounts": "Accounts",
+  "reports": "Reports",
+  "courses": "Courses",
+  "lessons": "Lessons",
+  "practice": "Practice",
+  "learning": "Learning",
+  "meditation": "Meditation",
+  "journal": "Journal",
+  "timer": "Timer",
+  "tracking": "Tracking",
+  "analytics": "Analytics",
+  "community": "Community",
+  "feed": "Feed",
+  "browse": "Browse",
+  "categories": "Categories",
+  "saved": "Saved",
+  "history": "History",
+  "achievements": "Achievements",
+  "leaderboard": "Leaderboard",
+  "challenges": "Challenges",
+  "rewards": "Rewards",
+  "today": "Today",
+  "medicines": "Medicines",
+  "adherence": "Adherence"
+}

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

@@ -0,0 +1,76 @@
+{
+  "skip": "Skip",
+  "getStarted": "Get Started",
+  "welcome": {
+    "title": "Welcome!",
+    "subtitle": "Your journey starts here",
+    "getStarted": "Get Started",
+    "skip": "Skip"
+  },
+  "slides": {
+    "slide1": {
+      "title": "Discover Amazing Features",
+      "description": "Explore everything our app has to offer"
+    },
+    "slide2": {
+      "title": "Stay Organized",
+      "description": "Keep track of what matters most"
+    },
+    "slide3": {
+      "title": "Achieve Your Goals",
+      "description": "We're here to help you succeed"
+    }
+  },
+  "permissions": {
+    "title": "Permissions",
+    "subtitle": "We need some permissions to provide the best experience",
+    "location": {
+      "title": "Location",
+      "description": "Provide location-based features",
+      "enable": "Enable Location"
+    },
+    "camera": {
+      "title": "Camera",
+      "description": "Take photos and scan documents",
+      "enable": "Enable Camera"
+    },
+    "photos": {
+      "title": "Photos",
+      "description": "Access your photo library",
+      "enable": "Enable Photos"
+    },
+    "later": "I'll do this later",
+    "continue": "Continue"
+  },
+  "personalization": {
+    "title": "Personalize Your Experience",
+    "subtitle": "Tell us about yourself",
+    "goals": {
+      "title": "What are your goals?",
+      "options": [
+        "Stay healthy",
+        "Be productive",
+        "Learn new skills",
+        "Connect with others",
+        "Have fun"
+      ]
+    },
+    "preferences": {
+      "title": "Set your preferences",
+      "theme": "Choose Theme",
+      "language": "Choose Language"
+    },
+    "continue": "Continue"
+  },
+  "complete": {
+    "title": "You're All Set!",
+    "subtitle": "Let's get started!",
+    "startButton": "Start Using App"
+  },
+  "navigation": {
+    "next": "Next",
+    "back": "Back",
+    "skip": "Skip",
+    "done": "Done"
+  }
+}

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

@@ -0,0 +1,65 @@
+{
+  "lightMode": "Light Mode",
+  "darkMode": "Dark Mode",
+  "language": "Language",
+  "aboutDescription": "App information and version",
+  "sections": {
+    "appearance": "Appearance",
+    "general": "General",
+    "support": "Support Development",
+    "about": "About & Legal"
+  },
+  "about": {
+    "title": "About",
+    "description": "App information and version",
+    "appInfo": "App Information",
+    "appVersion": "App Version",
+    "moreApps": "More Apps",
+    "moreAppsDescription": "Check out our other apps",
+    "contact": "Contact",
+    "contactEmail": "Contact Email",
+    "website": "Website"
+  },
+  "disclaimer": {
+    "title": "Health Disclaimer",
+    "shortMessage": "Tap to read important health information",
+    "message": "This app is for informational and wellness support purposes only. It is NOT a substitute for professional medical or mental health care.\n\nIf you're experiencing a health crisis or emergency, contact your local emergency services or healthcare provider immediately.\n\nAlways consult qualified healthcare professionals for medical advice, diagnosis, or treatment. The content in this app should not be used as a substitute for professional medical judgment.\n\nYour privacy is important. All data stays private on your device unless you explicitly choose to share it."
+  },
+  "legal": {
+    "title": "Legal",
+    "description": "Privacy policy, terms of use, and EULA",
+    "privacy": "Privacy Policy",
+    "privacyDescription": "How we handle your data",
+    "terms": "Terms of Use",
+    "termsDescription": "Terms and conditions",
+    "eula": "End User License Agreement",
+    "eulaDescription": "License agreement"
+  },
+  "version": {
+    "title": "App Version"
+  },
+  "languageSelection": {
+    "title": "Select Language",
+    "description": "Choose your preferred language",
+    "currentLanguage": "Current Language",
+    "searchPlaceholder": "Search languages"
+  },
+  "appearance": {
+    "title": "Appearance",
+    "darkMode": "Dark Mode",
+    "darkTheme": "Dark Theme",
+    "lightTheme": "Light Theme",
+    "themeDescription": "Language and theme settings"
+  },
+  "notifications": {
+    "title": "Notifications",
+    "description": "Manage notification preferences",
+    "enableNotifications": "Enable Notifications",
+    "notificationPermission": "Notification Permission",
+    "notificationPermissionDescription": "Allow app to send notifications"
+  },
+  "donate": {
+    "title": "Support the Developer",
+    "description": "Buy me a coffee to support development"
+  }
+}

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

@@ -0,0 +1,38 @@
+{
+  "types": {
+    "success": "Success",
+    "error": "Error",
+    "info": "Info",
+    "warning": "Warning"
+  },
+  "position": {
+    "top": "Top",
+    "bottom": "Bottom"
+  },
+  "presets": {
+    "saved": "Saved",
+    "savedDescription": "Your changes have been saved",
+    "deleted": "Deleted",
+    "deletedDescription": "Item has been removed",
+    "copied": "Copied",
+    "copiedDescription": "Copied to clipboard",
+    "errorGeneric": "Error",
+    "errorGenericDescription": "Something went wrong. Please try again.",
+    "errorNetwork": "Network Error",
+    "errorNetworkDescription": "Please check your connection",
+    "errorValidation": "Validation Error",
+    "errorValidationDescription": "Please check your input",
+    "infoLoading": "Loading",
+    "infoLoadingDescription": "Please wait...",
+    "infoSyncing": "Syncing",
+    "infoSyncingDescription": "Syncing your data...",
+    "warningUnsaved": "Unsaved Changes",
+    "warningUnsavedDescription": "You have unsaved changes",
+    "warningLimit": "Limit Reached",
+    "warningLimitDescription": "You have reached the limit"
+  },
+  "labels": {
+    "visibilityTime": "Display Duration",
+    "autoHide": "Auto Hide"
+  }
+}

package/src/infrastructure/storage/AsyncStorageWrapper.ts

@@ -0,0 +1,30 @@
+/**
+ * AsyncStorage Wrapper
+ * Simple wrapper for AsyncStorage operations
+ */
+
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+export const STORAGE_KEYS = {
+  LANGUAGE: '@localization:language',
+} as const;
+
+export const StorageWrapper = {
+  async getString(key: string, defaultValue: string): Promise<string> {
+    try {
+      const value = await AsyncStorage.getItem(key);
+      return value ?? defaultValue;
+    } catch (error) {
+      console.warn('[Localization] Failed to get storage value:', error);
+      return defaultValue;
+    }
+  },
+
+  async setString(key: string, value: string): Promise<void> {
+    try {
+      await AsyncStorage.setItem(key, value);
+    } catch (error) {
+      console.warn('[Localization] Failed to set storage value:', error);
+    }
+  },
+};

package/src/infrastructure/storage/LocalizationStore.ts

@@ -0,0 +1,118 @@
+/**
+ * Localization Store
+ * Zustand state management for language preferences with AsyncStorage persistence
+ */
+
+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 type { Language } from '../../domain/repositories/ILocalizationRepository';
+
+interface LocalizationState {
+  currentLanguage: string;
+  isRTL: boolean;
+  isInitialized: boolean;
+  supportedLanguages: Language[];
+  setLanguage: (languageCode: string) => Promise<void>;
+  initialize: () => Promise<void>;
+}
+
+export const useLocalizationStore = create<LocalizationState>((set, get) => ({
+  currentLanguage: DEFAULT_LANGUAGE,
+  isRTL: false,
+  isInitialized: false,
+  supportedLanguages: SUPPORTED_LANGUAGES,
+
+  /**
+   * Initialize localization
+   * DEVICE LOCALE DETECTION:
+   * - First launch (no saved language): Automatically detect device locale
+   * - After manual selection: Use saved language preference
+   * - 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: string;
+    if (savedLanguage && savedLanguage !== DEFAULT_LANGUAGE) {
+      // User has previously selected a language → Use their choice
+      languageCode = savedLanguage;
+    } 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
+   * Updates i18n, state, and persists to AsyncStorage
+   */
+  setLanguage: async (languageCode: string) => {
+    const language = getLanguageByCode(languageCode);
+
+    // ✅ DEFENSIVE: Early return if unsupported language
+    if (!language) return;
+
+    // Update i18n
+    await i18n.changeLanguage(languageCode);
+
+    // Update state
+    set({
+      currentLanguage: languageCode,
+      isRTL: language.rtl || false,
+    });
+
+    // Persist language preference
+    await StorageWrapper.setString(STORAGE_KEYS.LANGUAGE, languageCode);
+  },
+}));
+
+/**
+ * Hook to use localization
+ * Provides current language, RTL state, language switching, and translation function
+ */
+export const useLocalization = () => {
+  const {
+    currentLanguage,
+    isRTL,
+    isInitialized,
+    supportedLanguages,
+    setLanguage,
+    initialize,
+  } = useLocalizationStore();
+
+  const currentLanguageObject = getLanguageByCode(currentLanguage);
+
+  return {
+    t: i18n.t.bind(i18n), // Translation function
+    currentLanguage,
+    currentLanguageObject,
+    isRTL,
+    isInitialized,
+    supportedLanguages,
+    setLanguage,
+    initialize,
+  };
+};