@gtkx/testing 1.6.0 → 2.0.0-beta.1

package/README.md

@@ -13,7 +13,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
   <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
-  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <img src="https://img.shields.io/badge/node-%E2%89%A526.7-339933?logo=node.js&logoColor=white" alt="Node >= 26.7" />
   <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
   <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
   <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
@@ -116,7 +116,7 @@ At runtime, the native Rust core calls straight into the system GTK4, Adwaita, a
 
 ## Quick start
 
-GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+GTKX is Linux-only and needs Node.js 26.7 or later. See [Requirements](#requirements).
 
 Scaffold a new app with the `create-gtkx` initializer:
 
@@ -145,8 +145,8 @@ The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tu
 
 GTKX is Linux-only. You need:
 
-- Linux with the GTK4 (4.20 or later) and GLib development libraries, plus Adwaita (1.8 or later) once your project binds `Adw-1`
-- Node.js 24 or later
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 26.7 or later
 
 The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
 
@@ -167,7 +167,7 @@ GTKX is stable and ready for production use.
 
 ## Contributing
 
-Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 26.7 or later, pnpm, and a Rust toolchain.
 
 ## License
 

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,KAAK,MAAM,GAAG;IACV,+FAA+F;IAC/F,gBAAgB,EAAE,OAAO,CAAC;IAE1B,0FAA0F;IAC1F,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,KAAK,KAAK,CAAC;IAEnE,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sFAAsF;IACtF,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,KAAK,QAAQ,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAgB5D;;GAEG;AACH,QAAA,MAAM,SAAS,QAAO,MAErB,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,SAAS,GAAI,WAAW,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,KAAG,IAG1D,CAAC;AAMF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,KAAK,MAAM,GAAG;IACV,+FAA+F;IAC/F,gBAAgB,EAAE,OAAO,CAAC;IAE1B,0FAA0F;IAC1F,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,KAAK,KAAK,CAAC;IAEnE,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sFAAsF;IACtF,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,KAAK,QAAQ,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAgB5D;;GAEG;AACH,QAAA,MAAM,SAAS,QAAO,MAAuB,CAAC;AAE9C;;;;;GAKG;AACH,QAAA,MAAM,SAAS,GAAI,WAAW,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,KAAG,IAG1D,CAAC;AAMF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,CAAC"}

package/dist/config.js

@@ -12,9 +12,7 @@ function defaultGetElementError(message) {
 /**
  * Returns the current global testing configuration.
  */
-const getConfig = () => {
-    return currentConfig;
-};
+const getConfig = () => currentConfig;
 /**
  * Merges the given overrides into the global testing configuration.
  *

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAmCA,MAAM,aAAa,GAAW;IAC1B,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,sBAAsB;IACvC,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,GAAG;IACzB,uBAAuB,EAAE,IAAI;CAChC,CAAC;AAEF,MAAM,aAAa,GAAW,EAAE,GAAG,aAAa,EAAE,CAAC;AAEnD,SAAS,sBAAsB,CAAC,OAAe;IAC3C,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,SAAS,GAAG,GAAW,EAAE;IAC3B,OAAO,aAAa,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAAC,SAAqC,EAAQ,EAAE;IAC9D,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,YAAa,SAAQ,KAAK;IACnB,IAAI,GAAG,cAAc,CAAC;CAClC;AAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAA8B,CAAC","sourcesContent":["import type { Container } from \"./traversal.js\";\n\n/**\n * Global configuration for the testing harness, controlling query behavior,\n * error formatting, and the timeouts used by async utilities and actionability\n * checks.\n */\ntype Config = {\n    /** Whether a successful query throws instead, naming a better query, when one is available. */\n    throwSuggestions: boolean;\n\n    /** Builds the error thrown when a query fails, given a message and optional container. */\n    getElementError: (message: string, container?: Container) => Error;\n\n    /** Default timeout in milliseconds for async utilities such as waitFor. */\n    asyncUtilTimeout: number;\n\n    /** Timeout in milliseconds a user event waits for its widget to become actionable. */\n    actionabilityTimeout: number;\n\n    /**\n     * Timeout in milliseconds `render` waits for the window it shows the tree in to be laid out and\n     * activated. A window becoming active is a round trip through the compositor rather than an\n     * in-process check, so this is far longer than {@link Config.actionabilityTimeout}: it bounds\n     * how long a window that never activates takes to report, and costs nothing when one does.\n     */\n    windowActivationTimeout: number;\n};\n\n/**\n * Function form of a configuration update: receives the current config and\n * returns the fields to override.\n */\ntype ConfigFn = (existingConfig: Config) => Partial<Config>;\n\nconst defaultConfig: Config = {\n    throwSuggestions: false,\n    getElementError: defaultGetElementError,\n    asyncUtilTimeout: 1000,\n    actionabilityTimeout: 500,\n    windowActivationTimeout: 5000,\n};\n\nconst currentConfig: Config = { ...defaultConfig };\n\nfunction defaultGetElementError(message: string): Error {\n    return new ElementError(message);\n}\n\n/**\n * Returns the current global testing configuration.\n */\nconst getConfig = (): Config => {\n    return currentConfig;\n};\n\n/**\n * Merges the given overrides into the global testing configuration.\n *\n * @param newConfig Either a partial config object or a function that receives\n * the current config and returns the fields to override.\n */\nconst configure = (newConfig: Partial<Config> | ConfigFn): void => {\n    const updates = typeof newConfig === \"function\" ? newConfig(currentConfig) : newConfig;\n    Object.assign(currentConfig, updates);\n};\n\nclass ElementError extends Error {\n    override name = \"ElementError\";\n}\n\nexport { getConfig, configure, type Config, type ConfigFn };\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAmCA,MAAM,aAAa,GAAW;IAC1B,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,sBAAsB;IACvC,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,GAAG;IACzB,uBAAuB,EAAE,IAAI;CAChC,CAAC;AAEF,MAAM,aAAa,GAAW,EAAE,GAAG,aAAa,EAAE,CAAC;AAEnD,SAAS,sBAAsB,CAAC,OAAe;IAC3C,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,SAAS,GAAG,GAAW,EAAE,CAAC,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAAC,SAAqC,EAAQ,EAAE;IAC9D,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,YAAa,SAAQ,KAAK;IACnB,IAAI,GAAG,cAAc,CAAC;CAClC;AAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAA8B,CAAC","sourcesContent":["import type { Container } from \"./traversal.js\";\n\n/**\n * Global configuration for the testing harness, controlling query behavior,\n * error formatting, and the timeouts used by async utilities and actionability\n * checks.\n */\ntype Config = {\n    /** Whether a successful query throws instead, naming a better query, when one is available. */\n    throwSuggestions: boolean;\n\n    /** Builds the error thrown when a query fails, given a message and optional container. */\n    getElementError: (message: string, container?: Container) => Error;\n\n    /** Default timeout in milliseconds for async utilities such as waitFor. */\n    asyncUtilTimeout: number;\n\n    /** Timeout in milliseconds a user event waits for its widget to become actionable. */\n    actionabilityTimeout: number;\n\n    /**\n     * Timeout in milliseconds `render` waits for the window it shows the tree in to be laid out and\n     * activated. A window becoming active is a round trip through the compositor rather than an\n     * in-process check, so this is far longer than {@link Config.actionabilityTimeout}: it bounds\n     * how long a window that never activates takes to report, and costs nothing when one does.\n     */\n    windowActivationTimeout: number;\n};\n\n/**\n * Function form of a configuration update: receives the current config and\n * returns the fields to override.\n */\ntype ConfigFn = (existingConfig: Config) => Partial<Config>;\n\nconst defaultConfig: Config = {\n    throwSuggestions: false,\n    getElementError: defaultGetElementError,\n    asyncUtilTimeout: 1000,\n    actionabilityTimeout: 500,\n    windowActivationTimeout: 5000,\n};\n\nconst currentConfig: Config = { ...defaultConfig };\n\nfunction defaultGetElementError(message: string): Error {\n    return new ElementError(message);\n}\n\n/**\n * Returns the current global testing configuration.\n */\nconst getConfig = (): Config => currentConfig;\n\n/**\n * Merges the given overrides into the global testing configuration.\n *\n * @param newConfig Either a partial config object or a function that receives\n * the current config and returns the fields to override.\n */\nconst configure = (newConfig: Partial<Config> | ConfigFn): void => {\n    const updates = typeof newConfig === \"function\" ? newConfig(currentConfig) : newConfig;\n    Object.assign(currentConfig, updates);\n};\n\nclass ElementError extends Error {\n    override name = \"ElementError\";\n}\n\nexport { getConfig, configure, type Config, type ConfigFn };\n"]}

package/dist/queries.d.ts

@@ -4,161 +4,65 @@ import { type Container } from "./traversal.js";
 /** The built-in queries in their unbound form, each taking the container to search as its first argument. */
 type BuiltinQueries = QueryFamilies<[container: Container]>;
 declare const builtinQueries: BuiltinQueries;
-/**
- * Returns the single mapped widget with a matching accessible role and options, or null when none
- * match. Widgets that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by accessible role. */
 declare const queryByRole: BuiltinQueries["queryByRole"];
-/**
- * Returns every mapped widget with a matching accessible role and options. Widgets that are not
- * mapped are never matched. Throws when none match.
- */
+/** Gets all mapped widgets with an accessible role. */
 declare const getAllByRole: BuiltinQueries["getAllByRole"];
-/**
- * Returns the single mapped widget with a matching accessible role and options. Widgets that are not
- * mapped are never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by accessible role. */
 declare const getByRole: BuiltinQueries["getByRole"];
-/**
- * Waits for and returns every mapped widget with a matching accessible role and options, retrying
- * until at least one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with an accessible role. */
 declare const findAllByRole: BuiltinQueries["findAllByRole"];
-/**
- * Waits for and returns the single mapped widget with a matching accessible role and options,
- * retrying until it appears or the timeout elapses. Widgets that are not mapped are never matched.
- * Rejects when none or more than one matches.
- */
+/** Finds one mapped widget by accessible role. */
 declare const findByRole: BuiltinQueries["findByRole"];
-/**
- * Returns the single mapped widget with matching associated label text, or null when none match.
- * Widgets that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by label text. */
 declare const queryByLabelText: BuiltinQueries["queryByLabelText"];
-/**
- * Returns every mapped widget with matching associated label text. Widgets that are not mapped are
- * never matched. Throws when none match.
- */
+/** Gets all mapped widgets with label text. */
 declare const getAllByLabelText: BuiltinQueries["getAllByLabelText"];
-/**
- * Returns the single mapped widget with matching associated label text. Widgets that are not mapped
- * are never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by label text. */
 declare const getByLabelText: BuiltinQueries["getByLabelText"];
-/**
- * Waits for and returns every mapped widget with matching associated label text, retrying until at
- * least one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with label text. */
 declare const findAllByLabelText: BuiltinQueries["findAllByLabelText"];
-/**
- * Waits for and returns the single mapped widget with matching associated label text, retrying until
- * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when
- * none or more than one matches.
- */
+/** Finds one mapped widget by label text. */
 declare const findByLabelText: BuiltinQueries["findByLabelText"];
-/**
- * Returns the single mapped widget with matching rendered text content, or null when none match.
- * Widgets that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by rendered text. */
 declare const queryByText: BuiltinQueries["queryByText"];
-/**
- * Returns every mapped widget with matching rendered text content. Widgets that are not mapped are
- * never matched. Throws when none match.
- */
+/** Gets all mapped widgets with rendered text. */
 declare const getAllByText: BuiltinQueries["getAllByText"];
-/**
- * Returns the single mapped widget with matching rendered text content. Widgets that are not mapped
- * are never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by rendered text. */
 declare const getByText: BuiltinQueries["getByText"];
-/**
- * Waits for and returns every mapped widget with matching rendered text content, retrying until at
- * least one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with rendered text. */
 declare const findAllByText: BuiltinQueries["findAllByText"];
-/**
- * Waits for and returns the single mapped widget with matching rendered text content, retrying until
- * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when
- * none or more than one matches.
- */
+/** Finds one mapped widget by rendered text. */
 declare const findByText: BuiltinQueries["findByText"];
-/**
- * Returns the single mapped widget with a matching widget name, or null when none match. Widgets
- * that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by GTK name. */
 declare const queryByName: BuiltinQueries["queryByName"];
-/**
- * Returns every mapped widget with a matching widget name. Widgets that are not mapped are never
- * matched. Throws when none match.
- */
+/** Gets all mapped widgets with a GTK name. */
 declare const getAllByName: BuiltinQueries["getAllByName"];
-/**
- * Returns the single mapped widget with a matching widget name. Widgets that are not mapped are
- * never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by GTK name. */
 declare const getByName: BuiltinQueries["getByName"];
-/**
- * Waits for and returns every mapped widget with a matching widget name, retrying until at least one
- * appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with a GTK name. */
 declare const findAllByName: BuiltinQueries["findAllByName"];
-/**
- * Waits for and returns the single mapped widget with a matching widget name, retrying until it
- * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
- * or more than one matches.
- */
+/** Finds one mapped widget by GTK name. */
 declare const findByName: BuiltinQueries["findByName"];
-/**
- * Returns the single mapped widget with matching placeholder text, or null when none match. Widgets
- * that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by placeholder text. */
 declare const queryByPlaceholderText: BuiltinQueries["queryByPlaceholderText"];
-/**
- * Returns every mapped widget with matching placeholder text. Widgets that are not mapped are never
- * matched. Throws when none match.
- */
+/** Gets all mapped widgets with placeholder text. */
 declare const getAllByPlaceholderText: BuiltinQueries["getAllByPlaceholderText"];
-/**
- * Returns the single mapped widget with matching placeholder text. Widgets that are not mapped are
- * never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by placeholder text. */
 declare const getByPlaceholderText: BuiltinQueries["getByPlaceholderText"];
-/**
- * Waits for and returns every mapped widget with matching placeholder text, retrying until at least
- * one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with placeholder text. */
 declare const findAllByPlaceholderText: BuiltinQueries["findAllByPlaceholderText"];
-/**
- * Waits for and returns the single mapped widget with matching placeholder text, retrying until it
- * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
- * or more than one matches.
- */
+/** Finds one mapped widget by placeholder text. */
 declare const findByPlaceholderText: BuiltinQueries["findByPlaceholderText"];
-/**
- * Returns the single mapped widget with a matching display value, or null when none match. Widgets
- * that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by display value. */
 declare const queryByDisplayValue: BuiltinQueries["queryByDisplayValue"];
-/**
- * Returns every mapped widget with a matching display value. Widgets that are not mapped are never
- * matched. Throws when none match.
- */
+/** Gets all mapped widgets with a display value. */
 declare const getAllByDisplayValue: BuiltinQueries["getAllByDisplayValue"];
-/**
- * Returns the single mapped widget with a matching display value. Widgets that are not mapped are
- * never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by display value. */
 declare const getByDisplayValue: BuiltinQueries["getByDisplayValue"];
-/**
- * Waits for and returns every mapped widget with a matching display value, retrying until at least
- * one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with a display value. */
 declare const findAllByDisplayValue: BuiltinQueries["findAllByDisplayValue"];
-/**
- * Waits for and returns the single mapped widget with a matching display value, retrying until it
- * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
- * or more than one matches.
- */
+/** Finds one mapped widget by display value. */
 declare const findByDisplayValue: BuiltinQueries["findByDisplayValue"];
 declare const isTextMatch: (actual: string | null, expected: Matcher, widget: Gtk.Widget, options?: MatcherOptions) => boolean;
 declare const isMatchingWidgetType: (widget: Gtk.Widget, options?: MatcherOptions) => boolean;

package/dist/queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"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"}

package/dist/queries.js

@@ -18,161 +18,65 @@ const builtinQueries = {
     ...placeholderTextQueries,
     ...displayValueQueries,
 };
-/**
- * Returns the single mapped widget with a matching accessible role and options, or null when none
- * match. Widgets that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by accessible role. */
 const queryByRole = builtinQueries.queryByRole;
-/**
- * Returns every mapped widget with a matching accessible role and options. Widgets that are not
- * mapped are never matched. Throws when none match.
- */
+/** Gets all mapped widgets with an accessible role. */
 const getAllByRole = builtinQueries.getAllByRole;
-/**
- * Returns the single mapped widget with a matching accessible role and options. Widgets that are not
- * mapped are never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by accessible role. */
 const getByRole = builtinQueries.getByRole;
-/**
- * Waits for and returns every mapped widget with a matching accessible role and options, retrying
- * until at least one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with an accessible role. */
 const findAllByRole = builtinQueries.findAllByRole;
-/**
- * Waits for and returns the single mapped widget with a matching accessible role and options,
- * retrying until it appears or the timeout elapses. Widgets that are not mapped are never matched.
- * Rejects when none or more than one matches.
- */
+/** Finds one mapped widget by accessible role. */
 const findByRole = builtinQueries.findByRole;
-/**
- * Returns the single mapped widget with matching associated label text, or null when none match.
- * Widgets that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by label text. */
 const queryByLabelText = builtinQueries.queryByLabelText;
-/**
- * Returns every mapped widget with matching associated label text. Widgets that are not mapped are
- * never matched. Throws when none match.
- */
+/** Gets all mapped widgets with label text. */
 const getAllByLabelText = builtinQueries.getAllByLabelText;
-/**
- * Returns the single mapped widget with matching associated label text. Widgets that are not mapped
- * are never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by label text. */
 const getByLabelText = builtinQueries.getByLabelText;
-/**
- * Waits for and returns every mapped widget with matching associated label text, retrying until at
- * least one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with label text. */
 const findAllByLabelText = builtinQueries.findAllByLabelText;
-/**
- * Waits for and returns the single mapped widget with matching associated label text, retrying until
- * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when
- * none or more than one matches.
- */
+/** Finds one mapped widget by label text. */
 const findByLabelText = builtinQueries.findByLabelText;
-/**
- * Returns the single mapped widget with matching rendered text content, or null when none match.
- * Widgets that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by rendered text. */
 const queryByText = builtinQueries.queryByText;
-/**
- * Returns every mapped widget with matching rendered text content. Widgets that are not mapped are
- * never matched. Throws when none match.
- */
+/** Gets all mapped widgets with rendered text. */
 const getAllByText = builtinQueries.getAllByText;
-/**
- * Returns the single mapped widget with matching rendered text content. Widgets that are not mapped
- * are never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by rendered text. */
 const getByText = builtinQueries.getByText;
-/**
- * Waits for and returns every mapped widget with matching rendered text content, retrying until at
- * least one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with rendered text. */
 const findAllByText = builtinQueries.findAllByText;
-/**
- * Waits for and returns the single mapped widget with matching rendered text content, retrying until
- * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when
- * none or more than one matches.
- */
+/** Finds one mapped widget by rendered text. */
 const findByText = builtinQueries.findByText;
-/**
- * Returns the single mapped widget with a matching widget name, or null when none match. Widgets
- * that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by GTK name. */
 const queryByName = builtinQueries.queryByName;
-/**
- * Returns every mapped widget with a matching widget name. Widgets that are not mapped are never
- * matched. Throws when none match.
- */
+/** Gets all mapped widgets with a GTK name. */
 const getAllByName = builtinQueries.getAllByName;
-/**
- * Returns the single mapped widget with a matching widget name. Widgets that are not mapped are
- * never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by GTK name. */
 const getByName = builtinQueries.getByName;
-/**
- * Waits for and returns every mapped widget with a matching widget name, retrying until at least one
- * appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with a GTK name. */
 const findAllByName = builtinQueries.findAllByName;
-/**
- * Waits for and returns the single mapped widget with a matching widget name, retrying until it
- * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
- * or more than one matches.
- */
+/** Finds one mapped widget by GTK name. */
 const findByName = builtinQueries.findByName;
-/**
- * Returns the single mapped widget with matching placeholder text, or null when none match. Widgets
- * that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by placeholder text. */
 const queryByPlaceholderText = builtinQueries.queryByPlaceholderText;
-/**
- * Returns every mapped widget with matching placeholder text. Widgets that are not mapped are never
- * matched. Throws when none match.
- */
+/** Gets all mapped widgets with placeholder text. */
 const getAllByPlaceholderText = builtinQueries.getAllByPlaceholderText;
-/**
- * Returns the single mapped widget with matching placeholder text. Widgets that are not mapped are
- * never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by placeholder text. */
 const getByPlaceholderText = builtinQueries.getByPlaceholderText;
-/**
- * Waits for and returns every mapped widget with matching placeholder text, retrying until at least
- * one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with placeholder text. */
 const findAllByPlaceholderText = builtinQueries.findAllByPlaceholderText;
-/**
- * Waits for and returns the single mapped widget with matching placeholder text, retrying until it
- * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
- * or more than one matches.
- */
+/** Finds one mapped widget by placeholder text. */
 const findByPlaceholderText = builtinQueries.findByPlaceholderText;
-/**
- * Returns the single mapped widget with a matching display value, or null when none match. Widgets
- * that are not mapped are never matched. Throws when more than one matches.
- */
+/** Queries one mapped widget by display value. */
 const queryByDisplayValue = builtinQueries.queryByDisplayValue;
-/**
- * Returns every mapped widget with a matching display value. Widgets that are not mapped are never
- * matched. Throws when none match.
- */
+/** Gets all mapped widgets with a display value. */
 const getAllByDisplayValue = builtinQueries.getAllByDisplayValue;
-/**
- * Returns the single mapped widget with a matching display value. Widgets that are not mapped are
- * never matched. Throws when none or more than one matches.
- */
+/** Gets one mapped widget by display value. */
 const getByDisplayValue = builtinQueries.getByDisplayValue;
-/**
- * Waits for and returns every mapped widget with a matching display value, retrying until at least
- * one appears or the timeout elapses. Widgets that are not mapped are never matched.
- */
+/** Finds all mapped widgets with a display value. */
 const findAllByDisplayValue = builtinQueries.findAllByDisplayValue;
-/**
- * Waits for and returns the single mapped widget with a matching display value, retrying until it
- * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
- * or more than one matches.
- */
+/** Finds one mapped widget by display value. */
 const findByDisplayValue = builtinQueries.findByDisplayValue;
 const buildNormalizer = (options) => {
     const { normalizer, trim, collapseWhitespace } = options ?? {};