electrobun 1.15.1 → 1.16.0

package/bin/electrobun.cjs

@@ -4,6 +4,10 @@ const { execSync, spawn } = require('child_process');
 const { existsSync, mkdirSync, unlinkSync, chmodSync, copyFileSync, createWriteStream } = require('fs');
 const { join, dirname } = require('path');
 const https = require('https');
+const ProxyAgent = require('proxy-agent').ProxyAgent;
+
+// Create an HTTPS agent that respects environment proxy settings
+const agent = new ProxyAgent();
 
 // Detect platform and architecture
 function getPlatform() {
@@ -38,7 +42,7 @@ async function downloadFile(url, filePath) {
     mkdirSync(dirname(filePath), { recursive: true });
     const file = createWriteStream(filePath);
 
-    https.get(url, (response) => {
+    https.get(url, {agent}, (response) => {
       if (response.statusCode === 302 || response.statusCode === 301) {
         // Follow redirect
         return downloadFile(response.headers.location, filePath).then(resolve).catch(reject);

package/bun.lock

@@ -8,6 +8,7 @@
         "@babylonjs/core": "^7.45.0",
         "@types/bun": "^1.3.8",
         "png-to-ico": "^2.1.8",
+        "proxy-agent": "^6.5.0",
         "rcedit": "^4.0.1",
         "three": "^0.165.0",
       },
@@ -21,38 +22,92 @@
 
     "@malept/cross-spawn-promise": ["@malept/cross-spawn-promise@1.1.1", "", { "dependencies": { "cross-spawn": "^7.0.1" } }, "sha512-RTBGWL5FWQcg9orDOCcp4LvItNzUPcyEU9bwaeJX0rJ1IQxzucC48Y0/sQLp/g6t99IQgAlGIaesJS+gTn7tVQ=="],
 
+    "@tootallnate/quickjs-emscripten": ["@tootallnate/quickjs-emscripten@0.23.0", "", {}, "sha512-C5Mc6rdnsaJDjO3UpGW/CQTHtCKaYlScZTly4JIu97Jxo/odCiH0ITnDXSJPTOrEKk/ycSZ0AOgTmkDtkOsvIA=="],
+
     "@types/bun": ["@types/bun@1.3.8", "", { "dependencies": { "bun-types": "1.3.8" } }, "sha512-3LvWJ2q5GerAXYxO2mffLTqOzEu5qnhEAlh48Vnu8WQfnmSwbgagjGZV6BoHKJztENYEDn6QmVd949W4uESRJA=="],
 
     "@types/node": ["@types/node@17.0.45", "", {}, "sha512-w+tIMs3rq2afQdsPJlODhoUEKzFP1ayaoyl1CcnwtIlsVe7K7bA1NGm4s3PraqTLlXnbIN84zuBlxBWo1u9BLw=="],
 
+    "agent-base": ["agent-base@7.1.4", "", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="],
+
+    "ast-types": ["ast-types@0.13.4", "", { "dependencies": { "tslib": "^2.0.1" } }, "sha512-x1FCFnFifvYDDzTaLII71vG5uvDwgtmDTEVWAxrgeiR8VjMONcCXJx7E+USjDtHlwFmt9MysbqgF9b9Vjr6w+w=="],
+
+    "basic-ftp": ["basic-ftp@5.2.0", "", {}, "sha512-VoMINM2rqJwJgfdHq6RiUudKt2BV+FY5ZFezP/ypmwayk68+NzzAQy4XXLlqsGD4MCzq3DrmNFD/uUmBJuGoXw=="],
+
     "bun-types": ["bun-types@1.3.8", "", { "dependencies": { "@types/node": "*" } }, "sha512-fL99nxdOWvV4LqjmC+8Q9kW3M4QTtTR1eePs94v5ctGqU8OeceWrSUaRw3JYb7tU3FkMIAjkueehrHPPPGKi5Q=="],
 
     "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
 
     "cross-spawn-windows-exe": ["cross-spawn-windows-exe@1.2.0", "", { "dependencies": { "@malept/cross-spawn-promise": "^1.1.0", "is-wsl": "^2.2.0", "which": "^2.0.2" } }, "sha512-mkLtJJcYbDCxEG7Js6eUnUNndWjyUZwJ3H7bErmmtOYU/Zb99DyUkpamuIZE0b3bhmJyZ7D90uS6f+CGxRRjOw=="],
 
+    "data-uri-to-buffer": ["data-uri-to-buffer@6.0.2", "", {}, "sha512-7hvf7/GW8e86rW0ptuwS3OcBGDjIi6SZva7hCyWC0yYry2cOPmLIjXAUHI6DK2HsnwJd9ifmt57i8eV2n4YNpw=="],
+
+    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
+
+    "degenerator": ["degenerator@5.0.1", "", { "dependencies": { "ast-types": "^0.13.4", "escodegen": "^2.1.0", "esprima": "^4.0.1" } }, "sha512-TllpMR/t0M5sqCXfj85i4XaAzxmS5tVA16dqvdkMwGmzI+dXLXnw3J+3Vdv7VKw+ThlTMboK6i9rnZ6Nntj5CQ=="],
+
+    "escodegen": ["escodegen@2.1.0", "", { "dependencies": { "esprima": "^4.0.1", "estraverse": "^5.2.0", "esutils": "^2.0.2" }, "optionalDependencies": { "source-map": "~0.6.1" }, "bin": { "esgenerate": "bin/esgenerate.js", "escodegen": "bin/escodegen.js" } }, "sha512-2NlIDTwUWJN0mRPQOdtQBzbUHvdGY2P1VXSyU83Q3xKxM7WHX2Ql8dKq782Q9TgQUNOLEzEYu9bzLNj1q88I5w=="],
+
+    "esprima": ["esprima@4.0.1", "", { "bin": { "esparse": "./bin/esparse.js", "esvalidate": "./bin/esvalidate.js" } }, "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A=="],
+
+    "estraverse": ["estraverse@5.3.0", "", {}, "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA=="],
+
+    "esutils": ["esutils@2.0.3", "", {}, "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g=="],
+
+    "get-uri": ["get-uri@6.0.5", "", { "dependencies": { "basic-ftp": "^5.0.2", "data-uri-to-buffer": "^6.0.2", "debug": "^4.3.4" } }, "sha512-b1O07XYq8eRuVzBNgJLstU6FYc1tS6wnMtF1I1D9lE8LxZSOGZ7LhxN54yPP6mGw5f2CkXY2BQUL9Fx41qvcIg=="],
+
+    "http-proxy-agent": ["http-proxy-agent@7.0.2", "", { "dependencies": { "agent-base": "^7.1.0", "debug": "^4.3.4" } }, "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig=="],
+
+    "https-proxy-agent": ["https-proxy-agent@7.0.6", "", { "dependencies": { "agent-base": "^7.1.2", "debug": "4" } }, "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw=="],
+
+    "ip-address": ["ip-address@10.1.0", "", {}, "sha512-XXADHxXmvT9+CRxhXg56LJovE+bmWnEWB78LB83VZTprKTmaC5QfruXocxzTZ2Kl0DNwKuBdlIhjL8LeY8Sf8Q=="],
+
     "is-docker": ["is-docker@2.2.1", "", { "bin": { "is-docker": "cli.js" } }, "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ=="],
 
     "is-wsl": ["is-wsl@2.2.0", "", { "dependencies": { "is-docker": "^2.0.0" } }, "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww=="],
 
     "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
 
+    "lru-cache": ["lru-cache@7.18.3", "", {}, "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA=="],
+
     "minimist": ["minimist@1.2.8", "", {}, "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA=="],
 
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "netmask": ["netmask@2.0.2", "", {}, "sha512-dBpDMdxv9Irdq66304OLfEmQ9tbNRFnFTuZiLo+bD+r332bBmMJ8GBLXklIXXgxd3+v9+KUnZaUR5PJMa75Gsg=="],
+
+    "pac-proxy-agent": ["pac-proxy-agent@7.2.0", "", { "dependencies": { "@tootallnate/quickjs-emscripten": "^0.23.0", "agent-base": "^7.1.2", "debug": "^4.3.4", "get-uri": "^6.0.1", "http-proxy-agent": "^7.0.0", "https-proxy-agent": "^7.0.6", "pac-resolver": "^7.0.1", "socks-proxy-agent": "^8.0.5" } }, "sha512-TEB8ESquiLMc0lV8vcd5Ql/JAKAoyzHFXaStwjkzpOpC5Yv+pIzLfHvjTSdf3vpa2bMiUQrg9i6276yn8666aA=="],
+
+    "pac-resolver": ["pac-resolver@7.0.1", "", { "dependencies": { "degenerator": "^5.0.0", "netmask": "^2.0.2" } }, "sha512-5NPgf87AT2STgwa2ntRMr45jTKrYBGkVU36yT0ig/n/GMAa3oPqhZfIQ2kMEimReg0+t9kZViDVZ83qfVUlckg=="],
+
     "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
 
     "png-to-ico": ["png-to-ico@2.1.8", "", { "dependencies": { "@types/node": "^17.0.36", "minimist": "^1.2.6", "pngjs": "^6.0.0" }, "bin": { "png-to-ico": "bin/cli.js" } }, "sha512-Nf+IIn/cZ/DIZVdGveJp86NG5uNib1ZXMiDd/8x32HCTeKSvgpyg6D/6tUBn1QO/zybzoMK0/mc3QRgAyXdv9w=="],
 
     "pngjs": ["pngjs@6.0.0", "", {}, "sha512-TRzzuFRRmEoSW/p1KVAmiOgPco2Irlah+bGFCeNfJXxxYGwSw7YwAOAcd7X28K/m5bjBWKsC29KyoMfHbypayg=="],
 
+    "proxy-agent": ["proxy-agent@6.5.0", "", { "dependencies": { "agent-base": "^7.1.2", "debug": "^4.3.4", "http-proxy-agent": "^7.0.1", "https-proxy-agent": "^7.0.6", "lru-cache": "^7.14.1", "pac-proxy-agent": "^7.1.0", "proxy-from-env": "^1.1.0", "socks-proxy-agent": "^8.0.5" } }, "sha512-TmatMXdr2KlRiA2CyDu8GqR8EjahTG3aY3nXjdzFyoZbmB8hrBsTyMezhULIXKnC0jpfjlmiZ3+EaCzoInSu/A=="],
+
+    "proxy-from-env": ["proxy-from-env@1.1.0", "", {}, "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg=="],
+
     "rcedit": ["rcedit@4.0.1", "", { "dependencies": { "cross-spawn-windows-exe": "^1.1.0" } }, "sha512-bZdaQi34krFWhrDn+O53ccBDw0MkAT2Vhu75SqhtvhQu4OPyFM4RoVheyYiVQYdjhUi6EJMVWQ0tR6bCIYVkUg=="],
 
     "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
 
     "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
 
+    "smart-buffer": ["smart-buffer@4.2.0", "", {}, "sha512-94hK0Hh8rPqQl2xXc3HsaBoOXKV20MToPkcXvwbISWLEs+64sBq5kFgn2kJDHb1Pry9yrP0dxrCI9RRci7RXKg=="],
+
+    "socks": ["socks@2.8.7", "", { "dependencies": { "ip-address": "^10.0.1", "smart-buffer": "^4.2.0" } }, "sha512-HLpt+uLy/pxB+bum/9DzAgiKS8CX1EvbWxI4zlmgGCExImLdiad2iCwXT5Z4c9c3Eq8rP2318mPW2c+QbtjK8A=="],
+
+    "socks-proxy-agent": ["socks-proxy-agent@8.0.5", "", { "dependencies": { "agent-base": "^7.1.2", "debug": "^4.3.4", "socks": "^2.8.3" } }, "sha512-HehCEsotFqbPW9sJ8WVYB6UbmIMv7kUUORIF2Nncq4VQvBfNBLibW9YZR5dlYCSUhwcD628pRllm7n+E+YTzJw=="],
+
+    "source-map": ["source-map@0.6.1", "", {}, "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g=="],
+
     "three": ["three@0.165.0", "", {}, "sha512-cc96IlVYGydeceu0e5xq70H8/yoVT/tXBxV/W8A/U6uOq7DXc4/s1Mkmnu6SqoYGhSRWWYFOhVwvq6V0VtbplA=="],
 
+    "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
     "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
 
     "undici-types": ["undici-types@5.26.5", "", {}, "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA=="],

package/dist/api/browser/webviewtag.ts

@@ -73,6 +73,9 @@ interface WebviewTagElement extends HTMLElement {
 	openDevTools(): void;
 	closeDevTools(): void;
 	toggleDevTools(): void;
+
+	// JavaScript execution
+	executeJavascript(js: string): void;
 }
 
 // Augment global types so querySelector('electrobun-webview') returns WebviewTagElement

package/dist/api/bun/ElectrobunConfig.ts

@@ -58,6 +58,23 @@ export interface ElectrobunConfig {
 		urlSchemes?: string[];
 	};
 
+	/**
+	 * Bunny Ears / Carrot packaging metadata.
+	 * This lets an Electrobun app also declare how it should behave when distributed as a Carrot.
+	 */
+	bunny?: {
+		carrot?: {
+			/**
+			 * Carrot dependencies keyed by carrot id.
+			 * Supports npm-style specifiers such as:
+			 * - `file:../foundation-carrots/pty`
+			 * - `workspace:*`
+			 * - `^0.1.0`
+			 */
+			dependencies?: Record<string, string>;
+		};
+	};
+
 	/**
 	 * Build configuration options
 	 */
@@ -167,6 +184,20 @@ export interface ElectrobunConfig {
 		 */
 		locales?: string[] | "*";
 
+		/**
+		 * Additional file or directory paths to watch for changes during `electrobun dev --watch`.
+		 * Paths are relative to the project root.
+		 * Useful for files that affect your build but aren't listed as entrypoints or copy sources.
+		 */
+		watch?: string[];
+
+		/**
+		 * Glob patterns for files that should not trigger a rebuild when changed.
+		 * Patterns are matched against project-relative paths.
+		 * The `build/`, `artifacts/`, and `node_modules/` directories are always ignored automatically.
+		 */
+		watchIgnore?: string[];
+
 		/**
 		 * macOS-specific build configuration
 		 */
@@ -177,6 +208,13 @@ export interface ElectrobunConfig {
 			 */
 			codesign?: boolean;
 
+			/**
+			 * Create a DMG artifact for macOS builds.
+			 * Disable this for local prototype builds that only need the app bundle and update archive.
+			 * @default true
+			 */
+			createDmg?: boolean;
+
 			/**
 			 * Enable notarization for macOS builds (requires codesign)
 			 * @default false
@@ -204,17 +242,19 @@ export interface ElectrobunConfig {
 			/**
 			 * Custom Chromium command-line flags to pass to CEF during initialization.
 			 * Keys are flag names without the "--" prefix.
-			 * Use `true` for switch-only flags, or a string for flags that take a value.
+			 * - `true` — add a switch-only flag
+			 * - `"value"` — add a flag with a value
+			 * - `false` — remove a default flag set by Electrobun
 			 *
 			 * @example
 			 * ```typescript
 			 * chromiumFlags: {
-			 *   "disable-gpu": true,                // --disable-gpu
+			 *   "disable-gpu": false,               // remove Electrobun's default --disable-gpu
 			 *   "remote-debugging-port": "9333",    // --remote-debugging-port=9333
 			 * }
 			 * ```
 			 */
-			chromiumFlags?: Record<string, string | true>;
+			chromiumFlags?: Record<string, string | boolean>;
 
 			/**
 			 * macOS entitlements for code signing
@@ -253,17 +293,19 @@ export interface ElectrobunConfig {
 			/**
 			 * Custom Chromium command-line flags to pass to CEF during initialization.
 			 * Keys are flag names without the "--" prefix.
-			 * Use `true` for switch-only flags, or a string for flags that take a value.
+			 * - `true` — add a switch-only flag
+			 * - `"value"` — add a flag with a value
+			 * - `false` — remove a default flag set by Electrobun
 			 *
 			 * @example
 			 * ```typescript
 			 * chromiumFlags: {
-			 *   "disable-gpu": true,                // --disable-gpu
+			 *   "disable-gpu": false,               // remove Electrobun's default --disable-gpu
 			 *   "remote-debugging-port": "9333",    // --remote-debugging-port=9333
 			 * }
 			 * ```
 			 */
-			chromiumFlags?: Record<string, string | true>;
+			chromiumFlags?: Record<string, string | boolean>;
 
 			/**
 			 * Path to application icon (.ico format)
@@ -300,17 +342,19 @@ export interface ElectrobunConfig {
 			/**
 			 * Custom Chromium command-line flags to pass to CEF during initialization.
 			 * Keys are flag names without the "--" prefix.
-			 * Use `true` for switch-only flags, or a string for flags that take a value.
+			 * - `true` — add a switch-only flag
+			 * - `"value"` — add a flag with a value
+			 * - `false` — remove a default flag set by Electrobun
 			 *
 			 * @example
 			 * ```typescript
 			 * chromiumFlags: {
-			 *   "disable-gpu": true,                // --disable-gpu
+			 *   "disable-gpu": false,               // remove Electrobun's default --disable-gpu
 			 *   "remote-debugging-port": "9333",    // --remote-debugging-port=9333
 			 * }
 			 * ```
 			 */
-			chromiumFlags?: Record<string, string | true>;
+			chromiumFlags?: Record<string, string | boolean>;
 
 			/**
 			 * Path to application icon (PNG format recommended)

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

@@ -22,6 +22,7 @@ export type BrowserViewOptions<T = undefined> = {
 	url: string | null;
 	html: string | null;
 	preload: string | null;
+	viewsRoot: string | null;
 	renderer: "native" | "cef";
 	partition: string | null;
 	frame: {
@@ -54,6 +55,7 @@ const defaultOptions: Partial<BrowserViewOptions> = {
 	url: null,
 	html: null,
 	preload: null,
+	viewsRoot: null,
 	renderer: buildConfig.defaultRenderer,
 	frame: {
 		x: 0,
@@ -75,6 +77,7 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 	url: string | null = null;
 	html: string | null = null;
 	preload: string | null = null;
+	viewsRoot: string | null = null;
 	partition: string | null = null;
 	autoResize: boolean = true;
 	frame: {
@@ -106,6 +109,7 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		this.url = options.url || defaultOptions.url || null;
 		this.html = options.html || defaultOptions.html || null;
 		this.preload = options.preload || defaultOptions.preload || null;
+		this.viewsRoot = options.viewsRoot || defaultOptions.viewsRoot || null;
 		this.frame = {
 			x: options.frame?.x ?? defaultOptions.frame!.x,
 			y: options.frame?.y ?? defaultOptions.frame!.y,
@@ -130,22 +134,11 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		BrowserViewMap[this.id] = this;
 		this.ptr = this.init() as Pointer;
 
-		// If HTML content was provided, load it after webview creation
+		// If HTML content was provided, load it after webview creation.
 		if (this.html) {
-			console.log(
-				`DEBUG: BrowserView constructor triggering loadHTML for webview ${this.id}`,
-			);
-			// Small delay to ensure webview is ready
 			setTimeout(() => {
-				console.log(
-					`DEBUG: BrowserView delayed loadHTML for webview ${this.id}`,
-				);
 				this.loadHTML(this.html!);
-			}, 100); // Back to 100ms since we fixed the race condition
-		} else {
-			console.log(
-				`DEBUG: BrowserView constructor - no HTML provided for webview ${this.id}`,
-			);
+			}, 100);
 		}
 	}
 
@@ -166,6 +159,7 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 			url: this.html ? null : this.url,
 			html: this.html,
 			preload: this.preload,
+			viewsRoot: this.viewsRoot,
 			frame: {
 				width: this.frame.width,
 				height: this.frame.height,
@@ -279,6 +273,22 @@ export class BrowserView<T extends RPCWithTransport = RPCWithTransport> {
 		native.symbols.webviewToggleDevTools(this.ptr);
 	}
 
+	/**
+	 * Set the page zoom level (WebKit only, similar to browser zoom).
+	 * @param zoomLevel - The zoom level (1.0 = 100%, 1.5 = 150%, etc.)
+	 */
+	setPageZoom(zoomLevel: number) {
+		native.symbols.webviewSetPageZoom(this.ptr, zoomLevel);
+	}
+
+	/**
+	 * Get the current page zoom level.
+	 * @returns The current zoom level (1.0 = 100%)
+	 */
+	getPageZoom(): number {
+		return native.symbols.webviewGetPageZoom(this.ptr) as number;
+	}
+
 	// todo (yoav): move this to a class that also has off, append, prepend, etc.
 	// name should only allow browserView events
 	// Note: normalize event names to willNavigate instead of ['will-navigate'] to save

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

@@ -22,6 +22,7 @@ export type WindowOptionsType<T = undefined> = {
 	url: string | null;
 	html: string | null;
 	preload: string | null;
+	viewsRoot: string | null;
 	renderer: "native" | "cef";
 	rpc?: T;
 	styleMask?: {};
@@ -32,6 +33,9 @@ export type WindowOptionsType<T = undefined> = {
 	titleBarStyle: "hidden" | "hiddenInset" | "default";
 	// transparent: when true, window background is transparent (see-through)
 	transparent: boolean;
+	// passthrough: when true, mouse events pass through transparent regions
+	passthrough: boolean;
+	hidden?: boolean;
 	navigationRules: string | null;
 	// Sandbox mode: when true, disables RPC and only allows event emission
 	// Use for untrusted content (remote URLs) to prevent malicious sites from
@@ -50,9 +54,12 @@ const defaultOptions: WindowOptionsType = {
 	url: "https://electrobun.dev",
 	html: null,
 	preload: null,
+	viewsRoot: null,
 	renderer: buildConfig.defaultRenderer,
 	titleBarStyle: "default",
 	transparent: false,
+	passthrough: false,
+	hidden: false,
 	navigationRules: null,
 	sandbox: false,
 };
@@ -111,8 +118,11 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 	url: string | null = null;
 	html: string | null = null;
 	preload: string | null = null;
+	viewsRoot: string | null = null;
 	renderer: "native" | "cef" = "native";
 	transparent: boolean = false;
+	passthrough: boolean = false;
+	hidden: boolean = false;
 	navigationRules: string | null = null;
 	// Sandbox mode disables RPC and only allows event emission (for untrusted content)
 	sandbox: boolean = false;
@@ -138,8 +148,11 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 		this.url = options.url || null;
 		this.html = options.html || null;
 		this.preload = options.preload || null;
+		this.viewsRoot = options.viewsRoot || null;
 		this.renderer = options.renderer || defaultOptions.renderer;
 		this.transparent = options.transparent ?? false;
+		this.passthrough = options.passthrough ?? false;
+		this.hidden = options.hidden ?? false;
 		this.navigationRules = options.navigationRules || null;
 		this.sandbox = options.sandbox ?? false;
 
@@ -151,6 +164,7 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 		styleMask,
 		titleBarStyle,
 		transparent,
+		hidden,
 	}: Partial<WindowOptionsType<T>>) {
 		this.ptr = ffi.request.createWindow({
 			id: this.id,
@@ -193,6 +207,7 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 			},
 			titleBarStyle: titleBarStyle || "default",
 			transparent: transparent ?? false,
+			hidden: hidden ?? false,
 		}) as Pointer;
 
 		BrowserWindowMap[this.id] = this;
@@ -206,6 +221,7 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 			url: this.url,
 			html: this.html,
 			preload: this.preload,
+			viewsRoot: this.viewsRoot,
 			// frame: this.frame,
 			renderer: this.renderer,
 			frame: {
@@ -222,10 +238,9 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 			windowId: this.id,
 			navigationRules: this.navigationRules,
 			sandbox: this.sandbox,
+			startPassthrough: this.passthrough,
 		});
 
-		console.log("setting webviewId: ", webview.id);
-
 		this.webviewId = webview.id;
 	}
 
@@ -295,6 +310,14 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 	isAlwaysOnTop(): boolean {
 		return ffi.request.isWindowAlwaysOnTop({ winId: this.id });
 	}
+	
+	setVisibleOnAllWorkspaces(visibleOnAllWorkspaces: boolean) {
+		return ffi.request.setWindowVisibleOnAllWorkspaces({ winId: this.id, visibleOnAllWorkspaces });
+	}
+	
+	isVisibleOnAllWorkspaces(): boolean {
+		return ffi.request.isWindowVisibleOnAllWorkspaces({ winId: this.id });
+	}
 
 	setPosition(x: number, y: number) {
 		this.frame.x = x;
@@ -330,6 +353,22 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
 		return { width: frame.width, height: frame.height };
 	}
 
+	/**
+	 * Set the page zoom level for the window's webview (WebKit only).
+	 * @param zoomLevel - The zoom level (1.0 = 100%, 1.5 = 150%, etc.)
+	 */
+	setPageZoom(zoomLevel: number) {
+		this.webview?.setPageZoom(zoomLevel);
+	}
+
+	/**
+	 * Get the current page zoom level for the window's webview.
+	 * @returns The current zoom level (1.0 = 100%)
+	 */
+	getPageZoom(): number {
+		return this.webview?.getPageZoom() ?? 1.0;
+	}
+
 	// todo (yoav): move this to a class that also has off, append, prepend, etc.
 	// name should only allow browserWindow events
 	on(name: string, handler: (event: unknown) => void) {

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

@@ -1,4 +1,8 @@
-// TODO: have a context specific menu that excludes role
+// Context menus intentionally share ApplicationMenuItemConfig for now:
+// - macOS supports role-based context menu items.
+// - Windows has partial role behavior.
+// - Linux showContextMenu is currently unsupported.
+// Keep role typed here to avoid removing working macOS capability.
 import { ffi, type ApplicationMenuItemConfig } from "../proc/native";
 import electrobunEventEmitter from "../events/eventEmitter";
 import { roleLabelMap } from "./menuRoles";

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

@@ -1,4 +1,4 @@
-import { ffi, type MenuItemConfig } from "../proc/native";
+import { ffi, type MenuItemConfig, type Rectangle } from "../proc/native";
 import electrobunEventEmitter from "../events/eventEmitter";
 import { VIEWS_FOLDER } from "./Paths";
 import { join } from "path";
@@ -23,6 +23,13 @@ export type TrayOptions = {
 export class Tray {
 	id: number = nextTrayId++;
 	ptr: Pointer | null = null;
+	visible = true;
+	title = "";
+	image = "";
+	template = true;
+	width = 16;
+	height = 16;
+	menu: Array<MenuItemConfig> | null = null;
 
 	constructor({
 		title = "",
@@ -31,24 +38,43 @@ export class Tray {
 		width = 16,
 		height = 16,
 	}: TrayOptions = {}) {
+		this.title = title;
+		this.image = image;
+		this.template = template;
+		this.width = width;
+		this.height = height;
+
+		this.createNativeTray();
+
+		TrayMap[this.id] = this;
+	}
+
+	private createNativeTray() {
 		try {
 			this.ptr = ffi.request.createTray({
 				id: this.id,
-				title,
-				image: this.resolveImagePath(image),
-				template,
-				width,
-				height,
+				title: this.title,
+				image: this.resolveImagePath(this.image),
+				template: this.template,
+				width: this.width,
+				height: this.height,
 			}) as Pointer;
+			this.visible = true;
 		} catch (error) {
 			console.warn("Tray creation failed:", error);
 			console.warn(
 				"System tray functionality may not be available on this platform",
 			);
 			this.ptr = null;
+			this.visible = false;
 		}
 
-		TrayMap[this.id] = this;
+		if (this.ptr && this.menu) {
+			ffi.request.setTrayMenu({
+				id: this.id,
+				menuConfig: JSON.stringify(menuConfigWithDefaults(this.menu)),
+			});
+		}
 	}
 
 	resolveImagePath(imgPath: string) {
@@ -61,11 +87,13 @@ export class Tray {
 	}
 
 	setTitle(title: string) {
+		this.title = title;
 		if (!this.ptr) return;
 		ffi.request.setTrayTitle({ id: this.id, title });
 	}
 
 	setImage(imgPath: string) {
+		this.image = imgPath;
 		if (!this.ptr) return;
 		ffi.request.setTrayImage({
 			id: this.id,
@@ -74,6 +102,7 @@ export class Tray {
 	}
 
 	setMenu(menu: Array<MenuItemConfig>) {
+		this.menu = menu;
 		if (!this.ptr) return;
 		const menuWithDefaults = menuConfigWithDefaults(menu);
 		ffi.request.setTrayMenu({
@@ -87,11 +116,34 @@ export class Tray {
 		electrobunEventEmitter.on(specificName, handler);
 	}
 
+	setVisible(visible: boolean) {
+		if (visible === this.visible) {
+			return;
+		}
+
+		if (!visible) {
+			if (this.ptr) {
+				ffi.request.removeTray({ id: this.id });
+				this.ptr = null;
+			}
+			this.visible = false;
+			return;
+		}
+
+		this.createNativeTray();
+	}
+
+	getBounds(): Rectangle {
+		return ffi.request.getTrayBounds({ id: this.id });
+	}
+
 	remove() {
 		console.log("Tray.remove() called for id:", this.id);
 		if (this.ptr) {
 			ffi.request.removeTray({ id: this.id });
+			this.ptr = null;
 		}
+		this.visible = false;
 		delete TrayMap[this.id];
 		console.log("Tray removed from TrayMap");
 	}

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

@@ -4,7 +4,7 @@ import {
 	renameSync,
 	unlinkSync,
 	mkdirSync,
-	rmdirSync,
+	rmSync,
 	statSync,
 	readdirSync,
 } from "fs";
@@ -145,7 +145,7 @@ function cleanupExtractionFolder(
 			try {
 				const s = statSync(fullPath);
 				if (s.isDirectory()) {
-					rmdirSync(fullPath, { recursive: true });
+					rmSync(fullPath, { recursive: true });
 				} else {
 					unlinkSync(fullPath);
 				}
@@ -895,7 +895,7 @@ const Updater = {
 					if (currentOS === "macos") {
 						// Remove existing app before installing the new one
 						if (statSync(runningAppBundlePath, { throwIfNoEntry: false })) {
-							rmdirSync(runningAppBundlePath, { recursive: true });
+							rmSync(runningAppBundlePath, { recursive: true });
 						}
 
 						emitStatus("replacing-app", "Installing new version...");
@@ -920,7 +920,7 @@ const Updater = {
 						
 						// Remove existing app directory if it exists
 						if (statSync(appBundleDir, { throwIfNoEntry: false })) {
-							rmdirSync(appBundleDir, { recursive: true });
+							rmSync(appBundleDir, { recursive: true });
 						}
 
 						// Move new app bundle directory to app location

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

@@ -53,6 +53,14 @@ export const openPath = (path: string): boolean => {
 	return ffi.request.openPath({ path });
 };
 
+export const setDockIconVisible = (visible: boolean): void => {
+	ffi.request.setDockIconVisible({ visible });
+};
+
+export const isDockIconVisible = (): boolean => {
+	return ffi.request.isDockIconVisible();
+};
+
 export type NotificationOptions = {
 	/**
 	 * The title of the notification (required)

package/dist/api/bun/events/ApplicationEvents.ts

@@ -16,6 +16,7 @@ export default {
 		),
 	openUrl: (data: OpenUrlData) =>
 		new ElectrobunEvent<OpenUrlData, void>("open-url", data),
+	reopen: (data: {}) => new ElectrobunEvent<{}, void>("reopen", data),
 	beforeQuit: (data: {}) =>
 		new ElectrobunEvent<{}, { allow: boolean }>("before-quit", data),
 };