@burdenoff/fe-libs 2026.819.5 → 2026.823.2

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

@@ -0,0 +1,54 @@
+/**
+ * `@burdenoff/fe-libs/shell-native` — the shell-side native runtime.
+ *
+ * APP SHELLS ONLY. Microfrontends must never import this entry point: they talk
+ * to the shell through `window.__burdenoffNativeBridge`
+ * (`@burdenoff/fe-libs/shared/native`). Nothing here is re-exported from the
+ * `shared/native` barrel by design.
+ *
+ * Typical wiring (`main.tsx`, before React mounts):
+ * ```ts
+ * import { bootNativeShell } from '@burdenoff/fe-libs/shell-native';
+ *
+ * const shell = bootNativeShell({
+ *   product: 'vibecontrols',
+ *   appName: 'VibeControls',
+ *   plugins: {
+ *     updater: () => import('@capgo/capacitor-updater'),
+ *     pushNotifications: () => import('@capacitor/push-notifications'),
+ *   },
+ *   push: { enabled: true },
+ * });
+ * // …after the first meaningful paint:
+ * void shell.markAppReady();
+ * ```
+ */
+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 { 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';
+export { showNativeActionSheet } from './actionSheet';
+export { installExternalUrlOpener, openExternalUrl } from './browser';
+export { writeClipboardText } from './clipboard';
+export { showNativeConfirm } from './dialog';
+export { impactFeedback, notificationFeedback, selectionFeedback } from './feedback';
+export { shareContent } from './share';
+export { showNativeToast } from './toast';
+export { populateDeviceInfo } from './device';
+export { installMobileRuntimeHooks } from './app-lifecycle';
+export { DEFAULT_AUTH_INTERCEPT_PREFIXES, installNativeAuthNavigationIntercept, } from './auth-navigation';
+export { createDefaultBackButtonHandlers, installBackButtonHandler, runBackButtonPrecedence, } from './back-button';
+export { configureKeyboard, keyboardHandlers, KEYBOARD_HEIGHT_CSS_VAR, KEYBOARD_OPEN_CLASS, } from './keyboard';
+export { getLastNetworkStatus, installNetworkListener, NETWORK_STATUS_EVENT } from './network';
+export { applyStatusBarTheme, DARK_FAMILY_THEMES, installStatusBarThemeListener, isDarkThemeName, resolveDocumentIsDark, statusBarDetailIsDark, type StatusBarThemeDetail, } from './system-bars';
+export { notifyOtaReady } from './ota';
+export { installPushNotifications, requestPushPermission, PUSH_TOKEN_EVENT } from './push';
+export { installPwa, installPwaPrompt, isPwaEligibleHost, resetPwaForTests, PWA_INSTALLED_EVENT, PWA_INSTALL_AVAILABLE_EVENT, PWA_UPDATE_READY_EVENT, } from './pwa';
+export { configureElectronGlobalKey, getDesktopBridge, getElectronGlobalKey, getLegacyElectronBridge, isDesktopShell, } from './desktop-bridge';
+export { defineCapacitorConfig, type CapacitorConfigLike } from './capacitor-config';
+export { defineWebManifest, type WebManifestIcon, type WebManifestLike, type WebManifestShortcut, } from './web-manifest';
+export { renderServiceWorker, SERVICE_WORKER_TEMPLATE } from './service-worker';
+export type { AuthInterceptOptions, BackButtonHandlers, BeforeInstallPromptEventLike, BootNativeShellOptions, CapacitorListenerHandleLike, CapacitorUpdaterLike, DeepLinkDetail, LegacyElectronBridge, MobileRuntimeHooks, NativeConfig, NativePreviewMode, NativeShellHandle, NativeShellPlatform, NetworkHooks, NetworkStatusDetail, OptionalPluginLoaders, PushActionPerformedLike, PushNotificationSchemaLike, PushNotificationsLike, PushNotificationsLoader, PushOptions, PushPermissionStateLike, PushTokenLike, PwaOptions, SplashOptions, UpdaterLoader, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shell-native/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+export declare const KEYBOARD_HEIGHT_CSS_VAR = "--keyboard-height";
+export declare const KEYBOARD_OPEN_CLASS = "keyboard-open";
+/** Handlers are exported for unit tests; the installer wires them to the plugin. */
+export declare const keyboardHandlers: {
+    willShow(keyboardHeight: number): void;
+    didShow(keyboardHeight: number): void;
+    willHide(): void;
+    didHide(): void;
+};
+/**
+ * Body resize mode, accessory bar off, `--keyboard-height` + `body.keyboard-open`,
+ * and `burdenoff:keyboardWillShow/DidShow/WillHide/DidHide` window events.
+ */
+export declare function configureKeyboard(): Promise<void>;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/shell-native/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/shell-native/keyboard.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAcnD,oFAAoF;AACpF,eAAO,MAAM,gBAAgB;6BACF,MAAM,GAAG,IAAI;4BAId,MAAM,GAAG,IAAI;gBAIzB,IAAI;eAIL,IAAI;CAIhB,CAAC;AAIF;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBvD"}

package/dist/shell-native/keyboard.js

@@ -0,0 +1,42 @@
+import { isNativePluginAvailable as e } from "./platform.js";
+import { Keyboard as t, KeyboardResize as n } from "@capacitor/keyboard";
+//#region src/shell-native/keyboard.ts
+var r = "--keyboard-height", i = "keyboard-open";
+function a(e) {
+	typeof document > "u" || (document.documentElement.style.setProperty(r, `${e}px`), e > 0 ? document.body?.classList.add(i) : document.body?.classList.remove(i));
+}
+function o(e, t) {
+	typeof window > "u" || window.dispatchEvent(new CustomEvent(e, { detail: { keyboardHeight: t } }));
+}
+var s = {
+	willShow(e) {
+		a(e), o("burdenoff:keyboardWillShow", e);
+	},
+	didShow(e) {
+		a(e), o("burdenoff:keyboardDidShow", e);
+	},
+	willHide() {
+		a(0), o("burdenoff:keyboardWillHide", 0);
+	},
+	didHide() {
+		a(0), o("burdenoff:keyboardDidHide", 0);
+	}
+}, c = !1;
+async function l() {
+	if (!c && e("Keyboard")) {
+		c = !0, typeof document < "u" && a(0);
+		try {
+			await Promise.all([
+				t.setResizeMode({ mode: n.Body }).catch(() => void 0),
+				t.setAccessoryBarVisible({ isVisible: !1 }).catch(() => void 0),
+				t.setScroll({ isDisabled: !1 }).catch(() => void 0),
+				t.addListener("keyboardWillShow", (e) => s.willShow(e.keyboardHeight)),
+				t.addListener("keyboardDidShow", (e) => s.didShow(e.keyboardHeight)),
+				t.addListener("keyboardWillHide", () => s.willHide()),
+				t.addListener("keyboardDidHide", () => s.didHide())
+			]);
+		} catch {}
+	}
+}
+//#endregion
+export { r as KEYBOARD_HEIGHT_CSS_VAR, i as KEYBOARD_OPEN_CLASS, l as configureKeyboard, s as keyboardHandlers };

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

@@ -0,0 +1,9 @@
+import { NetworkHooks, NetworkStatusDetail } from './types';
+export declare const NETWORK_STATUS_EVENT = "burdenoff:networkStatusChange";
+export declare function getLastNetworkStatus(): NetworkStatusDetail | null;
+/**
+ * Dispatches `burdenoff:networkStatusChange` `{ connected, connectionType }`.
+ * Native: Capacitor Network plugin. Web: `navigator.onLine` + online/offline events.
+ */
+export declare function installNetworkListener(hooks?: NetworkHooks): Promise<void>;
+//# sourceMappingURL=network.d.ts.map

package/dist/shell-native/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/shell-native/network.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEjE,eAAO,MAAM,oBAAoB,kCAAkC,CAAC;AAKpE,wBAAgB,oBAAoB,IAAI,mBAAmB,GAAG,IAAI,CAEjE;AAaD;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BpF"}

package/dist/shell-native/network.js

@@ -0,0 +1,40 @@
+import { isNativePluginAvailable as e } from "./platform.js";
+import { Network as t } from "@capacitor/network";
+//#region src/shell-native/network.ts
+var n = "burdenoff:networkStatusChange", r = null, i = !1;
+function a() {
+	return r;
+}
+function o(e, t) {
+	let i = r?.connected;
+	r = e, typeof window < "u" && window.dispatchEvent(new CustomEvent(n, { detail: e })), i !== e.connected && (e.connected ? t.onReconnect?.() : t.onDisconnect?.());
+}
+async function s(n = {}) {
+	if (!i) {
+		if (i = !0, typeof navigator < "u" && typeof navigator.onLine == "boolean" && (r = {
+			connected: navigator.onLine,
+			connectionType: "unknown"
+		}), e("Network")) try {
+			let e = await t.getStatus();
+			r = {
+				connected: e.connected,
+				connectionType: e.connectionType
+			}, await t.addListener("networkStatusChange", (e) => {
+				o({
+					connected: e.connected,
+					connectionType: e.connectionType
+				}, n);
+			});
+			return;
+		} catch {}
+		typeof window > "u" || (window.addEventListener("online", () => o({
+			connected: !0,
+			connectionType: "unknown"
+		}, n)), window.addEventListener("offline", () => o({
+			connected: !1,
+			connectionType: "none"
+		}, n)));
+	}
+}
+//#endregion
+export { n as NETWORK_STATUS_EVENT, a as getLastNetworkStatus, s as installNetworkListener };

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

@@ -0,0 +1,3 @@
+import { OptionalPluginLoaders } from './types';
+export declare function notifyOtaReady(loaders?: OptionalPluginLoaders): Promise<void>;
+//# sourceMappingURL=ota.d.ts.map

package/dist/shell-native/ota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ota.d.ts","sourceRoot":"","sources":["../../src/shell-native/ota.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBvF"}

package/dist/shell-native/ota.js

@@ -0,0 +1,21 @@
+import { getDesktopBridge as e } from "../shared/native/desktop.js";
+import { isRealNativePlatform as t } from "./platform.js";
+//#region src/shell-native/ota.ts
+async function n(n = {}) {
+	try {
+		if (t()) {
+			if (!n.updater) return;
+			let { CapacitorUpdater: e } = await n.updater();
+			await e.notifyAppReady();
+			return;
+		}
+		let r = e();
+		if (r) {
+			await r.notifyAppReady();
+			return;
+		}
+		typeof window < "u" && await window.electronUpdater?.notifyAppReady?.();
+	} catch {}
+}
+//#endregion
+export { n as notifyOtaReady };

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

@@ -0,0 +1,21 @@
+import { NativeShellPlatform } from './types';
+/** Real Capacitor platform, or the presentation preview override. */
+export declare function getNativePlatform(): NativeShellPlatform;
+/** True on a real Capacitor native platform OR an ios/android presentation preview. */
+export declare function isNativePlatform(): boolean;
+/** True only for a presentation preview (never inside a real native app). */
+export declare function isNativePreview(): boolean;
+/**
+ * REAL plugin availability — never influenced by previews. Every native plugin
+ * call in shell-native is guarded by this so previews are side-effect free.
+ */
+export declare function isNativePluginAvailable(pluginName: string): boolean;
+/** Really running inside Capacitor (no preview override). */
+export declare function isRealNativePlatform(): boolean;
+/**
+ * Writes `data-platform` on `<html>` and `platform-ios|android|web`,
+ * `platform-native` (ios/android incl. preview) and `platform-preview` (when
+ * previewing) on `<body>`.
+ */
+export declare function applyNativePlatformClass(): void;
+//# sourceMappingURL=platform.d.ts.map

package/dist/shell-native/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/shell-native/platform.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAmBnD,qEAAqE;AACrE,wBAAgB,iBAAiB,IAAI,mBAAmB,CAKvD;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,IAAI,OAAO,CAI1C;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAOnE;AAED,6DAA6D;AAC7D,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAiB/C"}

package/dist/shell-native/platform.js

@@ -0,0 +1,51 @@
+import { getActiveNativePreview as e } from "./preview.js";
+import { Capacitor as t } from "@capacitor/core";
+//#region src/shell-native/platform.ts
+function n() {
+	try {
+		let e = t.getPlatform();
+		return e === "ios" || e === "android" ? e : "web";
+	} catch {
+		return "web";
+	}
+}
+function r() {
+	try {
+		return t.isNativePlatform();
+	} catch {
+		return !1;
+	}
+}
+function i() {
+	if (r()) return n();
+	let t = e();
+	return t === "ios" || t === "android" ? t : "web";
+}
+function a() {
+	if (r()) return !0;
+	let t = e();
+	return t === "ios" || t === "android";
+}
+function o() {
+	return !r() && e() !== null;
+}
+function s(e) {
+	if (!r()) return !1;
+	try {
+		return t.isPluginAvailable(e);
+	} catch {
+		return !1;
+	}
+}
+function c() {
+	return r();
+}
+function l() {
+	if (typeof document > "u") return;
+	let e = i();
+	document.documentElement.dataset.platform = e;
+	let t = document.body;
+	t && (t.classList.remove("platform-ios", "platform-android", "platform-web", "platform-native", "platform-preview"), t.classList.add(`platform-${e}`), a() && t.classList.add("platform-native"), o() && t.classList.add("platform-preview"));
+}
+//#endregion
+export { l as applyNativePlatformClass, i as getNativePlatform, a as isNativePlatform, s as isNativePluginAvailable, o as isNativePreview, c as isRealNativePlatform };

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

@@ -0,0 +1,18 @@
+import { NativePreviewMode } from '../shared/native/types';
+export declare const NATIVE_PREVIEW_QUERY_PARAM = "__nativePreview";
+export declare const NATIVE_PREVIEW_STORAGE_KEY = "burdenoff.nativePreview";
+/**
+ * Resolve the preview mode for this page load: the query param wins and is
+ * persisted to sessionStorage (`off` clears it); otherwise the persisted value
+ * is reused. Never active inside a real Capacitor native app.
+ */
+export declare function resolveNativePreview(): NativePreviewMode | null;
+/** Preview mode resolved by the last `resolveNativePreview()` / `applyNativePreview()`. */
+export declare function getActiveNativePreview(): NativePreviewMode | null;
+/**
+ * Apply a preview mode to the document: `data-native-preview` on `<html>` and, for
+ * `desktop`, a minimal fake `window.__burdenoffDesktop` (only when no real bridge
+ * exists) plus `data-desktop-platform` / `data-desktop-titlebar`.
+ */
+export declare function applyNativePreview(mode: NativePreviewMode | null): void;
+//# sourceMappingURL=preview.d.ts.map

package/dist/shell-native/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/shell-native/preview.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAA0B,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAExF,eAAO,MAAM,0BAA0B,oBAAoB,CAAC;AAC5D,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AAsCpE;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CA4B/D;AAED,2FAA2F;AAC3F,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,IAAI,CAEjE;AA+DD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAgBvE"}

package/dist/shell-native/preview.js

@@ -0,0 +1,124 @@
+import { Capacitor as e } from "@capacitor/core";
+//#region src/shell-native/preview.ts
+var t = "__nativePreview", n = "burdenoff.nativePreview", r = new Set([
+	"ios",
+	"android",
+	"pwa",
+	"desktop"
+]), i = null;
+function a(e) {
+	return !!e && r.has(e);
+}
+function o() {
+	try {
+		return typeof sessionStorage < "u" ? sessionStorage.getItem(n) : null;
+	} catch {
+		return null;
+	}
+}
+function s(e) {
+	try {
+		if (typeof sessionStorage > "u") return;
+		e ? sessionStorage.setItem(n, e) : sessionStorage.removeItem(n);
+	} catch {}
+}
+function c() {
+	try {
+		return e.isNativePlatform();
+	} catch {
+		return !1;
+	}
+}
+function l() {
+	if (typeof window > "u") return null;
+	if (c()) return i = null, null;
+	let e;
+	try {
+		e = new URLSearchParams(window.location.search).get(t);
+	} catch {
+		e = null;
+	}
+	if (e === "off") return s(null), i = null, null;
+	if (a(e)) return s(e), i = e, e;
+	let n = o();
+	return i = a(n) ? n : null, i;
+}
+function u() {
+	return i;
+}
+function d() {}
+async function f() {}
+function p() {
+	return d;
+}
+function m() {
+	let e = window.location.origin;
+	return {
+		isElectron: !0,
+		platform: "darwin",
+		arch: "preview",
+		versions: {
+			app: "preview",
+			electron: "preview",
+			chrome: "preview"
+		},
+		product: {
+			id: "preview",
+			name: "Preview",
+			scheme: "preview",
+			appId: "preview"
+		},
+		runtimeConfig: {
+			environment: "prod",
+			appOrigin: e,
+			gatewayBases: {
+				globalBase: e,
+				workspaceBase: e
+			},
+			gatewayUrls: {
+				globalBaseUrl: e,
+				workspaceBaseUrl: e,
+				publicStoreBaseUrl: e
+			}
+		},
+		titlebar: "hidden-inset",
+		onDeepLink: p,
+		onNavigate: p,
+		onUpdateState: p,
+		onWindowState: p,
+		openExternal: async (e) => {
+			try {
+				window.open(e, "_blank", "noopener,noreferrer");
+			} catch {}
+			return !0;
+		},
+		notify: async () => !1,
+		setBadgeCount: f,
+		setTheme: d,
+		setTrayQuickActions: d,
+		setLocale: d,
+		getUpdateState: async () => ({ status: "unsupported" }),
+		checkForUpdates: async () => ({ status: "unsupported" }),
+		installUpdate: f,
+		notifyAppReady: f,
+		window: {
+			minimize: d,
+			toggleMaximize: d,
+			close: d,
+			hide: d,
+			focus: d,
+			setTitle: d
+		}
+	};
+}
+function h(e) {
+	if (i = e, typeof document > "u") return;
+	let t = document.documentElement;
+	if (!e) {
+		delete t.dataset.nativePreview;
+		return;
+	}
+	t.dataset.nativePreview = e, e === "desktop" && typeof window < "u" && (window.__burdenoffDesktop || (window.__burdenoffDesktop = m()), t.dataset.desktopPlatform = window.__burdenoffDesktop.platform, t.dataset.desktopTitlebar = window.__burdenoffDesktop.titlebar);
+}
+//#endregion
+export { t as NATIVE_PREVIEW_QUERY_PARAM, n as NATIVE_PREVIEW_STORAGE_KEY, h as applyNativePreview, u as getActiveNativePreview, l as resolveNativePreview };

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

@@ -0,0 +1,14 @@
+import { PushNotificationsLoader, PushOptions } from './types';
+export declare const PUSH_TOKEN_EVENT = "burdenoff:pushToken";
+/**
+ * Install push listeners (registration → dispatch `burdenoff:pushToken` + set
+ * `window.__burdenoffPushToken`; notification tap → deep-link navigator).
+ * Does NOT prompt for permission — call `requestPushPermission()` for that.
+ */
+export declare function installPushNotifications(loader: PushNotificationsLoader, options?: Pick<PushOptions, 'onToken' | 'onNotificationAction' | 'onNotificationReceived'>): Promise<void>;
+/**
+ * Ask the user for push permission (call from an in-context UI affordance,
+ * never at boot) and register for a token on grant.
+ */
+export declare function requestPushPermission(): Promise<boolean>;
+//# sourceMappingURL=push.d.ts.map

package/dist/shell-native/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/shell-native/push.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAGV,uBAAuB,EACvB,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAkCtD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,uBAAuB,EAC/B,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,sBAAsB,GAAG,wBAAwB,CAAM,GAC7F,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAc9D"}

package/dist/shell-native/push.js

@@ -0,0 +1,62 @@
+import { getNativePlatform as e, isRealNativePlatform as t } from "./platform.js";
+import { navigateDeepLinkPath as n } from "./deep-link.js";
+//#region src/shell-native/push.ts
+var r = "burdenoff:pushToken", i = null, a = null;
+async function o() {
+	if (i) return i;
+	if (!a || !t()) return null;
+	try {
+		i = (await a()).PushNotifications ?? null;
+	} catch {
+		i = null;
+	}
+	return i;
+}
+function s(e) {
+	let t = e.notification.data;
+	if (!t || typeof t != "object") return null;
+	let n = t.route;
+	if (typeof n == "string" && n.startsWith("/")) return n;
+	let r = t.url;
+	if (typeof r == "string") try {
+		let e = new URL(r);
+		return `${e.pathname || "/"}${e.search}${e.hash}`;
+	} catch {
+		if (r.startsWith("/")) return r;
+	}
+	return null;
+}
+async function c(t, c = {}) {
+	a !== t && (i = null, a = t);
+	let l = await o();
+	if (!l) return;
+	let u = e();
+	if (u !== "web") try {
+		await l.addListener("registration", (e) => {
+			let t = {
+				value: e.value,
+				platform: u
+			};
+			window.__burdenoffPushToken = t, window.dispatchEvent(new CustomEvent(r, { detail: t })), c.onToken?.(e.value, u);
+		}), await l.addListener("registrationError", (e) => {
+			console.debug("[shell-native] Push registration error:", e.error);
+		}), await l.addListener("pushNotificationReceived", (e) => {
+			c.onNotificationReceived?.(e);
+		}), await l.addListener("pushNotificationActionPerformed", (e) => {
+			let t = s(e);
+			t && n(t), c.onNotificationAction?.(e);
+		}), (await l.checkPermissions()).receive === "granted" && await l.register();
+	} catch {}
+}
+async function l() {
+	let e = await o();
+	if (!e) return !1;
+	try {
+		let t = await e.checkPermissions();
+		return (t.receive === "prompt" || t.receive === "prompt-with-rationale") && (t = await e.requestPermissions()), t.receive === "granted" ? (await e.register(), !0) : !1;
+	} catch {
+		return !1;
+	}
+}
+//#endregion
+export { r as PUSH_TOKEN_EVENT, c as installPushNotifications, l as requestPushPermission };

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

@@ -0,0 +1,14 @@
+import { PwaOptions } from './types';
+export declare const PWA_UPDATE_READY_EVENT = "burdenoff:pwaUpdateReady";
+export declare const PWA_INSTALLED_EVENT = "burdenoff:pwaInstalled";
+export declare const PWA_INSTALL_AVAILABLE_EVENT = "burdenoff:pwaInstallAvailable";
+export declare function isPwaEligibleHost(hostname: string): boolean;
+/** Test-only reset. */
+export declare function resetPwaForTests(): void;
+export declare function installPwa(options?: PwaOptions): void;
+/**
+ * Trigger the captured install prompt. Resolves true when the user accepted.
+ * (The fe-libs `usePWA` hook is the richer, stateful alternative.)
+ */
+export declare function installPwaPrompt(): Promise<boolean>;
+//# sourceMappingURL=pwa.d.ts.map

package/dist/shell-native/pwa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa.d.ts","sourceRoot":"","sources":["../../src/shell-native/pwa.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAgC,UAAU,EAAE,MAAM,SAAS,CAAC;AAExE,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAC5D,eAAO,MAAM,2BAA2B,kCAAkC,CAAC;AAI3E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI3D;AAID,uBAAuB;AACvB,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,UAAe,GAAG,IAAI,CAgEzD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAczD"}

package/dist/shell-native/pwa.js

@@ -0,0 +1,49 @@
+import { isNativePlatform as e, isRealNativePlatform as t } from "./platform.js";
+import { isDesktopShell as n } from "./desktop-bridge.js";
+//#region src/shell-native/pwa.ts
+var r = "burdenoff:pwaUpdateReady", i = "burdenoff:pwaInstalled", a = "burdenoff:pwaInstallAvailable", o = ["localhost", "127.0.0.1"];
+function s(e) {
+	return !(o.includes(e) || e.endsWith(".local.burdenoff.com"));
+}
+var c = !1;
+function l() {
+	c = !1;
+}
+function u(o = {}) {
+	if (c || o.enabled === !1 || typeof window > "u" || typeof navigator > "u" || t() || e() || n() || !s(window.location.hostname) || (c = !0, window.addEventListener("beforeinstallprompt", (e) => {
+		window.__burdenoffPwaInstallPrompt = e, window.dispatchEvent(new CustomEvent(a));
+	}), window.addEventListener("appinstalled", () => {
+		window.__burdenoffPwaInstallPrompt = null, window.dispatchEvent(new CustomEvent(i));
+	}), !("serviceWorker" in navigator))) return;
+	let l = o.swUrl ?? "/sw.js", u = o.updateCheckIntervalMs ?? 6e4, d = !1, f = (e) => {
+		let t = e.waiting;
+		!t || !navigator.serviceWorker.controller || (window.dispatchEvent(new CustomEvent(r)), navigator.serviceWorker.addEventListener("controllerchange", () => {
+			d || (d = !0, window.location.reload());
+		}), t.postMessage({ type: "SKIP_WAITING" }));
+	}, p = () => {
+		navigator.serviceWorker.register(l).then((e) => {
+			f(e), e.addEventListener("updatefound", () => {
+				let t = e.installing;
+				t && t.addEventListener("statechange", () => {
+					t.state === "installed" && f(e);
+				});
+			}), u > 0 && setInterval(() => {
+				e.update().catch(() => void 0);
+			}, u);
+		}).catch((e) => {
+			console.debug("[shell-native] Service worker registration failed:", e);
+		});
+	};
+	document.readyState === "complete" ? p() : window.addEventListener("load", p, { once: !0 });
+}
+async function d() {
+	let e = typeof window < "u" ? window.__burdenoffPwaInstallPrompt : null;
+	if (!e) return !1;
+	try {
+		return await e.prompt(), (await e.userChoice)?.outcome === "accepted" ? (window.__burdenoffPwaInstallPrompt = null, !0) : !1;
+	} catch {
+		return !1;
+	}
+}
+//#endregion
+export { i as PWA_INSTALLED_EVENT, a as PWA_INSTALL_AVAILABLE_EVENT, r as PWA_UPDATE_READY_EVENT, u as installPwa, d as installPwaPrompt, s as isPwaEligibleHost, l as resetPwaForTests };

package/dist/shell-native/service-worker.d.ts

@@ -0,0 +1,5 @@
+import { NativeConfig } from './types';
+export declare const SERVICE_WORKER_TEMPLATE: string;
+/** Render the canonical sw.js for a product (`version` defaults to `v1`). */
+export declare function renderServiceWorker(cfg: NativeConfig, version?: string): string;
+//# sourceMappingURL=service-worker.d.ts.map

package/dist/shell-native/service-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-worker.d.ts","sourceRoot":"","sources":["../../src/shell-native/service-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,eAAO,MAAM,uBAAuB,QAyInC,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,SAAO,GAAG,MAAM,CAK7E"}