@burdenoff/fe-libs 2026.918.2 → 2026.920.1

package/dist/shared/assistant/writeModeConsent.d.ts

@@ -0,0 +1,99 @@
+import { AssistantModeConfig } from './conversation';
+import { AssistantTr } from './i18n';
+import { AssistantMode } from './types';
+/**
+ * The single flag this module replaces, as it sits in storage written by
+ * fe-libs 2026.919.1 and earlier.
+ */
+export declare const LEGACY_WRITE_CONSENT_KEY = "apiCallsAcknowledged";
+/**
+ * The write-capable modes this profile has accepted, read back from storage.
+ *
+ * - A stored list is kept, minus anything that is not a mode id and any repeat.
+ *   Storage is data from another build, so it is checked, not trusted.
+ * - Otherwise a stored legacy flag of exactly `true` becomes `["api-calls"]`.
+ * - Otherwise nothing is acknowledged.
+ *
+ * ★ A stored list WINS over the legacy flag, and is never merged with it. This
+ * build never writes the flag, and an older build drops the list the next time
+ * it persists (its `partialize` does not know the key), so the two are not
+ * stored side by side by either. Should they ever be, the list is the newer
+ * decision. After a rollback and a roll-forward, the flag the older build wrote
+ * is migrated again, exactly as on first upgrade.
+ */
+export declare function restoreAcknowledgedWriteModes(persisted: unknown): AssistantMode[];
+/** Has this profile accepted the write consent for `mode`? */
+export declare function isWriteModeAcknowledged(acknowledged: readonly AssistantMode[], mode: AssistantMode): boolean;
+/** Send-time consent and voice checks against the validated post-wait mode. */
+export declare function writeModeSendRefusal(mode: AssistantMode, config: Pick<AssistantModeConfig, "writeCapable"> | undefined, acknowledged: readonly AssistantMode[], { dictated, confirmsWrites }: {
+    dictated: boolean;
+    confirmsWrites: boolean;
+}): string | null;
+/** `acknowledged` plus `mode`, unchanged (same array) if it is already there. */
+export declare function withWriteModeAcknowledged(acknowledged: readonly AssistantMode[], mode: AssistantMode): readonly AssistantMode[];
+/** A mode as the dialog needs it: the product's config, or just an id. */
+export type WriteConsentMode = Pick<AssistantModeConfig, "id"> & Partial<Pick<AssistantModeConfig, "label" | "producesArtifacts">>;
+/** Every line of the dialog, already translated. */
+export interface WriteModeConsentCopy {
+    title: string;
+    body: string;
+    /** Whether the assistant stops for approval before a change — true or false, said plainly. */
+    safeguard: string;
+    confirm: string;
+    cancel: string;
+}
+/**
+ * fe-libs' own English for the `apiCalls.consent*` keys — the exact strings the
+ * `tr()` calls in `writeModeConsentCopy` pass as their fallbacks.
+ *
+ * ★ Written out twice ON PURPOSE. `i18nManifest.test.ts` reads the fallback
+ * ARGUMENT of every `tr()` call with the TypeScript parser, so a call site that
+ * passed this table's value instead of a literal would drop out of the manifest
+ * — and a key missing from the manifest is a key no product seeds, which is how
+ * a string silently goes English in every locale. That test pins each call site
+ * to the manifest, and `writeModeConsent.test.ts` pins this table to the
+ * manifest too, so the three cannot drift apart without CI failing.
+ */
+export declare const TAKE_ACTION_ENGLISH: {
+    readonly "apiCalls.consentTitle": "Switch to Take action mode?";
+    readonly "apiCalls.consentBody": "In Take action mode the assistant can read AND change your data — creating records, logging activity, updating details, and more, on your behalf.";
+    readonly "apiCalls.consentConfirm": "Enable Take action";
+    readonly "apiCalls.consentCancel": "Stay in Ask";
+};
+/** A consent key whose English fe-libs writes itself. */
+export type TakeActionConsentKey = keyof typeof TAKE_ACTION_ENGLISH;
+/**
+ * What the consent dialog says when switching from `current` into `target`.
+ *
+ * ★★ A PRODUCT'S OWN WORDS ALWAYS WIN. `apiCalls.consent*` predate per-mode
+ * wording, and products have seeded them: FluidGrids authored all five in six
+ * languages FOR ITS OWN NAME for `api-calls` ("In Workflow mode … your
+ * FluidGrids data"), HealthyBowl's body names "your HealthyBowl data". So for
+ * `api-calls` those keys are asked FIRST, and whatever comes back that is not
+ * fe-libs' own English is what renders — in the reader's language, byte for
+ * byte as before this change.
+ *
+ * ★★ `writeConsent.*` renders only where there is no product copy to lose: a
+ * mode that is not `api-calls` (a build mode has no seeded consent copy at all),
+ * or an `api-calls` whose dictionary gave our own sentence back. It says the
+ * same thing through `{{mode}}`, which names the mode as its pill does — so a
+ * product that calls `api-calls` "Build" stops being told "Take action" without
+ * any product's translation turning English.
+ *
+ * ★ The cancel button keeps `apiCalls.consentCancel` ("Stay in Ask") only when
+ * the mode being LEFT is the one called Ask — that sentence is about `current`,
+ * not `target`. Leaving Build names Build.
+ *
+ * ★★ `confirmsWrites` decides the safeguard line, and the caller must derive it
+ * from what the SANDBOX does (`modeRequiresConfirmWrites`), never from a product
+ * flag. The old dialog promised a confirmation step for every write-capable
+ * mode; only `api-calls` boots with AI_ASSISTANT_CONFIRM_WRITES, so for any
+ * other mode that promise was false. It now says the opposite, plainly.
+ */
+export declare function writeModeConsentCopy(tr: AssistantTr, { target, current, confirmsWrites, }: {
+    target: WriteConsentMode;
+    /** The mode being left; absent is read as Ask, the mode everyone starts in. */
+    current?: WriteConsentMode | null;
+    confirmsWrites: boolean;
+}): WriteModeConsentCopy;
+//# sourceMappingURL=writeModeConsent.d.ts.map

package/dist/shared/assistant/writeModeConsent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeModeConsent.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/writeModeConsent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAM1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAc/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,OAAO,GAAG,aAAa,EAAE,CAiBjF;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,IAAI,EAAE,aAAa,GAClB,OAAO,CAET;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,GAAG,SAAS,EAC7D,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GAC3E,MAAM,GAAG,IAAI,CAQf;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,IAAI,EAAE,aAAa,GAClB,SAAS,aAAa,EAAE,CAE1B;AAED,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,mBAAmB,CAAC,CAAC,CAAC;AAEpE,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAmBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB;;;;;CAMtB,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAuBpE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,WAAW,EACf,EACE,MAAM,EACN,OAAO,EACP,cAAc,GACf,EAAE;IACD,MAAM,EAAE,gBAAgB,CAAC;IACzB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,OAAO,CAAC;CACzB,GACA,oBAAoB,CA+DtB"}

package/dist/shared/assistant/writeModeConsent.js

@@ -0,0 +1,48 @@
+import { ASSISTANT_MODE_FALLBACK_LABELS as e, assistantModeFallbackLabel as t } from "./modeCopy.js";
+import { isAssistantModeId as n } from "./modeIds.js";
+//#region src/shared/assistant/writeModeConsent.ts
+var r = "apiCallsAcknowledged", i = "api-calls";
+function a(e) {
+	if (typeof e != "object" || !e) return [];
+	let t = Object.fromEntries(Object.entries(e)), r = t.acknowledgedWriteModes;
+	if (Array.isArray(r)) {
+		let e = /* @__PURE__ */ new Set();
+		for (let t of r) n(t) && e.add(t);
+		return [...e];
+	}
+	return t.apiCallsAcknowledged === !0 ? [i] : [];
+}
+function o(e, t) {
+	return e.includes(t);
+}
+function s(e, t, n, { dictated: r, confirmsWrites: i }) {
+	return t?.writeCapable && !o(n, e) ? "Confirm this assistant mode before sending: choose it again in the mode selector." : r && (t?.writeCapable || i) ? "Voice can't be used in a mode that can change your data. Type your request instead." : null;
+}
+function c(e, t) {
+	return e.includes(t) ? e : [...e, t];
+}
+function l(e, n) {
+	return e(`mode.${n.id}`, n.label || t(n));
+}
+var u = (e, n) => (e.label || t(e)) === n, d = {
+	"apiCalls.consentTitle": "Switch to Take action mode?",
+	"apiCalls.consentBody": "In Take action mode the assistant can read AND change your data — creating records, logging activity, updating details, and more, on your behalf.",
+	"apiCalls.consentConfirm": "Enable Take action",
+	"apiCalls.consentCancel": "Stay in Ask"
+};
+function f(e, t) {
+	return t === d[e] ? null : t;
+}
+var p = { id: "assistant" };
+function m(t, { target: n, current: r, confirmsWrites: i }) {
+	let a = l(t, n), o = n.id === "api-calls", s = !r || u(r, e.assistant);
+	return {
+		title: (o ? f("apiCalls.consentTitle", t("apiCalls.consentTitle", "Switch to Take action mode?")) : null) ?? t("writeConsent.title", "Switch to {{mode}} mode?", { mode: a }),
+		body: (o ? f("apiCalls.consentBody", t("apiCalls.consentBody", "In Take action mode the assistant can read AND change your data — creating records, logging activity, updating details, and more, on your behalf.")) : null) ?? t("writeConsent.body", "In {{mode}} mode the assistant can read AND change your data — creating records, logging activity, updating details, and more, on your behalf.", { mode: a }),
+		safeguard: i ? t("apiCalls.consentBody2", "It will describe what it is about to do and ask you to confirm before making a change. Only continue if you want the assistant to take actions for you.") : t("writeConsent.unconfirmed", "It does not stop to ask before each change — it makes changes as soon as it decides to. Only continue if you want the assistant to change your data without asking first."),
+		confirm: (o ? f("apiCalls.consentConfirm", t("apiCalls.consentConfirm", "Enable Take action")) : null) ?? t("writeConsent.confirm", "Enable {{mode}}", { mode: a }),
+		cancel: (s ? f("apiCalls.consentCancel", t("apiCalls.consentCancel", "Stay in Ask")) : null) ?? t("writeConsent.cancel", "Stay in {{mode}}", { mode: l(t, r ?? p) })
+	};
+}
+//#endregion
+export { r as LEGACY_WRITE_CONSENT_KEY, d as TAKE_ACTION_ENGLISH, o as isWriteModeAcknowledged, a as restoreAcknowledgedWriteModes, c as withWriteModeAcknowledged, m as writeModeConsentCopy, s as writeModeSendRefusal };

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;AAGf,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;AA2FD;;;;;;;;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":"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"}

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

@@ -1,8 +1,9 @@
 import { interpolate as e } from "./interpolate.js";
-import { createContext as t, use as n, useCallback as r, useEffect as i, useMemo as a, useRef as o, useState as s } from "react";
-import { Fragment as c, jsx as l } from "react/jsx-runtime";
+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";
 //#region src/shared/providers/shell/I18nProvider.tsx
-var u = t(null), d = {
+var d = n(null), f = {
 	en: {},
 	es: {},
 	fr: {},
@@ -12,7 +13,7 @@ var u = t(null), d = {
 	ta: {},
 	hi: {},
 	ar: {}
-}, f = {
+}, p = {
 	attempted: /* @__PURE__ */ new Set(),
 	translations: {},
 	version: 0,
@@ -20,7 +21,7 @@ var u = t(null), d = {
 		this.attempted.clear(), this.translations = {}, this.version++;
 	}
 };
-function p(e, t, n) {
+function m(e, t, n) {
 	if (typeof window > "u") return n;
 	if (e) {
 		let t = localStorage.getItem(`bf-p-${e}-locale`);
@@ -28,13 +29,6 @@ function p(e, t, n) {
 	}
 	return localStorage.getItem(t) || n;
 }
-function m(e, t) {
-	if (!e) return;
-	let n = t.split("."), r = e;
-	for (let e of n) if (typeof r == "object" && r && e in r) r = r[e];
-	else return;
-	return typeof r == "string" ? r : void 0;
-}
 function h(e) {
 	return typeof e == "object" && !!e;
 }
@@ -53,18 +47,18 @@ function g(e, t) {
 	}
 	return n;
 }
-function _({ children: t, defaultLocale: n = "en", translations: h = d, storageKey: _ = "burdenoff-locale", profileId: v, fetchTranslations: y, showChildrenWhileLoading: b = !0, loadingComponent: x }) {
-	let [S, C] = s(() => p(v, _, n)), [w, T] = s({}), [E, D] = s(!!y), [O, k] = s(null), A = o(/* @__PURE__ */ new Set()), j = o(f.version), M = a(() => {
+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) {
 			let r = t;
 			e[r] = g(h[r], n);
 		}
 		return e;
-	}, [h, w]), N = r(async (e) => {
+	}, [h, w]), N = i(async (e) => {
 		if (y) {
-			if (j.current !== f.version && (A.current.clear(), j.current = f.version), f.attempted.has(e)) {
-				let t = f.translations[e];
+			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
@@ -75,7 +69,7 @@ function _({ children: t, defaultLocale: n = "en", translations: h = d, storageK
 				A.current.add(e), D(!0), k(null);
 				try {
 					let t = await y(e);
-					t && Object.keys(t).length > 0 && (f.attempted.add(e), f.translations[e] = t), T((n) => ({
+					t && Object.keys(t).length > 0 && (p.attempted.add(e), p.translations[e] = t), T((n) => ({
 						...n,
 						[e]: t
 					}));
@@ -87,36 +81,36 @@ function _({ children: t, defaultLocale: n = "en", translations: h = d, storageK
 			}
 		}
 	}, [y]);
-	i(() => {
-		y && (f.attempted.has(S) && f.translations[S] && Object.keys(f.translations[S]).length > 0 || N(S));
+	a(() => {
+		y && (p.attempted.has(S) && p.translations[S] && Object.keys(p.translations[S]).length > 0 || N(S));
 	}, [
 		y,
 		S,
 		N
-	]), i(() => {
-		let e = p(v, _, n);
+	]), a(() => {
+		let e = m(v, _, r);
 		C(e), document.documentElement.setAttribute("lang", e);
 	}, [
 		v,
 		_,
-		n
+		r
 	]);
-	let P = r((e) => {
+	let P = i((e) => {
 		C(e), localStorage.setItem(_, e), v && localStorage.setItem(`bf-p-${v}-locale`, e), document.documentElement.setAttribute("lang", e);
-	}, [_, v]), F = r((t, r, i) => {
-		let a, o;
-		if (typeof r == "string") a = r, o = i;
-		else if (r && typeof r == "object") {
-			let { defaultValue: e, ...t } = r;
-			typeof e == "string" ? a = e : typeof e == "number" && (a = String(e)), o = t;
+	}, [_, v]), F = i((n, i, a) => {
+		let o, s;
+		if (typeof i == "string") o = i, s = a;
+		else if (i && typeof i == "object") {
+			let { defaultValue: e, ...t } = i;
+			typeof e == "string" ? o = e : typeof e == "number" && (o = String(e)), s = t;
 		}
-		let s = m(M[S], t) ?? (S === n ? void 0 : m(M[n], t)) ?? (n === "en" ? void 0 : m(M.en, t)) ?? a ?? t;
-		return o ? e(s, o) : s;
+		let c = t(M[S], n) ?? (S === r ? void 0 : t(M[r], n)) ?? (r === "en" ? void 0 : t(M.en, n)) ?? o ?? n;
+		return s ? e(c, s) : c;
 	}, [
 		S,
 		M,
-		n
-	]), I = a(() => ({
+		r
+	]), I = o(() => ({
 		locale: S,
 		translations: M[S] || {},
 		setLocale: P,
@@ -131,21 +125,21 @@ function _({ children: t, defaultLocale: n = "en", translations: h = d, storageK
 		E,
 		O
 	]);
-	return E && !b && x ? /* @__PURE__ */ l(c, { children: x }) : /* @__PURE__ */ l(u.Provider, {
+	return E && !b && x ? /* @__PURE__ */ u(l, { children: x }) : /* @__PURE__ */ u(d.Provider, {
 		value: I,
-		children: t
+		children: n
 	});
 }
 function v() {
-	let e = n(u);
+	let e = r(d);
 	if (!e) throw Error("useI18n must be used within an I18nProvider");
 	return e;
 }
 function y() {
-	f.clear();
+	p.clear();
 }
 function b(e) {
-	return f.attempted.has(e);
+	return p.attempted.has(e);
 }
 //#endregion
 export { _ as I18nProvider, y as clearTranslationCache, b as isTranslationAttempted, g as mergeTranslationDictionaries, v as useI18n };

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

@@ -0,0 +1,23 @@
+import { TranslationDictionary } from './I18nProvider';
+/**
+ * Where a nested dictionary keeps the value of a key that is ALSO a branch.
+ *
+ * `healthybowl.common.confirm` ("Confirm") and `healthybowl.common.confirm.title`
+ * ("Are you sure?") cannot both live at one path of a nested object, so the
+ * leaf is stored beside its children as `confirm._`. The product extractors
+ * write that slot, the seed stores such a key literally as `….confirm._`, and
+ * the i18n export serves it nested — so the translation already reaches the
+ * client. Nothing read it: `t('healthybowl.common.confirm')` walked to the
+ * object and returned undefined, and the call site's inline English rendered
+ * in every locale (13 HealthyBowl keys, BOFF-7438; BOFF-7459).
+ */
+export declare const LEAF_SLOT = "_";
+/**
+ * Resolve a dot-notated translation key from a dictionary: the string at that
+ * path, or — when the path names a branch — the string in its `_` slot.
+ *
+ * A branch with no `_` string still resolves to undefined, so the caller's
+ * fallback renders rather than "[object Object]".
+ */
+export declare function resolveTranslationValue(dictionary: TranslationDictionary | undefined, key: string): string | undefined;
+//# sourceMappingURL=resolveTranslation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTranslation.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/resolveTranslation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,qBAAqB,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAgBpB"}

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

@@ -0,0 +1,11 @@
+function e(e, t) {
+	if (!e) return;
+	let n = e;
+	for (let e of t.split(".")) if (typeof n == "object" && n && e in n) n = n[e];
+	else return;
+	if (typeof n == "string") return n;
+	let r = typeof n == "object" && n ? n._ : void 0;
+	return typeof r == "string" ? r : void 0;
+}
+//#endregion
+export { e as resolveTranslationValue };