@gtkx/testing 0.21.0 → 1.0.0-rc.2

package/dist/traversal.d.ts

@@ -1,13 +1,15 @@
-import * as Gtk from "@gtkx/ffi/gtk";
+import * as Gtk from "@gtkx/gi/gtk";
+type QueryContainer = Gtk.Widget | Gtk.EventController | Gtk.LayoutManager | Gtk.ListItem | Gtk.ListHeader;
 /**
- * Root element for scoping queries.
- *
- * When a `Gtk.Application` is provided, queries search across all toplevel
- * windows. When a `Gtk.Widget` is provided, queries are scoped to that
- * widget's subtree.
+ * A scope that queries and traversal can run against: a widget, an event
+ * controller, a layout manager, a list item or header, an application, or the
+ * sentinel representing all current toplevel windows.
  */
-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>;
-export declare const findAll: (container: Container, predicate: (node: Gtk.Widget) => boolean) => Gtk.Widget[];
+type Container = QueryContainer | Gtk.Application | typeof TOPLEVELS;
+declare const TOPLEVELS: unique symbol;
+declare const descendants: (widget: Gtk.Widget) => Generator<Gtk.Widget>;
+declare const roots: (container: Container) => Generator<Gtk.Widget>;
+declare const traverse: (container: Container) => Generator<Gtk.Widget>;
+declare const findAll: (container: Container, isMatch: (node: Gtk.Widget) => boolean) => Gtk.Widget[];
+export { TOPLEVELS, descendants, roots, traverse, findAll, type Container };
 //# sourceMappingURL=traversal.d.ts.map

package/dist/traversal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC;AAErD,eAAO,MAAM,aAAa,GAAI,WAAW,SAAS,KAAG,SAAS,IAAI,GAAG,CAAC,WACK,CAAC;AAmB5E,eAAO,MAAM,QAAQ,GAAc,WAAW,SAAS,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAM7E,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,WAAW,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,OAAO,KAAG,GAAG,CAAC,MAAM,EASlG,CAAC"}
+{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC;AAC3G;;;;GAIG;AACH,KAAK,SAAS,GAAG,cAAc,GAAG,GAAG,CAAC,WAAW,GAAG,OAAO,SAAS,CAAC;AAErE,QAAA,MAAM,SAAS,EAAE,OAAO,MAAiC,CAAC;AAc1D,QAAA,MAAM,WAAW,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAIvE,CAAC;AAsBF,QAAA,MAAM,KAAK,GAAc,WAAW,SAAS,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAYnE,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAc,WAAW,SAAS,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAItE,CAAC;AAEF,QAAA,MAAM,OAAO,GAAI,WAAW,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,OAAO,KAAG,GAAG,CAAC,MAAM,EAUzF,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC"}

package/dist/traversal.js

@@ -1,5 +1,6 @@
-import * as Gtk from "@gtkx/ffi/gtk";
-export const isApplication = (container) => "getWindows" in container && typeof container.getWindows === "function";
+import * as Gtk from "@gtkx/gi/gtk";
+const TOPLEVELS = Symbol("gtkx.toplevels");
+const isApplication = (container) => container instanceof Gtk.Application;
 const traverseWidgetTree = function* (root) {
     yield root;
     let child = root.getFirstChild();
@@ -8,29 +9,49 @@ const traverseWidgetTree = function* (root) {
         child = child.getNextSibling();
     }
 };
-const traverseWindows = function* () {
-    const windows = Gtk.Window.listToplevels();
-    for (const window of windows) {
-        yield* traverseWidgetTree(window);
+const descendants = function* (widget) {
+    const tree = traverseWidgetTree(widget);
+    tree.next();
+    yield* tree;
+};
+const resolveRoot = (container) => {
+    if (container instanceof Gtk.Widget) {
+        return container;
+    }
+    if (container instanceof Gtk.EventController) {
+        return container.getWidget();
+    }
+    if (container instanceof Gtk.LayoutManager) {
+        return container.getWidget();
     }
+    if (container instanceof Gtk.ListItem || container instanceof Gtk.ListHeader) {
+        return container.getChild();
+    }
+    return null;
 };
-export const traverse = function* (container) {
-    if (isApplication(container)) {
-        yield* traverseWindows();
+const roots = function* (container) {
+    if (container === TOPLEVELS || isApplication(container)) {
+        yield* Gtk.Window.listToplevels();
+        return;
+    }
+    const root = resolveRoot(container);
+    if (root) {
+        yield root;
     }
-    else {
-        yield* traverseWidgetTree(container);
+};
+const traverse = function* (container) {
+    for (const root of roots(container)) {
+        yield* traverseWidgetTree(root);
     }
 };
-export const findAll = (container, predicate) => {
+const findAll = (container, isMatch) => {
     const results = [];
     for (const node of traverse(container)) {
-        if (node.getAccessibleRole?.() === Gtk.AccessibleRole.LABEL)
-            continue;
-        if (predicate(node)) {
+        if (isMatch(node)) {
             results.push(node);
         }
     }
     return results;
 };
+export { TOPLEVELS, descendants, roots, traverse, findAll };
 //# sourceMappingURL=traversal.js.map

package/dist/traversal.js.map

@@ -1 +1 @@
-{"version":3,"file":"traversal.js","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AAWrC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAoB,EAAgC,EAAE,CAChF,YAAY,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,CAAC;AAE5E,MAAM,kBAAkB,GAAG,QAAQ,CAAC,EAAE,IAAgB;IAClD,MAAM,IAAI,CAAC;IAEX,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACjC,OAAO,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;IACnC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,QAAQ,CAAC;IAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IAC3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,SAAoB;IACnD,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,CAAC,eAAe,EAAE,CAAC;IAC7B,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,SAAoB,EAAE,SAAwC,EAAgB,EAAE;IACpG,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,KAAK,GAAG,CAAC,cAAc,CAAC,KAAK;YAAE,SAAS;QACtE,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC"}
+{"version":3,"file":"traversal.js","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAUpC,MAAM,SAAS,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAE1D,MAAM,aAAa,GAAG,CAAC,SAAoB,EAAgC,EAAE,CAAC,SAAS,YAAY,GAAG,CAAC,WAAW,CAAC;AAEnH,MAAM,kBAAkB,GAAG,QAAQ,CAAC,EAAE,IAAgB;IAClD,MAAM,IAAI,CAAC;IACX,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IAEjC,OAAO,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;IACnC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,MAAkB;IAC7C,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;IACZ,KAAK,CAAC,CAAC,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,SAAyB,EAAqB,EAAE;IACjE,IAAI,SAAS,YAAY,GAAG,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,SAAS,YAAY,GAAG,CAAC,eAAe,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,SAAS,YAAY,GAAG,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,SAAS,YAAY,GAAG,CAAC,QAAQ,IAAI,SAAS,YAAY,GAAG,CAAC,UAAU,EAAE,CAAC;QAC3E,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,SAAoB;IACzC,IAAI,SAAS,KAAK,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAElC,OAAO;IACX,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAEpC,IAAI,IAAI,EAAE,CAAC;QACP,MAAM,IAAI,CAAC;IACf,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,SAAoB;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,SAAoB,EAAE,OAAsC,EAAgB,EAAE;IAC3F,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAkB,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\n\ntype QueryContainer = Gtk.Widget | Gtk.EventController | Gtk.LayoutManager | Gtk.ListItem | Gtk.ListHeader;\n/**\n * A scope that queries and traversal can run against: a widget, an event\n * controller, a layout manager, a list item or header, an application, or the\n * sentinel representing all current toplevel windows.\n */\ntype Container = QueryContainer | Gtk.Application | typeof TOPLEVELS;\n\nconst TOPLEVELS: unique symbol = Symbol(\"gtkx.toplevels\");\n\nconst isApplication = (container: Container): container is Gtk.Application => container instanceof Gtk.Application;\n\nconst traverseWidgetTree = function* (root: Gtk.Widget): Generator<Gtk.Widget> {\n    yield root;\n    let child = root.getFirstChild();\n\n    while (child) {\n        yield* traverseWidgetTree(child);\n        child = child.getNextSibling();\n    }\n};\n\nconst descendants = function* (widget: Gtk.Widget): Generator<Gtk.Widget> {\n    const tree = traverseWidgetTree(widget);\n    tree.next();\n    yield* tree;\n};\n\nconst resolveRoot = (container: QueryContainer): Gtk.Widget | null => {\n    if (container instanceof Gtk.Widget) {\n        return container;\n    }\n\n    if (container instanceof Gtk.EventController) {\n        return container.getWidget();\n    }\n\n    if (container instanceof Gtk.LayoutManager) {\n        return container.getWidget();\n    }\n\n    if (container instanceof Gtk.ListItem || container instanceof Gtk.ListHeader) {\n        return container.getChild();\n    }\n\n    return null;\n};\n\nconst roots = function* (container: Container): Generator<Gtk.Widget> {\n    if (container === TOPLEVELS || isApplication(container)) {\n        yield* Gtk.Window.listToplevels();\n\n        return;\n    }\n\n    const root = resolveRoot(container);\n\n    if (root) {\n        yield root;\n    }\n};\n\nconst traverse = function* (container: Container): Generator<Gtk.Widget> {\n    for (const root of roots(container)) {\n        yield* traverseWidgetTree(root);\n    }\n};\n\nconst findAll = (container: Container, isMatch: (node: Gtk.Widget) => boolean): Gtk.Widget[] => {\n    const results: Gtk.Widget[] = [];\n\n    for (const node of traverse(container)) {\n        if (isMatch(node)) {\n            results.push(node);\n        }\n    }\n\n    return results;\n};\n\nexport { TOPLEVELS, descendants, roots, traverse, findAll, type Container };\n"]}

package/dist/types.d.ts

@@ -1,200 +1,146 @@
-import type * as Gtk from "@gtkx/ffi/gtk";
-import type { ComponentType, ReactNode, Ref } from "react";
+import type * as Gtk from "@gtkx/gi/gtk";
+import type { RootElement } from "@gtkx/react";
+import type { ComponentType, ErrorInfo, ReactNode } from "react";
+import type { PrettyWidgetOptions } from "./pretty-widget.js";
 import type { Container } from "./traversal.js";
 /**
- * Custom function for matching text content.
- *
- * @param content - The normalized text content to match against
- * @param widget - The widget being tested
- * @returns `true` if the content matches
+ * A custom matcher predicate: given a candidate widget's normalized text content and the widget
+ * itself, returns whether it matches.
  */
-export type TextMatchFunction = (content: string, widget: Gtk.Widget) => boolean;
-/**
- * Text matching pattern.
- *
- * Can be a string for exact/substring matching, a RegExp for pattern matching,
- * or a custom function for advanced matching logic.
- */
-export type TextMatch = string | RegExp | TextMatchFunction;
-/**
- * Options for text normalization before matching.
- */
-export type NormalizerOptions = {
-    /** Remove leading/trailing whitespace (default: true) */
-    trim?: boolean;
-    /** Replace multiple whitespace characters with single space (default: true) */
-    collapseWhitespace?: boolean;
+type MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;
+/** A value used to match widget text: a string or number, a regular expression, or a custom {@link MatcherFunction}. */
+type Matcher = string | number | RegExp | MatcherFunction;
+/** Normalizes a widget's text before it is compared against a matcher. */
+type NormalizerFn = (text: string) => string;
+/** Options controlling the default text normalizer. */
+type NormalizerOptions = {
+    /** Trim leading and trailing whitespace. */
+    trim?: boolean | undefined;
+    /** Collapse runs of whitespace into a single space. */
+    collapseWhitespace?: boolean | undefined;
 };
-/**
- * Options for text-based queries.
- */
-export type TextMatchOptions = {
-    /** Require exact match vs substring match (default: true) */
-    exact?: boolean;
-    /** Custom text normalizer function */
-    normalizer?: (text: string) => string;
-    /** Remove leading/trailing whitespace (default: true) */
-    trim?: boolean;
-    /** Replace multiple whitespace with single space (default: true) */
-    collapseWhitespace?: boolean;
-    /** Timeout in milliseconds for async queries (default: 1000) */
-    timeout?: number;
+/** Options controlling how asynchronous queries and waits poll for a condition. */
+type WaitForOptions = {
+    /** Maximum time in milliseconds to keep retrying before failing. */
+    timeout?: number | undefined;
+    /** Delay in milliseconds between retries. */
+    interval?: number | undefined;
+    /** Transforms the error thrown when the timeout elapses. */
+    onTimeout?: ((error: Error) => Error) | undefined;
+    /** Error whose stack trace attributes the timeout failure to the calling code. */
+    stackTraceError?: Error | undefined;
 };
-/**
- * Options for role-based queries.
- *
- * Extends text matching options with accessible state filters.
- */
-export type ByRoleOptions = TextMatchOptions & {
-    /** Filter by accessible name/label */
-    name?: TextMatch;
-    /** Filter by checked state (checkboxes, radios, toggles) */
-    checked?: boolean;
-    /** Filter by pressed state */
-    pressed?: boolean;
-    /** Filter by selected state */
-    selected?: boolean;
-    /** Filter by expanded state (expanders) */
-    expanded?: boolean;
-    /** Filter by heading level */
-    level?: number;
+/** Options controlling text matching and, for asynchronous queries, polling behavior. */
+type MatcherOptions = {
+    /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */
+    exact?: boolean | undefined;
+    /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */
+    normalizer?: NormalizerFn | undefined;
+    /** Forwarded to the default normalizer when no custom `normalizer` is given. */
+    trim?: boolean | undefined;
+    /** Forwarded to the default normalizer when no custom `normalizer` is given. */
+    collapseWhitespace?: boolean | undefined;
+    /** Whether to include a suggested better query in error messages. */
+    suggest?: boolean | undefined;
+} & WaitForOptions;
+/** Constraints on a widget's numeric range value used by role queries. */
+type ByRoleValue = {
+    /** The current value. */
+    now?: number | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    /** Matcher for the value's textual representation. */
+    text?: Matcher | undefined;
 };
-/**
- * Options for {@link waitFor} and {@link waitForElementToBeRemoved}.
- */
-export type WaitForOptions = {
-    /** Maximum time to wait in milliseconds (default: 1000) */
-    timeout?: number;
-    /** Polling interval in milliseconds (default: 50) */
-    interval?: number;
-    /** Custom error handler called on timeout */
-    onTimeout?: (error: Error) => Error;
+/** Options for role queries: an accessible name matcher plus accessible state and value constraints. */
+type ByRoleOptions = MatcherOptions & {
+    name?: Matcher | undefined;
+    checked?: boolean | undefined;
+    pressed?: boolean | undefined;
+    selected?: boolean | undefined;
+    expanded?: boolean | undefined;
+    /** Heading or hierarchy level. */
+    level?: number | undefined;
+    busy?: boolean | undefined;
+    description?: Matcher | undefined;
+    value?: ByRoleValue | undefined;
+    /** When true, include widgets excluded from the accessibility tree. */
+    hidden?: boolean | undefined;
 };
-/**
- * A wrapper component that exposes its root GTK widget via `ref`.
- * Accept `ref` as a prop and pass it through to the root intrinsic element.
- */
-export type WrapperComponent = ComponentType<{
+/** A React component that wraps rendered content, receiving it as its children. */
+type WrapperComponent = ComponentType<{
     children: ReactNode;
-    ref?: Ref<Gtk.Widget>;
 }>;
-/**
- * Options for {@link render}.
- */
-export type RenderOptions = {
-    /**
-     * Wrapper component or boolean.
-     * - `true` (default): Wrap in GtkApplicationWindow
-     * - `false`: No wrapper
-     * - Component: Custom wrapper that passes `ref` to its root element
-     */
-    wrapper?: boolean | WrapperComponent;
-    /**
-     * The element queries are bound to.
-     * Defaults to the GTK Application (searches all toplevel windows).
-     * Provide a specific widget or application to scope queries.
-     */
-    baseElement?: Container;
+type Query = (container: Container, ...args: never[]) => unknown;
+type QueryMap = Record<string, Query>;
+type BoundQuery<Q extends Query> = Q extends (container: Container, ...args: infer A) => infer R ? (...args: A) => R : never;
+type BoundCustomQueries<Q extends QueryMap> = {
+    [K in keyof Q]: BoundQuery<Q[K]>;
 };
 /**
- * Query methods bound to a container.
- *
- * @see {@link screen} for global queries
- * @see {@link within} for scoped queries
+ * Options for {@link render}: the container and base element to mount into, an optional wrapper,
+ * React behavior toggles, error callbacks, and custom queries to bind.
  */
-export type BoundQueries = {
-    /** Query single element by accessible role (returns null if not found) */
-    queryByRole: (role: Gtk.AccessibleRole, options?: ByRoleOptions) => Gtk.Widget | null;
-    /** Query single element by label/text content (returns null if not found) */
-    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 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 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 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 widget name (waits and throws if none found) */
-    findAllByName: (name: TextMatch, options?: TextMatchOptions) => Promise<Gtk.Widget[]>;
+type RenderOptions<Q extends QueryMap = Record<never, never>> = {
+    container?: Gtk.Widget | RootElement | undefined;
+    /** Root of the subtree that bound queries search. */
+    baseElement?: Container | undefined;
+    wrapper?: WrapperComponent | undefined;
+    /** Render inside React StrictMode. */
+    reactStrictMode?: boolean | undefined;
+    /** Enable widget animations during the test. */
+    animations?: boolean | undefined;
+    /** Called for errors caught by React error boundaries. */
+    onCaughtError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;
+    /** Called for errors React recovered from automatically. */
+    onRecoverableError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;
+    /** Custom queries to bind to the rendered result. */
+    queries?: Q | undefined;
 };
-/**
- * Result returned by {@link render}.
- *
- * Provides query methods and utilities for testing rendered components.
- */
-export type RenderResult = BoundQueries & {
-    /** The direct container widget wrapping the rendered content */
-    container: Gtk.Widget;
-    /** The element queries are bound to (defaults to the GTK Application) */
-    baseElement: Container;
-    /** Unmount the rendered component */
-    unmount: () => Promise<void>;
-    /** Re-render with a new element */
-    rerender: (element: ReactNode) => Promise<void>;
-    /** Print the widget tree to console for debugging */
-    debug: () => void;
+type DebugUtilities = {
+    debug: (element?: Container | Container[], options?: PrettyWidgetOptions) => void;
+    logRoles: () => void;
+    screenshot: (selector?: WindowSelector, options?: ScreenshotOptions) => Promise<ScreenshotResult>;
 };
-/**
- * Result returned by {@link screenshot} and screen.screenshot.
- */
-export type ScreenshotResult = {
-    /** Base64-encoded PNG image data */
+/** A captured screenshot: base64-encoded image data, its MIME type, and pixel dimensions. */
+type ScreenshotResult = {
     data: string;
-    /** MIME type of the image (always "image/png") */
     mimeType: string;
-    /** Width of the captured image in pixels */
     width: number;
-    /** Height of the captured image in pixels */
     height: number;
 };
+/** Options for capturing a screenshot: the poll timeout and interval, plus a rendering scale factor. */
+type ScreenshotOptions = Pick<WaitForOptions, "timeout" | "interval"> & {
+    /** Device scale factor applied when rendering. */
+    scale?: number;
+};
 /**
- * Options for {@link renderHook}.
+ * Selects the window to screenshot by index, or by title (exact string or regular expression);
+ * undefined targets the default window.
  */
-export type RenderHookOptions<Props> = {
-    /**
-     * Initial props passed to the hook callback.
-     */
+type WindowSelector = number | string | RegExp | undefined;
+/**
+ * Options for {@link renderHook}: an optional wrapper and the initial props (required unless the
+ * props type permits undefined).
+ */
+type RenderHookOptions<Props> = {
+    wrapper?: WrapperComponent;
+} & (undefined extends Props ? {
     initialProps?: Props;
-    /**
-     * Wrapper component or boolean.
-     * - `true` (default): Wrap in GtkApplicationWindow
-     * - `false`: No wrapper
-     * - Component: Custom wrapper that passes `ref` to its root element
-     */
-    wrapper?: boolean | WrapperComponent;
-};
+} : {
+    initialProps: Props;
+});
 /**
- * Result returned by {@link renderHook}.
- *
- * Provides access to the hook result and utilities for re-rendering and cleanup.
+ * The result of {@link renderHook}: the latest hook return value plus functions to rerender with new
+ * props and to unmount.
  */
-export type RenderHookResult<Result, Props> = {
-    /** Object containing the current hook return value */
+type RenderHookResult<Result, Props> = {
+    /** Holds the most recent value returned by the hook under `current`. */
     result: {
         current: Result;
     };
-    /** Re-render the hook with optional new props */
     rerender: (newProps?: Props) => Promise<void>;
-    /** Unmount the component containing the hook */
     unmount: () => Promise<void>;
 };
+export { type MatcherFunction, type Matcher, type NormalizerFn, type NormalizerOptions, type WaitForOptions, type MatcherOptions, type ByRoleValue, type ByRoleOptions, type WrapperComponent, type QueryMap, type BoundCustomQueries, type RenderOptions, type DebugUtilities, type ScreenshotResult, type ScreenshotOptions, type WindowSelector, type RenderHookOptions, type RenderHookResult, };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkKA,OAAO,EAmBN,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { RootElement } from \"@gtkx/react\";\nimport type { ComponentType, ErrorInfo, ReactNode } from \"react\";\nimport type { PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport type { Container } from \"./traversal.js\";\n\n/**\n * A custom matcher predicate: given a candidate widget's normalized text content and the widget\n * itself, returns whether it matches.\n */\ntype MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;\n/** A value used to match widget text: a string or number, a regular expression, or a custom {@link MatcherFunction}. */\ntype Matcher = string | number | RegExp | MatcherFunction;\n/** Normalizes a widget's text before it is compared against a matcher. */\ntype NormalizerFn = (text: string) => string;\n\n/** Options controlling the default text normalizer. */\ntype NormalizerOptions = {\n    /** Trim leading and trailing whitespace. */\n    trim?: boolean | undefined;\n    /** Collapse runs of whitespace into a single space. */\n    collapseWhitespace?: boolean | undefined;\n};\n\n/** Options controlling how asynchronous queries and waits poll for a condition. */\ntype WaitForOptions = {\n    /** Maximum time in milliseconds to keep retrying before failing. */\n    timeout?: number | undefined;\n    /** Delay in milliseconds between retries. */\n    interval?: number | undefined;\n    /** Transforms the error thrown when the timeout elapses. */\n    onTimeout?: ((error: Error) => Error) | undefined;\n    /** Error whose stack trace attributes the timeout failure to the calling code. */\n    stackTraceError?: Error | undefined;\n};\n\n/** Options controlling text matching and, for asynchronous queries, polling behavior. */\ntype MatcherOptions = {\n    /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */\n    exact?: boolean | undefined;\n    /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */\n    normalizer?: NormalizerFn | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    trim?: boolean | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    collapseWhitespace?: boolean | undefined;\n    /** Whether to include a suggested better query in error messages. */\n    suggest?: boolean | undefined;\n} & WaitForOptions;\n\n/** Constraints on a widget's numeric range value used by role queries. */\ntype ByRoleValue = {\n    /** The current value. */\n    now?: number | undefined;\n    min?: number | undefined;\n    max?: number | undefined;\n    /** Matcher for the value's textual representation. */\n    text?: Matcher | undefined;\n};\n\n/** Options for role queries: an accessible name matcher plus accessible state and value constraints. */\ntype ByRoleOptions = MatcherOptions & {\n    name?: Matcher | undefined;\n    checked?: boolean | undefined;\n    pressed?: boolean | undefined;\n    selected?: boolean | undefined;\n    expanded?: boolean | undefined;\n    /** Heading or hierarchy level. */\n    level?: number | undefined;\n    busy?: boolean | undefined;\n    description?: Matcher | undefined;\n    value?: ByRoleValue | undefined;\n    /** When true, include widgets excluded from the accessibility tree. */\n    hidden?: boolean | undefined;\n};\n\n/** A React component that wraps rendered content, receiving it as its children. */\ntype WrapperComponent = ComponentType<{\n    children: ReactNode;\n}>;\n\ntype Query = (container: Container, ...args: never[]) => unknown;\ntype QueryMap = Record<string, Query>;\n\ntype BoundQuery<Q extends Query> = Q extends (container: Container, ...args: infer A) => infer R\n    ? (...args: A) => R\n    : never;\n\ntype BoundCustomQueries<Q extends QueryMap> = { [K in keyof Q]: BoundQuery<Q[K]> };\n\n/**\n * Options for {@link render}: the container and base element to mount into, an optional wrapper,\n * React behavior toggles, error callbacks, and custom queries to bind.\n */\ntype RenderOptions<Q extends QueryMap = Record<never, never>> = {\n    container?: Gtk.Widget | RootElement | undefined;\n    /** Root of the subtree that bound queries search. */\n    baseElement?: Container | undefined;\n    wrapper?: WrapperComponent | undefined;\n    /** Render inside React StrictMode. */\n    reactStrictMode?: boolean | undefined;\n    /** Enable widget animations during the test. */\n    animations?: boolean | undefined;\n    /** Called for errors caught by React error boundaries. */\n    onCaughtError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Called for errors React recovered from automatically. */\n    onRecoverableError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Custom queries to bind to the rendered result. */\n    queries?: Q | undefined;\n};\n\ntype DebugUtilities = {\n    debug: (element?: Container | Container[], options?: PrettyWidgetOptions) => void;\n    logRoles: () => void;\n    screenshot: (selector?: WindowSelector, options?: ScreenshotOptions) => Promise<ScreenshotResult>;\n};\n\n/** A captured screenshot: base64-encoded image data, its MIME type, and pixel dimensions. */\ntype ScreenshotResult = {\n    data: string;\n    mimeType: string;\n    width: number;\n    height: number;\n};\n\n/** Options for capturing a screenshot: the poll timeout and interval, plus a rendering scale factor. */\ntype ScreenshotOptions = Pick<WaitForOptions, \"timeout\" | \"interval\"> & {\n    /** Device scale factor applied when rendering. */\n    scale?: number;\n};\n\n/**\n * Selects the window to screenshot by index, or by title (exact string or regular expression);\n * undefined targets the default window.\n */\ntype WindowSelector = number | string | RegExp | undefined;\n\n/**\n * Options for {@link renderHook}: an optional wrapper and the initial props (required unless the\n * props type permits undefined).\n */\ntype RenderHookOptions<Props> = {\n    wrapper?: WrapperComponent;\n} & (undefined extends Props\n    ? {\n            initialProps?: Props;\n        }\n    : {\n            initialProps: Props;\n        });\n\n/**\n * The result of {@link renderHook}: the latest hook return value plus functions to rerender with new\n * props and to unmount.\n */\ntype RenderHookResult<Result, Props> = {\n    /** Holds the most recent value returned by the hook under `current`. */\n    result: { current: Result };\n    rerender: (newProps?: Props) => Promise<void>;\n    unmount: () => Promise<void>;\n};\n\nexport {\n    type MatcherFunction,\n    type Matcher,\n    type NormalizerFn,\n    type NormalizerOptions,\n    type WaitForOptions,\n    type MatcherOptions,\n    type ByRoleValue,\n    type ByRoleOptions,\n    type WrapperComponent,\n    type QueryMap,\n    type BoundCustomQueries,\n    type RenderOptions,\n    type DebugUtilities,\n    type ScreenshotResult,\n    type ScreenshotOptions,\n    type WindowSelector,\n    type RenderHookOptions,\n    type RenderHookResult,\n};\n"]}

package/dist/user-event/adjustment.d.ts

@@ -0,0 +1,10 @@
+import * as Gtk from "@gtkx/gi/gtk";
+/** A scroll distance in pixels along each axis. */
+type ScrollDelta = {
+    x?: number;
+    y?: number;
+};
+declare const slide: (widget: Gtk.Widget, value: number) => Promise<void>;
+declare const scroll: (widget: Gtk.Widget, delta: ScrollDelta) => Promise<void>;
+export { slide, scroll, type ScrollDelta };
+//# sourceMappingURL=adjustment.d.ts.map

package/dist/user-event/adjustment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjustment.d.ts","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,mDAAmD;AACnD,KAAK,WAAW,GAAG;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CASzD,CAAC;AAwBP,QAAA,MAAM,MAAM,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,IAAI,CAY/D,CAAC;AAEP,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/user-event/adjustment.js

@@ -0,0 +1,35 @@
+import * as Gtk from "@gtkx/gi/gtk";
+import { wrapEvent } from "./event-wrapper.js";
+const slide = (widget, value) => wrapEvent(widget, () => {
+    if (!(widget instanceof Gtk.Range)) {
+        throw new TypeError(`userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`);
+    }
+    widget.emit("change-value", Gtk.ScrollType.JUMP, value);
+});
+const resolveScrollAdjustments = (widget) => {
+    for (let current = widget; current; current = current.getParent()) {
+        if (current instanceof Gtk.ScrolledWindow) {
+            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };
+        }
+        if (current instanceof Gtk.Scrollable) {
+            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };
+        }
+    }
+    return null;
+};
+const applyScrollDelta = (adjustment, delta) => {
+    if (!adjustment || delta === 0) {
+        return;
+    }
+    adjustment.setValue(adjustment.getValue() + delta);
+};
+const scroll = (widget, delta) => wrapEvent(widget, () => {
+    const adjustments = resolveScrollAdjustments(widget);
+    if (!adjustments) {
+        throw new Error("userEvent.scroll: no Gtk.ScrolledWindow or Gtk.Scrollable found on the widget or its ancestors");
+    }
+    applyScrollDelta(adjustments.horizontal, delta.x ?? 0);
+    applyScrollDelta(adjustments.vertical, delta.y ?? 0);
+});
+export { slide, scroll };
+//# sourceMappingURL=adjustment.js.map

package/dist/user-event/adjustment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjustment.js","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAa/C,MAAM,KAAK,GAAG,CAAC,MAAkB,EAAE,KAAa,EAAiB,EAAE,CAC/D,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CACf,8DAA8D,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAC1F,CAAC;IACN,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEP,MAAM,wBAAwB,GAAG,CAAC,MAAkB,EAA4B,EAAE;IAC9E,KAAK,IAAI,OAAO,GAAsB,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACnF,IAAI,OAAO,YAAY,GAAG,CAAC,cAAc,EAAE,CAAC;YACxC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACxF,CAAC;QAED,IAAI,OAAO,YAAY,GAAG,CAAC,UAAU,EAAE,CAAC;YACpC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACxF,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,UAAiC,EAAE,KAAa,EAAQ,EAAE;IAChF,IAAI,CAAC,UAAU,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;IACX,CAAC;IAED,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,KAAkB,EAAiB,EAAE,CACrE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAErD,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACX,gGAAgG,CACnG,CAAC;IACN,CAAC;IAED,gBAAgB,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,gBAAgB,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEP,OAAO,EAAE,KAAK,EAAE,MAAM,EAAoB,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** A scroll distance in pixels along each axis. */\ntype ScrollDelta = {\n    x?: number;\n    y?: number;\n};\n\ntype ScrollAdjustments = {\n    horizontal: Gtk.Adjustment | null;\n    vertical: Gtk.Adjustment | null;\n};\n\nconst slide = (widget: Gtk.Widget, value: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        if (!(widget instanceof Gtk.Range)) {\n            throw new TypeError(\n                `userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`,\n            );\n        }\n\n        widget.emit(\"change-value\", Gtk.ScrollType.JUMP, value);\n    });\n\nconst resolveScrollAdjustments = (widget: Gtk.Widget): ScrollAdjustments | null => {\n    for (let current: Gtk.Widget | null = widget; current; current = current.getParent()) {\n        if (current instanceof Gtk.ScrolledWindow) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n\n        if (current instanceof Gtk.Scrollable) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n    }\n\n    return null;\n};\n\nconst applyScrollDelta = (adjustment: Gtk.Adjustment | null, delta: number): void => {\n    if (!adjustment || delta === 0) {\n        return;\n    }\n\n    adjustment.setValue(adjustment.getValue() + delta);\n};\n\nconst scroll = (widget: Gtk.Widget, delta: ScrollDelta): Promise<void> =>\n    wrapEvent(widget, () => {\n        const adjustments = resolveScrollAdjustments(widget);\n\n        if (!adjustments) {\n            throw new Error(\n                \"userEvent.scroll: no Gtk.ScrolledWindow or Gtk.Scrollable found on the widget or its ancestors\",\n            );\n        }\n\n        applyScrollDelta(adjustments.horizontal, delta.x ?? 0);\n        applyScrollDelta(adjustments.vertical, delta.y ?? 0);\n    });\n\nexport { slide, scroll, type ScrollDelta };\n"]}

package/dist/user-event/click.d.ts

@@ -0,0 +1,8 @@
+import * as Gtk from "@gtkx/gi/gtk";
+declare const emitPress: (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number) => void;
+declare const emitRelease: (widget: Gtk.Widget, controllers: Gtk.GestureClick[], nPress: number) => void;
+declare const click: (widget: Gtk.Widget) => Promise<void>;
+declare const dblClick: (widget: Gtk.Widget) => Promise<void>;
+declare const tripleClick: (widget: Gtk.Widget) => Promise<void>;
+export { emitPress, emitRelease, click, dblClick, tripleClick };
+//# sourceMappingURL=click.d.ts.map

package/dist/user-event/click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAuBpC,QAAA,MAAM,SAAS,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,YAAY,EAAE,EAAE,QAAQ,MAAM,KAAG,IAExF,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,YAAY,EAAE,EAAE,QAAQ,MAAM,KAAG,IAE1F,CAAC;AAwCF,QAAA,MAAM,KAAK,GAAU,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAwBrD,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAyC,CAAC;AAC7F,QAAA,MAAM,WAAW,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAyC,CAAC;AAEhG,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}