@adminiumjs/i18n 0.1.2 → 0.2.2-rc.0

package/dist/react.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+// SPDX-License-Identifier: AGPL-3.0-only
 /**
  * React bindings for `@adminium/i18n` (separate entry so the framework-free
  * core — server emails, jobs, CLI — never pulls React in; §2.2). Deliberately
@@ -6,10 +7,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * plus hooks bound to the active locale. The `t()` call signature matches the
  * dashboard's key+fallback convention.
  */
-import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
-import { IntlMessageFormat } from 'intl-messageformat';
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, useSyncExternalStore, } from 'react';
+import { formatFallback } from './fallback.js';
 import { getFormatters } from './format/index.js';
 import { isRtlLocale, localeFromTag, tagForLocale } from './locales.js';
+import { getI18nRevision, subscribeI18nRevision } from './revision.js';
 const I18nContext = createContext(null);
 export function I18nProvider({ i18n, children }) {
     const [locale, setLocale] = useState(() => localeFromTag(i18n.language ?? 'en-US'));
@@ -23,7 +25,8 @@ export function I18nProvider({ i18n, children }) {
             i18n.off('languageChanged', onChanged);
         };
     }, [i18n]);
-    const value = useMemo(() => ({ i18n, locale }), [i18n, locale]);
+    const revision = useSyncExternalStore(subscribeI18nRevision, getI18nRevision, getI18nRevision);
+    const value = useMemo(() => ({ i18n, locale, revision }), [i18n, locale, revision]);
     return _jsx(I18nContext.Provider, { value: value, children: children });
 }
 function useI18nContext(hook) {
@@ -46,33 +49,19 @@ export function useRtl() {
 }
 /** Translator bound to the provider instance: `t(key, fallback, args?)`. */
 export function useT() {
-    const { i18n, locale } = useI18nContext('useT()');
+    const { i18n, locale, revision } = useI18nContext('useT()');
     return useCallback((key, fallback, args) => i18n.t(key, { defaultValue: fallback, ...args }), 
-    // `locale` is a dependency on purpose: a language switch re-binds the
-    // callback so memoized consumers re-render with fresh strings.
-    [i18n, locale]);
+    // `locale` and `revision` are dependencies on purpose: a language switch
+    // OR a runtime-override change re-binds the callback, so memoized
+    // consumers re-render with fresh strings either way (23 §4.4).
+    [i18n, locale, revision]);
 }
 /** Provider context, or `null` outside an `<I18nProvider>` (advanced probe). */
 export function useMaybeI18n() {
     return useContext(I18nContext);
 }
-// Fallback-path message cache for `useMaybeT` (mirrors IcuFormat.parse's).
-const fallbackMessageCache = new Map();
-function formatFallback(fallback, args) {
-    if (args === undefined || !fallback.includes('{'))
-        return fallback;
-    try {
-        let message = fallbackMessageCache.get(fallback);
-        if (message === undefined) {
-            message = new IntlMessageFormat(fallback, 'en-US', undefined, { ignoreTag: true });
-            fallbackMessageCache.set(fallback, message);
-        }
-        return String(message.format(args));
-    }
-    catch {
-        return fallback;
-    }
-}
+// Shared with the dashboard's module-level `t()` so the two no-instance
+// paths cannot drift (see fallback.ts).
 /**
  * `useT` for packages whose components must also render OUTSIDE an
  * `<I18nProvider>` (widget chrome in bare tests/Storybook/embeds): inside a
@@ -84,9 +73,12 @@ export function useMaybeT() {
     const context = useContext(I18nContext);
     const i18n = context?.i18n;
     const locale = context?.locale;
+    // Outside a provider there is no context revision to depend on, so subscribe
+    // directly — a widget rendered in an embed still has to pick up an edit.
+    const revision = useSyncExternalStore(subscribeI18nRevision, getI18nRevision, getI18nRevision);
     return useCallback((key, fallback, args) => i18n === undefined ? formatFallback(fallback, args) : i18n.t(key, { defaultValue: fallback, ...args }), 
-    // `locale` re-binds on language switch, same as `useT`.
-    [i18n, locale]);
+    // `locale`/`revision` re-bind on a switch or an override change, as in `useT`.
+    [i18n, locale, revision]);
 }
 /** Locale-bound Intl formatters (10 §4.1) — `useFmt().number(…)` etc. */
 export function useFmt() {

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}