electrobun 1.16.0 → 1.17.0-beta.0

package/dist/api/bun/proc/native.ts

@@ -705,30 +705,108 @@ export const native = (() => {
 			// },
 		});
 	} catch (err) {
-		console.log("FATAL Error opening native FFI:", (err as Error).message);
-		console.log("This may be due to:");
-		console.log("  - Missing libNativeWrapper.dll/so/dylib");
-		console.log("  - Architecture mismatch (ARM64 vs x64)");
-		console.log("  - Missing WebView2 or CEF dependencies");
-		if (suffix === "so") {
-			console.log(
-				"  - Missing system libraries (try: ldd ./libNativeWrapper.so)",
-			);
-		}
-		console.log(
-			"Check that the build process completed successfully for your architecture.",
-		);
-		process.exit();
+		// FFI not available — running as a carrot inside Bunny Ears or in a build-only context.
+		return null;
 	}
 })();
 
+export const hasFFI = native !== null;
+
+// PostMessage bridge for carrot workers (inter-carrot communication, host events).
+// Created when __bunnyCarrotBootstrap exists, regardless of FFI availability.
+class PostMessageBridge {
+	private requestId = 0;
+	private pendingRequests = new Map<number, {
+		resolve: (value: unknown) => void;
+		reject: (error: Error) => void;
+	}>();
+	private eventHandlers = new Map<string, Set<(payload: unknown) => void>>();
+
+	constructor() {
+		if (typeof self !== "undefined" && typeof self.addEventListener === "function") {
+			self.addEventListener("message", (event: MessageEvent) => {
+				this.handleMessage(event.data);
+			});
+		}
+	}
+
+	sendAction(action: string, payload?: unknown) {
+		self.postMessage({ type: "action", action, payload });
+	}
+
+	requestHost<T = unknown>(method: string, params?: unknown): Promise<T> {
+		const id = ++this.requestId;
+		self.postMessage({ type: "host-request", requestId: id, method, params });
+		return new Promise<T>((resolve, reject) => {
+			this.pendingRequests.set(id, {
+				resolve: (v) => resolve(v as T),
+				reject,
+			});
+		});
+	}
+
+	on(name: string, handler: (payload: unknown) => void) {
+		const handlers = this.eventHandlers.get(name) ?? new Set();
+		handlers.add(handler);
+		this.eventHandlers.set(name, handlers);
+		return () => {
+			handlers.delete(handler);
+			if (handlers.size === 0) this.eventHandlers.delete(name);
+		};
+	}
+
+	emit(name: string, payload: unknown) {
+		this.eventHandlers.get(name)?.forEach((h) => {
+			try { h(payload); } catch (e) { console.error(`[bridge] event handler failed: ${name}`, e); }
+		});
+	}
+
+	private handleMessage(message: any) {
+		if (!message || typeof message !== "object" || !("type" in message)) return;
+
+		if (message.type === "host-response") {
+			const pending = this.pendingRequests.get(message.requestId);
+			if (!pending) return;
+			this.pendingRequests.delete(message.requestId);
+			if (message.success) {
+				pending.resolve(message.payload);
+			} else {
+				pending.reject(new Error(message.error || "Host request failed"));
+			}
+		} else if (message.type === "event") {
+			this.emit(message.name, message.payload);
+		} else if (message.type === "init") {
+			this.emit("init", message);
+		}
+	}
+}
+
+const isCarrotWorker = !!(globalThis as any).__bunnyCarrotBootstrap;
+export const bridge: PostMessageBridge | null = isCarrotWorker ? new PostMessageBridge() : null;
+
+// Proxy wrapper: routes ffi.request calls through FFI when available,
+// or through the postMessage bridge when running as a carrot without FFI.
+function createFfiRequestProxy(ffiRequest: Record<string, Function>): Record<string, Function> {
+	if (hasFFI) return ffiRequest;
+
+	return new Proxy(ffiRequest, {
+		get(target, method: string) {
+			if (typeof method !== "string") return target[method];
+			return (params?: unknown) => bridge!.requestHost(method, params);
+		},
+	});
+}
+
 // const _callbacks: unknown[] = [];
 
 // NOTE: Bun seems to hit limits on args or arg types. eg: trying to send 12 bools results
 // in only about 8 going through then params after that. I think it may be similar to
 // a zig bug I ran into last year. So check number of args in a signature when alignment issues occur.
 
-export const ffi = {
+// Non-null accessor for use inside _ffiImpl — these methods are only called when hasFFI is true.
+const native_ = native!;
+
+const _ffiImpl = {
 	request: {
 		createWindow: (params: {
 			id: number;
@@ -782,7 +860,7 @@ export const ffi = {
 				hidden = false,
 			} = params;
 
-			const styleMask = native.symbols.getWindowStyle(
+			const styleMask = native_.symbols.getWindowStyle(
 				Borderless,
 				Titled,
 				Closable,
@@ -797,7 +875,7 @@ export const ffi = {
 				HUDWindow,
 			);
 
-			const windowPtr = native.symbols.createWindowWithFrameAndStyleFromWorker(
+			const windowPtr = native_.symbols.createWindowWithFrameAndStyleFromWorker(
 				id,
 				// frame
 				x,
@@ -821,9 +899,9 @@ export const ffi = {
 				throw "Failed to create window";
 			}
 
-			native.symbols.setWindowTitle(windowPtr, toCString(title));
+			native_.symbols.setWindowTitle(windowPtr, toCString(title));
 			if (!hidden) {
-				native.symbols.showWindow(windowPtr);
+				native_.symbols.showWindow(windowPtr);
 			}
 
 			return windowPtr;
@@ -836,7 +914,7 @@ export const ffi = {
 				throw `Can't add webview to window. window no longer exists`;
 			}
 
-			native.symbols.setWindowTitle(windowPtr, toCString(title));
+			native_.symbols.setWindowTitle(windowPtr, toCString(title));
 		},
 
 		closeWindow: (params: { winId: number }) => {
@@ -848,7 +926,7 @@ export const ffi = {
 				return;
 			}
 
-			native.symbols.closeWindow(windowPtr);
+			native_.symbols.closeWindow(windowPtr);
 			// Note: Cleanup of BrowserWindowMap happens in the windowCloseCallback
 		},
 
@@ -860,7 +938,7 @@ export const ffi = {
 				throw `Can't focus window. Window no longer exists`;
 			}
 
-			native.symbols.showWindow(windowPtr);
+			native_.symbols.showWindow(windowPtr);
 		},
 
 		minimizeWindow: (params: { winId: number }) => {
@@ -871,7 +949,7 @@ export const ffi = {
 				throw `Can't minimize window. Window no longer exists`;
 			}
 
-			native.symbols.minimizeWindow(windowPtr);
+			native_.symbols.minimizeWindow(windowPtr);
 		},
 
 		restoreWindow: (params: { winId: number }) => {
@@ -882,7 +960,7 @@ export const ffi = {
 				throw `Can't restore window. Window no longer exists`;
 			}
 
-			native.symbols.restoreWindow(windowPtr);
+			native_.symbols.restoreWindow(windowPtr);
 		},
 
 		isWindowMinimized: (params: { winId: number }): boolean => {
@@ -893,7 +971,7 @@ export const ffi = {
 				return false;
 			}
 
-			return native.symbols.isWindowMinimized(windowPtr);
+			return native_.symbols.isWindowMinimized(windowPtr);
 		},
 
 		maximizeWindow: (params: { winId: number }) => {
@@ -904,7 +982,7 @@ export const ffi = {
 				throw `Can't maximize window. Window no longer exists`;
 			}
 
-			native.symbols.maximizeWindow(windowPtr);
+			native_.symbols.maximizeWindow(windowPtr);
 		},
 
 		unmaximizeWindow: (params: { winId: number }) => {
@@ -915,7 +993,7 @@ export const ffi = {
 				throw `Can't unmaximize window. Window no longer exists`;
 			}
 
-			native.symbols.unmaximizeWindow(windowPtr);
+			native_.symbols.unmaximizeWindow(windowPtr);
 		},
 
 		isWindowMaximized: (params: { winId: number }): boolean => {
@@ -926,7 +1004,7 @@ export const ffi = {
 				return false;
 			}
 
-			return native.symbols.isWindowMaximized(windowPtr);
+			return native_.symbols.isWindowMaximized(windowPtr);
 		},
 
 		setWindowFullScreen: (params: { winId: number; fullScreen: boolean }) => {
@@ -937,7 +1015,7 @@ export const ffi = {
 				throw `Can't set fullscreen. Window no longer exists`;
 			}
 
-			native.symbols.setWindowFullScreen(windowPtr, fullScreen);
+			native_.symbols.setWindowFullScreen(windowPtr, fullScreen);
 		},
 
 		isWindowFullScreen: (params: { winId: number }): boolean => {
@@ -948,7 +1026,7 @@ export const ffi = {
 				return false;
 			}
 
-			return native.symbols.isWindowFullScreen(windowPtr);
+			return native_.symbols.isWindowFullScreen(windowPtr);
 		},
 
 		setWindowAlwaysOnTop: (params: { winId: number; alwaysOnTop: boolean }) => {
@@ -959,7 +1037,7 @@ export const ffi = {
 				throw `Can't set always on top. Window no longer exists`;
 			}
 
-			native.symbols.setWindowAlwaysOnTop(windowPtr, alwaysOnTop);
+			native_.symbols.setWindowAlwaysOnTop(windowPtr, alwaysOnTop);
 		},
 
 		isWindowAlwaysOnTop: (params: { winId: number }): boolean => {
@@ -970,7 +1048,7 @@ export const ffi = {
 				return false;
 			}
 
-			return native.symbols.isWindowAlwaysOnTop(windowPtr);
+			return native_.symbols.isWindowAlwaysOnTop(windowPtr);
 		},
 
 		setWindowVisibleOnAllWorkspaces: (params: {
@@ -984,7 +1062,7 @@ export const ffi = {
 				throw `Can't set visible on all workspaces. Window no longer exists`;
 			}
 
-			native.symbols.setWindowVisibleOnAllWorkspaces(
+			native_.symbols.setWindowVisibleOnAllWorkspaces(
 				windowPtr,
 				visibleOnAllWorkspaces,
 			);
@@ -998,7 +1076,7 @@ export const ffi = {
 				return false;
 			}
 
-			return native.symbols.isWindowVisibleOnAllWorkspaces(windowPtr);
+			return native_.symbols.isWindowVisibleOnAllWorkspaces(windowPtr);
 		},
 
 		setWindowPosition: (params: { winId: number; x: number; y: number }) => {
@@ -1009,7 +1087,7 @@ export const ffi = {
 				throw `Can't set window position. Window no longer exists`;
 			}
 
-			native.symbols.setWindowPosition(windowPtr, x, y);
+			native_.symbols.setWindowPosition(windowPtr, x, y);
 		},
 
 		setWindowSize: (params: {
@@ -1024,7 +1102,7 @@ export const ffi = {
 				throw `Can't set window size. Window no longer exists`;
 			}
 
-			native.symbols.setWindowSize(windowPtr, width, height);
+			native_.symbols.setWindowSize(windowPtr, width, height);
 		},
 
 		setWindowFrame: (params: {
@@ -1041,7 +1119,7 @@ export const ffi = {
 				throw `Can't set window frame. Window no longer exists`;
 			}
 
-			native.symbols.setWindowFrame(windowPtr, x, y, width, height);
+			native_.symbols.setWindowFrame(windowPtr, x, y, width, height);
 		},
 
 		getWindowFrame: (params: {
@@ -1060,7 +1138,7 @@ export const ffi = {
 			const widthBuf = new Float64Array(1);
 			const heightBuf = new Float64Array(1);
 
-			native.symbols.getWindowFrame(
+			native_.symbols.getWindowFrame(
 				windowPtr,
 				ptr(xBuf),
 				ptr(yBuf),
@@ -1172,8 +1250,8 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 			const customPreload = preload;
 
 			// Pre-set flags before initWebview (workaround for FFI param count limits)
-			native.symbols.setNextWebviewFlags(startTransparent, startPassthrough);
-			const webviewPtr = native.symbols.initWebview(
+			native_.symbols.setNextWebviewFlags(startTransparent, startPassthrough);
+			const webviewPtr = native_.symbols.initWebview(
 				id,
 				windowPtr,
 				toCString(renderer),
@@ -1230,7 +1308,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				throw `Can't add WGPUView to window. window no longer exists`;
 			}
 
-			const viewPtr = native.symbols.initWGPUView(
+			const viewPtr = native_.symbols.initWGPUView(
 				id,
 				windowPtr,
 				x,
@@ -1264,7 +1342,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return;
 			}
 
-			native.symbols.wgpuViewSetFrame(
+			native_.symbols.wgpuViewSetFrame(
 				view.ptr,
 				params.x,
 				params.y,
@@ -1282,7 +1360,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return;
 			}
 
-			native.symbols.wgpuViewSetTransparent(view.ptr, params.transparent);
+			native_.symbols.wgpuViewSetTransparent(view.ptr, params.transparent);
 		},
 
 		wgpuViewSetPassthrough: (params: {
@@ -1297,7 +1375,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return;
 			}
 
-			native.symbols.wgpuViewSetPassthrough(view.ptr, params.passthrough);
+			native_.symbols.wgpuViewSetPassthrough(view.ptr, params.passthrough);
 		},
 
 		wgpuViewSetHidden: (params: { id: number; hidden: boolean }) => {
@@ -1309,7 +1387,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return;
 			}
 
-			native.symbols.wgpuViewSetHidden(view.ptr, params.hidden);
+			native_.symbols.wgpuViewSetHidden(view.ptr, params.hidden);
 		},
 
 		wgpuViewRemove: (params: { id: number }) => {
@@ -1321,7 +1399,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return;
 			}
 
-			native.symbols.wgpuViewRemove(view.ptr);
+			native_.symbols.wgpuViewRemove(view.ptr);
 		},
 		wgpuViewGetNativeHandle: (params: { id: number }): Pointer | null => {
 			const view = WGPUView.getById(params.id);
@@ -1332,7 +1410,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return null;
 			}
 
-			const handle = native.symbols.wgpuViewGetNativeHandle(view.ptr);
+			const handle = native_.symbols.wgpuViewGetNativeHandle(view.ptr);
 			return handle || null;
 		},
 
@@ -1347,7 +1425,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return;
 			}
 
-			native.symbols.evaluateJavaScriptWithNoCompletion(
+			native_.symbols.evaluateJavaScriptWithNoCompletion(
 				webview.ptr,
 				toCString(js),
 			);
@@ -1363,7 +1441,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 		}): FFIType.ptr => {
 			const { id, title, image, template, width, height } = params;
 
-			const trayPtr = native.symbols.createTray(
+			const trayPtr = native_.symbols.createTray(
 				id,
 				toCString(title),
 				toCString(image),
@@ -1385,7 +1463,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 			const tray = Tray.getById(id);
 			if (!tray) return;
 
-			native.symbols.setTrayTitle(tray.ptr, toCString(title));
+			native_.symbols.setTrayTitle(tray.ptr, toCString(title));
 		},
 		setTrayImage: (params: { id: number; image: string }): void => {
 			const { id, image } = params;
@@ -1393,7 +1471,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 			const tray = Tray.getById(id);
 			if (!tray) return;
 
-			native.symbols.setTrayImage(tray.ptr, toCString(image));
+			native_.symbols.setTrayImage(tray.ptr, toCString(image));
 		},
 		setTrayMenu: (params: {
 			id: number;
@@ -1405,7 +1483,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 			const tray = Tray.getById(id);
 			if (!tray) return;
 
-			native.symbols.setTrayMenu(tray.ptr, toCString(menuConfig));
+			native_.symbols.setTrayMenu(tray.ptr, toCString(menuConfig));
 		},
 
 		removeTray: (params: { id: number }): void => {
@@ -1416,7 +1494,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				throw `Can't remove tray. Tray no longer exists`;
 			}
 
-			native.symbols.removeTray(tray.ptr);
+			native_.symbols.removeTray(tray.ptr);
 			// The Tray class will handle removing from TrayMap
 		},
 		getTrayBounds: (params: { id: number }): Rectangle => {
@@ -1425,7 +1503,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				return { x: 0, y: 0, width: 0, height: 0 };
 			}
 
-			const jsonStr = native.symbols.getTrayBounds(tray.ptr);
+			const jsonStr = native_.symbols.getTrayBounds(tray.ptr);
 			if (!jsonStr) {
 				return { x: 0, y: 0, width: 0, height: 0 };
 			}
@@ -1439,7 +1517,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 		setApplicationMenu: (params: { menuConfig: string }): void => {
 			const { menuConfig } = params;
 
-			native.symbols.setApplicationMenu(
+			native_.symbols.setApplicationMenu(
 				toCString(menuConfig),
 				applicationMenuHandler,
 			);
@@ -1447,25 +1525,25 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 		showContextMenu: (params: { menuConfig: string }): void => {
 			const { menuConfig } = params;
 
-			native.symbols.showContextMenu(toCString(menuConfig), contextMenuHandler);
+			native_.symbols.showContextMenu(toCString(menuConfig), contextMenuHandler);
 		},
 		moveToTrash: (params: { path: string }): boolean => {
 			const { path } = params;
 
-			return native.symbols.moveToTrash(toCString(path));
+			return native_.symbols.moveToTrash(toCString(path));
 		},
 		showItemInFolder: (params: { path: string }): void => {
 			const { path } = params;
 
-			native.symbols.showItemInFolder(toCString(path));
+			native_.symbols.showItemInFolder(toCString(path));
 		},
 		openExternal: (params: { url: string }): boolean => {
 			const { url } = params;
-			return native.symbols.openExternal(toCString(url));
+			return native_.symbols.openExternal(toCString(url));
 		},
 		openPath: (params: { path: string }): boolean => {
 			const { path } = params;
-			return native.symbols.openPath(toCString(path));
+			return native_.symbols.openPath(toCString(path));
 		},
 		showNotification: (params: {
 			title: string;
@@ -1474,7 +1552,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 			silent?: boolean;
 		}): void => {
 			const { title, body = "", subtitle = "", silent = false } = params;
-			native.symbols.showNotification(
+			native_.symbols.showNotification(
 				toCString(title),
 				toCString(body),
 				toCString(subtitle),
@@ -1482,10 +1560,10 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 			);
 		},
 		setDockIconVisible: (params: { visible: boolean }): void => {
-			native.symbols.setDockIconVisible(params.visible);
+			native_.symbols.setDockIconVisible(params.visible);
 		},
 		isDockIconVisible: (): boolean => {
-			return native.symbols.isDockIconVisible();
+			return native_.symbols.isDockIconVisible();
 		},
 		openFileDialog: (params: {
 			startingFolder: string;
@@ -1501,7 +1579,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 				canChooseDirectory,
 				allowsMultipleSelection,
 			} = params;
-			const filePath = native.symbols.openFileDialog(
+			const filePath = native_.symbols.openFileDialog(
 				toCString(startingFolder),
 				toCString(allowedFileTypes),
 				canChooseFiles ? 1 : 0,
@@ -1531,7 +1609,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 			} = params;
 			// Convert buttons array to comma-separated string
 			const buttonsStr = buttons.join(",");
-			return native.symbols.showMessageBox(
+			return native_.symbols.showMessageBox(
 				toCString(type),
 				toCString(title),
 				toCString(message),
@@ -1544,17 +1622,17 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 
 		// Clipboard API
 		clipboardReadText: (): string | null => {
-			const result = native.symbols.clipboardReadText();
+			const result = native_.symbols.clipboardReadText();
 			if (!result) return null;
 			return result.toString();
 		},
 		clipboardWriteText: (params: { text: string }): void => {
-			native.symbols.clipboardWriteText(toCString(params.text));
+			native_.symbols.clipboardWriteText(toCString(params.text));
 		},
 		clipboardReadImage: (): Uint8Array | null => {
 			// Allocate a buffer for the size output
 			const sizeBuffer = new BigUint64Array(1);
-			const dataPtr = native.symbols.clipboardReadImage(ptr(sizeBuffer));
+			const dataPtr = native_.symbols.clipboardReadImage(ptr(sizeBuffer));
 
 			if (!dataPtr) return null;
 
@@ -1574,13 +1652,13 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 		},
 		clipboardWriteImage: (params: { pngData: Uint8Array }): void => {
 			const { pngData } = params;
-			native.symbols.clipboardWriteImage(ptr(pngData), BigInt(pngData.length));
+			native_.symbols.clipboardWriteImage(ptr(pngData), BigInt(pngData.length));
 		},
 		clipboardClear: (): void => {
-			native.symbols.clipboardClear();
+			native_.symbols.clipboardClear();
 		},
 		clipboardAvailableFormats: (): string[] => {
-			const result = native.symbols.clipboardAvailableFormats();
+			const result = native_.symbols.clipboardAvailableFormats();
 			if (!result) return [];
 			const formatsStr = result.toString();
 			if (!formatsStr) return [];
@@ -1592,7 +1670,7 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 
 		//   } = params;
 
-		//   native.symbols.ffifunc(
+		//   native_.symbols.ffifunc(
 
 		//   );
 		// },
@@ -1607,27 +1685,32 @@ window.__electrobunBunBridge = window.__electrobunBunBridge || window.webkit?.me
 	},
 };
 
+export const ffi = {
+	request: createFfiRequestProxy(_ffiImpl.request as unknown as Record<string, Function>) as typeof _ffiImpl.request,
+	internal: _ffiImpl.internal,
+};
+
 export const WGPUBridge = {
 	available: !!native?.symbols?.wgpuInstanceCreateSurfaceMainThread,
 	instanceCreateSurface: (instancePtr: Pointer, descriptorPtr: Pointer): Pointer =>
-		native.symbols.wgpuInstanceCreateSurfaceMainThread(
+		native_.symbols.wgpuInstanceCreateSurfaceMainThread(
 			instancePtr as any,
 			descriptorPtr as any,
 		) as Pointer,
 	surfaceConfigure: (surfacePtr: Pointer, configPtr: Pointer) =>
-		native.symbols.wgpuSurfaceConfigureMainThread(
+		native_.symbols.wgpuSurfaceConfigureMainThread(
 			surfacePtr as any,
 			configPtr as any,
 		),
 	surfaceGetCurrentTexture: (surfacePtr: Pointer, surfaceTexturePtr: Pointer) =>
-		native.symbols.wgpuSurfaceGetCurrentTextureMainThread(
+		native_.symbols.wgpuSurfaceGetCurrentTextureMainThread(
 			surfacePtr as any,
 			surfaceTexturePtr as any,
 		),
 	surfacePresent: (surfacePtr: Pointer): number =>
-		native.symbols.wgpuSurfacePresentMainThread(surfacePtr as any),
+		native_.symbols.wgpuSurfacePresentMainThread(surfacePtr as any),
 	queueOnSubmittedWorkDone: (queuePtr: Pointer, callbackInfoPtr: Pointer): bigint =>
-		native.symbols.wgpuQueueOnSubmittedWorkDoneShim(
+		native_.symbols.wgpuQueueOnSubmittedWorkDoneShim(
 			queuePtr as any,
 			callbackInfoPtr as any,
 		),
@@ -1638,7 +1721,7 @@ export const WGPUBridge = {
 		size: bigint,
 		callbackInfoPtr: Pointer,
 	): bigint =>
-		native.symbols.wgpuBufferMapAsyncShim(
+		native_.symbols.wgpuBufferMapAsyncShim(
 			bufferPtr as any,
 			mode as any,
 			offset as any,
@@ -1650,7 +1733,7 @@ export const WGPUBridge = {
 		futureId: bigint,
 		timeoutNs: bigint,
 	): number =>
-		native.symbols.wgpuInstanceWaitAnyShim(
+		native_.symbols.wgpuInstanceWaitAnyShim(
 			instancePtr as any,
 			futureId as any,
 			timeoutNs as any,
@@ -1663,7 +1746,7 @@ export const WGPUBridge = {
 		timeoutNs: bigint,
 		outSizePtr: Pointer,
 	): Pointer =>
-		native.symbols.wgpuBufferReadSyncShim(
+		native_.symbols.wgpuBufferReadSyncShim(
 			instancePtr as any,
 			bufferPtr as any,
 			offset as any,
@@ -1679,7 +1762,7 @@ export const WGPUBridge = {
 		timeoutNs: bigint,
 		dstPtr: Pointer,
 	): number =>
-		native.symbols.wgpuBufferReadSyncIntoShim(
+		native_.symbols.wgpuBufferReadSyncIntoShim(
 			instancePtr as any,
 			bufferPtr as any,
 			offset as any,
@@ -1693,16 +1776,16 @@ export const WGPUBridge = {
 		size: bigint,
 		dstPtr: Pointer,
 	): Pointer =>
-		native.symbols.wgpuBufferReadbackBeginShim(
+		native_.symbols.wgpuBufferReadbackBeginShim(
 			bufferPtr as any,
 			offset as any,
 			size as any,
 			dstPtr as any,
 		) as Pointer,
 	bufferReadbackStatus: (jobPtr: Pointer): number =>
-		native.symbols.wgpuBufferReadbackStatusShim(jobPtr as any),
+		native_.symbols.wgpuBufferReadbackStatusShim(jobPtr as any),
 	bufferReadbackFree: (jobPtr: Pointer) =>
-		native.symbols.wgpuBufferReadbackFreeShim(jobPtr as any),
+		native_.symbols.wgpuBufferReadbackFreeShim(jobPtr as any),
 	runTest: (viewId: number) => {
 		const view = WGPUView.getById(viewId);
 		if (!view?.ptr) {
@@ -1713,31 +1796,34 @@ export const WGPUBridge = {
 			console.error("wgpuRunGPUTest not available");
 			return;
 		}
-		native.symbols.wgpuRunGPUTest(view.ptr);
+		native_.symbols.wgpuRunGPUTest(view.ptr);
 	},
 	createAdapterDeviceMainThread: (
 		instancePtr: Pointer,
 		surfacePtr: Pointer,
 		outAdapterDevicePtr: Pointer,
 	) =>
-		native.symbols.wgpuCreateAdapterDeviceMainThread(
+		native_.symbols.wgpuCreateAdapterDeviceMainThread(
 			instancePtr as any,
 			surfacePtr as any,
 			outAdapterDevicePtr as any,
 		),
 	createSurfaceForView: (instancePtr: Pointer, viewPtr: Pointer): Pointer | null => {
 		if (!native?.symbols?.wgpuCreateSurfaceForView) return null;
-		return native.symbols.wgpuCreateSurfaceForView(instancePtr as any, viewPtr as any) as Pointer;
+		return native_.symbols.wgpuCreateSurfaceForView(instancePtr as any, viewPtr as any) as Pointer;
 	},
 };
 
 // Worker management. Move to a different file
 process.on("uncaughtException", (err) => {
 	console.error("Uncaught exception in worker:", err);
-	// Fast path for crashes - skip beforeQuit, just stop the event loop
-	native.symbols.stopEventLoop();
-	native.symbols.waitForShutdownComplete(5000);
-	native.symbols.forceExit(1);
+	if (native) {
+		native_.symbols.stopEventLoop();
+		native_.symbols.waitForShutdownComplete(5000);
+		native_.symbols.forceExit(1);
+	} else {
+		process.exit(1);
+	}
 });
 
 process.on("unhandledRejection", (reason, _promise) => {
@@ -1919,89 +2005,61 @@ const getHTMLForWebviewSync = new JSCallback(
 	},
 );
 
-native.symbols.setJSUtils(getMimeType, getHTMLForWebviewSync);
+if (native) native_.symbols.setJSUtils(getMimeType, getHTMLForWebviewSync);
 
-// URL scheme open handler (macOS only)
-// Receives URLs when the app is opened via custom URL schemes (e.g., myapp://path)
-const urlOpenCallback = new JSCallback(
-	(urlPtr) => {
-		const url = new CString(urlPtr).toString();
-		const handler = electrobunEventEmitter.events.app.openUrl;
-		const event = handler({ url });
-		electrobunEventEmitter.emitEvent(event);
-	},
-	{
-		args: [FFIType.cstring],
-		returns: "void",
-		threadsafe: true,
-	},
-);
+// Native-only init: URL scheme handlers, quit handler, global shortcuts.
+// Skipped when running without FFI (carrot mode).
+const globalShortcutHandlers = new Map<string, () => void>();
 
-// Register the URL open handler with native code (macOS only)
-if (process.platform === "darwin") {
-	native.symbols.setURLOpenHandler(urlOpenCallback);
-}
+if (native) {
+	const urlOpenCallback = new JSCallback(
+		(urlPtr) => {
+			const url = new CString(urlPtr).toString();
+			const handler = electrobunEventEmitter.events.app.openUrl;
+			const event = handler({ url });
+			electrobunEventEmitter.emitEvent(event);
+		},
+		{ args: [FFIType.cstring], returns: "void", threadsafe: true },
+	);
+	if (process.platform === "darwin") {
+		native_.symbols.setURLOpenHandler(urlOpenCallback);
+	}
 
-const appReopenCallback = new JSCallback(
-	() => {
-		if (process.platform === "darwin") {
-			native.symbols.setDockIconVisible(true);
-		}
+	const appReopenCallback = new JSCallback(
+		() => {
+			if (process.platform === "darwin") {
+				native_.symbols.setDockIconVisible(true);
+			}
+			const handler = electrobunEventEmitter.events.app.reopen;
+			const event = handler({});
+			electrobunEventEmitter.emitEvent(event);
+		},
+		{ args: [], returns: "void", threadsafe: true },
+	);
+	if (process.platform === "darwin") {
+		native_.symbols.setAppReopenHandler(appReopenCallback);
+	}
 
-		const handler = electrobunEventEmitter.events.app.reopen;
-		const event = handler({});
-		electrobunEventEmitter.emitEvent(event);
-	},
-	{
-		args: [],
-		returns: "void",
-		threadsafe: true,
-	},
-);
+	const quitRequestedCallback = new JSCallback(
+		() => {
+			const { quit } = require("../core/Utils");
+			quit();
+		},
+		{ args: [], returns: "void", threadsafe: true },
+	);
+	native_.symbols.setQuitRequestedHandler(quitRequestedCallback);
 
-if (process.platform === "darwin") {
-	native.symbols.setAppReopenHandler(appReopenCallback);
+	const globalShortcutCallback = new JSCallback(
+		(acceleratorPtr) => {
+			const accelerator = new CString(acceleratorPtr).toString();
+			const handler = globalShortcutHandlers.get(accelerator);
+			if (handler) handler();
+		},
+		{ args: [FFIType.cstring], returns: "void", threadsafe: true },
+	);
+	native_.symbols.setGlobalShortcutCallback(globalShortcutCallback);
 }
 
-// Quit requested callback - invoked by native code when system quit is requested
-// (dock icon quit, menu quit, console close, etc.)
-const quitRequestedCallback = new JSCallback(
-	() => {
-		// Dynamic require to avoid circular dependency (Utils.ts imports from native.ts)
-		const { quit } = require("../core/Utils");
-		quit();
-	},
-	{
-		args: [],
-		returns: "void",
-		threadsafe: true,
-	},
-);
-
-// Register the quit handler with native code (all platforms)
-native.symbols.setQuitRequestedHandler(quitRequestedCallback);
-
-// Global shortcut storage and callback
-const globalShortcutHandlers = new Map<string, () => void>();
-
-const globalShortcutCallback = new JSCallback(
-	(acceleratorPtr) => {
-		const accelerator = new CString(acceleratorPtr).toString();
-		const handler = globalShortcutHandlers.get(accelerator);
-		if (handler) {
-			handler();
-		}
-	},
-	{
-		args: [FFIType.cstring],
-		returns: "void",
-		threadsafe: true,
-	},
-);
-
-// Set up the global shortcut callback
-native.symbols.setGlobalShortcutCallback(globalShortcutCallback);
-
 // GlobalShortcut module for external use
 export const GlobalShortcut = {
 	/**
@@ -2011,49 +2069,24 @@ export const GlobalShortcut = {
 	 * @returns true if registered successfully, false otherwise
 	 */
 	register: (accelerator: string, callback: () => void): boolean => {
-		if (globalShortcutHandlers.has(accelerator)) {
-			return false; // Already registered
-		}
-
-		const result = native.symbols.registerGlobalShortcut(
-			toCString(accelerator),
-		);
-		if (result) {
-			globalShortcutHandlers.set(accelerator, callback);
-		}
+		if (!native || globalShortcutHandlers.has(accelerator)) return false;
+		const result = native_.symbols.registerGlobalShortcut(toCString(accelerator));
+		if (result) globalShortcutHandlers.set(accelerator, callback);
 		return result;
 	},
-
-	/**
-	 * Unregister a global keyboard shortcut
-	 * @param accelerator - The shortcut string to unregister
-	 * @returns true if unregistered successfully, false otherwise
-	 */
 	unregister: (accelerator: string): boolean => {
-		const result = native.symbols.unregisterGlobalShortcut(
-			toCString(accelerator),
-		);
-		if (result) {
-			globalShortcutHandlers.delete(accelerator);
-		}
+		if (!native) return false;
+		const result = native_.symbols.unregisterGlobalShortcut(toCString(accelerator));
+		if (result) globalShortcutHandlers.delete(accelerator);
 		return result;
 	},
-
-	/**
-	 * Unregister all global keyboard shortcuts
-	 */
 	unregisterAll: (): void => {
-		native.symbols.unregisterAllGlobalShortcuts();
+		if (native) native_.symbols.unregisterAllGlobalShortcuts();
 		globalShortcutHandlers.clear();
 	},
-
-	/**
-	 * Check if a shortcut is registered
-	 * @param accelerator - The shortcut string to check
-	 * @returns true if registered, false otherwise
-	 */
 	isRegistered: (accelerator: string): boolean => {
-		return native.symbols.isGlobalShortcutRegistered(toCString(accelerator));
+		if (!native) return false;
+		return native_.symbols.isGlobalShortcutRegistered(toCString(accelerator));
 	},
 };
 
@@ -2085,7 +2118,7 @@ export const Screen = {
 	 * @returns Display object for the primary monitor
 	 */
 	getPrimaryDisplay: (): Display => {
-		const jsonStr = native.symbols.getPrimaryDisplay();
+		const jsonStr = native ? native_.symbols.getPrimaryDisplay() : null;
 		if (!jsonStr) {
 			return {
 				id: 0,
@@ -2113,7 +2146,7 @@ export const Screen = {
 	 * @returns Array of Display objects
 	 */
 	getAllDisplays: (): Display[] => {
-		const jsonStr = native.symbols.getAllDisplays();
+		const jsonStr = native ? native_.symbols.getAllDisplays() : null;
 		if (!jsonStr) {
 			return [];
 		}
@@ -2129,7 +2162,7 @@ export const Screen = {
 	 * @returns Point with x and y coordinates
 	 */
 	getCursorScreenPoint: (): Point => {
-		const jsonStr = native.symbols.getCursorScreenPoint();
+		const jsonStr = native ? native_.symbols.getCursorScreenPoint() : null;
 		if (!jsonStr) {
 			return { x: 0, y: 0 };
 		}
@@ -2145,7 +2178,7 @@ export const Screen = {
 	 */
 	getMouseButtons: (): bigint => {
 		try {
-			return native.symbols.getMouseButtons();
+			return native ? native_.symbols.getMouseButtons() : BigInt(0);
 		} catch {
 			return 0n;
 		}
@@ -2197,7 +2230,7 @@ class SessionCookies {
 	 */
 	get(filter?: CookieFilter): Cookie[] {
 		const filterJson = JSON.stringify(filter || {});
-		const result = native.symbols.sessionGetCookies(
+		const result = native_.symbols.sessionGetCookies(
 			toCString(this.partitionId),
 			toCString(filterJson),
 		);
@@ -2216,7 +2249,7 @@ class SessionCookies {
 	 */
 	set(cookie: Cookie): boolean {
 		const cookieJson = JSON.stringify(cookie);
-		return native.symbols.sessionSetCookie(
+		return native_.symbols.sessionSetCookie(
 			toCString(this.partitionId),
 			toCString(cookieJson),
 		);
@@ -2229,7 +2262,7 @@ class SessionCookies {
 	 * @returns true if the cookie was removed successfully
 	 */
 	remove(url: string, name: string): boolean {
-		return native.symbols.sessionRemoveCookie(
+		return native_.symbols.sessionRemoveCookie(
 			toCString(this.partitionId),
 			toCString(url),
 			toCString(name),
@@ -2240,7 +2273,7 @@ class SessionCookies {
 	 * Clear all cookies for this session
 	 */
 	clear(): void {
-		native.symbols.sessionClearCookies(toCString(this.partitionId));
+		native_.symbols.sessionClearCookies(toCString(this.partitionId));
 	}
 }
 
@@ -2260,7 +2293,7 @@ class SessionInstance {
 	 */
 	clearStorageData(types: StorageType[] | "all" = "all"): void {
 		const typesArray = types === "all" ? ["all"] : types;
-		native.symbols.sessionClearStorageData(
+		native_.symbols.sessionClearStorageData(
 			toCString(this.partition),
 			toCString(JSON.stringify(typesArray)),
 		);
@@ -2334,7 +2367,7 @@ const webviewEventHandler = (id: number, eventName: string, detail: string) => {
 			js = `document.querySelector('#electrobun-webview-${id}').emit(${JSON.stringify(eventName)}, ${JSON.stringify(detail)});`;
 		}
 
-		native.symbols.evaluateJavaScriptWithNoCompletion(
+		native_.symbols.evaluateJavaScriptWithNoCompletion(
 			hostWebview.ptr,
 			toCString(js),
 		);
@@ -2740,7 +2773,7 @@ export const internalRpcHandlers = {
 				return false;
 			}
 
-			return native.symbols.webviewCanGoBack(webviewPtr);
+			return native_.symbols.webviewCanGoBack(webviewPtr);
 		},
 		webviewTagCanGoForward: (params: { id: number }) => {
 			const { id } = params;
@@ -2750,7 +2783,7 @@ export const internalRpcHandlers = {
 				return false;
 			}
 
-			return native.symbols.webviewCanGoForward(webviewPtr);
+			return native_.symbols.webviewCanGoForward(webviewPtr);
 		},
 	},
 	message: {
@@ -2771,7 +2804,7 @@ export const internalRpcHandlers = {
 			}
 
 			const { x, y, width, height } = params.frame;
-			native.symbols.resizeWebview(
+			native_.symbols.resizeWebview(
 				webviewPtr,
 				x,
 				y,
@@ -2794,7 +2827,7 @@ export const internalRpcHandlers = {
 			}
 
 			const { x, y, width, height } = params.frame;
-			native.symbols.resizeWebview(
+			native_.symbols.resizeWebview(
 				view.ptr,
 				x,
 				y,
@@ -2811,7 +2844,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.loadURLInWebView(webview.ptr, toCString(params.url));
+			native_.symbols.loadURLInWebView(webview.ptr, toCString(params.url));
 		},
 		webviewTagUpdateHtml: (params: { id: number; html: string }) => {
 			const webview = BrowserView.getById(params.id);
@@ -2823,7 +2856,7 @@ export const internalRpcHandlers = {
 			}
 
 			// Store HTML content in native map for scheme handlers
-			native.symbols.setWebviewHTMLContent(webview.id, toCString(params.html));
+			native_.symbols.setWebviewHTMLContent(webview.id, toCString(params.html));
 
 			webview.loadHTML(params.html);
 			webview.html = params.html;
@@ -2836,7 +2869,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.updatePreloadScriptToWebView(
+			native_.symbols.updatePreloadScriptToWebView(
 				webview.ptr,
 				toCString("electrobun_custom_preload_script"),
 				toCString(params.preload),
@@ -2851,7 +2884,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewGoBack(webview.ptr);
+			native_.symbols.webviewGoBack(webview.ptr);
 		},
 		webviewTagGoForward: (params: { id: number }) => {
 			const webview = BrowserView.getById(params.id);
@@ -2861,7 +2894,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewGoForward(webview.ptr);
+			native_.symbols.webviewGoForward(webview.ptr);
 		},
 		webviewTagReload: (params: { id: number }) => {
 			const webview = BrowserView.getById(params.id);
@@ -2871,7 +2904,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewReload(webview.ptr);
+			native_.symbols.webviewReload(webview.ptr);
 		},
 		webviewTagRemove: (params: { id: number }) => {
 			const webview = BrowserView.getById(params.id);
@@ -2881,15 +2914,15 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewRemove(webview.ptr);
+			webview.remove();
 		},
 		startWindowMove: (params: { id: number }) => {
 			const windowPtr = getWindowPtr(params.id);
 			if (!windowPtr) return;
-			native.symbols.startWindowMove(windowPtr);
+			native_.symbols.startWindowMove(windowPtr);
 		},
 		stopWindowMove: (_params: unknown) => {
-			native.symbols.stopWindowMove();
+			native_.symbols.stopWindowMove();
 		},
 		webviewTagSetTransparent: (params: {
 			id: number;
@@ -2902,7 +2935,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewSetTransparent(webview.ptr, params.transparent);
+			native_.symbols.webviewSetTransparent(webview.ptr, params.transparent);
 		},
 		wgpuTagSetTransparent: (params: {
 			id: number;
@@ -2915,7 +2948,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.wgpuViewSetTransparent(view.ptr, params.transparent);
+			native_.symbols.wgpuViewSetTransparent(view.ptr, params.transparent);
 		},
 		webviewTagSetPassthrough: (params: {
 			id: number;
@@ -2928,7 +2961,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewSetPassthrough(
+			native_.symbols.webviewSetPassthrough(
 				webview.ptr,
 				params.enablePassthrough,
 			);
@@ -2941,7 +2974,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.wgpuViewSetPassthrough(view.ptr, params.passthrough);
+			native_.symbols.wgpuViewSetPassthrough(view.ptr, params.passthrough);
 		},
 		webviewTagSetHidden: (params: { id: number; hidden: boolean }) => {
 			const webview = BrowserView.getById(params.id);
@@ -2951,7 +2984,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewSetHidden(webview.ptr, params.hidden);
+			native_.symbols.webviewSetHidden(webview.ptr, params.hidden);
 		},
 		wgpuTagSetHidden: (params: { id: number; hidden: boolean }) => {
 			const view = WGPUView.getById(params.id);
@@ -2961,7 +2994,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.wgpuViewSetHidden(view.ptr, params.hidden);
+			native_.symbols.wgpuViewSetHidden(view.ptr, params.hidden);
 		},
 		wgpuTagRemove: (params: { id: number }) => {
 			const view = WGPUView.getById(params.id);
@@ -2985,7 +3018,7 @@ export const internalRpcHandlers = {
 				console.error("wgpuTagRunTest: wgpuRunGPUTest not available");
 				return;
 			}
-			native.symbols.wgpuRunGPUTest(view.ptr);
+			native_.symbols.wgpuRunGPUTest(view.ptr);
 		},
 		webviewTagSetNavigationRules: (params: { id: number; rules: string[] }) => {
 			const webview = BrowserView.getById(params.id);
@@ -2996,7 +3029,7 @@ export const internalRpcHandlers = {
 				return;
 			}
 			const rulesJson = JSON.stringify(params.rules);
-			native.symbols.setWebviewNavigationRules(
+			native_.symbols.setWebviewNavigationRules(
 				webview.ptr,
 				toCString(rulesJson),
 			);
@@ -3014,7 +3047,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewFindInPage(
+			native_.symbols.webviewFindInPage(
 				webview.ptr,
 				toCString(params.searchText),
 				params.forward,
@@ -3029,7 +3062,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewStopFind(webview.ptr);
+			native_.symbols.webviewStopFind(webview.ptr);
 		},
 		webviewTagOpenDevTools: (params: { id: number }) => {
 			const webview = BrowserView.getById(params.id);
@@ -3039,7 +3072,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewOpenDevTools(webview.ptr);
+			native_.symbols.webviewOpenDevTools(webview.ptr);
 		},
 		webviewTagCloseDevTools: (params: { id: number }) => {
 			const webview = BrowserView.getById(params.id);
@@ -3049,7 +3082,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewCloseDevTools(webview.ptr);
+			native_.symbols.webviewCloseDevTools(webview.ptr);
 		},
 		webviewTagToggleDevTools: (params: { id: number }) => {
 			const webview = BrowserView.getById(params.id);
@@ -3059,7 +3092,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.webviewToggleDevTools(webview.ptr);
+			native_.symbols.webviewToggleDevTools(webview.ptr);
 		},
 		webviewTagExecuteJavascript: (params: { id: number; js: string }) => {
 			const webview = BrowserView.getById(params.id);
@@ -3069,7 +3102,7 @@ export const internalRpcHandlers = {
 				);
 				return;
 			}
-			native.symbols.evaluateJavaScriptWithNoCompletion(
+			native_.symbols.evaluateJavaScriptWithNoCompletion(
 				webview.ptr,
 				toCString(params.js),
 			);