@burdenoff/fe-libs 2026.1007.4 → 2026.1007.6

package/dist/shared/events/sinks/RybbitSink.js

@@ -1,16 +1,17 @@
 "use client";
-import { useEventBus as e } from "../../../shared-events.js";
-import { useEffect as t, useRef as n, useState as r } from "react";
-import { jsx as i, jsxs as a } from "react/jsx-runtime";
+import { useShellLabel as e } from "../../providers/shell/useShellLabel.js";
+import { useEventBus as t } from "../../../shared-events.js";
+import { useEffect as n, useRef as r, useState as i } from "react";
+import { jsx as a, jsxs as o } from "react/jsx-runtime";
 //#region src/shared/events/sinks/RybbitSink.tsx
-var o = /* @__PURE__ */ "nav.route.changed,auth.signed_in,auth.signed_out,support.ticket.created,support.ticket.closed,support.ticket.reopened,support.kb.article_rated,notification.item.opened,notification.preference.updated,notification.admin.sent,notification.template.saved,notification.schedule.updated,bigconsole.dashboard.import_clicked,bigconsole.dashboard.imported,bigconsole.dashboard.share_clicked,bigconsole.dashboard.shared,bigconsole.data_sink.import_clicked,bigconsole.data_sink.imported,bigconsole.widget.create_clicked,bigconsole.widget.created,bigconsole.widget.duplicate_clicked,bigconsole.widget.duplicated,bigconsole.ai.generate_clicked,bigconsole.ai.dashboard_generated,bigconsole.ai.create_dashboard_clicked,bigconsole.ai.dashboard_created".split(","), s = /(token|password|secret|authorization|cookie|session|email|name|stack|message|subject|description|query|search|prompt|formula|reason|body|content)/i, c = /(^id$|Id$|_id$|_ID$)/, l = [
+var s = /* @__PURE__ */ "nav.route.changed,auth.signed_in,auth.signed_out,support.ticket.created,support.ticket.closed,support.ticket.reopened,support.kb.article_rated,notification.item.opened,notification.preference.updated,notification.admin.sent,notification.template.saved,notification.schedule.updated,bigconsole.dashboard.import_clicked,bigconsole.dashboard.imported,bigconsole.dashboard.share_clicked,bigconsole.dashboard.shared,bigconsole.data_sink.import_clicked,bigconsole.data_sink.imported,bigconsole.widget.create_clicked,bigconsole.widget.created,bigconsole.widget.duplicate_clicked,bigconsole.widget.duplicated,bigconsole.ai.generate_clicked,bigconsole.ai.dashboard_generated,bigconsole.ai.create_dashboard_clicked,bigconsole.ai.dashboard_created".split(","), c = /(token|password|secret|authorization|cookie|session|email|name|stack|message|subject|description|query|search|prompt|formula|reason|body|content)/i, l = /(^id$|Id$|_id$|_ID$)/, u = [
 	"ticketId",
 	"categoryId",
 	"workspaceId"
-], u = ["workspaceId"], d = {
-	"support.ticket.created": l,
-	"support.ticket.closed": l,
-	"support.ticket.reopened": l,
+], d = ["workspaceId"], f = {
+	"support.ticket.created": u,
+	"support.ticket.closed": u,
+	"support.ticket.reopened": u,
 	"support.kb.article_rated": ["articleId"],
 	"bigconsole.dashboard.imported": ["dashboardId"],
 	"bigconsole.dashboard.share_clicked": ["dashboardId"],
@@ -36,54 +37,54 @@ var o = /* @__PURE__ */ "nav.route.changed,auth.signed_in,auth.signed_out,suppor
 	"bigconsole.ai.dashboard_generated": ["generationId"],
 	"bigconsole.ai.create_dashboard_clicked": ["generationId"],
 	"bigconsole.ai.dashboard_created": ["dashboardId", "generationId"],
-	"healthybowl.farm.created": u,
-	"healthybowl.crop.created": u,
-	"healthybowl.crop.updated": u,
-	"healthybowl.harvest.recorded": u
-}, f = {
+	"healthybowl.farm.created": d,
+	"healthybowl.crop.created": d,
+	"healthybowl.crop.updated": d,
+	"healthybowl.harvest.recorded": d
+}, p = {
 	"auth.signed_out": ["reason"],
 	"psw.search.performed": ["queryLength"]
-}, p = {}, m = "bf-analytics-consent", h = "burdenoff:analytics-consent";
-function g() {
+}, m = {}, h = "bf-analytics-consent", g = "burdenoff:analytics-consent";
+function _() {
 	return navigator.globalPrivacyControl === !0;
 }
-function _() {
+function v() {
 	if (typeof window > "u") return null;
-	let e = window.localStorage.getItem(m);
+	let e = window.localStorage.getItem(h);
 	return e === "granted" || e === "denied" ? e : null;
 }
-function v() {
-	return typeof window > "u" || g() ? !1 : _() === "granted";
+function y() {
+	return typeof window > "u" || _() ? !1 : v() === "granted";
 }
-function y(e) {
-	typeof window > "u" || (window.localStorage.setItem(m, e ? "granted" : "denied"), window.dispatchEvent(new CustomEvent(h, { detail: { granted: e } })));
+function b(e) {
+	typeof window > "u" || (window.localStorage.setItem(h, e ? "granted" : "denied"), window.dispatchEvent(new CustomEvent(g, { detail: { granted: e } })));
 }
-function b() {
+function x() {
 	let e = window;
 	return navigator.doNotTrack === "1" || e.doNotTrack === "1";
 }
-function x(e) {
+function S(e) {
 	let t = 2166136261;
 	for (let n = 0; n < e.length; n += 1) t ^= e.charCodeAt(n), t = Math.imul(t, 16777619);
 	return `u_${(t >>> 0).toString(16).padStart(8, "0")}`;
 }
-async function S(e) {
+async function C(e) {
 	if (crypto.subtle) {
 		let t = new TextEncoder().encode(e), n = await crypto.subtle.digest("SHA-256", t);
 		return Array.from(new Uint8Array(n), (e) => e.toString(16).padStart(2, "0")).join("");
 	}
-	return x(e);
-}
-function C(e, t) {
-	return s.test(e) ? !(f[t] ?? []).includes(e) : c.test(e) ? !(d[t] ?? []).includes(e) : !1;
+	return S(e);
 }
 function w(e, t) {
+	return c.test(e) ? !(p[t] ?? []).includes(e) : l.test(e) ? !(f[t] ?? []).includes(e) : !1;
+}
+function T(e, t) {
 	if (!e || typeof e != "object" || Array.isArray(e)) return {};
 	let n = {};
-	for (let [r, i] of Object.entries(e)) C(r, t) || (typeof i == "string" || typeof i == "number" || typeof i == "boolean") && (n[r] = i);
+	for (let [r, i] of Object.entries(e)) w(r, t) || (typeof i == "string" || typeof i == "number" || typeof i == "boolean") && (n[r] = i);
 	return n;
 }
-function T(e) {
+function E(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) {
 		let e = {
@@ -95,39 +96,39 @@ function T(e) {
 	}
 	return t;
 }
-function E({ siteId: i, scriptUrl: a = "https://app.rybbit.io/api/script.js", rename: s = p, allowlist: c = o, identifyOn: l = "auth.signed_in" }) {
-	let u = e(), d = n(!1), [f, _] = r(v);
-	return t(() => {
-		let e = () => _(v()), t = (t) => {
-			t.key === m && e();
+function D({ siteId: e, scriptUrl: a = "https://app.rybbit.io/api/script.js", rename: o = m, allowlist: c = s, identifyOn: l = "auth.signed_in" }) {
+	let u = t(), d = r(!1), [f, p] = i(y);
+	return n(() => {
+		let e = () => p(y()), t = (t) => {
+			t.key === h && e();
 		};
-		return window.addEventListener(h, e), window.addEventListener("storage", t), () => {
-			window.removeEventListener(h, e), window.removeEventListener("storage", t);
+		return window.addEventListener(g, e), window.addEventListener("storage", t), () => {
+			window.removeEventListener(g, e), window.removeEventListener("storage", t);
 		};
-	}, []), t(() => {
-		if (!i || !f || g() || d.current) return;
+	}, []), n(() => {
+		if (!e || !f || _() || d.current) return;
 		d.current = !0;
-		let e = document.createElement("script");
-		return e.src = a, e.defer = !0, e.dataset.siteId = i, document.head.appendChild(e), () => {
-			document.head.removeChild(e);
+		let t = document.createElement("script");
+		return t.src = a, t.defer = !0, t.dataset.siteId = e, document.head.appendChild(t), () => {
+			document.head.removeChild(t);
 		};
 	}, [
-		i,
+		e,
 		a,
 		f
-	]), t(() => {
-		if (!(!i || !f || g())) return u.onAny((e) => {
-			if (b()) return;
+	]), n(() => {
+		if (!(!e || !f || _())) return u.onAny((e) => {
+			if (x()) return;
 			let t = window;
 			if (!t.rybbit || !c.includes(e.name)) return;
-			let n = T({
+			let n = E({
 				route: e.metadata.route.pathname,
 				env: e.metadata.app.env,
-				...w(e.payload, e.name)
+				...T(e.payload, e.name)
 			});
 			if (e.name === l) {
 				let r = e.payload, i = r?.userId ?? r?.actorId ?? r?.id;
-				i && S(i).then((e) => {
+				i && C(i).then((e) => {
 					t.rybbit?.identify(e, n);
 				});
 			}
@@ -135,50 +136,46 @@ function E({ siteId: i, scriptUrl: a = "https://app.rybbit.io/api/script.js", re
 				t.rybbit.pageview();
 				return;
 			}
-			let r = s[e.name] ?? e.name;
+			let r = o[e.name] ?? e.name;
 			t.rybbit.event(r, n);
 		});
 	}, [
 		u,
-		i,
+		e,
 		c,
 		l,
-		s,
+		o,
 		f
 	]), null;
 }
-function D({ productName: e = "this product" }) {
-	let [t, n] = r(() => _() === null);
-	return !t || g() ? null : /* @__PURE__ */ a("aside", {
+function O({ productName: t = "this product" }) {
+	let [n, r] = i(() => v() === null), s = e();
+	return !n || _() ? null : /* @__PURE__ */ o("aside", {
 		className: "fixed bottom-4 left-4 z-[100] w-[calc(100%-2rem)] max-w-sm rounded-xl border border-border-seam bg-bg-surface p-4 text-text-primary shadow-pop",
-		"aria-label": "Privacy choices",
+		"aria-label": s("privacyConsent.ariaLabel", "Privacy choices"),
 		"data-testid": "analytics-consent-banner",
 		children: [/* @__PURE__ */ a("p", {
 			className: "text-sm",
-			children: [
-				"Allow optional analytics to help improve ",
-				e,
-				"? Essential product operation works either way."
-			]
-		}), /* @__PURE__ */ a("div", {
+			children: s("privacyConsent.message", "Allow optional analytics to help improve {{productName}}? Essential product operation works either way.", { productName: t })
+		}), /* @__PURE__ */ o("div", {
 			className: "mt-3 flex gap-2",
-			children: [/* @__PURE__ */ i("button", {
+			children: [/* @__PURE__ */ a("button", {
 				type: "button",
 				className: "rounded-md border border-border-seam px-3 py-2 text-sm",
 				onClick: () => {
-					y(!1), n(!1);
+					b(!1), r(!1);
 				},
-				children: "Reject optional"
-			}), /* @__PURE__ */ i("button", {
+				children: s("privacyConsent.reject", "Reject optional")
+			}), /* @__PURE__ */ a("button", {
 				type: "button",
 				className: "rounded-md bg-action-primary-bg px-3 py-2 text-sm text-action-primary-text",
 				onClick: () => {
-					y(!0), n(!1);
+					b(!0), r(!1);
 				},
-				children: "Allow analytics"
+				children: s("privacyConsent.allow", "Allow analytics")
 			})]
 		})]
 	});
 }
 //#endregion
-export { D as AnalyticsConsentBanner, E as RybbitSink, v as readAnalyticsConsent, _ as readAnalyticsConsentChoice, y as setAnalyticsConsent };
+export { O as AnalyticsConsentBanner, D as RybbitSink, y as readAnalyticsConsent, v as readAnalyticsConsentChoice, b as setAnalyticsConsent };

package/dist/shared/hooks/index.d.ts

@@ -38,4 +38,6 @@ export type { UseQuotaErrorToastOptions, QuotaExhaustedEventDetail } from './use
 export { useUpgradePrompt, publishPlanUsageSnapshot, PLAN_USAGE_SNAPSHOT_EVENT, } from './useUpgradePrompt';
 export type { UseUpgradePromptOptions, UseUpgradePromptResult, PlanUsageEntry, PlanUsageSnapshot, } from './useUpgradePrompt';
 export { useCurrentContextSearchParams, appendContextToPath, } from './useCurrentContextSearchParams';
+export { useUnsavedChanges, listUnsavedChanges, registerUnsavedChange, unsavedChangesBlocking, UNSAVED_CHANGE_LABEL_MAX, } from '../navigation/unsavedChanges';
+export type { UnsavedChange, UseUnsavedChangesOptions, NavigationInitiator, } from '../navigation/unsavedChanges';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAc,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,8CAA2D,CAAC;AAE7F;;GAEG;AACH,wBAAgB,uBAAuB,2BAMtC;AAOD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG9E,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjG,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAc,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,8CAA2D,CAAC;AAE7F;;GAEG;AACH,wBAAgB,uBAAuB,2BAMtC;AAOD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG9E,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjG,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,aAAa,EACb,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC"}

package/dist/shared/navigation/unsavedChanges.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ★ BOFF-8060 (N4, C9): the leave-page guard.
+ *
+ * A page that holds work the person has not saved — an editor with changes, a
+ * half-filled form — says so here, in its own words, for as long as it holds
+ * it. The assistant reads the list before it moves the person anywhere:
+ *
+ * - an assistant-initiated navigation (a typed or spoken "take me to…", "go
+ *   back", "take me there", a "yes" to an offer, act-on-resolve) is REFUSED
+ *   while anything is listed (`createAssistantNavigate`), and the panel says
+ *   "You have unsaved changes in {label}. Save or discard them, then ask
+ *   again." The draft is never lost to the assistant;
+ * - act-on-resolve's guard R5 passes only when the list is empty;
+ * - the person's own navigation (the sidebar, a link they click, an "Open
+ *   {page}" link they tap) is not touched: it stays at sidebar parity.
+ *
+ * Page-scoped: an entry lives exactly as long as the component that registered
+ * it is mounted AND reports itself dirty. Unmounting (leaving the page) or
+ * going clean (saved, discarded) removes it. Nothing is persisted.
+ *
+ * ★★ One registry per page, not per copy of this module: a product microfe and
+ * the assistant overlay can end up with two copies of fe-libs in one bundle
+ * (a local-source plugin, a duplicate install), and a registry held in module
+ * scope would then leave the assistant reading an empty list while the editor
+ * wrote to the other one. The registry lives on `globalThis` under a
+ * registered symbol, so every copy reads and writes the same one.
+ */
+/** One unsaved change: where it is, in the product's own (translated) words. */
+export interface UnsavedChange {
+    /** Stable id of what holds the change, e.g. `dashboard-editor`. */
+    id: string;
+    /** What the person calls it, e.g. "the dashboard editor". Shown in the reply. */
+    label: string;
+}
+export interface UseUnsavedChangesOptions {
+    /** Stable id of what holds the change. Two registrations with one id are listed once. */
+    id: string;
+    /** What the person calls it, translated by the product. */
+    label: string;
+    /** Does it hold unsaved changes right now? */
+    dirty: boolean;
+}
+/** Longest label kept: it is quoted in a one-line reply. */
+export declare const UNSAVED_CHANGE_LABEL_MAX = 80;
+/**
+ * Register one unsaved change. Returns the function that removes it; call it
+ * when the change is saved or discarded, or when its holder goes away.
+ *
+ * ★ A registration is never dropped for a poor label: an empty label still
+ * counts as unsaved (the reply then names "this page"). Losing a guard over a
+ * missing word would be the expensive mistake.
+ */
+export declare function registerUnsavedChange(change: UnsavedChange): () => void;
+/**
+ * The unsaved changes on the page right now, oldest registration first, one
+ * per id. Empty when nothing is unsaved.
+ */
+export declare function listUnsavedChanges(): UnsavedChange[];
+/**
+ * Report a page's unsaved changes for as long as `dirty` is true and the
+ * calling component is mounted.
+ *
+ * ```tsx
+ * useUnsavedChanges({
+ *   id: "dashboard-editor",
+ *   label: t("dashboards.editor.unsavedLabel", "the dashboard editor"),
+ *   dirty: hasChanges,
+ * });
+ * ```
+ */
+export declare function useUnsavedChanges({ id, label, dirty }: UseUnsavedChangesOptions): void;
+/** Who started a navigation: the person (a link, the sidebar) or the assistant. */
+export type NavigationInitiator = "person" | "assistant";
+/**
+ * Should a navigation be refused for unsaved changes? Only one the ASSISTANT
+ * started, and only while something is unsaved; the person's own navigation
+ * never is. Returns the changes to name in the refusal, or null to go ahead.
+ *
+ * ★ Anything but an explicit `"person"` counts as the assistant's, so a caller
+ * that forgets to say is guarded rather than let through.
+ */
+export declare function unsavedChangesBlocking(initiator: NavigationInitiator | undefined): UnsavedChange[] | null;
+//# sourceMappingURL=unsavedChanges.d.ts.map

package/dist/shared/navigation/unsavedChanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsavedChanges.d.ts","sourceRoot":"","sources":["../../../src/shared/navigation/unsavedChanges.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,yFAAyF;IACzF,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,KAAK,CAAC;AA6B3C;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,IAAI,CAMvE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,EAAE,CASpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,wBAAwB,GAAG,IAAI,CAKtF;AAED,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,mBAAmB,GAAG,SAAS,GACzC,aAAa,EAAE,GAAG,IAAI,CAIxB"}

package/dist/shared/navigation/unsavedChanges.js

@@ -0,0 +1,46 @@
+import { useEffect as e } from "react";
+//#region src/shared/navigation/unsavedChanges.ts
+var t = 80, n = Symbol.for("burdenoff.fe-libs.unsavedChanges.v1");
+function r() {
+	let e = globalThis, t = e[n];
+	if (t instanceof Map) return t;
+	let r = /* @__PURE__ */ new Map();
+	return e[n] = r, r;
+}
+function i(e) {
+	let t = e.replace(/\s+/g, " ").trim();
+	return t.length <= 80 ? t : `${t.slice(0, 79).trimEnd()}…`;
+}
+function a(e) {
+	let t = Symbol(e.id);
+	return r().set(t, {
+		id: e.id,
+		label: i(e.label)
+	}), () => {
+		r().delete(t);
+	};
+}
+function o() {
+	let e = /* @__PURE__ */ new Set(), t = [];
+	for (let n of r().values()) e.has(n.id) || (e.add(n.id), t.push({ ...n }));
+	return t;
+}
+function s({ id: t, label: n, dirty: r }) {
+	e(() => {
+		if (r) return a({
+			id: t,
+			label: n
+		});
+	}, [
+		t,
+		n,
+		r
+	]);
+}
+function c(e) {
+	if (e === "person") return null;
+	let t = o();
+	return t.length > 0 ? t : null;
+}
+//#endregion
+export { t as UNSAVED_CHANGE_LABEL_MAX, o as listUnsavedChanges, a as registerUnsavedChange, c as unsavedChangesBlocking, s as useUnsavedChanges };

package/dist/shared/providers/AppShellProvider.d.ts

@@ -13,6 +13,23 @@ export interface AppShellConfig {
     domain?: string;
     /** Product ID for i18n translations service */
     i18nProductId: string;
+    /**
+     * The platform dictionary layered UNDER the product's: fallback < platform <
+     * product (BOFF-8060). Default `workspaces`, where the platform screens and
+     * the shared chrome keep their keys. `null` loads the product dictionary
+     * alone. Ignored by the Workspaces app itself (same id).
+     */
+    platformI18nProductId?: string | null;
+    /**
+     * Right-to-left support (BOFF-8060, F6). `enabled` (default false) lets
+     * `dir` follow the locale (Arabic RTL); leave it off until the product's UI
+     * uses logical CSS properties. `preview` (default true) honours the QA
+     * override `?dir=rtl` / `?dir=locale` / `?dir=off`.
+     */
+    rtl?: {
+        enabled?: boolean;
+        preview?: boolean;
+    };
     /** Resolved gateway URLs */
     gatewayUrls: {
         workspaceBaseUrl: string;

package/dist/shared/providers/AppShellProvider.d.ts.map

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