electrobun 1.18.1-beta.1 → 1.18.4-beta.10

package/dist/api/config/validate.ts

@@ -0,0 +1,19 @@
+const LEGACY_BUN_CONFIG_ERROR =
+	'Bun main-process configuration has been removed. Use build.mainProcess = "cottontail" and move build.bun options to build.cottontail.';
+
+export function assertNoLegacyBunMainProcessConfig(config: unknown): void {
+	if (!config || typeof config !== "object") return;
+
+	const build = (config as Record<string, unknown>)["build"];
+	if (!build || typeof build !== "object") return;
+
+	const buildConfig = build as Record<string, unknown>;
+	if (
+		buildConfig["mainProcess"] === "bun" ||
+		Object.hasOwn(buildConfig, "bun") ||
+		Object.hasOwn(buildConfig, "bunVersion") ||
+		Object.hasOwn(buildConfig, "bunnyBun")
+	) {
+		throw new Error(LEGACY_BUN_CONFIG_ERROR);
+	}
+}

package/dist/api/preload/.generated/compiled.ts

@@ -0,0 +1,8 @@
+// Auto-generated file. Do not edit directly.
+// Run "dash build.ts" or "dash run build:dev" from the package folder to regenerate.
+
+// Full preload for trusted webviews (RPC, encryption, drag regions, webview tags)
+export const preloadScript = "(function(){// src/preload/encryption.ts\nfunction base64ToUint8Array(base64) {\n  return new Uint8Array(atob(base64).split(\"\").map((char) => char.charCodeAt(0)));\n}\nfunction uint8ArrayToBase64(uint8Array) {\n  let binary = \"\";\n  for (let i = 0;i < uint8Array.length; i++) {\n    binary += String.fromCharCode(uint8Array[i]);\n  }\n  return btoa(binary);\n}\nfunction toArrayBuffer(bytes) {\n  const buffer = new ArrayBuffer(bytes.byteLength);\n  new Uint8Array(buffer).set(bytes);\n  return buffer;\n}\nasync function generateKeyFromBytes(rawKey) {\n  return await window.crypto.subtle.importKey(\"raw\", toArrayBuffer(rawKey), { name: \"AES-GCM\" }, true, [\"encrypt\", \"decrypt\"]);\n}\nasync function initEncryption() {\n  const secretKey = await generateKeyFromBytes(new Uint8Array(window.__electrobunSecretKeyBytes));\n  const encryptString = async (plaintext) => {\n    const encoder = new TextEncoder;\n    const encodedText = encoder.encode(plaintext);\n    const iv = window.crypto.getRandomValues(new Uint8Array(12));\n    const encryptedBuffer = await window.crypto.subtle.encrypt({ name: \"AES-GCM\", iv: toArrayBuffer(iv) }, secretKey, toArrayBuffer(encodedText));\n    const encryptedData = new Uint8Array(encryptedBuffer.slice(0, -16));\n    const tag = new Uint8Array(encryptedBuffer.slice(-16));\n    return {\n      encryptedData: uint8ArrayToBase64(encryptedData),\n      iv: uint8ArrayToBase64(iv),\n      tag: uint8ArrayToBase64(tag)\n    };\n  };\n  const decryptString = async (encryptedDataB64, ivB64, tagB64) => {\n    const encryptedData = base64ToUint8Array(encryptedDataB64);\n    const iv = base64ToUint8Array(ivB64);\n    const tag = base64ToUint8Array(tagB64);\n    const combinedData = new Uint8Array(encryptedData.length + tag.length);\n    combinedData.set(encryptedData);\n    combinedData.set(tag, encryptedData.length);\n    const decryptedBuffer = await window.crypto.subtle.decrypt({ name: \"AES-GCM\", iv: toArrayBuffer(iv) }, secretKey, toArrayBuffer(combinedData));\n    const decoder = new TextDecoder;\n    return decoder.decode(decryptedBuffer);\n  };\n  window.__electrobun_encrypt = encryptString;\n  window.__electrobun_decrypt = decryptString;\n}\n\n// src/preload/internalRpc.ts\nvar pendingRequests = {};\nvar requestId = 0;\nvar isProcessingQueue = false;\nvar sendQueue = [];\nfunction processQueue() {\n  if (isProcessingQueue) {\n    setTimeout(processQueue);\n    return;\n  }\n  if (sendQueue.length === 0)\n    return;\n  isProcessingQueue = true;\n  const batch = JSON.stringify(sendQueue);\n  sendQueue.length = 0;\n  window.__electrobunInternalBridge?.postMessage(batch);\n  setTimeout(() => {\n    isProcessingQueue = false;\n  }, 2);\n}\nfunction send(type, payload) {\n  sendQueue.push(JSON.stringify({ type: \"message\", id: type, payload }));\n  processQueue();\n}\nfunction request(type, payload) {\n  return new Promise((resolve, reject) => {\n    const id = `req_${++requestId}_${Date.now()}`;\n    pendingRequests[id] = { resolve, reject };\n    sendQueue.push(JSON.stringify({\n      type: \"request\",\n      method: type,\n      id,\n      params: payload,\n      hostWebviewId: window.__electrobunWebviewId\n    }));\n    processQueue();\n    setTimeout(() => {\n      if (pendingRequests[id]) {\n        delete pendingRequests[id];\n        reject(new Error(`Request timeout: ${type}`));\n      }\n    }, 1e4);\n  });\n}\nfunction handleResponse(msg) {\n  if (msg && msg.type === \"response\" && msg.id) {\n    const pending = pendingRequests[msg.id];\n    if (pending) {\n      delete pendingRequests[msg.id];\n      if (msg.success)\n        pending.resolve(msg.payload);\n      else\n        pending.reject(msg.payload);\n    }\n  }\n}\n\n// src/preload/dragRegions.ts\nfunction isAppRegionDrag(e) {\n  const target = e.target;\n  if (!target || !target.closest)\n    return false;\n  if (target.closest(\".electrobun-webkit-app-region-no-drag\") || target.closest('[style*=\"app-region\"][style*=\"no-drag\"]')) {\n    return false;\n  }\n  const draggableByStyle = target.closest('[style*=\"app-region\"][style*=\"drag\"]');\n  const draggableByClass = target.closest(\".electrobun-webkit-app-region-drag\");\n  return !!(draggableByStyle || draggableByClass);\n}\nfunction initDragRegions() {\n  document.addEventListener(\"mousedown\", (e) => {\n    if (isAppRegionDrag(e)) {\n      send(\"startWindowMove\", { id: window.__electrobunWindowId });\n    }\n  });\n  document.addEventListener(\"mouseup\", (e) => {\n    if (isAppRegionDrag(e)) {\n      send(\"stopWindowMove\", { id: window.__electrobunWindowId });\n    }\n  });\n}\n\n// src/preload/overlaySync.ts\nclass OverlaySyncController {\n  element;\n  options;\n  lastRect = { x: 0, y: 0, width: 0, height: 0 };\n  resizeObserver = null;\n  positionLoop = null;\n  resizeHandler = null;\n  burstUntil = 0;\n  constructor(element, options) {\n    this.element = element;\n    this.options = {\n      onSync: options.onSync,\n      getMasks: options.getMasks ?? (() => []),\n      burstIntervalMs: options.burstIntervalMs ?? 50,\n      baseIntervalMs: options.baseIntervalMs ?? 100,\n      burstDurationMs: options.burstDurationMs ?? 500\n    };\n  }\n  start() {\n    this.resizeObserver = new ResizeObserver(() => this.sync());\n    this.resizeObserver.observe(this.element);\n    const loop = () => {\n      this.sync();\n      const now = performance.now();\n      const interval = now < this.burstUntil ? this.options.burstIntervalMs : this.options.baseIntervalMs;\n      this.positionLoop = setTimeout(loop, interval);\n    };\n    this.positionLoop = setTimeout(loop, this.options.baseIntervalMs);\n    this.resizeHandler = () => this.sync(true);\n    window.addEventListener(\"resize\", this.resizeHandler);\n  }\n  stop() {\n    if (this.resizeObserver)\n      this.resizeObserver.disconnect();\n    if (this.positionLoop)\n      clearTimeout(this.positionLoop);\n    if (this.resizeHandler) {\n      window.removeEventListener(\"resize\", this.resizeHandler);\n    }\n    this.resizeObserver = null;\n    this.positionLoop = null;\n    this.resizeHandler = null;\n  }\n  forceSync() {\n    this.sync(true);\n  }\n  setLastRect(rect) {\n    this.lastRect = rect;\n  }\n  sync(force = false) {\n    const rect = this.element.getBoundingClientRect();\n    const newRect = {\n      x: rect.x,\n      y: rect.y,\n      width: rect.width,\n      height: rect.height\n    };\n    if (newRect.width === 0 && newRect.height === 0) {\n      return;\n    }\n    if (!force && newRect.x === this.lastRect.x && newRect.y === this.lastRect.y && newRect.width === this.lastRect.width && newRect.height === this.lastRect.height) {\n      return;\n    }\n    this.burstUntil = performance.now() + this.options.burstDurationMs;\n    this.lastRect = newRect;\n    const masks = this.options.getMasks();\n    this.options.onSync(newRect, JSON.stringify(masks));\n  }\n}\n\n// src/preload/webviewTag.ts\nvar webviewRegistry = {};\n\nclass ElectrobunWebviewTag extends HTMLElement {\n  webviewId = null;\n  maskSelectors = new Set;\n  _sync = null;\n  transparent = false;\n  passthroughEnabled = false;\n  hidden = false;\n  sandboxed = false;\n  _eventListeners = {};\n  static get observedAttributes() {\n    return [\"src\", \"html\"];\n  }\n  constructor() {\n    super();\n  }\n  connectedCallback() {\n    requestAnimationFrame(() => this.initWebview());\n  }\n  attributeChangedCallback(name, oldValue, newValue) {\n    if (oldValue === newValue)\n      return;\n    if (newValue === null)\n      return;\n    if (this.webviewId === null)\n      return;\n    if (name === \"src\")\n      this.loadURL(newValue);\n    else if (name === \"html\")\n      this.loadHTML(newValue);\n  }\n  disconnectedCallback() {\n    if (this.webviewId !== null) {\n      send(\"webviewTagRemove\", { id: this.webviewId });\n      delete webviewRegistry[this.webviewId];\n    }\n    if (this._sync)\n      this._sync.stop();\n  }\n  getInitialNavigationRules() {\n    const rawRules = this.getAttribute(\"navigation-rules\");\n    if (rawRules === null) {\n      return null;\n    }\n    const trimmed = rawRules.trim();\n    if (!trimmed) {\n      return [];\n    }\n    try {\n      const parsed = JSON.parse(trimmed);\n      if (!Array.isArray(parsed) || !parsed.every((rule) => typeof rule === \"string\")) {\n        throw new Error(\"navigation-rules must be a JSON string array\");\n      }\n      return parsed;\n    } catch (error) {\n      console.error(\"Invalid navigation-rules attribute:\", error);\n      return [];\n    }\n  }\n  async initWebview() {\n    const rect = this.getBoundingClientRect();\n    const initialRect = {\n      x: rect.x,\n      y: rect.y,\n      width: rect.width,\n      height: rect.height\n    };\n    const url = this.getAttribute(\"src\");\n    const html = this.getAttribute(\"html\");\n    const preload = this.getAttribute(\"preload\");\n    const partition = this.getAttribute(\"partition\");\n    const renderer = this.getAttribute(\"renderer\") || \"native\";\n    const masks = this.getAttribute(\"masks\");\n    const navigationRules = this.getInitialNavigationRules();\n    const sandbox = this.hasAttribute(\"sandbox\");\n    this.sandboxed = sandbox;\n    const transparent = this.hasAttribute(\"transparent\");\n    const passthrough = this.hasAttribute(\"passthrough\");\n    this.transparent = transparent;\n    this.passthroughEnabled = passthrough;\n    if (transparent)\n      this.style.opacity = \"0\";\n    if (passthrough)\n      this.style.pointerEvents = \"none\";\n    if (masks) {\n      masks.split(\",\").forEach((s) => this.maskSelectors.add(s.trim()));\n    }\n    try {\n      const webviewInitParams = {\n        hostWebviewId: window.__electrobunWebviewId,\n        windowId: window.__electrobunWindowId,\n        renderer,\n        url,\n        html,\n        preload,\n        partition,\n        frame: {\n          width: rect.width,\n          height: rect.height,\n          x: rect.x,\n          y: rect.y\n        },\n        sandbox,\n        transparent,\n        passthrough,\n        ...navigationRules === null ? {} : { navigationRules }\n      };\n      const webviewId = await request(\"webviewTagInit\", webviewInitParams);\n      this.webviewId = webviewId;\n      this.id = `electrobun-webview-${webviewId}`;\n      webviewRegistry[webviewId] = this;\n      this.setupObservers(initialRect);\n      this.syncDimensions(true);\n      requestAnimationFrame(() => {\n        Object.values(webviewRegistry).forEach((webview) => {\n          if (webview !== this && webview.webviewId !== null) {\n            webview.syncDimensions(true);\n          }\n        });\n      });\n    } catch (err) {\n      console.error(\"Failed to init webview:\", err);\n    }\n  }\n  setupObservers(initialRect) {\n    const getMasks = () => {\n      const rect = this.getBoundingClientRect();\n      const masks = [];\n      this.maskSelectors.forEach((selector) => {\n        try {\n          document.querySelectorAll(selector).forEach((el) => {\n            const mr = el.getBoundingClientRect();\n            masks.push({\n              x: mr.x - rect.x,\n              y: mr.y - rect.y,\n              width: mr.width,\n              height: mr.height\n            });\n          });\n        } catch (_e) {}\n      });\n      return masks;\n    };\n    this._sync = new OverlaySyncController(this, {\n      onSync: (rect, masksJson) => {\n        if (this.webviewId === null)\n          return;\n        send(\"webviewTagResize\", {\n          id: this.webviewId,\n          frame: rect,\n          masks: masksJson\n        });\n      },\n      getMasks,\n      burstIntervalMs: 10,\n      baseIntervalMs: 100,\n      burstDurationMs: 50\n    });\n    this._sync.setLastRect(initialRect);\n    this._sync.start();\n  }\n  syncDimensions(force = false) {\n    if (!this._sync)\n      return;\n    if (force) {\n      this._sync.forceSync();\n    }\n  }\n  loadURL(url) {\n    if (this.webviewId === null)\n      return;\n    this.setAttribute(\"src\", url);\n    send(\"webviewTagUpdateSrc\", { id: this.webviewId, url });\n  }\n  loadHTML(html) {\n    if (this.webviewId === null)\n      return;\n    send(\"webviewTagUpdateHtml\", { id: this.webviewId, html });\n  }\n  reload() {\n    if (this.webviewId !== null)\n      send(\"webviewTagReload\", { id: this.webviewId });\n  }\n  goBack() {\n    if (this.webviewId !== null)\n      send(\"webviewTagGoBack\", { id: this.webviewId });\n  }\n  goForward() {\n    if (this.webviewId !== null)\n      send(\"webviewTagGoForward\", { id: this.webviewId });\n  }\n  async canGoBack() {\n    if (this.webviewId === null)\n      return false;\n    return await request(\"webviewTagCanGoBack\", {\n      id: this.webviewId\n    });\n  }\n  async canGoForward() {\n    if (this.webviewId === null)\n      return false;\n    return await request(\"webviewTagCanGoForward\", {\n      id: this.webviewId\n    });\n  }\n  toggleTransparent(value) {\n    if (this.webviewId === null)\n      return;\n    this.transparent = value !== undefined ? value : !this.transparent;\n    this.style.opacity = this.transparent ? \"0\" : \"\";\n    send(\"webviewTagSetTransparent\", {\n      id: this.webviewId,\n      transparent: this.transparent\n    });\n  }\n  togglePassthrough(value) {\n    if (this.webviewId === null)\n      return;\n    this.passthroughEnabled = value !== undefined ? value : !this.passthroughEnabled;\n    this.style.pointerEvents = this.passthroughEnabled ? \"none\" : \"\";\n    send(\"webviewTagSetPassthrough\", {\n      id: this.webviewId,\n      enablePassthrough: this.passthroughEnabled\n    });\n  }\n  toggleHidden(value) {\n    if (this.webviewId === null)\n      return;\n    this.hidden = value !== undefined ? value : !this.hidden;\n    send(\"webviewTagSetHidden\", { id: this.webviewId, hidden: this.hidden });\n  }\n  addMaskSelector(selector) {\n    this.maskSelectors.add(selector);\n    this.syncDimensions(true);\n  }\n  removeMaskSelector(selector) {\n    this.maskSelectors.delete(selector);\n    this.syncDimensions(true);\n  }\n  setNavigationRules(rules) {\n    if (this.webviewId !== null) {\n      send(\"webviewTagSetNavigationRules\", { id: this.webviewId, rules });\n    }\n  }\n  findInPage(searchText, options) {\n    if (this.webviewId === null)\n      return;\n    const forward = options?.forward !== false;\n    const matchCase = options?.matchCase || false;\n    send(\"webviewTagFindInPage\", {\n      id: this.webviewId,\n      searchText,\n      forward,\n      matchCase\n    });\n  }\n  stopFindInPage() {\n    if (this.webviewId !== null)\n      send(\"webviewTagStopFind\", { id: this.webviewId });\n  }\n  openDevTools() {\n    if (this.webviewId !== null)\n      send(\"webviewTagOpenDevTools\", { id: this.webviewId });\n  }\n  closeDevTools() {\n    if (this.webviewId !== null)\n      send(\"webviewTagCloseDevTools\", { id: this.webviewId });\n  }\n  toggleDevTools() {\n    if (this.webviewId !== null)\n      send(\"webviewTagToggleDevTools\", { id: this.webviewId });\n  }\n  executeJavascript(js) {\n    if (this.webviewId === null)\n      return;\n    send(\"webviewTagExecuteJavascript\", { id: this.webviewId, js });\n  }\n  on(event, listener) {\n    if (!this._eventListeners[event])\n      this._eventListeners[event] = [];\n    this._eventListeners[event].push(listener);\n  }\n  off(event, listener) {\n    if (!this._eventListeners[event])\n      return;\n    const idx = this._eventListeners[event].indexOf(listener);\n    if (idx !== -1)\n      this._eventListeners[event].splice(idx, 1);\n  }\n  emit(event, detail) {\n    const listeners = this._eventListeners[event];\n    if (listeners) {\n      const customEvent = new CustomEvent(event, { detail });\n      listeners.forEach((fn) => fn(customEvent));\n    }\n  }\n  get src() {\n    return this.getAttribute(\"src\");\n  }\n  set src(value) {\n    if (value) {\n      this.setAttribute(\"src\", value);\n    } else {\n      this.removeAttribute(\"src\");\n    }\n  }\n  get html() {\n    return this.getAttribute(\"html\");\n  }\n  set html(value) {\n    if (value) {\n      this.setAttribute(\"html\", value);\n    } else {\n      this.removeAttribute(\"html\");\n    }\n  }\n  get preload() {\n    return this.getAttribute(\"preload\");\n  }\n  set preload(value) {\n    if (value)\n      this.setAttribute(\"preload\", value);\n    else\n      this.removeAttribute(\"preload\");\n  }\n  get renderer() {\n    return this.getAttribute(\"renderer\") || \"native\";\n  }\n  set renderer(value) {\n    this.setAttribute(\"renderer\", value);\n  }\n  get sandbox() {\n    return this.sandboxed;\n  }\n}\nfunction initWebviewTag() {\n  if (!customElements.get(\"electrobun-webview\")) {\n    customElements.define(\"electrobun-webview\", ElectrobunWebviewTag);\n  }\n  const injectStyles = () => {\n    const style = document.createElement(\"style\");\n    style.textContent = `\nelectrobun-webview {\n\tdisplay: block;\n\twidth: 800px;\n\theight: 300px;\n\tbackground: #fff;\n\tbackground-repeat: no-repeat !important;\n\toverflow: hidden;\n}\n`;\n    if (document.head?.firstChild) {\n      document.head.insertBefore(style, document.head.firstChild);\n    } else if (document.head) {\n      document.head.appendChild(style);\n    }\n  };\n  if (document.head) {\n    injectStyles();\n  } else {\n    document.addEventListener(\"DOMContentLoaded\", injectStyles);\n  }\n}\n\n// src/preload/wgpuTag.ts\nvar wgpuTagRegistry = {};\n\nclass ElectrobunWgpuTag extends HTMLElement {\n  wgpuViewId = null;\n  maskSelectors = new Set;\n  _sync = null;\n  transparent = false;\n  passthroughEnabled = false;\n  hidden = false;\n  _ready = false;\n  _initializing = false;\n  _eventListeners = {};\n  constructor() {\n    super();\n  }\n  connectedCallback() {\n    requestAnimationFrame(() => {\n      if (this.isConnected)\n        this.initWgpuView();\n    });\n  }\n  disconnectedCallback() {\n    if (this.wgpuViewId !== null) {\n      send(\"wgpuTagRemove\", { id: this.wgpuViewId });\n      delete wgpuTagRegistry[this.wgpuViewId];\n      this.wgpuViewId = null;\n    }\n    if (this._sync)\n      this._sync.stop();\n    this._sync = null;\n    this._ready = false;\n  }\n  async initWgpuView() {\n    if (this._initializing || this.wgpuViewId !== null)\n      return;\n    this._initializing = true;\n    const rect = this.getBoundingClientRect();\n    const initialRect = {\n      x: rect.x,\n      y: rect.y,\n      width: rect.width,\n      height: rect.height\n    };\n    const transparent = this.hasAttribute(\"transparent\");\n    const passthrough = this.hasAttribute(\"passthrough\");\n    const hidden = this.hasAttribute(\"hidden\");\n    const masks = this.getAttribute(\"masks\");\n    this.transparent = transparent;\n    this.passthroughEnabled = passthrough;\n    this.hidden = hidden;\n    if (masks) {\n      masks.split(\",\").forEach((s) => this.maskSelectors.add(s.trim()));\n    }\n    if (transparent)\n      this.style.opacity = \"0\";\n    if (passthrough)\n      this.style.pointerEvents = \"none\";\n    try {\n      const wgpuViewId = await request(\"wgpuTagInit\", {\n        windowId: window.__electrobunWindowId,\n        frame: {\n          width: rect.width,\n          height: rect.height,\n          x: rect.x,\n          y: rect.y\n        },\n        transparent,\n        passthrough\n      });\n      if (!this.isConnected) {\n        send(\"wgpuTagRemove\", { id: wgpuViewId });\n        return;\n      }\n      this.wgpuViewId = wgpuViewId;\n      if (!this.id) {\n        this.id = `electrobun-wgpu-${wgpuViewId}`;\n      }\n      wgpuTagRegistry[wgpuViewId] = this;\n      this.setupObservers(initialRect);\n      this.syncDimensions(true);\n      if (hidden) {\n        this.toggleHidden(true);\n      }\n      requestAnimationFrame(() => {\n        Object.values(wgpuTagRegistry).forEach((view) => {\n          if (view !== this && view.wgpuViewId !== null) {\n            view.syncDimensions(true);\n          }\n        });\n      });\n      this._ready = true;\n      this.emit(\"ready\", { id: wgpuViewId });\n    } catch (err) {\n      console.error(\"Failed to init WGPU view:\", err);\n    } finally {\n      this._initializing = false;\n    }\n  }\n  setupObservers(initialRect) {\n    const getMasks = () => {\n      const rect = this.getBoundingClientRect();\n      const masks = [];\n      this.maskSelectors.forEach((selector) => {\n        try {\n          document.querySelectorAll(selector).forEach((el) => {\n            const mr = el.getBoundingClientRect();\n            masks.push({\n              x: mr.x - rect.x,\n              y: mr.y - rect.y,\n              width: mr.width,\n              height: mr.height\n            });\n          });\n        } catch (_e) {}\n      });\n      return masks;\n    };\n    this._sync = new OverlaySyncController(this, {\n      onSync: (rect, masksJson) => {\n        if (this.wgpuViewId === null)\n          return;\n        send(\"wgpuTagResize\", {\n          id: this.wgpuViewId,\n          frame: rect,\n          masks: masksJson\n        });\n      },\n      getMasks,\n      burstIntervalMs: 10,\n      baseIntervalMs: 100,\n      burstDurationMs: 50\n    });\n    this._sync.setLastRect(initialRect);\n    this._sync.start();\n  }\n  syncDimensions(force = false) {\n    if (!this._sync)\n      return;\n    if (force) {\n      this._sync.forceSync();\n    }\n  }\n  toggleTransparent(value) {\n    if (this.wgpuViewId === null)\n      return;\n    this.transparent = value !== undefined ? value : !this.transparent;\n    this.style.opacity = this.transparent ? \"0\" : \"\";\n    send(\"wgpuTagSetTransparent\", {\n      id: this.wgpuViewId,\n      transparent: this.transparent\n    });\n  }\n  togglePassthrough(value) {\n    if (this.wgpuViewId === null)\n      return;\n    this.passthroughEnabled = value !== undefined ? value : !this.passthroughEnabled;\n    this.style.pointerEvents = this.passthroughEnabled ? \"none\" : \"\";\n    send(\"wgpuTagSetPassthrough\", {\n      id: this.wgpuViewId,\n      passthrough: this.passthroughEnabled\n    });\n  }\n  toggleHidden(value) {\n    if (this.wgpuViewId === null)\n      return;\n    this.hidden = value !== undefined ? value : !this.hidden;\n    send(\"wgpuTagSetHidden\", { id: this.wgpuViewId, hidden: this.hidden });\n  }\n  runTest() {\n    if (this.wgpuViewId === null)\n      return;\n    send(\"wgpuTagRunTest\", { id: this.wgpuViewId });\n  }\n  addMaskSelector(selector) {\n    this.maskSelectors.add(selector);\n    this.syncDimensions(true);\n  }\n  removeMaskSelector(selector) {\n    this.maskSelectors.delete(selector);\n    this.syncDimensions(true);\n  }\n  on(event, listener) {\n    if (!this._eventListeners[event])\n      this._eventListeners[event] = [];\n    this._eventListeners[event].push(listener);\n    if (event === \"ready\" && this._ready && this.wgpuViewId !== null) {\n      const readyEvent = new CustomEvent(event, {\n        detail: { id: this.wgpuViewId }\n      });\n      queueMicrotask(() => {\n        if (this._eventListeners[event]?.includes(listener)) {\n          listener(readyEvent);\n        }\n      });\n    }\n  }\n  off(event, listener) {\n    if (!this._eventListeners[event])\n      return;\n    const idx = this._eventListeners[event].indexOf(listener);\n    if (idx !== -1)\n      this._eventListeners[event].splice(idx, 1);\n  }\n  emit(event, detail) {\n    const listeners = this._eventListeners[event];\n    if (listeners) {\n      const customEvent = new CustomEvent(event, { detail });\n      listeners.forEach((fn) => fn(customEvent));\n    }\n  }\n}\nfunction initWgpuTag() {\n  if (!customElements.get(\"electrobun-wgpu\")) {\n    customElements.define(\"electrobun-wgpu\", ElectrobunWgpuTag);\n  }\n  const injectStyles = () => {\n    const style = document.createElement(\"style\");\n    style.textContent = `\nelectrobun-wgpu {\n\tdisplay: block;\n\twidth: 800px;\n\theight: 300px;\n\tbackground: #000;\n\toverflow: hidden;\n}\n`;\n    if (document.head?.firstChild) {\n      document.head.insertBefore(style, document.head.firstChild);\n    } else if (document.head) {\n      document.head.appendChild(style);\n    }\n  };\n  if (document.head) {\n    injectStyles();\n  } else {\n    document.addEventListener(\"DOMContentLoaded\", injectStyles);\n  }\n}\n\n// src/preload/events.ts\nfunction emitWebviewEvent(eventName, detail) {\n  setTimeout(() => {\n    const bridge = window.__electrobunEventBridge || window.__electrobunInternalBridge;\n    bridge?.postMessage(JSON.stringify({\n      id: \"webviewEvent\",\n      type: \"message\",\n      payload: {\n        id: window.__electrobunWebviewId,\n        eventName,\n        detail\n      }\n    }));\n  });\n}\nfunction initLifecycleEvents() {\n  window.addEventListener(\"load\", () => {\n    if (window === window.top) {\n      emitWebviewEvent(\"dom-ready\", document.location.href);\n    }\n  });\n  window.addEventListener(\"popstate\", () => {\n    emitWebviewEvent(\"did-navigate-in-page\", window.location.href);\n  });\n  window.addEventListener(\"hashchange\", () => {\n    emitWebviewEvent(\"did-navigate-in-page\", window.location.href);\n  });\n}\nvar cmdKeyHeld = false;\nvar cmdKeyTimestamp = 0;\nvar CMD_KEY_THRESHOLD_MS = 500;\nfunction isCmdHeld() {\n  if (cmdKeyHeld)\n    return true;\n  return Date.now() - cmdKeyTimestamp < CMD_KEY_THRESHOLD_MS && cmdKeyTimestamp > 0;\n}\nfunction initCmdClickHandling() {\n  window.addEventListener(\"keydown\", (event) => {\n    if (event.key === \"Meta\" || event.metaKey) {\n      cmdKeyHeld = true;\n      cmdKeyTimestamp = Date.now();\n    }\n  }, true);\n  window.addEventListener(\"keyup\", (event) => {\n    if (event.key === \"Meta\") {\n      cmdKeyHeld = false;\n      cmdKeyTimestamp = Date.now();\n    }\n  }, true);\n  window.addEventListener(\"blur\", () => {\n    cmdKeyHeld = false;\n  });\n  window.addEventListener(\"click\", (event) => {\n    if (event.metaKey || event.ctrlKey) {\n      const anchor = event.target?.closest?.(\"a\");\n      if (anchor && anchor.href) {\n        event.preventDefault();\n        event.stopPropagation();\n        event.stopImmediatePropagation();\n        emitWebviewEvent(\"new-window-open\", JSON.stringify({\n          url: anchor.href,\n          isCmdClick: true,\n          isSPANavigation: false\n        }));\n      }\n    }\n  }, true);\n}\nfunction initSPANavigationInterception() {\n  const originalPushState = history.pushState;\n  const originalReplaceState = history.replaceState;\n  history.pushState = function(state, title, url) {\n    if (isCmdHeld() && url) {\n      const resolvedUrl = new URL(String(url), window.location.href).href;\n      emitWebviewEvent(\"new-window-open\", JSON.stringify({\n        url: resolvedUrl,\n        isCmdClick: true,\n        isSPANavigation: true\n      }));\n      return;\n    }\n    return originalPushState.apply(this, [state, title, url]);\n  };\n  history.replaceState = function(state, title, url) {\n    if (isCmdHeld() && url) {\n      const resolvedUrl = new URL(String(url), window.location.href).href;\n      emitWebviewEvent(\"new-window-open\", JSON.stringify({\n        url: resolvedUrl,\n        isCmdClick: true,\n        isSPANavigation: true\n      }));\n      return;\n    }\n    return originalReplaceState.apply(this, [state, title, url]);\n  };\n}\nfunction initOverscrollPrevention() {\n  document.addEventListener(\"DOMContentLoaded\", () => {\n    const style = document.createElement(\"style\");\n    style.type = \"text/css\";\n    style.appendChild(document.createTextNode(\"html, body { overscroll-behavior: none; }\"));\n    document.head.appendChild(style);\n  });\n}\n\n// src/preload/index.ts\ninitEncryption().catch((err) => console.error(\"Failed to initialize encryption:\", err));\nvar internalMessageHandler = (msg) => {\n  handleResponse(msg);\n};\nvar defaultUserMessageHandler = (msg) => {\n  if (!window.__electrobunPendingHostMessages) {\n    window.__electrobunPendingHostMessages = [];\n  }\n  window.__electrobunPendingHostMessages.push(msg);\n};\nif (!window.__electrobun) {\n  window.__electrobun = {\n    receiveInternalMessageFromHost: internalMessageHandler,\n    receiveMessageFromHost: defaultUserMessageHandler,\n    receiveInternalMessageFromBun: internalMessageHandler,\n    receiveMessageFromBun: defaultUserMessageHandler\n  };\n} else {\n  window.__electrobun.receiveInternalMessageFromHost = internalMessageHandler;\n  window.__electrobun.receiveMessageFromHost = defaultUserMessageHandler;\n  window.__electrobun.receiveInternalMessageFromBun = internalMessageHandler;\n  window.__electrobun.receiveMessageFromBun = defaultUserMessageHandler;\n}\nwindow.__electrobunSendToHost = (message) => {\n  emitWebviewEvent(\"host-message\", JSON.stringify(message));\n};\ninitLifecycleEvents();\ninitCmdClickHandling();\ninitSPANavigationInterception();\ninitOverscrollPrevention();\ninitDragRegions();\ninitWebviewTag();\ninitWgpuTag();\n})();";
+
+// Minimal preload for sandboxed/untrusted webviews (lifecycle events only, no RPC)
+export const preloadScriptSandboxed = "(function(){// src/preload/events.ts\nfunction emitWebviewEvent(eventName, detail) {\n  setTimeout(() => {\n    const bridge = window.__electrobunEventBridge || window.__electrobunInternalBridge;\n    bridge?.postMessage(JSON.stringify({\n      id: \"webviewEvent\",\n      type: \"message\",\n      payload: {\n        id: window.__electrobunWebviewId,\n        eventName,\n        detail\n      }\n    }));\n  });\n}\nfunction initLifecycleEvents() {\n  window.addEventListener(\"load\", () => {\n    if (window === window.top) {\n      emitWebviewEvent(\"dom-ready\", document.location.href);\n    }\n  });\n  window.addEventListener(\"popstate\", () => {\n    emitWebviewEvent(\"did-navigate-in-page\", window.location.href);\n  });\n  window.addEventListener(\"hashchange\", () => {\n    emitWebviewEvent(\"did-navigate-in-page\", window.location.href);\n  });\n}\nvar cmdKeyHeld = false;\nvar cmdKeyTimestamp = 0;\nvar CMD_KEY_THRESHOLD_MS = 500;\nfunction isCmdHeld() {\n  if (cmdKeyHeld)\n    return true;\n  return Date.now() - cmdKeyTimestamp < CMD_KEY_THRESHOLD_MS && cmdKeyTimestamp > 0;\n}\nfunction initCmdClickHandling() {\n  window.addEventListener(\"keydown\", (event) => {\n    if (event.key === \"Meta\" || event.metaKey) {\n      cmdKeyHeld = true;\n      cmdKeyTimestamp = Date.now();\n    }\n  }, true);\n  window.addEventListener(\"keyup\", (event) => {\n    if (event.key === \"Meta\") {\n      cmdKeyHeld = false;\n      cmdKeyTimestamp = Date.now();\n    }\n  }, true);\n  window.addEventListener(\"blur\", () => {\n    cmdKeyHeld = false;\n  });\n  window.addEventListener(\"click\", (event) => {\n    if (event.metaKey || event.ctrlKey) {\n      const anchor = event.target?.closest?.(\"a\");\n      if (anchor && anchor.href) {\n        event.preventDefault();\n        event.stopPropagation();\n        event.stopImmediatePropagation();\n        emitWebviewEvent(\"new-window-open\", JSON.stringify({\n          url: anchor.href,\n          isCmdClick: true,\n          isSPANavigation: false\n        }));\n      }\n    }\n  }, true);\n}\nfunction initSPANavigationInterception() {\n  const originalPushState = history.pushState;\n  const originalReplaceState = history.replaceState;\n  history.pushState = function(state, title, url) {\n    if (isCmdHeld() && url) {\n      const resolvedUrl = new URL(String(url), window.location.href).href;\n      emitWebviewEvent(\"new-window-open\", JSON.stringify({\n        url: resolvedUrl,\n        isCmdClick: true,\n        isSPANavigation: true\n      }));\n      return;\n    }\n    return originalPushState.apply(this, [state, title, url]);\n  };\n  history.replaceState = function(state, title, url) {\n    if (isCmdHeld() && url) {\n      const resolvedUrl = new URL(String(url), window.location.href).href;\n      emitWebviewEvent(\"new-window-open\", JSON.stringify({\n        url: resolvedUrl,\n        isCmdClick: true,\n        isSPANavigation: true\n      }));\n      return;\n    }\n    return originalReplaceState.apply(this, [state, title, url]);\n  };\n}\nfunction initOverscrollPrevention() {\n  document.addEventListener(\"DOMContentLoaded\", () => {\n    const style = document.createElement(\"style\");\n    style.type = \"text/css\";\n    style.appendChild(document.createTextNode(\"html, body { overscroll-behavior: none; }\"));\n    document.head.appendChild(style);\n  });\n}\n\n// src/preload/index-sandboxed.ts\ninitLifecycleEvents();\ninitCmdClickHandling();\ninitSPANavigationInterception();\ninitOverscrollPrevention();\n})();";

package/dist/api/{bun/preload → preload}/build.ts

@@ -1,6 +1,6 @@
 // Standalone build script for the preload.
-// Normally this is run as part of "bun build.ts", but you can run this directly:
-//   bun src/bun/preload/build.ts
+// Normally this is run as part of "dash build.ts", but you can run it directly:
+//   dash src/preload/build.ts
 
 import { join, dirname } from "path";
 import { writeFileSync, mkdirSync } from "fs";
@@ -40,13 +40,13 @@ async function buildPreload() {
 		throw new Error("Failed to build sandboxed preload script");
 	}
 
-	// Bun does not currently support iife output, so we wrap the ESM bundle manually
-	// to keep preload globals scoped for script injection.
+	// The compatible bundler does not currently support IIFE output, so wrap
+	// the ESM bundle manually to keep preload globals scoped for injection.
 	const fullPreloadJs = `(function(){${await fullResult.outputs[0]!.text()}})();`;
 	const sandboxedPreloadJs = `(function(){${await sandboxedResult.outputs[0]!.text()}})();`;
 
-	const outputContent = `// Auto-generated file. Do not edit directly.
-// Run "bun build.ts" or "bun build:dev" from the package folder to regenerate.
+const outputContent = `// Auto-generated file. Do not edit directly.
+// Run "dash build.ts" from the package folder to regenerate.
 
 // Full preload for trusted webviews (RPC, encryption, drag regions, webview tags)
 export const preloadScript = ${JSON.stringify(fullPreloadJs)};

package/dist/api/{bun/preload → preload}/encryption.ts

@@ -19,10 +19,16 @@ function uint8ArrayToBase64(uint8Array: Uint8Array): string {
 	return btoa(binary);
 }
 
+function toArrayBuffer(bytes: Uint8Array): ArrayBuffer {
+	const buffer = new ArrayBuffer(bytes.byteLength);
+	new Uint8Array(buffer).set(bytes);
+	return buffer;
+}
+
 async function generateKeyFromBytes(rawKey: Uint8Array): Promise<CryptoKey> {
 	return await window.crypto.subtle.importKey(
 		"raw",
-		rawKey as unknown as ArrayBuffer,
+		toArrayBuffer(rawKey),
 		{ name: "AES-GCM" },
 		true,
 		["encrypt", "decrypt"],
@@ -41,9 +47,9 @@ export async function initEncryption(): Promise<void> {
 		const encodedText = encoder.encode(plaintext);
 		const iv = window.crypto.getRandomValues(new Uint8Array(12));
 		const encryptedBuffer = await window.crypto.subtle.encrypt(
-			{ name: "AES-GCM", iv },
+			{ name: "AES-GCM", iv: toArrayBuffer(iv) },
 			secretKey,
-			encodedText,
+			toArrayBuffer(encodedText),
 		);
 
 		// Split the tag (last 16 bytes) from the ciphertext
@@ -72,9 +78,9 @@ export async function initEncryption(): Promise<void> {
 		combinedData.set(tag, encryptedData.length);
 
 		const decryptedBuffer = await window.crypto.subtle.decrypt(
-			{ name: "AES-GCM", iv: iv as unknown as ArrayBuffer },
+			{ name: "AES-GCM", iv: toArrayBuffer(iv) },
 			secretKey,
-			combinedData as unknown as ArrayBuffer,
+			toArrayBuffer(combinedData),
 		);
 
 		const decoder = new TextDecoder();

package/dist/api/{bun/preload → preload}/globals.d.ts

@@ -6,6 +6,8 @@ declare global {
 		__electrobunWebviewId: number;
 		__electrobunWindowId: number;
 		__electrobunRpcSocketPort: number;
+		__electrobunHostSocketPort?: number;
+		__electrobunPlaintextHostSocket?: boolean;
 		__electrobunSecretKeyBytes: number[];
 		// Event-only bridge (all webviews, including sandboxed)
 		__electrobunEventBridge?: {
@@ -16,6 +18,9 @@ declare global {
 			postMessage: (message: string) => void;
 		};
 		// User RPC bridge (trusted webviews only)
+		__electrobunHostBridge?: {
+			postMessage: (message: string) => void;
+		};
 		__electrobunBunBridge?: {
 			postMessage: (message: string) => void;
 		};
@@ -28,7 +33,10 @@ declare global {
 			tag: string,
 		) => Promise<string>;
 		__electrobunSendToHost: (message: unknown) => void;
+		__electrobunPendingHostMessages?: unknown[];
 		__electrobun: {
+			receiveMessageFromHost: (msg: unknown) => void;
+			receiveInternalMessageFromHost: (msg: unknown) => void;
 			receiveMessageFromBun: (msg: unknown) => void;
 			receiveInternalMessageFromBun: (msg: unknown) => void;
 		};

package/dist/api/{bun/preload → preload}/index.ts

@@ -7,10 +7,12 @@
 // - window.__electrobunWebviewId
 // - window.__electrobunWindowId
 // - window.__electrobunRpcSocketPort
+// - window.__electrobunHostSocketPort (optional alias)
 // - window.__electrobunSecretKeyBytes
 // - window.__electrobunEventBridge (event emission - all webviews)
 // - window.__electrobunInternalBridge (internal RPC - trusted only)
-// - window.__electrobunBunBridge (user RPC - trusted only)
+// - window.__electrobunHostBridge (user RPC - trusted only)
+// - window.__electrobunBunBridge (legacy alias)
 
 import "./globals.d.ts";
 import { initEncryption } from "./encryption";
@@ -37,19 +39,27 @@ const internalMessageHandler = (msg: unknown) => {
 	handleResponse(msg as { type: string; id: string; success: boolean; payload: unknown });
 };
 
+const defaultUserMessageHandler = (msg: unknown) => {
+	// Buffer user RPC packets that arrive before the page-specific Electroview
+	// instance installs the real handler.
+	if (!window.__electrobunPendingHostMessages) {
+		window.__electrobunPendingHostMessages = [];
+	}
+	window.__electrobunPendingHostMessages.push(msg);
+};
+
 if (!window.__electrobun) {
 	window.__electrobun = {
+		receiveInternalMessageFromHost: internalMessageHandler,
+		receiveMessageFromHost: defaultUserMessageHandler,
 		receiveInternalMessageFromBun: internalMessageHandler,
-		receiveMessageFromBun: (msg: unknown) => {
-			// Default handler for user RPC - will be overridden if user creates Electroview
-			console.log("receiveMessageFromBun (no handler):", msg);
-		},
+		receiveMessageFromBun: defaultUserMessageHandler,
 	};
 } else {
+	window.__electrobun.receiveInternalMessageFromHost = internalMessageHandler;
+	window.__electrobun.receiveMessageFromHost = defaultUserMessageHandler;
 	window.__electrobun.receiveInternalMessageFromBun = internalMessageHandler;
-	window.__electrobun.receiveMessageFromBun = (msg: unknown) => {
-		console.log("receiveMessageFromBun (no handler):", msg);
-	};
+	window.__electrobun.receiveMessageFromBun = defaultUserMessageHandler;
 }
 
 // Allow preload scripts to send custom messages to the host webview

package/dist/api/{bun/preload → preload}/webviewTag.ts

@@ -68,6 +68,29 @@ export class ElectrobunWebviewTag extends HTMLElement {
 		if (this._sync) this._sync.stop();
 	}
 
+	private getInitialNavigationRules(): string[] | null {
+		const rawRules = this.getAttribute("navigation-rules");
+		if (rawRules === null) {
+			return null;
+		}
+
+		const trimmed = rawRules.trim();
+		if (!trimmed) {
+			return [];
+		}
+
+		try {
+			const parsed = JSON.parse(trimmed);
+			if (!Array.isArray(parsed) || !parsed.every((rule) => typeof rule === "string")) {
+				throw new Error("navigation-rules must be a JSON string array");
+			}
+			return parsed;
+		} catch (error) {
+			console.error("Invalid navigation-rules attribute:", error);
+			return [];
+		}
+	}
+
 	async initWebview() {
 		const rect = this.getBoundingClientRect();
 		const initialRect = {
@@ -85,6 +108,7 @@ export class ElectrobunWebviewTag extends HTMLElement {
 			| "native"
 			| "cef";
 		const masks = this.getAttribute("masks");
+		const navigationRules = this.getInitialNavigationRules();
 		// Sandbox attribute: when present, the child webview is sandboxed (no RPC, events only)
 		const sandbox = this.hasAttribute("sandbox");
 		this.sandboxed = sandbox;
@@ -101,7 +125,7 @@ export class ElectrobunWebviewTag extends HTMLElement {
 		}
 
 		try {
-			const webviewId = (await request("webviewTagInit", {
+			const webviewInitParams = {
 				hostWebviewId: window.__electrobunWebviewId,
 				windowId: window.__electrobunWindowId,
 				renderer,
@@ -115,11 +139,16 @@ export class ElectrobunWebviewTag extends HTMLElement {
 					x: rect.x,
 					y: rect.y,
 				},
-				navigationRules: null,
 				sandbox,
 				transparent,
 				passthrough,
-			})) as number;
+				...(navigationRules === null ? {} : { navigationRules }),
+			};
+
+			const webviewId = (await request(
+				"webviewTagInit",
+				webviewInitParams,
+			)) as number;
 
 			this.webviewId = webviewId;
 			this.id = `electrobun-webview-${webviewId}`;

package/dist/api/{bun/preload → preload}/wgpuTag.ts

@@ -17,6 +17,8 @@ export class ElectrobunWgpuTag extends HTMLElement {
 	transparent = false;
 	passthroughEnabled = false;
 	hidden = false;
+	private _ready = false;
+	private _initializing = false;
 	private _eventListeners: Record<string, Array<(event: CustomEvent) => void>> =
 		{};
 
@@ -25,18 +27,26 @@ export class ElectrobunWgpuTag extends HTMLElement {
 	}
 
 	connectedCallback() {
-		requestAnimationFrame(() => this.initWgpuView());
+		requestAnimationFrame(() => {
+			if (this.isConnected) void this.initWgpuView();
+		});
 	}
 
 	disconnectedCallback() {
 		if (this.wgpuViewId !== null) {
 			send("wgpuTagRemove", { id: this.wgpuViewId });
 			delete wgpuTagRegistry[this.wgpuViewId];
+			this.wgpuViewId = null;
 		}
 		if (this._sync) this._sync.stop();
+		this._sync = null;
+		this._ready = false;
 	}
 
 	async initWgpuView() {
+		if (this._initializing || this.wgpuViewId !== null) return;
+		this._initializing = true;
+
 		const rect = this.getBoundingClientRect();
 		const initialRect = {
 			x: rect.x,
@@ -74,8 +84,15 @@ export class ElectrobunWgpuTag extends HTMLElement {
 				passthrough,
 			})) as number;
 
+			if (!this.isConnected) {
+				send("wgpuTagRemove", { id: wgpuViewId });
+				return;
+			}
+
 			this.wgpuViewId = wgpuViewId;
-			this.id = `electrobun-wgpu-${wgpuViewId}`;
+			if (!this.id) {
+				this.id = `electrobun-wgpu-${wgpuViewId}`;
+			}
 			wgpuTagRegistry[wgpuViewId] = this;
 
 			this.setupObservers(initialRect);
@@ -96,9 +113,12 @@ export class ElectrobunWgpuTag extends HTMLElement {
 				});
 			});
 
+			this._ready = true;
 			this.emit("ready", { id: wgpuViewId });
 		} catch (err) {
 			console.error("Failed to init WGPU view:", err);
+		} finally {
+			this._initializing = false;
 		}
 	}
 
@@ -198,6 +218,17 @@ export class ElectrobunWgpuTag extends HTMLElement {
 	on(event: WgpuTagEventType, listener: (event: CustomEvent) => void) {
 		if (!this._eventListeners[event]) this._eventListeners[event] = [];
 		this._eventListeners[event].push(listener);
+
+		if (event === "ready" && this._ready && this.wgpuViewId !== null) {
+			const readyEvent = new CustomEvent(event, {
+				detail: { id: this.wgpuViewId },
+			});
+			queueMicrotask(() => {
+				if (this._eventListeners[event]?.includes(listener)) {
+					listener(readyEvent);
+				}
+			});
+		}
 	}
 
 	off(event: WgpuTagEventType, listener: (event: CustomEvent) => void) {

package/dist/api/{bun → sdks/bun}/__tests__/ffi-contract.test.ts

@@ -1,14 +1,11 @@
-// Contract tests for the bun:ffi APIs that electrobun depends on.
+// Contract tests for the bun:ffi compatibility APIs Electrobun depends on.
 //
-// Bun bumps don't usually break electrobun, but when they do, the breakage
-// almost always lives in this surface — JSCallback marshaling, FFIType
-// encoding, dlopen behavior. These tests are a tripwire: if a new Bun release
-// breaks any of them, we want to know before cutting an electrobun release,
-// not after a user reports a crash.
+// Runtime changes can break JSCallback marshaling, FFIType encoding, or dlopen
+// behavior. Keep these tests with Electrobun so Cottontail changes cannot
+// silently break the native bridge.
 //
-// Skipped on Windows for now since the bun-check workflow runs on Linux and
-// the system library paths differ. If we add a Windows runner later, switch
-// the libc path resolution to include msvcrt/ucrtbase.
+// Skipped on Windows because the system library paths differ. To enable them,
+// extend the libc path resolution to include msvcrt/ucrtbase.
 
 import { describe, expect, it } from "bun:test";
 import {