@gjsify/devtools-browser 0.11.1 → 0.12.0

package/lib/esm/browser-window.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{BUILTIN_PAGE_URLS as e,BrowserCore as t}from"./browser-core.js";import n from"@girs/adw-1";import r from"@girs/gtk-4.0";import{IFrameBridge as i}from"@gjsify/iframe";var BrowserWindow=class{constructor(a,o={}){let s=o.homeUrl??`page:welcome`;this._win=new n.ApplicationWindow({application:a,default_width:1100,default_height:720,title:o.title??`Minimalist Browser`});let c=new n.ToolbarView,l=new n.HeaderBar;c.add_top_bar(l);let u=new r.Button({icon_name:`go-previous-symbolic`,tooltip_text:`Back`,sensitive:!1}),d=new r.Button({icon_name:`go-next-symbolic`,tooltip_text:`Forward`,sensitive:!1}),f=new r.Button({icon_name:`view-refresh-symbolic`,tooltip_text:`Reload`});l.pack_start(u),l.pack_start(d),l.pack_start(f);let p=new r.Entry({placeholder_text:`page:welcome or https://…`,hexpand:!0,width_chars:50});p.set_text(s),l.set_title_widget(p);let m=new r.Button({label:`Go`,css_classes:[`suggested-action`]});l.pack_end(m);let h=new r.Box({orientation:r.Orientation.VERTICAL,spacing:0}),g=new r.Box({orientation:r.Orientation.HORIZONTAL,spacing:8,margin_start:12,margin_end:12,margin_top:6,margin_bottom:6}),_=new r.Label({label:`Quick nav:`});_.add_css_class(`dim-label`),g.append(_);for(let t of e){let e=new r.Button({label:t});e.add_css_class(`flat`),e.connect(`clicked`,()=>this._core.navigate(t)),g.append(e)}h.append(g),this._iframeWidget=new i({captureConsole:!0}),this._iframeWidget.installGlobals(),this._iframeWidget.vexpand=!0,this._iframeWidget.hexpand=!0,h.append(this._iframeWidget);let v=new r.Label({halign:r.Align.START,margin_start:12,margin_end:12,margin_top:4,margin_bottom:4});v.add_css_class(`dim-label`),v.add_css_class(`monospace`),v.set_text(`Status: idle`),h.append(v),c.set_content(h),this._win.set_content(c),this._core=new t(this._iframeWidget.iframeElement),this._iframeWidget.onReady(()=>this._core.reattachListener()),this._core.onStateChange(e=>{p.set_text(e.url),u.sensitive=e.canGoBack,d.sensitive=e.canGoForward}),this._core.onPageLoaded(e=>{v.set_text(`Status: loaded "${e.title}" (${e.url})`)});let submitUrl=()=>{let e=p.get_text().trim();e&&this._core.navigate(e)};m.connect(`clicked`,submitUrl),p.connect(`activate`,submitUrl),u.connect(`clicked`,()=>this._core.back()),d.connect(`clicked`,()=>this._core.forward()),f.connect(`clicked`,()=>this._core.reload()),this._core.navigate(s)}get core(){return this._core}get window(){return this._win}get bridge(){return this._iframeWidget}navigate(e){this._core.navigate(e)}present(){this._win.present()}};export{BrowserWindow};
+import"./_virtual/_rolldown/runtime.js";import{BrowserCore as e}from"./browser-core.js";import t from"@girs/adw-1";import n from"@girs/gtk-4.0";import{IFrameBridge as r}from"@gjsify/iframe";var BrowserWindow=class{constructor(i,a={}){let o=a.homeUrl??`page:welcome`;this._win=new t.ApplicationWindow({application:i,default_width:1100,default_height:720,title:a.title??`Minimalist Browser`});let s=new t.ToolbarView,c=new t.HeaderBar;s.add_top_bar(c);let l=new n.Button({icon_name:`go-previous-symbolic`,tooltip_text:`Back`,sensitive:!1}),u=new n.Button({icon_name:`go-next-symbolic`,tooltip_text:`Forward`,sensitive:!1}),d=new n.Button({icon_name:`view-refresh-symbolic`,tooltip_text:`Reload`});c.pack_start(l),c.pack_start(u),c.pack_start(d);let f=new n.Entry({placeholder_text:`page:welcome or https://…`,hexpand:!0});f.set_text(o),c.set_title_widget(f);let p=new n.Button({label:`Go`,css_classes:[`suggested-action`]});c.pack_end(p);let m=new n.Box({orientation:n.Orientation.VERTICAL,spacing:0});this._iframeWidget=new r({captureConsole:!0}),this._iframeWidget.installGlobals(),this._iframeWidget.vexpand=!0,this._iframeWidget.hexpand=!0,m.append(this._iframeWidget);let h=new n.Label({halign:n.Align.START,margin_start:12,margin_end:12,margin_top:4,margin_bottom:4});h.add_css_class(`dim-label`),h.add_css_class(`monospace`),h.set_text(`Status: idle`),m.append(h),s.set_content(m),this._win.set_content(s),this._core=new e(this._iframeWidget.iframeElement),this._iframeWidget.onReady(()=>this._core.reattachListener()),this._core.onStateChange(e=>{f.set_text(e.url),l.sensitive=e.canGoBack,u.sensitive=e.canGoForward}),this._core.onPageLoaded(e=>{h.set_text(`Status: loaded "${e.title}" (${e.url})`)});let submitUrl=()=>{let e=f.get_text().trim();e&&this._core.navigate(e)};p.connect(`clicked`,submitUrl),f.connect(`activate`,submitUrl),l.connect(`clicked`,()=>this._core.back()),u.connect(`clicked`,()=>this._core.forward()),d.connect(`clicked`,()=>this._core.reload()),this._core.navigate(o)}get core(){return this._core}get window(){return this._win}get bridge(){return this._iframeWidget}navigate(e){this._core.navigate(e)}present(){this._win.present()}};export{BrowserWindow};

package/lib/esm/run.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{browserDevtoolsExtension as e}from"./browser-devtools-extension.js";import{BrowserWindow as t}from"./browser-window.js";import n from"@girs/adw-1";import r from"@girs/gio-2.0";import i from"@girs/gobject-2.0";import{installDevtools as a}from"@gjsify/devtools";var o=class BrowserApplication extends n.Application{static{i.registerClass({GTypeName:`GjsifyBrowserApplication`},BrowserApplication)}constructor(e){super({application_id:e.applicationId,flags:r.ApplicationFlags.DEFAULT_FLAGS}),this._window=null,this._options=e,this.connect(`activate`,()=>this._onActivate())}_onActivate(){this._window||(this._window=new t(this,{title:this._options.title,homeUrl:this._options.homeUrl}),a(this,{enabled:this._options.devtools||void 0,winActionGroup:this._window.window,extend:[e({bridge:this._window.bridge,core:this._window.core,window:this._window})]})),this._window.present()}};i.type_ensure(o.$gtype);async function runBrowserDevtools(e){return new o(e).runAsync([imports.system.programInvocationName,...ARGV])}export{o as BrowserApplication,runBrowserDevtools};
+import"./_virtual/_rolldown/runtime.js";import{browserDevtoolsExtension as e}from"./browser-devtools-extension.js";import{BrowserWindow as t}from"./browser-window.js";import n from"@girs/adw-1";import r from"@girs/gio-2.0";import i from"@girs/glib-2.0";import a from"@girs/gobject-2.0";import{installDevtools as o}from"@gjsify/devtools";import{inspectorProtocolExtension as s}from"@gjsify/devtools-cdp";var c=class BrowserApplication extends n.Application{static{a.registerClass({GTypeName:`GjsifyBrowserApplication`},BrowserApplication)}constructor(e){super({application_id:e.applicationId,flags:r.ApplicationFlags.DEFAULT_FLAGS}),this._window=null,this._options=e,e.inspectorPort!==void 0&&i.setenv(`WEBKIT_INSPECTOR_HTTP_SERVER`,`127.0.0.1:${e.inspectorPort}`,!0),this.connect(`activate`,()=>this._onActivate())}_onActivate(){if(!this._window){this._window=new t(this,{title:this._options.title,homeUrl:this._options.homeUrl});let n=[e({bridge:this._window.bridge,core:this._window.core,window:this._window})];this._options.inspectorPort!==void 0&&(this._window.bridge.get_settings().set_enable_developer_extras(!0),n.push(s({port:this._options.inspectorPort}))),o(this,{enabled:this._options.devtools||void 0,winActionGroup:this._window.window,extend:n}),this._options.screenshot&&this._scheduleOneShot(this._options.screenshot)}this._window.present()}_scheduleOneShot(e){let t=this._window;if(!t)return;let n=!1,capture=()=>{n||(n=!0,i.timeout_add(i.PRIORITY_DEFAULT,500,()=>(t.bridge.takeScreenshot(`full`).then(t=>{i.file_set_contents(e,t),console.log(`[gjsify browse] screenshot → ${e} (${t.length} bytes)`),this.quit()}).catch(e=>{console.error(`[gjsify browse] screenshot failed: ${e}`),this.quit()}),i.SOURCE_REMOVE)))};t.core.onPageLoaded(()=>capture()),i.timeout_add_seconds(i.PRIORITY_DEFAULT,10,()=>(capture(),i.SOURCE_REMOVE))}};a.type_ensure(c.$gtype);async function runBrowserDevtools(e){return new c(e).runAsync([imports.system.programInvocationName,...ARGV])}export{c as BrowserApplication,runBrowserDevtools};

package/lib/types/browser-window.d.ts

@@ -9,8 +9,8 @@ export interface BrowserWindowOptions {
 }
 /**
  * A self-contained Adwaita browser window: HeaderBar with back/forward/reload +
- * URL entry, a quick-nav strip over the built-in pages, the WebKit content area,
- * and a status line. The embedded {@link IFrameBridge} captures the page console
+ * URL entry, the WebKit content area, and a status line. The embedded
+ * {@link IFrameBridge} captures the page console
  * so devtools `get_console` works.
  */
 export declare class BrowserWindow {

package/lib/types/run.d.ts

@@ -5,6 +5,21 @@ export interface RunBrowserDevtoolsOptions extends BrowserWindowOptions {
     applicationId: string;
     /** Force-enable the devtools control plane (otherwise gated on `GJSIFY_DEVTOOLS`). */
     devtools?: boolean;
+    /**
+     * Enable WebKit's remote inspector protocol on this port (sets
+     * `WEBKIT_INSPECTOR_HTTP_SERVER=127.0.0.1:<port>` before the WebView is built)
+     * and add the `Cdp*` control-plane methods (@gjsify/devtools-cdp). Drives the
+     * deep protocol (Runtime/DOM/CSS/Network/Console/Debugger) over MCP.
+     */
+    inspectorPort?: number;
+    /**
+     * One-shot mode: once the initial page has loaded, capture a WebKit
+     * screenshot to this path and quit. Turns `gjsify browse <url> --screenshot
+     * out.png` into a build→load→shoot→exit command (CI / quick single captures).
+     * For many stories in one session, drive a *running* browser over the
+     * `Browser*` control plane instead (no relaunch per shot).
+     */
+    screenshot?: string;
 }
 /**
  * Hosts the browser window and installs devtools on activate. Devtools is wired
@@ -16,6 +31,13 @@ export declare class BrowserApplication extends Adw.Application {
     private _options;
     constructor(options: RunBrowserDevtoolsOptions);
     private _onActivate;
+    /**
+     * One-shot screenshot: capture the page once it has loaded (plus a short
+     * settle so it has painted), write it, then quit. Uses the WebKit snapshot
+     * (`bridge.takeScreenshot`) — the generic GSK Screenshot would be blank
+     * because WebKit composites out-of-process.
+     */
+    private _scheduleOneShot;
 }
 /**
  * Construct and run a browser application, resolving with its exit code.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/devtools-browser",
-    "version": "0.11.1",
+    "version": "0.12.0",
     "description": "Minimalist Adwaita web browser for GJS — shared BrowserCore + native Adw shell + a devtools extension so an agent can drive and inspect web apps over MCP",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -41,12 +41,13 @@
         "@girs/gobject-2.0": "2.88.0-4.0.4",
         "@girs/gtk-4.0": "4.23.0-4.0.4",
         "@girs/webkit-6.0": "2.52.1-4.0.4",
-        "@gjsify/devtools": "^0.11.0",
-        "@gjsify/iframe": "^0.11.0"
+        "@gjsify/devtools": "^0.12.0",
+        "@gjsify/devtools-cdp": "^0.12.0",
+        "@gjsify/iframe": "^0.12.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.11.0",
-        "@gjsify/unit": "^0.11.0",
+        "@gjsify/cli": "^0.12.0",
+        "@gjsify/unit": "^0.12.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },