@burdenoff/fe-libs 2026.1007.4 → 2026.1007.5

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

@@ -0,0 +1,25 @@
+import { DirectionMode } from './I18nProvider';
+export declare const DIRECTION_PREVIEW_SESSION_KEY = "bf-dir-preview";
+export declare const DIRECTION_PREVIEW_LOCAL_KEY = "bf-rtl-preview";
+export interface DirectionStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface ResolveDirectionModeInput {
+    /** The product flag. Default false. */
+    enabled?: boolean;
+    /** Whether the QA preview is honoured. Default true. */
+    allowPreview?: boolean;
+    /** `window.location.search`, or '' when unavailable. */
+    search: string;
+    session: DirectionStorage | null;
+    local: DirectionStorage | null;
+}
+export declare function resolveDirectionMode(input: ResolveDirectionModeInput): DirectionMode;
+/** `resolveDirectionMode` against the real browser globals. */
+export declare function resolveBrowserDirectionMode(options: {
+    enabled?: boolean;
+    allowPreview?: boolean;
+}): DirectionMode;
+//# sourceMappingURL=directionMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directionMode.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/directionMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,6BAA6B,mBAAmB,CAAC;AAC9D,eAAO,MAAM,2BAA2B,mBAAmB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAChC;AAaD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,aAAa,CAyBpF;AAED,+DAA+D;AAC/D,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,aAAa,CAQhB"}

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

@@ -0,0 +1,34 @@
+//#region src/shared/providers/shell/directionMode.ts
+var e = "bf-dir-preview", t = (e) => e === "rtl" ? "rtl" : e === "locale" ? "locale" : null;
+function n(e, t) {
+	try {
+		return e();
+	} catch {
+		return t;
+	}
+}
+function r(r) {
+	let i = r.enabled ? "locale" : "off";
+	if (r.allowPreview === !1) return i;
+	let a = n(() => new URLSearchParams(r.search).get("dir"), null);
+	if (a !== null) {
+		let i = t(a);
+		if (n(() => {
+			i ? r.session?.setItem(e, i) : r.session?.removeItem(e);
+		}, void 0), i) return i;
+	} else {
+		let i = t(n(() => r.session?.getItem(e), null));
+		if (i) return i;
+	}
+	return t(n(() => r.local?.getItem("bf-rtl-preview"), null)) ?? i;
+}
+function i(e) {
+	return typeof window > "u" ? e.enabled ? "locale" : "off" : r({
+		...e,
+		search: n(() => window.location.search, ""),
+		session: n(() => window.sessionStorage, null),
+		local: n(() => window.localStorage, null)
+	});
+}
+//#endregion
+export { i as resolveBrowserDirectionMode };

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

@@ -1,7 +1,9 @@
 export { ThemeProvider, useTheme } from './ThemeProvider';
 export type { ThemeMode, Brand, Density, Typography, ThemeContextValue, ThemeProviderProps, } from './ThemeProvider';
-export { I18nProvider, useI18n, clearTranslationCache, isTranslationAttempted, } from './I18nProvider';
-export type { Locale, TranslationDictionary, I18nContextValue, I18nProviderProps, FetchTranslationsFn, } from './I18nProvider';
+export { I18nProvider, useI18n, useOptionalI18n, clearTranslationCache, isTranslationAttempted, LOCALE_DIRECTION, localeDirection, } from './I18nProvider';
+export type { Locale, TranslationDictionary, I18nContextValue, I18nProviderProps, FetchTranslationsFn, LoadTranslationsFn, TranslationLoadResult, LocaleLoadStatus, DirectionMode, TextDirection, } from './I18nProvider';
+export { useShellLabel } from './useShellLabel';
+export type { ShellLabel } from './useShellLabel';
 export { AuthProvider, useAuth } from './AuthProvider';
 export type { User, AuthTokens, Account, AuthContextValue, AuthProviderProps, } from './AuthProvider';
 export { AuthBridgeClient, initAuthBridge, getAuthBridge, destroyAuthBridge, isAuthBridgeInitialized, } from './AuthBridgeClient';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/index.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import { Locale, TranslationDictionary, TranslationLoadResult } from './I18nProvider';
+/** The platform dictionary every app layers under its own. */
+export declare const DEFAULT_PLATFORM_I18N_PRODUCT_ID = "workspaces";
+/** Fetch one product's dictionary for a locale; `null` when it could not be had. */
+export type FetchDictionaryFn = (productId: string, locale: Locale) => Promise<TranslationDictionary | null>;
+export interface LayeredTranslationLoaderOptions {
+    /** The app's own i18n product id. */
+    productId: string;
+    /**
+     * The platform dictionary to layer underneath. `null` opts out; the same id
+     * as `productId` means "this app is the platform" and is fetched once.
+     */
+    platformId: string | null;
+    /** The bundled fallback for a locale (usually English only). */
+    fallback: (locale: Locale) => TranslationDictionary;
+    fetchDictionary: FetchDictionaryFn;
+}
+/** The platform id actually layered, or null when there is nothing to layer. */
+export declare function effectivePlatformId(productId: string, platformId: string | null): string | null;
+/**
+ * The cache scope for a product+platform pair. Two apps on one origin (the
+ * Workspaces SPA in the auth bridge iframe, a product app) must never read each
+ * other's merged dictionary, and a dictionary merged WITH the platform must not
+ * be reused by a build that merges WITHOUT it.
+ */
+export declare function translationCacheScope(productId: string, platformId: string | null): string;
+/** fallback < platform < product. */
+export declare function layerTranslations(fallback: TranslationDictionary, platform: TranslationDictionary | null, product: TranslationDictionary | null): TranslationDictionary;
+export declare function createLayeredTranslationLoader(options: LayeredTranslationLoaderOptions): (locale: Locale) => Promise<TranslationLoadResult>;
+//# sourceMappingURL=translationLayers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translationLayers.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/translationLayers.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,8DAA8D;AAC9D,eAAO,MAAM,gCAAgC,eAAe,CAAC;AAE7D,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;AAE3C,MAAM,WAAW,+BAA+B;IAC9C,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,qBAAqB,CAAC;IACpD,eAAe,EAAE,iBAAiB,CAAC;CACpC;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAG1F;AAED,qCAAqC;AACrC,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,qBAAqB,GAAG,IAAI,EACtC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GACpC,qBAAqB,CAGvB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAyBpD"}

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

@@ -0,0 +1,35 @@
+import { mergeTranslationDictionaries as e } from "./I18nProvider.js";
+//#region src/shared/providers/shell/translationLayers.ts
+var t = "workspaces";
+function n(e, t) {
+	return !t || t === e ? null : t;
+}
+function r(e, t) {
+	let r = n(e, t);
+	return r ? `${e}+${r}` : e;
+}
+function i(t, n, r) {
+	let i = n ? e(t, n) : t;
+	return r ? e(i, r) : i;
+}
+function a(e) {
+	let t = n(e.productId, e.platformId), r = async (t, n) => {
+		try {
+			return await e.fetchDictionary(t, n);
+		} catch {
+			return null;
+		}
+	};
+	return async (n) => {
+		let [a, o] = await Promise.all([r(e.productId, n), t ? r(t, n) : Promise.resolve(null)]);
+		return a === null && o === null ? {
+			translations: {},
+			complete: !1
+		} : {
+			translations: i(e.fallback(n), o, a),
+			complete: a !== null
+		};
+	};
+}
+//#endregion
+export { t as DEFAULT_PLATFORM_I18N_PRODUCT_ID, a as createLayeredTranslationLoader, n as effectivePlatformId, r as translationCacheScope };

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

@@ -0,0 +1,55 @@
+import { TranslationDictionary } from './I18nProvider';
+/** A dictionary as stored, with the content hash that decides replacement. */
+export interface PersistedTranslations {
+    translations: TranslationDictionary;
+    hash: string;
+}
+/** What `I18nProvider` needs from a persistent cache. */
+export interface TranslationPersistence {
+    read(scope: string, locale: string): Promise<PersistedTranslations | null>;
+    write(scope: string, locale: string, entry: PersistedTranslations): Promise<void>;
+}
+/** One stored row. `id` is `scope|locale`. */
+export interface TranslationRecord extends PersistedTranslations {
+    id: string;
+    scope: string;
+    locale: string;
+    savedAt: number;
+}
+/** The storage primitives the persistence logic is written against. */
+export interface TranslationBackend {
+    get(id: string): Promise<TranslationRecord | null>;
+    put(record: TranslationRecord): Promise<void>;
+    list(): Promise<readonly TranslationRecord[]>;
+    delete(id: string): Promise<void>;
+}
+export interface TranslationPersistenceOptions {
+    /** Locales kept per scope, newest first. Default 2. */
+    maxEntriesPerScope?: number;
+    /** A read slower than this counts as a miss. Default 1500 ms. */
+    readTimeoutMs?: number;
+    /** Clock, injectable for tests. */
+    now?: () => number;
+}
+export declare const DEFAULT_MAX_ENTRIES_PER_SCOPE = 2;
+export declare const DEFAULT_READ_TIMEOUT_MS = 1500;
+export declare function translationRecordId(scope: string, locale: string): string;
+/**
+ * FNV-1a (32-bit) over the canonical JSON of a dictionary, as 8 hex digits.
+ *
+ * Only used to decide "did the published dictionary change?", so a fast
+ * non-cryptographic hash is enough; the JSON is produced by the same code path
+ * on every load, so key order is stable for identical content.
+ */
+export declare function hashTranslations(translations: TranslationDictionary): string;
+/** Persistence over any backend; never rejects. */
+export declare function createTranslationPersistence(backend: TranslationBackend, options?: TranslationPersistenceOptions): TranslationPersistence;
+/** The IndexedDB adapter. The database is opened lazily, once. */
+export declare function indexedDbTranslationBackend(factory: IDBFactory): TranslationBackend;
+/**
+ * The app-wide persistent cache, or null where IndexedDB is unavailable (SSR,
+ * test runners, some privacy modes). Reading the `indexedDB` global can itself
+ * throw in a sandboxed frame, hence the try.
+ */
+export declare function getDefaultTranslationPersistence(): TranslationPersistence | null;
+//# sourceMappingURL=translationStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translationStore.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/translationStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,qBAAqB,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAC3E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACnD,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,6BAA6B;IAC5C,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAE7C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,CAQ5E;AAsBD,mDAAmD;AACnD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,CAyCxB;AAuBD,kEAAkE;AAClE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,UAAU,GAAG,kBAAkB,CAmDnF;AAID;;;;GAIG;AACH,wBAAgB,gCAAgC,IAAI,sBAAsB,GAAG,IAAI,CAYhF"}

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

@@ -0,0 +1,100 @@
+function e(e, t) {
+	return `${e}|${t}`;
+}
+function t(e) {
+	let t = JSON.stringify(e), n = 2166136261;
+	for (let e = 0; e < t.length; e += 1) n ^= t.charCodeAt(e), n = Math.imul(n, 16777619);
+	return (n >>> 0).toString(16).padStart(8, "0");
+}
+function n(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function r(e, t, n) {
+	return new Promise((r) => {
+		let i = setTimeout(() => r(n), t);
+		e.then((e) => {
+			clearTimeout(i), r(e);
+		}, () => {
+			clearTimeout(i), r(n);
+		});
+	});
+}
+function i(t, i = {}) {
+	let a = Math.max(1, i.maxEntriesPerScope ?? 2), o = i.readTimeoutMs ?? 1500, s = i.now ?? (() => Date.now()), c = async (e, n) => {
+		let r = [...(await t.list()).filter((t) => t.scope === e)].sort((e, t) => t.savedAt - e.savedAt).filter((e, t) => e.id !== n && t >= a);
+		await Promise.all(r.map((e) => t.delete(e.id)));
+	};
+	return {
+		async read(i, a) {
+			let s = await r(t.get(e(i, a)), o, null);
+			return !s || typeof s.hash != "string" || !n(s.translations) ? null : {
+				translations: s.translations,
+				hash: s.hash
+			};
+		},
+		async write(n, r, i) {
+			try {
+				let a = e(n, r);
+				await t.put({
+					id: a,
+					scope: n,
+					locale: r,
+					translations: i.translations,
+					hash: i.hash,
+					savedAt: s()
+				}), await c(n, a);
+			} catch {}
+		}
+	};
+}
+var a = "boff-i18n", o = 1, s = "dictionaries";
+function c(e) {
+	return new Promise((t, n) => {
+		e.onsuccess = () => t(e.result), e.onerror = () => n(e.error ?? /* @__PURE__ */ Error("IndexedDB request failed"));
+	});
+}
+function l(e) {
+	return new Promise((t, n) => {
+		e.oncomplete = () => t(), e.onerror = () => n(e.error ?? /* @__PURE__ */ Error("IndexedDB transaction failed")), e.onabort = () => n(e.error ?? /* @__PURE__ */ Error("IndexedDB transaction aborted"));
+	});
+}
+function u(e) {
+	let t = null, n = () => (t || (t = new Promise((t, n) => {
+		let r = e.open(a, o);
+		r.onupgradeneeded = () => {
+			let e = r.result;
+			e.objectStoreNames.contains(s) || e.createObjectStore(s, { keyPath: "id" });
+		}, r.onsuccess = () => t(r.result), r.onerror = () => n(r.error ?? /* @__PURE__ */ Error("IndexedDB open failed")), r.onblocked = () => n(/* @__PURE__ */ Error("IndexedDB open blocked"));
+	}), t.catch(() => {
+		t = null;
+	})), t);
+	return {
+		async get(e) {
+			return await c((await n()).transaction(s, "readonly").objectStore(s).get(e)) ?? null;
+		},
+		async put(e) {
+			let t = (await n()).transaction(s, "readwrite");
+			t.objectStore(s).put(e), await l(t);
+		},
+		async list() {
+			return await c((await n()).transaction(s, "readonly").objectStore(s).getAll());
+		},
+		async delete(e) {
+			let t = (await n()).transaction(s, "readwrite");
+			t.objectStore(s).delete(e), await l(t);
+		}
+	};
+}
+var d;
+function f() {
+	if (d !== void 0) return d;
+	let e;
+	try {
+		e = typeof indexedDB > "u" ? void 0 : indexedDB;
+	} catch {
+		e = void 0;
+	}
+	return d = e ? i(u(e)) : null, d;
+}
+//#endregion
+export { f as getDefaultTranslationPersistence, t as hashTranslations };

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

@@ -1,3 +1,5 @@
+/** Resolve one shell label: `(key, englishFallback, params?) => text`. */
+export type ShellLabel = (key: string, fallback: string, params?: Record<string, string | number>) => string;
 /**
  * Resolve a shell chrome label through the i18n service, with an English
  * fallback.
@@ -8,6 +10,7 @@
  *
  *   const label = useShellLabel();
  *   label('nav.collapse', 'Collapse');
+ *   label('notifications.bellLabelUnread', 'Notifications ({{count}} unread)', { count });
  *
  * Used by the shell's own chrome (side nav, footer, breadcrumbs) so those
  * strings follow the active locale instead of being permanently English.
@@ -15,6 +18,15 @@
  * back to this, so a host can still override:
  *
  *   const text = collapseLabel ?? label('nav.collapse', 'Collapse');
+ *
+ * `{{name}}` / `{name}` placeholders are filled from `params` whichever text
+ * wins — the translation or the English.
+ *
+ * ★ Outside an `I18nProvider` this returns the English instead of throwing.
+ * The chrome and the `ui/` primitives (Tabs, NextSteps, the overflow menu, the
+ * consent banner) are public components that hosts, microfrontend tests and
+ * stories render standalone; a translated label must never make them crash
+ * where an English one did not.
  */
-export declare function useShellLabel(): (key: string, fallback: string) => string;
+export declare function useShellLabel(): ShellLabel;
 //# sourceMappingURL=useShellLabel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useShellLabel.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/useShellLabel.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CASzE"}
+{"version":3,"file":"useShellLabel.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/useShellLabel.ts"],"names":[],"mappings":"AAIA,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACrC,MAAM,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAW1C"}

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

@@ -1,12 +1,13 @@
-import { useI18n as e } from "./I18nProvider.js";
-import { useCallback as t } from "react";
+import { interpolate as e } from "./interpolate.js";
+import { useOptionalI18n as t } from "./I18nProvider.js";
+import { useCallback as n } from "react";
 //#region src/shared/providers/shell/useShellLabel.ts
-function n() {
-	let { t: n } = e();
-	return t((e, t) => {
-		let r = n(e);
-		return r === e ? t : r;
-	}, [n]);
+function r() {
+	let r = t()?.t;
+	return n((t, n, i) => {
+		let a = r ? r(t) : t, o = a === t ? n : a;
+		return i ? e(o, i) : o;
+	}, [r]);
 }
 //#endregion
-export { n as useShellLabel };
+export { r as useShellLabel };