electrobun 0.0.19-beta.99 → 0.1.0

package/README.md

@@ -20,7 +20,7 @@ Visit <a href="https://www.electrobun.dev/">Electrobun.dev</a> to see api docume
 - Write typescript for the main process and webviews without having to think about it.
 - Isolation between main and webview processes with fast, typed, easy to implement RPC between them.
 - Small self-extracting app bundles ~12MB (when using system webview, most of this is the bun runtime)
-- Even smaller app updates as small as 4KB (using bsdiff it only downloads tiny patches between versions)
+- Even smaller app updates as small as 14KB (using bsdiff it only downloads tiny patches between versions)
 - Provide everything you need in one tightly integrated workflow to start writing code in 5 minutes and distribute in 10.
 
 ## Architecture

package/dist/api/browser/webviewtag.ts

@@ -54,6 +54,7 @@ const ConfigureWebviewTags = (
     hiddenMirrorMode: boolean = false;
     wasZeroRect: boolean = false;
     isMirroring: boolean = false;
+    masks: string = '';
 
     partition: string | null = null;
 
@@ -83,7 +84,15 @@ const ConfigureWebviewTags = (
       this.lastRect = rect;
 
       const url = this.src || this.getAttribute("src");
-      const html = this.html || this.getAttribute("html");      
+      const html = this.html || this.getAttribute("html");   
+      
+      const maskSelectors = this.masks || this.getAttribute("masks");
+
+      if (maskSelectors) {
+        maskSelectors.split(',').forEach(s => {
+          this.maskSelectors.add(s);
+        })
+      }
 
       const webviewId = await this.internalRpc.request.webviewTagInit({        
         hostWebviewId: window.__electrobunWebviewId,
@@ -371,7 +380,12 @@ const ConfigureWebviewTags = (
       // this.mutationObserver?.disconnect();
       window.removeEventListener("resize", this.boundForceSyncDimensions);
       window.removeEventListener("scroll", this.boundSyncDimensions);
-      this.internalRpc.send.webviewTagRemove({ id: this.webviewId });
+      
+      if (this.webviewId) {
+        this.internalRpc.send.webviewTagRemove({ id: this.webviewId });
+        // Mark webview as removed to prevent further method calls
+        this.webviewId = undefined;
+      }
     }
 
     static get observedAttributes() {
@@ -393,6 +407,7 @@ const ConfigureWebviewTags = (
 
     updateIFrameSrc(src: string) {
       if (!this.webviewId) {
+        console.warn('updateIFrameSrc called on removed webview');
         return;
       }
       this.internalRpc.send.webviewTagUpdateSrc({
@@ -403,6 +418,7 @@ const ConfigureWebviewTags = (
 
     updateIFrameHtml(html: string) {
       if (!this.webviewId) {
+        console.warn('updateIFrameHtml called on removed webview');
         return;
       }
       
@@ -414,6 +430,7 @@ const ConfigureWebviewTags = (
 
     updateIFramePreload(preload: string) {
       if (!this.webviewId) {
+        console.warn('updateIFramePreload called on removed webview');
         return;
       }
       this.internalRpc.send.webviewTagUpdatePreload({
@@ -423,17 +440,33 @@ const ConfigureWebviewTags = (
     }
 
     goBack() {
+      if (!this.webviewId) {
+        console.warn('goBack called on removed webview');
+        return;
+      }
       this.internalRpc.send.webviewTagGoBack({ id: this.webviewId });
     }
 
     goForward() {
+      if (!this.webviewId) {
+        console.warn('goForward called on removed webview');
+        return;
+      }
       this.internalRpc.send.webviewTagGoForward({ id: this.webviewId });
     }
 
     reload() {
+      if (!this.webviewId) {
+        console.warn('reload called on removed webview');
+        return;
+      }
       this.internalRpc.send.webviewTagReload({ id: this.webviewId });
     }
     loadURL(url: string) {
+      if (!this.webviewId) {
+        console.warn('loadURL called on removed webview');
+        return;
+      }
       this.setAttribute("src", url);
       this.internalRpc.send.webviewTagUpdateSrc({
         id: this.webviewId,
@@ -441,6 +474,10 @@ const ConfigureWebviewTags = (
       });
     }
     loadHTML(html: string) {
+      if (!this.webviewId) {
+        console.warn('loadHTML called on removed webview');
+        return;
+      }
       this.setAttribute("html", html);
       this.internalRpc.send.webviewTagUpdateHtml({
         id: this.webviewId,
@@ -450,6 +487,11 @@ const ConfigureWebviewTags = (
 
     // This sets the native webview hovering over the dom to be transparent
     toggleTransparent(transparent?: boolean, bypassState?: boolean) {
+      if (!this.webviewId) {
+        console.warn('toggleTransparent called on removed webview');
+        return;
+      }
+
       if (!bypassState) {
         if (typeof transparent === "undefined") {
           this.transparent = !this.transparent;
@@ -464,6 +506,11 @@ const ConfigureWebviewTags = (
       });
     }
     togglePassthrough(enablePassthrough?: boolean, bypassState?: boolean) {
+      if (!this.webviewId) {
+        console.warn('togglePassthrough called on removed webview');
+        return;
+      }
+
       if (!bypassState) {
         if (typeof enablePassthrough === "undefined") {
           this.passthroughEnabled = !this.passthroughEnabled;
@@ -480,6 +527,11 @@ const ConfigureWebviewTags = (
     }
 
     toggleHidden(hidden?: boolean, bypassState?: boolean) {
+      if (!this.webviewId) {
+        console.warn('toggleHidden called on removed webview');
+        return;
+      }
+
       if (!bypassState) {
         if (typeof hidden === "undefined") {
           this.hidden = !this.hidden;

package/dist/api/bun/ElectrobunConfig.ts

@@ -0,0 +1,171 @@
+/**
+ * Electrobun configuration type definitions
+ * Used in electrobun.config.ts files
+ */
+
+export interface ElectrobunConfig {
+  /**
+   * Application metadata configuration
+   */
+  app: {
+    /**
+     * The display name of your application
+     */
+    name: string;
+    
+    /**
+     * Unique identifier for your application (e.g., "com.example.myapp")
+     * Used for platform-specific identifiers
+     */
+    identifier: string;
+    
+    /**
+     * Application version string (e.g., "1.0.0")
+     */
+    version: string;
+  };
+
+  /**
+   * Build configuration options
+   */
+  build?: {
+        /**
+     * Bun process build configuration
+     */
+    bun?: {
+      /**
+       * Entry point for the main Bun process
+       * @default "src/bun/index.ts"
+       */
+      entrypoint?: string;
+      
+      /**
+       * External modules to exclude from bundling
+       * @default []
+       */
+      external?: string[];
+    };
+
+    /**
+     * Browser view build configurations
+     */
+    views?: {
+      [viewName: string]: {
+        /**
+         * Entry point for this view's TypeScript code
+         */
+        entrypoint: string;
+        
+        /**
+         * External modules to exclude from bundling for this view
+         */
+        external?: string[];
+      };
+    };
+
+    /**
+     * Files to copy directly to the build output
+     * Key is source path, value is destination path
+     */
+    copy?: {
+      [sourcePath: string]: string;
+    };
+    /**
+     * Output folder for built application
+     * @default "build"
+     */
+    buildFolder?: string;
+    
+    /**
+     * Output folder for distribution artifacts
+     * @default "artifacts"
+     */
+    artifactFolder?: string;
+    
+    /**
+     * Build targets to compile for
+     * Can be "current", "all", or comma-separated list like "macos-arm64,win-x64"
+     */
+    targets?: string;
+
+    /**
+     * macOS-specific build configuration
+     */
+    mac?: {
+      /**
+       * Enable code signing for macOS builds
+       * @default false
+       */
+      codesign?: boolean;
+      
+      /**
+       * Enable notarization for macOS builds (requires codesign)
+       * @default false
+       */
+      notarize?: boolean;
+      
+      /**
+       * Bundle CEF (Chromium Embedded Framework) instead of using system WebView
+       * @default false
+       */
+      bundleCEF?: boolean;
+      
+      /**
+       * macOS entitlements for code signing
+       */
+      entitlements?: Record<string, boolean | string>;
+      
+      /**
+       * Path to .iconset folder containing app icons
+       * @default "icon.iconset"
+       */
+      icons?: string;
+    };
+
+    /**
+     * Windows-specific build configuration
+     */
+    win?: {
+      /**
+       * Bundle CEF (Chromium Embedded Framework) instead of using WebView2
+       * @default false
+       */
+      bundleCEF?: boolean;
+    };
+
+    /**
+     * Linux-specific build configuration
+     */
+    linux?: {
+      /**
+       * Bundle CEF (Chromium Embedded Framework) instead of using GTKWebKit
+       * Recommended on Linux for advanced layer compositing features
+       * @default false
+       */
+      bundleCEF?: boolean;
+    };
+  };
+
+  /**
+   * Build scripts configuration
+   */
+  scripts?: {
+    /**
+     * Script to run after build completes
+     * Can be a path to a script file
+     */
+    postBuild?: string;
+  };
+
+  /**
+   * Release and distribution configuration
+   */
+  release?: {
+    /**
+     * Base URL for artifact distribution (e.g., S3 bucket URL)
+     * Used for auto-updates and patch generation
+     */
+    bucketUrl?: string;
+  };
+}
+

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

@@ -182,6 +182,10 @@ export class BrowserWindow<T> {
     return ffi.request.closeWindow({ winId: this.id });
   }
 
+  focus() {
+    return ffi.request.focusWindow({ winId: this.id });
+  }
+
   // todo (yoav): move this to a class that also has off, append, prepend, etc.
   // name should only allow browserWindow events
   on(name, handler) {

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

@@ -73,6 +73,13 @@ export class Tray {
     electrobunEventEmitter.on(specificName, handler);
   }
 
+  remove() {
+    console.log('Tray.remove() called for id:', this.id);
+    ffi.request.removeTray({ id: this.id });
+    delete TrayMap[this.id];
+    console.log('Tray removed from TrayMap');
+  }
+
   static getById(id: number) {
     return TrayMap[id];
   }
@@ -80,6 +87,13 @@ export class Tray {
   static getAll() {
     return Object.values(TrayMap);
   }
+
+  static removeById(id: number) {
+    const tray = TrayMap[id];
+    if (tray) {
+      tray.remove();
+    }
+  }
 }
 
 const menuConfigWithDefaults = (

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

@@ -1,4 +1,4 @@
-import { join, dirname, resolve, basename } from "path";
+import { join, dirname, resolve, basename, relative } from "path";
 import { homedir } from "os";
 import { renameSync, unlinkSync, mkdirSync, rmdirSync, statSync, readdirSync, cpSync } from "fs";
 import { execSync } from "child_process";
@@ -379,9 +379,10 @@ const Updater = {
         if (currentOS === 'win') {
           console.log(`Using Windows native tar.exe to extract ${latestTarPath} to ${extractionDir}...`);
           try {
-            execSync(`tar -xf "${latestTarPath}" -C "${extractionDir}"`, { 
+            const relativeTarPath = relative(extractionDir, latestTarPath);
+            execSync(`tar -xf "${relativeTarPath}"`, { 
               stdio: 'inherit',
-              cwd: extractionDir 
+              cwd: extractionDir
             });
             console.log('Windows tar.exe extraction completed successfully');
             

package/dist/api/bun/index.ts

@@ -10,11 +10,13 @@ import { type RPCSchema, createRPC } from "rpc-anywhere";
 import type ElectrobunEvent from "./events/event";
 import * as PATHS from "./core/Paths";
 import * as Socket from "./core/Socket";
+import type { ElectrobunConfig } from "./ElectrobunConfig";
 
 // Named Exports
 export {
   type RPCSchema,
   type ElectrobunEvent,
+  type ElectrobunConfig,
   createRPC,
   BrowserWindow,
   BrowserView,

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

@@ -49,6 +49,12 @@ export const native = (() => {
         ],
         returns: FFIType.void,
       },
+      closeNSWindow: {
+        args: [
+          FFIType.ptr, // window ptr
+        ],
+        returns: FFIType.void,
+      },
       // webview
       initWebview: {
         args: [
@@ -180,6 +186,10 @@ export const native = (() => {
         args: [FFIType.ptr, FFIType.cstring],
         returns: FFIType.void
       },
+      removeTray: {
+        args: [FFIType.ptr],
+        returns: FFIType.void
+      },
       setApplicationMenu: {
         args: [FFIType.cstring, FFIType.function],
         returns: FFIType.void
@@ -345,7 +355,10 @@ export const ffi = {
         }
         
         native.symbols.setNSWindowTitle(windowPtr, toCString(title));        
+        // setTimeout(() => {
+          // console.log('calling makeNSWindowKeyAndOrderFront', windowPtr)
         native.symbols.makeNSWindowKeyAndOrderFront(windowPtr);
+        // }, 1000)
 
         return windowPtr;
       },
@@ -360,6 +373,29 @@ export const ffi = {
         
         native.symbols.setNSWindowTitle(windowPtr, toCString(title));        
       },
+      
+      closeWindow: (params: {winId: number}) => {
+        const {winId} = params;
+        const windowPtr = BrowserWindow.getById(winId)?.ptr;
+        
+        if (!windowPtr) {
+          throw `Can't close window. Window no longer exists`;
+        }
+        
+        native.symbols.closeNSWindow(windowPtr);
+        // Note: Cleanup of BrowserWindowMap happens in the windowCloseCallback
+      },
+
+      focusWindow: (params: {winId: number}) => {
+        const {winId} = params;
+        const windowPtr = BrowserWindow.getById(winId)?.ptr;
+        
+        if (!windowPtr) {
+          throw `Can't focus window. Window no longer exists`;
+        }
+        
+        native.symbols.makeNSWindowKeyAndOrderFront(windowPtr);
+      },
 
       createWebview: (params: {
         id: number;
@@ -653,6 +689,22 @@ export const ffi = {
           toCString(menuConfig)
         );
       },
+
+      removeTray: (params: { id: number }): void => {
+        const { id } = params;
+        console.log('removeTray called with id:', id);
+        const tray = Tray.getById(id);
+        console.log('Found tray:', tray);
+        
+        if (!tray) {
+          throw `Can't remove tray. Tray no longer exists`;
+        }
+        
+        console.log('Calling native.symbols.removeTray with ptr:', tray.ptr);
+        native.symbols.removeTray(tray.ptr);
+        console.log('Native removeTray called successfully');
+        // The Tray class will handle removing from TrayMap
+      },
       setApplicationMenu: (params: {menuConfig: string}): void => {
         const {
           menuConfig
@@ -725,6 +777,16 @@ process.on('unhandledRejection', (reason, promise) => {
   console.error('Unhandled rejection in worker:', reason);
 });
 
+process.on('SIGINT', () => {
+  console.log('[electrobun] Received SIGINT, calling killApp() for graceful shutdown...');
+  native.symbols.killApp();
+});
+
+process.on('SIGTERM', () => {
+  console.log('[electrobun] Received SIGTERM, calling killApp() for graceful shutdown...');
+  native.symbols.killApp();
+});
+
 
 
 
@@ -1110,6 +1172,7 @@ export const internalRpcHandlers = {
     },  
     webviewTagCallAsyncJavaScript: (params) => {
       console.log('-----------+ request: ', 'webviewTagCallAsyncJavaScript', params)
+      // Not implemented - users can use RPC for JavaScript execution if needed
     }
   },
   message: {
@@ -1126,33 +1189,60 @@ export const internalRpcHandlers = {
       native.symbols.resizeWebview(webviewPtr, x, y, width, height, toCString(params.masks))
     },      
     webviewTagUpdateSrc: (params) => {
-      const webviewPtr = BrowserView.getById(params.id)?.ptr;
-      native.symbols.loadURLInWebView(webviewPtr, toCString(params.url))      
+      const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagUpdateSrc: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
+      native.symbols.loadURLInWebView(webview.ptr, toCString(params.url));      
     },
     webviewTagUpdateHtml: (params) => {      
-      const webview = BrowserView.getById(params.id);   
-      webview.loadHTML(params.html) 
+      const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagUpdateHtml: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }   
+      webview.loadHTML(params.html);
       webview.html = params.html;
-      
     },
     webviewTagUpdatePreload: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagUpdatePreload: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.updatePreloadScriptToWebView(webview.ptr, toCString('electrobun_custom_preload_script'), toCString(params.preload), true);
     },
     webviewTagGoBack: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagGoBack: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.webviewGoBack(webview.ptr);
     },
     webviewTagGoForward: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagGoForward: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.webviewGoForward(webview.ptr);
     },
     webviewTagReload: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagReload: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.webviewReload(webview.ptr);
     },
     webviewTagRemove: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagRemove: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.webviewRemove(webview.ptr);
     },
     startWindowMove: (params) => {
@@ -1164,14 +1254,26 @@ export const internalRpcHandlers = {
     },
     webviewTagSetTransparent: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagSetTransparent: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.webviewSetTransparent(webview.ptr, params.transparent);
     },
     webviewTagSetPassthrough: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagSetPassthrough: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.webviewSetPassthrough(webview.ptr, params.enablePassthrough);
     },
     webviewTagSetHidden: (params) => {
       const webview = BrowserView.getById(params.id);
+      if (!webview || !webview.ptr) {
+        console.error(`webviewTagSetHidden: BrowserView not found or has no ptr for id ${params.id}`);
+        return;
+      }
       native.symbols.webviewSetHidden(webview.ptr, params.hidden);
     },
     webviewEvent: (params) => {

package/dist/main.js

@@ -5,11 +5,12 @@ var __require = import.meta.require;
 import { join, dirname, resolve } from "path";
 import { dlopen, suffix } from "bun:ffi";
 import { existsSync } from "fs";
-var libPath = `./libNativeWrapper.${suffix}`;
+var pathToMacOS = dirname(process.argv0);
+var libPath = join(pathToMacOS, `libNativeWrapper.${suffix}`);
 var absoluteLibPath = resolve(libPath);
 function main() {
   if (process.platform === "linux") {
-    const cefLibs = ["./libcef.so", "./libvk_swiftshader.so"];
+    const cefLibs = [join(pathToMacOS, "libcef.so"), join(pathToMacOS, "libvk_swiftshader.so")];
     const existingCefLibs = cefLibs.filter((lib2) => existsSync(lib2));
     if (existingCefLibs.length > 0 && !process.env.LD_PRELOAD) {
       console.error(`[LAUNCHER] ERROR: CEF libraries found but LD_PRELOAD not set!`);
@@ -45,8 +46,8 @@ function main() {
     }
   }
   const pathToLauncherBin = process.argv0;
-  const pathToMacOS = dirname(pathToLauncherBin);
-  const appEntrypointPath = join(pathToMacOS, "..", "Resources", "app", "bun", "index.js");
+  const pathToBinDir = dirname(pathToLauncherBin);
+  const appEntrypointPath = join(pathToBinDir, "..", "Resources", "app", "bun", "index.js");
   new Worker(appEntrypointPath, {});
   lib.symbols.runNSApplication();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electrobun",
-  "version": "0.0.19-beta.99",
+  "version": "0.1.0",
   "description": "Build ultra fast, tiny, and cross-platform desktop apps with Typescript.",
   "license": "MIT",
   "author": "Blackboard Technologies Inc.",
@@ -36,6 +36,7 @@
     "dev:playground:clean": "cd playground && rm -rf node_modules && npm install && cd .. && bun dev:playground",
     "dev:playground:rerun": "cd playground && bun start",
     "dev:playground:canary": "bun build:release && cd playground && npm install && bun build:canary && bun start:canary",
+    "run:playground": "bun build:dev && bun build:cli && cd templates/interactive-playground && npm install && bun build:dev && bun start",
     "dev:docs": "cd documentation && bun start",
     "build:docs:release": "cd documentation && bun run build",
     "npm:publish": "bun build:release && npm publish",
@@ -45,7 +46,8 @@
     "push:patch": "npm version patch && git push origin main --tags",
     "push:minor": "npm version minor && git push origin main --tags",
     "push:major": "npm version major && git push origin main --tags",
-    "build:push:artifacts": "bun scripts/build-and-upload-artifacts.js"
+    "build:push:artifacts": "bun scripts/build-and-upload-artifacts.js",
+    "test": "bun build:dev && bun build:cli && cd tests && npm install && bun build:dev && bun start"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",