@burdenoff/fe-libs 2026.1021.3 → 2026.1021.4

package/dist/chrome/contextSwitcher/contextSwitch.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Header organization / workspace switches (BOFF-8078), shared by every shell
+ * through `useContextSwitchController` (lifted from fluidgrids-app, where the
+ * same file was copied into bigconsole-app and healthybowl-app).
+ *
+ * `selectWorkspace` (microfe-auth) issues a token for the workspace it is
+ * given and then lists that workspace's projects. The list request does NOT
+ * carry the workspace it was asked about: fe-libs `graphqlFetch` derives the
+ * `x-workspace-id` header, and the context the fresh workspace token is
+ * validated against, from the stored ActiveContext (`bf-p-<uid>-context`, with
+ * the `?workspace=` URL param taking precedence). When the handler calls
+ * `selectWorkspace(B)` while ActiveContext still names workspace A, the new
+ * token is dropped as "invalid for context A", a token for A is minted in its
+ * place, and the request lists A's projects. The handler then selected A's
+ * first project, so the stored context paired workspace B with a project from
+ * workspace A, and kept that pair across reloads.
+ *
+ * Measured in prod on 2026-09-28 with the header switcher, A = f423fce9 and
+ * B = 089761cb: `MyProjectsForContext` went out with `x-workspace-id: f423fce9`
+ * and A's workspace token right after `IssueWorkspaceToken` returned B's token,
+ * and answered A's only project (e35d7c3b). VibeControls, which publishes the
+ * new workspace first, ends on B's project (e6febd92).
+ *
+ * So both switches publish the target context to ActiveContext first — the
+ * organization and workspace, with the project cleared — and only then ask
+ * microfe-auth to select it. Only a project that belongs to the target
+ * workspace is ever selected, and a switch that a later switch has superseded
+ * is discarded instead of applied.
+ */
+export interface SwitchableOrganization {
+    id: string;
+    tenantId?: unknown;
+}
+export interface SwitchableWorkspace {
+    id: string;
+    organizationId?: string | null;
+    tenantId?: unknown;
+}
+export interface SwitchableProject {
+    id: string;
+    workspaceId?: string | null;
+}
+export interface WorkspaceSelection<P extends SwitchableProject> {
+    success: boolean;
+    projects?: ReadonlyArray<P>;
+}
+export interface ContextSwitchDeps<O extends SwitchableOrganization, W extends SwitchableWorkspace, P extends SwitchableProject> {
+    /**
+     * Monotonic switch counter (a React ref), shared by the organization and
+     * workspace switches: the most recent switch of either kind wins.
+     */
+    requests: {
+        current: number;
+    };
+    setOrganization: (organizationId: string | null) => void;
+    setWorkspace: (workspaceId: string | null) => void;
+    setProject: (projectId: string | null) => void;
+    setTenant: (tenantId: string | null) => void;
+    selectOrganization: (organization: O) => Promise<ReadonlyArray<W>>;
+    selectWorkspace: (workspace: W) => Promise<WorkspaceSelection<P>>;
+    selectProject: (project: P) => void;
+}
+export type ContextSwitchOutcome = {
+    status: 'project-selected';
+    workspaceId: string;
+    projectId: string;
+} | {
+    status: 'no-project';
+    workspaceId: string;
+} | {
+    status: 'no-workspace';
+} | {
+    status: 'superseded';
+};
+/** The first project the selection returned that belongs to `workspaceId`. */
+export declare function firstProjectOfWorkspace<P extends SwitchableProject>(selection: WorkspaceSelection<P>, workspaceId: string): P | null;
+/** Header workspace switch: enter `workspace` and select its first project. */
+export declare function switchWorkspace<O extends SwitchableOrganization, W extends SwitchableWorkspace, P extends SwitchableProject>(deps: ContextSwitchDeps<O, W, P>, workspace: W): Promise<ContextSwitchOutcome>;
+/**
+ * Header organization switch: clear the workspace and project, load the
+ * organization's workspaces, then enter the first one exactly as a workspace
+ * switch would.
+ */
+export declare function switchOrganization<O extends SwitchableOrganization, W extends SwitchableWorkspace, P extends SwitchableProject>(deps: ContextSwitchDeps<O, W, P>, organization: O): Promise<ContextSwitchOutcome>;

package/dist/chrome/contextSwitcher/contextSwitch.js

@@ -0,0 +1,31 @@
+//#region src/chrome/contextSwitcher/contextSwitch.ts
+function e(e, t) {
+	return e.success ? e.projects?.find((e) => e.workspaceId === t) ?? null : null;
+}
+async function t(t, n, r) {
+	n.organizationId && t.setOrganization(n.organizationId), typeof n.tenantId == "string" && t.setTenant(n.tenantId), t.setWorkspace(n.id), t.setProject(null);
+	let i = await t.selectWorkspace(n);
+	if (r !== t.requests.current) return { status: "superseded" };
+	let a = e(i, n.id);
+	return a ? (t.selectProject(a), t.setProject(a.id), {
+		status: "project-selected",
+		workspaceId: n.id,
+		projectId: a.id
+	}) : {
+		status: "no-project",
+		workspaceId: n.id
+	};
+}
+function n(e, n) {
+	return t(e, n, ++e.requests.current);
+}
+async function r(e, n) {
+	let r = ++e.requests.current;
+	e.setOrganization(n.id), typeof n.tenantId == "string" && e.setTenant(n.tenantId), e.setWorkspace(null), e.setProject(null);
+	let i = await e.selectOrganization(n);
+	if (r !== e.requests.current) return { status: "superseded" };
+	let a = i[0];
+	return a ? t(e, a, r) : { status: "no-workspace" };
+}
+//#endregion
+export { e as firstProjectOfWorkspace, r as switchOrganization, n as switchWorkspace };

package/dist/chrome/contextSwitcher/resolveSwitchTarget.d.ts

@@ -0,0 +1,51 @@
+/**
+ * resolveSwitchTarget — where to land when the active org/workspace changes.
+ *
+ * The workspace token is re-issued on every context switch (BOFF-2821). A route
+ * that holds a *resource id belonging to the old workspace* (a workflow, a run,
+ * an agent, a file …) would then fire queries the new token cannot authorize —
+ * the "Unexpected error" banners — or show the old workspace's record under the
+ * new workspace. So when the switch starts on such a resource-deep route the
+ * shell replace-navigates to that section's list page; the stale id is dropped.
+ *
+ * List/section pages (no resource id) are NOT redirected: they re-scope in place
+ * through the new selection. Each product passes its own rule table, because the
+ * route shapes are product-specific (VibeControls' `/vibecontrols/<section>/<id>`,
+ * FluidGrids' `/workflows/workflow/<key>/<version>` and `/workflows/runs/<id>`).
+ *
+ * Lifted from vibecontrols-app `src/routes/resolveSwitchTarget.ts` (BOFF-2821),
+ * with VibeControls' hard-coded tables turned into a parameter.
+ */
+/** One resource-deep route and the list/landing route that replaces it. */
+export interface ContextSwitchRedirectRule {
+    /**
+     * Matches a pathname that carries a resource id of the old context. Rules are
+     * tried in order; the first match wins. A `g`/`y` flag is ignored (the match
+     * is always made from the start of a fresh state), so a shared rule table
+     * gives the same answer on every call.
+     */
+    match: RegExp;
+    /** The landing to go to: a fixed path, or one computed from the match. */
+    to: string | ((match: RegExpExecArray) => string);
+}
+/**
+ * The target pathname to replace-navigate to after a context switch, or `null`
+ * to stay on `pathname` (only the context query params change).
+ *
+ * Returns `null` when no rule matches, and when the matching rule's landing is
+ * `pathname` itself, so a rule can never loop on its own landing page.
+ */
+export declare function resolveSwitchTarget(pathname: string, rules: ReadonlyArray<ContextSwitchRedirectRule>): string | null;
+/**
+ * A rule for a family of `<prefix>/<section>/<id…>` detail routes: anything
+ * deeper than a `<prefix>/<section>` landing redirects back to that landing, so
+ * current and future detail routes are covered without enumerating each one.
+ * The bare `<prefix>/<section>` page and `<prefix>` itself stay in place.
+ *
+ * `sectionLandingRule('/vibecontrols')` is VibeControls' rule:
+ * `/vibecontrols/agents/a1` → `/vibecontrols/agents`,
+ * `/vibecontrols/calendar/task/t1` → `/vibecontrols/calendar`.
+ *
+ * @param prefix a rooted path without a trailing slash, e.g. `/vibecontrols`
+ */
+export declare function sectionLandingRule(prefix: string): ContextSwitchRedirectRule;

package/dist/chrome/contextSwitcher/resolveSwitchTarget.js

@@ -0,0 +1,26 @@
+//#region src/chrome/contextSwitcher/resolveSwitchTarget.ts
+function e(e, n) {
+	for (let r of n) {
+		let n = t(r.match).exec(e);
+		if (!n) continue;
+		let i = typeof r.to == "string" ? r.to : r.to(n);
+		return i === e ? null : i;
+	}
+	return null;
+}
+function t(e) {
+	return !e.global && !e.sticky ? e : new RegExp(e.source, e.flags.replace(/[gy]/g, ""));
+}
+function n(e) {
+	return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function r(e) {
+	if (!/^\/[^/]/.test(e) || e.endsWith("/")) throw Error(`sectionLandingRule: prefix must be a rooted path without a trailing slash, got "${e}"`);
+	let t = n(e);
+	return {
+		match: RegExp(`^${t}/([^/]+)/[^/]+`),
+		to: (t) => `${e}/${t[1]}`
+	};
+}
+//#endregion
+export { e as resolveSwitchTarget, r as sectionLandingRule };

package/dist/chrome/contextSwitcher/useContextSwitchController.d.ts

@@ -0,0 +1,50 @@
+import { ContextSwitchOutcome, SwitchableOrganization, SwitchableProject, SwitchableWorkspace, WorkspaceSelection } from './contextSwitch';
+import { ContextSwitchRedirectRule } from './resolveSwitchTarget';
+/** Which header switch produced an outcome. */
+export type ContextSwitchKind = 'organization' | 'workspace';
+export interface ContextSwitchEvent {
+    kind: ContextSwitchKind;
+    /** The organization or workspace the user picked. */
+    id: string;
+    outcome: ContextSwitchOutcome;
+}
+export interface UseContextSwitchControllerOptions<O extends SwitchableOrganization, W extends SwitchableWorkspace, P extends SwitchableProject> {
+    /** The switcher's lists; a pick is resolved to its full record here. */
+    organizations: ReadonlyArray<O>;
+    workspaces: ReadonlyArray<W>;
+    projects: ReadonlyArray<P>;
+    /** microfe-auth: select the organization and list its workspaces. */
+    selectOrganization: (organization: O) => Promise<ReadonlyArray<W>>;
+    /** microfe-auth: issue the workspace token and list the workspace's projects. */
+    selectWorkspace: (workspace: W) => Promise<WorkspaceSelection<P>>;
+    /** microfe-auth: select a project. */
+    selectProject: (project: P) => void;
+    /**
+     * The product's resource-deep routes and their list pages. Omitted or empty:
+     * a switch never navigates.
+     */
+    redirectRules?: ReadonlyArray<ContextSwitchRedirectRule>;
+    /** Called with every switch's outcome, superseded ones included. */
+    onSwitch?: (event: ContextSwitchEvent) => void;
+}
+export interface ContextSwitchController {
+    /**
+     * Switch to `organization` and enter its first workspace. Resolves to the
+     * outcome, or `null` when the id is not in `organizations`.
+     */
+    onOrganizationChange: (organization: {
+        id: string;
+    }) => Promise<ContextSwitchOutcome | null>;
+    /**
+     * Switch to `workspace` and select its first project. Resolves to the
+     * outcome, or `null` when the id is not in `workspaces`.
+     */
+    onWorkspaceChange: (workspace: {
+        id: string;
+    }) => Promise<ContextSwitchOutcome | null>;
+    /** Select `project` (an id missing from `projects` still becomes active). */
+    onProjectChange: (project: {
+        id: string;
+    }) => void;
+}
+export declare function useContextSwitchController<O extends SwitchableOrganization, W extends SwitchableWorkspace, P extends SwitchableProject>(options: UseContextSwitchControllerOptions<O, W, P>): ContextSwitchController;

package/dist/chrome/contextSwitcher/useContextSwitchController.js

@@ -0,0 +1,62 @@
+import { useActiveContext as e } from "../../shared/providers/shell/ActiveContextProvider.js";
+import { useLogger as t } from "../../shared/logger/useLogger.js";
+import { switchOrganization as n, switchWorkspace as r } from "./contextSwitch.js";
+import { resolveSwitchTarget as i } from "./resolveSwitchTarget.js";
+import { useRef as a } from "react";
+import { useLocation as o, useNavigate as s } from "react-router";
+//#region src/chrome/contextSwitcher/useContextSwitchController.ts
+function c(c) {
+	let { organizations: l, workspaces: u, projects: d, selectOrganization: f, selectWorkspace: p, selectProject: m, redirectRules: h, onSwitch: g } = c, _ = t("ContextSwitcher"), v = s(), { pathname: y } = o(), b = e(), x = {
+		requests: a(0),
+		setOrganization: b.setOrganization,
+		setWorkspace: b.setWorkspace,
+		setProject: b.setProject,
+		setTenant: b.setTenant,
+		selectOrganization: f,
+		selectWorkspace: p,
+		selectProject: m
+	}, S = () => {
+		if (!h || h.length === 0) return;
+		let e = i(y, h);
+		e && (_.info("Leaving a resource of the previous context", {
+			from: y,
+			to: e
+		}), v({
+			pathname: e,
+			search: typeof window > "u" ? "" : window.location.search
+		}, { replace: !0 }));
+	}, C = (e, t, n) => {
+		n.status === "superseded" && _.info(`Discarding stale ${e}-switch result`, { [`${e}Id`]: t }), g?.({
+			kind: e,
+			id: t,
+			outcome: n
+		});
+	};
+	return {
+		onOrganizationChange: async (e) => {
+			let t = l.find((t) => t.id === e.id);
+			if (!t) return _.warn("Organization switch ignored: not in the switcher list", { organizationId: e.id }), null;
+			_.info("Changing organization", { organizationId: t.id });
+			let r = t.id !== b.organizationId, i = n(x, t);
+			r && S();
+			let a = await i;
+			return C("organization", t.id, a), a;
+		},
+		onWorkspaceChange: async (e) => {
+			let t = u.find((t) => t.id === e.id);
+			if (!t) return _.warn("Workspace switch ignored: not in the switcher list", { workspaceId: e.id }), null;
+			_.info("Changing workspace", { workspaceId: t.id });
+			let n = t.id !== b.workspaceId, i = r(x, t);
+			n && S();
+			let a = await i;
+			return C("workspace", t.id, a), a;
+		},
+		onProjectChange: (e) => {
+			_.info("Changing project", { projectId: e.id });
+			let t = d.find((t) => t.id === e.id);
+			t && m(t), b.setProject(e.id);
+		}
+	};
+}
+//#endregion
+export { c as useContextSwitchController };

package/dist/chrome/index.d.ts

@@ -84,6 +84,12 @@ export type { LanguageSwitcherProps, Language } from './LanguageSwitcher';
 export type { GeographySwitcherProps } from './GeographySwitcher';
 export type { NotificationCenterProps } from './NotificationCenter';
 export type { ContextSwitcherProps, Organization, Workspace, Project, } from './ContextSwitcher';
+export { useContextSwitchController } from './contextSwitcher/useContextSwitchController';
+export type { ContextSwitchController, ContextSwitchEvent, ContextSwitchKind, UseContextSwitchControllerOptions, } from './contextSwitcher/useContextSwitchController';
+export { firstProjectOfWorkspace, switchOrganization, switchWorkspace, } from './contextSwitcher/contextSwitch';
+export type { ContextSwitchDeps, ContextSwitchOutcome, SwitchableOrganization, SwitchableProject, SwitchableWorkspace, WorkspaceSelection, } from './contextSwitcher/contextSwitch';
+export { resolveSwitchTarget, sectionLandingRule, } from './contextSwitcher/resolveSwitchTarget';
+export type { ContextSwitchRedirectRule } from './contextSwitcher/resolveSwitchTarget';
 export type { LanguagePickerSheetProps } from './LanguagePickerSheet';
 export type { ProductPickerSheetProps } from './ProductPickerSheet';
 export type { AccountSwitcherProps, Account } from './AccountSwitcher';

package/dist/chrome.js

@@ -23,26 +23,29 @@ import { NotificationCenter as D } from "./chrome/NotificationCenter.js";
 import { LanguagePickerSheet as O } from "./chrome/LanguagePickerSheet.js";
 import { ProductPickerSheet as k } from "./chrome/ProductPickerSheet.js";
 import { AccountSwitcher as A } from "./chrome/AccountSwitcher.js";
-import { AutoBreadcrumbs as j, registerBreadcrumbName as M, unregisterBreadcrumbName as N } from "./chrome/AutoBreadcrumbs.js";
-import { NavCustomizeDialog as P } from "./chrome/NavCustomizeDialog.js";
-import { PersonaSimulationPill as F, PersonaSurfaceControls as I } from "./chrome/PersonaSurfaceControls.js";
-import { ProductSideNav as L } from "./chrome/ProductSideNav.js";
-import { BrandMark as R } from "./chrome/BrandMark.js";
-import { DynamicFooter as z } from "./chrome/DynamicFooter.js";
-import { PanelTabs as B } from "./chrome/PanelTabs.js";
-import { PanelContainer as V } from "./chrome/PanelContainer.js";
-import { StatusBar as H } from "./chrome/StatusBar.js";
-import { PluginRoutes as U } from "./chrome/PluginRoutes.js";
-import { PluginSettingsPage as W } from "./chrome/PluginSettingsPage.js";
-import { PluginToolbar as G } from "./chrome/PluginToolbar.js";
-import { PluginWidgetGrid as K } from "./chrome/PluginWidgetGrid.js";
-import { PluginContextMenuTarget as q } from "./chrome/PluginContextMenuTarget.js";
-import { ThemePreferences as J } from "./chrome/ThemePreferences.js";
-import { selectMobileTabs as Y } from "./chrome/mobileTabBar/selectTabs.js";
-import { useMobileTabBarVisible as X } from "./chrome/mobileTabBar/useMobileTabBarVisible.js";
-import { MobileTabBar as Z } from "./chrome/MobileTabBar.js";
-import { NativeTopBar as Q } from "./chrome/NativeTopBar.js";
-import { SwipeNavigation as $ } from "./chrome/SwipeNavigation.js";
-import { NativePageTransition as ee } from "./chrome/NativePageTransition.js";
-import { findNavTitle as te, useNativeTopBarTitle as ne } from "./chrome/nativeTopBarTitle.js";
-export { A as AccountSwitcher, o as AppShellLayout, j as AutoBreadcrumbs, R as BrandMark, _ as Breadcrumbs, g as CommandPalette, w as ContextSwitcher, d as DEFAULT_FOOTER_COLUMNS, f as DEFAULT_SOCIAL_LINKS, z as DynamicFooter, p as Footer, l as FooterBar, T as GeographySwitcher, h as GlobalSearch, c as HeaderBar, O as LanguagePickerSheet, C as LanguageSwitcher, Z as MobileTabBar, t as NAV_MORE_ID_PREFIX, ee as NativePageTransition, Q as NativeTopBar, P as NavCustomizeDialog, v as NavLink, D as NotificationCenter, s as PageHeader, V as PanelContainer, B as PanelTabs, F as PersonaSimulationPill, I as PersonaSurfaceControls, q as PluginContextMenuTarget, u as PluginFooterStrip, U as PluginRoutes, W as PluginSettingsPage, G as PluginToolbar, K as PluginWidgetGrid, k as ProductPickerSheet, L as ProductSideNav, S as ProductSwitcher, x as ProfileSwitcher, E as PushOptInToggle, e as ShortcutHelpDialog, m as SideNavigation, b as Sidebar, H as StatusBar, $ as SwipeNavigation, y as Tabs, J as ThemePreferences, n as applyNavVisibility, r as applyPermissionFilter, i as applySurfaceVisibility, te as findNavTitle, a as isItemEffectivelyShown, M as registerBreadcrumbName, Y as selectMobileTabs, N as unregisterBreadcrumbName, X as useMobileTabBarVisible, ne as useNativeTopBarTitle };
+import { firstProjectOfWorkspace as j, switchOrganization as M, switchWorkspace as N } from "./chrome/contextSwitcher/contextSwitch.js";
+import { resolveSwitchTarget as P, sectionLandingRule as F } from "./chrome/contextSwitcher/resolveSwitchTarget.js";
+import { useContextSwitchController as I } from "./chrome/contextSwitcher/useContextSwitchController.js";
+import { AutoBreadcrumbs as L, registerBreadcrumbName as R, unregisterBreadcrumbName as z } from "./chrome/AutoBreadcrumbs.js";
+import { NavCustomizeDialog as B } from "./chrome/NavCustomizeDialog.js";
+import { PersonaSimulationPill as V, PersonaSurfaceControls as H } from "./chrome/PersonaSurfaceControls.js";
+import { ProductSideNav as U } from "./chrome/ProductSideNav.js";
+import { BrandMark as W } from "./chrome/BrandMark.js";
+import { DynamicFooter as G } from "./chrome/DynamicFooter.js";
+import { PanelTabs as K } from "./chrome/PanelTabs.js";
+import { PanelContainer as q } from "./chrome/PanelContainer.js";
+import { StatusBar as J } from "./chrome/StatusBar.js";
+import { PluginRoutes as Y } from "./chrome/PluginRoutes.js";
+import { PluginSettingsPage as X } from "./chrome/PluginSettingsPage.js";
+import { PluginToolbar as Z } from "./chrome/PluginToolbar.js";
+import { PluginWidgetGrid as Q } from "./chrome/PluginWidgetGrid.js";
+import { PluginContextMenuTarget as $ } from "./chrome/PluginContextMenuTarget.js";
+import { ThemePreferences as ee } from "./chrome/ThemePreferences.js";
+import { selectMobileTabs as te } from "./chrome/mobileTabBar/selectTabs.js";
+import { useMobileTabBarVisible as ne } from "./chrome/mobileTabBar/useMobileTabBarVisible.js";
+import { MobileTabBar as re } from "./chrome/MobileTabBar.js";
+import { NativeTopBar as ie } from "./chrome/NativeTopBar.js";
+import { SwipeNavigation as ae } from "./chrome/SwipeNavigation.js";
+import { NativePageTransition as oe } from "./chrome/NativePageTransition.js";
+import { findNavTitle as se, useNativeTopBarTitle as ce } from "./chrome/nativeTopBarTitle.js";
+export { A as AccountSwitcher, o as AppShellLayout, L as AutoBreadcrumbs, W as BrandMark, _ as Breadcrumbs, g as CommandPalette, w as ContextSwitcher, d as DEFAULT_FOOTER_COLUMNS, f as DEFAULT_SOCIAL_LINKS, G as DynamicFooter, p as Footer, l as FooterBar, T as GeographySwitcher, h as GlobalSearch, c as HeaderBar, O as LanguagePickerSheet, C as LanguageSwitcher, re as MobileTabBar, t as NAV_MORE_ID_PREFIX, oe as NativePageTransition, ie as NativeTopBar, B as NavCustomizeDialog, v as NavLink, D as NotificationCenter, s as PageHeader, q as PanelContainer, K as PanelTabs, V as PersonaSimulationPill, H as PersonaSurfaceControls, $ as PluginContextMenuTarget, u as PluginFooterStrip, Y as PluginRoutes, X as PluginSettingsPage, Z as PluginToolbar, Q as PluginWidgetGrid, k as ProductPickerSheet, U as ProductSideNav, S as ProductSwitcher, x as ProfileSwitcher, E as PushOptInToggle, e as ShortcutHelpDialog, m as SideNavigation, b as Sidebar, J as StatusBar, ae as SwipeNavigation, y as Tabs, ee as ThemePreferences, n as applyNavVisibility, r as applyPermissionFilter, i as applySurfaceVisibility, se as findNavTitle, j as firstProjectOfWorkspace, a as isItemEffectivelyShown, R as registerBreadcrumbName, P as resolveSwitchTarget, F as sectionLandingRule, te as selectMobileTabs, M as switchOrganization, N as switchWorkspace, z as unregisterBreadcrumbName, I as useContextSwitchController, ne as useMobileTabBarVisible, ce as useNativeTopBarTitle };

package/package.json

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