@gjsify/devtools 0.22.0 → 0.24.1

package/lib/esm/widget-tree.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import e from"@girs/gtk-4.0";function parseWidgetPath(e){let t=e.split(`/`).filter(e=>e.length>0);if(t.length===0)return null;let n=t[0].match(/^toplevel:(\d+)$/);if(!n)return null;let r=[];for(let e of t.slice(1)){let t=e.match(/^child:(\d+)$/);if(!t)return null;r.push(Number(t[1]))}return{toplevel:Number(n[1]),children:r}}function buildWidgetPath(e,t){return[`toplevel:${e}`,...t.map(e=>`child:${e}`)].join(`/`)}function widgetType(e){let t=e;return typeof t.$typeName==`string`&&t.$typeName.length>0?t.$typeName:t.constructor?.$gtype?.name??`GtkWidget`}function activateWidget(e){let t=e;return typeof t.activate==`function`?t.activate()===!0:!1}function nthChild(e,t){let n=e.get_first_child(),r=0;for(;n&&r<t;)n=n.get_next_sibling(),r++;return r===t?n:null}function listToplevels(){let t=e.Window.get_toplevels(),n=t.get_n_items(),r=[];for(let e=0;e<n;e++){let n=t.get_item(e);n&&r.push({path:`toplevel:${e}`,type:widgetType(n),title:n.get_title?.()??null,mapped:n.get_mapped(),focused:n.is_active??!1})}return r}function resolveWidgetPath(t){let n=parseWidgetPath(t);if(!n)return null;let r=e.Window.get_toplevels().get_item(n.toplevel);if(!r)return null;for(let e of n.children)if(r=nthChild(r,e),!r)return null;return r}function dumpTree(e,t,n){let r={path:n,type:widgetType(e),name:e.get_name()||null,cssClasses:e.get_css_classes(),mapped:e.get_mapped(),visible:e.get_visible(),children:[]};if(t<=0)return r;let i=e.get_first_child(),a=0;for(;i;)r.children.push(dumpTree(i,t-1,`${n}/child:${a}`)),i=i.get_next_sibling(),a++;return r}function jsonSafe(e){let t=typeof e;return e==null||t===`string`||t===`number`||t===`boolean`?e??null:`[${t}]`}function getWidgetProperty(e,t){let n=e,r=t.replace(/-/g,`_`),i=t.replace(/[-_]([a-z])/g,(e,t)=>t.toUpperCase());for(let e of[t,r,i])if(e in n)return jsonSafe(n[e])}function childIndex(e,t){let n=e.get_first_child(),r=0;for(;n;){if(n===t)return r;n=n.get_next_sibling(),r++}return-1}function pathOfWidget(t){let n=[],r=t,i=r.get_parent();for(;i;){let e=childIndex(i,r);if(e<0)return null;n.unshift(e),r=i,i=r.get_parent()}let a=e.Window.get_toplevels(),o=a.get_n_items();for(let e=0;e<o;e++)if(a.get_item(e)===r)return buildWidgetPath(e,n);return null}export{activateWidget,buildWidgetPath,dumpTree,getWidgetProperty,listToplevels,parseWidgetPath,pathOfWidget,resolveWidgetPath,widgetType};
+import"./_virtual/_rolldown/runtime.js";import e from"@girs/gtk-4.0";function parseWidgetPath(e){let t=e.split(`/`).filter(e=>e.length>0);if(t.length===0)return null;let n=t[0].match(/^toplevel:(\d+)$/);if(!n)return null;let r=[];for(let e of t.slice(1)){let t=e.match(/^child:(\d+)$/);if(!t)return null;r.push(Number(t[1]))}return{toplevel:Number(n[1]),children:r}}function buildWidgetPath(e,t){return[`toplevel:${e}`,...t.map(e=>`child:${e}`)].join(`/`)}function widgetType(e){let t=e;return typeof t.$typeName==`string`&&t.$typeName.length>0?t.$typeName:t.constructor?.$gtype?.name??`GtkWidget`}function activateWidget(e){let t=e;if(typeof t.activate==`function`&&t.activate()===!0)return!0;let n=typeof t.get_parent==`function`?t.get_parent():null;if(n&&widgetType(n)===`GtkListBox`){let t=n,r=!1;return typeof t.select_row==`function`&&(t.select_row(e),r=!0),typeof t.emit==`function`&&(t.emit(`row-activated`,e),r=!0),r}return!1}function nthChild(e,t){let n=e.get_first_child(),r=0;for(;n&&r<t;)n=n.get_next_sibling(),r++;return r===t?n:null}function listToplevels(){let t=e.Window.get_toplevels(),n=t.get_n_items(),r=[];for(let e=0;e<n;e++){let n=t.get_item(e);n&&r.push({path:`toplevel:${e}`,type:widgetType(n),title:n.get_title?.()??null,mapped:n.get_mapped(),focused:n.is_active??!1})}return r}function resolveWidgetPath(t){let n=parseWidgetPath(t);if(!n)return null;let r=e.Window.get_toplevels().get_item(n.toplevel);if(!r)return null;for(let e of n.children)if(r=nthChild(r,e),!r)return null;return r}function dumpTree(e,t,n){let r={path:n,type:widgetType(e),name:e.get_name()||null,cssClasses:e.get_css_classes(),mapped:e.get_mapped(),visible:e.get_visible(),children:[]};if(t<=0)return r;let i=e.get_first_child(),a=0;for(;i;)r.children.push(dumpTree(i,t-1,`${n}/child:${a}`)),i=i.get_next_sibling(),a++;return r}function jsonSafe(e){let t=typeof e;return e==null||t===`string`||t===`number`||t===`boolean`?e??null:`[${t}]`}function getWidgetProperty(e,t){let n=e,r=t.replace(/-/g,`_`),i=t.replace(/[-_]([a-z])/g,(e,t)=>t.toUpperCase());for(let e of[t,r,i])if(e in n)return jsonSafe(n[e])}function childIndex(e,t){let n=e.get_first_child(),r=0;for(;n;){if(n===t)return r;n=n.get_next_sibling(),r++}return-1}function pathOfWidget(t){let n=[],r=t,i=r.get_parent();for(;i;){let e=childIndex(i,r);if(e<0)return null;n.unshift(e),r=i,i=r.get_parent()}let a=e.Window.get_toplevels(),o=a.get_n_items();for(let e=0;e<o;e++)if(a.get_item(e)===r)return buildWidgetPath(e,n);return null}export{activateWidget,buildWidgetPath,dumpTree,getWidgetProperty,listToplevels,parseWidgetPath,pathOfWidget,resolveWidgetPath,widgetType};

package/lib/types/devtools-service.d.ts

@@ -42,9 +42,12 @@ export declare class DevtoolsService {
     GetProperty(path: string, prop: string): string;
     /** `GetFocused() -> s` — JSON {path,name,type} of the focused widget, or null. */
     GetFocused(): string;
-    /** `ActivateWidget(path) -> b` — activate the widget at `path` (Button→clicked,
-     * ActionRow→activated, …), the click-drive counterpart of DumpTree/GetProperty.
-     * Throws if the path resolves to no live widget; returns whether it was activatable. */
+    /** `ActivateWidget(path) -> b` — activate the widget at `path`: its own
+     * default activation (Button→clicked, Entry→activate, Toggle) or, for a
+     * GtkListBoxRow/AdwActionRow, a click on the owning GtkListBox (select the
+     * row + row-activated) so nav / preference rows drive. The click-drive
+     * counterpart of DumpTree/GetProperty. Throws if the path resolves to no
+     * live widget; returns whether it activated. */
     ActivateWidget(path: string): boolean;
     /** `DumpGSettings(schema_id) -> s` — JSON of a schema's keys + values. */
     DumpGSettings(schemaId: string): string;

package/lib/types/widget-tree.d.ts

@@ -26,15 +26,28 @@ export declare function buildWidgetPath(toplevel: number, children: readonly num
  */
 export declare function widgetType(widget: Gtk.Widget): string;
 /**
- * Activate a widget — the "default activation" GTK runs when the user presses
- * Enter on it (a `Gtk.Button` emits `clicked`, an `Adw.ActionRow` emits
- * `activated`, an entry emits `activate`, …). This is how external tooling
- * click-drives a running GUI: resolve a widget by path, then activate it.
+ * Activate a widget — how external tooling click-drives a running GUI: resolve a
+ * widget by path, then activate it. Two paths, tried in order:
  *
- * Returns GTK's own `gtk_widget_activate()` result — `true` if the widget was
- * activatable, `false` if it is not (e.g. a plain container). Duck-typed on the
- * `activate()` accessor for the same cross-runtime reason as {@link widgetType}
- * (GJS vs node-gi both expose it, so the spec can feed a plain mock shape).
+ *  1. **`gtk_widget_activate()`** — the widget's own default-activation signal
+ *     (a `Gtk.Button` emits `clicked`, a `Gtk.Entry` emits `activate`, a
+ *     `Gtk.ToggleButton` toggles). Returns true when it fires.
+ *  2. **Row fallback** — a `GtkListBoxRow` / `AdwActionRow` is NOT activatable
+ *     via `gtk_widget_activate()` (returns false): a row's interaction routes
+ *     through the owning `GtkListBox`, not the row's own signal. So driving a
+ *     sidebar nav row or a preference row over path #1 alone silently no-ops.
+ *     When the widget's parent is a `GtkListBox`, reproduce what a real click on
+ *     a row does — it both SELECTS the row (`select_row` → the `row-selected`
+ *     signal selection-driven nav shells listen to) AND ACTIVATES it
+ *     (`row-activated`, for activatable rows). Doing both drives either wiring
+ *     (a GtkListBox only ever parents rows, so the parent-type check is enough
+ *     to know the widget is the row to pass). `select_row` is a no-op under
+ *     selection-mode `none`, so it is always safe to call.
+ *
+ * Returns true if either path activated the widget, false if neither applies
+ * (e.g. a plain container). Duck-typed on the accessors it reads for the same
+ * cross-runtime reason as {@link widgetType} (GJS vs node-gi both expose them,
+ * so the spec can feed plain mock shapes).
  */
 export declare function activateWidget(widget: Gtk.Widget): boolean;
 /** Enumerate live toplevel windows as `{ path, type, title, mapped, focused }`. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/devtools",
-    "version": "0.22.0",
+    "version": "0.24.1",
     "description": "In-app DBus devtools control plane for GJS/GTK apps — inspect, screenshot, and drive a running app over org.gjsify.Devtools (gdbus or the MCP bridge)",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -43,11 +43,11 @@
         "@girs/gobject-2.0": "^4.1.0",
         "@girs/graphene-1.0": "^4.1.0",
         "@girs/gtk-4.0": "^4.1.0",
-        "@gjsify/devtools-protocol": "^0.22.0"
+        "@gjsify/devtools-protocol": "^0.24.1"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.22.0",
-        "@gjsify/unit": "^0.22.0",
+        "@gjsify/cli": "^0.24.1",
+        "@gjsify/unit": "^0.24.1",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },