@burdenoff/fe-libs 2026.723.5 → 2026.725.1

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

@@ -53,6 +53,24 @@ export interface ActiveContextProviderProps {
         tenant?: string;
     };
 }
+export declare const CONTEXT_THRASH_WINDOW_MS = 500;
+export declare const CONTEXT_THRASH_MAX_FLIPS = 3;
+export interface ContextFieldThrashState {
+    current: string | null;
+    previous: string | null;
+    flips: number;
+    windowStart: number;
+    suppressUntil: number;
+}
+export declare function createContextFieldThrashState(initial: string | null): ContextFieldThrashState;
+/**
+ * Decides whether `nextValue` should be applied to a context field, mutating
+ * `state` to reflect the decision. Returns `false` for a true no-op (value
+ * unchanged), while an active suppression window is in effect, or when this
+ * write is detected as the Nth rapid alternation back to the field's prior
+ * value — the ping-pong signature described above.
+ */
+export declare function shouldApplyContextFieldWrite(fieldName: string, state: ContextFieldThrashState, nextValue: string | null, now: number): boolean;
 /**
  * ActiveContextProvider
  *

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

@@ -1 +1 @@
-{"version":3,"file":"ActiveContextProvider.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ActiveContextProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAiBf;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sCAAsC;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oCAAoC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,kCAAkC;IAClC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,+BAA+B;IAC/B,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,6BAA6B;IAC7B,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,4BAA4B;IAC5B,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAE7C,qCAAqC;IACrC,UAAU,EAAE,CACV,OAAO,EAAE,OAAO,CAAC;QACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC,KACC,IAAI,CAAC;IAEV,+BAA+B;IAC/B,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAC;CACzB;AAID,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,CAAC;IACpB,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sBAAsB;IACtB,SAAS,CAAC,EAAE;QACV,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAiCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,qBAA4B,EAC5B,kBAAyB,EACzB,gBAAuB,EACvB,eAAsB,EACtB,UAAuC,EACvC,SAAiB,EACjB,SAA6C,GAC9C,EAAE,0BAA0B,2CAkS5B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,uBAM/B"}
+{"version":3,"file":"ActiveContextProvider.d.ts","sourceRoot":"","sources":["../../../../src/shared/providers/shell/ActiveContextProvider.tsx"],"names":[],"mappings":"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"}

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

@@ -1,32 +1,60 @@
 import { getProfileContext as e, resolveActiveProfileId as t, setProfileContext as n } from "./ProfileStorageManager.js";
 import { ACTIVE_CONTEXT_STORAGE_KEY as r, DEFAULT_ACTIVE_CONTEXT_URL_PARAMS as i, clearActiveContextStorage as a, getUrlParam as o, readActiveContextStorageValue as s, writeActiveContextFallback as c, writeActiveContextStorageValue as l } from "./ActiveContextStorage.js";
 import { isSsoNavigationPending as u } from "../../utils/ssoDeposit.js";
-import { createContext as d, use as f, useCallback as p, useEffect as m, useMemo as h, useState as g } from "react";
-import { jsx as _ } from "react/jsx-runtime";
+import { createContext as d, use as f, useCallback as p, useEffect as m, useMemo as h, useRef as g, useState as _ } from "react";
+import { jsx as v } from "react/jsx-runtime";
 //#region src/shared/providers/shell/ActiveContextProvider.tsx
-var v = d(null);
-function y(e) {
+var y = d(null);
+function b(e) {
+	return {
+		current: e,
+		previous: null,
+		flips: 0,
+		windowStart: 0,
+		suppressUntil: 0
+	};
+}
+function x() {
+	try {
+		return !!{
+			BASE_URL: "/",
+			DEV: !1,
+			MODE: "production",
+			PROD: !0,
+			SSR: !1
+		}?.DEV;
+	} catch {
+		return !1;
+	}
+}
+function S(e, t, n, r) {
+	if (t.current === n) return !1;
+	if (r < t.suppressUntil) return x() && console.warn(`[ActiveContext] Suppressing rapid ${e} change to avoid a render loop (BOFF-5395): holding at ${JSON.stringify(t.current)}, refused ${JSON.stringify(n)}.`), !1;
+	let i = n === t.previous, a = r - t.windowStart < 500;
+	return i && a ? t.flips += 1 : (t.flips = 1, t.windowStart = r), t.flips >= 3 ? (t.suppressUntil = r + 500, t.flips = 0, x() && console.warn(`[ActiveContext] Detected ${e} ping-pong between ${JSON.stringify(t.current)} and ${JSON.stringify(n)} (BOFF-5395) — holding at the current value instead of looping.`), !1) : (t.previous = t.current, t.current = n, !0);
+}
+function C(e) {
 	if (typeof window > "u" || u() || window.location.pathname.startsWith("/auth/")) return;
 	let t = new URL(window.location.href);
 	Object.entries(e).forEach(([e, n]) => {
 		n ? t.searchParams.set(e, n) : t.searchParams.delete(e);
 	}), window.history.replaceState({}, "", t.toString());
 }
-function b({ children: u, defaultOrganizationId: d = null, defaultWorkspaceId: f = null, defaultProjectId: b = null, defaultTenantId: x = null, storageKey: S = r, syncToUrl: C = !1, urlParams: w = i }) {
-	let [T, E] = g(() => {
+function w({ children: u, defaultOrganizationId: d = null, defaultWorkspaceId: f = null, defaultProjectId: x = null, defaultTenantId: w = null, storageKey: T = r, syncToUrl: E = !1, urlParams: D = i }) {
+	let [O, k] = _(() => {
 		if (typeof window > "u") return d;
-		if (C) {
-			let e = o(w.organization);
+		if (E) {
+			let e = o(D.organization);
 			if (e) return e;
 		}
-		return s("organization", S) || d;
-	}), [D, O] = g(() => {
+		return s("organization", T) || d;
+	}), [A, j] = _(() => {
 		if (typeof window > "u") return f;
-		if (C) {
-			let e = o(w.workspace);
+		if (E) {
+			let e = o(D.workspace);
 			if (e) return e;
 		}
-		let r = s("workspace", S) || f;
+		let r = s("workspace", T) || f;
 		if (r) {
 			let i = t();
 			if (i) {
@@ -38,145 +66,152 @@ function b({ children: u, defaultOrganizationId: d = null, defaultWorkspaceId: f
 			}
 		}
 		return r;
-	}), [k, A] = g(() => {
-		if (typeof window > "u") return b;
-		if (C) {
-			let e = o(w.project);
+	}), [M, N] = _(() => {
+		if (typeof window > "u") return x;
+		if (E) {
+			let e = o(D.project);
 			if (e) return e;
 		}
-		return s("project", S) || b;
-	}), [j, M] = g(() => {
-		if (typeof window > "u") return x;
-		if (C) {
-			let e = o(w.tenant);
+		return s("project", T) || x;
+	}), [P, F] = _(() => {
+		if (typeof window > "u") return w;
+		if (E) {
+			let e = o(D.tenant);
 			if (e) return e;
 		}
-		return s("tenant", S) || x;
-	});
-	m(() => {
-		l("organization", T, S), l("workspace", D, S), l("project", k, S), l("tenant", j, S);
+		return s("tenant", T) || w;
+	}), I = g(null);
+	I.current === null && (I.current = b(O));
+	let L = g(null);
+	L.current === null && (L.current = b(A));
+	let R = g(null);
+	R.current === null && (R.current = b(M));
+	let z = g(null);
+	z.current === null && (z.current = b(P)), m(() => {
+		l("organization", O, T), l("workspace", A, T), l("project", M, T), l("tenant", P, T);
 	}, [
-		T,
-		D,
-		k,
-		j,
-		S
+		O,
+		A,
+		M,
+		P,
+		T
 	]), m(() => {
 		let r = t();
 		if (!r) return;
 		let i = e(r), a = {
 			...i,
-			organizationId: T,
-			workspaceId: D,
-			projectId: k,
-			tenantId: j
+			organizationId: O,
+			workspaceId: A,
+			projectId: M,
+			tenantId: P
 		};
 		i?.organizationId === a.organizationId && i?.workspaceId === a.workspaceId && i?.projectId === a.projectId && i?.tenantId === a.tenantId || n(r, a);
 	}, [
-		T,
-		D,
-		k,
-		j
+		O,
+		A,
+		M,
+		P
 	]), m(() => {
-		C && y({
-			[w.organization]: T,
-			[w.workspace]: D,
-			[w.project]: k,
-			[w.tenant]: j
+		E && C({
+			[D.organization]: O,
+			[D.workspace]: A,
+			[D.project]: M,
+			[D.tenant]: P
 		});
 	}, [
-		T,
-		D,
-		k,
-		j,
-		C,
-		w
+		O,
+		A,
+		M,
+		P,
+		E,
+		D
 	]), m(() => {
-		if (!C) return;
+		if (!E) return;
 		let e = () => {
-			let e = o(w.organization), t = o(w.workspace), n = o(w.project), r = o(w.tenant);
-			e !== T && E(e), t !== D && O(t), n !== k && A(n), r !== j && M(r);
+			let e = o(D.organization), t = o(D.workspace), n = o(D.project), r = o(D.tenant);
+			e !== O && (k(e), I.current.previous = I.current.current, I.current.current = e), t !== A && (j(t), L.current.previous = L.current.current, L.current.current = t), n !== M && (N(n), R.current.previous = R.current.current, R.current.current = n), r !== P && (F(r), z.current.previous = z.current.current, z.current.current = r);
 		};
 		return window.addEventListener("popstate", e), () => window.removeEventListener("popstate", e);
 	}, [
-		C,
-		w,
-		T,
+		E,
 		D,
-		k,
-		j
+		O,
+		A,
+		M,
+		P
 	]);
-	let N = p((r) => {
-		E(r);
+	let B = p((r) => {
+		if (!S("organizationId", I.current, r, Date.now())) return;
+		k(r);
 		let i = t();
 		i && n(i, {
 			...e(i),
 			organizationId: r
 		}), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:organization-changed", { detail: { organizationId: r } }));
-	}, []), P = p((r, i) => {
+	}, []), V = p((r, i) => {
 		let a = {
 			organization: "organizationId",
 			workspace: "workspaceId",
 			project: "projectId",
 			tenant: "tenantId"
 		};
-		l(r, i, S);
+		l(r, i, T);
 		let o = t();
 		o ? n(o, {
 			...e(o),
 			[a[r]]: i
-		}) : typeof window < "u" && c(r, i, S);
-	}, [S]), F = p((e) => {
-		O(e), P("workspace", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:workspace-changed", { detail: { workspaceId: e } }));
-	}, [P]), I = p((e) => {
-		A(e), P("project", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:project-changed", { detail: { projectId: e } }));
-	}, [P]), L = p((e) => {
-		M(e), P("tenant", e);
-	}, [P]), R = p((e) => {
-		e.organizationId !== void 0 && N(e.organizationId), e.workspaceId !== void 0 && F(e.workspaceId), e.projectId !== void 0 && I(e.projectId), e.tenantId !== void 0 && L(e.tenantId);
+		}) : typeof window < "u" && c(r, i, T);
+	}, [T]), H = p((e) => {
+		S("workspaceId", L.current, e, Date.now()) && (j(e), V("workspace", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:workspace-changed", { detail: { workspaceId: e } })));
+	}, [V]), U = p((e) => {
+		S("projectId", R.current, e, Date.now()) && (N(e), V("project", e), typeof window < "u" && window.dispatchEvent(new CustomEvent("burdenoff:project-changed", { detail: { projectId: e } })));
+	}, [V]), W = p((e) => {
+		S("tenantId", z.current, e, Date.now()) && (F(e), V("tenant", e));
+	}, [V]), G = p((e) => {
+		e.organizationId !== void 0 && B(e.organizationId), e.workspaceId !== void 0 && H(e.workspaceId), e.projectId !== void 0 && U(e.projectId), e.tenantId !== void 0 && W(e.tenantId);
 	}, [
-		N,
-		F,
-		I,
-		L
-	]), z = p(() => {
-		E(null), O(null), A(null), M(null), a(S);
+		B,
+		H,
+		U,
+		W
+	]), K = p(() => {
+		k(null), j(null), N(null), F(null), I.current = b(null), L.current = b(null), R.current = b(null), z.current = b(null), a(T);
 		let e = t();
 		e && n(e, {});
-	}, [S]), B = h(() => ({
-		organizationId: T,
-		workspaceId: D,
-		projectId: k,
-		tenantId: j,
-		setOrganization: N,
-		setWorkspace: F,
-		setProject: I,
-		setTenant: L,
-		setContext: R,
-		clearContext: z,
-		urlSyncEnabled: C
+	}, [T]), q = h(() => ({
+		organizationId: O,
+		workspaceId: A,
+		projectId: M,
+		tenantId: P,
+		setOrganization: B,
+		setWorkspace: H,
+		setProject: U,
+		setTenant: W,
+		setContext: G,
+		clearContext: K,
+		urlSyncEnabled: E
 	}), [
-		T,
-		D,
-		k,
-		j,
-		N,
-		F,
-		I,
-		L,
-		R,
-		z,
-		C
+		O,
+		A,
+		M,
+		P,
+		B,
+		H,
+		U,
+		W,
+		G,
+		K,
+		E
 	]);
-	return /* @__PURE__ */ _(v.Provider, {
-		value: B,
+	return /* @__PURE__ */ v(y.Provider, {
+		value: q,
 		children: u
 	});
 }
-function x() {
-	let e = f(v);
+function T() {
+	let e = f(y);
 	if (!e) throw Error("useActiveContext must be used within an ActiveContextProvider");
 	return e;
 }
 //#endregion
-export { b as ActiveContextProvider, x as useActiveContext };
+export { w as ActiveContextProvider, T as useActiveContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.723.5",
+  "version": "2026.725.1",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "imports": {