@gtkx/testing 0.20.0 → 1.0.0-rc.1

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;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACjB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,KAAK,CAAC;IAElE;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAcF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,QAAO,QAAQ,CAAC,MAAM,CAE3C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,KAAG,IAG/F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAO,IAE9B,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,MAAM,MAAM,MAAM,GAAG;IACjB,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,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAiBnE;;GAEG;AACH,eAAO,MAAM,SAAS,QAAO,MAE5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,cAAe,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,KAAG,IAGjE,CAAC"}

package/dist/config.js

@@ -1,60 +1,29 @@
 const defaultGetElementError = (message, _container) => {
-    return new Error(message);
+    const error = new Error(message);
+    error.name = "GtkxElementError";
+    return error;
 };
 const defaultConfig = {
-    showSuggestions: true,
+    throwSuggestions: false,
     getElementError: defaultGetElementError,
     asyncUtilTimeout: 1000,
+    actionabilityTimeout: 500,
 };
 let currentConfig = { ...defaultConfig };
 /**
- * Returns the current testing library configuration.
- *
- * @returns The current configuration object
- *
- * @example
- * ```tsx
- * import { getConfig } from "@gtkx/testing";
- *
- * const config = getConfig();
- * console.log(config.showSuggestions);
- * ```
+ * Returns the current global testing configuration.
  */
 export const getConfig = () => {
     return currentConfig;
 };
 /**
- * Configures the testing library behavior.
- *
- * Accepts either a partial configuration object or a function that receives
- * the current configuration and returns updates.
- *
- * @param newConfig - Partial configuration or updater function
- *
- * @example
- * ```tsx
- * import { configure } from "@gtkx/testing";
+ * Merges the given overrides into the global testing configuration.
  *
- * // Disable role suggestions
- * configure({ showSuggestions: false });
- *
- * // Use updater function
- * configure((current) => ({
- *   showSuggestions: !current.showSuggestions,
- * }));
- * ```
+ * @param newConfig Either a partial config object or a function that receives
+ * the current config and returns the fields to override.
  */
 export const configure = (newConfig) => {
     const updates = typeof newConfig === "function" ? newConfig(currentConfig) : newConfig;
     currentConfig = { ...currentConfig, ...updates };
 };
-/**
- * Resets configuration to defaults.
- * Primarily used for testing.
- *
- * @internal
- */
-export const resetConfig = () => {
-    currentConfig = { ...defaultConfig };
-};
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAyBA,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAE,UAAqB,EAAS,EAAE;IAC7E,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,aAAa,GAAW;IAC1B,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,sBAAsB;IACvC,gBAAgB,EAAE,IAAI;CACzB,CAAC;AAEF,IAAI,aAAa,GAAW,EAAE,GAAG,aAAa,EAAE,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAqB,EAAE;IAC5C,OAAO,aAAa,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAmE,EAAQ,EAAE;IACnG,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;AACrD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAS,EAAE;IAClC,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC;AACzC,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA0BA,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAE,UAAsB,EAAS,EAAE;IAC9E,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAW;IAC1B,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,sBAAsB;IACvC,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,GAAG;CAC5B,CAAC;AAEF,IAAI,aAAa,GAAW,EAAE,GAAG,aAAa,EAAE,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAW,EAAE;IAClC,OAAO,aAAa,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAqC,EAAQ,EAAE;IACrE,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;AACrD,CAAC,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 */\nexport type Config = {\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 for waiting on a widget to become actionable. */\n    actionabilityTimeout: number;\n};\n\n/**\n * Function form of a configuration update: receives the current config and\n * returns the fields to override.\n */\nexport type ConfigFn = (existingConfig: Config) => Partial<Config>;\n\nconst defaultGetElementError = (message: string, _container?: Container): Error => {\n    const error = new Error(message);\n    error.name = \"GtkxElementError\";\n    return error;\n};\n\nconst defaultConfig: Config = {\n    throwSuggestions: false,\n    getElementError: defaultGetElementError,\n    asyncUtilTimeout: 1000,\n    actionabilityTimeout: 500,\n};\n\nlet currentConfig: Config = { ...defaultConfig };\n\n/**\n * Returns the current global testing configuration.\n */\nexport const 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 */\nexport const configure = (newConfig: Partial<Config> | ConfigFn): void => {\n    const updates = typeof newConfig === \"function\" ? newConfig(currentConfig) : newConfig;\n    currentConfig = { ...currentConfig, ...updates };\n};\n"]}

package/dist/editable.d.ts

@@ -0,0 +1,7 @@
+import * as Gtk from "@gtkx/gi/gtk";
+export type EditableTarget = Gtk.Editable | Gtk.TextView;
+export declare const EDITABLE_ROLES: Set<Gtk.AccessibleRole>;
+export declare const isEditable: (widget: unknown) => widget is EditableTarget;
+export declare const getEditableDelegate: (widget: Gtk.Widget) => Gtk.Widget | null;
+export declare const readEditableText: (widget: EditableTarget) => string;
+//# sourceMappingURL=editable.d.ts.map

package/dist/editable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable.d.ts","sourceRoot":"","sources":["../src/editable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,CAIjD,CAAC;AAEH,eAAO,MAAM,UAAU,WAAY,OAAO,KAAG,MAAM,IAAI,cACa,CAAC;AAErE,eAAO,MAAM,mBAAmB,WAAY,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,MAAM,GAAG,IAGrE,CAAC;AAQF,eAAO,MAAM,gBAAgB,WAAY,cAAc,KAAG,MAKzD,CAAC"}

package/dist/editable.js

@@ -0,0 +1,24 @@
+import * as Gtk from "@gtkx/gi/gtk";
+export const EDITABLE_ROLES = new Set([
+    Gtk.AccessibleRole.TEXT_BOX,
+    Gtk.AccessibleRole.SEARCH_BOX,
+    Gtk.AccessibleRole.SPIN_BUTTON,
+]);
+export const isEditable = (widget) => widget instanceof Gtk.Editable || widget instanceof Gtk.TextView;
+export const getEditableDelegate = (widget) => {
+    if (!(widget instanceof Gtk.Editable))
+        return null;
+    return widget.getDelegate();
+};
+const readTextViewBufferText = (widget) => {
+    const buffer = widget.getBuffer();
+    const [start, end] = buffer.getBounds();
+    return buffer.getText(start, end, true);
+};
+export const readEditableText = (widget) => {
+    if (widget instanceof Gtk.TextView) {
+        return readTextViewBufferText(widget);
+    }
+    return widget.getText();
+};
+//# sourceMappingURL=editable.js.map

package/dist/editable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable.js","sourceRoot":"","sources":["../src/editable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAIpC,MAAM,CAAC,MAAM,cAAc,GAA4B,IAAI,GAAG,CAAqB;IAC/E,GAAG,CAAC,cAAc,CAAC,QAAQ;IAC3B,GAAG,CAAC,cAAc,CAAC,UAAU;IAC7B,GAAG,CAAC,cAAc,CAAC,WAAW;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAe,EAA4B,EAAE,CACpE,MAAM,YAAY,GAAG,CAAC,QAAQ,IAAI,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAkB,EAAqB,EAAE;IACzE,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,MAAoB,EAAU,EAAE;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAsB,EAAU,EAAE;IAC/D,IAAI,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjC,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\n\nexport type EditableTarget = Gtk.Editable | Gtk.TextView;\n\nexport const EDITABLE_ROLES: Set<Gtk.AccessibleRole> = new Set<Gtk.AccessibleRole>([\n    Gtk.AccessibleRole.TEXT_BOX,\n    Gtk.AccessibleRole.SEARCH_BOX,\n    Gtk.AccessibleRole.SPIN_BUTTON,\n]);\n\nexport const isEditable = (widget: unknown): widget is EditableTarget =>\n    widget instanceof Gtk.Editable || widget instanceof Gtk.TextView;\n\nexport const getEditableDelegate = (widget: Gtk.Widget): Gtk.Widget | null => {\n    if (!(widget instanceof Gtk.Editable)) return null;\n    return widget.getDelegate();\n};\n\nconst readTextViewBufferText = (widget: Gtk.TextView): string => {\n    const buffer = widget.getBuffer();\n    const [start, end] = buffer.getBounds();\n    return buffer.getText(start, end, true);\n};\n\nexport const readEditableText = (widget: EditableTarget): string => {\n    if (widget instanceof Gtk.TextView) {\n        return readTextViewBufferText(widget);\n    }\n    return widget.getText();\n};\n"]}

package/dist/errors.d.ts

@@ -0,0 +1,29 @@
+import type * as Gtk from "@gtkx/gi/gtk";
+import type { Container } from "./traversal.js";
+import type { ByRoleOptions, Matcher } from "./types.js";
+export type QueryDescriptor = {
+    queryType: "role";
+    role: Gtk.AccessibleRole;
+    options?: ByRoleOptions | undefined;
+} | {
+    queryType: "text";
+    text: Matcher;
+} | {
+    queryType: "labelText";
+    text: Matcher;
+} | {
+    queryType: "name";
+    name: Matcher;
+} | {
+    queryType: "placeholderText";
+    text: Matcher;
+} | {
+    queryType: "displayValue";
+    value: Matcher;
+};
+export declare const runWithExpensiveErrorDiagnosticsDisabled: <T>(callback: () => T) => T;
+export declare const notFoundError: (container: Container, descriptor: QueryDescriptor) => Error;
+export declare const multipleFoundError: (container: Container, descriptor: QueryDescriptor, matches: Gtk.Widget[]) => Error;
+export declare const suggestionError: (suggestion: string, container: Container) => Error;
+export declare const timeoutError: (timeout: number, lastError: Error | null) => Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAIzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAe,OAAO,EAAE,MAAM,YAAY,CAAC;AAoCtE,MAAM,MAAM,eAAe,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,cAAc,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,GACpF;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACpC;IAAE,SAAS,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACzC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACpC;IAAE,SAAS,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC/C;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAqBpD,eAAO,MAAM,wCAAwC,GAAI,CAAC,YAAY,MAAM,CAAC,KAAG,CAQ/E,CAAC;AAUF,eAAO,MAAM,aAAa,cAAe,SAAS,cAAc,eAAe,KAAG,KASjF,CAAC;AAUF,eAAO,MAAM,kBAAkB,cAAe,SAAS,cAAc,eAAe,WAAW,GAAG,CAAC,MAAM,EAAE,KAAG,KAY7G,CAAC;AAEF,eAAO,MAAM,eAAe,eAAgB,MAAM,aAAa,SAAS,KAAG,KAI1E,CAAC;AAEF,eAAO,MAAM,YAAY,YAAa,MAAM,aAAa,KAAK,GAAG,IAAI,KAAG,KAIvE,CAAC"}

package/dist/errors.js

@@ -0,0 +1,119 @@
+import { getConfig } from "./config.js";
+import { prettyWidget } from "./pretty-widget.js";
+import { formatRole, prettyRoles } from "./role-helpers.js";
+const formatTextMatcher = (text) => {
+    if (typeof text === "function") {
+        return "custom function";
+    }
+    if (text instanceof RegExp) {
+        return text.toString();
+    }
+    return `'${text}'`;
+};
+const formatByRoleValue = (value) => {
+    const parts = [];
+    if (value.now !== undefined)
+        parts.push(`now=${value.now}`);
+    if (value.min !== undefined)
+        parts.push(`min=${value.min}`);
+    if (value.max !== undefined)
+        parts.push(`max=${value.max}`);
+    if (value.text !== undefined)
+        parts.push(`text ${formatTextMatcher(value.text)}`);
+    return parts.join(", ");
+};
+const formatByRoleDescription = (role, options) => {
+    const parts = [`role '${formatRole(role).toUpperCase()}'`];
+    if (options?.name)
+        parts.push(`name ${formatTextMatcher(options.name)}`);
+    if (options?.checked !== undefined)
+        parts.push(`checked=${options.checked}`);
+    if (options?.pressed !== undefined)
+        parts.push(`pressed=${options.pressed}`);
+    if (options?.selected !== undefined)
+        parts.push(`selected=${options.selected}`);
+    if (options?.expanded !== undefined)
+        parts.push(`expanded=${options.expanded}`);
+    if (options?.level !== undefined)
+        parts.push(`level=${options.level}`);
+    if (options?.busy !== undefined)
+        parts.push(`busy=${options.busy}`);
+    if (options?.description)
+        parts.push(`description ${formatTextMatcher(options.description)}`);
+    if (options?.value)
+        parts.push(`value ${formatByRoleValue(options.value)}`);
+    if (options?.hidden !== undefined)
+        parts.push(`hidden=${options.hidden}`);
+    return parts.join(" and ");
+};
+const formatQueryDescription = (descriptor) => {
+    switch (descriptor.queryType) {
+        case "role":
+            return formatByRoleDescription(descriptor.role, descriptor.options);
+        case "text":
+            return `text ${formatTextMatcher(descriptor.text)}`;
+        case "labelText":
+            return `label text ${formatTextMatcher(descriptor.text)}`;
+        case "name":
+            return `name ${formatTextMatcher(descriptor.name)}`;
+        case "placeholderText":
+            return `placeholder text ${formatTextMatcher(descriptor.text)}`;
+        case "displayValue":
+            return `display value ${formatTextMatcher(descriptor.value)}`;
+    }
+};
+let expensiveErrorDiagnosticsDisabled = false;
+export const runWithExpensiveErrorDiagnosticsDisabled = (callback) => {
+    const previous = expensiveErrorDiagnosticsDisabled;
+    expensiveErrorDiagnosticsDisabled = true;
+    try {
+        return callback();
+    }
+    finally {
+        expensiveErrorDiagnosticsDisabled = previous;
+    }
+};
+const buildElementError = (container, headLines) => {
+    const config = getConfig();
+    const lines = expensiveErrorDiagnosticsDisabled
+        ? headLines
+        : [...headLines, "", prettyWidget(container, { highlight: false })];
+    return config.getElementError(lines.join("\n"), container);
+};
+export const notFoundError = (container, descriptor) => {
+    const description = formatQueryDescription(descriptor);
+    const headLines = [`Unable to find an element with ${description}`];
+    if (!expensiveErrorDiagnosticsDisabled && descriptor.queryType === "role") {
+        headLines.push("", "Here are the accessible roles:", "", prettyRoles(container));
+    }
+    return buildElementError(container, headLines);
+};
+const allByVariantHint = (descriptor) => {
+    const variant = descriptor.queryType === "role" ? "getAllByRole" : "getAllBy*";
+    return ("(If this is intentional, use the *AllBy* variant of the query, " +
+        `e.g. queryAllBy*/getAllBy*/findAllBy*, such as ${variant}.)`);
+};
+export const multipleFoundError = (container, descriptor, matches) => {
+    const description = formatQueryDescription(descriptor);
+    const headLines = [
+        `Found ${matches.length} elements with ${description}, but expected only one`,
+        "",
+        allByVariantHint(descriptor),
+    ];
+    if (!expensiveErrorDiagnosticsDisabled) {
+        const renderedMatches = matches.map((widget) => prettyWidget(widget, { highlight: false }));
+        headLines.push("", "Here are the matching elements:", "", ...renderedMatches);
+    }
+    return buildElementError(container, headLines);
+};
+export const suggestionError = (suggestion, container) => {
+    const config = getConfig();
+    const message = `A better query is available, try this:\n${suggestion}\n`;
+    return config.getElementError(message, container);
+};
+export const timeoutError = (timeout, lastError) => {
+    const baseMessage = `Timed out after ${timeout}ms`;
+    const message = lastError ? `${baseMessage}.\n\n${lastError.message}` : baseMessage;
+    return getConfig().getElementError(message);
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { getConfig } from \"./config.js\";\nimport { prettyWidget } from \"./pretty-widget.js\";\nimport { formatRole, prettyRoles } from \"./role-helpers.js\";\nimport type { Container } from \"./traversal.js\";\nimport type { ByRoleOptions, ByRoleValue, Matcher } from \"./types.js\";\n\nconst formatTextMatcher = (text: Matcher): string => {\n    if (typeof text === \"function\") {\n        return \"custom function\";\n    }\n    if (text instanceof RegExp) {\n        return text.toString();\n    }\n    return `'${text}'`;\n};\n\nconst formatByRoleValue = (value: ByRoleValue): string => {\n    const parts: string[] = [];\n    if (value.now !== undefined) parts.push(`now=${value.now}`);\n    if (value.min !== undefined) parts.push(`min=${value.min}`);\n    if (value.max !== undefined) parts.push(`max=${value.max}`);\n    if (value.text !== undefined) parts.push(`text ${formatTextMatcher(value.text)}`);\n    return parts.join(\", \");\n};\n\nconst formatByRoleDescription = (role: Gtk.AccessibleRole, options?: ByRoleOptions): string => {\n    const parts = [`role '${formatRole(role).toUpperCase()}'`];\n    if (options?.name) parts.push(`name ${formatTextMatcher(options.name)}`);\n    if (options?.checked !== undefined) parts.push(`checked=${options.checked}`);\n    if (options?.pressed !== undefined) parts.push(`pressed=${options.pressed}`);\n    if (options?.selected !== undefined) parts.push(`selected=${options.selected}`);\n    if (options?.expanded !== undefined) parts.push(`expanded=${options.expanded}`);\n    if (options?.level !== undefined) parts.push(`level=${options.level}`);\n    if (options?.busy !== undefined) parts.push(`busy=${options.busy}`);\n    if (options?.description) parts.push(`description ${formatTextMatcher(options.description)}`);\n    if (options?.value) parts.push(`value ${formatByRoleValue(options.value)}`);\n    if (options?.hidden !== undefined) parts.push(`hidden=${options.hidden}`);\n    return parts.join(\" and \");\n};\n\nexport type QueryDescriptor =\n    | { queryType: \"role\"; role: Gtk.AccessibleRole; options?: ByRoleOptions | undefined }\n    | { queryType: \"text\"; text: Matcher }\n    | { queryType: \"labelText\"; text: Matcher }\n    | { queryType: \"name\"; name: Matcher }\n    | { queryType: \"placeholderText\"; text: Matcher }\n    | { queryType: \"displayValue\"; value: Matcher };\n\nconst formatQueryDescription = (descriptor: QueryDescriptor): string => {\n    switch (descriptor.queryType) {\n        case \"role\":\n            return formatByRoleDescription(descriptor.role, descriptor.options);\n        case \"text\":\n            return `text ${formatTextMatcher(descriptor.text)}`;\n        case \"labelText\":\n            return `label text ${formatTextMatcher(descriptor.text)}`;\n        case \"name\":\n            return `name ${formatTextMatcher(descriptor.name)}`;\n        case \"placeholderText\":\n            return `placeholder text ${formatTextMatcher(descriptor.text)}`;\n        case \"displayValue\":\n            return `display value ${formatTextMatcher(descriptor.value)}`;\n    }\n};\n\nlet expensiveErrorDiagnosticsDisabled = false;\n\nexport const runWithExpensiveErrorDiagnosticsDisabled = <T>(callback: () => T): T => {\n    const previous = expensiveErrorDiagnosticsDisabled;\n    expensiveErrorDiagnosticsDisabled = true;\n    try {\n        return callback();\n    } finally {\n        expensiveErrorDiagnosticsDisabled = previous;\n    }\n};\n\nconst buildElementError = (container: Container, headLines: string[]): Error => {\n    const config = getConfig();\n    const lines = expensiveErrorDiagnosticsDisabled\n        ? headLines\n        : [...headLines, \"\", prettyWidget(container, { highlight: false })];\n    return config.getElementError(lines.join(\"\\n\"), container);\n};\n\nexport const notFoundError = (container: Container, descriptor: QueryDescriptor): Error => {\n    const description = formatQueryDescription(descriptor);\n    const headLines = [`Unable to find an element with ${description}`];\n\n    if (!expensiveErrorDiagnosticsDisabled && descriptor.queryType === \"role\") {\n        headLines.push(\"\", \"Here are the accessible roles:\", \"\", prettyRoles(container));\n    }\n\n    return buildElementError(container, headLines);\n};\n\nconst allByVariantHint = (descriptor: QueryDescriptor): string => {\n    const variant = descriptor.queryType === \"role\" ? \"getAllByRole\" : \"getAllBy*\";\n    return (\n        \"(If this is intentional, use the *AllBy* variant of the query, \" +\n        `e.g. queryAllBy*/getAllBy*/findAllBy*, such as ${variant}.)`\n    );\n};\n\nexport const multipleFoundError = (container: Container, descriptor: QueryDescriptor, matches: Gtk.Widget[]): Error => {\n    const description = formatQueryDescription(descriptor);\n    const headLines = [\n        `Found ${matches.length} elements with ${description}, but expected only one`,\n        \"\",\n        allByVariantHint(descriptor),\n    ];\n    if (!expensiveErrorDiagnosticsDisabled) {\n        const renderedMatches = matches.map((widget) => prettyWidget(widget, { highlight: false }));\n        headLines.push(\"\", \"Here are the matching elements:\", \"\", ...renderedMatches);\n    }\n    return buildElementError(container, headLines);\n};\n\nexport const suggestionError = (suggestion: string, container: Container): Error => {\n    const config = getConfig();\n    const message = `A better query is available, try this:\\n${suggestion}\\n`;\n    return config.getElementError(message, container);\n};\n\nexport const timeoutError = (timeout: number, lastError: Error | null): Error => {\n    const baseMessage = `Timed out after ${timeout}ms`;\n    const message = lastError ? `${baseMessage}.\\n\\n${lastError.message}` : baseMessage;\n    return getConfig().getElementError(message);\n};\n"]}

package/dist/fire-event.d.ts

@@ -1,29 +1,11 @@
-import { Value } from "@gtkx/ffi/gobject";
-import type * as Gtk from "@gtkx/ffi/gtk";
+import type * as GObject from "@gtkx/gi/gobject";
 /**
- * Emits a GTK signal on a widget or event controller.
+ * Emits a GObject signal on a widget or object inside React's act environment,
+ * so any resulting state updates are flushed before the promise resolves.
  *
- * Low-level utility for triggering signals directly. Prefer {@link userEvent}
- * for common interactions like clicking and typing.
- *
- * @param element - The widget or event controller to emit the signal on
- * @param signalName - GTK signal name (e.g., "clicked", "activate", "drag-begin")
- * @param args - Additional signal arguments as GValues
- *
- * @example
- * ```tsx
- * import { fireEvent } from "@gtkx/testing";
- * import { Value } from "@gtkx/ffi/gobject";
- *
- * // Emit signal on widget
- * await fireEvent(widget, "clicked");
- *
- * // Emit signal on gesture controller
- * const gesture = widget.observeControllers().getObject(0) as Gtk.GestureDrag;
- * await fireEvent(gesture, "drag-begin", Value.newFromDouble(100), Value.newFromDouble(100));
- * ```
- *
- * @see {@link userEvent} for high-level user interactions
+ * @param element The GObject instance to emit the signal on.
+ * @param signalName Name of the signal to emit.
+ * @param args Arguments passed to the signal handlers.
  */
-export declare const fireEvent: (element: Gtk.Widget | Gtk.EventController, signalName: string, ...args: Value[]) => Promise<void>;
+export declare const fireEvent: (element: GObject.Object, signalName: string, ...args: unknown[]) => Promise<void>;
 //# sourceMappingURL=fire-event.d.ts.map

package/dist/fire-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fire-event.d.ts","sourceRoot":"","sources":["../src/fire-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,KAAK,KAAK,GAAG,MAAM,eAAe,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,SAAS,GAClB,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,eAAe,EACzC,YAAY,MAAM,EAClB,GAAG,MAAM,KAAK,EAAE,KACjB,OAAO,CAAC,IAAI,CASd,CAAC"}
+{"version":3,"file":"fire-event.d.ts","sourceRoot":"","sources":["../src/fire-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAGjD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,YAAmB,OAAO,CAAC,MAAM,cAAc,MAAM,WAAW,OAAO,EAAE,KAAG,OAAO,CAAC,IAAI,CAI7G,CAAC"}

package/dist/fire-event.js

@@ -1,35 +1,15 @@
-import { signalEmitv, signalLookup, typeFromName, Value } from "@gtkx/ffi/gobject";
-import { tick } from "./timing.js";
+import { runInAct } from "./act.js";
 /**
- * Emits a GTK signal on a widget or event controller.
+ * Emits a GObject signal on a widget or object inside React's act environment,
+ * so any resulting state updates are flushed before the promise resolves.
  *
- * Low-level utility for triggering signals directly. Prefer {@link userEvent}
- * for common interactions like clicking and typing.
- *
- * @param element - The widget or event controller to emit the signal on
- * @param signalName - GTK signal name (e.g., "clicked", "activate", "drag-begin")
- * @param args - Additional signal arguments as GValues
- *
- * @example
- * ```tsx
- * import { fireEvent } from "@gtkx/testing";
- * import { Value } from "@gtkx/ffi/gobject";
- *
- * // Emit signal on widget
- * await fireEvent(widget, "clicked");
- *
- * // Emit signal on gesture controller
- * const gesture = widget.observeControllers().getObject(0) as Gtk.GestureDrag;
- * await fireEvent(gesture, "drag-begin", Value.newFromDouble(100), Value.newFromDouble(100));
- * ```
- *
- * @see {@link userEvent} for high-level user interactions
+ * @param element The GObject instance to emit the signal on.
+ * @param signalName Name of the signal to emit.
+ * @param args Arguments passed to the signal handlers.
  */
 export const fireEvent = async (element, signalName, ...args) => {
-    const gtype = typeFromName(element.constructor.glibTypeName);
-    const signalId = signalLookup(signalName, gtype);
-    const instanceValue = Value.newFromObject(element);
-    signalEmitv([instanceValue, ...args], signalId, 0);
-    await tick();
+    await runInAct(() => {
+        element.emit(signalName, ...args);
+    });
 };
 //# sourceMappingURL=fire-event.js.map

package/dist/fire-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"fire-event.js","sourceRoot":"","sources":["../src/fire-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE3G,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC1B,OAAyC,EACzC,UAAkB,EAClB,GAAG,IAAa,EACH,EAAE;IACf,MAAM,KAAK,GAAG,YAAY,CAAE,OAAO,CAAC,WAA8B,CAAC,YAAY,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAEjD,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,OAAkB,CAAC,CAAC;IAE9D,WAAW,CAAC,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEnD,MAAM,IAAI,EAAE,CAAC;AACjB,CAAC,CAAC"}
+{"version":3,"file":"fire-event.js","sourceRoot":"","sources":["../src/fire-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,OAAuB,EAAE,UAAkB,EAAE,GAAG,IAAe,EAAiB,EAAE;IAC9G,MAAM,QAAQ,CAAC,GAAG,EAAE;QAChB,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport { runInAct } from \"./act.js\";\n\n/**\n * Emits a GObject signal on a widget or object inside React's act environment,\n * so any resulting state updates are flushed before the promise resolves.\n *\n * @param element The GObject instance to emit the signal on.\n * @param signalName Name of the signal to emit.\n * @param args Arguments passed to the signal handlers.\n */\nexport const fireEvent = async (element: GObject.Object, signalName: string, ...args: unknown[]): Promise<void> => {\n    await runInAct(() => {\n        element.emit(signalName, ...args);\n    });\n};\n"]}

package/dist/frame-sync.d.ts

@@ -0,0 +1,3 @@
+import type * as Gtk from "@gtkx/gi/gtk";
+export declare const scheduleAfterLayout: (widget: Gtk.Widget | null, callback: () => void) => void;
+//# sourceMappingURL=frame-sync.d.ts.map

package/dist/frame-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-sync.d.ts","sourceRoot":"","sources":["../src/frame-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAIzC,eAAO,MAAM,mBAAmB,WAAY,GAAG,CAAC,MAAM,GAAG,IAAI,YAAY,MAAM,IAAI,KAAG,IA6BrF,CAAC"}

package/dist/frame-sync.js

@@ -0,0 +1,30 @@
+const CLOCK_STALL_FALLBACK_MS = 500;
+export const scheduleAfterLayout = (widget, callback) => {
+    let done = false;
+    let removeTick = null;
+    let fallback = null;
+    const finish = () => {
+        if (done)
+            return;
+        done = true;
+        if (fallback !== null)
+            clearTimeout(fallback);
+        removeTick?.();
+        removeTick = null;
+        fallback = null;
+        callback();
+    };
+    if (widget === null || widget.getFrameClock() === null || widget.getWidth() > 0) {
+        queueMicrotask(finish);
+        return;
+    }
+    fallback = setTimeout(finish, CLOCK_STALL_FALLBACK_MS);
+    const tickId = widget.addTickCallback(() => {
+        if (widget.getWidth() === 0)
+            return true;
+        finish();
+        return false;
+    });
+    removeTick = () => widget.removeTickCallback(tickId);
+};
+//# sourceMappingURL=frame-sync.js.map

package/dist/frame-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-sync.js","sourceRoot":"","sources":["../src/frame-sync.ts"],"names":[],"mappings":"AAEA,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAyB,EAAE,QAAoB,EAAQ,EAAE;IACzF,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,UAAU,GAAwB,IAAI,CAAC;IAC3C,IAAI,QAAQ,GAAyC,IAAI,CAAC;IAE1D,MAAM,MAAM,GAAG,GAAS,EAAE;QACtB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,QAAQ,KAAK,IAAI;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC9C,UAAU,EAAE,EAAE,CAAC;QACf,UAAU,GAAG,IAAI,CAAC;QAClB,QAAQ,GAAG,IAAI,CAAC;QAChB,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC;IAEF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;QAC9E,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO;IACX,CAAC;IAED,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE;QACvC,IAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,UAAU,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\n\nconst CLOCK_STALL_FALLBACK_MS = 500;\n\nexport const scheduleAfterLayout = (widget: Gtk.Widget | null, callback: () => void): void => {\n    let done = false;\n    let removeTick: (() => void) | null = null;\n    let fallback: ReturnType<typeof setTimeout> | null = null;\n\n    const finish = (): void => {\n        if (done) return;\n        done = true;\n        if (fallback !== null) clearTimeout(fallback);\n        removeTick?.();\n        removeTick = null;\n        fallback = null;\n        callback();\n    };\n\n    if (widget === null || widget.getFrameClock() === null || widget.getWidth() > 0) {\n        queueMicrotask(finish);\n        return;\n    }\n\n    fallback = setTimeout(finish, CLOCK_STALL_FALLBACK_MS);\n\n    const tickId = widget.addTickCallback(() => {\n        if (widget.getWidth() === 0) return true;\n        finish();\n        return false;\n    });\n\n    removeTick = () => widget.removeTickCallback(tickId);\n};\n"]}

package/dist/index.d.ts

@@ -1,21 +1,26 @@
-export type { Config } from "./config.js";
+import "./register-test-hooks.js";
+export { act } from "./act.js";
+export type { BoundQueries, RenderResult, Screen } from "./bound-queries.js";
+export type { Config, ConfigFn } from "./config.js";
 export { configure, getConfig } from "./config.js";
 export { fireEvent } from "./fire-event.js";
+export type { TextExpectation } from "./matchers.js";
+export { matchers, registerMatchers } from "./matchers.js";
 export type { PrettyWidgetOptions } from "./pretty-widget.js";
-export { prettyWidget } from "./pretty-widget.js";
-export { findAllByLabelText, findAllByRole, findAllByTestId, findAllByText, findByLabelText, findByRole, findByTestId, findByText, queryAllByLabelText, queryAllByRole, queryAllByTestId, queryAllByText, queryByLabelText, queryByRole, queryByTestId, queryByText, } from "./queries.js";
+export { logWidget, prettyWidget } from "./pretty-widget.js";
+export { findAllByDisplayValue, findAllByLabelText, findAllByName, findAllByPlaceholderText, findAllByRole, findAllByText, findByDisplayValue, findByLabelText, findByName, findByPlaceholderText, findByRole, findByText, getAllByDisplayValue, getAllByLabelText, getAllByName, getAllByPlaceholderText, getAllByRole, getAllByText, getByDisplayValue, getByLabelText, getByName, getByPlaceholderText, getByRole, getByText, getDefaultNormalizer, queryAllByDisplayValue, queryAllByLabelText, queryAllByName, queryAllByPlaceholderText, queryAllByRole, queryAllByText, queryByDisplayValue, queryByLabelText, queryByName, queryByPlaceholderText, queryByRole, queryByText, } from "./queries.js";
 export { cleanup, render } from "./render.js";
 export { renderHook } from "./render-hook.js";
-export type { RoleInfo } from "./role-helpers.js";
-export { getRoles, logRoles, prettyRoles } from "./role-helpers.js";
+export { formatRole, getRoles, logRoles, prettyRoles } from "./role-helpers.js";
 export { screen } from "./screen.js";
-export type { ScreenshotOptions } from "./screenshot.js";
-export { screenshot } from "./screenshot.js";
-export { tick } from "./timing.js";
+export { captureAndSaveScreenshot, logScreenshotPath, screenshot } from "./screenshot.js";
+export type { Method, Suggestion, Variant } from "./suggestions.js";
+export { getSuggestedQuery } from "./suggestions.js";
 export type { Container } from "./traversal.js";
-export type { BoundQueries, ByRoleOptions, NormalizerOptions, RenderHookOptions, RenderHookResult, RenderOptions, RenderResult, ScreenshotResult, TextMatch, TextMatchFunction, TextMatchOptions, WaitForOptions, WrapperComponent, } from "./types.js";
-export type { PointerInput, TabOptions } from "./user-event.js";
-export { userEvent } from "./user-event.js";
+export type { ByRoleOptions, ByRoleValue, Matcher, MatcherFunction, MatcherOptions, NormalizerFn, NormalizerOptions, RenderHookOptions, RenderHookResult, RenderOptions, ScreenshotOptions, ScreenshotResult, WaitForOptions, WindowSelector, WrapperComponent, } from "./types.js";
+export type { DragOffset, DragOptions, DropContent, DropOptions, PointerInput, TabOptions, TypeOptions, UserEvent, } from "./user-event/index.js";
+export { userEvent } from "./user-event/index.js";
 export { waitFor, waitForElementToBeRemoved } from "./wait-for.js";
+export { getWidgetErrorMessage, getWidgetInvalidState, getWidgetNodeText, } from "./widget-accessible-properties.js";
 export { within } from "./within.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC;AAElC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACH,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,SAAS,EACT,SAAS,EACT,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,WAAW,EACX,WAAW,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1F,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACR,aAAa,EACb,WAAW,EACX,OAAO,EACP,eAAe,EACf,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,SAAS,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,14 +1,18 @@
+import "./register-test-hooks.js";
+export { act } from "./act.js";
 export { configure, getConfig } from "./config.js";
 export { fireEvent } from "./fire-event.js";
-export { prettyWidget } from "./pretty-widget.js";
-export { findAllByLabelText, findAllByRole, findAllByTestId, findAllByText, findByLabelText, findByRole, findByTestId, findByText, queryAllByLabelText, queryAllByRole, queryAllByTestId, queryAllByText, queryByLabelText, queryByRole, queryByTestId, queryByText, } from "./queries.js";
+export { matchers, registerMatchers } from "./matchers.js";
+export { logWidget, prettyWidget } from "./pretty-widget.js";
+export { findAllByDisplayValue, findAllByLabelText, findAllByName, findAllByPlaceholderText, findAllByRole, findAllByText, findByDisplayValue, findByLabelText, findByName, findByPlaceholderText, findByRole, findByText, getAllByDisplayValue, getAllByLabelText, getAllByName, getAllByPlaceholderText, getAllByRole, getAllByText, getByDisplayValue, getByLabelText, getByName, getByPlaceholderText, getByRole, getByText, getDefaultNormalizer, queryAllByDisplayValue, queryAllByLabelText, queryAllByName, queryAllByPlaceholderText, queryAllByRole, queryAllByText, queryByDisplayValue, queryByLabelText, queryByName, queryByPlaceholderText, queryByRole, queryByText, } from "./queries.js";
 export { cleanup, render } from "./render.js";
 export { renderHook } from "./render-hook.js";
-export { getRoles, logRoles, prettyRoles } from "./role-helpers.js";
+export { formatRole, getRoles, logRoles, prettyRoles } from "./role-helpers.js";
 export { screen } from "./screen.js";
-export { screenshot } from "./screenshot.js";
-export { tick } from "./timing.js";
-export { userEvent } from "./user-event.js";
+export { captureAndSaveScreenshot, logScreenshotPath, screenshot } from "./screenshot.js";
+export { getSuggestedQuery } from "./suggestions.js";
+export { userEvent } from "./user-event/index.js";
 export { waitFor, waitForElementToBeRemoved } from "./wait-for.js";
+export { getWidgetErrorMessage, getWidgetInvalidState, getWidgetNodeText, } from "./widget-accessible-properties.js";
 export { within } from "./within.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAkBnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC;AAElC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACH,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,SAAS,EACT,SAAS,EACT,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,WAAW,EACX,WAAW,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA6BrD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC","sourcesContent":["import \"./register-test-hooks.js\";\n\nexport { act } from \"./act.js\";\nexport type { BoundQueries, RenderResult, Screen } from \"./bound-queries.js\";\nexport type { Config, ConfigFn } from \"./config.js\";\nexport { configure, getConfig } from \"./config.js\";\nexport { fireEvent } from \"./fire-event.js\";\nexport type { TextExpectation } from \"./matchers.js\";\nexport { matchers, registerMatchers } from \"./matchers.js\";\nexport type { PrettyWidgetOptions } from \"./pretty-widget.js\";\nexport { logWidget, prettyWidget } from \"./pretty-widget.js\";\nexport {\n    findAllByDisplayValue,\n    findAllByLabelText,\n    findAllByName,\n    findAllByPlaceholderText,\n    findAllByRole,\n    findAllByText,\n    findByDisplayValue,\n    findByLabelText,\n    findByName,\n    findByPlaceholderText,\n    findByRole,\n    findByText,\n    getAllByDisplayValue,\n    getAllByLabelText,\n    getAllByName,\n    getAllByPlaceholderText,\n    getAllByRole,\n    getAllByText,\n    getByDisplayValue,\n    getByLabelText,\n    getByName,\n    getByPlaceholderText,\n    getByRole,\n    getByText,\n    getDefaultNormalizer,\n    queryAllByDisplayValue,\n    queryAllByLabelText,\n    queryAllByName,\n    queryAllByPlaceholderText,\n    queryAllByRole,\n    queryAllByText,\n    queryByDisplayValue,\n    queryByLabelText,\n    queryByName,\n    queryByPlaceholderText,\n    queryByRole,\n    queryByText,\n} from \"./queries.js\";\nexport { cleanup, render } from \"./render.js\";\nexport { renderHook } from \"./render-hook.js\";\nexport { formatRole, getRoles, logRoles, prettyRoles } from \"./role-helpers.js\";\nexport { screen } from \"./screen.js\";\nexport { captureAndSaveScreenshot, logScreenshotPath, screenshot } from \"./screenshot.js\";\nexport type { Method, Suggestion, Variant } from \"./suggestions.js\";\nexport { getSuggestedQuery } from \"./suggestions.js\";\nexport type { Container } from \"./traversal.js\";\nexport type {\n    ByRoleOptions,\n    ByRoleValue,\n    Matcher,\n    MatcherFunction,\n    MatcherOptions,\n    NormalizerFn,\n    NormalizerOptions,\n    RenderHookOptions,\n    RenderHookResult,\n    RenderOptions,\n    ScreenshotOptions,\n    ScreenshotResult,\n    WaitForOptions,\n    WindowSelector,\n    WrapperComponent,\n} from \"./types.js\";\nexport type {\n    DragOffset,\n    DragOptions,\n    DropContent,\n    DropOptions,\n    PointerInput,\n    TabOptions,\n    TypeOptions,\n    UserEvent,\n} from \"./user-event/index.js\";\nexport { userEvent } from \"./user-event/index.js\";\nexport { waitFor, waitForElementToBeRemoved } from \"./wait-for.js\";\nexport {\n    getWidgetErrorMessage,\n    getWidgetInvalidState,\n    getWidgetNodeText,\n} from \"./widget-accessible-properties.js\";\nexport { within } from \"./within.js\";\n"]}

package/dist/matchers.d.ts

@@ -0,0 +1,55 @@
+/** The expected value for a text matcher: an exact string or a regular expression. */
+export type TextExpectation = string | RegExp;
+type MatcherResult = {
+    pass: boolean;
+    message: () => string;
+};
+interface MatcherContext {
+    isNot: boolean;
+}
+type TextMatcher = (this: MatcherContext, received: unknown, expected?: TextExpectation) => MatcherResult;
+type StateMatcher = (this: MatcherContext, received: unknown) => MatcherResult;
+type ValueMatcher = (this: MatcherContext, received: unknown, expected: number) => MatcherResult;
+export declare const toHaveDisplayValue: TextMatcher;
+export declare const toHaveTextContent: TextMatcher;
+export declare const toHaveAccessibleName: TextMatcher;
+export declare const toHavePlaceholderText: TextMatcher;
+export declare const toBeChecked: StateMatcher;
+export declare const toBePressed: StateMatcher;
+export declare const toBeExpanded: StateMatcher;
+export declare const toBeSelected: StateMatcher;
+export declare const toHaveValue: ValueMatcher;
+interface MatcherImplementations {
+    toHaveDisplayValue: TextMatcher;
+    toHaveTextContent: TextMatcher;
+    toHaveAccessibleName: TextMatcher;
+    toHavePlaceholderText: TextMatcher;
+    toBeChecked: StateMatcher;
+    toBePressed: StateMatcher;
+    toBeExpanded: StateMatcher;
+    toBeSelected: StateMatcher;
+    toHaveValue: ValueMatcher;
+}
+/** The widget assertion matchers keyed by name, suitable for passing to `expect.extend`. */
+export declare const matchers: MatcherImplementations;
+/** Registers the widget matchers on the global `expect`, when one is available. Safe to call more than once. */
+export declare const registerMatchers: () => void;
+interface WidgetMatchers<R = void> {
+    toHaveDisplayValue(expected?: TextExpectation): R;
+    toHaveTextContent(expected?: TextExpectation): R;
+    toHaveAccessibleName(expected?: TextExpectation): R;
+    toHavePlaceholderText(expected?: TextExpectation): R;
+    toBeChecked(): R;
+    toBePressed(): R;
+    toBeExpanded(): R;
+    toBeSelected(): R;
+    toHaveValue(expected: number): R;
+}
+declare module "@vitest/expect" {
+    interface Assertion<T = any> extends WidgetMatchers {
+    }
+    interface AsymmetricMatchersContaining extends WidgetMatchers {
+    }
+}
+export {};
+//# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"AAcA,sFAAsF;AACtF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC;AAE9D,UAAU,cAAc;IACpB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,KAAK,aAAa,CAAC;AAC1G,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,KAAK,aAAa,CAAC;AAC/E,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,aAAa,CAAC;AA0EjG,eAAO,MAAM,kBAAkB,EAAE,WAA+E,CAAC;AACjH,eAAO,MAAM,iBAAiB,EAAE,WAI/B,CAAC;AACF,eAAO,MAAM,oBAAoB,EAAE,WAAmF,CAAC;AACvH,eAAO,MAAM,qBAAqB,EAAE,WAInC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,YAAmF,CAAC;AAC9G,eAAO,MAAM,WAAW,EAAE,YAAmF,CAAC;AAC9G,eAAO,MAAM,YAAY,EAAE,YAAsF,CAAC;AAClH,eAAO,MAAM,YAAY,EAAE,YAAsF,CAAC;AAElH,eAAO,MAAM,WAAW,EAAE,YAkBzB,CAAC;AAEF,UAAU,sBAAsB;IAC5B,kBAAkB,EAAE,WAAW,CAAC;IAChC,iBAAiB,EAAE,WAAW,CAAC;IAC/B,oBAAoB,EAAE,WAAW,CAAC;IAClC,qBAAqB,EAAE,WAAW,CAAC;IACnC,WAAW,EAAE,YAAY,CAAC;IAC1B,WAAW,EAAE,YAAY,CAAC;IAC1B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,YAAY,CAAC;CAC7B;AAED,4FAA4F;AAC5F,eAAO,MAAM,QAAQ,EAAE,sBAUtB,CAAC;AAcF,gHAAgH;AAChH,eAAO,MAAM,gBAAgB,QAAO,IAMnC,CAAC;AAEF,UAAU,cAAc,CAAC,CAAC,GAAG,IAAI;IAC7B,kBAAkB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC;IAClD,iBAAiB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC;IACjD,oBAAoB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC;IACpD,qBAAqB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC;IACrD,WAAW,IAAI,CAAC,CAAC;IACjB,WAAW,IAAI,CAAC,CAAC;IACjB,YAAY,IAAI,CAAC,CAAC;IAClB,YAAY,IAAI,CAAC,CAAC;IAClB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC;CACpC;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAE5B,UAAU,SAAS,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,cAAc;KAAG;IACtD,UAAU,4BAA6B,SAAQ,cAAc;KAAG;CACnE"}