electrobun 0.5.0-beta.0 → 0.6.0-beta.0

package/{templates/multitab-browser/bun.lock → bun.lock}

@@ -2,9 +2,16 @@
   "lockfileVersion": 1,
   "workspaces": {
     "": {
-      "name": "multitab-browser",
+      "name": "electrobun",
       "dependencies": {
-        "electrobun": "file:../../",
+        "@oneidentity/zstd-js": "^1.0.3",
+        "archiver": "^7.0.1",
+        "rpc-anywhere": "1.5.0",
+        "tar": "^6.2.1",
+      },
+      "devDependencies": {
+        "@types/archiver": "^6.0.3",
+        "@types/bun": "1.1.9",
       },
     },
   },
@@ -15,7 +22,7 @@
 
     "@pkgjs/parseargs": ["@pkgjs/parseargs@0.11.0", "", {}, "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg=="],
 
-    "@types/archiver": ["@types/archiver@6.0.3", "", { "dependencies": { "@types/readdir-glob": "*" } }, "sha512-a6wUll6k3zX6qs5KlxIggs1P1JcYJaTCx2gnlr+f0S1yd2DoaEwoIK10HmBaLnZwWneBz+JBm0dwcZu0zECBcQ=="],
+    "@types/archiver": ["@types/archiver@6.0.4", "", { "dependencies": { "@types/readdir-glob": "*" } }, "sha512-ULdQpARQ3sz9WH4nb98mJDYA0ft2A8C4f4fovvUcFwINa1cgGjY36JCAYuP5YypRq4mco1lJp1/7jEMS2oR0Hg=="],
 
     "@types/bun": ["@types/bun@1.1.9", "", { "dependencies": { "bun-types": "1.1.27" } }, "sha512-SXJRejXpmAc3qxyN/YS4/JGWEzLf4dDBa5fLtRDipQXHqNccuMU4EUYCooXNTsylG0DmwFQsGgEDHxZF+3DqRw=="],
 
@@ -37,9 +44,9 @@
 
     "abort-controller": ["abort-controller@3.0.0", "", { "dependencies": { "event-target-shim": "^5.0.0" } }, "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg=="],
 
-    "ansi-regex": ["ansi-regex@6.2.0", "", {}, "sha512-TKY5pyBkHyADOPYlRT9Lx6F544mPl0vS5Ew7BJ45hA08Q+t3GjbueLliBWN3sMICk6+y7HdyxSzC4bWS8baBdg=="],
+    "ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
 
-    "ansi-styles": ["ansi-styles@6.2.1", "", {}, "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug=="],
+    "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
 
     "archiver": ["archiver@7.0.1", "", { "dependencies": { "archiver-utils": "^5.0.2", "async": "^3.2.4", "buffer-crc32": "^1.0.0", "readable-stream": "^4.0.0", "readdir-glob": "^1.1.2", "tar-stream": "^3.0.0", "zip-stream": "^6.0.1" } }, "sha512-ZcbTaIqJOfCc03QwD468Unz/5Ir8ATtvAHsK+FdXbDIbGfihqh9mrvdcYunQzqn4HrvWWaFyaxJhGZagaJJpPQ=="],
 
@@ -47,11 +54,11 @@
 
     "async": ["async@3.2.6", "", {}, "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA=="],
 
-    "b4a": ["b4a@1.6.7", "", {}, "sha512-OnAYlL5b7LEkALw87fUVafQw5rVR9RjwGd4KUwNQ6DrrNmaVaUCgLipfVlzrPQ4tWOR9P0IXGNOx50jYCCdSJg=="],
+    "b4a": ["b4a@1.7.3", "", { "peerDependencies": { "react-native-b4a": "*" }, "optionalPeers": ["react-native-b4a"] }, "sha512-5Q2mfq2WfGuFp3uS//0s6baOJLMoVduPYVeNmDYxu5OUA1/cBfvr2RIS7vi62LdNj/urk1hfmj867I3qt6uZ7Q=="],
 
     "balanced-match": ["balanced-match@1.0.2", "", {}, "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="],
 
-    "bare-events": ["bare-events@2.6.1", "", {}, "sha512-AuTJkq9XmE6Vk0FJVNq5QxETrSA/vKHarWVBG5l/JbdCL1prJemiyJqUS0jrlXO0MftuPq4m3YVYhoNc5+aE/g=="],
+    "bare-events": ["bare-events@2.8.2", "", { "peerDependencies": { "bare-abort-controller": "*" }, "optionalPeers": ["bare-abort-controller"] }, "sha512-riJjyv1/mHLIPX4RwiK+oW9/4c3TEUeORHKefKAKnZ5kyslbN+HXowtbaVEqt4IMUB7OXlfixcs6gsFeo/jhiQ=="],
 
     "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
 
@@ -83,21 +90,21 @@
 
     "eastasianwidth": ["eastasianwidth@0.2.0", "", {}, "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA=="],
 
-    "electrobun": ["electrobun@file:../..", { "dependencies": { "@oneidentity/zstd-js": "^1.0.3", "archiver": "^7.0.1", "rpc-anywhere": "1.5.0", "tar": "^6.2.1" }, "devDependencies": { "@types/archiver": "^6.0.3", "@types/bun": "1.1.9" }, "bin": { "electrobun": "./bin/electrobun.cjs" } }],
-
     "emoji-regex": ["emoji-regex@9.2.2", "", {}, "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg=="],
 
     "event-target-shim": ["event-target-shim@5.0.1", "", {}, "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ=="],
 
     "events": ["events@3.3.0", "", {}, "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q=="],
 
+    "events-universal": ["events-universal@1.0.1", "", { "dependencies": { "bare-events": "^2.7.0" } }, "sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw=="],
+
     "fast-fifo": ["fast-fifo@1.3.2", "", {}, "sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ=="],
 
     "foreground-child": ["foreground-child@3.3.1", "", { "dependencies": { "cross-spawn": "^7.0.6", "signal-exit": "^4.0.1" } }, "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw=="],
 
     "fs-minipass": ["fs-minipass@2.1.0", "", { "dependencies": { "minipass": "^3.0.0" } }, "sha512-V/JgOLFCS+R6Vcq0slCuaeWEdNC3ouDlJMNIsacH2VtALiu9mV4LPrHc5cDl8k5aw6J8jwgWWpiTo5RYhmIzvg=="],
 
-    "glob": ["glob@10.4.5", "", { "dependencies": { "foreground-child": "^3.1.0", "jackspeak": "^3.1.2", "minimatch": "^9.0.4", "minipass": "^7.1.2", "package-json-from-dist": "^1.0.0", "path-scurry": "^1.11.1" }, "bin": { "glob": "dist/esm/bin.mjs" } }, "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg=="],
+    "glob": ["glob@10.5.0", "", { "dependencies": { "foreground-child": "^3.1.0", "jackspeak": "^3.1.2", "minimatch": "^9.0.4", "minipass": "^7.1.2", "package-json-from-dist": "^1.0.0", "path-scurry": "^1.11.1" }, "bin": { "glob": "dist/esm/bin.mjs" } }, "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg=="],
 
     "graceful-fs": ["graceful-fs@4.2.11", "", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="],
 
@@ -127,7 +134,7 @@
 
     "minizlib": ["minizlib@2.1.2", "", { "dependencies": { "minipass": "^3.0.0", "yallist": "^4.0.0" } }, "sha512-bAxsR8BVfj60DWXHE3u30oHzfl4G7khkSuPW+qvpd7jFRHm7dLxOjUk1EHACJ/hxLY8phGJ0YhYHZo7jil7Qdg=="],
 
-    "mkdirp": ["mkdirp@1.0.4", "", { "bin": { "mkdirp": "bin/cmd.js" } }, "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw=="],
+    "mkdirp": ["mkdirp@1.0.4", "", { "bin": "bin/cmd.js" }, "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw=="],
 
     "normalize-path": ["normalize-path@3.0.0", "", {}, "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA=="],
 
@@ -155,7 +162,7 @@
 
     "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
 
-    "streamx": ["streamx@2.22.1", "", { "dependencies": { "fast-fifo": "^1.3.2", "text-decoder": "^1.1.0" }, "optionalDependencies": { "bare-events": "^2.2.0" } }, "sha512-znKXEBxfatz2GBNK02kRnCXjV+AA4kjZIUxeWSr3UGirZMJfTE9uiwKHobnbgxWyL/JWro8tTq+vOqAK1/qbSA=="],
+    "streamx": ["streamx@2.23.0", "", { "dependencies": { "events-universal": "^1.0.0", "fast-fifo": "^1.3.2", "text-decoder": "^1.1.0" } }, "sha512-kn+e44esVfn2Fa/O0CPFcex27fjIL6MkVae0Mm6q+E6f0hWv578YCERbv+4m02cjxvDsPKLnmxral/rR6lBMAg=="],
 
     "string-width": ["string-width@5.1.2", "", { "dependencies": { "eastasianwidth": "^0.2.0", "emoji-regex": "^9.2.2", "strip-ansi": "^7.0.1" } }, "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA=="],
 
@@ -163,7 +170,7 @@
 
     "string_decoder": ["string_decoder@1.3.0", "", { "dependencies": { "safe-buffer": "~5.2.0" } }, "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA=="],
 
-    "strip-ansi": ["strip-ansi@7.1.0", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ=="],
+    "strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
 
     "strip-ansi-cjs": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
 

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

@@ -599,24 +599,92 @@ export const ffi = {
          window.addEventListener('popstate', function(event) {
           emitWebviewEvent('did-navigate-in-page', window.location.href);
          });
-        
+
          window.addEventListener('hashchange', function(event) {
-          emitWebviewEvent('did-navigate-in-page', window.location.href);    
+          emitWebviewEvent('did-navigate-in-page', window.location.href);
          });
-        
-         document.addEventListener('click', function(event) {
-          if ((event.metaKey || event.ctrlKey) && event.target.tagName === 'A') {
-            event.preventDefault();
-            event.stopPropagation();
-        
-            // Get the href of the link
-            const url = event.target.href;        
-            
-            // Open the URL in a new window or tab
-            // Note: we already handle new windows in objc
-            window.open(url, '_blank');
-          }
-        }, true);
+
+         // Track cmd key state for SPA navigation detection
+         let __electrobunCmdKeyHeld = false;
+         let __electrobunCmdKeyTimestamp = 0;
+         const CMD_KEY_THRESHOLD_MS = 500; // How long after cmd release to still consider it a cmd+click
+
+         window.addEventListener('keydown', function(event) {
+           if (event.key === 'Meta' || event.metaKey) {
+             __electrobunCmdKeyHeld = true;
+             __electrobunCmdKeyTimestamp = Date.now();
+           }
+         }, true);
+
+         window.addEventListener('keyup', function(event) {
+           if (event.key === 'Meta') {
+             __electrobunCmdKeyHeld = false;
+             __electrobunCmdKeyTimestamp = Date.now();
+           }
+         }, true);
+
+         // Also track on blur in case key release happens outside window
+         window.addEventListener('blur', function() {
+           __electrobunCmdKeyHeld = false;
+         });
+
+         function __electrobunIsCmdHeld() {
+           if (__electrobunCmdKeyHeld) return true;
+           // Also return true if cmd was released very recently (for race conditions)
+           return (Date.now() - __electrobunCmdKeyTimestamp) < CMD_KEY_THRESHOLD_MS && __electrobunCmdKeyTimestamp > 0;
+         }
+
+         // Intercept cmd+clicks on anchors before SPA frameworks (like Turbo) can handle them
+         // Uses capture phase on window - this fires before document capture listeners
+         window.addEventListener('click', function(event) {
+           if (event.metaKey || event.ctrlKey) {
+             // Find the closest anchor element (handles clicks on nested elements inside <a>)
+             const anchor = event.target.closest('a');
+             if (anchor && anchor.href) {
+               event.preventDefault();
+               event.stopPropagation();
+               event.stopImmediatePropagation();
+               emitWebviewEvent('new-window-open', JSON.stringify({
+                 url: anchor.href,
+                 isCmdClick: true,
+                 isSPANavigation: false
+               }));
+             }
+           }
+         }, true);
+
+         // Intercept history.pushState and replaceState for SPA navigation
+         // This catches cases where cmd is held but the SPA still manages to call pushState
+         const originalPushState = history.pushState;
+         const originalReplaceState = history.replaceState;
+
+         history.pushState = function(state, title, url) {
+           if (__electrobunIsCmdHeld() && url) {
+             // Resolve relative URLs
+             const resolvedUrl = new URL(url, window.location.href).href;
+             emitWebviewEvent('new-window-open', JSON.stringify({
+               url: resolvedUrl,
+               isCmdClick: true,
+               isSPANavigation: true
+             }));
+             // Don't call original - block the navigation
+             return;
+           }
+           return originalPushState.apply(this, arguments);
+         };
+
+         history.replaceState = function(state, title, url) {
+           if (__electrobunIsCmdHeld() && url) {
+             const resolvedUrl = new URL(url, window.location.href).href;
+             emitWebviewEvent('new-window-open', JSON.stringify({
+               url: resolvedUrl,
+               isCmdClick: true,
+               isSPANavigation: true
+             }));
+             return;
+           }
+           return originalReplaceState.apply(this, arguments);
+         };
         
          // prevent overscroll
          document.addEventListener('DOMContentLoaded', () => {        

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electrobun",
-  "version": "0.5.0-beta.0",
+  "version": "0.6.0-beta.0",
   "description": "Build ultra fast, tiny, and cross-platform desktop apps with Typescript.",
   "license": "MIT",
   "author": "Blackboard Technologies Inc.",
@@ -31,24 +31,22 @@
     "check-zig-version": "vendors/zig/zig version",
     "build:dev": "bun build.ts",
     "build:release": "bun build.ts --release",
-    "dev:playground": "bun build:dev && bun build:cli && cd playground && npm install && bun build:dev && bun start",
-    "dev:playground:linux": "bun build:dev && npm link && cd playground && npm link electrobun && bun build:dev && bun start",
-    "dev:playground:clean": "cd playground && rm -rf node_modules && rm -rf vendors/cef && npm install && cd .. && bun dev:playground",
-    "dev:playground:clean:linux": "cd playground && rm -rf node_modules && rm -rf vendors/cef && npm install && cd .. && bun dev:playground:linux",
-    "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",
+    "dev": "bun install && bun build:dev && bun build:cli && cd ../kitchen && bun install && bun build:dev && bun start",
+    "dev:clean": "cd ../kitchen && rm -rf node_modules && rm -rf vendors/cef && cd ../package && bun dev",
+    "dev:rerun": "cd ../kitchen && bun start",
+    "dev:canary": "bun install && bun build:release && cd ../kitchen && bun install && bun build:canary && bun start:canary",
+    "run:template": "bun install && bun build:dev && bun build:cli && cd ../templates/interactive-playground && bun 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",
     "npm:publish:beta": "bun build:release && npm publish --tag beta",
-    "push:beta": "npm version prerelease --preid=beta && git push origin main --tags",
-    "push:patch": "npm version prepatch --preid=beta && git push origin main --tags",
-    "push:minor": "npm version preminor --preid=beta && git push origin main --tags",
-    "push:major": "npm version premajor --preid=beta && git push origin main --tags",
-    "push:stable": "npm version patch && git push origin main --tags",
+    "push:beta": "bun scripts/push-version.js beta",
+    "push:patch": "bun scripts/push-version.js patch",
+    "push:minor": "bun scripts/push-version.js minor",
+    "push:major": "bun scripts/push-version.js major",
+    "push:stable": "bun scripts/push-version.js stable",
     "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"
+    "test": "bun install && bun build:dev && bun build:cli && cd ../tests && bun install && bun build:dev && bun start"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/BETA_RELEASE.md

@@ -1,67 +0,0 @@
-# Electrobun Beta Releases
-
-## For Users
-
-### Installing Beta Versions
-
-```bash
-# Install latest beta
-npm install electrobun@beta
-
-# Install specific beta version
-npm install electrobun@0.0.19-beta.1
-
-# View available versions
-npm view electrobun versions --json
-```
-
-### Switching Between Stable and Beta
-
-```bash
-# Switch to stable
-npm install electrobun@latest
-
-# Switch to beta
-npm install electrobun@beta
-```
-
-## For Maintainers
-
-### Publishing Beta Releases
-
-1. **Update version:**
-   ```bash
-   # First beta of a new version
-   npm version 0.0.19-beta.1
-   
-   # Increment beta number
-   bun npm:version:beta
-   ```
-
-2. **Create GitHub Release:**
-   ```bash
-   git push origin v0.0.19-beta.1
-   ```
-   Or manually trigger the workflow with the beta tag.
-
-3. **Publish to npm:**
-   ```bash
-   bun npm:publish:beta
-   ```
-
-### Beta Release Workflow
-
-1. Beta versions use semantic versioning: `MAJOR.MINOR.PATCH-beta.NUMBER`
-2. GitHub Actions automatically marks releases with `-beta` as pre-releases
-3. npm publishes to the `beta` dist-tag (not `latest`)
-4. Users on stable versions won't get beta updates
-
-### Promoting Beta to Stable
-
-```bash
-# Update version to stable
-npm version 0.0.19
-
-# Publish as latest
-bun npm:publish
-```

package/BUILD.md

@@ -1,90 +0,0 @@
-# Build System
-
-This document describes Electrobun's build system and cross-platform compilation approach.
-
-## Overview
-
-Electrobun uses a custom build system (`build.ts`) that handles:
-- Vendoring dependencies (Bun, Zig, CEF, WebView2)
-- Building native wrappers for each platform
-- Creating distribution packages
-
-## Platform-Specific Native Wrappers
-
-### macOS
-- Single `libNativeWrapper.dylib` with weak linking to CEF framework
-- Uses `-weak_framework 'Chromium Embedded Framework'` for optional CEF support
-- Gracefully falls back to WebKit when CEF is not bundled
-
-### Windows  
-- Single `libNativeWrapper.dll` with runtime CEF detection
-- Links both WebView2 and CEF libraries at build time
-- Uses runtime checks to determine which webview engine to use
-
-### Linux
-**Dual Binary Approach** - Linux builds create two separate native wrapper binaries:
-
-#### `libNativeWrapper.so` (GTK-only)
-- Size: ~1.46MB
-- Dependencies: WebKitGTK, GTK+3, AppIndicator only
-- No CEF dependencies linked
-- Used when `bundleCEF: false` in electrobun.config
-
-#### `libNativeWrapper_cef.so` (CEF-enabled)  
-- Size: ~3.47MB
-- Dependencies: WebKitGTK, GTK+3, AppIndicator + CEF libraries
-- Full CEF functionality available
-- Used when `bundleCEF: true` in electrobun.config
-
-#### Why Dual Binaries?
-
-Unlike macOS and Windows, Linux doesn't have reliable weak linking for shared libraries. Hard linking CEF libraries causes `dlopen` failures when CEF isn't bundled. The dual binary approach provides:
-
-1. **Small bundle sizes** - Developers can ship lightweight apps without CEF overhead
-2. **Flexibility** - Same codebase supports both system WebKitGTK and CEF rendering
-3. **Reliability** - No runtime linking failures or undefined symbols
-
-#### CLI Binary Selection
-
-The Electrobun CLI automatically copies the appropriate binary based on the `bundleCEF` setting:
-
-```typescript
-const useCEF = config.build.linux?.bundleCEF;
-const nativeWrapperSource = useCEF 
-  ? PATHS.NATIVE_WRAPPER_LINUX_CEF 
-  : PATHS.NATIVE_WRAPPER_LINUX;
-```
-
-Both binaries are included in the distributed `electrobun` npm package, ensuring developers can toggle CEF support without recompilation.
-
-## Build Commands
-
-```bash
-# Full build with all platforms
-bun build.ts
-
-# Development build with playground
-bun dev:playground
-
-# Release build  
-bun build.ts --release
-
-# CI build
-bun build.ts --ci
-```
-
-## Architecture Support
-
-- **macOS**: ARM64 (Apple Silicon), x64 (Intel) 
-- **Windows**: x64 only (ARM Windows users run via automatic emulation)
-- **Linux**: x64, ARM64
-
-### Windows Architecture Notes
-
-Windows builds are created on ARM VMs but target x64 architecture. Both x64 and ARM Windows users use the same x64 binary:
-- **x64 Windows**: Runs natively
-- **ARM Windows**: Runs via automatic Windows emulation layer
-
-This approach simplifies distribution while maintaining compatibility across Windows architectures.
-
-The build system automatically detects the host architecture and downloads appropriate dependencies.

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Blackboard Technologies inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,102 +0,0 @@
-<p align="center">
-  <a href="https://electrobun.dev"><img src="https://github.com/blackboardsh/electrobun/assets/75102186/8799b522-0507-45e9-86e3-c3cfded1aa7c" alt="Logo" height=170></a>
-</p>
-<h1 align="center">Electrobun</h1>
-
-<div align="center">
-</div>
-
-## What is Electrobun?
-
-Electrobun aims to be a complete **solution-in-a-box** for building, updating, and shipping ultra fast, tiny, and cross-platform desktop applications written in Typescript.
-Under the hood it uses <a href="https://bun.sh">bun</a> to execute the main process and to bundle webview typescript, and has native bindings written in <a href="https://ziglang.org/">zig</a>.
-
-Visit <a href="https://blackboard.sh/electrobun/">https://blackboard.sh/electrobun/</a> to see api documentation, guides, and more.
-
-**Project Goals**
-
-- 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 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
-
-Read about how Electrobun is designed, and why, in our <a href="https://www.electrobun.dev/docs/guides/Architecture/Overview">architecture docs</a>.
-
-## Apps Built with Electrobun
-- [Co(lab)](https://blackboard.sh/colab/) - a hybrid web browser + code editor for deep work
-
-## Roadmap
-
-See the <a href="https://github.com/orgs/blackboardsh/projects/5">roadmap</a>
-
-## Contributing
-
-On the road to a stable 1.0.0 I'm probably going to just be pushing directly to main a lot.
-
-As we get closer to 1.0.0 I'll probably make guidelines for PRs and stuff. In the meantime if you find this project and want to contribute code it's probably best to create an issue first or ping me on twitter or discord to discuss when, what, and how is best to do that.
-
-Ways to get involved at this early stage:
-
-- Follow us on X for updates <a href="https://twitter.com/BlackboardTech">@BlackboardTech</a> or <a href="https://bsky.app/profile/yoav.codes">@yoav.codes</a>
-- Join the conversation on <a href="https://discord.gg/ueKE4tjaCE">Discord</a>
-- Create and participate in Github issues and discussions
-
-## Development Setup
-
-### Prerequisites
-
-**macOS:**
-- Xcode command line tools
-- cmake (install via homebrew: `brew install cmake`)
-
-**Windows:**
-- Visual Studio Build Tools or Visual Studio with C++ development tools
-- cmake
-
-**Linux:**
-- build-essential package
-- cmake
-- webkit2gtk and GTK development packages
-
-On Ubuntu/Debian based distros: `sudo apt install build-essential cmake pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev`
-
-### First-time Setup
-
-```bash
-git clone --recurse-submodules https://github.com/blackboardsh/electrobun.git
-cd electrobun
-bun install
-bun dev:playground:clean
-# On Linux, use:
-bun dev:playground:clean:linux
-```
-
-### Development Workflow
-
-```bash
-# After making changes to source code
-bun dev:playground
-# On Linux, use:
-bun dev:playground:linux
-
-# If you only changed playground code (not electrobun source)
-bun dev:playground:rerun
-
-# If you need a completely fresh start
-bun dev:playground:clean
-# On Linux, use:
-bun dev:playground:clean:linux
-```
-
-### Additional Commands
-
-- `bun dev:playground:canary` - Build and run playground in canary mode
-- `bun build:dev` - Build electrobun in development mode
-- `bun build:release` - Build electrobun in release mode
-
-### Debugging
-
-**macOS:** Use `lldb <path-to-bundle>/Contents/MacOS/launcher` and then `run` to debug release builds

package/debug.js

@@ -1,5 +0,0 @@
-console.log('process.argv:', process.argv);
-const indexOfElectrobun = process.argv.findIndex((arg) => arg.includes('electrobun'));
-console.log('indexOfElectrobun:', indexOfElectrobun);
-const commandArg = process.argv[indexOfElectrobun + 1] || 'build';
-console.log('commandArg:', commandArg);

package/templates/hello-world/README.md

@@ -1,57 +0,0 @@
-# Electrobun Hello World
-
-A simple Electrobun app to get you started with the framework.
-
-## What You'll See
-
-This hello world app demonstrates:
-- **Native Window**: A cross-platform desktop window
-- **Web-based UI**: Modern HTML, CSS, and JavaScript interface
-- **Simple Architecture**: Clean separation between Bun process and UI
-
-## Getting Started
-
-1. Install dependencies:
-   ```bash
-   bun install
-   ```
-
-2. Run in development mode:
-   ```bash
-   bun run dev
-   ```
-
-3. Build for production:
-   ```bash
-   bun run build
-   ```
-
-## Project Structure
-
-```
-src/
-├── bun/
-│   └── index.ts      # Main process - creates and manages windows
-└── mainview/
-    ├── index.html    # Your app's UI
-    ├── index.css     # Styles
-    └── index.ts      # View logic
-```
-
-## Next Steps
-
-Ready to build something more complex? Check out:
-
-- **[Documentation](https://docs.electrobun.dev)** - Learn about all Electrobun features
-- **[Examples](https://github.com/blackboardsh/electrobun/tree/main/playground)** - See advanced features like RPC, menus, and system tray
-- **[GitHub](https://github.com/blackboardsh/electrobun)** - Star the repo and join the community
-
-### Add More Features
-
-Want to extend this app? Try adding:
-- RPC communication between Bun and webview
-- Native menus and system tray
-- File dialogs and system integration
-- Multiple windows and views
-
-Happy building! 🚀