@gjsify/iframe 0.4.14 → 0.4.16

package/lib/esm/iframe-bridge.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{iframeWidget as e,windowProxy as t}from"./property-symbol.js";import{HTMLIFrameElement as n}from"./html-iframe-element.js";import{IFrameWindowProxy as r}from"./iframe-window-proxy.js";import{MessageBridge as i}from"./message-bridge.js";import a from"gi://GObject";import o from"gi://WebKit?version=6.0";const s=a.registerClass({GTypeName:`GjsifyIFrameBridge`},class IFrameBridge extends o.WebView{constructor(a){let{enableDeveloperExtras:s,enableJavascript:c,...l}=a??{},u=new o.UserContentManager,d=new o.Settings;d.enable_javascript=c??!0,d.enable_developer_extras=s??!0,super({...l,user_content_manager:u,settings:d}),this._readyCallbacks=[],this._options={enableDeveloperExtras:s,enableJavascript:c},this._iframe=new n,this._iframe[e]=this,this._messageBridge=new i(this);let f=new r(this._messageBridge);this._iframe[t]=f,this._messageBridge.setWindowProxy(f),this.connect(`load-changed`,(e,t)=>{switch(t){case o.LoadEvent.COMMITTED:{let e=this.get_uri();e&&this._messageBridge.updateUri(e);break}case o.LoadEvent.FINISHED:this._iframe._onLoad();for(let e of this._readyCallbacks)e(this._iframe);this._readyCallbacks=[];break}}),this.connect(`load-failed`,()=>(this._iframe._onError(),!1)),this.connect(`unrealize`,()=>{this._messageBridge.destroy();let n=this._iframe[t];n&&n._close(),this._iframe[e]=null,this._iframe[t]=null})}get iframeElement(){return this._iframe}onReady(e){this._readyCallbacks.push(e)}loadUri(e){this._iframe.setAttribute(`src`,e),this.load_uri(e)}loadHtml(e,t){this._iframe.setAttribute(`srcdoc`,e),this.load_html(e,t??`about:srcdoc`)}postMessage(e,t=`*`){this._messageBridge.sendToWebView(e,t)}installGlobals(){Object.defineProperty(globalThis,`HTMLIFrameElement`,{value:n,writable:!0,configurable:!0})}});export{s as IFrameBridge};
+import"./_virtual/_rolldown/runtime.js";import{iframeWidget as e,windowProxy as t}from"./property-symbol.js";import{HTMLIFrameElement as n}from"./html-iframe-element.js";import{IFrameWindowProxy as r}from"./iframe-window-proxy.js";import{MessageBridge as i}from"./message-bridge.js";import a from"gi://GObject";import o from"gi://WebKit?version=6.0";const s=a.registerClass({GTypeName:`GjsifyIFrameBridge`},class IFrameBridge extends o.WebView{constructor(a){let{enableDeveloperExtras:s,enableJavascript:c,...l}=a??{},u=new o.UserContentManager,d=new o.Settings;d.enable_javascript=c??!0,d.enable_developer_extras=s??!0,super({...l,user_content_manager:u,settings:d}),this._readyCallbacks=[],this._options={enableDeveloperExtras:s,enableJavascript:c},this._iframe=new n,this._iframe[e]=this,this._messageBridge=new i(this);let f=new r(this._messageBridge);this._iframe[t]=f,this._messageBridge.setWindowProxy(f),this.connect(`load-changed`,(e,t)=>{switch(t){case o.LoadEvent.COMMITTED:{let e=this.get_uri();e&&this._messageBridge.updateUri(e);break}case o.LoadEvent.FINISHED:this._iframe._onLoad();for(let e of this._readyCallbacks)e(this._iframe);this._readyCallbacks=[];break}}),this.connect(`load-failed`,()=>(this._iframe._onError(),!1)),this.connect(`unrealize`,()=>{this._messageBridge.destroy();let n=this._iframe[t];n&&n._close(),this._iframe[e]=null,this._iframe[t]=null})}get iframeElement(){return this._iframe}onReady(e){this._readyCallbacks.push(e)}loadUri(e){this._iframe.setAttribute(`src`,e),this.load_uri(e)}loadHtml(e,t){this._iframe.setAttribute(`srcdoc`,e),this.load_html(e,t??`about:srcdoc`)}postMessage(e,t=`*`){this._messageBridge.sendToWebView(e,t)}goBack(){this.go_back()}goForward(){this.go_forward()}get canGoBack(){return this.can_go_back()}get canGoForward(){return this.can_go_forward()}installGlobals(){Object.defineProperty(globalThis,`HTMLIFrameElement`,{value:n,writable:!0,configurable:!0})}});export{s as IFrameBridge};

package/lib/types/iframe-bridge.d.ts

@@ -52,6 +52,30 @@ export declare const IFrameBridge: {
          * Equivalent to `this.iframeElement.contentWindow.postMessage(message, targetOrigin)`.
          */
         postMessage(message: unknown, targetOrigin?: string): void;
+        /**
+         * Navigate the embedded WebView back one entry in its internal
+         * history list. No-op when `canGoBack` is false.
+         *
+         * Note: reflects WebKit's own navigation history (independent of
+         * any application-level history the embedder maintains). The
+         * browser `<iframe>` element has no equivalent — cross-origin
+         * iframes cannot be navigated programmatically by the parent. For
+         * cross-variant (browser + GJS) parity, embedders typically track
+         * URLs themselves and call `loadUri(url)`; the methods here exist
+         * for apps that DO want to expose the WebKit-internal back/forward
+         * list directly (e.g. a "WebView with browser-like UX").
+         */
+        goBack(): void;
+        /** Navigate forward in the WebView's internal history. No-op when
+         *  `canGoForward` is false. See `goBack()` for caveats. */
+        goForward(): void;
+        /** True when the WebView has prior entries in its internal history.
+         *  Reflects WebKit's `can-go-back` state, NOT any application-level
+         *  history stack. */
+        get canGoBack(): boolean;
+        /** True when the WebView has forward entries in its internal history.
+         *  Reflects WebKit's `can-go-forward` state. */
+        get canGoForward(): boolean;
         /**
          * Set `globalThis.HTMLIFrameElement` to the gjsify implementation.
          */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/iframe",
-    "version": "0.4.14",
+    "version": "0.4.16",
     "description": "HTMLIFrameElement for GJS, backed by WebKit.WebView",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -37,13 +37,13 @@
         "@girs/gtk-4.0": "4.23.0-4.0.0-rc.15",
         "@girs/javascriptcore-6.0": "2.52.1-4.0.0-rc.15",
         "@girs/webkit-6.0": "2.52.1-4.0.0-rc.15",
-        "@gjsify/dom-elements": "^0.4.14",
-        "@gjsify/dom-events": "^0.4.14",
-        "@gjsify/message-channel": "^0.4.14"
+        "@gjsify/dom-elements": "^0.4.16",
+        "@gjsify/dom-events": "^0.4.16",
+        "@gjsify/message-channel": "^0.4.16"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.4.14",
-        "@gjsify/unit": "^0.4.14",
+        "@gjsify/cli": "^0.4.16",
+        "@gjsify/unit": "^0.4.16",
         "@types/node": "^25.6.2",
         "typescript": "^6.0.3"
     }