@asafarim/shared-i18n 0.6.6 → 0.8.0

package/demo/src/locales/de/demo.json

@@ -0,0 +1,85 @@
+{
+  "title": "Shared i18n Demo",
+  "subtitle": "Ein leichtgewichtiger React i18next Wrapper mit Cookie-Persistenz.",
+  "cta": "Sprache wechseln",
+  "overview": {
+    "heading": "Übersicht",
+    "description": "@asafarim/shared-i18n ist ein produktionsreifes Internationalisierungspaket (i18n) für React-Anwendungen.",
+    "features": {
+      "title": "Hauptmerkmale",
+      "items": [
+        "Mehrsprachiger Support mit Cookie-Persistenz",
+        "Eingebaute Spracherkennung und Fallback",
+        "TypeScript-Support mit vollständiger Typsicherheit",
+        "Vorkonfiguriert mit gemeinsamen und Identity-Portal-Namespaces",
+        "Nahtlose Integration mit react-i18next",
+        "Backend-Sprachpräferenz-Synchronisation",
+        "SSR-sichere Dienstprogramme für serverseitiges Rendering"
+      ]
+    },
+    "useCases": {
+      "title": "Perfekt für",
+      "items": [
+        "Globale Anwendungen, die mehrsprachigen Support benötigen",
+        "Enterprise-Plattformen mit Benutzer-Sprachpräferenzen",
+        "Identitäts- und Authentifizierungssysteme",
+        "Content-Management-Systeme mit Lokalisierung",
+        "SaaS-Anwendungen, die internationale Benutzer bedienen"
+      ]
+    }
+  },
+  "getStarted": {
+    "heading": "Erste Schritte",
+    "intro": "Erfahren Sie, wie Sie @asafarim/shared-i18n in wenigen Minuten in Ihre React-Anwendung integrieren.",
+    "steps": [
+      {
+        "title": "1. Paket installieren",
+        "description": "Fügen Sie das Paket zu Ihren Projektabhängigkeiten hinzu.",
+        "code": "pnpm add @asafarim/shared-i18n"
+      },
+      {
+        "title": "2. i18n in Ihrer App initialisieren",
+        "description": "Rufen Sie initI18n beim Anwendungsstart auf, um Spracheinstellungen zu konfigurieren.",
+        "code": "import { initI18n } from '@asafarim/shared-i18n';\n\ninitI18n({\n  defaultNS: 'common',\n  ns: ['common', 'identityPortal'],\n  resources: { /* your translations */ }\n});"
+      },
+      {
+        "title": "3. Den useLanguage Hook verwenden",
+        "description": "Greifen Sie auf Sprachwechsel und aktuellen Sprachstatus in Ihren Komponenten zu.",
+        "code": "const { changeLanguage, isChanging } = useLanguage();\n\n<button onClick={() => changeLanguage('nl')}>\n  Zu Niederländisch wechseln\n</button>"
+      },
+      {
+        "title": "4. Mit useTranslation übersetzen",
+        "description": "Verwenden Sie den useTranslation Hook, um auf übersetzte Zeichenfolgen zuzugreifen.",
+        "code": "const { t } = useTranslation('common');\n\n<h1>{t('welcome')}</h1>"
+      },
+      {
+        "title": "5. Cookie-Persistenz nutzen",
+        "description": "Benutzer-Sprachpräferenzen werden automatisch gespeichert und wiederhergestellt.",
+        "code": "// Automatisch über Cookies persistiert\n// Keine zusätzliche Einrichtung erforderlich!"
+      },
+      {
+        "title": "6. Mit Backend synchronisieren (Optional)",
+        "description": "Aktualisieren Sie Benutzer-Sprachpräferenzen auf Ihrem Backend.",
+        "code": "import { updateUserLanguagePreference } from '@asafarim/shared-i18n';\n\nawait updateUserLanguagePreference('en');"
+      }
+    ],
+    "tips": {
+      "title": "Pro-Tipps",
+      "items": [
+        "Verwenden Sie Namespaces, um Übersetzungen nach Funktionen zu organisieren",
+        "Nutzen Sie die Trans-Komponente für komplexe Übersetzungen mit Variablen",
+        "Setzen Sie VITE_IDENTITY_API_URL für Backend-Synchronisation",
+        "Überprüfen Sie die Browser-Spracherkennung mit getInitialLanguage()",
+        "Kombinieren Sie mit Design-Tokens für konsistente Themen über Sprachen hinweg"
+      ]
+    }
+  },
+  "status": {
+    "heading": "Live-Status",
+    "cookie": "Cookie",
+    "backend": "Backend",
+    "simulate": "Backend-Synchronisation simulieren",
+    "resultOk": "Backend-Synchronisation erfolgreich",
+    "resultFail": "Backend-Synchronisation fehlgeschlagen"
+  }
+}

package/demo/src/locales/en/demo.json

@@ -1,85 +1,85 @@
-{
-  "title": "Shared i18n demo",
-  "subtitle": "A lightweight React i18next wrapper with cookie persistence.",
-  "cta": "Switch language",
-  "overview": {
-    "heading": "Overview",
-    "description": "@asafarim/shared-i18n is a production-grade internationalization (i18n) package for React applications.",
-    "features": {
-      "title": "Key Features",
-      "items": [
-        "Multi-language support with cookie persistence",
-        "Built-in language detection and fallback",
-        "TypeScript support with full type safety",
-        "Pre-configured with common and identity-portal namespaces",
-        "Seamless integration with react-i18next",
-        "Backend language preference synchronization",
-        "SSR-safe utilities for server-side rendering"
-      ]
-    },
-    "useCases": {
-      "title": "Perfect For",
-      "items": [
-        "Global applications requiring multi-language support",
-        "Enterprise platforms with user language preferences",
-        "Identity and authentication systems",
-        "Content management systems with localization",
-        "SaaS applications serving international users"
-      ]
-    }
-  },
-  "getStarted": {
-    "heading": "Get Started",
-    "intro": "Learn how to integrate @asafarim/shared-i18n into your React application in minutes.",
-    "steps": [
-      {
-        "title": "1. Install the Package",
-        "description": "Add the package to your project dependencies.",
-        "code": "pnpm add @asafarim/shared-i18n"
-      },
-      {
-        "title": "2. Initialize i18n in Your App",
-        "description": "Call initI18n at application startup to configure language settings.",
-        "code": "import { initI18n } from '@asafarim/shared-i18n';\n\ninitI18n({\n  defaultNS: 'common',\n  ns: ['common', 'identityPortal'],\n  resources: { /* your translations */ }\n});"
-      },
-      {
-        "title": "3. Use the useLanguage Hook",
-        "description": "Access language switching and current language state in your components.",
-        "code": "const { changeLanguage, isChanging } = useLanguage();\n\n<button onClick={() => changeLanguage('nl')}>\n  Switch to Dutch\n</button>"
-      },
-      {
-        "title": "4. Translate with useTranslation",
-        "description": "Use the useTranslation hook to access translated strings.",
-        "code": "const { t } = useTranslation('common');\n\n<h1>{t('welcome')}</h1>"
-      },
-      {
-        "title": "5. Leverage Cookie Persistence",
-        "description": "User language preferences are automatically saved and restored.",
-        "code": "// Automatically persisted via cookies\n// No additional setup required!"
-      },
-      {
-        "title": "6. Sync with Backend (Optional)",
-        "description": "Update user language preferences on your backend.",
-        "code": "import { updateUserLanguagePreference } from '@asafarim/shared-i18n';\n\nawait updateUserLanguagePreference('en');"
-      }
-    ],
-    "tips": {
-      "title": "Pro Tips",
-      "items": [
-        "Use namespaces to organize translations by feature",
-        "Leverage the Trans component for complex translations with variables",
-        "Set VITE_IDENTITY_API_URL for backend synchronization",
-        "Check browser language detection with getInitialLanguage()",
-        "Combine with design tokens for consistent theming across languages"
-      ]
-    }
-  },
-  "status": {
-    "heading": "Live status",
-    "cookie": "Cookie",
-    "backend": "Backend",
-    "simulate": "Simulate backend sync",
-    "resultOk": "Backend sync succeeded",
-    "resultFail": "Backend sync failed"
-  }
-}
+{
+  "title": "Shared i18n demo",
+  "subtitle": "A lightweight React i18next wrapper with cookie persistence.",
+  "cta": "Switch language",
+  "overview": {
+    "heading": "Overview",
+    "description": "@asafarim/shared-i18n is a production-grade internationalization (i18n) package for React applications.",
+    "features": {
+      "title": "Key Features",
+      "items": [
+        "Multi-language support with cookie persistence",
+        "Built-in language detection and fallback",
+        "TypeScript support with full type safety",
+        "Pre-configured with common and identity-portal namespaces",
+        "Seamless integration with react-i18next",
+        "Backend language preference synchronization",
+        "SSR-safe utilities for server-side rendering"
+      ]
+    },
+    "useCases": {
+      "title": "Perfect For",
+      "items": [
+        "Global applications requiring multi-language support",
+        "Enterprise platforms with user language preferences",
+        "Identity and authentication systems",
+        "Content management systems with localization",
+        "SaaS applications serving international users"
+      ]
+    }
+  },
+  "getStarted": {
+    "heading": "Get Started",
+    "intro": "Learn how to integrate @asafarim/shared-i18n into your React application in minutes.",
+    "steps": [
+      {
+        "title": "1. Install the Package",
+        "description": "Add the package to your project dependencies.",
+        "code": "pnpm add @asafarim/shared-i18n"
+      },
+      {
+        "title": "2. Initialize i18n in Your App",
+        "description": "Call initI18n at application startup to configure language settings.",
+        "code": "import { initI18n } from '@asafarim/shared-i18n';\n\ninitI18n({\n  defaultNS: 'common',\n  ns: ['common', 'identityPortal'],\n  resources: { /* your translations */ }\n});"
+      },
+      {
+        "title": "3. Use the useLanguage Hook",
+        "description": "Access language switching and current language state in your components.",
+        "code": "const { changeLanguage, isChanging } = useLanguage();\n\n<button onClick={() => changeLanguage('nl')}>\n  Switch to Dutch\n</button>"
+      },
+      {
+        "title": "4. Translate with useTranslation",
+        "description": "Use the useTranslation hook to access translated strings.",
+        "code": "const { t } = useTranslation('common');\n\n<h1>{t('welcome')}</h1>"
+      },
+      {
+        "title": "5. Leverage Cookie Persistence",
+        "description": "User language preferences are automatically saved and restored.",
+        "code": "// Automatically persisted via cookies\n// No additional setup required!"
+      },
+      {
+        "title": "6. Sync with Backend (Optional)",
+        "description": "Update user language preferences on your backend.",
+        "code": "import { updateUserLanguagePreference } from '@asafarim/shared-i18n';\n\nawait updateUserLanguagePreference('en');"
+      }
+    ],
+    "tips": {
+      "title": "Pro Tips",
+      "items": [
+        "Use namespaces to organize translations by feature",
+        "Leverage the Trans component for complex translations with variables",
+        "Set VITE_IDENTITY_API_URL for backend synchronization",
+        "Check browser language detection with getInitialLanguage()",
+        "Combine with design tokens for consistent theming across languages"
+      ]
+    }
+  },
+  "status": {
+    "heading": "Live status",
+    "cookie": "Cookie",
+    "backend": "Backend",
+    "simulate": "Simulate backend sync",
+    "resultOk": "Backend sync succeeded",
+    "resultFail": "Backend sync failed"
+  }
+}

package/demo/src/locales/fr/demo.json

@@ -1,85 +1,85 @@
-{
-  "title": "Démonstration Shared i18n",
-  "subtitle": "Un wrapper React i18next léger avec persistance des cookies.",
-  "cta": "Changer de langue",
-  "overview": {
-    "heading": "Aperçu",
-    "description": "@asafarim/shared-i18n est un package d'internationalisation (i18n) de qualité production pour les applications React.",
-    "features": {
-      "title": "Fonctionnalités Principales",
-      "items": [
-        "Support multi-langues avec persistance des cookies",
-        "Détection de langue et fallback intégrés",
-        "Support TypeScript avec sécurité typage complet",
-        "Espaces de noms common et identity-portal préconfigurés",
-        "Intégration transparente avec react-i18next",
-        "Synchronisation des préférences de langue avec le backend",
-        "Utilitaires SSR-safe pour le rendu côté serveur"
-      ]
-    },
-    "useCases": {
-      "title": "Idéal Pour",
-      "items": [
-        "Applications globales nécessitant un support multi-langues",
-        "Plateformes enterprise avec préférences de langue utilisateur",
-        "Systèmes d'identité et d'authentification",
-        "Systèmes de gestion de contenu avec localisation",
-        "Applications SaaS servant des utilisateurs internationaux"
-      ]
-    }
-  },
-  "getStarted": {
-    "heading": "Premiers Pas",
-    "intro": "Apprenez à intégrer @asafarim/shared-i18n dans votre application React en quelques minutes.",
-    "steps": [
-      {
-        "title": "1. Installer le Package",
-        "description": "Ajoutez le package aux dépendances de votre projet.",
-        "code": "pnpm add @asafarim/shared-i18n"
-      },
-      {
-        "title": "2. Initialiser i18n dans Votre App",
-        "description": "Appelez initI18n au démarrage de l'application pour configurer les paramètres de langue.",
-        "code": "import { initI18n } from '@asafarim/shared-i18n';\n\ninitI18n({\n  defaultNS: 'common',\n  ns: ['common', 'identityPortal'],\n  resources: /* vos traductions */\n});"
-      },
-      {
-        "title": "3. Utiliser le Hook useLanguage",
-        "description": "Accédez au changement de langue et à l'état de langue actuel dans vos composants.",
-        "code": "const { changeLanguage, isChanging } = useLanguage();\n\n<button onClick={() => changeLanguage('en')}>\n  Vers Anglais\n</button>"
-      },
-      {
-        "title": "4. Traduire avec useTranslation",
-        "description": "Utilisez le hook useTranslation pour accéder aux chaînes traduites.",
-        "code": "const { t } = useTranslation('common');\n\n<h1>{t('welcome')}</h1>"
-      },
-      {
-        "title": "5. Profiter de la Persistance des Cookies",
-        "description": "Les préférences de langue des utilisateurs sont automatiquement sauvegardées et restaurées.",
-        "code": "// Sauvegardé automatiquement via cookies\n// Aucune configuration supplémentaire requise !"
-      },
-      {
-        "title": "6. Synchroniser avec le Backend (Optionnel)",
-        "description": "Mettez à jour les préférences de langue des utilisateurs sur votre backend.",
-        "code": "import { updateUserLanguagePreference } from '@asafarim/shared-i18n';\n\nawait updateUserLanguagePreference('fr');"
-      }
-    ],
-    "tips": {
-      "title": "Conseils Pro",
-      "items": [
-        "Utilisez les espaces de noms pour organiser les traductions par fonctionnalité",
-        "Profitez du composant Trans pour les traductions complexes avec variables",
-        "Configurez VITE_IDENTITY_API_URL pour la synchronisation backend",
-        "Vérifiez la détection de langue du navigateur avec getInitialLanguage()",
-        "Combinez avec les design tokens pour des thèmes cohérents dans toutes les langues"
-      ]
-    }
-  },
-  "status": {
-    "heading": "Statut en direct",
-    "cookie": "Cookie",
-    "backend": "Backend",
-    "simulate": "Simuler la synchronisation backend",
-    "resultOk": "Synchronisation backend réussie",
-    "resultFail": "Échec de la synchronisation backend"
-  }
-}
+{
+  "title": "Démonstration Shared i18n",
+  "subtitle": "Un wrapper React i18next léger avec persistance des cookies.",
+  "cta": "Changer de langue",
+  "overview": {
+    "heading": "Aperçu",
+    "description": "@asafarim/shared-i18n est un package d'internationalisation (i18n) de qualité production pour les applications React.",
+    "features": {
+      "title": "Fonctionnalités Principales",
+      "items": [
+        "Support multi-langues avec persistance des cookies",
+        "Détection de langue et fallback intégrés",
+        "Support TypeScript avec sécurité typage complet",
+        "Espaces de noms common et identity-portal préconfigurés",
+        "Intégration transparente avec react-i18next",
+        "Synchronisation des préférences de langue avec le backend",
+        "Utilitaires SSR-safe pour le rendu côté serveur"
+      ]
+    },
+    "useCases": {
+      "title": "Idéal Pour",
+      "items": [
+        "Applications globales nécessitant un support multi-langues",
+        "Plateformes enterprise avec préférences de langue utilisateur",
+        "Systèmes d'identité et d'authentification",
+        "Systèmes de gestion de contenu avec localisation",
+        "Applications SaaS servant des utilisateurs internationaux"
+      ]
+    }
+  },
+  "getStarted": {
+    "heading": "Premiers Pas",
+    "intro": "Apprenez à intégrer @asafarim/shared-i18n dans votre application React en quelques minutes.",
+    "steps": [
+      {
+        "title": "1. Installer le Package",
+        "description": "Ajoutez le package aux dépendances de votre projet.",
+        "code": "pnpm add @asafarim/shared-i18n"
+      },
+      {
+        "title": "2. Initialiser i18n dans Votre App",
+        "description": "Appelez initI18n au démarrage de l'application pour configurer les paramètres de langue.",
+        "code": "import { initI18n } from '@asafarim/shared-i18n';\n\ninitI18n({\n  defaultNS: 'common',\n  ns: ['common', 'identityPortal'],\n  resources: /* vos traductions */\n});"
+      },
+      {
+        "title": "3. Utiliser le Hook useLanguage",
+        "description": "Accédez au changement de langue et à l'état de langue actuel dans vos composants.",
+        "code": "const { changeLanguage, isChanging } = useLanguage();\n\n<button onClick={() => changeLanguage('en')}>\n  Vers Anglais\n</button>"
+      },
+      {
+        "title": "4. Traduire avec useTranslation",
+        "description": "Utilisez le hook useTranslation pour accéder aux chaînes traduites.",
+        "code": "const { t } = useTranslation('common');\n\n<h1>{t('welcome')}</h1>"
+      },
+      {
+        "title": "5. Profiter de la Persistance des Cookies",
+        "description": "Les préférences de langue des utilisateurs sont automatiquement sauvegardées et restaurées.",
+        "code": "// Sauvegardé automatiquement via cookies\n// Aucune configuration supplémentaire requise !"
+      },
+      {
+        "title": "6. Synchroniser avec le Backend (Optionnel)",
+        "description": "Mettez à jour les préférences de langue des utilisateurs sur votre backend.",
+        "code": "import { updateUserLanguagePreference } from '@asafarim/shared-i18n';\n\nawait updateUserLanguagePreference('fr');"
+      }
+    ],
+    "tips": {
+      "title": "Conseils Pro",
+      "items": [
+        "Utilisez les espaces de noms pour organiser les traductions par fonctionnalité",
+        "Profitez du composant Trans pour les traductions complexes avec variables",
+        "Configurez VITE_IDENTITY_API_URL pour la synchronisation backend",
+        "Vérifiez la détection de langue du navigateur avec getInitialLanguage()",
+        "Combinez avec les design tokens pour des thèmes cohérents dans toutes les langues"
+      ]
+    }
+  },
+  "status": {
+    "heading": "Statut en direct",
+    "cookie": "Cookie",
+    "backend": "Backend",
+    "simulate": "Simuler la synchronisation backend",
+    "resultOk": "Synchronisation backend réussie",
+    "resultFail": "Échec de la synchronisation backend"
+  }
+}

package/demo/src/locales/it/demo.json

@@ -0,0 +1,85 @@
+{
+  "title": "Demo i18n condiviso",
+  "subtitle": "Un wrapper leggero React i18next con persistenza dei cookie.",
+  "cta": "Cambia lingua",
+  "overview": {
+    "heading": "Panoramica",
+    "description": "@asafarim/shared-i18n è un pacchetto di internazionalizzazione (i18n) di livello produzione per applicazioni React.",
+    "features": {
+      "title": "Caratteristiche Principali",
+      "items": [
+        "Supporto multi-lingua con persistenza dei cookie",
+        "Rilevamento automatico della lingua e fallback",
+        "Supporto TypeScript con sicurezza completa dei tipi",
+        "Pre-configurato con namespace comuni e identity-portal",
+        "Integrazione perfetta con react-i18next",
+        "Sincronizzazione delle preferenze linguistiche del backend",
+        "Utilità sicure per SSR per il rendering lato server"
+      ]
+    },
+    "useCases": {
+      "title": "Perfetto Per",
+      "items": [
+        "Applicazioni globali che richiedono supporto multi-lingua",
+        "Piattaforme enterprise con preferenze linguistiche degli utenti",
+        "Sistemi di identità e autenticazione",
+        "Sistemi di gestione contenuti con localizzazione",
+        "Applicazioni SaaS che servono utenti internazionali"
+      ]
+    }
+  },
+  "getStarted": {
+    "heading": "Inizia",
+    "intro": "Scopri come integrare @asafarim/shared-i18n nella tua applicazione React in pochi minuti.",
+    "steps": [
+      {
+        "title": "1. Installa il Pacchetto",
+        "description": "Aggiungi il pacchetto alle dipendenze del tuo progetto.",
+        "code": "pnpm add @asafarim/shared-i18n"
+      },
+      {
+        "title": "2. Inizializza i18n nella Tua App",
+        "description": "Chiama initI18n all'avvio dell'applicazione per configurare le impostazioni linguistiche.",
+        "code": "import { initI18n } from '@asafarim/shared-i18n';\n\ninitI18n({\n  defaultNS: 'common',\n  ns: ['common', 'identityPortal'],\n  resources: { /* your translations */ }\n});"
+      },
+      {
+        "title": "3. Usa l'Hook useLanguage",
+        "description": "Accedi al cambio lingua e allo stato della lingua corrente nei tuoi componenti.",
+        "code": "const { changeLanguage, isChanging } = useLanguage();\n\n<button onClick={() => changeLanguage('nl')}>\n  Passa all'olandese\n</button>"
+      },
+      {
+        "title": "4. Traduci con useTranslation",
+        "description": "Usa l'hook useTranslation per accedere alle stringhe tradotte.",
+        "code": "const { t } = useTranslation('common');\n\n<h1>{t('welcome')}</h1>"
+      },
+      {
+        "title": "5. Sfrutta la Persistenza dei Cookie",
+        "description": "Le preferenze linguistiche degli utenti vengono automaticamente salvate e ripristinate.",
+        "code": "// Automaticamente persistito tramite cookie\n// Nessuna configurazione aggiuntiva richiesta!"
+      },
+      {
+        "title": "6. Sincronizza con il Backend (Opzionale)",
+        "description": "Aggiorna le preferenze linguistiche degli utenti sul tuo backend.",
+        "code": "import { updateUserLanguagePreference } from '@asafarim/shared-i18n';\n\nawait updateUserLanguagePreference('en');"
+      }
+    ],
+    "tips": {
+      "title": "Suggerimenti Pro",
+      "items": [
+        "Usa i namespace per organizzare le traduzioni per funzionalità",
+        "Sfrutta il componente Trans per traduzioni complesse con variabili",
+        "Imposta VITE_IDENTITY_API_URL per la sincronizzazione del backend",
+        "Verifica il rilevamento della lingua del browser con getInitialLanguage()",
+        "Combina con i design token per un tema consistente tra le lingue"
+      ]
+    }
+  },
+  "status": {
+    "heading": "Stato live",
+    "cookie": "Cookie",
+    "backend": "Backend",
+    "simulate": "Simula sincronizzazione backend",
+    "resultOk": "Sincronizzazione backend riuscita",
+    "resultFail": "Sincronizzazione backend fallita"
+  }
+}