@burdenoff/fe-libs 2026.1021.2 → 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/dist/shell-native/boot.js

@@ -8,18 +8,18 @@ import { installNativeAuthNavigationIntercept as f } from "./auth-navigation.js"
 import { createDefaultBackButtonHandlers as p, installBackButtonHandler as m } from "./back-button.js";
 import { installExternalUrlOpener as h } from "./browser.js";
 import { installNativeBridge as g } from "./bridge.js";
-import { installDeepLinkHandler as _ } from "./deep-link.js";
-import { populateDeviceInfo as v } from "./device.js";
-import { configureKeyboard as y } from "./keyboard.js";
-import { installNetworkListener as b } from "./network.js";
-import { notifyOtaReady as x } from "./ota.js";
-import { installPushNotifications as S } from "./push.js";
-import { installPushOptIn as C } from "./push-optin.js";
-import { installPwa as w } from "./pwa.js";
-import { armSplashSafetyTimer as T, markAppReady as E } from "./splash.js";
-import { installStatusBarThemeListener as D } from "./system-bars.js";
+import { armDeepLinkFallback as _, disarmDeepLinkFallback as v, installDeepLinkHandler as y } from "./deep-link.js";
+import { populateDeviceInfo as b } from "./device.js";
+import { configureKeyboard as x } from "./keyboard.js";
+import { installNetworkListener as S } from "./network.js";
+import { notifyOtaReady as C } from "./ota.js";
+import { installPushNotifications as w } from "./push.js";
+import { installPushOptIn as T } from "./push-optin.js";
+import { installPwa as E } from "./pwa.js";
+import { armSplashSafetyTimer as D, markAppReady as O } from "./splash.js";
+import { installStatusBarThemeListener as k } from "./system-bars.js";
 //#region src/shell-native/boot.ts
-function O(e, t) {
+function A(e, t) {
 	try {
 		let n = t();
 		n instanceof Promise && n.catch((t) => {
@@ -29,38 +29,40 @@ function O(e, t) {
 		console.debug(`[shell-native] boot step "${e}" failed:`, t);
 	}
 }
-function k() {
+function j() {
 	if (typeof document > "u") return;
 	let e = document.querySelector("meta[name=\"viewport\"]");
 	if (!e) return;
 	let t = (e.content || "").split(",").map((e) => e.trim()).filter((e) => e.length > 0 && !e.startsWith("maximum-scale") && !e.startsWith("user-scalable") && !e.startsWith("interactive-widget"));
 	t.push("maximum-scale=1", "user-scalable=no"), o() === "android" && t.push("interactive-widget=resizes-content"), e.content = t.join(", ");
 }
-var A = null;
-function j(j) {
-	if (A) return A;
-	if (d(j.electronGlobalKey ?? `${j.product}Electron`), j.preview?.allow !== !1 && O("preview", () => n(i())), O("notifyOtaReady", () => x(j.plugins ?? {})), O("authIntercept", () => f(j.authIntercept)), O("externalUrlOpener", () => h()), O("nativeBridge", () => {
+var M = null;
+function N(v) {
+	if (M) return M;
+	d(v.electronGlobalKey ?? `${v.product}Electron`), v.preview?.allow !== !1 && A("preview", () => n(i())), A("notifyOtaReady", () => C(v.plugins ?? {})), A("authIntercept", () => f(v.authIntercept)), A("externalUrlOpener", () => h()), A("nativeBridge", () => {
 		g(), a();
-	}), O("deviceInfo", () => v()), O("statusBarTheme", () => D()), O("keyboard", () => y()), O("backButton", () => m({
-		...p(j.appName),
-		...j.backButton
-	})), O("deepLinks", () => _()), O("network", () => b(j.network ?? {})), O("runtimeHooks", () => u(j.runtimeHooks ?? {})), j.push?.enabled && j.plugins?.pushNotifications) {
-		let e = j.plugins.pushNotifications, t = j.plugins.localNotifications;
-		O("push", () => S(e, j.push ?? {}, t));
+	}), A("deviceInfo", () => b()), A("statusBarTheme", () => k()), A("keyboard", () => x()), A("backButton", () => m({
+		...p(v.appName),
+		...v.backButton
+	})), A("deepLinks", () => y());
+	let N = v.deepLinks?.fallbackDelayMs;
+	if (N !== !1 && A("deepLinkFallback", () => _(N ?? 4e3)), A("network", () => S(v.network ?? {})), A("runtimeHooks", () => u(v.runtimeHooks ?? {})), v.push?.enabled && v.plugins?.pushNotifications) {
+		let e = v.plugins.pushNotifications, t = v.plugins.localNotifications;
+		A("push", () => w(e, v.push ?? {}, t));
 	}
-	return l() && j.splash?.autoHide !== !1 && O("splashSafetyTimer", () => T(j.splash?.maxWaitMs ?? 8e3)), O("pwa", () => w({
+	return l() && v.splash?.autoHide !== !1 && A("splashSafetyTimer", () => D(v.splash?.maxWaitMs ?? 8e3)), A("pwa", () => E({
 		enabled: !0,
-		...j.pwa
-	})), O("pushOptIn", () => C()), t() && O("desktopShell", () => e(j.desktop)), s() && O("viewport", () => k()), A = {
+		...v.pwa
+	})), A("pushOptIn", () => T()), t() && A("desktopShell", () => e(v.desktop)), s() && A("viewport", () => j()), M = {
 		platform: o(),
 		isNative: s(),
 		isPreview: c(),
 		previewMode: r(),
-		markAppReady: E
-	}, A;
+		markAppReady: O
+	}, M;
 }
-function M() {
-	A = null;
+function P() {
+	M = null, v();
 }
 //#endregion
-export { j as bootNativeShell, M as resetNativeShellBootForTests };
+export { N as bootNativeShell, P as resetNativeShellBootForTests };

package/dist/shell-native/deep-link-context.d.ts

@@ -0,0 +1,44 @@
+import { ActiveContextUrlParams } from '../shared/providers/shell/ActiveContextStorage';
+import { DeepLinkNavigator } from './deep-link';
+/** The `setContext` payload of `ActiveContextProvider` (`useActiveContext().setContext`). */
+export type DeepLinkContextUpdate = Partial<{
+    organizationId: string | null;
+    workspaceId: string | null;
+    projectId: string | null;
+    tenantId: string | null;
+}>;
+/**
+ * Ids a deep link may set as active context: a UUID or a cuid. Anything else is
+ * ignored so a crafted link cannot plant junk in the stored context.
+ */
+export declare const DEEP_LINK_CONTEXT_ID_PATTERN: RegExp;
+export interface DeepLinkContextOptions {
+    /** Query param names; defaults to `?org=&workspace=&project=&tenant=`. */
+    urlParams?: ActiveContextUrlParams;
+}
+/**
+ * Read the active-context ids a deep-link path carries. `path` is
+ * `pathname + search + hash`; the `#fragment` is ignored. Returns `null` when
+ * the link names no (valid) context.
+ *
+ * A link that names an organization or workspace but no project clears the
+ * project, so a project from the previous workspace cannot drive
+ * workspace-token issuance.
+ */
+export declare function parseDeepLinkContext(path: string, options?: DeepLinkContextOptions): DeepLinkContextUpdate | null;
+export interface DeepLinkNavigatorOptions extends DeepLinkContextOptions {
+    /**
+     * Commit the link's context before navigating — pass
+     * `useActiveContext().setContext`. A deep link arrives through `navigate()`
+     * (no reload, no `popstate`), so `ActiveContextProvider` would otherwise never
+     * see its `?org/workspace/project/tenant`.
+     */
+    setContext?: (context: DeepLinkContextUpdate) => void;
+}
+/**
+ * Build the navigator `registerDeepLinkNavigator` expects: it drops paths that
+ * are not same-origin in-app paths, commits the link's context once, then
+ * navigates. This is action-driven (it only runs for an actual deep link or
+ * push tap), so it cannot set up a URL ↔ context write-back loop.
+ */
+export declare function createDeepLinkNavigator(navigate: (path: string) => void, options?: DeepLinkNavigatorOptions): DeepLinkNavigator;

package/dist/shell-native/deep-link-context.js

@@ -0,0 +1,31 @@
+import { DEFAULT_ACTIVE_CONTEXT_URL_PARAMS as e } from "../shared/providers/shell/ActiveContextStorage.js";
+import { isSafeInAppPath as t } from "./deep-link.js";
+//#region src/shell-native/deep-link-context.ts
+var n = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|c[a-z0-9]{8,32})$/i;
+function r(t, r = {}) {
+	let i = t.indexOf("?");
+	if (i === -1) return null;
+	let a = t.indexOf("#", i), o = a === -1 ? t.slice(i) : t.slice(i, a), s = new URLSearchParams(o), c = {
+		...e,
+		...r.urlParams
+	}, l = (e) => {
+		let t = s.get(e);
+		return t && n.test(t) ? t : null;
+	}, u = l(c.organization), d = l(c.workspace), f = l(c.project), p = l(c.tenant), m = {};
+	return u && (m.organizationId = u), d && (m.workspaceId = d), f ? m.projectId = f : (u || d) && (m.projectId = null), p && (m.tenantId = p), Object.keys(m).length > 0 ? m : null;
+}
+function i(e, n = {}) {
+	return (i) => {
+		if (!t(i)) {
+			console.debug("[shell-native] ignored a deep link that is not an in-app path");
+			return;
+		}
+		if (n.setContext) {
+			let e = r(i, n);
+			e && n.setContext(e);
+		}
+		e(i);
+	};
+}
+//#endregion
+export { n as DEEP_LINK_CONTEXT_ID_PATTERN, i as createDeepLinkNavigator, r as parseDeepLinkContext };

package/dist/shell-native/deep-link.d.ts

@@ -1,4 +1,16 @@
-type DeepLinkNavigator = (path: string) => void;
+export type DeepLinkNavigator = (path: string) => void;
+/**
+ * How long `bootNativeShell` waits for a router to call
+ * `registerDeepLinkNavigator` before it drains queued deep links itself
+ * through `history.pushState` + `popstate` (see `armDeepLinkFallback`).
+ */
+export declare const DEFAULT_DEEP_LINK_FALLBACK_DELAY_MS = 4000;
+/**
+ * True for a same-origin, in-app path: `/x`, `/x?y#z`. Refuses protocol-relative
+ * (`//host`, `/\host`) and anything that is not a rooted path, so a deep link or
+ * push payload can never steer the webview to another origin.
+ */
+export declare function isSafeInAppPath(path: string): boolean;
 /**
  * Map a deep-link URL to an in-app SPA path. Handles both
  * `scheme://app/path?x` (custom scheme; host is the synthetic `app`) and
@@ -9,10 +21,25 @@ export declare function deepLinkUrlToPath(rawUrl: string): string | null;
 export declare function installDeepLinkHandler(): Promise<void>;
 /**
  * Register the router's navigate function. Links that arrived before the router
- * mounted are queued and flushed here.
+ * mounted are queued and flushed here. Returns a disposer that unregisters this
+ * navigator only if it is still the active one (a newer registration wins).
+ *
+ * Prefer `useDeepLinkNavigator` in React shells — it also hydrates the active
+ * context from the link's `?org/workspace/project/tenant`.
  */
-export declare function registerDeepLinkNavigator(navigate: DeepLinkNavigator): void;
+export declare function registerDeepLinkNavigator(navigate: DeepLinkNavigator): () => void;
 export declare function clearDeepLinkNavigator(): void;
 /** Route a path through the active navigator (or queue it) — used by push taps. */
 export declare function navigateDeepLinkPath(path: string): void;
-export {};
+/**
+ * Safety net for shells whose router never registers a navigator: once
+ * `delayMs` has passed without a registration, queued links (and every later
+ * link while no navigator is registered) navigate through `history.pushState`
+ * + `popstate`. A navigator registered later always takes precedence. Calling
+ * it again re-arms with the new delay; `bootNativeShell` arms it.
+ */
+export declare function armDeepLinkFallback(delayMs?: number): void;
+/** Cancel the fallback timer and leave router-less navigation off. */
+export declare function disarmDeepLinkFallback(): void;
+/** Test-only: drop the queue, the navigator and the fallback. */
+export declare function resetDeepLinksForTests(): void;

package/dist/shell-native/deep-link.js

@@ -3,14 +3,35 @@ import { isNativePluginAvailable as t } from "./platform.js";
 import { getLegacyElectronBridge as n } from "./desktop-bridge.js";
 import { App as r } from "@capacitor/app";
 //#region src/shell-native/deep-link.ts
-var i = [], a = null;
-function o() {
-	if (!a || i.length === 0) return;
-	let e = i;
-	i = [];
-	for (let t of e) a(t);
-}
-function s(e) {
+var i = 4e3, a = [], o = null, s = null, c = !1;
+function l(e) {
+	if (typeof e != "string" || !e.startsWith("/") || e.startsWith("//") || e.startsWith("/\\")) return !1;
+	for (let t = 0; t < e.length; t += 1) {
+		let n = e.charCodeAt(t);
+		if (n < 32 || n === 127) return !1;
+	}
+	return !0;
+}
+function u(e) {
+	if (l(e) && !(typeof window > "u")) try {
+		window.history.pushState(null, "", e);
+		let t = typeof PopStateEvent == "function" ? new PopStateEvent("popstate", { state: null }) : new Event("popstate");
+		window.dispatchEvent(t);
+	} catch (e) {
+		console.debug("[shell-native] deep-link fallback navigation failed:", e);
+	}
+}
+function d() {
+	return o || (c ? u : null);
+}
+function f() {
+	let e = d();
+	if (!e || a.length === 0) return;
+	let t = a;
+	a = [];
+	for (let n of t) e(n);
+}
+function p(e) {
 	let t;
 	try {
 		t = new URL(e);
@@ -19,35 +40,49 @@ function s(e) {
 	}
 	return `${t.pathname || "/"}${t.search}${t.hash}`;
 }
-function c(e) {
-	let t = s(e);
-	t !== null && (a ? a(t) : i.push(t));
+function m(e) {
+	let t = p(e);
+	t !== null && b(t);
 }
-async function l() {
+async function h() {
 	if (t("App")) try {
-		await r.addListener("appUrlOpen", (e) => c(e.url));
+		await r.addListener("appUrlOpen", (e) => m(e.url));
 	} catch {}
 }
-function u() {
+function g() {
 	let t = e();
 	if (t && typeof t.onDeepLink == "function") {
-		t.onDeepLink((e) => c(e));
+		t.onDeepLink((e) => m(e));
 		return;
 	}
 	let r = n();
-	r && typeof r.onDeepLink == "function" && r.onDeepLink((e) => c(e));
+	r && typeof r.onDeepLink == "function" && r.onDeepLink((e) => m(e));
 }
-async function d() {
-	u(), await l();
+async function _() {
+	g(), await h();
 }
-function f(e) {
-	a = e, o();
+function v(e) {
+	return o = e, f(), () => {
+		o === e && (o = null);
+	};
 }
-function p() {
-	a = null;
+function y() {
+	o = null;
 }
-function m(e) {
-	a ? a(e) : i.push(e);
+function b(e) {
+	let t = d();
+	t ? t(e) : a.push(e);
+}
+function x(e = i) {
+	S(), s = setTimeout(() => {
+		s = null, c = !0, !o && a.length > 0 && console.debug("[shell-native] no deep-link navigator registered; routing queued links via history"), f();
+	}, Number.isFinite(e) && e > 0 ? e : 0);
+}
+function S() {
+	s !== null && clearTimeout(s), s = null, c = !1;
+}
+function C() {
+	S(), a = [], o = null;
 }
 //#endregion
-export { p as clearDeepLinkNavigator, s as deepLinkUrlToPath, d as installDeepLinkHandler, m as navigateDeepLinkPath, f as registerDeepLinkNavigator };
+export { i as DEFAULT_DEEP_LINK_FALLBACK_DELAY_MS, x as armDeepLinkFallback, y as clearDeepLinkNavigator, p as deepLinkUrlToPath, S as disarmDeepLinkFallback, _ as installDeepLinkHandler, l as isSafeInAppPath, b as navigateDeepLinkPath, v as registerDeepLinkNavigator, C as resetDeepLinksForTests };

package/dist/shell-native/index.d.ts

@@ -27,7 +27,9 @@
  */
 export { bootNativeShell, resetNativeShellBootForTests } from './boot';
 export { APP_READY_EVENT, armSplashSafetyTimer, isAppReady, markAppReady, resetAppReadyForTests, } from './splash';
-export { clearDeepLinkNavigator, deepLinkUrlToPath, installDeepLinkHandler, navigateDeepLinkPath, registerDeepLinkNavigator, } from './deep-link';
+export { armDeepLinkFallback, clearDeepLinkNavigator, DEFAULT_DEEP_LINK_FALLBACK_DELAY_MS, deepLinkUrlToPath, disarmDeepLinkFallback, installDeepLinkHandler, isSafeInAppPath, navigateDeepLinkPath, registerDeepLinkNavigator, resetDeepLinksForTests, type DeepLinkNavigator, } from './deep-link';
+export { createDeepLinkNavigator, DEEP_LINK_CONTEXT_ID_PATTERN, parseDeepLinkContext, type DeepLinkContextOptions, type DeepLinkContextUpdate, type DeepLinkNavigatorOptions, } from './deep-link-context';
+export { useDeepLinkNavigator } from './useDeepLinkNavigator';
 export { installNativeBridge } from './bridge';
 export { applyNativePlatformClass, getNativePlatform, isNativePlatform, isNativePluginAvailable, isNativePreview, isRealNativePlatform, } from './platform';
 export { applyNativePreview, getActiveNativePreview, resolveNativePreview, NATIVE_PREVIEW_QUERY_PARAM, NATIVE_PREVIEW_STORAGE_KEY, } from './preview';

package/dist/shell-native/types.d.ts

@@ -318,6 +318,15 @@ export interface BootNativeShellOptions {
     desktop?: {
         navigate?: (path: string) => void;
     };
+    /**
+     * Deep-link queue. Links queue until the router registers a navigator
+     * (`useDeepLinkNavigator`). If none registers within `fallbackDelayMs`
+     * (default 4000), queued and later links navigate through
+     * `history.pushState` + `popstate` instead. `false` disables the fallback.
+     */
+    deepLinks?: {
+        fallbackDelayMs?: number | false;
+    };
 }
 export interface NativeShellHandle {
     platform: NativeShellPlatform;

package/dist/shell-native/useDeepLinkNavigator.d.ts

@@ -0,0 +1,18 @@
+import { DeepLinkNavigatorOptions } from './deep-link-context';
+/**
+ * Bind the native deep-link queue (Capacitor `appUrlOpen`, the desktop
+ * bridge's `onDeepLink`, native and web push taps) to the shell's router.
+ * Mount it ONCE, inside the router and inside `ActiveContextProvider`:
+ *
+ * ```tsx
+ * const navigate = useNavigate();
+ * const { setContext } = useActiveContext();
+ * useDeepLinkNavigator(navigate, { setContext });
+ * ```
+ *
+ * Links that arrived before mount (cold-start OAuth callbacks, the push tap
+ * that launched the app) are flushed on mount. The latest `navigate` and
+ * options are always used, so callers need not memoise them. On unmount the
+ * navigator is unregistered unless a newer registration replaced it.
+ */
+export declare function useDeepLinkNavigator(navigate: (path: string) => void, options?: DeepLinkNavigatorOptions): void;

package/dist/shell-native/useDeepLinkNavigator.js

@@ -0,0 +1,19 @@
+import { registerDeepLinkNavigator as e } from "./deep-link.js";
+import { createDeepLinkNavigator as t } from "./deep-link-context.js";
+import { useEffect as n, useRef as r } from "react";
+//#region src/shell-native/useDeepLinkNavigator.ts
+function i(i, a = {}) {
+	let o = r(i), s = r(a);
+	n(() => {
+		o.current = i, s.current = a;
+	}), n(() => e(t((e) => o.current(e), {
+		get urlParams() {
+			return s.current.urlParams;
+		},
+		get setContext() {
+			return s.current.setContext;
+		}
+	})), []);
+}
+//#endregion
+export { i as useDeepLinkNavigator };

package/dist/shell-native.js

@@ -13,19 +13,21 @@ import { impactFeedback as D, notificationFeedback as O, selectionFeedback as k
 import { showNativeToast as A } from "./shell-native/toast.js";
 import { shareContent as j } from "./shell-native/share.js";
 import { installNativeBridge as M } from "./shell-native/bridge.js";
-import { clearDeepLinkNavigator as N, deepLinkUrlToPath as P, installDeepLinkHandler as F, navigateDeepLinkPath as I, registerDeepLinkNavigator as L } from "./shell-native/deep-link.js";
-import { populateDeviceInfo as R } from "./shell-native/device.js";
-import { KEYBOARD_HEIGHT_CSS_VAR as z, KEYBOARD_OPEN_CLASS as B, configureKeyboard as V, keyboardHandlers as H } from "./shell-native/keyboard.js";
-import { NETWORK_STATUS_EVENT as U, getLastNetworkStatus as W, installNetworkListener as G } from "./shell-native/network.js";
-import { notifyOtaReady as K } from "./shell-native/ota.js";
-import { PUSH_TOKEN_EVENT as q, emitPushToken as J, installPushNotifications as Y, requestPushPermission as X } from "./shell-native/push.js";
-import { SW_NOTIFICATION_CLICK_MESSAGE as Z, SW_PUSH_SUBSCRIPTION_CHANGE_MESSAGE as Q, WEB_PUSH_MANIFEST_KEY as $, getWebPushManifestConfig as ee, getWebPushSubscription as te, installWebPushMessageBridge as ne, isWebPushSupported as re, requestWebPushPermission as ie, resetWebPushForTests as ae, resolveVapidPublicKey as oe, serializeWebPushSubscription as se, subscribeWebPush as ce, unsubscribeWebPush as le, urlBase64ToUint8Array as ue } from "./shell-native/web-push.js";
-import { installPushOptIn as de, resetPushOptInForTests as fe } from "./shell-native/push-optin.js";
-import { PWA_INSTALLED_EVENT as pe, PWA_INSTALL_AVAILABLE_EVENT as me, PWA_UPDATE_READY_EVENT as he, installPwa as ge, installPwaPrompt as _e, isPwaEligibleHost as ve, resetPwaForTests as ye } from "./shell-native/pwa.js";
-import { APP_READY_EVENT as be, armSplashSafetyTimer as xe, isAppReady as Se, markAppReady as Ce, resetAppReadyForTests as we } from "./shell-native/splash.js";
-import { DARK_FAMILY_THEMES as Te, applyStatusBarTheme as Ee, installStatusBarThemeListener as De, isDarkThemeName as Oe, resolveDocumentIsDark as ke, statusBarDetailIsDark as Ae } from "./shell-native/system-bars.js";
-import { bootNativeShell as je, resetNativeShellBootForTests as Me } from "./shell-native/boot.js";
-import { defineCapacitorConfig as Ne, isValidAllowNavigationRule as Pe } from "./shell-native/capacitor-config.js";
-import { defineWebManifest as Fe } from "./shell-native/web-manifest.js";
-import { SERVICE_WORKER_TEMPLATE as Ie, renderServiceWorker as Le } from "./shell-native/service-worker.js";
-export { be as APP_READY_EVENT, Te as DARK_FAMILY_THEMES, _ as DEFAULT_AUTH_INTERCEPT_PREFIXES, z as KEYBOARD_HEIGHT_CSS_VAR, B as KEYBOARD_OPEN_CLASS, t as NATIVE_PREVIEW_QUERY_PARAM, n as NATIVE_PREVIEW_STORAGE_KEY, U as NETWORK_STATUS_EVENT, q as PUSH_TOKEN_EVENT, pe as PWA_INSTALLED_EVENT, me as PWA_INSTALL_AVAILABLE_EVENT, he as PWA_UPDATE_READY_EVENT, Ie as SERVICE_WORKER_TEMPLATE, Z as SW_NOTIFICATION_CLICK_MESSAGE, Q as SW_PUSH_SUBSCRIPTION_CHANGE_MESSAGE, $ as WEB_PUSH_MANIFEST_KEY, o as applyNativePlatformClass, r as applyNativePreview, Ee as applyStatusBarTheme, xe as armSplashSafetyTimer, je as bootNativeShell, N as clearDeepLinkNavigator, p as configureElectronGlobalKey, V as configureKeyboard, b as createDefaultBackButtonHandlers, P as deepLinkUrlToPath, Ne as defineCapacitorConfig, Fe as defineWebManifest, J as emitPushToken, i as getActiveNativePreview, e as getDesktopBridge, m as getElectronGlobalKey, W as getLastNetworkStatus, h as getLegacyElectronBridge, s as getNativePlatform, ee as getWebPushManifestConfig, te as getWebPushSubscription, D as impactFeedback, x as installBackButtonHandler, F as installDeepLinkHandler, w as installExternalUrlOpener, f as installMobileRuntimeHooks, v as installNativeAuthNavigationIntercept, M as installNativeBridge, G as installNetworkListener, Y as installPushNotifications, de as installPushOptIn, ge as installPwa, _e as installPwaPrompt, De as installStatusBarThemeListener, ne as installWebPushMessageBridge, Se as isAppReady, Oe as isDarkThemeName, g as isDesktopShell, c as isNativePlatform, l as isNativePluginAvailable, u as isNativePreview, ve as isPwaEligibleHost, d as isRealNativePlatform, Pe as isValidAllowNavigationRule, re as isWebPushSupported, H as keyboardHandlers, Ce as markAppReady, I as navigateDeepLinkPath, O as notificationFeedback, K as notifyOtaReady, T as openExternalUrl, R as populateDeviceInfo, L as registerDeepLinkNavigator, Le as renderServiceWorker, X as requestPushPermission, ie as requestWebPushPermission, we as resetAppReadyForTests, Me as resetNativeShellBootForTests, fe as resetPushOptInForTests, ye as resetPwaForTests, ae as resetWebPushForTests, ke as resolveDocumentIsDark, a as resolveNativePreview, oe as resolveVapidPublicKey, S as runBackButtonPrecedence, k as selectionFeedback, se as serializeWebPushSubscription, j as shareContent, C as showNativeActionSheet, y as showNativeConfirm, A as showNativeToast, Ae as statusBarDetailIsDark, ce as subscribeWebPush, le as unsubscribeWebPush, ue as urlBase64ToUint8Array, E as writeClipboardText };
+import { DEFAULT_DEEP_LINK_FALLBACK_DELAY_MS as N, armDeepLinkFallback as P, clearDeepLinkNavigator as F, deepLinkUrlToPath as I, disarmDeepLinkFallback as L, installDeepLinkHandler as R, isSafeInAppPath as z, navigateDeepLinkPath as B, registerDeepLinkNavigator as V, resetDeepLinksForTests as H } from "./shell-native/deep-link.js";
+import { populateDeviceInfo as U } from "./shell-native/device.js";
+import { KEYBOARD_HEIGHT_CSS_VAR as W, KEYBOARD_OPEN_CLASS as G, configureKeyboard as K, keyboardHandlers as q } from "./shell-native/keyboard.js";
+import { NETWORK_STATUS_EVENT as J, getLastNetworkStatus as Y, installNetworkListener as X } from "./shell-native/network.js";
+import { notifyOtaReady as Z } from "./shell-native/ota.js";
+import { PUSH_TOKEN_EVENT as Q, emitPushToken as $, installPushNotifications as ee, requestPushPermission as te } from "./shell-native/push.js";
+import { SW_NOTIFICATION_CLICK_MESSAGE as ne, SW_PUSH_SUBSCRIPTION_CHANGE_MESSAGE as re, WEB_PUSH_MANIFEST_KEY as ie, getWebPushManifestConfig as ae, getWebPushSubscription as oe, installWebPushMessageBridge as se, isWebPushSupported as ce, requestWebPushPermission as le, resetWebPushForTests as ue, resolveVapidPublicKey as de, serializeWebPushSubscription as fe, subscribeWebPush as pe, unsubscribeWebPush as me, urlBase64ToUint8Array as he } from "./shell-native/web-push.js";
+import { installPushOptIn as ge, resetPushOptInForTests as _e } from "./shell-native/push-optin.js";
+import { PWA_INSTALLED_EVENT as ve, PWA_INSTALL_AVAILABLE_EVENT as ye, PWA_UPDATE_READY_EVENT as be, installPwa as xe, installPwaPrompt as Se, isPwaEligibleHost as Ce, resetPwaForTests as we } from "./shell-native/pwa.js";
+import { APP_READY_EVENT as Te, armSplashSafetyTimer as Ee, isAppReady as De, markAppReady as Oe, resetAppReadyForTests as ke } from "./shell-native/splash.js";
+import { DARK_FAMILY_THEMES as Ae, applyStatusBarTheme as je, installStatusBarThemeListener as Me, isDarkThemeName as Ne, resolveDocumentIsDark as Pe, statusBarDetailIsDark as Fe } from "./shell-native/system-bars.js";
+import { bootNativeShell as Ie, resetNativeShellBootForTests as Le } from "./shell-native/boot.js";
+import { DEEP_LINK_CONTEXT_ID_PATTERN as Re, createDeepLinkNavigator as ze, parseDeepLinkContext as Be } from "./shell-native/deep-link-context.js";
+import { useDeepLinkNavigator as Ve } from "./shell-native/useDeepLinkNavigator.js";
+import { defineCapacitorConfig as He, isValidAllowNavigationRule as Ue } from "./shell-native/capacitor-config.js";
+import { defineWebManifest as We } from "./shell-native/web-manifest.js";
+import { SERVICE_WORKER_TEMPLATE as Ge, renderServiceWorker as Ke } from "./shell-native/service-worker.js";
+export { Te as APP_READY_EVENT, Ae as DARK_FAMILY_THEMES, Re as DEEP_LINK_CONTEXT_ID_PATTERN, _ as DEFAULT_AUTH_INTERCEPT_PREFIXES, N as DEFAULT_DEEP_LINK_FALLBACK_DELAY_MS, W as KEYBOARD_HEIGHT_CSS_VAR, G as KEYBOARD_OPEN_CLASS, t as NATIVE_PREVIEW_QUERY_PARAM, n as NATIVE_PREVIEW_STORAGE_KEY, J as NETWORK_STATUS_EVENT, Q as PUSH_TOKEN_EVENT, ve as PWA_INSTALLED_EVENT, ye as PWA_INSTALL_AVAILABLE_EVENT, be as PWA_UPDATE_READY_EVENT, Ge as SERVICE_WORKER_TEMPLATE, ne as SW_NOTIFICATION_CLICK_MESSAGE, re as SW_PUSH_SUBSCRIPTION_CHANGE_MESSAGE, ie as WEB_PUSH_MANIFEST_KEY, o as applyNativePlatformClass, r as applyNativePreview, je as applyStatusBarTheme, P as armDeepLinkFallback, Ee as armSplashSafetyTimer, Ie as bootNativeShell, F as clearDeepLinkNavigator, p as configureElectronGlobalKey, K as configureKeyboard, ze as createDeepLinkNavigator, b as createDefaultBackButtonHandlers, I as deepLinkUrlToPath, He as defineCapacitorConfig, We as defineWebManifest, L as disarmDeepLinkFallback, $ as emitPushToken, i as getActiveNativePreview, e as getDesktopBridge, m as getElectronGlobalKey, Y as getLastNetworkStatus, h as getLegacyElectronBridge, s as getNativePlatform, ae as getWebPushManifestConfig, oe as getWebPushSubscription, D as impactFeedback, x as installBackButtonHandler, R as installDeepLinkHandler, w as installExternalUrlOpener, f as installMobileRuntimeHooks, v as installNativeAuthNavigationIntercept, M as installNativeBridge, X as installNetworkListener, ee as installPushNotifications, ge as installPushOptIn, xe as installPwa, Se as installPwaPrompt, Me as installStatusBarThemeListener, se as installWebPushMessageBridge, De as isAppReady, Ne as isDarkThemeName, g as isDesktopShell, c as isNativePlatform, l as isNativePluginAvailable, u as isNativePreview, Ce as isPwaEligibleHost, d as isRealNativePlatform, z as isSafeInAppPath, Ue as isValidAllowNavigationRule, ce as isWebPushSupported, q as keyboardHandlers, Oe as markAppReady, B as navigateDeepLinkPath, O as notificationFeedback, Z as notifyOtaReady, T as openExternalUrl, Be as parseDeepLinkContext, U as populateDeviceInfo, V as registerDeepLinkNavigator, Ke as renderServiceWorker, te as requestPushPermission, le as requestWebPushPermission, ke as resetAppReadyForTests, H as resetDeepLinksForTests, Le as resetNativeShellBootForTests, _e as resetPushOptInForTests, we as resetPwaForTests, ue as resetWebPushForTests, Pe as resolveDocumentIsDark, a as resolveNativePreview, de as resolveVapidPublicKey, S as runBackButtonPrecedence, k as selectionFeedback, fe as serializeWebPushSubscription, j as shareContent, C as showNativeActionSheet, y as showNativeConfirm, A as showNativeToast, Fe as statusBarDetailIsDark, pe as subscribeWebPush, me as unsubscribeWebPush, he as urlBase64ToUint8Array, Ve as useDeepLinkNavigator, E as writeClipboardText };

package/package.json

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