bunite-core 0.0.1 → 0.0.3

package/src/preload/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"fileNames":["../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es5.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2016.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2018.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2019.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2021.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2022.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.dom.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.core.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2016.array.include.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2016.intl.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.arraybuffer.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.date.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.object.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.string.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.intl.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2017.typedarrays.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2018.asynciterable.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2018.intl.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2018.promise.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2018.regexp.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2019.array.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2019.object.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2019.string.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2019.symbol.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2019.intl.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.bigint.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.date.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.promise.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.string.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.intl.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2020.number.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2021.promise.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2021.string.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2021.weakref.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2021.intl.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2022.array.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2022.error.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2022.intl.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2022.object.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2022.string.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.es2022.regexp.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.decorators.d.ts","../../../node_modules/.bun/typescript@6.0.2/node_modules/typescript/lib/lib.decorators.legacy.d.ts","./webviewelement.ts","./runtime.ts"],"fileInfos":[{"version":"bcd24271a113971ba9eb71ff8cb01bc6b0f872a85c23fdbe5d93065b375933cd","affectsGlobalScope":true,"impliedFormat":1},{"version":"3f88bedbeb09c6f5a6645cb24c7c55f1aa22d19ae96c8e6959cbd8b85a707bc6","impliedFormat":1},{"version":"7fe93b39b810eadd916be8db880dd7f0f7012a5cc6ffb62de8f62a2117fa6f1f","impliedFormat":1},{"version":"bb0074cc08b84a2374af33d8bf044b80851ccc9e719a5e202eacf40db2c31600","impliedFormat":1},{"version":"1a7daebe4f45fb03d9ec53d60008fbf9ac45a697fdc89e4ce218bc94b94f94d6","impliedFormat":1},{"version":"f94b133a3cb14a288803be545ac2683e0d0ff6661bcd37e31aaaec54fc382aed","impliedFormat":1},{"version":"f59d0650799f8782fd74cf73c19223730c6d1b9198671b1c5b3a38e1188b5953","impliedFormat":1},{"version":"8a15b4607d9a499e2dbeed9ec0d3c0d7372c850b2d5f1fb259e8f6d41d468a84","impliedFormat":1},{"version":"26e0fe14baee4e127f4365d1ae0b276f400562e45e19e35fd2d4c296684715e6","impliedFormat":1},{"version":"d6b1eba8496bdd0eed6fc8a685768fe01b2da4a0388b5fe7df558290bffcf32f","affectsGlobalScope":true,"impliedFormat":1},{"version":"eadcffda2aa84802c73938e589b9e58248d74c59cb7fcbca6474e3435ac15504","affectsGlobalScope":true,"impliedFormat":1},{"version":"105ba8ff7ba746404fe1a2e189d1d3d2e0eb29a08c18dded791af02f29fb4711","affectsGlobalScope":true,"impliedFormat":1},{"version":"00343ca5b2e3d48fa5df1db6e32ea2a59afab09590274a6cccb1dbae82e60c7c","affectsGlobalScope":true,"impliedFormat":1},{"version":"ebd9f816d4002697cb2864bea1f0b70a103124e18a8cd9645eeccc09bdf80ab4","affectsGlobalScope":true,"impliedFormat":1},{"version":"2c1afac30a01772cd2a9a298a7ce7706b5892e447bb46bdbeef720f7b5da77ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"7b0225f483e4fa685625ebe43dd584bb7973bbd84e66a6ba7bbe175ee1048b4f","affectsGlobalScope":true,"impliedFormat":1},{"version":"c0a4b8ac6ce74679c1da2b3795296f5896e31c38e888469a8e0f99dc3305de60","affectsGlobalScope":true,"impliedFormat":1},{"version":"3084a7b5f569088e0146533a00830e206565de65cae2239509168b11434cd84f","affectsGlobalScope":true,"impliedFormat":1},{"version":"c5079c53f0f141a0698faa903e76cb41cd664e3efb01cc17a5c46ec2eb0bef42","affectsGlobalScope":true,"impliedFormat":1},{"version":"32cafbc484dea6b0ab62cf8473182bbcb23020d70845b406f80b7526f38ae862","affectsGlobalScope":true,"impliedFormat":1},{"version":"fca4cdcb6d6c5ef18a869003d02c9f0fd95df8cfaf6eb431cd3376bc034cad36","affectsGlobalScope":true,"impliedFormat":1},{"version":"b93ec88115de9a9dc1b602291b85baf825c85666bf25985cc5f698073892b467","affectsGlobalScope":true,"impliedFormat":1},{"version":"f5c06dcc3fe849fcb297c247865a161f995cc29de7aa823afdd75aaaddc1419b","affectsGlobalScope":true,"impliedFormat":1},{"version":"b77e16112127a4b169ef0b8c3a4d730edf459c5f25fe52d5e436a6919206c4d7","affectsGlobalScope":true,"impliedFormat":1},{"version":"fbffd9337146eff822c7c00acbb78b01ea7ea23987f6c961eba689349e744f8c","affectsGlobalScope":true,"impliedFormat":1},{"version":"a995c0e49b721312f74fdfb89e4ba29bd9824c770bbb4021d74d2bf560e4c6bd","affectsGlobalScope":true,"impliedFormat":1},{"version":"c7b3542146734342e440a84b213384bfa188835537ddbda50d30766f0593aff9","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce6180fa19b1cccd07ee7f7dbb9a367ac19c0ed160573e4686425060b6df7f57","affectsGlobalScope":true,"impliedFormat":1},{"version":"3f02e2476bccb9dbe21280d6090f0df17d2f66b74711489415a8aa4df73c9675","affectsGlobalScope":true,"impliedFormat":1},{"version":"45e3ab34c1c013c8ab2dc1ba4c80c780744b13b5676800ae2e3be27ae862c40c","affectsGlobalScope":true,"impliedFormat":1},{"version":"805c86f6cca8d7702a62a844856dbaa2a3fd2abef0536e65d48732441dde5b5b","affectsGlobalScope":true,"impliedFormat":1},{"version":"e42e397f1a5a77994f0185fd1466520691456c772d06bf843e5084ceb879a0ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"f4c2b41f90c95b1c532ecc874bd3c111865793b23aebcc1c3cbbabcd5d76ffb0","affectsGlobalScope":true,"impliedFormat":1},{"version":"ab26191cfad5b66afa11b8bf935ef1cd88fabfcb28d30b2dfa6fad877d050332","affectsGlobalScope":true,"impliedFormat":1},{"version":"2088bc26531e38fb05eedac2951480db5309f6be3fa4a08d2221abb0f5b4200d","affectsGlobalScope":true,"impliedFormat":1},{"version":"cb9d366c425fea79716a8fb3af0d78e6b22ebbab3bd64d25063b42dc9f531c1e","affectsGlobalScope":true,"impliedFormat":1},{"version":"500934a8089c26d57ebdb688fc9757389bb6207a3c8f0674d68efa900d2abb34","affectsGlobalScope":true,"impliedFormat":1},{"version":"689da16f46e647cef0d64b0def88910e818a5877ca5379ede156ca3afb780ac3","affectsGlobalScope":true,"impliedFormat":1},{"version":"bc21cc8b6fee4f4c2440d08035b7ea3c06b3511314c8bab6bef7a92de58a2593","affectsGlobalScope":true,"impliedFormat":1},{"version":"7ca53d13d2957003abb47922a71866ba7cb2068f8d154877c596d63c359fed25","affectsGlobalScope":true,"impliedFormat":1},{"version":"54725f8c4df3d900cb4dac84b64689ce29548da0b4e9b7c2de61d41c79293611","affectsGlobalScope":true,"impliedFormat":1},{"version":"e5594bc3076ac29e6c1ebda77939bc4c8833de72f654b6e376862c0473199323","affectsGlobalScope":true,"impliedFormat":1},{"version":"2f3eb332c2d73e729f3364fcc0c2b375e72a121e8157d25a82d67a138c83a95c","affectsGlobalScope":true,"impliedFormat":1},{"version":"6f4427f9642ce8d500970e4e69d1397f64072ab73b97e476b4002a646ac743b1","affectsGlobalScope":true,"impliedFormat":1},{"version":"48915f327cd1dea4d7bd358d9dc7732f58f9e1626a29cc0c05c8c692419d9bb7","affectsGlobalScope":true,"impliedFormat":1},{"version":"b7bf9377723203b5a6a4b920164df22d56a43f593269ba6ae1fdc97774b68855","affectsGlobalScope":true,"impliedFormat":1},{"version":"db9709688f82c9e5f65a119c64d835f906efe5f559d08b11642d56eb85b79357","affectsGlobalScope":true,"impliedFormat":1},{"version":"4b25b8c874acd1a4cf8444c3617e037d444d19080ac9f634b405583fd10ce1f7","affectsGlobalScope":true,"impliedFormat":1},{"version":"37be57d7c90cf1f8112ee2636a068d8fd181289f82b744160ec56a7dc158a9f5","affectsGlobalScope":true,"impliedFormat":1},{"version":"a917a49ac94cd26b754ab84e113369a75d1a47a710661d7cd25e961cc797065f","affectsGlobalScope":true,"impliedFormat":1},{"version":"6d3261badeb7843d157ef3e6f5d1427d0eeb0af0cf9df84a62cfd29fd47ac86e","affectsGlobalScope":true,"impliedFormat":1},{"version":"195daca651dde22f2167ac0d0a05e215308119a3100f5e6268e8317d05a92526","affectsGlobalScope":true,"impliedFormat":1},{"version":"8b11e4285cd2bb164a4dc09248bdec69e9842517db4ca47c1ba913011e44ff2f","affectsGlobalScope":true,"impliedFormat":1},{"version":"0508571a52475e245b02bc50fa1394065a0a3d05277fbf5120c3784b85651799","affectsGlobalScope":true,"impliedFormat":1},{"version":"8f9af488f510c3015af3cc8c267a9e9d96c4dd38a1fdff0e11dc5a544711415b","affectsGlobalScope":true,"impliedFormat":1},{"version":"fc611fea8d30ea72c6bbfb599c9b4d393ce22e2f5bfef2172534781e7d138104","affectsGlobalScope":true,"impliedFormat":1},{"version":"1ce14b81c5cc821994aa8ec1d42b220dd41b27fcc06373bce3958af7421b77d4","affectsGlobalScope":true,"impliedFormat":1},{"version":"b3a048b3e9302ef9a34ef4ebb9aecfb28b66abb3bce577206a79fee559c230da","affectsGlobalScope":true,"impliedFormat":1},{"version":"f7924c67469cd6b44b50480cec49f3d34b3feae7bb292d6f44b7939f9d07a2dc","signature":"5c08c27ab7fdb9d3a443d5b81d066acf9a3b44413dbfe91153a2288779910ad5","affectsGlobalScope":true},{"version":"b61a26197044cf31caa83db322ecb653d081fc67e14b25c5a41cd7cc33b3fca1","signature":"6447fe52d8ee29270b95a53b62dece95739c334d51b6271bd7e1323e81b79a2c"}],"root":[59,60],"options":{"composite":true,"exactOptionalPropertyTypes":false,"module":7,"skipLibCheck":true,"strict":true,"target":9},"affectedFilesPendingEmit":[[60,17],[59,17]],"emitSignatures":[59,60],"version":"6.0.2"}

package/src/preload/webviewElement.ts

@@ -0,0 +1,307 @@
+// <bunite-webview> custom element — registered in every appres:// page via preload.
+
+declare const bunite: {
+  invoke: (method: string, params?: unknown) => Promise<any>;
+  on: (channel: string, handler: (data: any) => void) => (() => void);
+  off: (channel: string, handler: (data: any) => void) => void;
+};
+
+// --- OverlaySyncController ---
+// Tracks element bounds and notifies when they change.
+// Uses ResizeObserver for size changes and rAF polling for position changes.
+// Dirty-flag coalescing ensures at most one IPC per animation frame.
+
+type Rect = { x: number; y: number; width: number; height: number };
+
+class OverlaySyncController {
+  private element: HTMLElement;
+  private onBoundsChange: (rect: Rect) => void;
+  private observer: ResizeObserver | null = null;
+  private rafId = 0;
+  private lastRect: Rect = { x: 0, y: 0, width: 0, height: 0 };
+  private dirty = false;
+  private stopped = false;
+
+  constructor(element: HTMLElement, onBoundsChange: (rect: Rect) => void) {
+    this.element = element;
+    this.onBoundsChange = onBoundsChange;
+  }
+
+  start() {
+    this.observer = new ResizeObserver(() => this.markDirty());
+    this.observer.observe(this.element);
+    this.scheduleFrame();
+  }
+
+  stop() {
+    this.stopped = true;
+    this.observer?.disconnect();
+    this.observer = null;
+    if (this.rafId) {
+      cancelAnimationFrame(this.rafId);
+      this.rafId = 0;
+    }
+  }
+
+  private markDirty() {
+    this.dirty = true;
+  }
+
+  private scheduleFrame() {
+    if (this.stopped) return;
+    this.rafId = requestAnimationFrame(() => {
+      this.flush();
+      this.scheduleFrame();
+    });
+  }
+
+  private flush() {
+    const dpr = window.devicePixelRatio || 1;
+    const r = this.element.getBoundingClientRect();
+    const rect: Rect = {
+      x: Math.round(r.x * dpr),
+      y: Math.round(r.y * dpr),
+      width: Math.round(r.width * dpr),
+      height: Math.round(r.height * dpr)
+    };
+
+    // Always check for position changes (not caught by ResizeObserver)
+    if (
+      !this.dirty &&
+      rect.x === this.lastRect.x &&
+      rect.y === this.lastRect.y &&
+      rect.width === this.lastRect.width &&
+      rect.height === this.lastRect.height
+    ) {
+      return;
+    }
+
+    this.dirty = false;
+    this.lastRect = rect;
+    this.onBoundsChange(rect);
+  }
+}
+
+// --- BuniteWebviewElement ---
+
+type SurfaceInitResponse = { surfaceId: number };
+
+class BuniteWebviewElement extends HTMLElement {
+  static observedAttributes = ["src"];
+
+  _surfaceId: number | null = null;
+  private _syncCtrl: OverlaySyncController | null = null;
+  private _initPromise: Promise<SurfaceInitResponse> | null = null;
+  private _aborted = false;
+  private _pendingSrc: string | null = null;
+  private _syncHidden = false;
+  private _userHidden = false;
+  private _layoutObserver: ResizeObserver | null = null;
+  private _unsubNavigate: (() => void) | null = null;
+
+  constructor() {
+    super();
+    // NOTE: Custom element spec forbids setting attributes in constructor.
+  }
+
+  connectedCallback() {
+    this._aborted = false;
+    this._syncHidden = false;
+    this._userHidden = false;
+    this._unsubNavigate = bunite.on("__bunite:webview.didNavigate", (data: any) => {
+      if (data?.surfaceId === this._surfaceId) {
+        this.dispatchEvent(new CustomEvent("did-navigate", { detail: { url: data.url } }));
+      }
+    });
+    this._waitForLayout();
+  }
+
+  private _waitForLayout() {
+    if (this._layoutObserver) return; // already waiting
+
+    const tryInit = () => {
+      if (!this.isConnected || this._aborted) return true; // stop waiting
+      const r = this.getBoundingClientRect();
+      if (r.width > 0 && r.height > 0) {
+        const src = this.getAttribute("src") || this._pendingSrc || "";
+        if (src) this.initSurface();
+        return true;
+      }
+      return false;
+    };
+
+    requestAnimationFrame(() => {
+      if (tryInit()) return;
+      // Element has no layout yet — wait via ResizeObserver
+      this._layoutObserver = new ResizeObserver(() => {
+        if (tryInit()) {
+          this._layoutObserver?.disconnect();
+          this._layoutObserver = null;
+        }
+      });
+      this._layoutObserver.observe(this);
+    });
+  }
+
+  disconnectedCallback() {
+    this._aborted = true;
+    this._unsubNavigate?.();
+    this._unsubNavigate = null;
+    this._layoutObserver?.disconnect();
+    this._layoutObserver = null;
+    this._syncCtrl?.stop();
+    this._syncCtrl = null;
+
+    if (this._surfaceId != null) {
+      const id = this._surfaceId;
+      this._surfaceId = null;
+      bunite.invoke("__bunite:surface.remove", { surfaceId: id }).catch(() => {});
+    } else if (this._initPromise) {
+      this._initPromise
+        .then((r) => {
+          bunite.invoke("__bunite:surface.remove", { surfaceId: r.surfaceId }).catch(() => {});
+        })
+        .catch(() => {});
+    }
+    this._initPromise = null;
+  }
+
+  attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null) {
+    if (name !== "src") return;
+    if (this._surfaceId != null) {
+      bunite.invoke("__bunite:webview.navigate", {
+        surfaceId: this._surfaceId,
+        url: newValue || ""
+      }).catch(() => {});
+    } else if (this._initPromise) {
+      // Init in progress — queue for after completion
+      this._pendingSrc = newValue || "";
+    } else if (this.isConnected && !this._aborted && newValue) {
+      // No init started yet (was waiting for src) — start now
+      this._waitForLayout();
+    }
+  }
+
+  setHidden(hidden: boolean) {
+    this._userHidden = hidden;
+    this._applySurfaceHidden();
+  }
+
+  goBack() {
+    if (this._surfaceId != null)
+      bunite.invoke("__bunite:webview.goBack", { surfaceId: this._surfaceId }).catch(() => {});
+  }
+
+  reload() {
+    if (this._surfaceId != null)
+      bunite.invoke("__bunite:webview.reload", { surfaceId: this._surfaceId }).catch(() => {});
+  }
+
+  navigate(url: string) {
+    this.setAttribute("src", url);
+  }
+
+  private _applySurfaceHidden() {
+    if (this._surfaceId == null) return;
+    bunite.invoke("__bunite:surface.setHidden", {
+      surfaceId: this._surfaceId,
+      hidden: this._userHidden || this._syncHidden
+    }).catch(() => {});
+  }
+
+  private initSurface() {
+    if (this._surfaceId != null || this._initPromise != null) return;
+
+    const dpr = window.devicePixelRatio || 1;
+    const r = this.getBoundingClientRect();
+    const src = this._pendingSrc || this.getAttribute("src") || "";
+    this._pendingSrc = null;
+
+    const initPromise = bunite.invoke("__bunite:surface.init", {
+      src,
+      x: Math.round(r.x * dpr),
+      y: Math.round(r.y * dpr),
+      width: Math.round(r.width * dpr),
+      height: Math.round(r.height * dpr),
+      hidden: this._userHidden
+    }) as Promise<SurfaceInitResponse>;
+    this._initPromise = initPromise;
+
+    initPromise
+      .then((response) => {
+        if (this._initPromise !== initPromise) return;
+        if (this._aborted) {
+          bunite.invoke("__bunite:surface.remove", { surfaceId: response.surfaceId }).catch(() => {});
+          return;
+        }
+
+        this._surfaceId = response.surfaceId;
+
+        // Apply hidden state that was set during init
+        if (this._userHidden) {
+          this._applySurfaceHidden();
+        }
+
+        // Apply src that was set before init completed
+        if (this._pendingSrc != null) {
+          const pending = this._pendingSrc;
+          this._pendingSrc = null;
+          bunite.invoke("__bunite:webview.navigate", {
+            surfaceId: this._surfaceId,
+            url: pending
+          }).catch(() => {});
+        }
+
+        this._syncCtrl = new OverlaySyncController(this, (rect) => {
+          if (this._surfaceId == null) return;
+
+          const isZero = rect.width === 0 && rect.height === 0;
+          if (isZero) {
+            if (!this._syncHidden) {
+              this._syncHidden = true;
+              this._applySurfaceHidden();
+            }
+            return;
+          }
+          if (this._syncHidden) {
+            this._syncHidden = false;
+            this._applySurfaceHidden();
+          }
+
+          bunite.invoke("__bunite:surface.resize", {
+            surfaceId: this._surfaceId,
+            x: rect.x,
+            y: rect.y,
+            w: rect.width,
+            h: rect.height
+          }).catch(() => {});
+        });
+        this._syncCtrl.start();
+      })
+      .catch(() => {})
+      .finally(() => {
+        if (this._initPromise === initPromise) {
+          this._initPromise = null;
+        }
+      });
+  }
+}
+
+if (typeof customElements !== "undefined") {
+  customElements.define("bunite-webview", BuniteWebviewElement);
+
+  // When the host page gains focus (click on non-surface area), the host BrowserView
+  // HWND comes to front and covers surface child HWNDs. Re-raise surfaces on focus.
+  const raiseAll = () => bunite.invoke("__bunite:surface.bringAllVisiblesToFront").catch(() => {});
+  document.addEventListener("pointerdown", raiseAll, true);
+
+  // During host-page drag (e.g. dockview tab drag), send surfaces behind host
+  // via Z-order swap so OLE DragDrop reaches the host's IDropTarget.
+  document.addEventListener("dragstart", () => {
+    bunite.invoke("__bunite:surface.setAllPassthrough", { passthrough: true }).catch(() => {});
+  }, true);
+  document.addEventListener("dragend", () => {
+    bunite.invoke("__bunite:surface.setAllPassthrough", { passthrough: false }).catch(() => {});
+    raiseAll();
+  }, true);
+}

package/src/shared/cefVersion.ts

@@ -0,0 +1,2 @@
+// Auto-generated by scripts/gen-cef-version.ts
+export const CEF_VERSION = "146.0.10";

package/src/shared/log.ts

@@ -0,0 +1,40 @@
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+
+const levels: Record<LogLevel, number> = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  silent: 4
+};
+
+let currentLevel: LogLevel = "warn";
+
+function shouldLog(level: LogLevel): boolean {
+  return levels[level] >= levels[currentLevel];
+}
+
+export function logLevelToInt(level: LogLevel): number {
+  return levels[level];
+}
+
+export const log = {
+  setLevel(level: LogLevel) {
+    currentLevel = level;
+  },
+  getLevel(): LogLevel {
+    return currentLevel;
+  },
+  debug(...args: unknown[]) {
+    if (shouldLog("debug")) console.debug("[bunite]", ...args);
+  },
+  info(...args: unknown[]) {
+    if (shouldLog("info")) console.info("[bunite]", ...args);
+  },
+  warn(...args: unknown[]) {
+    if (shouldLog("warn")) console.warn("[bunite]", ...args);
+  },
+  error(...args: unknown[]) {
+    if (shouldLog("error")) console.error("[bunite]", ...args);
+  }
+};

package/src/shared/paths.ts

@@ -1,7 +1,8 @@
 import { dirname, join } from "node:path";
-import { existsSync } from "node:fs";
+import { existsSync, readdirSync } from "node:fs";
 import { createRequire } from "node:module";
 import { ARCH, BIN_EXT, NATIVE_LIB_EXT, PLATFORM_TAG } from "./platform";
+import { CEF_VERSION } from "./cefVersion";
 
 const require = createRequire(import.meta.url);
 
@@ -24,38 +25,108 @@ export function resolvePackageRoot(packageName: string): string | null {
   }
 }
 
-export function resolveBunitePackageRoot(): string {
-  const packageJsonPath = require.resolve("bunite/package.json");
-  return dirname(packageJsonPath);
+export function resolveBunitePackageRoot(): string | null {
+  try {
+    const packageJsonPath = require.resolve("bunite-core/package.json");
+    return dirname(packageJsonPath);
+  } catch {
+    return null;
+  }
 }
 
-export function resolveFallbackCefDir(): string | null {
-  const envOverride = process.env.BUNITE_CEF_DIR ?? process.env.BUNITE_CEF_ROOT;
-  if (envOverride && existsSync(envOverride)) {
-    return envOverride;
+function hasCefRuntime(dir: string): boolean {
+  return existsSync(join(dir, "libcef.dll")) || existsSync(join(dir, "libcef.so"));
+}
+
+function parseCefVersion(name: string): number[] | null {
+  const m = name.match(/^cef-(\d+)\.(\d+)\.(\d+)$/);
+  return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+
+function resolveCefDir(searchDirs: string[]): string | null {
+  // 0. Explicit override (testing / development)
+  const forceDir = process.env.BUNITE_CEF_DIR;
+  if (forceDir && hasCefRuntime(forceDir)) {
+    return forceDir;
   }
 
-  const bunitePackageRoot = resolveBunitePackageRoot();
-  const localVendorPath = join(bunitePackageRoot, "vendors", "cef");
-  if (existsSync(localVendorPath)) {
-    return localVendorPath;
+  // 1. Local cef/ adjacent to native artifacts (standalone dist)
+  for (const dir of searchDirs) {
+    const candidate = join(dir, "cef");
+    if (hasCefRuntime(candidate)) {
+      return candidate;
+    }
   }
 
-  const upstreamVendorPath = "C:\\project\\electrobun\\package\\vendors\\cef";
-  if (existsSync(upstreamVendorPath)) {
-    return upstreamVendorPath;
+  // 2. Shared CEF root: BUNITE_CEF_ROOTDIR/cef-<version>/
+  const rootDir = process.env.BUNITE_CEF_ROOTDIR;
+  if (rootDir && existsSync(rootDir)) {
+    const exact = join(rootDir, `cef-${CEF_VERSION}`);
+    if (hasCefRuntime(exact)) {
+      return exact;
+    }
+    // Same major fallback — numeric version comparison
+    const [targetMajor] = CEF_VERSION.split(".").map(Number);
+    try {
+      let best: { dir: string; ver: number[] } | null = null;
+      for (const name of readdirSync(rootDir)) {
+        const ver = parseCefVersion(name);
+        if (!ver || ver[0] !== targetMajor) continue;
+        const full = join(rootDir, name);
+        if (!hasCefRuntime(full)) continue;
+        if (!best || ver[1] > best.ver[1] || (ver[1] === best.ver[1] && ver[2] > best.ver[2])) {
+          best = { dir: full, ver };
+        }
+      }
+      if (best) return best.dir;
+    } catch {}
+  }
+
+  // 3. vendors/cef inside bunite-core package
+  const packageRoot = resolveBunitePackageRoot();
+  if (packageRoot) {
+    const vendorPath = join(packageRoot, "vendors", "cef");
+    if (hasCefRuntime(vendorPath)) {
+      return vendorPath;
+    }
   }
 
   return null;
 }
 
-export function resolveDefaultViewsRoot(): string | null {
-  const candidate = join(process.cwd(), "views");
+/** Entry script dir (dev) or exe dir (compiled binary). */
+export function getBaseDir(): string {
+  const main = Bun.main;
+  if (main && existsSync(main)) return dirname(main);
+  return dirname(process.execPath);
+}
+
+export function resolveDefaultAppResRoot(): string | null {
+  const candidate = join(process.cwd(), "appres");
   return existsSync(candidate) ? candidate : null;
 }
 
 export function resolveNativeArtifacts(): ResolvedNativeArtifacts {
+  const exeDir = dirname(process.execPath);
+
+  // 1. Executable-relative (compiled standalone binary)
+  const exeNativeLib = join(exeDir, `libBuniteNative${NATIVE_LIB_EXT}`);
+  const exeProcessHelper = join(exeDir, `process_helper${BIN_EXT}`);
+  if (existsSync(exeNativeLib) && existsSync(exeProcessHelper)) {
+    return {
+      packageRoot: exeDir,
+      source: "local-build",
+      nativePackageName: null,
+      cefPackageName: null,
+      nativeLibPath: exeNativeLib,
+      processHelperPath: exeProcessHelper,
+      cefDir: resolveCefDir([exeDir])
+    };
+  }
+
   const packageRoot = resolveBunitePackageRoot();
+
+  // 2. Optional npm packages (@bunite/native-*, @bunite/cef-*)
   const nativePackageName = `@bunite/native-${PLATFORM_TAG}-${ARCH}`;
   const cefPackageName = `@bunite/cef-${PLATFORM_TAG}-${ARCH}`;
   const nativePackageRoot = resolvePackageRoot(nativePackageName);
@@ -76,7 +147,7 @@ export function resolveNativeArtifacts(): ResolvedNativeArtifacts {
     existsSync(packagedProcessHelperPath)
   ) {
     return {
-      packageRoot,
+      packageRoot: packageRoot ?? exeDir,
       source: "optional-package",
       nativePackageName,
       cefPackageName: packagedCefDir && existsSync(packagedCefDir) ? cefPackageName : null,
@@ -86,43 +157,42 @@ export function resolveNativeArtifacts(): ResolvedNativeArtifacts {
     };
   }
 
-  const localBuildRoot = join(packageRoot, "native-build", `${PLATFORM_TAG}-${ARCH}`);
-  const localCefDir = join(localBuildRoot, "cef");
-  const directLocalNativeLibPath = join(localBuildRoot, `libBuniteNative${NATIVE_LIB_EXT}`);
-  const directLocalProcessHelperPath = join(localBuildRoot, `process_helper${BIN_EXT}`);
-
-  if (existsSync(directLocalNativeLibPath) && existsSync(directLocalProcessHelperPath)) {
-    const resolvedLocalCefDir = existsSync(localCefDir) ? localCefDir : resolveFallbackCefDir();
-    return {
-      packageRoot,
-      source: "local-build",
-      nativePackageName: null,
-      cefPackageName: null,
-      nativeLibPath: directLocalNativeLibPath,
-      processHelperPath: directLocalProcessHelperPath,
-      cefDir: resolvedLocalCefDir
-    };
-  }
-
-  const localBuildBinRoot = join(localBuildRoot, "Release");
-  const localNativeLibPath = join(localBuildBinRoot, `libBuniteNative${NATIVE_LIB_EXT}`);
-  const localProcessHelperPath = join(localBuildBinRoot, `process_helper${BIN_EXT}`);
-
-  if (existsSync(localNativeLibPath) && existsSync(localProcessHelperPath)) {
-    const resolvedLocalCefDir = existsSync(localCefDir) ? localCefDir : resolveFallbackCefDir();
-    return {
-      packageRoot,
-      source: "local-build",
-      nativePackageName: null,
-      cefPackageName: null,
-      nativeLibPath: localNativeLibPath,
-      processHelperPath: localProcessHelperPath,
-      cefDir: resolvedLocalCefDir
-    };
+  // 3. Local build (development)
+  if (packageRoot) {
+    const localBuildRoot = join(packageRoot, "native-build", `${PLATFORM_TAG}-${ARCH}`);
+    const directLib = join(localBuildRoot, `libBuniteNative${NATIVE_LIB_EXT}`);
+    const directHelper = join(localBuildRoot, `process_helper${BIN_EXT}`);
+
+    if (existsSync(directLib) && existsSync(directHelper)) {
+      return {
+        packageRoot,
+        source: "local-build",
+        nativePackageName: null,
+        cefPackageName: null,
+        nativeLibPath: directLib,
+        processHelperPath: directHelper,
+        cefDir: resolveCefDir([localBuildRoot])
+      };
+    }
+
+    const releaseLib = join(localBuildRoot, "Release", `libBuniteNative${NATIVE_LIB_EXT}`);
+    const releaseHelper = join(localBuildRoot, "Release", `process_helper${BIN_EXT}`);
+
+    if (existsSync(releaseLib) && existsSync(releaseHelper)) {
+      return {
+        packageRoot,
+        source: "local-build",
+        nativePackageName: null,
+        cefPackageName: null,
+        nativeLibPath: releaseLib,
+        processHelperPath: releaseHelper,
+        cefDir: resolveCefDir([localBuildRoot])
+      };
+    }
   }
 
   return {
-    packageRoot,
+    packageRoot: packageRoot ?? exeDir,
     source: "missing",
     nativePackageName: nativePackageRoot ? nativePackageName : null,
     cefPackageName: cefPackageRoot ? cefPackageName : null,

package/src/shared/rpc.ts

@@ -16,7 +16,13 @@ export type RPCMessagePacket = {
   payload: unknown;
 };
 
-export type RPCPacket = RPCRequestPacket | RPCResponsePacket | RPCMessagePacket;
+export type RPCEventPacket = {
+  type: "event";
+  channel: string;
+  data: unknown;
+};
+
+export type RPCPacket = RPCRequestPacket | RPCResponsePacket | RPCMessagePacket | RPCEventPacket;
 
 type BaseRPCRequestsSchema = Record<string, { params: unknown; response: unknown }>;
 type BaseRPCMessagesSchema = Record<string, unknown>;