@burdenoff/fe-libs 2026.1007.4 → 2026.1007.6

package/dist/shared/providers/shell/I18nProvider.d.ts

@@ -1,23 +1,76 @@
 import { ReactNode } from 'react';
+import { TranslationPersistence } from './translationStore';
 export type Locale = 'en' | 'es' | 'fr' | 'de' | 'ja' | 'zh' | 'ta' | 'hi' | 'ar';
+export type TextDirection = 'ltr' | 'rtl';
+/**
+ * How the provider decides the document's text direction (BOFF-8060, F6).
+ *
+ * - `off` (the default): the provider never touches `dir`; every locale renders
+ *   LTR, exactly as before. Existing component CSS across fe-libs and the
+ *   microfrontends still uses physical Tailwind utilities (`ml-`, `left-`,
+ *   `text-left`, `translate-x`), which mirror wrongly under `dir="rtl"`:
+ *   sidebars and icon gaps on the wrong side, drawers sliding from the wrong
+ *   edge, chevrons pointing backwards. Arabic stays LTR until that sweep lands.
+ * - `locale`: `dir` follows `LOCALE_DIRECTION` (Arabic RTL). For products whose
+ *   UI has been swept to logical utilities.
+ * - `rtl`: force RTL whatever the locale. A QA preview (`?dir=rtl`) for
+ *   checking a sweep in production before any user sees RTL.
+ */
+export type DirectionMode = 'off' | 'locale' | 'rtl';
+/** Script direction of each supported locale. */
+export declare const LOCALE_DIRECTION: Readonly<Record<Locale, TextDirection>>;
+/** Direction of a locale code (`ar`, `ar-EG`); unknown codes are LTR. */
+export declare function localeDirection(code: string): TextDirection;
+/** The direction the document renders in under a mode. */
+export declare function directionFor(mode: DirectionMode, locale: string): TextDirection;
 export interface TranslationDictionary {
     [key: string]: string | TranslationDictionary;
 }
+/**
+ * Where one locale's dictionary stands (BOFF-8823).
+ *
+ * - `loading`: a fetch for it is in flight. A persisted copy (F3) may already be
+ *   on screen meanwhile, but it can predate a newly seeded key, so a consumer
+ *   waiting for a word in this locale keeps waiting until the download settles.
+ * - `ready`: the download settled with a dictionary applied (the fresh one, or
+ *   the cached copy when the revalidation came back partial or failed), or this
+ *   session already holds a complete one.
+ * - `failed`: the fetch settled with nothing; the static fallback is in force.
+ */
+export type LocaleLoadStatus = 'loading' | 'ready' | 'failed';
 export interface I18nContextValue {
     locale: Locale;
     translations: TranslationDictionary;
     setLocale: (locale: Locale) => void;
     t: (key: string, fallbackOrParams?: string | Record<string, string | number>, params?: Record<string, string | number>) => string;
-    /** Whether translations are currently being fetched */
+    /** Whether ANY locale's translations are being fetched. */
     isLoading: boolean;
     /** Error message if translation fetch failed */
     error: string | null;
+    /**
+     * Per-locale readiness. Wait on the locale you need, not on `isLoading`: a
+     * fetch for another locale settling says nothing about yours.
+     */
+    localeStatus: Readonly<Partial<Record<Locale, LocaleLoadStatus>>>;
+    /** Whether the dictionary for `code` (`hi`, `hi-IN`) is still being fetched. */
+    isLocaleLoading: (code: string) => boolean;
+    /** The document's text direction under the provider's direction mode. */
+    dir: TextDirection;
 }
 /**
  * Function to fetch translations for a specific locale.
  * Used when dynamic API-based translations are enabled.
  */
 export type FetchTranslationsFn = (locale: Locale) => Promise<TranslationDictionary>;
+/**
+ * A fetch that can say whether what it returns is the whole dictionary.
+ * An incomplete result is shown but never cached as the session's answer.
+ */
+export interface TranslationLoadResult {
+    translations: TranslationDictionary;
+    complete: boolean;
+}
+export type LoadTranslationsFn = (locale: Locale) => Promise<TranslationLoadResult>;
 export interface I18nProviderProps {
     children: ReactNode;
     defaultLocale?: Locale;
@@ -36,8 +89,33 @@ export interface I18nProviderProps {
      * Optional function to fetch translations dynamically from an API.
      * When provided, translations will be fetched on mount and locale change.
      * Static translations prop is used as fallback during loading or on error.
+     * A non-empty result counts as complete.
      */
     fetchTranslations?: FetchTranslationsFn;
+    /**
+     * Like `fetchTranslations`, but reports whether the result is complete.
+     * Takes precedence when both are given.
+     */
+    loadTranslations?: LoadTranslationsFn;
+    /**
+     * Names the dictionary being fetched (e.g. `healthybowl+workspaces`). The
+     * in-memory and persistent caches are keyed by scope AND locale, so two
+     * providers fetching different dictionaries never serve each other's.
+     */
+    cacheScope?: string;
+    /**
+     * A persistent cache: the last complete dictionary is applied at once on the
+     * next load and revalidated in the background. Default: none.
+     */
+    persistence?: TranslationPersistence | null;
+    /**
+     * For a non-English locale with `persistence`, hold the FIRST paint up to
+     * this long for the cached dictionary, so the page does not flash English
+     * before it. 0 (the default) never holds.
+     */
+    firstPaintHoldMs?: number;
+    /** Text direction handling. Default `off`: the document stays LTR. */
+    directionMode?: DirectionMode;
     /**
      * Whether to show children during initial translation fetch.
      * Default: true (show children with fallback translations while loading)
@@ -59,8 +137,18 @@ export interface I18nProviderProps {
  *   drop static keys for the same locale.
  */
 export declare function mergeTranslationDictionaries(base: TranslationDictionary | undefined, override: TranslationDictionary | undefined): TranslationDictionary;
-export declare function I18nProvider({ children, defaultLocale, translations: staticTranslations, storageKey, profileId, fetchTranslations, showChildrenWhileLoading, loadingComponent, }: I18nProviderProps): import('react/jsx-runtime').JSX.Element;
+/** Whether `code`'s locale is `loading` in a status map (primary-tag match). */
+export declare function isLocaleLoadingIn(status: Readonly<Partial<Record<Locale, LocaleLoadStatus>>>, code: string): boolean;
+export declare function I18nProvider({ children, defaultLocale, translations: staticTranslations, storageKey, profileId, fetchTranslations, loadTranslations, cacheScope, persistence, firstPaintHoldMs, directionMode, showChildrenWhileLoading, loadingComponent, }: I18nProviderProps): import('react/jsx-runtime').JSX.Element;
 export declare function useI18n(): I18nContextValue;
+/**
+ * The i18n context, or null outside an `I18nProvider`.
+ *
+ * For presentation components that must also render standalone (a host or a
+ * test without the shell): they fall back to their English copy instead of
+ * throwing.
+ */
+export declare function useOptionalI18n(): I18nContextValue | null;
 /**
  * Clear the global translation cache.
  * Call this to force a refetch of translations on the next component mount.
@@ -68,8 +156,8 @@ export declare function useI18n(): I18nContextValue;
  */
 export declare function clearTranslationCache(): void;
 /**
- * Check if translations have been attempted for a locale.
+ * Check whether a complete dictionary is cached for a locale (in a scope).
  * Useful for debugging.
  */
-export declare function isTranslationAttempted(locale: Locale): boolean;
+export declare function isTranslationAttempted(locale: Locale, scope?: string): boolean;
 //# sourceMappingURL=I18nProvider.d.ts.map

package/dist/shared/providers/shell/I18nProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"I18nProvider.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/I18nProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAWlF,MAAM,WAAW,qBAAqB;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,qBAAqB,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,qBAAqB,CAAC;IACpC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,CAAC,EAAE,CACD,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACrC,MAAM,CAAC;IACZ,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAID;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B;AAoED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,qBAAqB,GAAG,SAAS,EACvC,QAAQ,EAAE,qBAAqB,GAAG,SAAS,GAC1C,qBAAqB,CAsBvB;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,aAAoB,EACpB,YAAY,EAAE,kBAAyC,EACvD,UAA+B,EAC/B,SAAS,EACT,iBAAiB,EACjB,wBAA+B,EAC/B,gBAAgB,GACjB,EAAE,iBAAiB,2CAwMnB;AAED,wBAAgB,OAAO,qBAMtB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"I18nProvider.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/I18nProvider.tsx"],"names":[],"mappings":"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"}

package/dist/shared/providers/shell/I18nProvider.js

@@ -1,9 +1,28 @@
 import { interpolate as e } from "./interpolate.js";
 import { resolveTranslationValue as t } from "./resolveTranslation.js";
-import { createContext as n, use as r, useCallback as i, useEffect as a, useMemo as o, useRef as s, useState as c } from "react";
-import { Fragment as l, jsx as u } from "react/jsx-runtime";
+import { hashTranslations as n } from "./translationStore.js";
+import { createContext as r, use as i, useCallback as a, useEffect as o, useMemo as s, useRef as c, useState as l } from "react";
+import { Fragment as u, jsx as d } from "react/jsx-runtime";
 //#region src/shared/providers/shell/I18nProvider.tsx
-var d = n(null), f = {
+var f = Object.freeze({
+	en: "ltr",
+	es: "ltr",
+	fr: "ltr",
+	de: "ltr",
+	ja: "ltr",
+	zh: "ltr",
+	ta: "ltr",
+	hi: "ltr",
+	ar: "rtl"
+}), p = (e) => e.trim().toLowerCase().split(/[-_]/)[0] ?? "";
+function m(e) {
+	let t = p(e);
+	return t in f ? f[t] : "ltr";
+}
+function h(e, t) {
+	return e === "rtl" ? "rtl" : e === "locale" ? m(t) : "ltr";
+}
+var g = r(null), ee = {
 	en: {},
 	es: {},
 	fr: {},
@@ -13,15 +32,21 @@ var d = n(null), f = {
 	ta: {},
 	hi: {},
 	ar: {}
-}, p = {
+}, _ = {
 	attempted: /* @__PURE__ */ new Set(),
-	translations: {},
+	translations: /* @__PURE__ */ new Map(),
 	version: 0,
 	clear() {
-		this.attempted.clear(), this.translations = {}, this.version++;
+		this.attempted.clear(), this.translations.clear(), this.version++;
 	}
 };
-function m(e, t, n) {
+function v(e, t) {
+	return e ? `${e}::${t}` : t;
+}
+function y(e) {
+	return !!e && Object.keys(e).length > 0;
+}
+function b(e, t, n) {
 	if (typeof window > "u") return n;
 	if (e) {
 		let t = localStorage.getItem(`bf-p-${e}-locale`);
@@ -29,10 +54,10 @@ function m(e, t, n) {
 	}
 	return localStorage.getItem(t) || n;
 }
-function h(e) {
+function x(e) {
 	return typeof e == "object" && !!e;
 }
-function g(e, t) {
+function S(e, t) {
 	if (!e && !t) return {};
 	if (!e) return { ...t ?? {} };
 	if (!t) return { ...e };
@@ -43,103 +68,186 @@ function g(e, t) {
 			n[e] = r;
 			continue;
 		}
-		n[e] = g(h(t) ? t : void 0, r);
+		n[e] = S(x(t) ? t : void 0, r);
 	}
 	return n;
 }
-function _({ children: n, defaultLocale: r = "en", translations: h = f, storageKey: _ = "burdenoff-locale", profileId: v, fetchTranslations: y, showChildrenWhileLoading: b = !0, loadingComponent: x }) {
-	let [S, C] = c(() => m(v, _, r)), [w, T] = c({}), [E, D] = c(!!y), [O, k] = c(null), A = s(/* @__PURE__ */ new Set()), j = s(p.version), M = o(() => {
-		let e = { ...h };
-		for (let [t, n] of Object.entries(w)) if (n && Object.keys(n).length > 0) {
+function C(e, t) {
+	let n = p(t);
+	return Object.entries(e).some(([e, t]) => t === "loading" && p(e) === n);
+}
+function w({ children: r, defaultLocale: i = "en", translations: f = ee, storageKey: m = "burdenoff-locale", profileId: x, fetchTranslations: w, loadTranslations: T, cacheScope: E = "", persistence: D = null, firstPaintHoldMs: O = 0, directionMode: k = "off", showChildrenWhileLoading: A = !0, loadingComponent: j }) {
+	let [M, N] = l(() => b(x, m, i)), P = s(() => {
+		if (T) return T;
+		if (w) return async (e) => {
+			let t = await w(e);
+			return {
+				translations: t ?? {},
+				complete: y(t)
+			};
+		};
+	}, [T, w]), [F, I] = l(() => {
+		let e = _.translations.get(v(E, M));
+		return e ? { [M]: e.translations } : {};
+	}), [L, te] = l(() => {
+		if (!P) return {};
+		let e = _.translations.has(v(E, M));
+		return { [M]: e ? "ready" : "loading" };
+	}), [R, z] = l(null), [B, V] = l(() => typeof window < "u" && !!P && !!D && O > 0 && p(M) !== "en" && !_.translations.has(v(E, M)));
+	o(() => {
+		if (!B) return;
+		let e = setTimeout(() => V(!1), O);
+		return () => clearTimeout(e);
+	}, [B, O]);
+	let H = c(/* @__PURE__ */ new Map()), U = c(/* @__PURE__ */ new Set()), W = c(_.version), G = a((e, t) => {
+		te((n) => n[e] === t ? n : {
+			...n,
+			[e]: t
+		});
+	}, []), K = a((e, t, n) => {
+		H.current.set(e, n), I((n) => n[e] === t ? n : {
+			...n,
+			[e]: t
+		});
+	}, []), q = s(() => {
+		let e = { ...f };
+		for (let [t, n] of Object.entries(F)) if (n && Object.keys(n).length > 0) {
 			let r = t;
-			e[r] = g(h[r], n);
+			e[r] = S(f[r], n);
 		}
 		return e;
-	}, [h, w]), N = i(async (e) => {
-		if (y) {
-			if (j.current !== p.version && (A.current.clear(), j.current = p.version), p.attempted.has(e)) {
-				let t = p.translations[e];
-				t && Object.keys(t).length > 0 && T((n) => !n[e] || Object.keys(n[e]).length === 0 ? {
-					...n,
-					[e]: t
-				} : n);
+	}, [f, F]), J = a(async (e) => {
+		if (!P) return;
+		W.current !== _.version && (U.current.clear(), H.current.clear(), W.current = _.version);
+		let t = v(E, e), r = _.translations.get(t);
+		if (r) {
+			H.current.get(e) !== r.hash && K(e, r.translations, r.hash), G(e, "ready"), V(!1);
+			return;
+		}
+		if (U.current.has(t)) return;
+		U.current.add(t), G(e, "loading"), z(null);
+		let i = !1, a = !1, o = !1, s = D ? D.read(E, e).catch(() => null) : Promise.resolve(null);
+		s.then((t) => {
+			if (i || !t || !y(t.translations)) {
+				V(!1);
 				return;
 			}
-			if (!A.current.has(e)) {
-				A.current.add(e), D(!0), k(null);
-				try {
-					let t = await y(e);
-					t && Object.keys(t).length > 0 && (p.attempted.add(e), p.translations[e] = t), T((n) => ({
-						...n,
-						[e]: t
-					}));
-				} catch (t) {
-					console.error(`[I18nProvider] Failed to fetch translations for ${e}:`, t), k(t instanceof Error ? t.message : "Failed to fetch translations");
-				} finally {
-					A.current.delete(e), D(!1);
+			o = !0, K(e, t.translations, t.hash), a && G(e, "ready"), V(!1);
+		});
+		try {
+			let r = await P(e);
+			if (a = !0, r.complete && y(r.translations)) {
+				let a = n(r.translations);
+				if (_.attempted.add(t), _.translations.set(t, {
+					translations: r.translations,
+					hash: a
+				}), i = !0, H.current.get(e) !== a && K(e, r.translations, a), G(e, "ready"), D) {
+					let t = await s;
+					(!t || t.hash !== a) && D.write(E, e, {
+						translations: r.translations,
+						hash: a
+					});
 				}
-			}
+			} else o ? G(e, "ready") : y(r.translations) ? (K(e, r.translations, n(r.translations)), G(e, "ready")) : G(e, "failed");
+		} catch (t) {
+			a = !0, console.error(`[I18nProvider] Failed to fetch translations for ${e}:`, t), z(t instanceof Error ? t.message : "Failed to fetch translations"), G(e, o ? "ready" : "failed");
+		} finally {
+			U.current.delete(t), V(!1);
 		}
-	}, [y]);
-	a(() => {
-		y && (p.attempted.has(S) && p.translations[S] && Object.keys(p.translations[S]).length > 0 || N(S));
 	}, [
-		y,
-		S,
-		N
-	]), a(() => {
-		let e = m(v, _, r);
-		C(e), document.documentElement.setAttribute("lang", e);
+		K,
+		E,
+		P,
+		G,
+		D
+	]);
+	o(() => {
+		P && J(M);
+	}, [
+		P,
+		M,
+		J
+	]), o(() => {
+		let e = b(x, m, i);
+		N(e), document.documentElement.setAttribute("lang", e);
 	}, [
-		v,
-		_,
-		r
+		x,
+		m,
+		i
 	]);
-	let P = i((e) => {
-		C(e), localStorage.setItem(_, e), v && localStorage.setItem(`bf-p-${v}-locale`, e), document.documentElement.setAttribute("lang", e);
-	}, [_, v]), F = i((n, i, a) => {
+	let Y = a((e) => {
+		if (N(e), P) {
+			let t = _.translations.get(v(E, e));
+			t ? (H.current.get(e) !== t.hash && K(e, t.translations, t.hash), G(e, "ready")) : G(e, "loading");
+		}
+		localStorage.setItem(m, e), x && localStorage.setItem(`bf-p-${x}-locale`, e), document.documentElement.setAttribute("lang", e);
+	}, [
+		K,
+		E,
+		P,
+		G,
+		m,
+		x
+	]), X = h(k, M);
+	o(() => {
+		if (k === "off" || typeof document > "u") return;
+		let e = document.documentElement, t = e.getAttribute("dir");
+		return e.setAttribute("dir", X), () => {
+			t === null ? e.removeAttribute("dir") : e.setAttribute("dir", t);
+		};
+	}, [k, X]);
+	let Z = a((n, r, a) => {
 		let o, s;
-		if (typeof i == "string") o = i, s = a;
-		else if (i && typeof i == "object") {
-			let { defaultValue: e, ...t } = i;
+		if (typeof r == "string") o = r, s = a;
+		else if (r && typeof r == "object") {
+			let { defaultValue: e, ...t } = r;
 			typeof e == "string" ? o = e : typeof e == "number" && (o = String(e)), s = t;
 		}
-		let c = t(M[S], n) ?? (S === r ? void 0 : t(M[r], n)) ?? (r === "en" ? void 0 : t(M.en, n)) ?? o ?? n;
+		let c = t(q[M], n) ?? (M === i ? void 0 : t(q[i], n)) ?? (i === "en" ? void 0 : t(q.en, n)) ?? o ?? n;
 		return s ? e(c, s) : c;
 	}, [
-		S,
 		M,
-		r
-	]), I = o(() => ({
-		locale: S,
-		translations: M[S] || {},
-		setLocale: P,
-		t: F,
-		isLoading: E,
-		error: O
+		q,
+		i
+	]), Q = Object.values(L).includes("loading"), $ = a((e) => C(L, e), [L]), ne = s(() => ({
+		locale: M,
+		translations: q[M] || {},
+		setLocale: Y,
+		t: Z,
+		isLoading: Q,
+		error: R,
+		localeStatus: L,
+		isLocaleLoading: $,
+		dir: X
 	}), [
-		S,
 		M,
-		P,
-		F,
-		E,
-		O
+		q,
+		Y,
+		Z,
+		Q,
+		R,
+		L,
+		$,
+		X
 	]);
-	return E && !b && x ? /* @__PURE__ */ u(l, { children: x }) : /* @__PURE__ */ u(d.Provider, {
-		value: I,
-		children: n
+	return B ? /* @__PURE__ */ d(u, { children: j ?? null }) : Q && !A && j && !y(F[M]) ? /* @__PURE__ */ d(u, { children: j }) : /* @__PURE__ */ d(g.Provider, {
+		value: ne,
+		children: r
 	});
 }
-function v() {
-	let e = r(d);
+function T() {
+	let e = i(g);
 	if (!e) throw Error("useI18n must be used within an I18nProvider");
 	return e;
 }
-function y() {
-	p.clear();
+function E() {
+	return i(g);
+}
+function D() {
+	_.clear();
 }
-function b(e) {
-	return p.attempted.has(e);
+function O(e, t = "") {
+	return _.attempted.has(v(t, e));
 }
 //#endregion
-export { _ as I18nProvider, y as clearTranslationCache, b as isTranslationAttempted, g as mergeTranslationDictionaries, v as useI18n };
+export { w as I18nProvider, f as LOCALE_DIRECTION, D as clearTranslationCache, O as isTranslationAttempted, m as localeDirection, S as mergeTranslationDictionaries, T as useI18n, E as useOptionalI18n };

package/dist/shared/providers/shell/ProfileI18nBridge.d.ts

@@ -1,15 +1,31 @@
 import { ReactNode } from 'react';
-import { Locale, TranslationDictionary } from './I18nProvider';
+import { DirectionMode, Locale, TranslationDictionary } from './I18nProvider';
+/** How long a returning non-English visitor's first paint waits for the cached dictionary. */
+export declare const FIRST_PAINT_HOLD_MS = 150;
 export interface ProfileI18nBridgeProps {
     children: ReactNode;
     /** Product ID for translations in the i18n service (created during DB seeding) */
     i18nProductId: string;
+    /**
+     * The platform dictionary layered UNDER the product's (BOFF-8060, F2):
+     * fallback < platform < product. Default `workspaces`, the home of the
+     * platform screens' and shared chrome's keys. `null` opts out. Ignored when
+     * it equals `i18nProductId` (the Workspaces app loads one dictionary).
+     */
+    platformI18nProductId?: string | null;
     /** Default locale (default: "en") */
     defaultLocale?: Locale;
     /** Static fallback translations */
     fallbackTranslations?: Record<string, TranslationDictionary>;
     /** Disable live translation fetches and rely on static fallbacks only */
     disableDynamicFetch?: boolean;
+    /**
+     * Keep the last complete dictionary in IndexedDB and apply it at once on the
+     * next load while revalidating (BOFF-8060, F3). Default true.
+     */
+    persistTranslations?: boolean;
+    /** Text direction handling (BOFF-8060, F6). Default `off`: always LTR. */
+    directionMode?: DirectionMode;
 }
-export declare function ProfileI18nBridge({ children, i18nProductId, defaultLocale, fallbackTranslations, disableDynamicFetch, }: ProfileI18nBridgeProps): import('react/jsx-runtime').JSX.Element;
+export declare function ProfileI18nBridge({ children, i18nProductId, platformI18nProductId, defaultLocale, fallbackTranslations, disableDynamicFetch, persistTranslations, directionMode, }: ProfileI18nBridgeProps): import('react/jsx-runtime').JSX.Element;
 //# sourceMappingURL=ProfileI18nBridge.d.ts.map

package/dist/shared/providers/shell/ProfileI18nBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProfileI18nBridge.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ProfileI18nBridge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAYxB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC7D,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,aAAa,EACb,aAAoB,EACpB,oBAAoB,EACpB,mBAA2B,GAC5B,EAAE,sBAAsB,2CAiGxB"}
+{"version":3,"file":"ProfileI18nBridge.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ProfileI18nBridge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG7D,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAmBxB,8FAA8F;AAC9F,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAgDvC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC7D,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAYD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,aAAa,EACb,qBAAwD,EACxD,aAAoB,EACpB,oBAAoB,EACpB,mBAA2B,EAC3B,mBAA0B,EAC1B,aAAqB,GACtB,EAAE,sBAAsB,2CAmExB"}

package/dist/shared/providers/shell/ProfileI18nBridge.js

@@ -1,44 +1,54 @@
 import { graphqlFetch as e } from "../../graphql/fetch.js";
 import "../../../shared-graphql.js";
 import { useAuth as t } from "./AuthProvider.js";
-import { I18nProvider as n, mergeTranslationDictionaries as r } from "./I18nProvider.js";
-import { useCallback as i, useMemo as a } from "react";
-import { jsx as o } from "react/jsx-runtime";
+import { getDefaultTranslationPersistence as n } from "./translationStore.js";
+import { I18nProvider as r, useI18n as i } from "./I18nProvider.js";
+import { DEFAULT_PLATFORM_I18N_PRODUCT_ID as a, createLayeredTranslationLoader as o, effectivePlatformId as s, translationCacheScope as c } from "./translationLayers.js";
+import { useCallback as l, useMemo as u } from "react";
+import { jsx as d } from "react/jsx-runtime";
+import { DirectionProvider as f } from "@radix-ui/react-direction";
 //#region src/shared/providers/shell/ProfileI18nBridge.tsx
-var s = "\n  query ExportTranslations($productId: String!, $languageCode: String!, $format: ImportJobFormat!) {\n    exportTranslations(productId: $productId, languageCode: $languageCode, format: $format) {\n      format\n      url\n    }\n  }\n";
-function c({ children: c, i18nProductId: l, defaultLocale: u = "en", fallbackTranslations: d, disableDynamicFetch: f = !1 }) {
-	let { user: p } = t(), m = p?.id ?? null, h = !f, g = i(async (t) => {
-		let n = d?.[t] ?? {};
-		if (!h) return n;
-		try {
-			let i = await e({
-				gateway: "global",
-				query: s,
-				operationName: "ExportTranslations",
-				variables: {
-					productId: l,
-					languageCode: t,
-					format: "JSON"
-				},
-				extraHeaders: {
-					"x-actor-id": "system-i18n",
-					"x-actor-type": "service"
-				}
-			});
-			if (i.errors?.length || !i.data?.exportTranslations?.url) return {};
-			let a = i.data.exportTranslations.url, o = decodeURIComponent(a.replace("data:application/json;charset=utf-8,", ""));
-			return r(n, JSON.parse(o));
-		} catch {
-			return {};
+var p = "\n  query ExportTranslations($productId: String!, $languageCode: String!, $format: ImportJobFormat!) {\n    exportTranslations(productId: $productId, languageCode: $languageCode, format: $format) {\n      format\n      url\n    }\n  }\n";
+async function m(t, n) {
+	let r = await e({
+		gateway: "global",
+		query: p,
+		operationName: "ExportTranslations",
+		variables: {
+			productId: t,
+			languageCode: n,
+			format: "JSON"
+		},
+		extraHeaders: {
+			"x-actor-id": "system-i18n",
+			"x-actor-type": "service"
 		}
-	}, [
-		d,
-		l,
-		h
-	]);
-	return /* @__PURE__ */ o(n, {
-		defaultLocale: u,
-		translations: a(() => d ?? {
+	});
+	if (r.errors?.length || !r.data?.exportTranslations?.url) return null;
+	let i = r.data.exportTranslations.url, a = decodeURIComponent(i.replace("data:application/json;charset=utf-8,", ""));
+	return JSON.parse(a);
+}
+function h({ children: e }) {
+	let { dir: t } = i();
+	return /* @__PURE__ */ d(f, {
+		dir: t,
+		children: e
+	});
+}
+function g({ children: e, i18nProductId: i, platformI18nProductId: f = a, defaultLocale: p = "en", fallbackTranslations: g, disableDynamicFetch: _ = !1, persistTranslations: v = !0, directionMode: y = "off" }) {
+	let { user: b } = t(), x = b?.id ?? null, S = !_, C = s(i, f), w = l((e) => g?.[e] ?? {}, [g]), T = u(() => o({
+		productId: i,
+		platformId: C,
+		fallback: w,
+		fetchDictionary: m
+	}), [
+		w,
+		i,
+		C
+	]), E = u(() => S && v ? n() : null, [v, S]);
+	return /* @__PURE__ */ d(r, {
+		defaultLocale: p,
+		translations: u(() => g ?? {
 			en: {},
 			es: {},
 			fr: {},
@@ -48,12 +58,16 @@ function c({ children: c, i18nProductId: l, defaultLocale: u = "en", fallbackTra
 			ta: {},
 			hi: {},
 			ar: {}
-		}, [d]),
-		fetchTranslations: h ? g : void 0,
-		profileId: m,
+		}, [g]),
+		loadTranslations: S ? T : void 0,
+		cacheScope: c(i, C),
+		persistence: E,
+		firstPaintHoldMs: E ? 150 : 0,
+		directionMode: y,
+		profileId: x,
 		showChildrenWhileLoading: !0,
-		children: c
+		children: /* @__PURE__ */ d(h, { children: e })
 	});
 }
 //#endregion
-export { c as ProfileI18nBridge };
+export { g as ProfileI18nBridge };