@gtkx/testing 0.13.3 → 0.15.0

package/README.md

@@ -1,18 +1,18 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="60" height="60">
+ <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="60" height="60">
 </p>
 
 <h1 align="center">GTKX</h1>
 
 <p align="center">
-  <strong>Build native GTK4 desktop applications with React and TypeScript.</strong>
+ <strong>Build native GTK4 desktop applications with React and TypeScript.</strong>
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
-  <a href="https://github.com/eugeniodepalo/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
-  <a href="https://github.com/eugeniodepalo/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
-  <a href="https://github.com/eugeniodepalo/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
+ <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
+ <a href="https://github.com/eugeniodepalo/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
+ <a href="https://github.com/eugeniodepalo/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
+ <a href="https://github.com/eugeniodepalo/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
 </p>
 
 ---
@@ -83,7 +83,8 @@ Explore complete applications in the [`examples/`](./examples) directory:
 - **[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
+- **[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,23 +1,28 @@
+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.
+ * Emits a GTK signal on a widget or event controller.
  *
  * Low-level utility for triggering signals directly. Prefer {@link userEvent}
  * for common interactions like clicking and typing.
  *
- * @param element - The widget to emit the signal on
- * @param signalName - GTK signal name (e.g., "clicked", "activate")
- * @param args - Additional signal arguments
+ * @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 as GValues
  *
  * @example
  * ```tsx
  * import { fireEvent } from "@gtkx/testing";
+ * import { Value } from "@gtkx/ffi/gobject";
  *
- * // Emit custom signal
- * await fireEvent(widget, "my-custom-signal");
+ * // 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", Value.newFromDouble(100), Value.newFromDouble(100));
  * ```
  *
  * @see {@link userEvent} for high-level user interactions
  */
-export declare const fireEvent: (element: Gtk.Widget, 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,30 +1,34 @@
-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.
+ * Emits a GTK signal on a widget or event controller.
  *
  * Low-level utility for triggering signals directly. Prefer {@link userEvent}
  * for common interactions like clicking and typing.
  *
- * @param element - The widget to emit the signal on
- * @param signalName - GTK signal name (e.g., "clicked", "activate")
- * @param args - Additional signal arguments
+ * @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 as GValues
  *
  * @example
  * ```tsx
  * import { fireEvent } from "@gtkx/testing";
+ * import { Value } from "@gtkx/ffi/gobject";
  *
- * // Emit custom signal
- * await fireEvent(widget, "my-custom-signal");
+ * // 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", 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/render.d.ts

@@ -15,9 +15,9 @@ import type { RenderOptions, RenderResult } from "./types.js";
  * import { render, screen } from "@gtkx/testing";
  *
  * test("button click", async () => {
- *   await render(<MyButton />);
- *   const button = await screen.findByRole(Gtk.AccessibleRole.BUTTON);
- *   await userEvent.click(button);
+ * await render(<MyButton />);
+ * const button = await screen.findByRole(Gtk.AccessibleRole.BUTTON);
+ * await userEvent.click(button);
  * });
  * ```
  *
@@ -36,12 +36,12 @@ export declare const render: (element: ReactNode, options?: RenderOptions) => Pr
  * import { render, cleanup } from "@gtkx/testing";
  *
  * afterEach(async () => {
- *   await cleanup();
+ * await cleanup();
  * });
  *
  * test("my test", async () => {
- *   await render(<MyComponent />);
- *   // ...
+ * await render(<MyComponent />);
+ * // ...
  * });
  * ```
  */

package/dist/render.js

@@ -55,9 +55,9 @@ const wrapElement = (element, wrapper = true) => {
  * import { render, screen } from "@gtkx/testing";
  *
  * test("button click", async () => {
- *   await render(<MyButton />);
- *   const button = await screen.findByRole(Gtk.AccessibleRole.BUTTON);
- *   await userEvent.click(button);
+ * await render(<MyButton />);
+ * const button = await screen.findByRole(Gtk.AccessibleRole.BUTTON);
+ * await userEvent.click(button);
  * });
  * ```
  *
@@ -96,12 +96,12 @@ export const render = async (element, options) => {
  * import { render, cleanup } from "@gtkx/testing";
  *
  * afterEach(async () => {
- *   await cleanup();
+ * await cleanup();
  * });
  *
  * test("my test", async () => {
- *   await render(<MyComponent />);
- *   // ...
+ * await render(<MyComponent />);
+ * // ...
  * });
  * ```
  */

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.

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 } from "@gtkx/native";
 import { fireEvent } from "./fire-event.js";
 import { tick } from "./timing.js";
 import { isEditable } from "./widget.js";
@@ -166,27 +166,18 @@ const getOrCreateController = (element, controllerType) => {
     element.addController(controller);
     return controller;
 };
-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 };
-    });
-    call("libgobject-2.0.so.0", "g_signal_emit_by_name", [
-        { type: { type: "gobject", ownership: "borrowed" }, value: target.handle },
-        { type: { type: "string", ownership: "borrowed" }, value: signalName },
-        ...signalArgs,
-    ], { 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 = {
@@ -252,7 +243,13 @@ const keyboard = async (element, input) => {
     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 = Value.newFromBoolean(false);
+        signalEmitv([
+            Value.newFromObject(controller),
+            Value.newFromUint(action.keyval),
+            Value.newFromUint(0),
+            Value.newFromUint(0),
+        ], getSignalId(controller, signalName), 0, returnValue);
         if (action.press && action.keyval === Gdk.KEY_Return && isEditable(element)) {
             await fireEvent(element, "activate");
         }
@@ -261,15 +258,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();
 };

package/package.json

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