@gtkx/testing 0.14.0 → 0.16.0

package/README.md

@@ -71,6 +71,7 @@ render(<App />, "com.example.counter");
 - **React 19** — Hooks, concurrent features, and the component model you know
 - **Native GTK4 widgets** — Real native controls, not web components in a webview
 - **Adwaita support** — Modern GNOME styling with Libadwaita components
+- **Declarative animations** — Framer Motion-like API using native Adwaita animations
 - **Hot Module Replacement** — Fast refresh during development
 - **TypeScript first** — Full type safety with auto-generated bindings
 - **CSS-in-JS styling** — Familiar styling patterns adapted for GTK
@@ -80,11 +81,11 @@ render(<App />, "com.example.counter");
 
 Explore complete applications in the [`examples/`](./examples) directory:
 
-- **[browser](./examples/browser)** — Simple browser using WebKitWebView
 - **[gtk-demo](./examples/gtk-demo)** — Full replica of the official GTK demo app
 - **[hello-world](./examples/hello-world)** — Minimal application showing a counter
 - **[todo](./examples/todo)** — Full-featured todo application with Adwaita styling and testing
 - **[x-showcase](./examples/x-showcase)** — Showcase of all x.\* virtual components
+- **[browser](./examples/browser)** — Simple browser using WebKitWebView
 - **[deploying](./examples/deploying)** — Example of packaging and distributing a GTKX app
 
 ## Documentation

package/dist/fire-event.d.ts

@@ -1,5 +1,5 @@
+import { Value } from "@gtkx/ffi/gobject";
 import type * as Gtk from "@gtkx/ffi/gtk";
-import type { Arg } from "@gtkx/native";
 /**
  * Emits a GTK signal on a widget or event controller.
  *
@@ -8,20 +8,21 @@ import type { Arg } from "@gtkx/native";
  *
  * @param element - The widget or event controller to emit the signal on
  * @param signalName - GTK signal name (e.g., "clicked", "activate", "drag-begin")
- * @param args - Additional signal arguments
+ * @param args - Additional signal arguments as GValues
  *
  * @example
  * ```tsx
  * import { fireEvent } from "@gtkx/testing";
+ * import { Value } from "@gtkx/ffi/gobject";
  *
  * // Emit signal on widget
  * await fireEvent(widget, "clicked");
  *
  * // Emit signal on gesture controller
  * const gesture = widget.observeControllers().getObject(0) as Gtk.GestureDrag;
- * await fireEvent(gesture, "drag-begin", { type: { type: "float", size: 64 }, value: 100 }, { type: { type: "float", size: 64 }, value: 100 });
+ * await fireEvent(gesture, "drag-begin", Value.newFromDouble(100), Value.newFromDouble(100));
  * ```
  *
  * @see {@link userEvent} for high-level user interactions
  */
-export declare const fireEvent: (element: Gtk.Widget | Gtk.EventController, signalName: string, ...args: Arg[]) => Promise<void>;
+export declare const fireEvent: (element: Gtk.Widget | Gtk.EventController, signalName: string, ...args: Value[]) => Promise<void>;

package/dist/fire-event.js

@@ -1,4 +1,4 @@
-import { call } from "@gtkx/native";
+import { signalEmitv, signalLookup, typeFromName, Value } from "@gtkx/ffi/gobject";
 import { tick } from "./timing.js";
 /**
  * Emits a GTK signal on a widget or event controller.
@@ -8,27 +8,27 @@ import { tick } from "./timing.js";
  *
  * @param element - The widget or event controller to emit the signal on
  * @param signalName - GTK signal name (e.g., "clicked", "activate", "drag-begin")
- * @param args - Additional signal arguments
+ * @param args - Additional signal arguments as GValues
  *
  * @example
  * ```tsx
  * import { fireEvent } from "@gtkx/testing";
+ * import { Value } from "@gtkx/ffi/gobject";
  *
  * // Emit signal on widget
  * await fireEvent(widget, "clicked");
  *
  * // Emit signal on gesture controller
  * const gesture = widget.observeControllers().getObject(0) as Gtk.GestureDrag;
- * await fireEvent(gesture, "drag-begin", { type: { type: "float", size: 64 }, value: 100 }, { type: { type: "float", size: 64 }, value: 100 });
+ * await fireEvent(gesture, "drag-begin", Value.newFromDouble(100), Value.newFromDouble(100));
  * ```
  *
  * @see {@link userEvent} for high-level user interactions
  */
 export const fireEvent = async (element, signalName, ...args) => {
-    call("libgobject-2.0.so.0", "g_signal_emit_by_name", [
-        { type: { type: "gobject", ownership: "borrowed" }, value: element.handle },
-        { type: { type: "string", ownership: "borrowed" }, value: signalName },
-        ...args,
-    ], { type: "undefined" });
+    const gtype = typeFromName(element.constructor.glibTypeName);
+    const signalId = signalLookup(signalName, gtype);
+    const instanceValue = Value.newFromObject(element);
+    signalEmitv([instanceValue, ...args], signalId, 0, null);
     await tick();
 };

package/dist/pretty-widget.js

@@ -1,4 +1,5 @@
 import { getNativeId } from "@gtkx/ffi";
+import * as Gtk from "@gtkx/ffi/gtk";
 import { formatRole } from "./role-helpers.js";
 import { isApplication } from "./traversal.js";
 import { getWidgetText } from "./widget-text.js";
@@ -105,7 +106,7 @@ const printWidget = (widget, colors, depth, includeIds) => {
 };
 const printContainer = (container, colors, includeIds) => {
     if (isApplication(container)) {
-        const windows = container.getWindows();
+        const windows = Gtk.Window.listToplevels();
         return windows.map((window) => printWidget(window, colors, 0, includeIds)).join("");
     }
     return printWidget(container, colors, 0, includeIds);

package/dist/render.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { discardAllBatches, start, stop } from "@gtkx/ffi";
+import { start, stop } from "@gtkx/ffi";
 import * as Gio from "@gtkx/ffi/gio";
 import { ApplicationContext, GtkApplicationWindow, reconciler } from "@gtkx/react";
 import { bindQueries } from "./bind-queries.js";
@@ -20,7 +20,6 @@ const update = async (instance, element, fiberRoot) => {
     }
 };
 const handleError = (error) => {
-    discardAllBatches();
     lastRenderError = error;
 };
 const ensureInitialized = () => {

package/dist/screen.d.ts

@@ -1,4 +1,4 @@
-import type * as Gtk from "@gtkx/ffi/gtk";
+import * as Gtk from "@gtkx/ffi/gtk";
 import { type ScreenshotOptions } from "./screenshot.js";
 import type { ScreenshotResult } from "./types.js";
 /** @internal */

package/dist/screen.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import * as Gtk from "@gtkx/ffi/gtk";
 import { bindQueries } from "./bind-queries.js";
 import { prettyWidget } from "./pretty-widget.js";
 import { logRoles } from "./role-helpers.js";
@@ -80,8 +81,7 @@ export const screen = {
      * ```
      */
     screenshot: async (selector, options) => {
-        const root = getRoot();
-        const windows = root.getWindows();
+        const windows = Gtk.Window.listToplevels();
         if (windows.length === 0) {
             throw new Error("No windows available for screenshot");
         }

package/dist/traversal.d.ts

@@ -1,4 +1,4 @@
-import type * as Gtk from "@gtkx/ffi/gtk";
+import * as Gtk from "@gtkx/ffi/gtk";
 export type Container = Gtk.Application | Gtk.Widget;
 export declare const isApplication: (container: Container) => container is Gtk.Application;
 export declare const traverse: (container: Container) => Generator<Gtk.Widget>;

package/dist/traversal.js

@@ -1,3 +1,4 @@
+import * as Gtk from "@gtkx/ffi/gtk";
 export const isApplication = (container) => "getWindows" in container && typeof container.getWindows === "function";
 const traverseWidgetTree = function* (root) {
     yield root;
@@ -7,15 +8,15 @@ const traverseWidgetTree = function* (root) {
         child = child.getNextSibling();
     }
 };
-const traverseApplication = function* (app) {
-    const windows = app.getWindows();
+const traverseWindows = function* () {
+    const windows = Gtk.Window.listToplevels();
     for (const window of windows) {
         yield* traverseWidgetTree(window);
     }
 };
 export const traverse = function* (container) {
     if (isApplication(container)) {
-        yield* traverseApplication(container);
+        yield* traverseWindows();
     }
     else {
         yield* traverseWidgetTree(container);

package/dist/user-event.d.ts

@@ -6,6 +6,13 @@ export type TabOptions = {
     /** Navigate backwards (Shift+Tab) instead of forwards */
     shift?: boolean;
 };
+/**
+ * Pointer input actions for simulating mouse interactions.
+ *
+ * - `"click"` or `"[MouseLeft]"`: Full click (press + release)
+ * - `"down"` or `"[MouseLeft>]"`: Press and hold
+ * - `"up"` or `"[/MouseLeft]"`: Release
+ */
 export type PointerInput = "click" | "down" | "up" | "[MouseLeft]" | "[MouseLeft>]" | "[/MouseLeft]";
 /**
  * User interaction utilities for testing.
@@ -39,13 +46,13 @@ export declare const userEvent: {
     /**
      * Double-clicks a widget.
      *
-     * Emits two consecutive clicked signals.
+     * Emits pressed/released signals with n_press=1, then n_press=2.
      */
     dblClick: (element: Gtk.Widget) => Promise<void>;
     /**
      * Triple-clicks a widget.
      *
-     * Emits three consecutive clicked signals. Useful for text selection.
+     * Emits pressed/released signals with n_press=1, 2, then 3. Useful for text selection.
      */
     tripleClick: (element: Gtk.Widget) => Promise<void>;
     /**

package/dist/user-event.js

@@ -1,7 +1,7 @@
 import { getNativeObject } from "@gtkx/ffi";
 import * as Gdk from "@gtkx/ffi/gdk";
+import { signalEmitv, signalLookup, typeFromName, Value } from "@gtkx/ffi/gobject";
 import * as Gtk from "@gtkx/ffi/gtk";
-import { call, createRef } from "@gtkx/native";
 import { fireEvent } from "./fire-event.js";
 import { tick } from "./timing.js";
 import { isEditable } from "./widget.js";
@@ -35,14 +35,25 @@ const click = async (element) => {
         await fireEvent(element, "clicked");
     }
 };
+const emitClickSequence = async (element, nPress) => {
+    const controller = getOrCreateController(element, Gtk.GestureClick);
+    for (let i = 1; i <= nPress; i++) {
+        const args = [
+            Value.newFromObject(controller),
+            Value.newFromInt(i),
+            Value.newFromDouble(0),
+            Value.newFromDouble(0),
+        ];
+        signalEmitv(args, getSignalId(controller, "pressed"), 0, null);
+        signalEmitv(args, getSignalId(controller, "released"), 0, null);
+    }
+    await tick();
+};
 const dblClick = async (element) => {
-    await fireEvent(element, "clicked");
-    await fireEvent(element, "clicked");
+    await emitClickSequence(element, 2);
 };
 const tripleClick = async (element) => {
-    await fireEvent(element, "clicked");
-    await fireEvent(element, "clicked");
-    await fireEvent(element, "clicked");
+    await emitClickSequence(element, 3);
 };
 const tab = async (element, options) => {
     const direction = options?.shift ? Gtk.DirectionType.TAB_BACKWARD : Gtk.DirectionType.TAB_FORWARD;
@@ -166,36 +177,18 @@ const getOrCreateController = (element, controllerType) => {
     element.addController(controller);
     return controller;
 };
-const SIGNALS_WITH_RETURN_VALUE = new Set(["key-pressed", "key-released"]);
-const emitSignal = (target, signalName, ...args) => {
-    const signalArgs = args.map((arg) => {
-        if (arg.type === "float") {
-            return { type: { type: "float", size: 64 }, value: arg.value };
-        }
-        return { type: { type: "int", size: 32, unsigned: true }, value: arg.value };
-    });
-    const ffiArgs = [
-        { type: { type: "gobject", ownership: "borrowed" }, value: target.handle },
-        { type: { type: "string", ownership: "borrowed" }, value: signalName },
-        ...signalArgs,
-    ];
-    if (SIGNALS_WITH_RETURN_VALUE.has(signalName)) {
-        const returnRef = createRef(0);
-        ffiArgs.push({
-            type: { type: "ref", innerType: { type: "int", size: 32, unsigned: false } },
-            value: returnRef,
-        });
-    }
-    call("libgobject-2.0.so.0", "g_signal_emit_by_name", ffiArgs, { type: "undefined" });
+const getSignalId = (target, signalName) => {
+    const gtype = typeFromName(target.constructor.glibTypeName);
+    return signalLookup(signalName, gtype);
 };
 const hover = async (element) => {
     const controller = getOrCreateController(element, Gtk.EventControllerMotion);
-    emitSignal(controller, "enter", { type: "float", value: 0 }, { type: "float", value: 0 });
+    signalEmitv([Value.newFromObject(controller), Value.newFromDouble(0), Value.newFromDouble(0)], getSignalId(controller, "enter"), 0, null);
     await tick();
 };
 const unhover = async (element) => {
     const controller = getOrCreateController(element, Gtk.EventControllerMotion);
-    emitSignal(controller, "leave");
+    signalEmitv([Value.newFromObject(controller)], getSignalId(controller, "leave"), 0, null);
     await tick();
 };
 const KEY_MAP = {
@@ -256,12 +249,20 @@ const parseKeyboardInput = (input) => {
     }
     return actions;
 };
+let gdkModifierType = null;
 const keyboard = async (element, input) => {
+    gdkModifierType ??= typeFromName("GdkModifierType");
     const controller = getOrCreateController(element, Gtk.EventControllerKey);
     const actions = parseKeyboardInput(input);
     for (const action of actions) {
         const signalName = action.press ? "key-pressed" : "key-released";
-        emitSignal(controller, signalName, { type: "int", value: action.keyval }, { type: "int", value: 0 }, { type: "int", value: 0 });
+        const returnValue = action.press ? Value.newFromBoolean(false) : null;
+        signalEmitv([
+            Value.newFromObject(controller),
+            Value.newFromUint(action.keyval),
+            Value.newFromUint(0),
+            Value.newFromFlags(gdkModifierType, 0),
+        ], getSignalId(controller, signalName), 0, returnValue);
         if (action.press && action.keyval === Gdk.KEY_Return && isEditable(element)) {
             await fireEvent(element, "activate");
         }
@@ -270,15 +271,27 @@ const keyboard = async (element, input) => {
 };
 const pointer = async (element, input) => {
     const controller = getOrCreateController(element, Gtk.GestureClick);
+    const pressedArgs = [
+        Value.newFromObject(controller),
+        Value.newFromInt(1),
+        Value.newFromDouble(0),
+        Value.newFromDouble(0),
+    ];
+    const releasedArgs = [
+        Value.newFromObject(controller),
+        Value.newFromInt(1),
+        Value.newFromDouble(0),
+        Value.newFromDouble(0),
+    ];
     if (input === "[MouseLeft]" || input === "click") {
-        emitSignal(controller, "pressed", { type: "int", value: 1 }, { type: "float", value: 0 }, { type: "float", value: 0 });
-        emitSignal(controller, "released", { type: "int", value: 1 }, { type: "float", value: 0 }, { type: "float", value: 0 });
+        signalEmitv(pressedArgs, getSignalId(controller, "pressed"), 0, null);
+        signalEmitv(releasedArgs, getSignalId(controller, "released"), 0, null);
     }
     else if (input === "[MouseLeft>]" || input === "down") {
-        emitSignal(controller, "pressed", { type: "int", value: 1 }, { type: "float", value: 0 }, { type: "float", value: 0 });
+        signalEmitv(pressedArgs, getSignalId(controller, "pressed"), 0, null);
     }
     else if (input === "[/MouseLeft]" || input === "up") {
-        emitSignal(controller, "released", { type: "int", value: 1 }, { type: "float", value: 0 }, { type: "float", value: 0 });
+        signalEmitv(releasedArgs, getSignalId(controller, "released"), 0, null);
     }
     await tick();
 };
@@ -314,13 +327,13 @@ export const userEvent = {
     /**
      * Double-clicks a widget.
      *
-     * Emits two consecutive clicked signals.
+     * Emits pressed/released signals with n_press=1, then n_press=2.
      */
     dblClick,
     /**
      * Triple-clicks a widget.
      *
-     * Emits three consecutive clicked signals. Useful for text selection.
+     * Emits pressed/released signals with n_press=1, 2, then 3. Useful for text selection.
      */
     tripleClick,
     /**

package/dist/widget-text.js

@@ -1,4 +1,4 @@
-import { getNativeObject } from "@gtkx/ffi";
+import { getNativeInterface } from "@gtkx/ffi";
 import * as Gtk from "@gtkx/ffi/gtk";
 const ROLES_WITH_INTERNAL_LABELS = new Set([
     Gtk.AccessibleRole.BUTTON,
@@ -77,7 +77,7 @@ export const getWidgetText = (widget) => {
         case Gtk.AccessibleRole.TEXT_BOX:
         case Gtk.AccessibleRole.SEARCH_BOX:
         case Gtk.AccessibleRole.SPIN_BUTTON:
-            return getNativeObject(widget.handle, Gtk.Editable).getText() ?? null;
+            return getNativeInterface(widget, Gtk.Editable)?.getText() ?? null;
         case Gtk.AccessibleRole.GROUP:
             return widget.getLabel?.() ?? null;
         case Gtk.AccessibleRole.WINDOW:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/testing",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Testing utilities for GTKX applications",
   "keywords": [
     "gtkx",
@@ -36,14 +36,13 @@
     "dist"
   ],
   "dependencies": {
-    "@gtkx/ffi": "0.14.0",
-    "@gtkx/native": "0.14.0",
-    "@gtkx/react": "0.14.0"
+    "@gtkx/ffi": "0.16.0",
+    "@gtkx/react": "0.16.0"
   },
   "devDependencies": {
     "@types/react-reconciler": "^0.32.3",
     "react-reconciler": "^0.33.0",
-    "@gtkx/vitest": "0.14.0"
+    "@gtkx/vitest": "0.16.0"
   },
   "scripts": {
     "build": "tsc -b && cp ../../README.md .",