@transfergratis/react-native-sdk 0.1.4 → 0.1.6

package/src/i18n/README.md

@@ -0,0 +1,288 @@
+# 🌍 Système d'Internationalisation (i18n) - Transfergratis SDK
+
+Ce système d'internationalisation permet de traduire facilement votre application KYC en plusieurs langues.
+
+## 📁 Structure des fichiers
+
+```
+src/i18n/
+├── index.ts              # Configuration principale i18n-js
+├── types.ts              # Types TypeScript
+├── usage-example.tsx     # Exemple d'utilisation
+├── README.md             # Documentation
+├── en/                   # Traductions anglaises
+│   └── index.ts
+└── fr/                   # Traductions françaises
+    └── index.ts
+```
+
+## 🚀 Utilisation rapide
+
+### 1. Import du hook
+
+```tsx
+import { useI18n } from '../hooks/useI18n';
+
+const MyComponent = () => {
+  const { t, locale, setLocale } = useI18n();
+  
+  return (
+    <View>
+      <Text>{t('kyc.title')}</Text>
+      <Button title={t('common.next')} onPress={() => {}} />
+    </View>
+  );
+};
+```
+
+### 2. Changement de langue
+
+```tsx
+const { setLocale, availableLocales } = useI18n();
+
+// Changer la langue
+setLocale('fr');
+
+// Obtenir les langues disponibles
+console.log(availableLocales); // ['en', 'fr']
+```
+
+### 3. Interpolation de variables
+
+```tsx
+// Dans les traductions : "Step {current} of {total}"
+const stepText = t('kyc.step', { current: 1, total: 5 });
+// Résultat : "Step 1 of 5"
+```
+
+### 4. Pluralisation
+
+```tsx
+// Dans les traductions : "You have {count} message(s)"
+const messageText = tPlural('messages.count', 3);
+// Résultat : "You have 3 messages"
+```
+
+## 📝 Clés de traduction disponibles
+
+### Éléments communs
+- `common.next` - "Next" / "Suivant"
+- `common.previous` - "Previous" / "Précédent"
+- `common.continue` - "Continue" / "Continuer"
+- `common.cancel` - "Cancel" / "Annuler"
+- `common.submit` - "Submit" / "Soumettre"
+- `common.retry` - "Retry" / "Réessayer"
+- `common.close` - "Close" / "Fermer"
+- `common.back` - "Back" / "Retour"
+- `common.loading` - "Loading..." / "Chargement..."
+- `common.error` - "Error" / "Erreur"
+- `common.success` - "Success" / "Succès"
+
+### Flux KYC
+- `kyc.title` - "Identity Verification" / "Vérification d'Identité"
+- `kyc.subtitle` - "Complete your identity verification" / "Complétez votre vérification d'identité"
+- `kyc.step` - "Step {current} of {total}" / "Étape {current} sur {total}"
+
+#### Initialisation
+- `kyc.initialization.title` - "Welcome to Identity Verification"
+- `kyc.initialization.description` - "We need to verify your identity..."
+- `kyc.initialization.startButton` - "Start Verification"
+- `kyc.initialization.requirements` - "What you'll need:"
+- `kyc.initialization.requirementsList` - Array des exigences
+
+#### Sélection de pays
+- `kyc.countrySelection.title` - "Select Your Country"
+- `kyc.countrySelection.subtitle` - "Choose the country that issued your ID"
+- `kyc.countrySelection.searchPlaceholder` - "Search for your country..."
+- `kyc.countrySelection.noResults` - "No countries found"
+- `kyc.countrySelection.selectCountry` - "Select Country"
+
+#### Capture de carte d'identité
+- `kyc.idCardCapture.title` - "Capture Your ID Document"
+- `kyc.idCardCapture.subtitle` - "Take a clear photo of your ID document"
+- `kyc.idCardCapture.frontSide` - "Front Side"
+- `kyc.idCardCapture.backSide` - "Back Side"
+- `kyc.idCardCapture.instructions.title` - "Instructions:"
+- `kyc.idCardCapture.instructions.list` - Array des instructions
+- `kyc.idCardCapture.captureButton` - "Capture Photo"
+- `kyc.idCardCapture.retakeButton` - "Retake"
+- `kyc.idCardCapture.usePhotoButton` - "Use This Photo"
+- `kyc.idCardCapture.processing` - "Processing image..."
+- `kyc.idCardCapture.success` - "ID captured successfully"
+- `kyc.idCardCapture.error` - "Failed to capture ID. Please try again."
+
+#### Capture de selfie
+- `kyc.selfieCapture.title` - "Take a Selfie"
+- `kyc.selfieCapture.subtitle` - "Take a clear selfie for identity verification"
+- `kyc.selfieCapture.instructions.title` - "Instructions:"
+- `kyc.selfieCapture.instructions.list` - Array des instructions
+- `kyc.selfieCapture.captureButton` - "Take Selfie"
+- `kyc.selfieCapture.retakeButton` - "Retake"
+- `kyc.selfieCapture.usePhotoButton` - "Use This Photo"
+- `kyc.selfieCapture.processing` - "Processing selfie..."
+- `kyc.selfieCapture.success` - "Selfie captured successfully"
+- `kyc.selfieCapture.error` - "Failed to capture selfie. Please try again."
+
+#### Upload de fichier
+- `kyc.fileUpload.title` - "Upload Document"
+- `kyc.fileUpload.subtitle` - "Upload a clear photo of your document"
+- `kyc.fileUpload.selectFile` - "Select File"
+- `kyc.fileUpload.uploadButton` - "Upload"
+- `kyc.fileUpload.dragDropText` - "Drag and drop your file here..."
+- `kyc.fileUpload.supportedFormats` - "Supported formats: JPG, PNG, PDF"
+- `kyc.fileUpload.maxSize` - "Max file size: 10MB"
+- `kyc.fileUpload.processing` - "Processing file..."
+- `kyc.fileUpload.success` - "File uploaded successfully"
+- `kyc.fileUpload.error` - "Failed to upload file. Please try again."
+
+#### Progrès de vérification
+- `kyc.verificationProgress.title` - "Verifying Your Identity"
+- `kyc.verificationProgress.subtitle` - "Please wait while we verify your information"
+- `kyc.verificationProgress.steps.analyzing` - "Analyzing documents..."
+- `kyc.verificationProgress.steps.extracting` - "Extracting information..."
+- `kyc.verificationProgress.steps.verifying` - "Verifying identity..."
+- `kyc.verificationProgress.steps.complete` - "Verification complete"
+- `kyc.verificationProgress.estimatedTime` - "Estimated time: 2-3 minutes"
+- `kyc.verificationProgress.status.pending` - "Pending"
+- `kyc.verificationProgress.status.processing` - "Processing"
+- `kyc.verificationProgress.status.completed` - "Completed"
+- `kyc.verificationProgress.status.failed` - "Failed"
+
+#### Révision et soumission
+- `kyc.reviewSubmit.title` - "Review Your Information"
+- `kyc.reviewSubmit.subtitle` - "Please review the information we extracted"
+- `kyc.reviewSubmit.personalInfo` - "Personal Information"
+- `kyc.reviewSubmit.documentInfo` - "Document Information"
+- `kyc.reviewSubmit.editButton` - "Edit"
+- `kyc.reviewSubmit.submitButton` - "Submit for Verification"
+- `kyc.reviewSubmit.confirmMessage` - "Are you sure you want to submit this information?"
+- `kyc.reviewSubmit.processing` - "Submitting..."
+- `kyc.reviewSubmit.success` - "Information submitted successfully"
+- `kyc.reviewSubmit.error` - "Failed to submit information. Please try again."
+
+### Caméra et médias
+- `camera.permissionTitle` - "Camera Permission Required"
+- `camera.permissionMessage` - "We need access to your camera..."
+- `camera.permissionButton` - "Grant Permission"
+- `camera.settingsButton` - "Open Settings"
+- `camera.notAvailable` - "Camera not available"
+- `camera.switchCamera` - "Switch Camera"
+- `camera.flashOn` - "Flash On"
+- `camera.flashOff` - "Flash Off"
+- `camera.capturePhoto` - "Capture Photo"
+- `camera.processing` - "Processing..."
+
+### Erreurs
+- `errors.networkError` - "Network error. Please check your connection."
+- `errors.serverError` - "Server error. Please try again later."
+- `errors.validationError` - "Please check your information and try again."
+- `errors.cameraError` - "Camera error. Please try again."
+- `errors.fileError` - "File error. Please try again."
+- `errors.timeoutError` - "Request timeout. Please try again."
+- `errors.unknownError` - "An unknown error occurred. Please try again."
+
+### Validation
+- `validation.required` - "This field is required"
+- `validation.invalidEmail` - "Please enter a valid email address"
+- `validation.invalidPhone` - "Please enter a valid phone number"
+- `validation.invalidDate` - "Please enter a valid date"
+- `validation.minLength` - "Must be at least {min} characters"
+- `validation.maxLength` - "Must be no more than {max} characters"
+- `validation.invalidFormat` - "Invalid format"
+- `validation.fileTooLarge` - "File is too large"
+- `validation.fileTypeNotSupported` - "File type not supported"
+
+## 🔧 Ajouter une nouvelle langue
+
+1. Créer un nouveau dossier dans `src/i18n/` (ex: `es/` pour l'espagnol)
+2. Créer un fichier `index.ts` avec la même structure que `en/index.ts`
+3. Ajouter la nouvelle locale au type `SupportedLocale` dans `types.ts`
+4. Importer et ajouter les traductions dans `src/i18n/index.ts`
+
+## 🔧 Ajouter une nouvelle clé de traduction
+
+1. Ajouter la clé dans tous les fichiers de langue (`en/index.ts`, `fr/index.ts`, etc.)
+2. Mettre à jour les types TypeScript dans `types.ts`
+3. Utiliser la nouvelle clé dans vos composants avec `t('nouvelle.cle')`
+
+## 📱 Exemple d'utilisation complète
+
+```tsx
+import React from 'react';
+import { View, Text, TouchableOpacity } from 'react-native';
+import { useI18n } from '../hooks/useI18n';
+
+const KYCScreen = () => {
+  const { t, locale, setLocale, availableLocales } = useI18n();
+
+  return (
+    <View>
+      {/* Sélecteur de langue */}
+      <View style={{ flexDirection: 'row', gap: 10 }}>
+        {availableLocales.map((loc) => (
+          <TouchableOpacity
+            key={loc}
+            onPress={() => setLocale(loc)}
+            style={{ 
+              padding: 10, 
+              backgroundColor: locale === loc ? '#007AFF' : '#F5F5F5' 
+            }}
+          >
+            <Text style={{ color: locale === loc ? 'white' : 'black' }}>
+              {loc.toUpperCase()}
+            </Text>
+          </TouchableOpacity>
+        ))}
+      </View>
+
+      {/* Contenu traduit */}
+      <Text style={{ fontSize: 24, fontWeight: 'bold' }}>
+        {t('kyc.title')}
+      </Text>
+      
+      <Text style={{ fontSize: 16, marginBottom: 20 }}>
+        {t('kyc.subtitle')}
+      </Text>
+
+      {/* Boutons avec interpolation */}
+      <Text>
+        {t('kyc.step', { current: 1, total: 5 })}
+      </Text>
+
+      {/* Boutons d'action */}
+      <TouchableOpacity style={{ backgroundColor: '#007AFF', padding: 15 }}>
+        <Text style={{ color: 'white', textAlign: 'center' }}>
+          {t('kyc.initialization.startButton')}
+        </Text>
+      </TouchableOpacity>
+    </View>
+  );
+};
+```
+
+## 🎯 Bonnes pratiques
+
+1. **Utilisez des clés descriptives** : `kyc.idCardCapture.instructions.title` au lieu de `instructions`
+2. **Groupez les clés liées** : Utilisez la notation par points pour l'organisation
+3. **Gardez les clés cohérentes** : Utilisez la même structure dans toutes les langues
+4. **Testez toutes les langues** : Assurez-vous que toutes les clés existent dans tous les fichiers de langue
+5. **Utilisez l'interpolation** : Pour le contenu dynamique, utilisez la syntaxe `{variable}`
+6. **Gérez la pluralisation** : Utilisez `tPlural` pour le texte dépendant du nombre
+
+## 🚀 Fonctionnalités avancées
+
+### Support RTL (Right-to-Left)
+Le système détecte automatiquement les langues RTL (arabe, hébreu, etc.) et ajuste l'interface.
+
+### Fallback automatique
+Si une traduction n'est pas trouvée, le système utilise automatiquement la langue par défaut.
+
+### Types TypeScript
+Toutes les traductions sont typées pour une meilleure sécurité et autocomplétion.
+
+### Performance optimisée
+Les traductions sont mises en cache et les re-rendus sont minimisés.
+
+---
+
+**Note** : Ce système est entièrement compatible avec React Native et fonctionne sur iOS, Android et Web.

package/src/i18n/en/index.ts

@@ -0,0 +1,206 @@
+export const en = {
+  // Common UI elements
+  common: {
+    next: 'Next',
+    previous: 'Previous',
+    continue: 'Continue',
+    cancel: 'Cancel',
+    confirm: 'Confirm',
+    submit: 'Submit',
+    retry: 'Retry',
+    close: 'Close',
+    back: 'Back',
+    loading: 'Loading...',
+    error: 'Error',
+    success: 'Success',
+    warning: 'Warning',
+    info: 'Information',
+  },
+
+  // KYC Flow
+  kyc: {
+    title: 'Identity Verification',
+    subtitle: 'Complete your identity verification to continue',
+    step: 'Step %{current} of %{total}',
+    
+    // Initialization
+    initialization: {
+      title: 'Welcome to Identity Verification',
+      description: 'We need to verify your identity to comply with regulations and ensure security.',
+      startButton: 'Start Verification',
+      requirements: 'What you\'ll need:',
+      requirementsList: [
+        'Valid government-issued ID',
+        'Good lighting for photos',
+        'Stable internet connection'
+      ]
+    },
+
+    // Location Capture
+    locationCapture: {
+      title: 'Secure Your Verification',
+      description: 'Allow location access to help us protect your account and prevent fraudulent activity during verification.',
+      howThisHelps: 'How this helps:',
+      howThisHelpsList: '• Verifies your device location matches your identity\n• Detects and prevents unauthorized access\n• Ensures compliance with security regulations',
+      permissionDeniedTitle: 'Permission denied',
+      permissionDeniedMessage: 'Location permission is required to continue.',
+      locationDisabledTitle: 'Location disabled',
+      locationDisabledMessage: 'Please enable location services on your device to continue.',
+      errorTitle: 'Error',
+      errorMessage: 'Unable to retrieve your location. Please try again.',
+      obtained: 'Location obtained',
+      latitudeLabel: 'Latitude',
+      longitudeLabel: 'Longitude',
+      accuracyLabel: 'Accuracy',
+      resetButton: 'Reset',
+      enableButton: 'Enable Location Access',
+      fetching: 'Fetching...'
+    },
+
+    // Country Selection
+    countrySelection: {
+      title: 'Select Your Country',
+      subtitle: 'Choose the country that issued your ID document',
+      searchPlaceholder: 'Search for your country...',
+      noResults: 'No countries found',
+      selectCountry: 'Select Country'
+    },
+
+    // ID Card Capture
+    idCardCapture: {
+      title: 'Capture Your ID Document',
+      subtitle: 'Take a clear photo of your ID document',
+      frontSide: 'Front Side',
+      backSide: 'Back Side',
+      instructions: {
+        title: 'Instructions:',
+        list: [
+          'Place your ID on a flat surface',
+          'Ensure good lighting',
+          'Keep the entire document in frame',
+          'Avoid glare and shadows'
+        ]
+      },
+      captureButton: 'Capture Photo',
+      retakeButton: 'Retake',
+      usePhotoButton: 'Use This Photo',
+      processing: 'Processing image...',
+      success: 'ID captured successfully',
+      error: 'Failed to capture ID. Please try again.'
+    },
+
+    // Selfie Capture
+    selfieCapture: {
+      title: 'Take a Selfie',
+      subtitle: 'Take a clear selfie for identity verification',
+      instructions: {
+        title: 'Instructions:',
+        list: [
+          'Look directly at the camera',
+          'Ensure good lighting on your face',
+          'Remove glasses and hats',
+          'Keep a neutral expression'
+        ]
+      },
+      captureButton: 'Take Selfie',
+      retakeButton: 'Retake',
+      usePhotoButton: 'Use This Photo',
+      processing: 'Processing selfie...',
+      success: 'Selfie captured successfully',
+      error: 'Failed to capture selfie. Please try again.'
+    },
+
+    // File Upload
+    fileUpload: {
+      title: 'Upload Document',
+      subtitle: 'Upload a clear photo of your document',
+      selectFile: 'Select File',
+      uploadButton: 'Upload',
+      dragDropText: 'Drag and drop your file here, or click to select',
+      supportedFormats: 'Supported formats: JPG, PNG, PDF',
+      maxSize: 'Max file size: 10MB',
+      processing: 'Processing file...',
+      success: 'File uploaded successfully',
+      error: 'Failed to upload file. Please try again.'
+    },
+
+    // Verification Progress
+    verificationProgress: {
+      title: 'Verifying Your Identity',
+      subtitle: 'Please wait while we verify your information',
+      steps: {
+        analyzing: 'Analyzing documents...',
+        extracting: 'Extracting information...',
+        verifying: 'Verifying identity...',
+        complete: 'Verification complete'
+      },
+      estimatedTime: 'Estimated time: 2-3 minutes',
+      status: {
+        pending: 'Pending',
+        processing: 'Processing',
+        completed: 'Completed',
+        failed: 'Failed'
+      }
+    },
+
+    // Review and Submit
+    reviewSubmit: {
+      title: 'Review Your Information',
+      subtitle: 'Please review the information we extracted',
+      personalInfo: 'Personal Information',
+      documentInfo: 'Document Information',
+      editButton: 'Edit',
+      submitButton: 'Submit for Verification',
+      confirmMessage: 'Are you sure you want to submit this information?',
+      processing: 'Submitting...',
+      success: 'Information submitted successfully',
+      error: 'Failed to submit information. Please try again.'
+    }
+  },
+
+  // Camera and Media
+  camera: {
+    permissionTitle: 'Camera Permission Required',
+    permissionMessage: 'We need access to your camera to capture your ID and selfie.',
+    permissionButton: 'Grant Permission',
+    settingsButton: 'Open Settings',
+    notAvailable: 'Camera not available',
+    switchCamera: 'Switch Camera',
+    flashOn: 'Flash On',
+    flashOff: 'Flash Off',
+    capturePhoto: 'Capture Photo',
+    processing: 'Processing...',
+    permissionRequired: 'Camera permission required. Please grant permission to continue.',
+    deviceNotAvailable: 'Camera device not available',
+    notReady: 'Camera not ready',
+    analyzing: 'Analyzing...',
+    errorOccurred: 'Camera error occurred',
+    failedToCapture: 'Failed to capture photo',
+    failedToStartRecording: 'Failed to start video recording',
+    failedToStopRecording: 'Failed to stop video recording'
+  },
+
+  // Errors
+  errors: {
+    networkError: 'Network error. Please check your connection.',
+    serverError: 'Server error. Please try again later.',
+    validationError: 'Please check your information and try again.',
+    cameraError: 'Camera error. Please try again.',
+    fileError: 'File error. Please try again.',
+    timeoutError: 'Request timeout. Please try again.',
+    unknownError: 'An unknown error occurred. Please try again.'
+  },
+
+  // Validation messages
+  validation: {
+    required: 'This field is required',
+    invalidEmail: 'Please enter a valid email address',
+    invalidPhone: 'Please enter a valid phone number',
+    invalidDate: 'Please enter a valid date',
+    minLength: 'Must be at least %{min} characters',
+    maxLength: 'Must be no more than %{max} characters',
+    invalidFormat: 'Invalid format',
+    fileTooLarge: 'File is too large',
+    fileTypeNotSupported: 'File type not supported'
+  }
+};