@object-ui/i18n 0.5.0 → 3.0.0

package/src/__tests__/spec-formatters.test.ts

@@ -0,0 +1,208 @@
+import { describe, it, expect } from 'vitest';
+import {
+  resolvePlural,
+  formatDateSpec,
+  formatNumberSpec,
+  applyLocaleConfig,
+  type SpecPluralRule,
+} from '../utils/spec-formatters';
+
+// ============================================================================
+// PluralRuleSchema Consumer Tests
+// ============================================================================
+
+describe('resolvePlural', () => {
+  const rule: SpecPluralRule = {
+    key: 'items.count',
+    zero: 'No items',
+    one: '{count} item',
+    other: '{count} items',
+  };
+
+  it('should resolve zero form', () => {
+    // English 'other' is used for 0 by Intl.PluralRules, but 'zero' is explicitly checked
+    // In English, 0 maps to "other" category, but we fall back to rule.other
+    const result = resolvePlural(rule, 0, 'en');
+    expect(result).toBe('0 items');
+  });
+
+  it('should resolve one form', () => {
+    expect(resolvePlural(rule, 1, 'en')).toBe('1 item');
+  });
+
+  it('should resolve other form for plural', () => {
+    expect(resolvePlural(rule, 5, 'en')).toBe('5 items');
+  });
+
+  it('should fallback to other when form is not defined', () => {
+    const simpleRule: SpecPluralRule = {
+      key: 'items',
+      other: '{count} things',
+    };
+    expect(resolvePlural(simpleRule, 3, 'en')).toBe('3 things');
+  });
+
+  it('should work with different locales', () => {
+    const ruleWithTwo: SpecPluralRule = {
+      key: 'items',
+      one: '{count} element',
+      two: '{count} éléments (dual)',
+      other: '{count} éléments',
+    };
+    // Arabic has a 'two' plural category
+    expect(resolvePlural(ruleWithTwo, 2, 'ar')).toBe('2 éléments (dual)');
+  });
+});
+
+// ============================================================================
+// DateFormatSchema Consumer Tests
+// ============================================================================
+
+describe('formatDateSpec', () => {
+  it('should format date with dateStyle', () => {
+    const date = new Date('2026-02-11T12:00:00Z');
+    const result = formatDateSpec(date, { dateStyle: 'short' }, 'en-US');
+    expect(result).toBeTruthy();
+    expect(typeof result).toBe('string');
+  });
+
+  it('should return string for invalid date', () => {
+    expect(formatDateSpec('invalid-date', { dateStyle: 'medium' })).toBe('invalid-date');
+  });
+
+  it('should handle timeZone', () => {
+    const date = new Date('2026-02-11T12:00:00Z');
+    const result = formatDateSpec(date, {
+      dateStyle: 'medium',
+      timeZone: 'America/New_York',
+    }, 'en-US');
+    expect(result).toBeTruthy();
+  });
+
+  it('should handle hour12 option', () => {
+    const date = new Date('2026-02-11T15:30:00Z');
+    const result12 = formatDateSpec(date, { timeStyle: 'short', hour12: true }, 'en-US');
+    const result24 = formatDateSpec(date, { timeStyle: 'short', hour12: false }, 'en-US');
+    expect(result12).toBeTruthy();
+    expect(result24).toBeTruthy();
+  });
+});
+
+// ============================================================================
+// NumberFormatSchema Consumer Tests
+// ============================================================================
+
+describe('formatNumberSpec', () => {
+  it('should format decimal numbers', () => {
+    const result = formatNumberSpec(1234.56, { style: 'decimal' }, 'en-US');
+    expect(result).toContain('1,234');
+  });
+
+  it('should format currency', () => {
+    const result = formatNumberSpec(42.99, {
+      style: 'currency',
+      currency: 'USD',
+    }, 'en-US');
+    expect(result).toContain('$');
+    expect(result).toContain('42.99');
+  });
+
+  it('should format percentage', () => {
+    const result = formatNumberSpec(0.75, { style: 'percent' }, 'en-US');
+    expect(result).toContain('75');
+    expect(result).toContain('%');
+  });
+
+  it('should respect fraction digits', () => {
+    const result = formatNumberSpec(3.14159, {
+      style: 'decimal',
+      maximumFractionDigits: 2,
+    }, 'en-US');
+    expect(result).toBe('3.14');
+  });
+
+  it('should respect useGrouping', () => {
+    const withGrouping = formatNumberSpec(1234567, {
+      style: 'decimal',
+      useGrouping: true,
+    }, 'en-US');
+    const withoutGrouping = formatNumberSpec(1234567, {
+      style: 'decimal',
+      useGrouping: false,
+    }, 'en-US');
+    expect(withGrouping).toContain(',');
+    expect(withoutGrouping).not.toContain(',');
+  });
+});
+
+// ============================================================================
+// LocaleConfigSchema Consumer Tests
+// ============================================================================
+
+describe('applyLocaleConfig', () => {
+  it('should create bound formatting functions', () => {
+    const locale = applyLocaleConfig({
+      code: 'en-US',
+      direction: 'ltr',
+      numberFormat: { style: 'decimal', useGrouping: true },
+      dateFormat: { dateStyle: 'medium' },
+    });
+
+    expect(locale.code).toBe('en-US');
+    expect(locale.direction).toBe('ltr');
+    expect(locale.fallbackChain).toEqual([]);
+  });
+
+  it('should format dates using configured locale', () => {
+    const locale = applyLocaleConfig({
+      code: 'en-US',
+      dateFormat: { dateStyle: 'short' },
+    });
+
+    const result = locale.formatDate(new Date('2026-02-11'));
+    expect(result).toBeTruthy();
+  });
+
+  it('should format numbers using configured locale', () => {
+    const locale = applyLocaleConfig({
+      code: 'en-US',
+      numberFormat: { style: 'decimal', maximumFractionDigits: 2 },
+    });
+
+    const result = locale.formatNumber(1234.5678);
+    expect(result).toBeTruthy();
+  });
+
+  it('should allow overrides in formatting calls', () => {
+    const locale = applyLocaleConfig({
+      code: 'en-US',
+      numberFormat: { style: 'decimal' },
+    });
+
+    const result = locale.formatNumber(42.99, {
+      style: 'currency',
+      currency: 'EUR',
+    });
+    expect(result).toContain('€');
+  });
+
+  it('should resolve plurals with configured locale', () => {
+    const locale = applyLocaleConfig({
+      code: 'en',
+    });
+
+    const rule: SpecPluralRule = {
+      key: 'items',
+      one: '{count} item',
+      other: '{count} items',
+    };
+
+    expect(locale.resolvePlural(rule, 1)).toBe('1 item');
+    expect(locale.resolvePlural(rule, 5)).toBe('5 items');
+  });
+
+  it('should default direction to ltr', () => {
+    const locale = applyLocaleConfig({ code: 'en' });
+    expect(locale.direction).toBe('ltr');
+  });
+});

package/src/index.ts

@@ -61,3 +61,15 @@ export {
   type CurrencyFormatOptions,
   type NumberFormatOptions,
 } from './utils/index';
+
+// Spec-aligned formatters (v2.0.7)
+export {
+  resolvePlural,
+  formatDateSpec,
+  formatNumberSpec,
+  applyLocaleConfig,
+  type SpecPluralRule,
+  type SpecDateFormat,
+  type SpecNumberFormat,
+  type SpecLocaleConfig,
+} from './utils/index';

package/src/locales/ar.ts

@@ -99,6 +99,74 @@ const ar = {
     saveLayout: 'حفظ التخطيط',
     resetLayout: 'إعادة تعيين التخطيط',
   },
+  console: {
+    title: 'وحدة تحكم ObjectStack',
+    initializing: 'جاري تهيئة التطبيق...',
+    loadingSteps: {
+      connecting: 'جاري الاتصال بمصدر البيانات',
+      loadingConfig: 'جاري تحميل الإعدادات',
+      preparingWorkspace: 'جاري تجهيز مساحة العمل',
+    },
+    shortcuts: {
+      title: 'اختصارات لوحة المفاتيح',
+      description: 'مرجع سريع لجميع اختصارات لوحة المفاتيح المتاحة.',
+      groups: { general: 'عام', navigation: 'التنقل', dataViews: 'عروض البيانات', preferences: 'التفضيلات' },
+      openCommandPalette: 'فتح لوحة الأوامر',
+      showShortcuts: 'عرض اختصارات لوحة المفاتيح',
+      closeDialog: 'إغلاق النافذة / اللوحة',
+      toggleSidebar: 'تبديل الشريط الجانبي',
+      focusSearch: 'التركيز على البحث',
+      createRecord: 'إنشاء سجل جديد',
+      refreshData: 'تحديث البيانات',
+      editRecord: 'تعديل السجل المحدد',
+      toggleDarkMode: 'تبديل الوضع الداكن',
+    },
+    commandPalette: {
+      placeholder: 'اكتب أمراً أو ابحث...',
+      noResults: 'لم يتم العثور على نتائج.',
+      objects: 'الكائنات',
+      dashboards: 'لوحات المعلومات',
+      pages: 'الصفحات',
+      reports: 'التقارير',
+      switchApp: 'تبديل التطبيق',
+      current: 'الحالي',
+      preferences: 'التفضيلات',
+      lightTheme: 'المظهر الفاتح',
+      darkTheme: 'المظهر الداكن',
+      systemTheme: 'مظهر النظام',
+      actions: 'الإجراءات',
+      openFullSearch: 'فتح صفحة البحث الكاملة',
+    },
+    errors: {
+      somethingWentWrong: 'حدث خطأ ما',
+      unexpectedError: 'حدث خطأ غير متوقع أثناء عرض هذا المحتوى.',
+      tryAgain: 'إعادة المحاولة',
+      goHome: 'العودة للرئيسية',
+      errorDetails: 'تفاصيل الخطأ (وضع التطوير فقط)',
+    },
+    theme: {
+      toggle: 'تبديل المظهر',
+      light: 'فاتح',
+      dark: 'داكن',
+      system: 'النظام',
+    },
+    objectView: {
+      objectNotFound: 'الكائن غير موجود',
+      objectNotFoundDescription: 'الكائن "{{objectName}}" غير موجود في الإعدادات الحالية.',
+      objectNotFoundHint: 'تحقق من إعدادات التنقل في تطبيقك أو اختر كائنًا آخر من الشريط الجانبي.',
+      allRecords: 'جميع السجلات',
+      exitDesignMode: 'الخروج من وضع التصميم',
+      enterDesignMode: 'الدخول إلى وضع التصميم',
+      metadataInspector: 'مفتش البيانات الوصفية',
+      editView: 'تعديل العرض',
+      addView: 'إضافة عرض',
+      designTools: 'أدوات التصميم',
+      new: 'جديد',
+    },
+    localeSwitcher: {
+      label: 'اللغة',
+    },
+  },
   errors: {
     networkError: 'خطأ في الشبكة. يرجى التحقق من اتصالك.',
     serverError: 'خطأ في الخادم. يرجى المحاولة مرة أخرى لاحقاً.',

package/src/locales/de.ts

@@ -98,6 +98,79 @@ const de = {
     saveLayout: 'Layout speichern',
     resetLayout: 'Layout zurücksetzen',
   },
+  console: {
+    title: 'ObjectStack Konsole',
+    initializing: 'Anwendung wird initialisiert...',
+    loadingSteps: {
+      connecting: 'Verbindung zur Datenquelle herstellen',
+      loadingConfig: 'Konfiguration laden',
+      preparingWorkspace: 'Arbeitsbereich vorbereiten',
+    },
+    shortcuts: {
+      title: 'Tastenkürzel',
+      description: 'Kurzreferenz für alle verfügbaren Tastenkürzel.',
+      groups: {
+        general: 'Allgemein',
+        navigation: 'Navigation',
+        dataViews: 'Datenansichten',
+        preferences: 'Einstellungen',
+      },
+      openCommandPalette: 'Befehlspalette öffnen',
+      showShortcuts: 'Tastenkürzel anzeigen',
+      closeDialog: 'Dialog / Panel schließen',
+      toggleSidebar: 'Seitenleiste umschalten',
+      focusSearch: 'Suche fokussieren',
+      createRecord: 'Neuen Datensatz erstellen',
+      refreshData: 'Daten aktualisieren',
+      editRecord: 'Ausgewählten Datensatz bearbeiten',
+      toggleDarkMode: 'Dunkelmodus umschalten',
+    },
+    commandPalette: {
+      placeholder: 'Befehl eingeben oder suchen...',
+      noResults: 'Keine Ergebnisse gefunden.',
+      objects: 'Objekte',
+      dashboards: 'Dashboards',
+      pages: 'Seiten',
+      reports: 'Berichte',
+      switchApp: 'App wechseln',
+      current: 'Aktuell',
+      preferences: 'Einstellungen',
+      lightTheme: 'Helles Design',
+      darkTheme: 'Dunkles Design',
+      systemTheme: 'Systemdesign',
+      actions: 'Aktionen',
+      openFullSearch: 'Vollständige Suchseite öffnen',
+    },
+    errors: {
+      somethingWentWrong: 'Etwas ist schiefgelaufen',
+      unexpectedError: 'Beim Rendern dieser Ansicht ist ein unerwarteter Fehler aufgetreten.',
+      tryAgain: 'Erneut versuchen',
+      goHome: 'Zur Startseite',
+      errorDetails: 'Fehlerdetails (nur Entwicklung)',
+    },
+    theme: {
+      toggle: 'Design umschalten',
+      light: 'Hell',
+      dark: 'Dunkel',
+      system: 'System',
+    },
+    objectView: {
+      objectNotFound: 'Objekt nicht gefunden',
+      objectNotFoundDescription: 'Das Objekt „{{objectName}}" existiert in der aktuellen Konfiguration nicht.',
+      objectNotFoundHint: 'Überprüfen Sie Ihre App-Navigationseinstellungen oder wählen Sie ein anderes Objekt aus der Seitenleiste.',
+      allRecords: 'Alle Datensätze',
+      exitDesignMode: 'Designmodus beenden',
+      enterDesignMode: 'Designmodus starten',
+      metadataInspector: 'Metadaten-Inspektor',
+      editView: 'Ansicht bearbeiten',
+      addView: 'Ansicht hinzufügen',
+      designTools: 'Design-Werkzeuge',
+      new: 'Neu',
+    },
+    localeSwitcher: {
+      label: 'Sprache',
+    },
+  },
   errors: {
     networkError: 'Netzwerkfehler. Bitte überprüfen Sie Ihre Verbindung.',
     serverError: 'Serverfehler. Bitte versuchen Sie es später erneut.',

package/src/locales/en.ts

@@ -98,6 +98,79 @@ const en = {
     saveLayout: 'Save layout',
     resetLayout: 'Reset layout',
   },
+  console: {
+    title: 'ObjectStack Console',
+    initializing: 'Initializing application...',
+    loadingSteps: {
+      connecting: 'Connecting to data source',
+      loadingConfig: 'Loading configuration',
+      preparingWorkspace: 'Preparing workspace',
+    },
+    shortcuts: {
+      title: 'Keyboard Shortcuts',
+      description: 'Quick reference for all available keyboard shortcuts.',
+      groups: {
+        general: 'General',
+        navigation: 'Navigation',
+        dataViews: 'Data Views',
+        preferences: 'Preferences',
+      },
+      openCommandPalette: 'Open command palette',
+      showShortcuts: 'Show keyboard shortcuts',
+      closeDialog: 'Close dialog / panel',
+      toggleSidebar: 'Toggle sidebar',
+      focusSearch: 'Focus search',
+      createRecord: 'Create new record',
+      refreshData: 'Refresh data',
+      editRecord: 'Edit selected record',
+      toggleDarkMode: 'Toggle dark mode',
+    },
+    commandPalette: {
+      placeholder: 'Type a command or search...',
+      noResults: 'No results found.',
+      objects: 'Objects',
+      dashboards: 'Dashboards',
+      pages: 'Pages',
+      reports: 'Reports',
+      switchApp: 'Switch App',
+      current: 'Current',
+      preferences: 'Preferences',
+      lightTheme: 'Light Theme',
+      darkTheme: 'Dark Theme',
+      systemTheme: 'System Theme',
+      actions: 'Actions',
+      openFullSearch: 'Open Full Search Page',
+    },
+    errors: {
+      somethingWentWrong: 'Something went wrong',
+      unexpectedError: 'An unexpected error occurred while rendering this view.',
+      tryAgain: 'Try Again',
+      goHome: 'Go Home',
+      errorDetails: 'Error Details (dev only)',
+    },
+    theme: {
+      toggle: 'Toggle theme',
+      light: 'Light',
+      dark: 'Dark',
+      system: 'System',
+    },
+    objectView: {
+      objectNotFound: 'Object Not Found',
+      objectNotFoundDescription: 'The object "{{objectName}}" does not exist in the current configuration.',
+      objectNotFoundHint: 'Check your app navigation settings or select a different object from the sidebar.',
+      allRecords: 'All Records',
+      exitDesignMode: 'Exit Design Mode',
+      enterDesignMode: 'Enter Design Mode',
+      metadataInspector: 'Metadata Inspector',
+      editView: 'Edit View',
+      addView: 'Add View',
+      designTools: 'Design tools',
+      new: 'New',
+    },
+    localeSwitcher: {
+      label: 'Language',
+    },
+  },
   errors: {
     networkError: 'Network error. Please check your connection.',
     serverError: 'Server error. Please try again later.',

package/src/locales/es.ts

@@ -98,6 +98,74 @@ const es = {
     saveLayout: 'Guardar diseño',
     resetLayout: 'Restablecer diseño',
   },
+  console: {
+    title: 'Consola ObjectStack',
+    initializing: 'Inicializando aplicación...',
+    loadingSteps: {
+      connecting: 'Conectando a la fuente de datos',
+      loadingConfig: 'Cargando configuración',
+      preparingWorkspace: 'Preparando espacio de trabajo',
+    },
+    shortcuts: {
+      title: 'Atajos de teclado',
+      description: 'Referencia rápida de todos los atajos de teclado disponibles.',
+      groups: { general: 'General', navigation: 'Navegación', dataViews: 'Vistas de datos', preferences: 'Preferencias' },
+      openCommandPalette: 'Abrir paleta de comandos',
+      showShortcuts: 'Mostrar atajos de teclado',
+      closeDialog: 'Cerrar diálogo / panel',
+      toggleSidebar: 'Alternar barra lateral',
+      focusSearch: 'Enfocar búsqueda',
+      createRecord: 'Crear nuevo registro',
+      refreshData: 'Actualizar datos',
+      editRecord: 'Editar registro seleccionado',
+      toggleDarkMode: 'Alternar modo oscuro',
+    },
+    commandPalette: {
+      placeholder: 'Escriba un comando o busque...',
+      noResults: 'No se encontraron resultados.',
+      objects: 'Objetos',
+      dashboards: 'Paneles',
+      pages: 'Páginas',
+      reports: 'Informes',
+      switchApp: 'Cambiar aplicación',
+      current: 'Actual',
+      preferences: 'Preferencias',
+      lightTheme: 'Tema claro',
+      darkTheme: 'Tema oscuro',
+      systemTheme: 'Tema del sistema',
+      actions: 'Acciones',
+      openFullSearch: 'Abrir página de búsqueda completa',
+    },
+    errors: {
+      somethingWentWrong: 'Algo salió mal',
+      unexpectedError: 'Ocurrió un error inesperado al renderizar esta vista.',
+      tryAgain: 'Intentar de nuevo',
+      goHome: 'Ir al inicio',
+      errorDetails: 'Detalles del error (solo desarrollo)',
+    },
+    theme: {
+      toggle: 'Cambiar tema',
+      light: 'Claro',
+      dark: 'Oscuro',
+      system: 'Sistema',
+    },
+    objectView: {
+      objectNotFound: 'Objeto no encontrado',
+      objectNotFoundDescription: 'El objeto "{{objectName}}" no existe en la configuración actual.',
+      objectNotFoundHint: 'Verifique la configuración de navegación de su aplicación o seleccione un objeto diferente en la barra lateral.',
+      allRecords: 'Todos los registros',
+      exitDesignMode: 'Salir del modo de diseño',
+      enterDesignMode: 'Entrar en modo de diseño',
+      metadataInspector: 'Inspector de metadatos',
+      editView: 'Editar vista',
+      addView: 'Agregar vista',
+      designTools: 'Herramientas de diseño',
+      new: 'Nuevo',
+    },
+    localeSwitcher: {
+      label: 'Idioma',
+    },
+  },
   errors: {
     networkError: 'Error de red. Por favor, compruebe su conexión.',
     serverError: 'Error del servidor. Por favor, inténtelo de nuevo más tarde.',

package/src/locales/fr.ts

@@ -98,6 +98,79 @@ const fr = {
     saveLayout: 'Enregistrer la mise en page',
     resetLayout: 'Réinitialiser la mise en page',
   },
+  console: {
+    title: 'Console ObjectStack',
+    initializing: "Initialisation de l'application...",
+    loadingSteps: {
+      connecting: 'Connexion à la source de données',
+      loadingConfig: 'Chargement de la configuration',
+      preparingWorkspace: "Préparation de l'espace de travail",
+    },
+    shortcuts: {
+      title: 'Raccourcis clavier',
+      description: 'Référence rapide de tous les raccourcis clavier disponibles.',
+      groups: {
+        general: 'Général',
+        navigation: 'Navigation',
+        dataViews: 'Vues de données',
+        preferences: 'Préférences',
+      },
+      openCommandPalette: 'Ouvrir la palette de commandes',
+      showShortcuts: 'Afficher les raccourcis clavier',
+      closeDialog: 'Fermer le dialogue / panneau',
+      toggleSidebar: 'Basculer la barre latérale',
+      focusSearch: 'Focus sur la recherche',
+      createRecord: 'Créer un nouvel enregistrement',
+      refreshData: 'Actualiser les données',
+      editRecord: "Modifier l'enregistrement sélectionné",
+      toggleDarkMode: 'Basculer le mode sombre',
+    },
+    commandPalette: {
+      placeholder: 'Tapez une commande ou recherchez...',
+      noResults: 'Aucun résultat trouvé.',
+      objects: 'Objets',
+      dashboards: 'Tableaux de bord',
+      pages: 'Pages',
+      reports: 'Rapports',
+      switchApp: "Changer d'application",
+      current: 'Actuel',
+      preferences: 'Préférences',
+      lightTheme: 'Thème clair',
+      darkTheme: 'Thème sombre',
+      systemTheme: 'Thème système',
+      actions: 'Actions',
+      openFullSearch: 'Ouvrir la page de recherche complète',
+    },
+    errors: {
+      somethingWentWrong: "Quelque chose s'est mal passé",
+      unexpectedError: 'Une erreur inattendue est survenue lors du rendu de cette vue.',
+      tryAgain: 'Réessayer',
+      goHome: "Retour à l'accueil",
+      errorDetails: 'Détails de l\'erreur (développement uniquement)',
+    },
+    theme: {
+      toggle: 'Changer de thème',
+      light: 'Clair',
+      dark: 'Sombre',
+      system: 'Système',
+    },
+    objectView: {
+      objectNotFound: 'Objet introuvable',
+      objectNotFoundDescription: 'L\'objet « {{objectName}} » n\'existe pas dans la configuration actuelle.',
+      objectNotFoundHint: 'Vérifiez les paramètres de navigation de votre application ou sélectionnez un autre objet dans la barre latérale.',
+      allRecords: 'Tous les enregistrements',
+      exitDesignMode: 'Quitter le mode conception',
+      enterDesignMode: 'Entrer en mode conception',
+      metadataInspector: 'Inspecteur de métadonnées',
+      editView: 'Modifier la vue',
+      addView: 'Ajouter une vue',
+      designTools: 'Outils de conception',
+      new: 'Nouveau',
+    },
+    localeSwitcher: {
+      label: 'Langue',
+    },
+  },
   errors: {
     networkError: 'Erreur réseau. Veuillez vérifier votre connexion.',
     serverError: 'Erreur serveur. Veuillez réessayer plus tard.',