@gjsify/iframe 0.10.0 → 0.12.0

package/lib/esm/console-capture.js

@@ -0,0 +1,24 @@
+import"./_virtual/_rolldown/runtime.js";const e=[`log`,`warn`,`error`,`info`,`debug`];function buildConsoleCaptureScript(t){return`(function(){
+    var handler = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers[${JSON.stringify(t)}];
+    if (!handler) return;
+    if (window.__gjsifyConsoleHook) return;
+    window.__gjsifyConsoleHook = true;
+    function stringify(a){
+        if (typeof a === 'string') return a;
+        if (a instanceof Error) return (a.name || 'Error') + ': ' + (a.message || '');
+        try { return JSON.stringify(a); }
+        catch (_e) { try { return String(a); } catch (_e2) { return '[unserializable]'; } }
+    }
+    var levels = ${JSON.stringify(e)};
+    for (var i = 0; i < levels.length; i++) {
+        (function(level){
+            var orig = (console[level] && console[level].bind) ? console[level].bind(console) : function(){};
+            console[level] = function(){
+                var args = Array.prototype.slice.call(arguments);
+                try { handler.postMessage(JSON.stringify({ __gjsifyConsole: level, args: args.map(stringify) })); }
+                catch (_e) {}
+                return orig.apply(console, arguments);
+            };
+        })(levels[i]);
+    }
+})();`}function parseConsoleEnvelope(e){if(typeof e!=`object`||!e)return null;let t=e.__gjsifyConsole;if(typeof t!=`string`)return null;let n=e.args;return{level:t,args:Array.isArray(n)?n.map(e=>typeof e==`string`?e:String(e)):[]}}var ConsoleBuffer=class{constructor(e=1e3){this._max=e,this._entries=[]}push(e){this._entries.push(e),this._entries.length>this._max&&this._entries.splice(0,this._entries.length-this._max)}list(){return this._entries.slice()}clear(){this._entries=[]}};export{ConsoleBuffer,buildConsoleCaptureScript,parseConsoleEnvelope};

package/lib/esm/dom-queries.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";function buildGetLinksExpression(){return`Array.prototype.slice.call(document.querySelectorAll('a[href]')).map(function(a){return {href:a.href,text:(a.textContent||'').trim(),title:a.getAttribute('title')||''};})`}function buildQueryDomExpression(e,t=200){return`Array.prototype.slice.call(document.querySelectorAll(${JSON.stringify(e)})).slice(0,${Math.max(0,Math.floor(t))}).map(function(el){var r=el.getBoundingClientRect();return {tagName:el.tagName,id:el.id||"",className:(typeof el.className==="string"?el.className:""),text:(el.textContent||"").trim().slice(0,200),href:(el.getAttribute&&el.getAttribute("href"))||undefined,visible:!!(r.width||r.height)};})`}function buildClickElementExpression(e){return`(function(){var t=${JSON.stringify(e)};var el=null;try{el=document.querySelector(t);}catch(_e){el=null;}if(!el){var links=Array.prototype.slice.call(document.querySelectorAll("a"));for(var i=0;i<links.length;i++){if((links[i].textContent||"").trim()===t){el=links[i];break;}}}if(!el)return false;el.click();return true;})()`}export{buildClickElementExpression,buildGetLinksExpression,buildQueryDomExpression};

package/lib/esm/eval.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";function buildEvalScript(e){return`(function(){try{var __v=(`+e+`);if(__v===undefined)return JSON.stringify({__gjsifyEval:'undefined'});return JSON.stringify({__gjsifyEval:'ok',value:__v});}catch(__e){return JSON.stringify({__gjsifyEval:'error',message:String((__e&&__e.message)||__e)});}})()`}function parseEvalResult(e){if(e==null)return;let t;try{t=JSON.parse(e)}catch{return}if(typeof t!=`object`||!t)return;let n=t.__gjsifyEval;if(n===`error`){let e=t.message,n=Error(typeof e==`string`?e:`evaluateJavaScript failed`);throw n.name=`EvalError`,n}if(n!==`undefined`&&n===`ok`)return t.value}export{buildEvalScript,parseEvalResult};

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{notifyElementResize as a}from"@gjsify/dom-elements";import o from"gi://GObject";import s from"gi://WebKit?version=6.0";const c=o.registerClass({GTypeName:`GjsifyIFrameBridge`},class IFrameBridge extends s.WebView{constructor(o){let{enableDeveloperExtras:c,enableJavascript:l,...u}=o??{},d=new s.UserContentManager,f=new s.Settings;f.enable_javascript=l??!0,f.enable_developer_extras=c??!0,super({...u,user_content_manager:d,settings:f}),this._readyCallbacks=[],this._options={enableDeveloperExtras:c,enableJavascript:l},this._iframe=new n,this._iframe[e]=this,this._messageBridge=new i(this);let p=new r(this._messageBridge);this._iframe[t]=p,this._messageBridge.setWindowProxy(p),this.connect(`load-changed`,(e,t)=>{switch(t){case s.LoadEvent.COMMITTED:{let e=this.get_uri();e&&this._messageBridge.updateUri(e);break}case s.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(`resize`,()=>{let e=this.get_allocated_width(),t=this.get_allocated_height();a(this._iframe,e,t)}),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{c as IFrameBridge};
+import"./_virtual/_rolldown/runtime.js";import{buildClickElementExpression as e,buildGetLinksExpression as t,buildQueryDomExpression as n}from"./dom-queries.js";import{buildEvalScript as r,parseEvalResult as i}from"./eval.js";import{iframeWidget as a,windowProxy as o}from"./property-symbol.js";import{HTMLIFrameElement as s}from"./html-iframe-element.js";import{IFrameWindowProxy as c}from"./iframe-window-proxy.js";import"./promisify.js";import{MessageBridge as l}from"./message-bridge.js";import{notifyElementResize as u}from"@gjsify/dom-elements";import d from"gi://GLib?version=2.0";import f from"gi://GObject";import p from"gi://WebKit?version=6.0";const m=f.registerClass({GTypeName:`GjsifyIFrameBridge`},class IFrameBridge extends p.WebView{constructor(e){let{enableDeveloperExtras:t,enableJavascript:n,captureConsole:r,...i}=e??{},u=new p.UserContentManager,d=new p.Settings;d.enable_javascript=n??!0,d.enable_developer_extras=t??!0,super({...i,user_content_manager:u,settings:d}),this._readyCallbacks=[],this._navigationWaiters=[],this._lastLoadError=null,this._loadErrorCallbacks=[],this._options={enableDeveloperExtras:t,enableJavascript:n,captureConsole:r},this._iframe=new s,this._iframe[a]=this,this._messageBridge=new l(this,{captureConsole:r});let f=new c(this._messageBridge);this._iframe[o]=f,this._messageBridge.setWindowProxy(f),this.connect(`load-changed`,(e,t)=>{switch(t){case p.LoadEvent.STARTED:this._lastLoadError=null;break;case p.LoadEvent.COMMITTED:{let e=this.get_uri();e&&this._messageBridge.updateUri(e);break}case p.LoadEvent.FINISHED:this._iframe._onLoad();for(let e of this._readyCallbacks)e(this._iframe);this._readyCallbacks=[],this._settleNavigationWaiters(null);break}}),this.connect(`load-failed`,(e,t,n,r)=>{let i={uri:n,message:r?.message??`load failed`};this._lastLoadError=i;for(let e of this._loadErrorCallbacks)e(i);return this._iframe._onError(),this._settleNavigationWaiters(Error(`load failed for ${n}: ${i.message}`)),!1}),this.connect(`unrealize`,()=>{this._messageBridge.destroy();let e=this._iframe[o];e&&e._close(),this._iframe[a]=null,this._iframe[o]=null})}vfunc_size_allocate(e,t,n){super.vfunc_size_allocate(e,t,n),u(this._iframe,e,t)}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()}get currentUri(){return this.get_uri()??`about:blank`}get pageTitle(){return this.get_title()??``}get lastLoadError(){return this._lastLoadError}onLoadError(e){this._loadErrorCallbacks.push(e)}async evaluateJavaScript(e){return i((await this.evaluate_javascript(r(e),-1,null,null,null))?.to_string()??null)}async takeScreenshot(e=`full`){let t=e===`visible`?p.SnapshotRegion.VISIBLE:p.SnapshotRegion.FULL_DOCUMENT,n=(await this.get_snapshot(t,p.SnapshotOptions.NONE,null)).save_to_png_bytes().get_data();return n?new Uint8Array(n):new Uint8Array}waitForNavigation(e=3e4){return new Promise((t,n)=>{let r={resolve:t,reject:n,sourceId:null};e>0&&(r.sourceId=d.timeout_add(d.PRIORITY_DEFAULT,e,()=>{let t=this._navigationWaiters.indexOf(r);return t!==-1&&this._navigationWaiters.splice(t,1),r.sourceId=null,n(Error(`waitForNavigation: timed out after ${e}ms`)),d.SOURCE_REMOVE})),this._navigationWaiters.push(r)})}_settleNavigationWaiters(e){if(this._navigationWaiters.length===0)return;let t=this._navigationWaiters;this._navigationWaiters=[];for(let n of t)n.sourceId!==null&&(d.source_remove(n.sourceId),n.sourceId=null),e?n.reject(e):n.resolve()}getViewportSize(){return{width:this.get_allocated_width(),height:this.get_allocated_height()}}setViewportSize(e,t){this.set_size_request(e,t)}getConsoleLogs(){return this._messageBridge.getConsoleLogs()}clearConsoleLogs(){this._messageBridge.clearConsoleLogs()}onConsole(e){this._messageBridge.onConsole(e)}async getLinks(){let e=await this.evaluateJavaScript(t());return Array.isArray(e)?e:[]}async queryDom(e,t=200){let r=await this.evaluateJavaScript(n(e,t));return Array.isArray(r)?r:[]}async clickElement(t){return await this.evaluateJavaScript(e(t))===!0}installGlobals(){Object.defineProperty(globalThis,`HTMLIFrameElement`,{value:s,writable:!0,configurable:!0})}});export{m as IFrameBridge};

package/lib/esm/message-bridge.js

@@ -1,5 +1,5 @@
-import"./_virtual/_rolldown/runtime.js";import{BridgePortTransport as e}from"./iframe-message-channel.js";import{BINARY_SERIALIZER_INJECTED_SRC as t,decodeBinariesFromJson as n,encodeBinariesForJson as r}from"./serialize.js";import{MessageEvent as i}from"@gjsify/dom-events";import a from"gi://WebKit?version=6.0";import o from"gi://Gio?version=2.0";o._promisify(a.WebView.prototype,`evaluate_javascript`,`evaluate_javascript_finish`);const s=`gjsify-iframe`,c=`https://gjsify.local`;function normaliseTargetOrigin(e){if(e===`*`)return`*`;if(e===`/`)return null;try{return new URL(e).origin}catch{let t=Error(`Invalid target origin '${e}'`);throw t.name=`SyntaxError`,t}}const BOOTSTRAP_SCRIPT_FOR_TEST=()=>l,l=`(function() {
-    var handler = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers['${s}'];
+import"./_virtual/_rolldown/runtime.js";import{ConsoleBuffer as e,buildConsoleCaptureScript as t,parseConsoleEnvelope as n}from"./console-capture.js";import"./promisify.js";import{BridgePortTransport as r}from"./iframe-message-channel.js";import{BINARY_SERIALIZER_INJECTED_SRC as i,decodeBinariesFromJson as a,encodeBinariesForJson as o}from"./serialize.js";import{MessageEvent as s}from"@gjsify/dom-events";import c from"gi://WebKit?version=6.0";const l=`gjsify-iframe`,u=`https://gjsify.local`;function normaliseTargetOrigin(e){if(e===`*`)return`*`;if(e===`/`)return null;try{return new URL(e).origin}catch{let t=Error(`Invalid target origin '${e}'`);throw t.name=`SyntaxError`,t}}const BOOTSTRAP_SCRIPT_FOR_TEST=()=>d,d=`(function() {
+    var handler = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers['${l}'];
     if (!handler) return;
 
     // Idempotency guard: WebKit auto-injects this script at INJECTION_TIME.START
@@ -11,9 +11,9 @@ import"./_virtual/_rolldown/runtime.js";import{BridgePortTransport as e}from"./i
     // __gjsifyBridge.origPostMessage would loop forever.
     if (window.__gjsifyBridge && window.__gjsifyBridge.__bridgeVersion === 1) return;
 
-    var GJS_HOST_ORIGIN = '${c}';
+    var GJS_HOST_ORIGIN = '${u}';
 
-    ${t}
+    ${i}
 
     // Per-WebView registry of proxy ports created during GJS → WebView
     // postMessage. Keyed by the GJS-allocated portId. Each entry has a
@@ -133,4 +133,4 @@ import"./_virtual/_rolldown/runtime.js";import{BridgePortTransport as e}from"./i
         postMessage: bridgePostMessage,
         origPostMessage: origPostMessage,
     };
-})();`;var MessageBridge=class{_getTransport(){return this._transport===null&&(this._transport=new e(this)),this._transport}constructor(e){this._windowProxy=null,this._currentUri=`about:blank`,this._signalId=null,this._ports=new Map,this._nextPortId=1,this._transport=null,this._webView=e,this._userContentManager=e.get_user_content_manager(),this._setupReceiver(),this._injectBootstrapScript()}setWindowProxy(e){this._windowProxy=e}updateUri(e){this._currentUri=e}getLocation(){let e;try{e=new URL(this._currentUri).origin}catch{e=`null`}return{href:this._currentUri,origin:e}}_registerTransferredPort(e){if(e._transferred)throw Error(`MessagePort: already transferred`);let t=e._partner;if(!t)throw Error(`MessagePort: partner missing — port already transferred or closed`);let n=this._nextPortId++;return e._transferred=!0,e._partner=null,t._partner=null,t._transport=this._getTransport(),t._portId=n,this._ports.set(n,t),n}_sendPortMessage(e,n){let i=r(n),a=JSON.stringify(i),o=`(function(){${t}var p = window.__gjsifyPortRegistry && window.__gjsifyPortRegistry[${e}]; if (p) p.deliver(__decodeBin(JSON.parse(${JSON.stringify(a)})));})();`;this._webView.evaluate_javascript(o,-1,null,null,null).catch(()=>{})}_closePort(e){this._ports.delete(e);let t=`(function(){ if (window.__gjsifyPortRegistry) delete window.__gjsifyPortRegistry[${e}]; })();`;this._webView.evaluate_javascript(t,-1,null,null,null).catch(()=>{})}sendToWebView(e,n,i){let a=normaliseTargetOrigin(n);if(a!==`*`){let e=this.getLocation().origin;if((a??`https://gjsify.local`)!==e)return}let o=e;if(i&&i.length>0){let t=new Map;for(let e of i){let n=this._registerTransferredPort(e);t.set(e,n)}o=substitutePorts(e,t)}let s=r(o),l=JSON.stringify(s),u=JSON.stringify(c),d=`(function(){${t}var d = __decodeBin(JSON.parse(${JSON.stringify(l)})); if (window.__gjsifySubstitutePorts) d = window.__gjsifySubstitutePorts(d); window.dispatchEvent(new MessageEvent('message', { data: d, origin: ${u} }));})();`;this._webView.evaluate_javascript(d,-1,null,null,null).catch(()=>{})}destroy(){this._signalId!==null&&(this._userContentManager.disconnect(this._signalId),this._signalId=null),this._userContentManager.unregister_script_message_handler(s,null),this._windowProxy=null}_setupReceiver(){this._userContentManager.register_script_message_handler(s,null),this._signalId=this._userContentManager.connect(`script-message-received::${s}`,(e,t)=>{if(this._windowProxy)try{let e=t.to_string(),r=JSON.parse(e);if(typeof r.__gjsifyPortMessage==`number`){let e=r,t=this._ports.get(e.__gjsifyPortMessage);t&&t._receive(n(e.payload));return}if(typeof r.__gjsifyPortClose==`number`){let e=r,t=this._ports.get(e.__gjsifyPortClose);t&&t.close(),this._ports.delete(e.__gjsifyPortClose);return}let a=r,o=a.targetOrigin;if(o!==`*`&&o!==`https://gjsify.local`)return;let s=new i(`message`,{data:n(a.data),origin:a.origin});this._windowProxy.dispatchEvent(s)}catch(e){console.error(`[IFrame MessageBridge] Error processing message:`,e)}})}_injectBootstrapScript(){let e=new a.UserScript(l,a.UserContentInjectedFrames.ALL_FRAMES,a.UserScriptInjectionTime.START,null,null);this._userContentManager.add_script(e)}};function substitutePorts(e,t){let n=new WeakMap;function walk(e){if(typeof e!=`object`||!e)return e;if(e[Symbol.toStringTag]===`MessagePort`&&t.has(e))return{__gjsifyPort:t.get(e)};if(n.has(e))return n.get(e);if(Array.isArray(e)){let t=[];n.set(e,t);for(let n=0;n<e.length;n++)t[n]=walk(e[n]);return t}if(Object.prototype.toString.call(e).slice(8,-1)===`Object`){let t={};n.set(e,t);for(let n of Object.keys(e))t[n]=walk(e[n]);return t}return e}return walk(e)}export{BOOTSTRAP_SCRIPT_FOR_TEST,c as GJS_HOST_ORIGIN,MessageBridge,normaliseTargetOrigin};
+})();`;var MessageBridge=class{_getTransport(){return this._transport===null&&(this._transport=new r(this)),this._transport}constructor(t,n){this._windowProxy=null,this._currentUri=`about:blank`,this._signalId=null,this._ports=new Map,this._nextPortId=1,this._transport=null,this._consoleBuffer=new e,this._consoleCallbacks=[],this._webView=t,this._captureConsole=n?.captureConsole??!1,this._userContentManager=t.get_user_content_manager(),this._setupReceiver(),this._injectBootstrapScript(),this._captureConsole&&this._injectConsoleCaptureScript()}getConsoleLogs(){return this._consoleBuffer.list()}clearConsoleLogs(){this._consoleBuffer.clear()}onConsole(e){this._consoleCallbacks.push(e)}_recordConsole(e){this._consoleBuffer.push(e);for(let t of this._consoleCallbacks)t(e)}setWindowProxy(e){this._windowProxy=e}updateUri(e){this._currentUri=e}getLocation(){let e;try{e=new URL(this._currentUri).origin}catch{e=`null`}return{href:this._currentUri,origin:e}}_registerTransferredPort(e){if(e._transferred)throw Error(`MessagePort: already transferred`);let t=e._partner;if(!t)throw Error(`MessagePort: partner missing — port already transferred or closed`);let n=this._nextPortId++;return e._transferred=!0,e._partner=null,t._partner=null,t._transport=this._getTransport(),t._portId=n,this._ports.set(n,t),n}_sendPortMessage(e,t){let n=o(t),r=JSON.stringify(n),a=`(function(){${i}var p = window.__gjsifyPortRegistry && window.__gjsifyPortRegistry[${e}]; if (p) p.deliver(__decodeBin(JSON.parse(${JSON.stringify(r)})));})();`;this._webView.evaluate_javascript(a,-1,null,null,null).catch(()=>{})}_closePort(e){this._ports.delete(e);let t=`(function(){ if (window.__gjsifyPortRegistry) delete window.__gjsifyPortRegistry[${e}]; })();`;this._webView.evaluate_javascript(t,-1,null,null,null).catch(()=>{})}sendToWebView(e,t,n){let r=normaliseTargetOrigin(t);if(r!==`*`){let e=this.getLocation().origin;if((r??`https://gjsify.local`)!==e)return}let a=e;if(n&&n.length>0){let t=new Map;for(let e of n){let n=this._registerTransferredPort(e);t.set(e,n)}a=substitutePorts(e,t)}let s=o(a),c=JSON.stringify(s),l=JSON.stringify(u),d=`(function(){${i}var d = __decodeBin(JSON.parse(${JSON.stringify(c)})); if (window.__gjsifySubstitutePorts) d = window.__gjsifySubstitutePorts(d); window.dispatchEvent(new MessageEvent('message', { data: d, origin: ${l} }));})();`;this._webView.evaluate_javascript(d,-1,null,null,null).catch(()=>{})}destroy(){this._signalId!==null&&(this._userContentManager.disconnect(this._signalId),this._signalId=null),this._userContentManager.unregister_script_message_handler(l,null),this._windowProxy=null}_setupReceiver(){this._userContentManager.register_script_message_handler(l,null),this._signalId=this._userContentManager.connect(`script-message-received::${l}`,(e,t)=>{try{let e=t.to_string(),r=JSON.parse(e),i=n(r);if(i){this._recordConsole(i);return}if(typeof r.__gjsifyPortMessage==`number`){let e=r,t=this._ports.get(e.__gjsifyPortMessage);t&&t._receive(a(e.payload));return}if(typeof r.__gjsifyPortClose==`number`){let e=r,t=this._ports.get(e.__gjsifyPortClose);t&&t.close(),this._ports.delete(e.__gjsifyPortClose);return}if(!this._windowProxy)return;let o=r,c=o.targetOrigin;if(c!==`*`&&c!==`https://gjsify.local`)return;let l=new s(`message`,{data:a(o.data),origin:o.origin});this._windowProxy.dispatchEvent(l)}catch(e){console.error(`[IFrame MessageBridge] Error processing message:`,e)}})}_injectBootstrapScript(){let e=new c.UserScript(d,c.UserContentInjectedFrames.ALL_FRAMES,c.UserScriptInjectionTime.START,null,null);this._userContentManager.add_script(e)}_injectConsoleCaptureScript(){let e=new c.UserScript(t(l),c.UserContentInjectedFrames.ALL_FRAMES,c.UserScriptInjectionTime.START,null,null);this._userContentManager.add_script(e)}};function substitutePorts(e,t){let n=new WeakMap;function walk(e){if(typeof e!=`object`||!e)return e;if(e[Symbol.toStringTag]===`MessagePort`&&t.has(e))return{__gjsifyPort:t.get(e)};if(n.has(e))return n.get(e);if(Array.isArray(e)){let t=[];n.set(e,t);for(let n=0;n<e.length;n++)t[n]=walk(e[n]);return t}if(Object.prototype.toString.call(e).slice(8,-1)===`Object`){let t={};n.set(e,t);for(let n of Object.keys(e))t[n]=walk(e[n]);return t}return e}return walk(e)}export{BOOTSTRAP_SCRIPT_FOR_TEST,u as GJS_HOST_ORIGIN,MessageBridge,normaliseTargetOrigin};

package/lib/esm/promisify.js

@@ -0,0 +1 @@
+import e from"gi://WebKit?version=6.0";import t from"gi://Gio?version=2.0";t._promisify(e.WebView.prototype,`evaluate_javascript`,`evaluate_javascript_finish`),t._promisify(e.WebView.prototype,`get_snapshot`,`get_snapshot_finish`);

package/lib/types/console-capture.d.ts

@@ -0,0 +1,34 @@
+import type { ConsoleLogEntry } from './types/index.js';
+/**
+ * Build the self-contained in-page UserScript that mirrors `console.*` to the
+ * host via `window.webkit.messageHandlers[channelName]`.
+ *
+ * Self-contained (acquires its own handler reference, own idempotency guard) so
+ * it can be injected as a separate UserScript independent of the postMessage
+ * bootstrap — it is opt-in (`captureConsole`), so it must not be entangled with
+ * the always-injected bridge script. ES5 to match the bootstrap's style.
+ *
+ * Each forwarded entry is `{__gjsifyConsole: level, args: string[]}` — args are
+ * stringified in-page (objects via JSON, Errors as `name: message`) so the host
+ * never has to traverse a live JS graph across the bridge.
+ */
+export declare function buildConsoleCaptureScript(channelName: string): string;
+/**
+ * Parse a received envelope into a {@link ConsoleLogEntry}, or null when it is
+ * not a console envelope. Defensive — a tampered page must not crash the host:
+ * non-string args are coerced to strings, a missing args array becomes empty.
+ */
+export declare function parseConsoleEnvelope(envelope: unknown): ConsoleLogEntry | null;
+/**
+ * Bounded ring buffer of console entries. Keeps at most `max` (oldest dropped),
+ * so a chatty page can't grow host memory without bound.
+ */
+export declare class ConsoleBuffer {
+    private readonly _max;
+    private _entries;
+    constructor(_max?: number);
+    push(entry: ConsoleLogEntry): void;
+    /** A copy of the buffered entries (oldest first). */
+    list(): ConsoleLogEntry[];
+    clear(): void;
+}

package/lib/types/console-capture.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/dom-queries.d.ts

@@ -0,0 +1,36 @@
+/** A link harvested by {@link buildGetLinksExpression}. */
+export interface LinkInfo {
+    /** Resolved absolute href. */
+    href: string;
+    /** Trimmed visible text. */
+    text: string;
+    /** `title` attribute (empty when absent). */
+    title: string;
+}
+/** Element metadata returned by {@link buildQueryDomExpression}. */
+export interface ElementInfo {
+    tagName: string;
+    id: string;
+    className: string;
+    /** Trimmed text content, capped to keep payloads small. */
+    text: string;
+    /** `href` attribute when present. */
+    href?: string;
+    /** True when the element has a non-zero bounding box. */
+    visible: boolean;
+}
+/** Expression: every `<a href>` on the page as {@link LinkInfo}[]. */
+export declare function buildGetLinksExpression(): string;
+/**
+ * Expression: `querySelectorAll(selector)` mapped to {@link ElementInfo}[],
+ * capped at `limit` to bound the payload.
+ */
+export declare function buildQueryDomExpression(selector: string, limit?: number): string;
+/**
+ * Expression (returns boolean): click the first element matching `selectorOrText`
+ * — tried first as a CSS selector, then as exact trimmed `<a>` link text. Returns
+ * false when nothing matches. An invalid selector is caught and falls through to
+ * the text match. The caller awaits navigation separately (register
+ * `waitForNavigation()` before invoking, since a fast nav could finish first).
+ */
+export declare function buildClickElementExpression(selectorOrText: string): string;

package/lib/types/dom-queries.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/eval.d.ts

@@ -0,0 +1,30 @@
+/** JSON envelope the in-page wrapper returns. */
+export type EvalResult = {
+    __gjsifyEval: 'ok';
+    value: unknown;
+} | {
+    __gjsifyEval: 'undefined';
+} | {
+    __gjsifyEval: 'error';
+    message: string;
+};
+/**
+ * Wrap a user expression so its value comes back as a JSON string.
+ *
+ * The wrapper always evaluates to a JSON string of one {@link EvalResult}
+ * shape — `ok` with the JSON-serialised value, `undefined` when the value is
+ * `undefined`, or `error` with the thrown message. A value that is not
+ * JSON-serialisable (function, circular object) collapses to `undefined`.
+ */
+export declare function buildEvalScript(expression: string): string;
+/**
+ * Parse the JSON string returned by {@link buildEvalScript} (read off the
+ * JSCValue via `to_string()`).
+ *
+ * - `ok` → the deserialised value.
+ * - `undefined` → `undefined`.
+ * - `error` → throws an `Error` (name `EvalError`) carrying the page message.
+ * - malformed / `null` / non-envelope JSON → `undefined` (defensive — a
+ *   tampered page or a non-wrapper result must not crash the host).
+ */
+export declare function parseEvalResult(json: string | null | undefined): unknown;

package/lib/types/eval.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;