@burdenoff/fe-libs 2026.819.5 → 2026.823.2

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

@@ -1,5 +1,19 @@
-import { ConfirmOptions, HapticImpactStyle, HapticNotificationType, ShareOptions, ToastDuration } from './types';
+import { ActionSheetOptions, ConfirmOptions, HapticImpactStyle, HapticNotificationType, ShareOptions, ToastDuration } from './types';
 export declare function nativeImpact(style?: HapticImpactStyle): void;
+/**
+ * Haptic selection tick (tab switch, picker/segment change). Uses the bridge's
+ * dedicated `selection()` when the shell provides it, degrading to a light
+ * impact on older shells. Web is a no-op.
+ */
+export declare function nativeSelection(): void;
+/**
+ * Present the OS-native action sheet. Resolves the chosen option index, or
+ * `null` when the native sheet is unavailable (no bridge, an older shell
+ * without `actionSheet`, or a native failure) — callers must then render the
+ * web fallback (`ActionSheet` from `@burdenoff/fe-libs/ui`, usually via
+ * `useActionSheet()` which handles the fallback automatically).
+ */
+export declare function nativeActionSheet(options: ActionSheetOptions): Promise<number | null>;
 export declare function nativeNotify(type: HapticNotificationType): void;
 export declare function nativeToast(message: string, duration?: ToastDuration): Promise<boolean>;
 export declare function nativeConfirm(options: ConfirmOptions): Promise<boolean | null>;

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

@@ -1 +1 @@
-{"version":3,"file":"consumers.d.ts","sourceRoot":"","sources":["../../../src/shared/native/consumers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,wBAAgB,YAAY,CAAC,KAAK,GAAE,iBAA2B,GAAG,IAAI,CAErE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAE/D;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAuB,GAChC,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAIpF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BnE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAazE;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9D"}
+{"version":3,"file":"consumers.d.ts","sourceRoot":"","sources":["../../../src/shared/native/consumers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,wBAAgB,YAAY,CAAC,KAAK,GAAE,iBAA2B,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAQtC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ3F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAE/D;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAuB,GAChC,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAIpF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BnE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAazE;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9D"}

package/dist/shared/native/consumers.js

@@ -3,18 +3,37 @@ import { getNativeBridge as e } from "./bridge.js";
 function t(t = "light") {
 	e()?.impact(t);
 }
-function n(t) {
+function n() {
+	let t = e();
+	if (t) {
+		if (typeof t.selection == "function") {
+			t.selection();
+			return;
+		}
+		t.impact("light");
+	}
+}
+async function r(t) {
+	let n = e();
+	if (!n || typeof n.actionSheet != "function") return null;
+	try {
+		return await n.actionSheet(t);
+	} catch {
+		return null;
+	}
+}
+function i(t) {
 	e()?.notify(t);
 }
-async function r(t, n = "short") {
+async function a(t, n = "short") {
 	let r = e();
 	return r ? r.toast(t, n) : !1;
 }
-async function i(t) {
+async function o(t) {
 	let n = e();
 	return n ? n.confirm(t) : null;
 }
-async function a(t) {
+async function s(t) {
 	let n = e();
 	if (n) return n.copyText(t);
 	try {
@@ -29,7 +48,7 @@ async function a(t) {
 		document.body.removeChild(r);
 	}
 }
-async function o(t) {
+async function c(t) {
 	let n = e();
 	if (n) return n.share(t);
 	if (typeof navigator < "u" && typeof navigator.share == "function") try {
@@ -39,11 +58,11 @@ async function o(t) {
 	}
 	return !1;
 }
-async function s(t) {
+async function l(t) {
 	if (!t.startsWith("https:") && !t.startsWith("http:")) return;
 	let n = e();
 	if (n) return n.openExternalUrl(t);
 	typeof window < "u" && window.open(t, "_blank", "noopener,noreferrer");
 }
 //#endregion
-export { i as nativeConfirm, a as nativeCopyText, t as nativeImpact, n as nativeNotify, s as nativeOpenUrl, o as nativeShare, r as nativeToast };
+export { r as nativeActionSheet, o as nativeConfirm, s as nativeCopyText, t as nativeImpact, i as nativeNotify, l as nativeOpenUrl, n as nativeSelection, c as nativeShare, a as nativeToast };

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

@@ -0,0 +1,123 @@
+import { BurdenoffDesktopBridge, DesktopNotification, DesktopPlatform, DesktopQuickAction, DesktopRuntimeConfig, DesktopThemeOptions, DesktopTitlebarMode, DesktopUpdateState, DesktopWindowState } from './types';
+import { GatewayBases } from '../utils/gatewayFetchRewrite';
+import { RuntimeGatewayUrls } from '../config/gatewayUrls';
+import { RuntimeAuthBridgeConfig } from '../config/authBridgeUrls';
+/** Legacy per-product preload global (`window.<product>Electron`). */
+export interface LegacyDesktopRuntime {
+    isElectron?: boolean;
+    platform?: string;
+    versions?: {
+        electron?: string;
+        chrome?: string;
+    };
+    runtimeConfig?: DesktopRuntimeConfig;
+    onDeepLink?: (callback: (url: string) => void) => unknown;
+    openExternal?: (url: string) => Promise<boolean> | boolean;
+}
+export interface BootDesktopShellOptions {
+    /** Router navigate used for deep links + tray/menu navigation. */
+    navigate?: (path: string) => void;
+    /** Tray / dock quick actions to publish once the bridge is up. */
+    quickActions?: DesktopQuickAction[];
+    /** Explicit legacy preload key (defaults to auto-discovery). */
+    electronGlobalKey?: string;
+}
+export interface DesktopShellHandle {
+    isDesktop: boolean;
+    platform?: DesktopPlatform;
+    titlebar?: DesktopTitlebarMode;
+}
+/** The `@burdenoff/desktop-shell` preload bridge, or null on web. */
+export declare function getDesktopBridge(): BurdenoffDesktopBridge | null;
+/**
+ * Legacy `window.<product>Electron` runtime. The product key is unknown to
+ * fe-libs, so `window` is scanned ONCE for a `*Electron` global and the result
+ * cached (a full scan on every call would be wasteful in hot paths such as
+ * `resolveGatewayUrls()`).
+ */
+export declare function getLegacyDesktopRuntime(globalKey?: string): LegacyDesktopRuntime | null;
+/** Reset the cached legacy-global lookup (tests / late preload injection). */
+export declare function resetDesktopBridgeCache(): void;
+/** True when running inside a desktop shell (new bridge or legacy preload). */
+export declare function isDesktop(): boolean;
+/** Baked desktop runtime config (bridge first, then the legacy preload). */
+export declare function getDesktopRuntimeConfig(): DesktopRuntimeConfig | null;
+/** Gateway bases from the desktop runtime config, or null on web. */
+export declare function getDesktopGatewayBases(): GatewayBases | null;
+/** Gateway URLs from the desktop runtime config, or null on web. */
+export declare function getDesktopGatewayUrls(): RuntimeGatewayUrls | null;
+/**
+ * Auth bridge config baked into the desktop build, if any.
+ *
+ * NOTE: shells must NOT initialise the cross-TLD iframe bridge in Electron —
+ * see `resolveShellAuthBridgeConfig()` in `shared/config/authBridgeUrls.ts`,
+ * which returns `undefined` on desktop. This accessor exists for tooling and
+ * diagnostics that want to see the baked value.
+ */
+export declare function getDesktopAuthBridgeConfig(): RuntimeAuthBridgeConfig | null;
+/**
+ * Open an http/https/mailto URL in the user's default browser. Falls back to
+ * `window.open` on web so callers never need to branch.
+ */
+export declare function desktopOpenExternal(url: string): Promise<boolean>;
+/**
+ * Show an OS notification. On desktop this goes through the shell (so clicks
+ * can focus the window / route). On web it uses the browser Notification API
+ * ONLY when permission was already granted — it never prompts.
+ */
+export declare function desktopNotify(notification: DesktopNotification): Promise<boolean>;
+/** Dock / taskbar badge count. Uses the PWA badging API when not on desktop. */
+export declare function desktopSetBadgeCount(count: number): Promise<void>;
+/** Tell the desktop shell which color scheme + background the UI is using. */
+export declare function desktopSetTheme(theme: DesktopThemeOptions): void;
+/** Publish tray / dock quick actions. */
+export declare function desktopSetTrayQuickActions(actions: DesktopQuickAction[]): void;
+/** Tell the desktop shell which locale the UI switched to (menus, tray). */
+export declare function desktopSetLocale(locale: string): void;
+export declare const DESKTOP_UPDATE_UNSUPPORTED: DesktopUpdateState;
+/** Subscribe to auto-update state changes. Returns an unsubscribe fn. */
+export declare function onDesktopUpdateState(cb: (state: DesktopUpdateState) => void): () => void;
+export declare function getDesktopUpdateState(): Promise<DesktopUpdateState>;
+export declare function desktopCheckForUpdates(): Promise<DesktopUpdateState>;
+/** Quit and install a downloaded update. No-op on web. */
+export declare function desktopInstallUpdate(): Promise<void>;
+type DesktopNavigator = (path: string) => void;
+/**
+ * Register the router navigate fn. Routes that arrived before the router
+ * mounted (cold-start deep links) are flushed immediately.
+ */
+export declare function registerDesktopNavigator(navigate: DesktopNavigator): () => void;
+/**
+ * Convert a deep-link URL to an in-app path.
+ *
+ * `vibecontrols://app/agents?tab=logs` → `/agents?tab=logs`
+ * `https://app.vibecontrols.com/agents` → `/agents`
+ * Already-relative values pass through unchanged.
+ */
+export declare function desktopDeepLinkToPath(rawUrl: string): string | null;
+/**
+ * Subscribe to OS deep links (`<scheme>://app/...` and universal links).
+ * Returns an unsubscribe fn.
+ */
+export declare function installDesktopDeepLinkHandler(onPath: (path: string) => void): () => void;
+/** Subscribe to in-app routes pushed by the shell (tray, menu, jump list). */
+export declare function installDesktopNavigateHandler(onRoute: (route: string) => void): () => void;
+export declare const DESKTOP_WINDOW_STATE_DEFAULT: DesktopWindowState;
+export declare function getDesktopWindowState(): DesktopWindowState;
+/** Subscribe to window focus / fullscreen / maximize changes. */
+export declare function onDesktopWindowState(cb: (state: DesktopWindowState) => void): () => void;
+/**
+ * Boot the desktop renderer integration. Idempotent — repeat calls only merge
+ * newly supplied options (navigate / quick actions).
+ *
+ * DOM contract (see `shared/styles/native.css` section 6):
+ *   `html[data-desktop-platform="darwin|win32|linux"]`
+ *   `html[data-desktop-titlebar="hidden-inset|native"]`
+ *   `html[data-desktop-fullscreen|data-desktop-focused|data-desktop-maximized]`
+ *   `body.platform-desktop`
+ */
+export declare function bootDesktopShell(opts?: BootDesktopShellOptions): DesktopShellHandle;
+/** Reset boot state (tests only). */
+export declare function resetDesktopShellBootState(): void;
+export {};
+//# sourceMappingURL=desktop.d.ts.map

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

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

package/dist/shared/native/desktop.js

@@ -0,0 +1,280 @@
+//#region src/shared/native/desktop.ts
+function e() {
+	if (typeof window > "u") return null;
+	let e = window.__burdenoffDesktop;
+	return e?.isElectron ? e : null;
+}
+var t = !1, n = null;
+function r(e) {
+	return typeof e == "object" && !!e && "isElectron" in e;
+}
+function i(e) {
+	if (typeof window > "u") return null;
+	let i = window;
+	if (e) {
+		let t = i[e];
+		return r(t) && t.isElectron === !0 ? t : null;
+	}
+	if (t || (t = !0, n = Object.keys(i).find((e) => {
+		if (!e.endsWith("Electron") || e === "Electron") return !1;
+		let t = i[e];
+		return r(t) && t.isElectron === !0;
+	}) ?? null), !n) return null;
+	let a = i[n];
+	return r(a) && a.isElectron === !0 ? a : null;
+}
+function a() {
+	return e() !== null || i() !== null;
+}
+function o() {
+	let t = e();
+	return t?.runtimeConfig ? t.runtimeConfig : i()?.runtimeConfig ?? null;
+}
+function s(e) {
+	return typeof e == "string" && e.trim().length > 0;
+}
+function c() {
+	let e = o()?.gatewayBases;
+	return !e || !s(e.globalBase) || !s(e.workspaceBase) ? null : e;
+}
+function l() {
+	let e = o()?.gatewayUrls;
+	return !e || !s(e.globalBaseUrl) || !s(e.workspaceBaseUrl) ? null : {
+		globalBaseUrl: e.globalBaseUrl,
+		workspaceBaseUrl: e.workspaceBaseUrl,
+		publicStoreBaseUrl: s(e.publicStoreBaseUrl) ? e.publicStoreBaseUrl : e.globalBaseUrl
+	};
+}
+function u() {
+	return o()?.authBridge ?? null;
+}
+var d = new Set([
+	"http:",
+	"https:",
+	"mailto:"
+]);
+function f(e) {
+	try {
+		return d.has(new URL(e).protocol);
+	} catch {
+		return !1;
+	}
+}
+async function p(t) {
+	if (!f(t)) return !1;
+	let n = e();
+	if (n) try {
+		return await n.openExternal(t);
+	} catch {
+		return !1;
+	}
+	let r = i();
+	if (typeof r?.openExternal == "function") try {
+		return await r.openExternal(t);
+	} catch {
+		return !1;
+	}
+	return typeof window > "u" ? !1 : window.open(t, "_blank", "noopener,noreferrer") !== null;
+}
+async function m(t) {
+	let n = e();
+	if (n) try {
+		return await n.notify(t);
+	} catch {
+		return !1;
+	}
+	if (typeof window > "u") return !1;
+	let r = window.Notification;
+	if (typeof r != "function" || r.permission !== "granted") return !1;
+	try {
+		return new r(t.title, {
+			body: t.body,
+			silent: t.silent,
+			tag: t.id
+		}), !0;
+	} catch {
+		return !1;
+	}
+}
+async function h(t) {
+	let n = Number.isFinite(t) && t > 0 ? Math.floor(t) : 0, r = e();
+	if (r) {
+		try {
+			await r.setBadgeCount(n);
+		} catch {}
+		return;
+	}
+	if (typeof navigator > "u") return;
+	let i = navigator;
+	try {
+		n > 0 ? await i.setAppBadge?.(n) : await i.clearAppBadge?.();
+	} catch {}
+}
+function g(t) {
+	let n = e();
+	if (n) try {
+		n.setTheme(t);
+	} catch {}
+}
+function _(t) {
+	let n = e();
+	if (n) try {
+		n.setTrayQuickActions(t);
+	} catch {}
+}
+function v(t) {
+	let n = e();
+	if (!(!n || !s(t))) try {
+		n.setLocale(t);
+	} catch {}
+}
+var y = { status: "unsupported" };
+function b(t) {
+	let n = e();
+	if (!n) return () => {};
+	try {
+		return n.onUpdateState(t);
+	} catch {
+		return () => {};
+	}
+}
+async function x() {
+	let t = e();
+	if (!t) return y;
+	try {
+		return await t.getUpdateState();
+	} catch {
+		return y;
+	}
+}
+async function S() {
+	let t = e();
+	if (!t) return y;
+	try {
+		return await t.checkForUpdates();
+	} catch (e) {
+		return {
+			status: "error",
+			error: e instanceof Error ? e.message : String(e)
+		};
+	}
+}
+async function C() {
+	let t = e();
+	if (t) try {
+		await t.installUpdate();
+	} catch {}
+}
+var w = null, T = [];
+function E() {
+	if (!w || T.length === 0) return;
+	let e = T;
+	T = [];
+	for (let t of e) w(t);
+}
+function D(e) {
+	if (e) {
+		if (w) {
+			w(e);
+			return;
+		}
+		T.push(e);
+	}
+}
+function O(e) {
+	return w = e, E(), () => {
+		w === e && (w = null);
+	};
+}
+function k(e) {
+	if (!s(e)) return null;
+	let t = e.trim();
+	if (t.startsWith("/")) return t;
+	try {
+		let e = new URL(t), n = e.pathname && e.pathname !== "" ? e.pathname : "/";
+		return `${n.startsWith("/") ? n : `/${n}`}${e.search}${e.hash}`;
+	} catch {
+		return null;
+	}
+}
+function A(t) {
+	let n = (e) => {
+		let n = k(e);
+		n && t(n);
+	}, r = [], a = e();
+	if (a) try {
+		r.push(a.onDeepLink(n));
+	} catch {}
+	let o = i();
+	if (o && typeof o.onDeepLink == "function") try {
+		let e = o.onDeepLink(n);
+		typeof e == "function" && r.push(e);
+	} catch {}
+	return () => {
+		for (let e of r) try {
+			e();
+		} catch {}
+	};
+}
+function j(t) {
+	let n = e();
+	if (!n) return () => {};
+	try {
+		return n.onNavigate((e) => {
+			let n = k(e) ?? (e.startsWith("/") ? e : null);
+			n && t(n);
+		});
+	} catch {
+		return () => {};
+	}
+}
+var M = {
+	focused: !0,
+	fullScreen: !1,
+	maximized: !1
+}, N = M, P = /* @__PURE__ */ new Set();
+function F() {
+	return N;
+}
+function I(e) {
+	return P.add(e), () => {
+		P.delete(e);
+	};
+}
+function L(e) {
+	N = e;
+	let t = typeof document > "u" ? null : document.documentElement;
+	t && (t.dataset.desktopFullscreen = e.fullScreen ? "true" : "false", t.dataset.desktopFocused = e.focused ? "true" : "false", t.dataset.desktopMaximized = e.maximized ? "true" : "false");
+	for (let t of P) try {
+		t(e);
+	} catch {}
+}
+var R = null;
+function z(t = {}) {
+	if (t.navigate && O(t.navigate), R) return t.quickActions?.length && _(t.quickActions), R;
+	let n = e(), r = n ? null : i(t.electronGlobalKey);
+	if (!n && !r) return { isDesktop: !1 };
+	let a = n?.platform, o = n?.titlebar;
+	if (R = {
+		isDesktop: !0,
+		platform: a,
+		titlebar: o
+	}, typeof document < "u") {
+		let e = document.documentElement;
+		e.dataset.desktopPlatform = a ?? (r?.platform || "linux"), e.dataset.desktopTitlebar = o ?? "native", document.body?.classList.add("platform-desktop");
+	}
+	if (n) try {
+		n.onWindowState(L);
+	} catch {}
+	if (L(N), A(D), j(D), t.quickActions?.length && _(t.quickActions), typeof window < "u" && !window.__burdenoffOpenExternal && (window.__burdenoffOpenExternal = (e) => {
+		p(e);
+	}), n) {
+		let e = () => {
+			n.notifyAppReady().catch(() => void 0);
+		};
+		typeof requestAnimationFrame == "function" ? requestAnimationFrame(e) : e();
+	}
+	return R;
+}
+//#endregion
+export { y as DESKTOP_UPDATE_UNSUPPORTED, M as DESKTOP_WINDOW_STATE_DEFAULT, z as bootDesktopShell, S as desktopCheckForUpdates, k as desktopDeepLinkToPath, C as desktopInstallUpdate, m as desktopNotify, p as desktopOpenExternal, h as desktopSetBadgeCount, v as desktopSetLocale, g as desktopSetTheme, _ as desktopSetTrayQuickActions, u as getDesktopAuthBridgeConfig, e as getDesktopBridge, c as getDesktopGatewayBases, l as getDesktopGatewayUrls, o as getDesktopRuntimeConfig, x as getDesktopUpdateState, F as getDesktopWindowState, i as getLegacyDesktopRuntime, A as installDesktopDeepLinkHandler, j as installDesktopNavigateHandler, a as isDesktop, b as onDesktopUpdateState, I as onDesktopWindowState, O as registerDesktopNavigator };

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

@@ -0,0 +1,39 @@
+/**
+ * Native entry — the installed-app equivalent of the web marketing landing.
+ *
+ * Installed apps (Capacitor native, installed/standalone PWA, Electron
+ * desktop) must never show the logged-out web marketing landing: app stores
+ * reject marketing walls, and an installed app should open straight into a
+ * focused sign-in surface. Shells branch their logged-out route on
+ * `shouldShowNativeWelcome()` and render `<NativeWelcome/>`
+ * (`@burdenoff/fe-libs/ui`) instead of `ModernLanding`.
+ *
+ * @example
+ * ```tsx
+ * // AppRoutes.tsx (logged-out landing route)
+ * if (shouldShowNativeWelcome()) {
+ *   const routes = getNativeEntryRoutes();
+ *   return (
+ *     <NativeWelcome
+ *       onSignIn={() => navigate(routes.signIn)}
+ *       onCreateAccount={() => navigate(routes.createAccount)}
+ *     />
+ *   );
+ * }
+ * return <ModernLanding ... />;
+ * ```
+ */
+export declare function shouldShowNativeWelcome(): boolean;
+export interface NativeEntryRoutes {
+    /** In-app route for the primary "Sign in" CTA. */
+    signIn: string;
+    /** In-app route for the secondary "Create account" CTA. */
+    createAccount: string;
+}
+/**
+ * Canonical in-app auth routes for the native welcome CTAs. Every product
+ * shell hosts microfe-auth on these paths, so the welcome screen can navigate
+ * without per-shell wiring.
+ */
+export declare function getNativeEntryRoutes(): NativeEntryRoutes;
+//# sourceMappingURL=entry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../src/shared/native/entry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD"}

package/dist/shared/native/entry.js

@@ -0,0 +1,13 @@
+import { isInstalledApp as e } from "./platform.js";
+//#region src/shared/native/entry.ts
+function t() {
+	return e();
+}
+function n() {
+	return {
+		signIn: "/auth/login",
+		createAccount: "/auth/register"
+	};
+}
+//#endregion
+export { n as getNativeEntryRoutes, t as shouldShowNativeWelcome };

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

@@ -9,4 +9,14 @@ export { useHaptics } from './useHaptics';
 export type { UseHapticsResult } from './useHaptics';
 export { useStatusBar } from './useStatusBar';
 export type { UseStatusBarResult } from './useStatusBar';
+export { useNetworkStatus, reduceNetworkStatus, readInitialNetworkStatus, } from './useNetworkStatus';
+export type { NetworkStatus } from './useNetworkStatus';
+export { usePullToRefresh, computePullProgress, computePullOffset, PULL_TO_REFRESH_THRESHOLD, } from './usePullToRefresh';
+export type { UsePullToRefreshOptions, UsePullToRefreshResult, PullToRefreshBind, } from './usePullToRefresh';
+export { useActionSheet, resolveActionSheetOutcome } from './useActionSheet';
+export type { UseActionSheetResult, ShowActionSheetOptions, ActionSheetHostProps, ActionSheetOutcome, } from './useActionSheet';
+export { useDesktop } from './useDesktop';
+export type { UseDesktopResult } from './useDesktop';
+export { useDesktopUpdateState } from './useDesktopUpdateState';
+export { useDesktopWindowState } from './useDesktopWindowState';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -1,3 +1,5 @@
+import "./useNetworkStatus.js";
+import "./usePullToRefresh.js";
 import "./useNativePlatform.js";
 import "./useSafeArea.js";
 import "./useNativeKeyboard.js";
@@ -5,3 +7,7 @@ import "./useAppState.js";
 import "./useDeviceInfo.js";
 import "./useHaptics.js";
 import "./useStatusBar.js";
+import "./useActionSheet.js";
+import "./useDesktop.js";
+import "./useDesktopUpdateState.js";
+import "./useDesktopWindowState.js";

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

@@ -0,0 +1,63 @@
+import { ActionSheetButton, ActionSheetOptions } from '../types';
+/**
+ * Where a `useActionSheet().show()` call must be answered from.
+ *
+ * `native` — the OS sheet handled it; `index` is the (validated) chosen option
+ * or `null` when the native layer returned something unusable.
+ * `fallback` — no native sheet is available; render the web `ActionSheet`.
+ */
+export type ActionSheetOutcome = {
+    source: 'native';
+    index: number | null;
+} | {
+    source: 'fallback';
+};
+/**
+ * Pure resolution of a bridge `actionSheet()` result. Kept separate from the
+ * hook so the native/web decision is unit-testable without a DOM.
+ */
+export declare function resolveActionSheetOutcome(nativeIndex: number | null, optionCount: number): ActionSheetOutcome;
+export interface ShowActionSheetOptions extends ActionSheetOptions {
+    /** Cancel row label for the web fallback sheet. Default "Cancel". */
+    cancelLabel?: string;
+}
+/** Props to spread onto the web `<ActionSheet />` fallback. */
+export interface ActionSheetHostProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title?: string;
+    message?: string;
+    options: ActionSheetButton[];
+    cancelLabel?: string;
+    onSelect: (index: number) => void;
+}
+export interface UseActionSheetResult {
+    /**
+     * Present the sheet. Resolves the chosen option index, or `null` when the
+     * user dismissed/cancelled it.
+     */
+    show: (options: ShowActionSheetOptions) => Promise<number | null>;
+    /** Spread onto `<ActionSheet {...sheetProps} />` inside the calling component. */
+    sheetProps: ActionSheetHostProps;
+}
+/**
+ * Native-first action sheet. On Capacitor shells the OS sheet is used; on web
+ * (and on older shells without `bridge.actionSheet`) it falls back to the
+ * token-styled `ActionSheet` bottom sheet, which the caller renders:
+ *
+ * @example
+ * ```tsx
+ * const { show, sheetProps } = useActionSheet();
+ * const onMore = async () => {
+ *   const index = await show({
+ *     title: 'Agent',
+ *     options: [{ title: 'Rename' }, { title: 'Delete', style: 'destructive' }],
+ *   });
+ *   if (index === 0) rename();
+ *   if (index === 1) remove();
+ * };
+ * return <><Button onClick={onMore}>More</Button><ActionSheet {...sheetProps} /></>;
+ * ```
+ */
+export declare function useActionSheet(): UseActionSheetResult;
+//# sourceMappingURL=useActionSheet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useActionSheet.d.ts","sourceRoot":"","sources":["../../../../src/shared/native/hooks/useActionSheet.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAMpB;AAED,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClE,kFAAkF;IAClF,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CA8CrD"}