@burdenoff/fe-libs 2026.819.5 → 2026.823.2

package/dist/shared/native/hooks/useActionSheet.js

@@ -0,0 +1,45 @@
+import { nativeActionSheet as e } from "../consumers.js";
+import { useCallback as t, useMemo as n, useRef as r, useState as i } from "react";
+//#region src/shared/native/hooks/useActionSheet.ts
+function a(e, t) {
+	return e === null ? { source: "fallback" } : !Number.isInteger(e) || e < 0 || e >= t ? {
+		source: "native",
+		index: null
+	} : {
+		source: "native",
+		index: e
+	};
+}
+var o = [];
+function s() {
+	let [s, c] = i(null), l = r(null), u = t((e) => {
+		let t = l.current;
+		l.current = null, c(null), t?.(e);
+	}, []);
+	return {
+		show: t(async (t) => {
+			if (t.options.length === 0) return null;
+			let n = a(await e({
+				title: t.title,
+				message: t.message,
+				options: t.options
+			}), t.options.length);
+			return n.source === "native" ? n.index : (l.current?.(null), new Promise((e) => {
+				l.current = e, c(t);
+			}));
+		}, []),
+		sheetProps: n(() => ({
+			open: s !== null,
+			onOpenChange: (e) => {
+				e || u(null);
+			},
+			title: s?.title,
+			message: s?.message,
+			options: s?.options ?? o,
+			cancelLabel: s?.cancelLabel,
+			onSelect: (e) => u(e)
+		}), [s, u])
+	};
+}
+//#endregion
+export { a as resolveActionSheetOutcome, s as useActionSheet };

package/dist/shared/native/hooks/useDesktop.d.ts

@@ -0,0 +1,15 @@
+import { BurdenoffDesktopBridge, DesktopPlatform, DesktopTitlebarMode } from '../types';
+export interface UseDesktopResult {
+    isDesktop: boolean;
+    platform?: DesktopPlatform;
+    titlebar?: DesktopTitlebarMode;
+    versions?: BurdenoffDesktopBridge['versions'];
+    product?: BurdenoffDesktopBridge['product'];
+    bridge: BurdenoffDesktopBridge | null;
+}
+/**
+ * Desktop shell identity. `isDesktop` is true for the legacy per-product
+ * preload too, in which case only `bridge`-derived fields are undefined.
+ */
+export declare function useDesktop(): UseDesktopResult;
+//# sourceMappingURL=useDesktop.d.ts.map

package/dist/shared/native/hooks/useDesktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDesktop.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/useDesktop.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE7F,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CAY7C"}

package/dist/shared/native/hooks/useDesktop.js

@@ -0,0 +1,18 @@
+import { getDesktopBridge as e, isDesktop as t } from "../desktop.js";
+import { useMemo as n } from "react";
+//#region src/shared/native/hooks/useDesktop.ts
+function r() {
+	return n(() => {
+		let n = e();
+		return {
+			isDesktop: t(),
+			platform: n?.platform,
+			titlebar: n?.titlebar,
+			versions: n?.versions,
+			product: n?.product,
+			bridge: n
+		};
+	}, []);
+}
+//#endregion
+export { r as useDesktop };

package/dist/shared/native/hooks/useDesktopUpdateState.d.ts

@@ -0,0 +1,7 @@
+import { DesktopUpdateState } from '../types';
+/**
+ * Live auto-update state from the desktop shell. Always
+ * `{ status: 'unsupported' }` on web.
+ */
+export declare function useDesktopUpdateState(): DesktopUpdateState;
+//# sourceMappingURL=useDesktopUpdateState.d.ts.map

package/dist/shared/native/hooks/useDesktopUpdateState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDesktopUpdateState.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/useDesktopUpdateState.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAqB1D"}

package/dist/shared/native/hooks/useDesktopUpdateState.js

@@ -0,0 +1,20 @@
+import { DESKTOP_UPDATE_UNSUPPORTED as e, getDesktopUpdateState as t, onDesktopUpdateState as n } from "../desktop.js";
+import { useEffect as r, useState as i } from "react";
+//#region src/shared/native/hooks/useDesktopUpdateState.ts
+function a() {
+	let [a, o] = i(e);
+	return r(() => {
+		let e = !1;
+		t().then((t) => {
+			e || o(t);
+		});
+		let r = n((t) => {
+			e || o(t);
+		});
+		return () => {
+			e = !0, r();
+		};
+	}, []), a;
+}
+//#endregion
+export { a as useDesktopUpdateState };

package/dist/shared/native/hooks/useDesktopWindowState.d.ts

@@ -0,0 +1,7 @@
+import { DesktopWindowState } from '../types';
+/**
+ * Window focus / fullscreen / maximize state, kept in sync by
+ * `bootDesktopShell()`. Returns the neutral default on web.
+ */
+export declare function useDesktopWindowState(): DesktopWindowState;
+//# sourceMappingURL=useDesktopWindowState.d.ts.map

package/dist/shared/native/hooks/useDesktopWindowState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDesktopWindowState.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/useDesktopWindowState.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAM1D"}

package/dist/shared/native/hooks/useDesktopWindowState.js

@@ -0,0 +1,9 @@
+import { getDesktopWindowState as e, onDesktopWindowState as t } from "../desktop.js";
+import { useEffect as n, useState as r } from "react";
+//#region src/shared/native/hooks/useDesktopWindowState.ts
+function i() {
+	let [i, a] = r(() => e());
+	return n(() => t(a), []), i;
+}
+//#endregion
+export { i as useDesktopWindowState };

package/dist/shared/native/hooks/useHaptics.d.ts

@@ -2,6 +2,7 @@ import { HapticImpactStyle, HapticNotificationType } from '../types';
 export interface UseHapticsResult {
     impact: (style?: HapticImpactStyle) => void;
     notify: (type: HapticNotificationType) => void;
+    /** Lightest tap — toggles, segments, picker/tab changes (spec §5.4). */
     selection: () => void;
 }
 export declare function useHaptics(): UseHapticsResult;

package/dist/shared/native/hooks/useHaptics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHaptics.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/useHaptics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C,MAAM,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC/C,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAS7C"}
+{"version":3,"file":"useHaptics.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/useHaptics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C,MAAM,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC/C,wEAAwE;IACxE,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAS7C"}

package/dist/shared/native/hooks/useHaptics.js

@@ -1,12 +1,12 @@
-import { nativeImpact as e, nativeNotify as t } from "../consumers.js";
-import { useMemo as n } from "react";
+import { nativeImpact as e, nativeNotify as t, nativeSelection as n } from "../consumers.js";
+import { useMemo as r } from "react";
 //#region src/shared/native/hooks/useHaptics.ts
-function r() {
-	return n(() => ({
+function i() {
+	return r(() => ({
 		impact: (t) => e(t),
 		notify: (e) => t(e),
-		selection: () => e("light")
+		selection: () => n()
 	}), []);
 }
 //#endregion
-export { r as useHaptics };
+export { i as useHaptics };

package/dist/shared/native/hooks/useNetworkStatus.d.ts

@@ -0,0 +1,23 @@
+import { NetworkStatusEventDetail } from '../types';
+export interface NetworkStatus {
+    connected: boolean;
+    /** Capacitor connection type when known (`wifi`, `cellular`, `none`, `unknown`). */
+    connectionType?: string;
+}
+/**
+ * Pure reducer for connectivity updates. Returns `prev` (referentially) when
+ * nothing changed so React state updates are skipped for repeat events.
+ */
+export declare function reduceNetworkStatus(prev: NetworkStatus, next: NetworkStatusEventDetail): NetworkStatus;
+/** Initial connectivity snapshot from `navigator.onLine` (optimistic on SSR). */
+export declare function readInitialNetworkStatus(nav?: {
+    onLine?: boolean;
+} | undefined): NetworkStatus;
+/**
+ * Live connectivity for offline UI. Seeded from `navigator.onLine`, then
+ * updated by the shell-native `burdenoff:networkStatusChange` event (Capacitor
+ * Network plugin on native) and the browser `online`/`offline` events, so it
+ * is correct on web even when `bootNativeShell` was never called.
+ */
+export declare function useNetworkStatus(): NetworkStatus;
+//# sourceMappingURL=useNetworkStatus.d.ts.map

package/dist/shared/native/hooks/useNetworkStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNetworkStatus.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/useNetworkStatus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAKzD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,wBAAwB,GAC7B,aAAa,CAMf;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CACtC,GAAG,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAoE,GAC/F,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CA0BhD"}

package/dist/shared/native/hooks/useNetworkStatus.js

@@ -0,0 +1,29 @@
+import { useEffect as e, useState as t } from "react";
+//#region src/shared/native/hooks/useNetworkStatus.ts
+var n = "burdenoff:networkStatusChange";
+function r(e, t) {
+	let n = t.connectionType ?? e.connectionType;
+	return e.connected === t.connected && e.connectionType === n ? e : {
+		connected: t.connected,
+		connectionType: n
+	};
+}
+function i(e = typeof navigator > "u" ? void 0 : navigator) {
+	return e && typeof e.onLine == "boolean" ? { connected: e.onLine } : { connected: !0 };
+}
+function a() {
+	let [a, o] = t(() => i());
+	return e(() => {
+		let e = (e) => {
+			o((t) => r(t, e));
+		}, t = (t) => {
+			let n = t.detail;
+			n && typeof n.connected == "boolean" && e(n);
+		}, i = () => e({ connected: !0 }), a = () => e({ connected: !1 });
+		return window.addEventListener(n, t), window.addEventListener("online", i), window.addEventListener("offline", a), () => {
+			window.removeEventListener(n, t), window.removeEventListener("online", i), window.removeEventListener("offline", a);
+		};
+	}, []), a;
+}
+//#endregion
+export { i as readInitialNetworkStatus, r as reduceNetworkStatus, a as useNetworkStatus };

package/dist/shared/native/hooks/usePullToRefresh.d.ts

@@ -0,0 +1,62 @@
+import { TouchEvent as ReactTouchEvent } from 'react';
+/** Default pull distance (px of finger travel) required to trigger a refresh. */
+export declare const PULL_TO_REFRESH_THRESHOLD = 72;
+/**
+ * Refresh progress for a downward pull: 0 at rest, 1 once the finger has
+ * travelled `threshold` px. Clamped; negative/zero pulls and invalid
+ * thresholds yield 0.
+ */
+export declare function computePullProgress(dy: number, threshold: number): number;
+/**
+ * Rubber-banded indicator offset (px) for a pull of `dy` px. Approaches
+ * `threshold * 1.5` asymptotically so long pulls feel damped like the native
+ * gesture instead of tracking the finger 1:1.
+ */
+export declare function computePullOffset(dy: number, threshold: number): number;
+export interface UsePullToRefreshOptions {
+    /** Called when the gesture completes past the threshold. */
+    onRefresh: () => Promise<void> | void;
+    /** Finger travel (px) required to arm the refresh. Default 72. */
+    threshold?: number;
+    /** Hard-disable the gesture (e.g. while a form blocks navigation). */
+    disabled?: boolean;
+    /**
+     * Whether the gesture is active at all. Defaults to `isNative()` — web
+     * browsers already have reload affordances; pass `true` to enable it for
+     * installed PWAs too.
+     */
+    enabled?: boolean;
+}
+export interface PullToRefreshBind {
+    /** Attach to the scrollable container. */
+    ref: (node: HTMLElement | null) => void;
+    onTouchStart: (event: ReactTouchEvent<HTMLElement>) => void;
+    onTouchMove: (event: ReactTouchEvent<HTMLElement>) => void;
+    onTouchEnd: () => void;
+    onTouchCancel: () => void;
+}
+export interface UsePullToRefreshResult {
+    /** Spread onto the scroll container (`<div {...bind}>`). */
+    bind: PullToRefreshBind;
+    /** True while the finger is down and pulling past the top. */
+    pulling: boolean;
+    /** 0..1 — fraction of the threshold reached. */
+    progress: number;
+    /** Damped indicator offset in px. */
+    offset: number;
+    /** True while `onRefresh` is running. */
+    refreshing: boolean;
+    /** Resolved enablement (native detection + `disabled`). */
+    enabled: boolean;
+}
+/**
+ * Touch pull-to-refresh for scrollable lists (spec §5.7): only engages when
+ * the container is scrolled to the top, fires `impact('medium')` once when the
+ * pull crosses the threshold, and `notify('success')` after `onRefresh`
+ * resolves. Pair with the `PullToRefresh` wrapper from
+ * `@burdenoff/fe-libs/ui`, or spread `bind` onto your own container (give it
+ * `overscroll-behavior-y: contain` — the `[data-pull-to-refresh]` CSS does
+ * this — so the browser's own overscroll doesn't fight the gesture).
+ */
+export declare function usePullToRefresh(options: UsePullToRefreshOptions): UsePullToRefreshResult;
+//# sourceMappingURL=usePullToRefresh.d.ts.map

package/dist/shared/native/hooks/usePullToRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePullToRefresh.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/usePullToRefresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,IAAI,eAAe,EAAE,MAAM,OAAO,CAAC;AAKnG,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,GAAG,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC5D,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC3D,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,IAAI,EAAE,iBAAiB,CAAC;IACxB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA0GzF"}

package/dist/shared/native/hooks/usePullToRefresh.js

@@ -0,0 +1,84 @@
+import { isNative as e } from "../platform.js";
+import { nativeImpact as t, nativeNotify as n } from "../consumers.js";
+import { useCallback as r, useMemo as i, useRef as a, useState as o } from "react";
+//#region src/shared/native/hooks/usePullToRefresh.ts
+var s = 72;
+function c(e, t) {
+	return !(t > 0) || !(e > 0) ? 0 : Math.min(e / t, 1);
+}
+function l(e, t) {
+	if (!(t > 0) || !(e > 0)) return 0;
+	let n = t * 1.5;
+	return Math.round(n * (1 - Math.exp(-e / n)));
+}
+function u(s) {
+	let { onRefresh: u, threshold: d = 72, disabled: f = !1 } = s, p = !f && (s.enabled ?? e()), m = a(null), h = a(null), g = a(!1), _ = a(0), v = a(u);
+	v.current = u;
+	let [y, b] = o(!1), [x, S] = o(0), [C, w] = o(0), [T, E] = o(!1), D = r(() => {
+		h.current = null, g.current = !1, _.current = 0, b(!1), S(0), w(0);
+	}, []), O = r((e) => {
+		m.current = e;
+	}, []), k = r((e) => {
+		if (!p || T) return;
+		let t = m.current;
+		if (t && t.scrollTop > 0) return;
+		let n = e.touches[0];
+		n && (h.current = n.clientY, g.current = !1);
+	}, [p, T]), A = r((e) => {
+		if (!p || T || h.current === null) return;
+		let n = m.current;
+		if (n && n.scrollTop > 0) {
+			D();
+			return;
+		}
+		let r = e.touches[0];
+		if (!r) return;
+		let i = r.clientY - h.current, a = c(i, d);
+		if (a <= 0) {
+			_.current > 0 && D();
+			return;
+		}
+		a >= 1 && !g.current && (g.current = !0, t("medium")), _.current = a, b(!0), S(a), w(l(i, d));
+	}, [
+		p,
+		T,
+		D,
+		d
+	]), j = r(() => {
+		if (!p || h.current === null) return;
+		let e = _.current >= 1 && !T;
+		D(), e && (E(!0), Promise.resolve().then(() => v.current()).then(() => {
+			n("success");
+		}).catch(() => {}).finally(() => {
+			E(!1);
+		}));
+	}, [
+		p,
+		T,
+		D
+	]), M = r(() => {
+		D();
+	}, [D]);
+	return {
+		bind: i(() => ({
+			ref: O,
+			onTouchStart: k,
+			onTouchMove: A,
+			onTouchEnd: j,
+			onTouchCancel: M
+		}), [
+			O,
+			k,
+			A,
+			j,
+			M
+		]),
+		pulling: y,
+		progress: x,
+		offset: C,
+		refreshing: T,
+		enabled: p
+	};
+}
+//#endregion
+export { s as PULL_TO_REFRESH_THRESHOLD, l as computePullOffset, c as computePullProgress, u as usePullToRefresh };

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

@@ -1,8 +1,13 @@
-export type { AppState, AppStateEventDetail, BurdenoffNativeBridge, BurdenoffNativePlatform, ConfirmOptions, DeviceInfo, HapticImpactStyle, HapticNotificationType, KeyboardEventDetail, NetworkStatusEventDetail, SafeAreaInsets, ShareOptions, StatusBarTheme, StatusBarThemeEventDetail, ToastDuration, } from './types';
+export type { ActionSheetButton, ActionSheetButtonStyle, ActionSheetOptions, AppState, AppStateEventDetail, BurdenoffDesktopBridge, BurdenoffNativeBridge, BurdenoffNativePlatform, ConfirmOptions, DesktopEnvironment, DesktopNotification, DesktopPlatform, DesktopQuickAction, DesktopRuntimeConfig, DesktopThemeOptions, DesktopTitlebarMode, DesktopUpdateState, DesktopUpdateStatus, DesktopWindowState, DeviceInfo, HapticImpactStyle, HapticNotificationType, KeyboardEventDetail, NativePreviewMode, NetworkStatusEventDetail, PushTokenEventDetail, SafeAreaInsets, ShareOptions, StatusBarTheme, StatusBarThemeEventDetail, ToastDuration, } from './types';
 export { getNativeBridge } from './bridge';
 export { getPlatform, isAndroid, isIOS, isNative, isWeb, isElectron, isStandalonePWA, isInstalledApp, isWebBrowser, } from './platform';
 export { nativeConfirm, nativeCopyText, nativeImpact, nativeNotify, nativeOpenUrl, nativeShare, nativeToast, } from './consumers';
 export { SafeAreaView, type SafeAreaViewProps } from './SafeAreaView';
 export * from './hooks';
 export { isNativeIAPAvailable, getNativeProducts, purchaseNativeProduct, acknowledgeNativePurchase, restoreNativePurchases, getNativePurchases, installNativeIAP, type NativeProduct, type NativeTransaction, type NativePurchaseType, } from './purchases';
+export { shouldShowNativeWelcome, getNativeEntryRoutes } from './entry';
+export type { NativeEntryRoutes } from './entry';
+export { nativeSelection, nativeActionSheet } from './consumers';
+export { getDesktopBridge, getLegacyDesktopRuntime, isDesktop, getDesktopRuntimeConfig, getDesktopGatewayBases, getDesktopGatewayUrls, getDesktopAuthBridgeConfig, desktopOpenExternal, desktopNotify, desktopSetBadgeCount, desktopSetTheme, desktopSetTrayQuickActions, desktopSetLocale, desktopDeepLinkToPath, installDesktopDeepLinkHandler, installDesktopNavigateHandler, registerDesktopNavigator, bootDesktopShell, onDesktopUpdateState, onDesktopWindowState, getDesktopWindowState, desktopCheckForUpdates, desktopInstallUpdate, getDesktopUpdateState, DESKTOP_UPDATE_UNSUPPORTED, DESKTOP_WINDOW_STATE_DEFAULT, } from './desktop';
+export type { BootDesktopShellOptions, DesktopShellHandle, LegacyDesktopRuntime } from './desktop';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/native/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,EACL,QAAQ,EACR,KAAK,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/native/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,QAAQ,EACR,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,EACL,QAAQ,EACR,KAAK,EACL,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/shared/native/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/shared/native/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,WAAW,IAAI,uBAAuB,CAIrD;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,gDAAgD;AAChD,wBAAgB,UAAU,IAAI,OAAO,CASpC;AAED,mFAAmF;AACnF,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/shared/native/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,WAAW,IAAI,uBAAuB,CAIrD;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,gDAAgD;AAChD,wBAAgB,UAAU,IAAI,OAAO,CAapC;AAED,mFAAmF;AACnF,wBAAgB,eAAe,IAAI,OAAO,CAQzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/shared/native/platform.js

@@ -17,10 +17,11 @@ function a() {
 	return t() === "web";
 }
 function o() {
-	return !!(typeof navigator < "u" && /electron/i.test(navigator.userAgent) || typeof window < "u" && window.process?.type === "renderer");
+	return typeof window > "u" ? !1 : !!(window.__burdenoffDesktop?.isElectron || typeof navigator < "u" && /electron/i.test(navigator.userAgent) || typeof window < "u" && window.process?.type === "renderer");
 }
 function s() {
 	if (typeof window > "u") return !1;
+	if (document?.documentElement?.dataset?.nativePreview === "pwa") return !0;
 	let e = window.matchMedia?.("(display-mode: standalone)")?.matches ?? !1, t = window.navigator.standalone === !0;
 	return e || t;
 }

package/dist/shared/native/purchases.d.ts

@@ -1,7 +1,13 @@
 import { PURCHASE_TYPE, Product, Transaction } from '@capgo/native-purchases';
 export type { Product as NativeProduct, Transaction as NativeTransaction, } from '@capgo/native-purchases';
 export type { PURCHASE_TYPE as NativePurchaseType } from '@capgo/native-purchases';
-/** True when running inside a Capacitor iOS or Android app. */
+/**
+ * True when running inside a Capacitor iOS or Android app.
+ *
+ * Resolved through the shell-installed native bridge (`shared/native/platform`)
+ * instead of a static Capacitor import, so this module stays loadable in
+ * web-only bundles where Capacitor is never installed.
+ */
 export declare function isNativeIAPAvailable(): boolean;
 /**
  * Fetch product info from the App Store / Play Store for the given identifiers.

package/dist/shared/native/purchases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"purchases.d.ts","sourceRoot":"","sources":["../../../src/shared/native/purchases.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGnF,YAAY,EACV,OAAO,IAAI,aAAa,EACxB,WAAW,IAAI,iBAAiB,GACjC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,+DAA+D;AAC/D,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAmBD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,kBAAkB,EAAE,MAAM,EAAE,EAC5B,WAAW,CAAC,EAAE,aAAa,GAC1B,OAAO,CAAC,OAAO,EAAE,CAAC,CAKpB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GACA,OAAO,CAAC,WAAW,CAAC,CAItB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAED,gGAAgG;AAChG,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI5D;AAED,yEAAyE;AACzE,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IACjD,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAKzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GACjD,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"purchases.d.ts","sourceRoot":"","sources":["../../../src/shared/native/purchases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKnF,YAAY,EACV,OAAO,IAAI,aAAa,EACxB,WAAW,IAAI,iBAAiB,GACjC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAmBD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,kBAAkB,EAAE,MAAM,EAAE,EAC5B,WAAW,CAAC,EAAE,aAAa,GAC1B,OAAO,CAAC,OAAO,EAAE,CAAC,CAKpB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GACA,OAAO,CAAC,WAAW,CAAC,CAItB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAED,gGAAgG;AAChG,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI5D;AAED,yEAAyE;AACzE,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IACjD,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAKzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GACjD,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/shared/native/purchases.js

@@ -1,10 +1,10 @@
-import { Capacitor as e } from "../../node_modules/@capacitor/core/dist/index.js";
+import { isNative as e } from "./platform.js";
 //#region src/shared/native/purchases.ts
 function t() {
-	return e.isNativePlatform();
+	return e();
 }
 async function n() {
-	if (!e.isNativePlatform()) return null;
+	if (!t()) return null;
 	try {
 		return (await import(
 			/* @vite-ignore */

package/dist/shared/native/types.d.ts

@@ -1,3 +1,6 @@
+import { GatewayBases } from '../utils/gatewayFetchRewrite';
+import { RuntimeGatewayUrls } from '../config/gatewayUrls';
+import { RuntimeAuthBridgeConfig } from '../config/authBridgeUrls';
 export type BurdenoffNativePlatform = 'ios' | 'android' | 'web';
 export type HapticImpactStyle = 'light' | 'medium' | 'heavy';
 export type HapticNotificationType = 'success' | 'warning' | 'error';
@@ -29,21 +32,154 @@ export interface DeviceInfo {
     manufacturer?: string;
     isVirtual?: boolean;
 }
+export type ActionSheetButtonStyle = 'default' | 'destructive' | 'cancel';
+export interface ActionSheetButton {
+    title: string;
+    style?: ActionSheetButtonStyle;
+    /** Optional icon name (lucide) — used by the web fallback sheet only. */
+    icon?: string;
+}
+export interface ActionSheetOptions {
+    title?: string;
+    message?: string;
+    options: ActionSheetButton[];
+}
+/**
+ * Presentation-only native preview, armed by `?__nativePreview=ios|android|pwa|desktop|off`
+ * (persisted in sessionStorage). Lets Playwright/humans see the installed-app UI in a
+ * plain browser. Plugin calls stay guarded by the REAL Capacitor availability, so this
+ * never triggers native side effects.
+ */
+export type NativePreviewMode = 'ios' | 'android' | 'pwa' | 'desktop';
 export interface BurdenoffNativeBridge {
     getPlatform(): BurdenoffNativePlatform;
     isNativePlatform(): boolean;
     impact(style?: HapticImpactStyle): Promise<void>;
     notify(type: HapticNotificationType): Promise<void>;
+    /** Haptic selection tick (tab switch, picker change). Optional for older shells. */
+    selection?(): Promise<void>;
     toast(message: string, duration?: ToastDuration): Promise<boolean>;
     confirm(options: ConfirmOptions): Promise<boolean | null>;
+    /**
+     * Native action sheet. Resolves the chosen option index, or `null` when the
+     * native sheet is unavailable (caller must render its web fallback). Optional
+     * for older shells.
+     */
+    actionSheet?(options: ActionSheetOptions): Promise<number | null>;
     copyText(text: string): Promise<boolean>;
     share(options: ShareOptions): Promise<boolean>;
     openExternalUrl(url: string): Promise<void>;
+    /** True when the platform is a presentation-only preview (see NativePreviewMode). */
+    isPreview?(): boolean;
+}
+export type DesktopPlatform = 'darwin' | 'win32' | 'linux';
+export type DesktopTitlebarMode = 'hidden-inset' | 'native';
+export type DesktopEnvironment = 'local' | 'alpha' | 'prod';
+/**
+ * Runtime config baked into the desktop build and exposed on the bridge.
+ *
+ * Byte-compatible with the legacy `window.<product>Electron.runtimeConfig`
+ * shape (see `@burdenoff/desktop-shell` `src/shared/types.ts` — the authoritative
+ * contract), so it reuses the existing fe-libs runtime types rather than
+ * redefining them.
+ */
+export interface DesktopRuntimeConfig {
+    environment: DesktopEnvironment;
+    gatewayBases: GatewayBases;
+    gatewayUrls: RuntimeGatewayUrls;
+    authBridge?: RuntimeAuthBridgeConfig;
+    /** Origin the desktop window loads (custom scheme in packaged builds). */
+    appOrigin?: string;
+    /** electron-updater generic feed root for this channel. */
+    updateFeedUrl?: string;
+}
+export type DesktopUpdateStatus = 'unsupported' | 'idle' | 'checking' | 'available' | 'downloading' | 'downloaded' | 'up-to-date' | 'error';
+export interface DesktopUpdateState {
+    status: DesktopUpdateStatus;
+    version?: string;
+    percent?: number;
+    error?: string;
+    checkedAt?: string;
+}
+export interface DesktopNotification {
+    id?: string;
+    title: string;
+    body?: string;
+    /** In-app route to navigate to when the notification is clicked. */
+    route?: string;
+    silent?: boolean;
+}
+export interface DesktopQuickAction {
+    id: string;
+    label: string;
+    route?: string;
+    accelerator?: string;
+    /** Also expose on the Windows jump list / macOS dock menu. */
+    jumpList?: boolean;
+}
+export interface DesktopWindowState {
+    focused: boolean;
+    fullScreen: boolean;
+    maximized: boolean;
+}
+export interface DesktopThemeOptions {
+    scheme: 'light' | 'dark' | 'system';
+    backgroundColor?: string;
+}
+export interface BurdenoffDesktopBridge {
+    readonly isElectron: true;
+    readonly platform: DesktopPlatform;
+    readonly arch: string;
+    readonly versions: {
+        app: string;
+        electron: string;
+        chrome: string;
+    };
+    readonly product: {
+        id: string;
+        name: string;
+        scheme: string;
+        appId: string;
+    };
+    readonly runtimeConfig: DesktopRuntimeConfig;
+    readonly titlebar: DesktopTitlebarMode;
+    onDeepLink(cb: (url: string) => void): () => void;
+    onNavigate(cb: (route: string) => void): () => void;
+    onUpdateState(cb: (state: DesktopUpdateState) => void): () => void;
+    onWindowState(cb: (state: DesktopWindowState) => void): () => void;
+    openExternal(url: string): Promise<boolean>;
+    notify(notification: DesktopNotification): Promise<boolean>;
+    setBadgeCount(count: number): Promise<void>;
+    setTheme(theme: DesktopThemeOptions): void;
+    setTrayQuickActions(actions: DesktopQuickAction[]): void;
+    setLocale(locale: string): void;
+    getUpdateState(): Promise<DesktopUpdateState>;
+    checkForUpdates(): Promise<DesktopUpdateState>;
+    installUpdate(): Promise<void>;
+    notifyAppReady(): Promise<void>;
+    window: {
+        minimize(): void;
+        toggleMaximize(): void;
+        close(): void;
+        hide(): void;
+        focus(): void;
+        setTitle(title: string): void;
+    };
+}
+export interface PushTokenEventDetail {
+    value: string;
+    platform: 'ios' | 'android';
 }
 declare global {
     interface Window {
         __burdenoffNativeBridge?: BurdenoffNativeBridge;
         __burdenoffDeviceInfo?: DeviceInfo;
+        __burdenoffDesktop?: BurdenoffDesktopBridge;
+        __burdenoffOpenExternal?: (url: string) => Promise<void> | void;
+        __burdenoffPushToken?: PushTokenEventDetail;
+        electronUpdater?: {
+            notifyAppReady(): Promise<unknown>;
+        };
     }
 }
 export interface KeyboardEventDetail {