@strato-admin/i18n 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vadim Gubergrits
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @strato-admin/i18n
+
+Strato Admin I18n - ICU i18nProvider for React Admin / Strato Admin.

package/dist/hash.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Simple FNV-1a hash for generating stable message IDs.
+ * This is lightweight and works identically in Node and the Browser.
+ */
+export declare function generateMessageId(msg: string): string;

package/dist/hash.js

@@ -0,0 +1,14 @@
+/**
+ * Simple FNV-1a hash for generating stable message IDs.
+ * This is lightweight and works identically in Node and the Browser.
+ */
+export function generateMessageId(msg) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < msg.length; i++) {
+        hash ^= msg.charCodeAt(i);
+        // FNV-1a prime multiplication (hash * 16777619)
+        hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+    }
+    // Convert to a base36 string for a compact, stable ID
+    return (hash >>> 0).toString(36);
+}

package/dist/icuI18nProvider.d.ts

@@ -0,0 +1,2 @@
+import type { I18nProvider } from '@strato-admin/core';
+export declare const icuI18nProvider: (getMessages: (locale: string) => any | Promise<any>, initialLocale?: string, availableLocales?: any[]) => I18nProvider;

package/dist/icuI18nProvider.js

@@ -0,0 +1,80 @@
+import { IntlMessageFormat } from 'intl-messageformat';
+import { generateMessageId } from './hash';
+export const icuI18nProvider = (getMessages, initialLocale = 'en', availableLocales = [{ locale: 'en', name: 'English' }]) => {
+    let locale = initialLocale;
+    let messages = getMessages(initialLocale);
+    const formatters = new Map();
+    if (messages instanceof Promise) {
+        throw new Error(`The i18nProvider returned a Promise for the messages of the default locale (${initialLocale}). Please update your i18nProvider to return the messages of the default locale in a synchronous way.`);
+    }
+    return {
+        translate: (key, options = {}) => {
+            let finalKey = key;
+            let finalOptions = options;
+            // Handle React Admin's special validation error format
+            if (typeof key === 'string' && key.startsWith('@@react-admin@@')) {
+                try {
+                    const parsed = JSON.parse(key.substring(15)); // 15 is the length of '@@react-admin@@'
+                    if (typeof parsed === 'object' && parsed !== null) {
+                        finalKey = parsed.message;
+                        finalOptions = { ...options, ...parsed.args };
+                    }
+                    else {
+                        finalKey = parsed;
+                    }
+                }
+                catch (e) {
+                    // Fallback to original key if parsing fails
+                }
+            }
+            const { _: defaultMessage, ...values } = finalOptions;
+            // 1. Generate the hash ID for the English key
+            const msgid = generateMessageId(finalKey);
+            // 2. Lookup by hash first, then fall back to literal key (for ra.* keys)
+            const message = messages[msgid] || messages[finalKey];
+            if (message === undefined) {
+                return defaultMessage !== undefined ? defaultMessage : finalKey;
+            }
+            if (typeof message !== 'string') {
+                return finalKey;
+            }
+            const cacheKey = `${locale}_${finalKey}`;
+            let formatter = formatters.get(cacheKey);
+            if (!formatter) {
+                try {
+                    formatter = new IntlMessageFormat(message, locale);
+                    formatters.set(cacheKey, formatter);
+                }
+                catch (error) {
+                    console.error(`Error parsing message for key "${finalKey}":`, error);
+                    return defaultMessage !== undefined ? defaultMessage : finalKey;
+                }
+            }
+            try {
+                return formatter.format(values);
+            }
+            catch (error) {
+                console.error(`Error formatting message for key "${finalKey}":`, error);
+                return defaultMessage !== undefined ? defaultMessage : finalKey;
+            }
+        },
+        changeLocale: (newLocale) => {
+            const newMessages = getMessages(newLocale);
+            if (newMessages instanceof Promise) {
+                return newMessages.then((resolvedMessages) => {
+                    locale = newLocale;
+                    messages = resolvedMessages;
+                    formatters.clear();
+                });
+            }
+            else {
+                locale = newLocale;
+                messages = newMessages;
+                formatters.clear();
+                return Promise.resolve();
+            }
+        },
+        getLocale: () => locale,
+        getLocales: () => availableLocales,
+    };
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './icuI18nProvider';
+export * from './hash';

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './icuI18nProvider';
+export * from './hash';

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@strato-admin/i18n",
+  "version": "0.1.0",
+  "description": "Strato Admin I18n - ICU i18nProvider for React Admin / Strato Admin",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "strato",
+    "admin",
+    "react-admin",
+    "i18n",
+    "icu"
+  ],
+  "author": "Vadim Gubergrits <vadim.gubergrits@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vgrits/strato-admin.git",
+    "directory": "packages/strato-i18n"
+  },
+  "peerDependencies": {
+    "@strato-admin/core": "0.1.0"
+  },
+  "dependencies": {
+    "intl-messageformat": "^11.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.7",
+    "@strato-admin/ra-core": "^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run"
+  }
+}

package/src/hash.ts

@@ -0,0 +1,14 @@
+/**
+ * Simple FNV-1a hash for generating stable message IDs.
+ * This is lightweight and works identically in Node and the Browser.
+ */
+export function generateMessageId(msg: string): string {
+  let hash = 0x811c9dc5;
+  for (let i = 0; i < msg.length; i++) {
+    hash ^= msg.charCodeAt(i);
+    // FNV-1a prime multiplication (hash * 16777619)
+    hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+  }
+  // Convert to a base36 string for a compact, stable ID
+  return (hash >>> 0).toString(36);
+}

package/src/icuI18nProvider.ts

@@ -0,0 +1,94 @@
+import { IntlMessageFormat } from 'intl-messageformat';
+import type { I18nProvider, TranslationMessages } from '@strato-admin/core';
+import { generateMessageId } from './hash';
+
+export const icuI18nProvider = (
+  getMessages: (locale: string) => any | Promise<any>,
+  initialLocale: string = 'en',
+  availableLocales: any[] = [{ locale: 'en', name: 'English' }],
+): I18nProvider => {
+  let locale = initialLocale;
+  let messages = getMessages(initialLocale);
+  const formatters = new Map<string, IntlMessageFormat>();
+
+  if (messages instanceof Promise) {
+    throw new Error(
+      `The i18nProvider returned a Promise for the messages of the default locale (${initialLocale}). Please update your i18nProvider to return the messages of the default locale in a synchronous way.`,
+    );
+  }
+
+  return {
+    translate: (key: string, options: any = {}) => {
+      let finalKey = key;
+      let finalOptions = options;
+
+      // Handle React Admin's special validation error format
+      if (typeof key === 'string' && key.startsWith('@@react-admin@@')) {
+        try {
+          const parsed = JSON.parse(key.substring(15)); // 15 is the length of '@@react-admin@@'
+          if (typeof parsed === 'object' && parsed !== null) {
+            finalKey = parsed.message;
+            finalOptions = { ...options, ...parsed.args };
+          } else {
+            finalKey = parsed;
+          }
+        } catch (e) {
+          // Fallback to original key if parsing fails
+        }
+      }
+
+      const { _: defaultMessage, ...values } = finalOptions;
+
+      // 1. Generate the hash ID for the English key
+      const msgid = generateMessageId(finalKey);
+      
+      // 2. Lookup by hash first, then fall back to literal key (for ra.* keys)
+      const message = (messages as any)[msgid] || (messages as any)[finalKey];
+
+      if (message === undefined) {
+        return defaultMessage !== undefined ? defaultMessage : finalKey;
+      }
+
+      if (typeof message !== 'string') {
+        return finalKey;
+      }
+
+      const cacheKey = `${locale}_${finalKey}`;
+      let formatter = formatters.get(cacheKey);
+
+      if (!formatter) {
+        try {
+          formatter = new IntlMessageFormat(message, locale);
+          formatters.set(cacheKey, formatter);
+        } catch (error) {
+          console.error(`Error parsing message for key "${finalKey}":`, error);
+          return defaultMessage !== undefined ? defaultMessage : finalKey;
+        }
+      }
+
+      try {
+        return formatter.format(values) as string;
+      } catch (error) {
+        console.error(`Error formatting message for key "${finalKey}":`, error);
+        return defaultMessage !== undefined ? defaultMessage : finalKey;
+      }
+    },
+    changeLocale: (newLocale: string) => {
+      const newMessages = getMessages(newLocale);
+      if (newMessages instanceof Promise) {
+        return newMessages.then((resolvedMessages) => {
+          locale = newLocale;
+          messages = resolvedMessages;
+          formatters.clear();
+        });
+      } else {
+        locale = newLocale;
+        messages = newMessages;
+        formatters.clear();
+        return Promise.resolve();
+      }
+    },
+    getLocale: () => locale,
+    getLocales: () => availableLocales,
+  };
+};

package/src/index.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect } from 'vitest';
+import { icuI18nProvider } from './index';
+
+describe('icuI18nProvider', () => {
+  const getMessages = (locale: string) => {
+    if (locale === 'en') {
+      return {
+        simple: 'Hello',
+        withParam: 'Hello {name}',
+        plural: 'You have {count, plural, =0 {no messages} one {1 message} other {# messages}}.',
+        'nested.key': 'Nested value',
+      };
+    }
+    if (locale === 'fr') {
+      return {
+        simple: 'Bonjour',
+      };
+    }
+    return {};
+  };
+
+  it('translates simple keys', () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.translate('simple')).toBe('Hello');
+  });
+
+  it('translates keys with parameters', () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.translate('withParam', { name: 'World' })).toBe('Hello World');
+  });
+
+  it('translates plural keys', () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.translate('plural', { count: 0 })).toBe('You have no messages.');
+    expect(i18n.translate('plural', { count: 1 })).toBe('You have 1 message.');
+    expect(i18n.translate('plural', { count: 2 })).toBe('You have 2 messages.');
+  });
+
+  it('translates keys with dots (flat)', () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.translate('nested.key')).toBe('Nested value');
+  });
+
+  it('uses fallback if key is missing', () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.translate('missing', { _: 'Fallback' })).toBe('Fallback');
+  });
+
+  it('returns key if missing and no fallback provided', () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.translate('missing')).toBe('missing');
+  });
+
+  it('changes locale and updates translations', async () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.getLocale()).toBe('en');
+    expect(i18n.translate('simple')).toBe('Hello');
+
+    await i18n.changeLocale('fr');
+    expect(i18n.getLocale()).toBe('fr');
+    expect(i18n.translate('simple')).toBe('Bonjour');
+  });
+
+  it('clears formatters cache when locale changes', async () => {
+    const i18n = icuI18nProvider(getMessages, 'en');
+    expect(i18n.translate('simple')).toBe('Hello');
+
+    await i18n.changeLocale('fr');
+    // If cache wasn't cleared, it would still return "Hello" (as it's keyed by key and locale but let's be sure)
+    expect(i18n.translate('simple')).toBe('Bonjour');
+  });
+});

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './icuI18nProvider';
+export * from './hash';