@gtkx/testing 0.9.0 → 0.9.2

package/README.md

@@ -22,7 +22,7 @@ GTKX lets you build native Linux desktop applications using React and TypeScript
 ## Features
 
 - **React** — Hooks, state, props, and components you already know
-- **Hot Reload** — Edit code and see changes instantly via Vite
+- **HMR** — Edit code and see changes instantly via Vite
 - **Native** — Direct FFI bindings to GTK4 via Rust and libffi
 - **CLI** — `npx @gtkx/cli@latest create` scaffolds a ready-to-go project
 - **CSS-in-JS** — Emotion-style `css` template literals for GTK styling
@@ -41,14 +41,7 @@ Edit your code and see changes instantly—no restart needed.
 ### Example
 
 ```tsx
-import {
-  render,
-  ApplicationWindow,
-  Box,
-  Button,
-  Label,
-  quit,
-} from "@gtkx/react";
+import { render, ApplicationWindow, Box, Button, quit } from "@gtkx/react";
 import * as Gtk from "@gtkx/ffi/gtk";
 import { useState } from "react";
 
@@ -58,7 +51,7 @@ const App = () => {
   return (
     <ApplicationWindow title="Counter" onCloseRequest={quit}>
       <Box orientation={Gtk.Orientation.VERTICAL} spacing={12}>
-        <Label label={`Count: ${count}`} />
+        {`Count: ${count}`}
         <Button label="Increment" onClicked={() => setCount((c) => c + 1)} />
       </Box>
     </ApplicationWindow>
@@ -84,8 +77,6 @@ const primary = css`
 <Button label="Click me" cssClasses={[primary]} />;
 ```
 
-GTK also provides built-in classes like `suggested-action`, `destructive-action`, `card`, and `heading`.
-
 ## Testing
 
 ```tsx
@@ -109,9 +100,8 @@ test("increments count", async () => {
 
 ## Requirements
 
-- Node.js 20+
+- Node.js 20+ (Deno support experimental)
 - GTK4 Runtime (`gtk4` on Fedora, `libgtk-4-1` on Ubuntu)
-- Linux
 
 ## Contributing
 

package/dist/queries.js

@@ -1,4 +1,4 @@
-import { getInterface } from "@gtkx/ffi";
+import { getNativeObject } from "@gtkx/ffi";
 import * as Gtk from "@gtkx/ffi/gtk";
 import { findAll } from "./traversal.js";
 import { waitFor } from "./wait-for.js";
@@ -50,13 +50,13 @@ const ROLES_WITH_INTERNAL_LABELS = new Set([
     Gtk.AccessibleRole.LINK,
 ]);
 const isInternalLabel = (widget) => {
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible || accessible.getAccessibleRole() !== Gtk.AccessibleRole.LABEL)
         return false;
     const parent = widget.getParent();
     if (!parent)
         return false;
-    const parentAccessible = getInterface(parent.id, Gtk.Accessible);
+    const parentAccessible = getNativeObject(parent.id, Gtk.Accessible);
     if (!parentAccessible)
         return false;
     return ROLES_WITH_INTERNAL_LABELS.has(parentAccessible.getAccessibleRole());
@@ -70,7 +70,7 @@ const collectChildLabels = (widget) => {
     const labels = [];
     let child = widget.getFirstChild();
     while (child) {
-        const childAccessible = getInterface(child.id, Gtk.Accessible);
+        const childAccessible = getNativeObject(child.id, Gtk.Accessible);
         if (childAccessible?.getAccessibleRole() === Gtk.AccessibleRole.LABEL) {
             const labelText = getLabelText(child);
             if (labelText)
@@ -84,7 +84,7 @@ const collectChildLabels = (widget) => {
 const getWidgetText = (widget) => {
     if (isInternalLabel(widget))
         return null;
-    const role = getInterface(widget.id, Gtk.Accessible)?.getAccessibleRole();
+    const role = getNativeObject(widget.id, Gtk.Accessible)?.getAccessibleRole();
     if (role === undefined)
         return null;
     switch (role) {
@@ -109,7 +109,7 @@ const getWidgetText = (widget) => {
         case Gtk.AccessibleRole.TEXT_BOX:
         case Gtk.AccessibleRole.SEARCH_BOX:
         case Gtk.AccessibleRole.SPIN_BUTTON:
-            return getInterface(widget.id, Gtk.Editable)?.getText() ?? null;
+            return getNativeObject(widget.id, Gtk.Editable)?.getText() ?? null;
         case Gtk.AccessibleRole.GROUP:
             return widget.getLabel?.() ?? null;
         case Gtk.AccessibleRole.WINDOW:
@@ -135,7 +135,7 @@ const getWidgetTestId = (widget) => {
     return widget.getName();
 };
 const getWidgetCheckedState = (widget) => {
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible)
         return undefined;
     const role = accessible.getAccessibleRole();
@@ -152,7 +152,7 @@ const getWidgetCheckedState = (widget) => {
     }
 };
 const getWidgetExpandedState = (widget) => {
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible)
         return undefined;
     const role = accessible.getAccessibleRole();
@@ -203,7 +203,7 @@ const formatByRoleError = (role, options) => {
 };
 const getAllByRole = (container, role, options) => {
     const matches = findAll(container, (node) => {
-        const accessible = getInterface(node.id, Gtk.Accessible);
+        const accessible = getNativeObject(node.id, Gtk.Accessible);
         if (!accessible || accessible.getAccessibleRole() !== role)
             return false;
         return matchByRoleOptions(node, options);

package/dist/render.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { getCurrentApp, getInterface, start, stop } from "@gtkx/ffi";
+import { getApplication, getNativeObject, start, stop } from "@gtkx/ffi";
 import * as Gtk from "@gtkx/ffi/gtk";
 import { ApplicationWindow, ROOT_NODE_CONTAINER, reconciler } from "@gtkx/react";
 import * as queries from "./queries.js";
@@ -11,7 +11,7 @@ let container = null;
 const getWidgetLabel = (widget) => {
     if (!hasLabel(widget))
         return null;
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible)
         return null;
     const role = accessible.getAccessibleRole();
@@ -22,7 +22,7 @@ const getWidgetLabel = (widget) => {
 };
 const printWidgetTree = (root, indent = 0) => {
     const prefix = "  ".repeat(indent);
-    const accessibleRole = getInterface(root.id, Gtk.Accessible)?.getAccessibleRole();
+    const accessibleRole = getNativeObject(root.id, Gtk.Accessible)?.getAccessibleRole();
     const role = accessibleRole !== undefined ? (Gtk.AccessibleRole[accessibleRole] ?? "UNKNOWN") : "UNKNOWN";
     const labelText = getWidgetLabel(root);
     const label = labelText ? ` label="${labelText}"` : "";
@@ -96,7 +96,7 @@ export const render = async (element, options) => {
  */
 export const cleanup = async () => {
     if (container) {
-        const app = getCurrentApp();
+        const app = getApplication();
         const instance = reconciler.getInstance();
         await update(instance, null, container);
         for (const window of app.getWindows()) {

package/dist/screen.d.ts

@@ -1,9 +1,5 @@
 import type * as Gtk from "@gtkx/ffi/gtk";
 import type { ByRoleOptions, TextMatch, TextMatchOptions } from "./types.js";
-/**
- * Sets the root application for screen queries. Called internally by render().
- * @param root - The GTK application to use as query root, or null to clear
- */
 export declare const setScreenRoot: (root: Gtk.Application | null) => void;
 /**
  * Global screen object providing query methods bound to the current render root.

package/dist/screen.js

@@ -1,9 +1,5 @@
 import * as queries from "./queries.js";
 let currentRoot = null;
-/**
- * Sets the root application for screen queries. Called internally by render().
- * @param root - The GTK application to use as query root, or null to clear
- */
 export const setScreenRoot = (root) => {
     currentRoot = root;
 };

package/dist/timing.d.ts

@@ -1,4 +1 @@
-/**
- * Returns a promise that resolves on the next event loop tick.
- */
 export declare const tick: () => Promise<void>;

package/dist/timing.js

@@ -1,4 +1 @@
-/**
- * Returns a promise that resolves on the next event loop tick.
- */
 export const tick = () => new Promise((resolve) => setTimeout(resolve, 0));

package/dist/traversal.d.ts

@@ -1,10 +1,4 @@
 import type * as Gtk from "@gtkx/ffi/gtk";
 type Container = Gtk.Application | Gtk.Widget;
-/**
- * Traverses the widget tree and returns all widgets matching the predicate.
- * @param container - The application or widget to search within
- * @param predicate - Function that returns true for matching widgets
- * @returns Array of widgets that match the predicate
- */
 export declare const findAll: (container: Container, predicate: (node: Gtk.Widget) => boolean) => Gtk.Widget[];
 export {};

package/dist/traversal.js

@@ -21,12 +21,6 @@ const traverse = function* (container) {
         yield* traverseWidgetTree(container);
     }
 };
-/**
- * Traverses the widget tree and returns all widgets matching the predicate.
- * @param container - The application or widget to search within
- * @param predicate - Function that returns true for matching widgets
- * @returns Array of widgets that match the predicate
- */
 export const findAll = (container, predicate) => {
     const results = [];
     for (const node of traverse(container)) {

package/dist/user-event.js

@@ -1,4 +1,4 @@
-import { getInterface, getObject } from "@gtkx/ffi";
+import { getNativeObject } from "@gtkx/ffi";
 import * as Gtk from "@gtkx/ffi/gtk";
 import { fireEvent } from "./fire-event.js";
 import { tick } from "./timing.js";
@@ -10,14 +10,14 @@ const TOGGLEABLE_ROLES = new Set([
     Gtk.AccessibleRole.SWITCH,
 ]);
 const isToggleable = (widget) => {
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible)
         return false;
     return TOGGLEABLE_ROLES.has(accessible.getAccessibleRole());
 };
 const click = async (element) => {
     if (isToggleable(element)) {
-        const role = getInterface(element.id, Gtk.Accessible)?.getAccessibleRole();
+        const role = getNativeObject(element.id, Gtk.Accessible)?.getAccessibleRole();
         if (role === Gtk.AccessibleRole.CHECKBOX || role === Gtk.AccessibleRole.RADIO) {
             const checkButton = element;
             checkButton.setActive(!checkButton.getActive());
@@ -53,7 +53,7 @@ const tab = async (element, options) => {
     const direction = options?.shift ? Gtk.DirectionType.TAB_BACKWARD : Gtk.DirectionType.TAB_FORWARD;
     const root = element.getRoot();
     if (root) {
-        getObject(root.id).childFocus(direction);
+        getNativeObject(root.id).childFocus(direction);
     }
     await tick();
 };
@@ -61,7 +61,7 @@ const type = async (element, text) => {
     if (!isEditable(element)) {
         throw new Error("Cannot type into element: element is not editable (TEXT_BOX, SEARCH_BOX, or SPIN_BUTTON)");
     }
-    const editable = getInterface(element.id, Gtk.Editable);
+    const editable = getNativeObject(element.id, Gtk.Editable);
     if (!editable)
         return;
     const currentText = editable.getText();
@@ -72,12 +72,12 @@ const clear = async (element) => {
     if (!isEditable(element)) {
         throw new Error("Cannot clear element: element is not editable (TEXT_BOX, SEARCH_BOX, or SPIN_BUTTON)");
     }
-    getInterface(element.id, Gtk.Editable)?.setText("");
+    getNativeObject(element.id, Gtk.Editable)?.setText("");
     await tick();
 };
 const SELECTABLE_ROLES = new Set([Gtk.AccessibleRole.COMBO_BOX, Gtk.AccessibleRole.LIST]);
 const isSelectable = (widget) => {
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible)
         return false;
     return SELECTABLE_ROLES.has(accessible.getAccessibleRole());
@@ -86,7 +86,7 @@ const selectOptions = async (element, values) => {
     if (!isSelectable(element)) {
         throw new Error("Cannot select options: element is not a selectable widget (COMBO_BOX or LIST)");
     }
-    const role = getInterface(element.id, Gtk.Accessible)?.getAccessibleRole();
+    const role = getNativeObject(element.id, Gtk.Accessible)?.getAccessibleRole();
     const valueArray = Array.isArray(values) ? values : [values];
     if (role === Gtk.AccessibleRole.COMBO_BOX) {
         if (valueArray.length > 1) {
@@ -120,7 +120,7 @@ const selectOptions = async (element, values) => {
     await tick();
 };
 const deselectOptions = async (element, values) => {
-    const role = getInterface(element.id, Gtk.Accessible)?.getAccessibleRole();
+    const role = getNativeObject(element.id, Gtk.Accessible)?.getAccessibleRole();
     if (role !== Gtk.AccessibleRole.LIST) {
         throw new Error("Cannot deselect options: only ListBox supports deselection");
     }

package/dist/widget.d.ts

@@ -1,9 +1,3 @@
 import * as Gtk from "@gtkx/ffi/gtk";
-/**
- * Checks if a widget has an editable accessible role (text box, search box, or spin button).
- */
 export declare const isEditable: (widget: Gtk.Widget) => boolean;
-/**
- * Checks if a widget has an accessible role that supports labels.
- */
 export declare const hasLabel: (widget: Gtk.Widget) => boolean;

package/dist/widget.js

@@ -1,15 +1,12 @@
-import { getInterface } from "@gtkx/ffi";
+import { getNativeObject } from "@gtkx/ffi";
 import * as Gtk from "@gtkx/ffi/gtk";
 const EDITABLE_ROLES = new Set([
     Gtk.AccessibleRole.TEXT_BOX,
     Gtk.AccessibleRole.SEARCH_BOX,
     Gtk.AccessibleRole.SPIN_BUTTON,
 ]);
-/**
- * Checks if a widget has an editable accessible role (text box, search box, or spin button).
- */
 export const isEditable = (widget) => {
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible)
         return false;
     return EDITABLE_ROLES.has(accessible.getAccessibleRole());
@@ -24,11 +21,8 @@ const LABEL_ROLES = new Set([
     Gtk.AccessibleRole.MENU_ITEM_CHECKBOX,
     Gtk.AccessibleRole.MENU_ITEM_RADIO,
 ]);
-/**
- * Checks if a widget has an accessible role that supports labels.
- */
 export const hasLabel = (widget) => {
-    const accessible = getInterface(widget.id, Gtk.Accessible);
+    const accessible = getNativeObject(widget.id, Gtk.Accessible);
     if (!accessible)
         return false;
     return LABEL_ROLES.has(accessible.getAccessibleRole());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/testing",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Testing utilities for GTKX applications",
   "keywords": [
     "gtk",
@@ -32,12 +32,12 @@
     "dist"
   ],
   "dependencies": {
-    "@gtkx/ffi": "0.9.0",
-    "@gtkx/native": "0.9.0",
-    "@gtkx/react": "0.9.0"
+    "@gtkx/ffi": "0.9.2",
+    "@gtkx/react": "0.9.2",
+    "@gtkx/native": "0.9.2"
   },
   "scripts": {
     "build": "tsc -b && cp ../../README.md .",
-    "test": "if [ -n \"$CI\" ]; then vitest run; else GDK_BACKEND=x11 xvfb-run -a vitest run; fi"
+    "test": "../../scripts/run-tests.sh"
   }
 }