@asafarim/shared-i18n 0.5.2 → 0.6.0

package/demo/src/index.css

@@ -0,0 +1,569 @@
+@import "@asafarim/design-tokens/css";
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: var(--asm-font-family-base, 'Inter', sans-serif);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  background-color: var(--asm-color-bg);
+  color: var(--asm-color-text);
+}
+
+.app-container {
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+}
+
+.app-header {
+  background-color: var(--asm-color-primary-600);
+  color: var(--asm-color-bg);
+  padding: var(--asm-space-10);
+  box-shadow: var(--asm-effect-shadow-md);
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: var(--asm-space-6);
+  flex-wrap: wrap;
+}
+
+.header-content {
+  flex: 1;
+  min-width: 300px;
+}
+
+.app-header h1 {
+  font-size: 2rem;
+  margin-bottom: var(--asm-space-2);
+}
+
+.subtitle {
+  font-size: 0.95rem;
+  opacity: 0.9;
+}
+
+.app-main {
+  flex: 1;
+  max-width: 1200px;
+  width: 100%;
+  margin: 0 auto;
+  padding: var(--asm-space-10);
+  gap: var(--asm-space-10);
+  display: flex;
+  flex-direction: column;
+}
+
+.panel {
+  background-color: var(--asm-color-surface);
+  border: 1px solid var(--asm-color-border);
+  border-radius: var(--asm-radius-lg);
+  padding: var(--asm-space-6);
+  box-shadow: var(--asm-effect-shadow-sm);
+}
+
+.panel-title {
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin-bottom: var(--asm-space-4);
+  color: var(--asm-color-text);
+}
+
+.panel-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
+  gap: var(--asm-space-6);
+}
+
+.panel-grid h3 {
+  font-size: 1rem;
+  margin-bottom: var(--asm-space-3);
+  color: var(--asm-color-text-muted);
+}
+
+.key-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.9rem;
+}
+
+.key-table th,
+.key-table td {
+  padding: var(--asm-space-4);
+  text-align: left;
+  border-bottom: 1px solid var(--asm-color-border);
+}
+
+.key-table th {
+  background-color: var(--asm-color-surface-muted);
+  font-weight: 600;
+  color: var(--asm-color-text-muted);
+}
+
+.key-table tr:hover {
+  background-color: var(--asm-color-surface-muted);
+}
+
+.language-bar {
+  display: flex;
+  gap: var(--asm-space-3);
+}
+
+.lang-button {
+  padding: var(--asm-space-2) var(--asm-space-4);
+  border: 2px solid var(--asm-color-bg);
+  background-color: transparent;
+  color: var(--asm-color-bg);
+  border-radius: var(--asm-radius-md);
+  cursor: pointer;
+  font-size: 0.95rem;
+  font-weight: 500;
+  transition: all 0.2s ease;
+}
+
+.lang-button:hover:not(:disabled) {
+  background-color: var(--asm-color-button-ghost-bg-hover);
+}
+
+.lang-button.active {
+  background-color: var(--asm-color-bg);
+  color: var(--asm-color-primary-600);
+}
+
+.lang-button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
+.interpolation-demo {
+  display: flex;
+  flex-direction: column;
+  gap: var(--asm-space-6);
+}
+
+.demo-item {
+  padding: var(--asm-space-6);
+  background-color: var(--asm-color-surface-muted);
+  border-radius: var(--asm-radius-md);
+  border-left: 4px solid var(--asm-color-primary-600);
+}
+
+.demo-item h4 {
+  font-size: 0.95rem;
+  margin-bottom: var(--asm-space-3);
+  color: var(--asm-color-text-muted);
+}
+
+.demo-output {
+  font-size: 1rem;
+  color: var(--asm-color-text);
+  font-weight: 500;
+}
+
+.status-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+  gap: var(--asm-space-6);
+}
+
+.status-card {
+  background-color: var(--asm-color-surface-muted);
+  border: 1px solid var(--asm-color-border);
+  border-radius: var(--asm-radius-md);
+  padding: var(--asm-space-6);
+}
+
+.status-card h4 {
+  font-size: 0.9rem;
+  color: var(--asm-color-text-muted);
+  margin-bottom: var(--asm-space-2);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.status-card p {
+  font-size: 1rem;
+  color: var(--asm-color-text);
+  word-break: break-all;
+}
+
+.status-list {
+  list-style: none;
+  margin-top: var(--asm-space-3);
+}
+
+.status-list li {
+  padding: var(--asm-space-2) 0;
+  color: var(--asm-color-text);
+  font-size: 0.95rem;
+}
+
+.sync-button {
+  margin-top: var(--asm-space-4);
+  padding: var(--asm-space-3) var(--asm-space-6);
+  background-color: var(--asm-color-button-primary-bg);
+  color: var(--asm-color-button-primary-text);
+  border: none;
+  border-radius: var(--asm-radius-md);
+  cursor: pointer;
+  font-size: 0.95rem;
+  font-weight: 500;
+  transition: all 0.2s ease;
+}
+
+.sync-button:hover:not(:disabled) {
+  background-color: var(--asm-color-button-primary-bg-hover);
+  box-shadow: var(--asm-effect-shadow-sm);
+}
+
+.sync-button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
+.sync-result {
+  margin-top: var(--asm-space-3);
+  padding: var(--asm-space-4);
+  border-radius: var(--asm-radius-md);
+  font-size: 0.9rem;
+}
+
+.sync-result.success {
+  background-color: var(--asm-color-success-100);
+  color: var(--asm-color-success-600);
+  border: 1px solid var(--asm-color-success-200);
+}
+
+.sync-result.error {
+  background-color: var(--asm-color-danger-100);
+  color: var(--asm-color-danger-600);
+  border: 1px solid var(--asm-color-danger-200);
+}
+
+.nav-tabs {
+  display: flex;
+  gap: var(--asm-space-2);
+  margin-bottom: var(--asm-space-6);
+  border-bottom: 2px solid var(--asm-color-border);
+  overflow-x: auto;
+}
+
+.nav-tab {
+  padding: var(--asm-space-3) var(--asm-space-4);
+  background: none;
+  border: none;
+  border-bottom: 3px solid transparent;
+  color: var(--asm-color-text-muted);
+  cursor: pointer;
+  font-size: 0.95rem;
+  font-weight: 500;
+  transition: all var(--asm-motion-duration-normal) var(--asm-motion-easing-standard);
+  white-space: nowrap;
+}
+
+.nav-tab:hover {
+  color: var(--asm-color-text);
+}
+
+.nav-tab.active {
+  color: var(--asm-color-primary-600);
+  border-bottom-color: var(--asm-color-primary-600);
+}
+
+.overview-section {
+  animation: fadeIn var(--asm-motion-duration-normal) var(--asm-motion-easing-standard);
+}
+
+.overview-header {
+  margin-bottom: var(--asm-space-8);
+}
+
+.overview-title {
+  font-size: 2rem;
+  font-weight: 700;
+  color: var(--asm-color-text);
+  margin-bottom: var(--asm-space-3);
+}
+
+.overview-description {
+  font-size: 1.125rem;
+  color: var(--asm-color-text-muted);
+  line-height: 1.6;
+}
+
+.overview-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(380px, 1fr));
+  gap: var(--asm-space-6);
+}
+
+.feature-card {
+  background: linear-gradient(135deg, var(--asm-color-surface) 0%, var(--asm-color-surface-muted) 100%);
+  border: 1px solid var(--asm-color-border);
+  border-radius: var(--asm-radius-lg);
+  padding: var(--asm-space-6);
+  transition: all var(--asm-motion-duration-normal) var(--asm-motion-easing-standard);
+}
+
+.feature-card:hover {
+  transform: translateY(-4px);
+  box-shadow: var(--asm-effect-shadow-lg);
+  border-color: var(--asm-color-primary-600);
+}
+
+.feature-icon {
+  font-size: 2.5rem;
+  margin-bottom: var(--asm-space-3);
+  display: inline-block;
+}
+
+.feature-card h3 {
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: var(--asm-color-text);
+  margin-bottom: var(--asm-space-4);
+}
+
+.feature-list {
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: var(--asm-space-3);
+}
+
+.feature-list li {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--asm-space-2);
+  color: var(--asm-color-text);
+  line-height: 1.5;
+}
+
+.feature-dot {
+  color: var(--asm-color-primary-600);
+  font-weight: bold;
+  flex-shrink: 0;
+}
+
+.get-started-section {
+  animation: fadeIn var(--asm-motion-duration-normal) var(--asm-motion-easing-standard);
+}
+
+.gs-header {
+  margin-bottom: var(--asm-space-8);
+}
+
+.gs-title {
+  font-size: 2rem;
+  font-weight: 700;
+  color: var(--asm-color-text);
+  margin-bottom: var(--asm-space-3);
+}
+
+.gs-intro {
+  font-size: 1.125rem;
+  color: var(--asm-color-text-muted);
+  line-height: 1.6;
+}
+
+.steps-container {
+  display: flex;
+  flex-direction: column;
+  gap: var(--asm-space-4);
+  margin-bottom: var(--asm-space-8);
+}
+
+.step-item {
+  border: 1px solid var(--asm-color-border);
+  border-radius: var(--asm-radius-lg);
+  overflow: hidden;
+  transition: all var(--asm-motion-duration-normal) var(--asm-motion-easing-standard);
+}
+
+.step-item:hover {
+  border-color: var(--asm-color-primary-600);
+  box-shadow: var(--asm-effect-shadow-md);
+}
+
+.step-header {
+  width: 100%;
+  display: flex;
+  align-items: center;
+  gap: var(--asm-space-4);
+  padding: var(--asm-space-4) var(--asm-space-6);
+  background-color: var(--asm-color-surface);
+  border: none;
+  cursor: pointer;
+  transition: all var(--asm-motion-duration-normal) var(--asm-motion-easing-standard);
+}
+
+.step-header:hover {
+  background-color: var(--asm-color-surface-muted);
+}
+
+.step-header.expanded {
+  background-color: var(--asm-color-surface-muted);
+}
+
+.step-number {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  border-radius: var(--asm-radius-full);
+  background: linear-gradient(135deg, var(--asm-color-primary-600) 0%, var(--asm-color-primary-700) 100%);
+  color: white;
+  font-weight: 700;
+  font-size: 1.125rem;
+  flex-shrink: 0;
+}
+
+.step-info {
+  flex: 1;
+  text-align: left;
+}
+
+.step-info h3 {
+  font-size: 1rem;
+  font-weight: 600;
+  color: var(--asm-color-text);
+  margin-bottom: var(--asm-space-1);
+}
+
+.step-info p {
+  font-size: 0.9rem;
+  color: var(--asm-color-text-muted);
+}
+
+.step-toggle {
+  font-size: 1.5rem;
+  color: var(--asm-color-primary-600);
+  font-weight: bold;
+  flex-shrink: 0;
+}
+
+.step-content {
+  padding: var(--asm-space-6);
+  background-color: var(--asm-color-surface-muted);
+  border-top: 1px solid var(--asm-color-border);
+  animation: slideDown var(--asm-motion-duration-normal) var(--asm-motion-easing-standard);
+}
+
+.code-block {
+  background-color: var(--asm-color-text);
+  color: var(--asm-color-bg);
+  padding: var(--asm-space-4);
+  border-radius: var(--asm-radius-md);
+  overflow-x: auto;
+  font-family: var(--asm-font-family-mono, monospace);
+  font-size: 0.85rem;
+  line-height: 1.5;
+  margin: 0;
+}
+
+.tips-section {
+  display: flex;
+  gap: var(--asm-space-6);
+  padding: var(--asm-space-6);
+  background: linear-gradient(135deg, var(--asm-color-primary-50) 0%, var(--asm-color-secondary-50) 100%);
+  border: 2px solid var(--asm-color-primary-200);
+  border-radius: var(--asm-radius-lg);
+}
+
+.tips-icon {
+  font-size: 2rem;
+  flex-shrink: 0;
+}
+
+.tips-content h3 {
+  font-size: 1.125rem;
+  font-weight: 600;
+  color: var(--asm-color-text);
+  margin-bottom: var(--asm-space-3);
+}
+
+.tips-list {
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: var(--asm-space-2);
+}
+
+.tips-list li {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--asm-space-2);
+  color: var(--asm-color-text);
+  font-size: 0.95rem;
+  line-height: 1.5;
+}
+
+.tips-list li::before {
+  content: "✓";
+  color: var(--asm-color-semantic-success);
+  font-weight: bold;
+  flex-shrink: 0;
+}
+
+@media (max-width: 768px) {
+  .app-header {
+    flex-direction: column;
+  }
+
+  .app-main {
+    padding: var(--asm-space-6);
+  }
+
+  .panel-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .app-header h1 {
+    font-size: 1.5rem;
+  }
+
+  .overview-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .tips-section {
+    flex-direction: column;
+  }
+
+  .step-header {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .step-toggle {
+    align-self: flex-end;
+    margin-top: calc(var(--asm-space-4) * -1);
+  }
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(8px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes slideDown {
+  from {
+    opacity: 0;
+    max-height: 0;
+  }
+  to {
+    opacity: 1;
+    max-height: 500px;
+  }
+}

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

@@ -0,0 +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"
+  }
+}