electrobun 1.18.1 → 1.18.4-beta.5

package/README.md

@@ -63,9 +63,11 @@ Don't miss our:
 - [GOG Achievements GUI](https://github.com/timendum/gog-achievements-gui) - desktop app for managing GOG achievements
 - [groov](https://github.com/laurenzcodes/groov) - desktop audio deck monitor
 - [Guerilla Glass](https://github.com/okikeSolutions/guerillaglass) - open-source cross-platform creator studio for fast Record -> Edit -> Deliver workflows
+- [Invoke](https://getinvoke.com) - macOS UI automation & shortcut platform
 - [Marginalia](https://github.com/lars-hoeijmans/Marginalia) - a simple note taking app
 - [MarkBun](https://github.com/xiaochong/markbun) - fast, beautiful, Typora-like markdown desktop editor
 - [md-browse](https://github.com/needle-tools/md-browse) - a markdown-first browser that converts web pages to clean markdown
+- [moop](https://github.com/zrubinrattet/moop/) - desktop app for batch image optimization for the web
 - [Patchline](https://github.com/adwaithks/Patchline) - lightweight desktop Git client for reading patches and line diffs, then staging and committing changes
 - [peekachu](https://github.com/needle-tools/peekachu) - password manager for AIs; store secrets in your OS keychain and scrub output so AI assistants never see actual values
 - [PiBun](https://github.com/khairold/pibun) - desktop GUI for the Pi coding agent with chat, terminal, git integration, and plugin system

package/dist/api/browser/global.d.ts

@@ -7,6 +7,8 @@ interface ElectrobunEncryptResult {
 }
 
 interface ElectrobunBridge {
+  receiveMessageFromHost: (msg: unknown) => void;
+  receiveInternalMessageFromHost: (msg: unknown) => void;
   receiveMessageFromBun: (msg: unknown) => void;
   receiveInternalMessageFromBun: (msg: unknown) => void;
 }
@@ -20,10 +22,13 @@ declare global {
     __electrobunWebviewId: number;
     __electrobunWindowId: number;
     __electrobunRpcSocketPort: number;
+    __electrobunHostSocketPort?: number;
     __electrobun?: ElectrobunBridge;
+    __electrobunPendingHostMessages?: unknown[];
     __electrobun_encrypt: (msg: string) => Promise<ElectrobunEncryptResult>;
     __electrobun_decrypt: (encryptedData: string, iv: string, tag: string) => Promise<string>;
     __electrobunInternalBridge?: MessageHandler;
+    __electrobunHostBridge?: MessageHandler;
     __electrobunBunBridge?: MessageHandler;
   }
 }

package/dist/api/browser/index.ts

@@ -15,13 +15,23 @@ import { type WgpuTagElement, type WgpuEventTypes } from "./wgputag";
 import "./global.d.ts";
 
 const WEBVIEW_ID = window.__electrobunWebviewId;
-const RPC_SOCKET_PORT = window.__electrobunRpcSocketPort;
+const HOST_SOCKET_PORT =
+	window.__electrobunHostSocketPort ?? window.__electrobunRpcSocketPort;
 
 class Electroview<T extends RPCWithTransport> {
-	bunSocket?: WebSocket;
+	hostSocket?: WebSocket;
+	hostSocketCanSend = false;
 	// user's custom rpc browser <-> bun
 	rpc?: T;
 	rpcHandler?: (msg: unknown) => void;
+	carrots = {
+		invoke: <R = unknown>(
+			carrotId: string,
+			method: string,
+			params?: unknown,
+			options?: { windowId?: string },
+		) => this.invokeCarrot<R>(carrotId, method, params, options),
+	};
 
 	constructor(config: { rpc: T }) {
 		this.rpc = config.rpc;
@@ -29,34 +39,42 @@ class Electroview<T extends RPCWithTransport> {
 	}
 
 	init() {
-		this.initSocketToBun();
+		this.initSocketToHost();
 
-		// Set up handler for user RPC messages from bun
-		// Note: receiveInternalMessageFromBun is set up by the preload script
-		window.__electrobun!.receiveMessageFromBun =
-			this.receiveMessageFromBun.bind(this);
+		// Set up handler for user RPC messages from the host runtime.
+		const hostMessageHandler = this.receiveMessageFromHost.bind(this);
+		window.__electrobun!.receiveMessageFromHost = hostMessageHandler;
+		window.__electrobun!.receiveMessageFromBun = hostMessageHandler;
 
 		if (this.rpc) {
 			this.rpc.setTransport(this.createTransport());
 		}
+
+		const pendingMessages = window.__electrobunPendingHostMessages;
+		if (pendingMessages?.length) {
+			window.__electrobunPendingHostMessages = [];
+			for (const message of pendingMessages) {
+				hostMessageHandler(message);
+			}
+		}
 	}
 
-	initSocketToBun() {
+	initSocketToHost() {
 		// Skip native socket when running in a remote browser (no port/webview ID)
-		if (!RPC_SOCKET_PORT || !WEBVIEW_ID) {
+		if (!HOST_SOCKET_PORT || !WEBVIEW_ID) {
 			return;
 		}
 
-		// Note: Using ws:// for localhost is intentional - all RPC messages are
+		// Note: Using ws:// for loopback is intentional - all RPC messages are
 		// encrypted with per-webview AES-GCM keys, making TLS redundant
 		const socket = new WebSocket(
-			`ws://localhost:${RPC_SOCKET_PORT}/socket?webviewId=${WEBVIEW_ID}`,
+			`ws://127.0.0.1:${HOST_SOCKET_PORT}/socket?webviewId=${WEBVIEW_ID}`,
 		);
 
-		this.bunSocket = socket;
+		this.hostSocket = socket;
 
 		socket.addEventListener("open", () => {
-			// this.bunSocket?.send("Hello from webview " + WEBVIEW_ID);
+			this.hostSocketCanSend = true;
 		});
 
 		socket.addEventListener("message", async (event) => {
@@ -71,6 +89,7 @@ class Electroview<T extends RPCWithTransport> {
 						encryptedPacket.tag,
 					);
 
+					this.hostSocketCanSend = true;
 					this.rpcHandler?.(JSON.parse(decrypted));
 				} catch (err) {
 					console.error("Error parsing bun message:", err);
@@ -83,10 +102,12 @@ class Electroview<T extends RPCWithTransport> {
 		});
 
 		socket.addEventListener("error", (event) => {
+			this.hostSocketCanSend = false;
 			console.error("Socket error:", event);
 		});
 
 		socket.addEventListener("close", (_event) => {
+			this.hostSocketCanSend = false;
 			// console.log("Socket closed:", event);
 		});
 	}
@@ -97,9 +118,9 @@ class Electroview<T extends RPCWithTransport> {
 			send(message: unknown) {
 				try {
 					const messageString = JSON.stringify(message);
-					that.bunBridge(messageString);
+					that.sendMessageToHost(messageString);
 				} catch (error) {
-					console.error("bun: failed to serialize message to webview", error);
+					console.error("host: failed to serialize message to webview", error);
 				}
 			},
 			registerHandler(handler: (msg: unknown) => void) {
@@ -108,8 +129,11 @@ class Electroview<T extends RPCWithTransport> {
 		};
 	}
 
-	async bunBridge(msg: string) {
-		if (this.bunSocket?.readyState === WebSocket.OPEN) {
+	async sendMessageToHost(msg: string) {
+		if (
+			this.hostSocketCanSend &&
+			this.hostSocket?.readyState === WebSocket.OPEN
+		) {
 			try {
 				const { encryptedData, iv, tag } =
 					await window.__electrobun_encrypt(msg);
@@ -120,24 +144,42 @@ class Electroview<T extends RPCWithTransport> {
 					tag: tag,
 				};
 				const encryptedPacketString = JSON.stringify(encryptedPacket);
-				this.bunSocket.send(encryptedPacketString);
+				this.hostSocket.send(encryptedPacketString);
 				return;
 			} catch (error) {
-				console.error("Error sending message to bun via socket:", error);
+				console.error("Error sending message to host via socket:", error);
 			}
 		}
 
 		// if socket's are unavailable, fallback to postMessage
-		window.__electrobunBunBridge?.postMessage(msg);
+		window.__electrobunHostBridge?.postMessage(msg);
 	}
 
-	receiveMessageFromBun(msg: unknown) {
-		// NOTE: in the webview messages are passed by executing ElectrobunView.receiveMessageFromBun(object)
+	receiveMessageFromHost(msg: unknown) {
+		// NOTE: in the webview messages are passed by executing window.__electrobun.receiveMessageFromHost(object)
 		// so they're already parsed into an object here
 		if (this.rpcHandler) {
 			this.rpcHandler(msg);
 		}
 	}
+
+	async invokeCarrot<R = unknown>(
+		carrotId: string,
+		method: string,
+		params?: unknown,
+		options?: { windowId?: string },
+	): Promise<R> {
+		const requestProxy = (this.rpc as any)?.request;
+		if (!requestProxy || typeof requestProxy.invokeCarrot !== "function") {
+			throw new Error("Renderer carrot invocation is not available in this Electrobun host.");
+		}
+		return requestProxy.invokeCarrot({
+			carrotId,
+			method,
+			params,
+			windowId: options?.windowId,
+		}) as Promise<R>;
+	}
 	static defineRPC<Schema extends ElectrobunRPCSchema>(
 		config: ElectrobunRPCConfig<Schema, "webview">,
 	) {

package/dist/api/bun/ElectrobunConfig.ts

@@ -13,6 +13,28 @@ type BunBuildOptions = Omit<
 	"entrypoints" | "outdir" | "target"
 >;
 
+type CarrotFileActivatorConfig = {
+	baseName?: string;
+	nodeType?: "file" | "dir" | "any";
+	slate: {
+		type: string;
+		name?: string;
+		icon?: string;
+		config?: Record<string, unknown>;
+	};
+};
+
+type CarrotContributionsConfig = {
+	fileActivators?: CarrotFileActivatorConfig[];
+};
+
+type CarrotUIDefinition = {
+	name?: string;
+	entrypoint?: string;
+	path?: string;
+	[key: string]: unknown;
+};
+
 export interface ElectrobunConfig {
 	/**
 	 * Application metadata configuration
@@ -112,6 +134,14 @@ export interface ElectrobunConfig {
 	 * Build configuration options
 	 */
 	build?: {
+		/**
+		 * Main process implementation to build and package.
+		 * - "bun": bundle and run the Bun main process entrypoint
+		 * - "zig": compile and run the Zig main process entrypoint
+		 * @default "bun"
+		 */
+		mainProcess?: "bun" | "zig";
+
 		/**
 		 * Bun process build configuration.
 		 * Accepts all Bun.build() options (plugins, sourcemap, minify, define, etc.)
@@ -125,6 +155,18 @@ export interface ElectrobunConfig {
 			entrypoint?: string;
 		} & BunBuildOptions;
 
+		/**
+		 * Zig main process build configuration.
+		 * Used when `build.mainProcess` is set to `"zig"`.
+		 */
+		zig?: {
+			/**
+			 * Entry point for the main Zig process
+			 * @default "src/zig/main.zig"
+			 */
+			entrypoint?: string;
+		};
+
 		/**
 		 * Browser view build configurations.
 		 * Each view accepts all Bun.build() options (plugins, sourcemap, minify, define, etc.)
@@ -244,7 +286,9 @@ export interface ElectrobunConfig {
 			carrotOnly?: boolean;
 			permissions?: Record<string, unknown>;
 			dependencies?: Record<string, string>;
-			remoteUIs?: Record<string, { entrypoint: string; [key: string]: unknown }>;
+			remoteUIs?: Record<string, CarrotUIDefinition>;
+			slateUIs?: Record<string, CarrotUIDefinition>;
+			contributions?: CarrotContributionsConfig;
 		};
 
 		/**

package/dist/api/bun/core/BrowserView.ts

@@ -1,5 +1,4 @@
-import { native, toCString, ffi } from "../proc/native";
-import * as fs from "fs";
+import { ffi } from "../proc/native";
 import electrobunEventEmitter from "../events/eventEmitter";
 import {
 	type ElectrobunRPCSchema,
@@ -7,10 +6,8 @@ import {
 	type RPCWithTransport,
 	defineElectrobunRPC,
 } from "../../shared/rpc.js";
-import { Updater } from "./Updater";
 import { BuildConfig } from "./BuildConfig";
 import {
-	rpcPort,
 	sendMessageToWebviewViaSocket,
 	removeSocketForWebview,
 } from "./Socket";
@@ -20,7 +17,6 @@ import { type Pointer } from "bun:ffi";
 const BrowserViewMap: {
 	[id: number]: BrowserView<any>;
 } = {};
-let nextWebviewId = 1;
 
 export type BrowserViewOptions<T = undefined> = {
 	url: string | null;
@@ -38,7 +34,6 @@ export type BrowserViewOptions<T = undefined> = {
 	rpc: T;
 	hostWebviewId: number;
 	autoResize: boolean;
-
 	windowId: number;
 	navigationRules: string | null;
 	// Sandbox mode: when true, disables RPC and only allows event emission
@@ -52,8 +47,7 @@ export type BrowserViewOptions<T = undefined> = {
 	// renderer:
 };
 
-const hash = await Updater.localInfo.hash();
-const buildConfig = await BuildConfig.get();
+const buildConfig = BuildConfig.getSync();
 
 const defaultOptions: Partial<BrowserViewOptions> = {
 	url: null,
@@ -68,13 +62,8 @@ const defaultOptions: Partial<BrowserViewOptions> = {
 		height: 600,
 	},
 };
-// Note: we use the build's hash to separate from different apps and different builds
-// but we also want a randomId to separate different instances of the same app
-const randomId = Math.random().toString(36).substring(7);
-
 export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
-	id: number = nextWebviewId++;
-	ptr: Pointer | null = null;
+	id = 0;
 	hostWebviewId?: number;
 	windowId!: number;
 	renderer!: "cef" | "native";
@@ -95,9 +84,6 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		width: 800,
 		height: 600,
 	};
-	pipePrefix!: string;
-	inStream!: fs.WriteStream;
-	outStream!: ReadableStream<Uint8Array>;
 	secretKey!: Uint8Array;
 	rpc?: T;
 	rpcHandler?: (msg: unknown) => void;
@@ -108,6 +94,13 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 	startPassthrough: boolean = false;
 	isRemoved: boolean = false;
 
+	get ptr(): Pointer | null {
+		if (this.isRemoved) {
+			return null;
+		}
+		return ffi.request.getWebviewPointer({ id: this.id }) as Pointer | null;
+	}
+
 	constructor(options: Partial<BrowserViewOptions<T>> = defaultOptions) {
 		// const rpc = options.rpc;
 
@@ -124,9 +117,6 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		this.rpc = options.rpc;
 		this.secretKey = new Uint8Array(randomBytes(32));
 		this.partition = options.partition || null;
-		// todo (yoav): since collisions can crash the app add a function that checks if the
-		// file exists first
-		this.pipePrefix = `/private/tmp/electrobun_ipc_pipe_${hash}_${randomId}_${this.id}`;
 		this.hostWebviewId = options.hostWebviewId;
 		this.windowId = options.windowId ?? 0;
 		this.autoResize = options.autoResize === false ? false : true;
@@ -136,8 +126,8 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		this.startTransparent = options.startTransparent ?? false;
 		this.startPassthrough = options.startPassthrough ?? false;
 
+		this.id = this.init() as number;
 		BrowserViewMap[this.id] = this;
-		this.ptr = this.init() as Pointer;
 
 		// If HTML content was provided, load it after webview creation.
 		if (this.html) {
@@ -148,21 +138,17 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 	}
 
 	init() {
-		this.createStreams();
+		this.initializeRpcTransport();
 
 		return ffi.request.createWebview({
-			id: this.id,
 			windowId: this.windowId,
+			hostWebviewId: this.hostWebviewId ?? null,
 			renderer: this.renderer,
-			rpcPort: rpcPort,
 			// todo: consider sending secretKey as base64
 			secretKey: this.secretKey.toString(),
-			hostWebviewId: this.hostWebviewId || null,
-			pipePrefix: this.pipePrefix,
 			partition: this.partition,
 			// Only pass URL if no HTML content is provided to avoid conflicts
 			url: this.html ? null : this.url,
-			html: this.html,
 			preload: this.preload,
 			viewsRoot: this.viewsRoot,
 			frame: {
@@ -180,7 +166,7 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		});
 	}
 
-	createStreams() {
+	initializeRpcTransport() {
 		if (!this.rpc) {
 			// eslint-disable-next-line @typescript-eslint/no-explicit-any
 			this.rpc = BrowserView.defineRPC({
@@ -191,23 +177,23 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		this.rpc!.setTransport(this.createTransport());
 	}
 
-	sendMessageToWebviewViaExecute(jsonMessage: unknown) {
+	sendHostMessageToWebviewViaExecute(jsonMessage: unknown) {
 		const stringifiedMessage =
 			typeof jsonMessage === "string"
 				? jsonMessage
 				: JSON.stringify(jsonMessage);
 		// todo (yoav): make this a shared const with the browser api
-		const wrappedMessage = `window.__electrobun.receiveMessageFromBun(${stringifiedMessage})`;
+		const wrappedMessage = `window.__electrobun.receiveMessageFromHost(${stringifiedMessage})`;
 		this.executeJavascript(wrappedMessage);
 	}
 
-	sendInternalMessageViaExecute(jsonMessage: unknown) {
+	sendInternalHostMessageViaExecute(jsonMessage: unknown) {
 		const stringifiedMessage =
 			typeof jsonMessage === "string"
 				? jsonMessage
 				: JSON.stringify(jsonMessage);
 		// todo (yoav): make this a shared const with the browser api
-		const wrappedMessage = `window.__electrobun.receiveInternalMessageFromBun(${stringifiedMessage})`;
+		const wrappedMessage = `window.__electrobun.receiveInternalMessageFromHost(${stringifiedMessage})`;
 		this.executeJavascript(wrappedMessage);
 	}
 
@@ -224,7 +210,7 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 
 	loadURL(url: string) {
 		this.url = url;
-		native!.symbols.loadURLInWebView(this.ptr, toCString(this.url));
+		ffi.request.loadURLInWebView({ id: this.id, url: this.url });
 	}
 
 	loadHTML(html: string) {
@@ -232,18 +218,18 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 
 		if (this.renderer === "cef") {
 			// For CEF, store HTML content in native map and use scheme handler
-			native!.symbols.setWebviewHTMLContent(this.id, toCString(html));
+			ffi.request.setWebviewHTMLContent({ id: this.id, html });
 			this.loadURL("views://internal/index.html");
 		} else {
 			// For WKWebView, load HTML content directly
-			native!.symbols.loadHTMLInWebView(this.ptr, toCString(html));
+			ffi.request.loadHTMLInWebView({ id: this.id, html });
 		}
 	}
 
 	setNavigationRules(rules: string[]) {
 		this.navigationRules = JSON.stringify(rules);
 		const rulesJson = JSON.stringify(rules);
-		native!.symbols.setWebviewNavigationRules(this.ptr, toCString(rulesJson));
+		ffi.request.setWebviewNavigationRules({ id: this.id, rulesJson });
 	}
 
 	findInPage(
@@ -252,28 +238,28 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 	) {
 		const forward = options?.forward ?? true;
 		const matchCase = options?.matchCase ?? false;
-		native!.symbols.webviewFindInPage(
-			this.ptr,
-			toCString(searchText),
+		ffi.request.webviewFindInPage({
+			id: this.id,
+			searchText,
 			forward,
 			matchCase,
-		);
+		});
 	}
 
 	stopFindInPage() {
-		native!.symbols.webviewStopFind(this.ptr);
+		ffi.request.webviewStopFind({ id: this.id });
 	}
 
 	openDevTools() {
-		native!.symbols.webviewOpenDevTools(this.ptr);
+		ffi.request.webviewOpenDevTools({ id: this.id });
 	}
 
 	closeDevTools() {
-		native!.symbols.webviewCloseDevTools(this.ptr);
+		ffi.request.webviewCloseDevTools({ id: this.id });
 	}
 
 	toggleDevTools() {
-		native!.symbols.webviewToggleDevTools(this.ptr);
+		ffi.request.webviewToggleDevTools({ id: this.id });
 	}
 
 	/**
@@ -281,7 +267,7 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 	 * @param zoomLevel - The zoom level (1.0 = 100%, 1.5 = 150%, etc.)
 	 */
 	setPageZoom(zoomLevel: number) {
-		native!.symbols.webviewSetPageZoom(this.ptr, zoomLevel);
+		ffi.request.webviewSetPageZoom({ id: this.id, zoomLevel });
 	}
 
 	/**
@@ -289,7 +275,7 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 	 * @returns The current zoom level (1.0 = 100%)
 	 */
 	getPageZoom(): number {
-		return native!.symbols.webviewGetPageZoom(this.ptr) as number;
+		return ffi.request.webviewGetPageZoom({ id: this.id }) as number;
 	}
 
 	// todo (yoav): move this to a class that also has off, append, prepend, etc.
@@ -326,9 +312,9 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 				if (!sentOverSocket) {
 					try {
 						const messageString = JSON.stringify(message);
-						that.sendMessageToWebviewViaExecute(messageString);
+						that.sendHostMessageToWebviewViaExecute(messageString);
 					} catch (error) {
-						console.error("bun: failed to serialize message to webview", error);
+						console.error("host: failed to serialize message to webview", error);
 					}
 				}
 			},
@@ -342,10 +328,9 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 	};
 
 	remove() {
-		if (!this.ptr || this.isRemoved) {
+		if (this.isRemoved) {
 			return;
 		}
-		const ptr = this.ptr;
 		this.isRemoved = true;
 		// Drop JS-side references first so late callbacks cannot target a stale view.
 		delete BrowserViewMap[this.id];
@@ -356,16 +341,72 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 			unregisterHandler() {},
 		});
 		this.rpcHandler = undefined;
-    
-    this.rpcHandler = undefined;
-    this.ptr = null;
-    native!.symbols.webviewRemove(ptr);
+		try {
+			ffi.request.webviewRemove({ id: this.id });
+		} catch (error) {
+			console.error(`Error removing webview ${this.id}:`, error);
+		}
 	}
 
 	static getById(id: number) {
 		return BrowserViewMap[id];
 	}
 
+	// Core can create webviews before Bun has constructed a JS wrapper for them.
+	// Use this in native/runtime paths that need to ensure a wrapper exists.
+	static ensureWrapped<T extends RPCWithTransport = RPCWithTransport>(
+		id: number,
+		options: Partial<BrowserViewOptions<T>> = {},
+	) {
+		return (
+			(BrowserViewMap[id] as BrowserView<T> | undefined) ??
+			BrowserView.adoptExisting(id, options)
+		);
+	}
+
+	static adoptExisting<T extends RPCWithTransport = RPCWithTransport>(
+		id: number,
+		options: Partial<BrowserViewOptions<T>> = {},
+	) {
+		const existing = BrowserViewMap[id] as BrowserView<T> | undefined;
+		if (existing) {
+			return existing;
+		}
+
+		const ptr = ffi.request.getWebviewPointer({ id }) as Pointer | null;
+		if (!ptr) {
+			return undefined;
+		}
+
+		const view = Object.create(BrowserView.prototype) as BrowserView<T>;
+		view.id = id;
+		view.hostWebviewId = options.hostWebviewId;
+		view.windowId = options.windowId ?? 0;
+		view.renderer = options.renderer ?? defaultOptions.renderer ?? "native";
+		view.url = options.url ?? defaultOptions.url ?? null;
+		view.html = options.html ?? defaultOptions.html ?? null;
+		view.preload = options.preload ?? defaultOptions.preload ?? null;
+		view.viewsRoot = options.viewsRoot ?? defaultOptions.viewsRoot ?? null;
+		view.partition = options.partition ?? null;
+		view.frame = {
+			x: options.frame?.x ?? defaultOptions.frame!.x,
+			y: options.frame?.y ?? defaultOptions.frame!.y,
+			width: options.frame?.width ?? defaultOptions.frame!.width,
+			height: options.frame?.height ?? defaultOptions.frame!.height,
+		};
+		view.secretKey = new Uint8Array(0);
+		view.rpc = options.rpc;
+		view.rpcHandler = undefined;
+		view.autoResize = options.autoResize === false ? false : true;
+		view.navigationRules = options.navigationRules ?? null;
+		view.sandbox = options.sandbox ?? false;
+		view.startTransparent = options.startTransparent ?? false;
+		view.startPassthrough = options.startPassthrough ?? false;
+		view.isRemoved = false;
+		BrowserViewMap[id] = view as BrowserView<any>;
+		return view;
+	}
+
 	static getAll() {
 		return Object.values(BrowserViewMap);
 	}