@gjsify/iframe 0.3.13 → 0.3.15

package/lib/esm/html-iframe-element.js

@@ -1,131 +1,133 @@
-var _a, _b, _c;
+import { iframeWidget, loaded, windowProxy } from "./property-symbol.js";
 import { HTMLElement, PropertySymbol } from "@gjsify/dom-elements";
 import { Event } from "@gjsify/dom-events";
-import * as PS from "./property-symbol.js";
+
+//#region src/html-iframe-element.ts
+let _PS$iframeWidget, _PS$windowProxy, _PS$loaded;
 const { tagName, localName, namespaceURI } = PropertySymbol;
-class HTMLIFrameElement extends HTMLElement {
-  constructor() {
-    super();
-    /** @internal The backing IFrameBridge (set by IFrameBridge when it creates this element) */
-    this[_c] = null;
-    /** @internal The contentWindow proxy */
-    this[_b] = null;
-    /** @internal Whether content has been loaded */
-    this[_a] = false;
-    this[tagName] = "IFRAME";
-    this[localName] = "iframe";
-    this[namespaceURI] = "http://www.w3.org/1999/xhtml";
-  }
-  // -- Attribute-backed string properties --
-  get src() {
-    return this.getAttribute("src") ?? "";
-  }
-  set src(value) {
-    const old = this.getAttribute("src");
-    this.setAttribute("src", value);
-    if (value !== old && value && this[PS.iframeWidget]) {
-      this[PS.iframeWidget].loadUri(value);
-    }
-  }
-  get srcdoc() {
-    return this.getAttribute("srcdoc") ?? "";
-  }
-  set srcdoc(value) {
-    const old = this.getAttribute("srcdoc");
-    this.setAttribute("srcdoc", value);
-    if (value !== old && value && this[PS.iframeWidget]) {
-      this[PS.iframeWidget].loadHtml(value);
-    }
-  }
-  get name() {
-    return this.getAttribute("name") ?? "";
-  }
-  set name(value) {
-    this.setAttribute("name", value);
-  }
-  get sandbox() {
-    return this.getAttribute("sandbox") ?? "";
-  }
-  set sandbox(value) {
-    this.setAttribute("sandbox", value);
-  }
-  get allow() {
-    return this.getAttribute("allow") ?? "";
-  }
-  set allow(value) {
-    this.setAttribute("allow", value);
-  }
-  get referrerPolicy() {
-    return this.getAttribute("referrerpolicy") ?? "";
-  }
-  set referrerPolicy(value) {
-    this.setAttribute("referrerpolicy", value);
-  }
-  get loading() {
-    const value = this.getAttribute("loading");
-    if (value === "lazy" || value === "eager") return value;
-    return "eager";
-  }
-  set loading(value) {
-    this.setAttribute("loading", value);
-  }
-  // -- Attribute-backed string properties (width/height are strings per spec) --
-  get width() {
-    return this.getAttribute("width") ?? "";
-  }
-  set width(value) {
-    this.setAttribute("width", value);
-  }
-  get height() {
-    return this.getAttribute("height") ?? "";
-  }
-  set height(value) {
-    this.setAttribute("height", value);
-  }
-  // -- Content access --
-  /**
-   * Returns the window proxy for the iframe's content.
-   * Available after the IFrameBridge has loaded content.
-   */
-  get contentWindow() {
-    return this[PS.windowProxy];
-  }
-  /**
-   * Always returns null — cross-context boundary.
-   * The WebView content runs in a separate process; direct document access
-   * is not feasible. Use postMessage() for communication.
-   */
-  get contentDocument() {
-    return null;
-  }
-  // -- Methods --
-  /**
-   * Returns a promise that resolves to the iframe's src URL.
-   */
-  getSVGDocument() {
-    return null;
-  }
-  cloneNode(deep = false) {
-    const clone = super.cloneNode(deep);
-    clone[PS.iframeWidget] = null;
-    clone[PS.windowProxy] = null;
-    clone[PS.loaded] = false;
-    return clone;
-  }
-  get [(_c = PS.iframeWidget, _b = PS.windowProxy, _a = PS.loaded, Symbol.toStringTag)]() {
-    return "HTMLIFrameElement";
-  }
-  // -- Internal: called by IFrameBridge --
-  /** @internal Fire load event */
-  _onLoad() {
-    this[PS.loaded] = true;
-    this.dispatchEvent(new Event("load"));
-  }
-  /** @internal Fire error event */
-  _onError() {
-    this.dispatchEvent(new Event("error"));
-  }
-}
-export {
-  HTMLIFrameElement
+/**
+* HTML IFrame Element.
+*
+* Backed by WebKit.WebView when connected to an IFrameBridge.
+* Without a backing widget, behaves as a pure DOM element with attribute storage.
+*
+* Reference: https://developer.mozilla.org/en-US/docs/Web/API/HTMLIFrameElement
+*/
+var HTMLIFrameElement = class extends HTMLElement {
+	constructor() {
+		super();
+		this[_PS$iframeWidget] = null;
+		this[_PS$windowProxy] = null;
+		this[_PS$loaded] = false;
+		this[tagName] = "IFRAME";
+		this[localName] = "iframe";
+		this[namespaceURI] = "http://www.w3.org/1999/xhtml";
+	}
+	get src() {
+		return this.getAttribute("src") ?? "";
+	}
+	set src(value) {
+		const old = this.getAttribute("src");
+		this.setAttribute("src", value);
+		if (value !== old && value && this[iframeWidget]) {
+			this[iframeWidget].loadUri(value);
+		}
+	}
+	get srcdoc() {
+		return this.getAttribute("srcdoc") ?? "";
+	}
+	set srcdoc(value) {
+		const old = this.getAttribute("srcdoc");
+		this.setAttribute("srcdoc", value);
+		if (value !== old && value && this[iframeWidget]) {
+			this[iframeWidget].loadHtml(value);
+		}
+	}
+	get name() {
+		return this.getAttribute("name") ?? "";
+	}
+	set name(value) {
+		this.setAttribute("name", value);
+	}
+	get sandbox() {
+		return this.getAttribute("sandbox") ?? "";
+	}
+	set sandbox(value) {
+		this.setAttribute("sandbox", value);
+	}
+	get allow() {
+		return this.getAttribute("allow") ?? "";
+	}
+	set allow(value) {
+		this.setAttribute("allow", value);
+	}
+	get referrerPolicy() {
+		return this.getAttribute("referrerpolicy") ?? "";
+	}
+	set referrerPolicy(value) {
+		this.setAttribute("referrerpolicy", value);
+	}
+	get loading() {
+		const value = this.getAttribute("loading");
+		if (value === "lazy" || value === "eager") return value;
+		return "eager";
+	}
+	set loading(value) {
+		this.setAttribute("loading", value);
+	}
+	get width() {
+		return this.getAttribute("width") ?? "";
+	}
+	set width(value) {
+		this.setAttribute("width", value);
+	}
+	get height() {
+		return this.getAttribute("height") ?? "";
+	}
+	set height(value) {
+		this.setAttribute("height", value);
+	}
+	/**
+	* Returns the window proxy for the iframe's content.
+	* Available after the IFrameBridge has loaded content.
+	*/
+	get contentWindow() {
+		return this[windowProxy];
+	}
+	/**
+	* Always returns null — cross-context boundary.
+	* The WebView content runs in a separate process; direct document access
+	* is not feasible. Use postMessage() for communication.
+	*/
+	get contentDocument() {
+		return null;
+	}
+	/**
+	* Returns a promise that resolves to the iframe's src URL.
+	*/
+	getSVGDocument() {
+		return null;
+	}
+	cloneNode(deep = false) {
+		const clone = super.cloneNode(deep);
+		clone[iframeWidget] = null;
+		clone[windowProxy] = null;
+		clone[loaded] = false;
+		return clone;
+	}
+	get [(_PS$iframeWidget = iframeWidget, _PS$windowProxy = windowProxy, _PS$loaded = loaded, Symbol.toStringTag)]() {
+		return "HTMLIFrameElement";
+	}
+	/** @internal Fire load event */
+	_onLoad() {
+		this[loaded] = true;
+		this.dispatchEvent(new Event("load"));
+	}
+	/** @internal Fire error event */
+	_onError() {
+		this.dispatchEvent(new Event("error"));
+	}
 };
+
+//#endregion
+export { HTMLIFrameElement };

package/lib/esm/iframe-bridge.js

@@ -1,107 +1,130 @@
-import GObject from "gi://GObject";
-import WebKit from "gi://WebKit?version=6.0";
+import { iframeWidget, windowProxy } from "./property-symbol.js";
 import { HTMLIFrameElement } from "./html-iframe-element.js";
 import { IFrameWindowProxy } from "./iframe-window-proxy.js";
 import { MessageBridge } from "./message-bridge.js";
-import * as PS from "./property-symbol.js";
-const IFrameBridge = GObject.registerClass(
-  { GTypeName: "GjsifyIFrameBridge" },
-  class IFrameBridge2 extends WebKit.WebView {
-    constructor(options) {
-      const { enableDeveloperExtras, enableJavascript, ...webViewProps } = options ?? {};
-      const userContentManager = new WebKit.UserContentManager();
-      const settings = new WebKit.Settings();
-      settings.enable_javascript = enableJavascript ?? true;
-      settings.enable_developer_extras = enableDeveloperExtras ?? true;
-      super({
-        ...webViewProps,
-        user_content_manager: userContentManager,
-        settings
-      });
-      this._readyCallbacks = [];
-      this._options = { enableDeveloperExtras, enableJavascript };
-      this._iframe = new HTMLIFrameElement();
-      this._iframe[PS.iframeWidget] = this;
-      this._messageBridge = new MessageBridge(this);
-      const windowProxy = new IFrameWindowProxy(this._messageBridge);
-      this._iframe[PS.windowProxy] = windowProxy;
-      this._messageBridge.setWindowProxy(windowProxy);
-      this.connect("load-changed", (_webView, event) => {
-        switch (event) {
-          case WebKit.LoadEvent.COMMITTED: {
-            const uri = this.get_uri();
-            if (uri) this._messageBridge.updateUri(uri);
-            break;
-          }
-          case WebKit.LoadEvent.FINISHED:
-            this._iframe._onLoad();
-            for (const cb of this._readyCallbacks) {
-              cb(this._iframe);
-            }
-            this._readyCallbacks = [];
-            break;
-        }
-      });
-      this.connect("load-failed", () => {
-        this._iframe._onError();
-        return false;
-      });
-      this.connect("unrealize", () => {
-        this._messageBridge.destroy();
-        const proxy = this._iframe[PS.windowProxy];
-        if (proxy) {
-          proxy._close();
-        }
-        this._iframe[PS.iframeWidget] = null;
-        this._iframe[PS.windowProxy] = null;
-      });
-    }
-    /** The HTMLIFrameElement wrapping this WebView. */
-    get iframeElement() {
-      return this._iframe;
-    }
-    /**
-     * Register a callback to be invoked when content has loaded.
-     * If content is already loaded, the callback fires on next load.
-     */
-    onReady(cb) {
-      this._readyCallbacks.push(cb);
-    }
-    /**
-     * Load a URI into the WebView.
-     * Also updates the iframe element's src attribute.
-     */
-    loadUri(uri) {
-      this._iframe.setAttribute("src", uri);
-      this.load_uri(uri);
-    }
-    /**
-     * Load inline HTML into the WebView.
-     * Also updates the iframe element's srcdoc attribute.
-     */
-    loadHtml(html, baseUri) {
-      this._iframe.setAttribute("srcdoc", html);
-      this.load_html(html, baseUri ?? "about:srcdoc");
-    }
-    /**
-     * Send a message to the WebView content via the standard postMessage API.
-     * Equivalent to `this.iframeElement.contentWindow.postMessage(message, targetOrigin)`.
-     */
-    postMessage(message, targetOrigin = "*") {
-      this._messageBridge.sendToWebView(message, targetOrigin);
-    }
-    /**
-     * Set `globalThis.HTMLIFrameElement` to the gjsify implementation.
-     */
-    installGlobals() {
-      Object.defineProperty(globalThis, "HTMLIFrameElement", {
-        value: HTMLIFrameElement,
-        writable: true,
-        configurable: true
-      });
-    }
-  }
-);
-export {
-  IFrameBridge
-};
+import GObject from "gi://GObject";
+import WebKit from "gi://WebKit?version=6.0";
+
+//#region src/iframe-bridge.ts
+/**
+* A `WebKit.WebView` subclass that handles iframe bootstrapping:
+* - Sets up WebKit settings (JavaScript, developer extras)
+* - Creates an `HTMLIFrameElement` wrapping this WebView
+* - Sets up postMessage bridge for GJS ↔ WebView communication
+* - Fires `onReady()` callbacks with the iframe element once loaded
+* - `installGlobals()` sets `globalThis.HTMLIFrameElement`
+*
+* Usage:
+* ```ts
+* const iframeWidget = new IFrameBridge();
+* iframeWidget.installGlobals();
+* iframeWidget.onReady((iframe) => {
+*     iframe.contentWindow?.addEventListener('message', (e) => {
+*         console.log('Message from iframe:', e.data);
+*     });
+* });
+* iframeWidget.iframeElement.src = 'https://example.com';
+* window.set_child(iframeWidget);
+* ```
+*/
+const IFrameBridge = GObject.registerClass({ GTypeName: "GjsifyIFrameBridge" }, class IFrameBridge extends WebKit.WebView {
+	constructor(options) {
+		const { enableDeveloperExtras, enableJavascript, ...webViewProps } = options ?? {};
+		const userContentManager = new WebKit.UserContentManager();
+		const settings = new WebKit.Settings();
+		settings.enable_javascript = enableJavascript ?? true;
+		settings.enable_developer_extras = enableDeveloperExtras ?? true;
+		super({
+			...webViewProps,
+			user_content_manager: userContentManager,
+			settings
+		});
+		this._readyCallbacks = [];
+		this._options = {
+			enableDeveloperExtras,
+			enableJavascript
+		};
+		this._iframe = new HTMLIFrameElement();
+		this._iframe[iframeWidget] = this;
+		this._messageBridge = new MessageBridge(this);
+		const windowProxy$1 = new IFrameWindowProxy(this._messageBridge);
+		this._iframe[windowProxy] = windowProxy$1;
+		this._messageBridge.setWindowProxy(windowProxy$1);
+		this.connect("load-changed", (_webView, event) => {
+			switch (event) {
+				case WebKit.LoadEvent.COMMITTED: {
+					const uri = this.get_uri();
+					if (uri) this._messageBridge.updateUri(uri);
+					break;
+				}
+				case WebKit.LoadEvent.FINISHED:
+					this._iframe._onLoad();
+					for (const cb of this._readyCallbacks) {
+						cb(this._iframe);
+					}
+					this._readyCallbacks = [];
+					break;
+			}
+		});
+		this.connect("load-failed", () => {
+			this._iframe._onError();
+			return false;
+		});
+		this.connect("unrealize", () => {
+			this._messageBridge.destroy();
+			const proxy = this._iframe[windowProxy];
+			if (proxy) {
+				proxy._close();
+			}
+			this._iframe[iframeWidget] = null;
+			this._iframe[windowProxy] = null;
+		});
+	}
+	/** The HTMLIFrameElement wrapping this WebView. */
+	get iframeElement() {
+		return this._iframe;
+	}
+	/**
+	* Register a callback to be invoked when content has loaded.
+	* If content is already loaded, the callback fires on next load.
+	*/
+	onReady(cb) {
+		this._readyCallbacks.push(cb);
+	}
+	/**
+	* Load a URI into the WebView.
+	* Also updates the iframe element's src attribute.
+	*/
+	loadUri(uri) {
+		this._iframe.setAttribute("src", uri);
+		this.load_uri(uri);
+	}
+	/**
+	* Load inline HTML into the WebView.
+	* Also updates the iframe element's srcdoc attribute.
+	*/
+	loadHtml(html, baseUri) {
+		this._iframe.setAttribute("srcdoc", html);
+		this.load_html(html, baseUri ?? "about:srcdoc");
+	}
+	/**
+	* Send a message to the WebView content via the standard postMessage API.
+	* Equivalent to `this.iframeElement.contentWindow.postMessage(message, targetOrigin)`.
+	*/
+	postMessage(message, targetOrigin = "*") {
+		this._messageBridge.sendToWebView(message, targetOrigin);
+	}
+	/**
+	* Set `globalThis.HTMLIFrameElement` to the gjsify implementation.
+	*/
+	installGlobals() {
+		Object.defineProperty(globalThis, "HTMLIFrameElement", {
+			value: HTMLIFrameElement,
+			writable: true,
+			configurable: true
+		});
+	}
+});
+
+//#endregion
+export { IFrameBridge };

package/lib/esm/iframe-window-proxy.js

@@ -1,58 +1,73 @@
 import { EventTarget } from "@gjsify/dom-events";
-class IFrameWindowProxy extends EventTarget {
-  constructor(bridge) {
-    super();
-    this._closed = false;
-    this._bridge = bridge;
-  }
-  /**
-   * Send a message to the iframe content.
-   *
-   * @param message - Data to send (must be JSON-serializable)
-   * @param targetOrigin - Target origin for the message. Default: '*'
-   */
-  postMessage(message, targetOrigin = "*") {
-    if (this._closed) return;
-    this._bridge.sendToWebView(message, targetOrigin);
-  }
-  /**
-   * Read-only location reflecting the current WebView URI.
-   */
-  get location() {
-    return this._bridge.getLocation();
-  }
-  /**
-   * Reference to the host (parent) window — in GJS this is globalThis.
-   */
-  get parent() {
-    return globalThis;
-  }
-  /**
-   * Reference to the top-level window — in GJS this is globalThis.
-   */
-  get top() {
-    return globalThis;
-  }
-  /**
-   * The window itself (self-reference per spec).
-   */
-  get self() {
-    return this;
-  }
-  get window() {
-    return this;
-  }
-  get closed() {
-    return this._closed;
-  }
-  /** @internal Mark as closed when the WebView is destroyed */
-  _close() {
-    this._closed = true;
-  }
-  get [Symbol.toStringTag]() {
-    return "IFrameWindowProxy";
-  }
-}
-export {
-  IFrameWindowProxy
+
+//#region src/iframe-window-proxy.ts
+/**
+* Lightweight Window-like proxy returned by `HTMLIFrameElement.contentWindow`.
+*
+* Supports the subset of the Window API needed for cross-origin iframe communication:
+* - `postMessage()` for sending messages to the iframe content
+* - `addEventListener('message', ...)` for receiving messages from the iframe content
+* - `location` (read-only) reflecting the current URI
+* - `parent` reference to the host window
+* - `closed` status
+*
+* This is intentionally NOT a full BrowserWindow — just enough for standard
+* postMessage-based communication patterns.
+*/
+var IFrameWindowProxy = class extends EventTarget {
+	constructor(bridge) {
+		super();
+		this._closed = false;
+		this._bridge = bridge;
+	}
+	/**
+	* Send a message to the iframe content.
+	*
+	* @param message - Data to send (must be JSON-serializable)
+	* @param targetOrigin - Target origin for the message. Default: '*'
+	*/
+	postMessage(message, targetOrigin = "*") {
+		if (this._closed) return;
+		this._bridge.sendToWebView(message, targetOrigin);
+	}
+	/**
+	* Read-only location reflecting the current WebView URI.
+	*/
+	get location() {
+		return this._bridge.getLocation();
+	}
+	/**
+	* Reference to the host (parent) window — in GJS this is globalThis.
+	*/
+	get parent() {
+		return globalThis;
+	}
+	/**
+	* Reference to the top-level window — in GJS this is globalThis.
+	*/
+	get top() {
+		return globalThis;
+	}
+	/**
+	* The window itself (self-reference per spec).
+	*/
+	get self() {
+		return this;
+	}
+	get window() {
+		return this;
+	}
+	get closed() {
+		return this._closed;
+	}
+	/** @internal Mark as closed when the WebView is destroyed */
+	_close() {
+		this._closed = true;
+	}
+	get [Symbol.toStringTag]() {
+		return "IFrameWindowProxy";
+	}
 };
+
+//#endregion
+export { IFrameWindowProxy };

package/lib/esm/index.js

@@ -1,18 +1,16 @@
 import { HTMLIFrameElement } from "./html-iframe-element.js";
-import { IFrameBridge } from "./iframe-bridge.js";
 import { IFrameWindowProxy } from "./iframe-window-proxy.js";
 import { MessageBridge } from "./message-bridge.js";
+import { IFrameBridge } from "./iframe-bridge.js";
 import { Document } from "@gjsify/dom-elements";
-import { HTMLIFrameElement as HTMLIFrameElement2 } from "./html-iframe-element.js";
-Document.registerElementFactory("iframe", () => new HTMLIFrameElement2());
+
+//#region src/index.ts
+Document.registerElementFactory("iframe", () => new HTMLIFrameElement());
 Object.defineProperty(globalThis, "HTMLIFrameElement", {
-  value: HTMLIFrameElement2,
-  writable: true,
-  configurable: true
+	value: HTMLIFrameElement,
+	writable: true,
+	configurable: true
 });
-export {
-  HTMLIFrameElement,
-  IFrameBridge,
-  IFrameWindowProxy,
-  MessageBridge
-};
+
+//#endregion
+export { HTMLIFrameElement, IFrameBridge, IFrameWindowProxy, MessageBridge };

package/lib/esm/message-bridge.js

@@ -1,8 +1,19 @@
-import Gio from "gi://Gio?version=2.0";
-import WebKit from "gi://WebKit?version=6.0";
 import { MessageEvent } from "@gjsify/dom-events";
+import WebKit from "gi://WebKit?version=6.0";
+import Gio from "gi://Gio?version=2.0";
+
+//#region src/message-bridge.ts
 Gio._promisify(WebKit.WebView.prototype, "evaluate_javascript", "evaluate_javascript_finish");
 const CHANNEL_NAME = "gjsify-iframe";
+/**
+* Bootstrap script injected into every WebView page at document start.
+* Provides the `window.parent.postMessage()` bridge from WebView content back to GJS.
+*
+* The script:
+* 1. Gets the WebKit message handler registered under CHANNEL_NAME
+* 2. Creates a parent proxy with a postMessage() that sends via the WebKit handler
+* 3. Overrides window.parent to point to the proxy
+*/
 const BOOTSTRAP_SCRIPT = `(function() {
     var handler = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers['${CHANNEL_NAME}'];
     if (!handler) return;
@@ -14,7 +25,7 @@ const BOOTSTRAP_SCRIPT = `(function() {
         }));
     }
     // In a WebKit.WebView loaded via srcdoc, window.parent === window (no real iframe nesting).
-    // window.parent is [LegacyUnforgeable] \u2014 cannot be redefined with defineProperty.
+    // window.parent is [LegacyUnforgeable] — cannot be redefined with defineProperty.
     // Instead, override window.postMessage directly. Since window.parent === window,
     // calls to window.parent.postMessage() will use our override.
     var origPostMessage = window.postMessage;
@@ -24,106 +35,98 @@ const BOOTSTRAP_SCRIPT = `(function() {
     // Also expose on a safe namespace for explicit use
     window.__gjsifyBridge = { postMessage: bridgePostMessage, origPostMessage: origPostMessage };
 })();`;
-class MessageBridge {
-  constructor(webView) {
-    this._windowProxy = null;
-    this._currentUri = "about:blank";
-    this._signalId = null;
-    this._webView = webView;
-    this._userContentManager = webView.get_user_content_manager();
-    this._setupReceiver();
-    this._injectBootstrapScript();
-  }
-  /** Connect the IFrameWindowProxy that will receive messages from the WebView */
-  setWindowProxy(proxy) {
-    this._windowProxy = proxy;
-  }
-  /** Update current URI (called by IFrameBridge on load-changed) */
-  updateUri(uri) {
-    this._currentUri = uri;
-  }
-  /** Get current location info for the IFrameWindowProxy */
-  getLocation() {
-    let origin;
-    try {
-      const url = new URL(this._currentUri);
-      origin = url.origin;
-    } catch {
-      origin = "null";
-    }
-    return { href: this._currentUri, origin };
-  }
-  /**
-   * Send a message from GJS to the WebView content.
-   * Dispatches a standard MessageEvent on the WebView's window object.
-   */
-  sendToWebView(data, _targetOrigin) {
-    const serialized = JSON.stringify(data);
-    const origin = JSON.stringify("gjsify");
-    const script = `window.dispatchEvent(new MessageEvent('message', { data: JSON.parse(${JSON.stringify(serialized)}), origin: ${origin} }));`;
-    this._webView.evaluate_javascript(
-      script,
-      -1,
-      // length (-1 = null-terminated)
-      null,
-      // world name (null = default)
-      null,
-      // source URI
-      null
-      // cancellable
-    ).catch(() => {
-    });
-  }
-  /** Clean up signal handlers */
-  destroy() {
-    if (this._signalId !== null) {
-      this._userContentManager.disconnect(this._signalId);
-      this._signalId = null;
-    }
-    this._userContentManager.unregister_script_message_handler(CHANNEL_NAME, null);
-    this._windowProxy = null;
-  }
-  /**
-   * Set up the receiver for messages coming from the WebView.
-   * Registers a script message handler and connects to the signal.
-   */
-  _setupReceiver() {
-    this._userContentManager.register_script_message_handler(CHANNEL_NAME, null);
-    this._signalId = this._userContentManager.connect(
-      `script-message-received::${CHANNEL_NAME}`,
-      (_ucm, jsValue) => {
-        if (!this._windowProxy) return;
-        try {
-          const json = jsValue.to_string();
-          const envelope = JSON.parse(json);
-          const event = new MessageEvent("message", {
-            data: envelope.data,
-            origin: envelope.origin
-          });
-          this._windowProxy.dispatchEvent(event);
-        } catch (error) {
-          console.error("[IFrame MessageBridge] Error processing message:", error);
-        }
-      }
-    );
-  }
-  /**
-   * Inject the bootstrap script into the WebView so that
-   * window.parent.postMessage() bridges back to GJS.
-   */
-  _injectBootstrapScript() {
-    const script = new WebKit.UserScript(
-      BOOTSTRAP_SCRIPT,
-      WebKit.UserContentInjectedFrames.ALL_FRAMES,
-      WebKit.UserScriptInjectionTime.START,
-      null,
-      // allow list (null = all)
-      null
-      // block list (null = none)
-    );
-    this._userContentManager.add_script(script);
-  }
-}
-export {
-  MessageBridge
+/**
+* Manages bidirectional postMessage communication between GJS and a WebKit.WebView.
+*
+* Direction 1 — GJS → WebView:
+*   Uses webView.evaluate_javascript() to dispatch a MessageEvent on the WebView's window.
+*
+* Direction 2 — WebView → GJS:
+*   Bootstrap script overrides window.parent.postMessage to call
+*   webkit.messageHandlers[CHANNEL_NAME].postMessage(), which triggers
+*   the UserContentManager 'script-message-received' signal in GJS.
+*/
+var MessageBridge = class {
+	constructor(webView) {
+		this._windowProxy = null;
+		this._currentUri = "about:blank";
+		this._signalId = null;
+		this._webView = webView;
+		this._userContentManager = webView.get_user_content_manager();
+		this._setupReceiver();
+		this._injectBootstrapScript();
+	}
+	/** Connect the IFrameWindowProxy that will receive messages from the WebView */
+	setWindowProxy(proxy) {
+		this._windowProxy = proxy;
+	}
+	/** Update current URI (called by IFrameBridge on load-changed) */
+	updateUri(uri) {
+		this._currentUri = uri;
+	}
+	/** Get current location info for the IFrameWindowProxy */
+	getLocation() {
+		let origin;
+		try {
+			const url = new URL(this._currentUri);
+			origin = url.origin;
+		} catch {
+			origin = "null";
+		}
+		return {
+			href: this._currentUri,
+			origin
+		};
+	}
+	/**
+	* Send a message from GJS to the WebView content.
+	* Dispatches a standard MessageEvent on the WebView's window object.
+	*/
+	sendToWebView(data, _targetOrigin) {
+		const serialized = JSON.stringify(data);
+		const origin = JSON.stringify("gjsify");
+		const script = `window.dispatchEvent(new MessageEvent('message', { data: JSON.parse(${JSON.stringify(serialized)}), origin: ${origin} }));`;
+		this._webView.evaluate_javascript(script, -1, null, null, null).catch(() => {});
+	}
+	/** Clean up signal handlers */
+	destroy() {
+		if (this._signalId !== null) {
+			this._userContentManager.disconnect(this._signalId);
+			this._signalId = null;
+		}
+		this._userContentManager.unregister_script_message_handler(CHANNEL_NAME, null);
+		this._windowProxy = null;
+	}
+	/**
+	* Set up the receiver for messages coming from the WebView.
+	* Registers a script message handler and connects to the signal.
+	*/
+	_setupReceiver() {
+		this._userContentManager.register_script_message_handler(CHANNEL_NAME, null);
+		this._signalId = this._userContentManager.connect(`script-message-received::${CHANNEL_NAME}`, (_ucm, jsValue) => {
+			if (!this._windowProxy) return;
+			try {
+				const json = jsValue.to_string();
+				const envelope = JSON.parse(json);
+				const event = new MessageEvent("message", {
+					data: envelope.data,
+					origin: envelope.origin
+				});
+				this._windowProxy.dispatchEvent(event);
+			} catch (error) {
+				console.error("[IFrame MessageBridge] Error processing message:", error);
+			}
+		});
+	}
+	/**
+	* Inject the bootstrap script into the WebView so that
+	* window.parent.postMessage() bridges back to GJS.
+	*/
+	_injectBootstrapScript() {
+		const script = new WebKit.UserScript(BOOTSTRAP_SCRIPT, WebKit.UserContentInjectedFrames.ALL_FRAMES, WebKit.UserScriptInjectionTime.START, null, null);
+		this._userContentManager.add_script(script);
+	}
 };
+
+//#endregion
+export { MessageBridge };

package/lib/esm/property-symbol.js

@@ -1,8 +1,7 @@
-const iframeWidget = /* @__PURE__ */ Symbol("iframeWidget");
-const windowProxy = /* @__PURE__ */ Symbol("windowProxy");
-const loaded = /* @__PURE__ */ Symbol("loaded");
-export {
-  iframeWidget,
-  loaded,
-  windowProxy
-};
+//#region src/property-symbol.ts
+const iframeWidget = Symbol("iframeWidget");
+const windowProxy = Symbol("windowProxy");
+const loaded = Symbol("loaded");
+
+//#endregion
+export { iframeWidget, loaded, windowProxy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gjsify/iframe",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "HTMLIFrameElement for GJS, backed by WebKit.WebView",
   "type": "module",
   "module": "lib/esm/index.js",
@@ -30,16 +30,16 @@
     "dom"
   ],
   "dependencies": {
-    "@girs/gjs": "^4.0.0-rc.9",
-    "@girs/gtk-4.0": "^4.23.0-4.0.0-rc.9",
+    "@girs/gjs": "4.0.0-rc.9",
+    "@girs/gtk-4.0": "4.23.0-4.0.0-rc.9",
     "@girs/javascriptcore-6.0": "2.52.1-4.0.0-rc.9",
     "@girs/webkit-6.0": "2.52.1-4.0.0-rc.9",
-    "@gjsify/dom-elements": "^0.3.13",
-    "@gjsify/dom-events": "^0.3.13"
+    "@gjsify/dom-elements": "^0.3.15",
+    "@gjsify/dom-events": "^0.3.15"
   },
   "devDependencies": {
-    "@gjsify/cli": "^0.3.13",
-    "@gjsify/unit": "^0.3.13",
+    "@gjsify/cli": "^0.3.15",
+    "@gjsify/unit": "^0.3.15",
     "@types/node": "^25.6.0",
     "typescript": "^6.0.3"
   }