@gtkx/testing 0.19.0 → 0.21.0

package/src/screenshot.ts

@@ -18,7 +18,7 @@ const captureSnapshot = (widget: Gtk.Widget): ScreenshotResult => {
     const height = paintable.getIntrinsicHeight();
 
     if (width <= 0 || height <= 0) {
-        throw new Error("Widget has no size - ensure it is realized and visible");
+        throw new Error("Widget has no size: ensure it is realized and visible");
     }
 
     const snapshot = new Gtk.Snapshot();
@@ -31,7 +31,7 @@ const captureSnapshot = (widget: Gtk.Widget): ScreenshotResult => {
 
     const display = widget.getDisplay();
     if (!display) {
-        throw new Error("Widget has no display - ensure it is realized");
+        throw new Error("Widget has no display: ensure it is realized");
     }
 
     const renderer = new Gsk.CairoRenderer();
@@ -97,9 +97,9 @@ export const screenshot = async (widget: Gtk.Widget, options?: ScreenshotOptions
             const height = paintable.getIntrinsicHeight();
 
             if (width <= 0 || height <= 0) {
-                return new Error("Widget has no size - ensure it is realized and visible");
+                return new Error("Widget has no size: ensure it is realized and visible");
             }
-            return new Error(`Widget produced no render content after waiting for paint cycle. ${error.message}`);
+            return new Error(`Widget produced no render content after waiting for paint cycle: ${error.message}`);
         },
     });
 };

package/src/types.ts

@@ -118,32 +118,32 @@ export type BoundQueries = {
     queryByLabelText: (text: TextMatch, options?: TextMatchOptions) => Gtk.Widget | null;
     /** Query single element by visible text (returns null if not found) */
     queryByText: (text: TextMatch, options?: TextMatchOptions) => Gtk.Widget | null;
-    /** Query single element by test ID (returns null if not found) */
-    queryByTestId: (testId: TextMatch, options?: TextMatchOptions) => Gtk.Widget | null;
+    /** Query single element by widget name (returns null if not found) */
+    queryByName: (name: TextMatch, options?: TextMatchOptions) => Gtk.Widget | null;
     /** Query all elements by accessible role (returns empty array if none found) */
     queryAllByRole: (role: Gtk.AccessibleRole, options?: ByRoleOptions) => Gtk.Widget[];
     /** Query all elements by label/text content (returns empty array if none found) */
     queryAllByLabelText: (text: TextMatch, options?: TextMatchOptions) => Gtk.Widget[];
     /** Query all elements by visible text (returns empty array if none found) */
     queryAllByText: (text: TextMatch, options?: TextMatchOptions) => Gtk.Widget[];
-    /** Query all elements by test ID (returns empty array if none found) */
-    queryAllByTestId: (testId: TextMatch, options?: TextMatchOptions) => Gtk.Widget[];
+    /** Query all elements by widget name (returns empty array if none found) */
+    queryAllByName: (name: TextMatch, options?: TextMatchOptions) => Gtk.Widget[];
     /** Find single element by accessible role (waits and throws if not found) */
     findByRole: (role: Gtk.AccessibleRole, options?: ByRoleOptions) => Promise<Gtk.Widget>;
     /** Find single element by label/text content (waits and throws if not found) */
     findByLabelText: (text: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget>;
     /** Find single element by visible text (waits and throws if not found) */
     findByText: (text: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget>;
-    /** Find single element by test ID (waits and throws if not found) */
-    findByTestId: (testId: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget>;
+    /** Find single element by widget name (waits and throws if not found) */
+    findByName: (name: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget>;
     /** Find all elements by accessible role (waits and throws if none found) */
     findAllByRole: (role: Gtk.AccessibleRole, options?: ByRoleOptions) => Promise<Gtk.Widget[]>;
     /** Find all elements by label/text content (waits and throws if none found) */
     findAllByLabelText: (text: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget[]>;
     /** Find all elements by visible text (waits and throws if none found) */
     findAllByText: (text: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget[]>;
-    /** Find all elements by test ID (waits and throws if none found) */
-    findAllByTestId: (testId: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget[]>;
+    /** Find all elements by widget name (waits and throws if none found) */
+    findAllByName: (name: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget[]>;
 };
 
 /**

package/src/user-event.ts

@@ -394,7 +394,7 @@ export const userEvent = {
     /**
      * Activates a widget.
      *
-     * Uses GTK's native {@link Gtk.Widget.activate} to trigger the widget's
+     * Uses GTK's native `Gtk.Widget.activate()` to trigger the widget's
      * default action — clicking buttons, toggling checkboxes/switches, etc.
      */
     click,

package/src/wait-for.ts

@@ -46,6 +46,7 @@ export const waitFor = async <T>(callback: () => T | Promise<T>, options?: WaitF
     throw timeoutError;
 };
 
+/** @internal */
 type ElementOrCallback = Gtk.Widget | (() => Gtk.Widget | null);
 
 const getElement = (elementOrCallback: ElementOrCallback): Gtk.Widget | null => {
@@ -107,7 +108,7 @@ export const waitForElementToBeRemoved = async (
         await new Promise((resolve) => setTimeout(resolve, interval));
     }
 
-    const timeoutError = new Error(`Timed out after ${timeout}ms waiting for element to be removed.`);
+    const timeoutError = new Error(`Timed out after ${timeout}ms waiting for element to be removed`);
     if (onTimeout) {
         throw onTimeout(timeoutError);
     }

package/src/widget-text.ts

@@ -120,12 +120,12 @@ export const getWidgetAccessibleName = (widget: Gtk.Widget): string | null => {
 };
 
 /**
- * Gets the test ID from a widget (uses the widget's name property).
+ * Gets the widget name (gtk_widget_get_name).
  *
- * @param widget - The widget to get the test ID from
- * @returns The test ID or null if not set
+ * @param widget - The widget to get the name from
+ * @returns The widget name or null if not set
  */
-export const getWidgetTestId = (widget: Gtk.Widget): string | null => {
+export const getWidgetName = (widget: Gtk.Widget): string | null => {
     return widget.getName();
 };