@gtkx/testing 1.0.0-rc.1 → 1.0.0-rc.3

package/dist/queries.js

@@ -1,25 +1,140 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { buildQueries } from "./build-queries.js";
 import { multipleFoundError, notFoundError } from "./errors.js";
+import { getDefaultNormalizer } from "./normalize.js";
 import { findAll, traverse } from "./traversal.js";
-import { getWidgetAccessibleName, getWidgetBusyState, getWidgetCheckedState, getWidgetDescription, getWidgetDisplayValue, getWidgetExpandedState, getWidgetLabelledByText, getWidgetLabelText, getWidgetLevel, getWidgetName, getWidgetOwnLabel, getWidgetPlaceholderText, getWidgetPressedState, getWidgetSelectedState, getWidgetValue, isInaccessible, } from "./widget-accessible-properties.js";
+import { getWidgetAccessibleName, getWidgetBusyState, getWidgetDescription, getWidgetDisplayValue, getWidgetExpandedState, getWidgetLabelledByText, getWidgetLabelText, getWidgetLevel, getWidgetName, getWidgetOwnLabel, getWidgetPlaceholderText, getWidgetPressedState, getWidgetSelectedState, getWidgetValue, isInaccessible, isWidgetChecked, } from "./widget-accessible-properties.js";
+const roleQueries = nameQueryFamily("Role", queryAllByRole, buildQueries("Role", queryAllByRole, (container, matches, role, options) => multipleFoundError(container, { queryType: "role", role, options }, matches), (container, role, options) => notFoundError(container, { queryType: "role", role, options })));
+const labelTextQueries = nameQueryFamily("LabelText", queryAllByLabelText, buildQueries("LabelText", queryAllByLabelText, (container, matches, text) => multipleFoundError(container, { queryType: "labelText", text }, matches), (container, text) => notFoundError(container, { queryType: "labelText", text })));
+const textQueries = nameQueryFamily("Text", queryAllByText, buildQueries("Text", queryAllByText, (container, matches, text) => multipleFoundError(container, { queryType: "text", text }, matches), (container, text) => notFoundError(container, { queryType: "text", text })));
+const nameQueries = nameQueryFamily("Name", queryAllByName, buildQueries("Name", queryAllByName, (container, matches, name) => multipleFoundError(container, { queryType: "name", name }, matches), (container, name) => notFoundError(container, { queryType: "name", name })));
+const placeholderTextQueries = nameQueryFamily("PlaceholderText", queryAllByPlaceholderText, buildQueries("PlaceholderText", queryAllByPlaceholderText, (container, matches, text) => multipleFoundError(container, { queryType: "placeholderText", text }, matches), (container, text) => notFoundError(container, { queryType: "placeholderText", text })));
+const displayValueQueries = nameQueryFamily("DisplayValue", queryAllByDisplayValue, buildQueries("DisplayValue", queryAllByDisplayValue, (container, matches, value) => multipleFoundError(container, { queryType: "displayValue", value }, matches), (container, value) => notFoundError(container, { queryType: "displayValue", value })));
+const builtinQueries = {
+    ...roleQueries,
+    ...labelTextQueries,
+    ...textQueries,
+    ...nameQueries,
+    ...placeholderTextQueries,
+    ...displayValueQueries,
+};
 /**
- * Builds the default text normalizer, which optionally trims surrounding whitespace and collapses runs of whitespace into single spaces.
- * @param options Toggles for trimming and whitespace collapsing.
- * @returns A function that normalizes a string for comparison against a matcher.
+ * Returns the single widget with a matching accessible role and options, or null when none match.
+ * Throws when more than one matches.
  */
-export const getDefaultNormalizer = ({ trim = true, collapseWhitespace = true, } = {}) => {
-    return (text) => {
-        let result = text;
-        if (trim) {
-            result = result.trim();
-        }
-        if (collapseWhitespace) {
-            result = result.replaceAll(/\s+/g, " ");
-        }
-        return result;
-    };
-};
+const queryByRole = builtinQueries.queryByRole;
+/** Returns every widget with a matching accessible role and options. Throws when none match. */
+const getAllByRole = builtinQueries.getAllByRole;
+/**
+ * Returns the single widget with a matching accessible role and options.
+ * Throws when none or more than one matches.
+ */
+const getByRole = builtinQueries.getByRole;
+/**
+ * Waits for and returns every widget with a matching accessible role and options, retrying until at
+ * least one appears or the timeout elapses.
+ */
+const findAllByRole = builtinQueries.findAllByRole;
+/**
+ * Waits for and returns the single widget with a matching accessible role and options, retrying
+ * until it appears or the timeout elapses. Rejects when none or more than one matches.
+ */
+const findByRole = builtinQueries.findByRole;
+/**
+ * Returns the single widget with matching associated label text, or null when none match.
+ * Throws when more than one matches.
+ */
+const queryByLabelText = builtinQueries.queryByLabelText;
+/** Returns every widget with matching associated label text. Throws when none match. */
+const getAllByLabelText = builtinQueries.getAllByLabelText;
+/** Returns the single widget with matching associated label text. Throws when none or more than one matches. */
+const getByLabelText = builtinQueries.getByLabelText;
+/**
+ * Waits for and returns every widget with matching associated label text, retrying until at least
+ * one appears or the timeout elapses.
+ */
+const findAllByLabelText = builtinQueries.findAllByLabelText;
+/**
+ * Waits for and returns the single widget with matching associated label text, retrying until it
+ * appears or the timeout elapses. Rejects when none or more than one matches.
+ */
+const findByLabelText = builtinQueries.findByLabelText;
+/**
+ * Returns the single widget with matching rendered text content, or null when none match.
+ * Throws when more than one matches.
+ */
+const queryByText = builtinQueries.queryByText;
+/** Returns every widget with matching rendered text content. Throws when none match. */
+const getAllByText = builtinQueries.getAllByText;
+/** Returns the single widget with matching rendered text content. Throws when none or more than one matches. */
+const getByText = builtinQueries.getByText;
+/**
+ * Waits for and returns every widget with matching rendered text content, retrying until at least
+ * one appears or the timeout elapses.
+ */
+const findAllByText = builtinQueries.findAllByText;
+/**
+ * Waits for and returns the single widget with matching rendered text content, retrying until it
+ * appears or the timeout elapses. Rejects when none or more than one matches.
+ */
+const findByText = builtinQueries.findByText;
+/**
+ * Returns the single widget with a matching widget name, or null when none match.
+ * Throws when more than one matches.
+ */
+const queryByName = builtinQueries.queryByName;
+/** Returns every widget with a matching widget name. Throws when none match. */
+const getAllByName = builtinQueries.getAllByName;
+/** Returns the single widget with a matching widget name. Throws when none or more than one matches. */
+const getByName = builtinQueries.getByName;
+/**
+ * Waits for and returns every widget with a matching widget name, retrying until at least one
+ * appears or the timeout elapses.
+ */
+const findAllByName = builtinQueries.findAllByName;
+/**
+ * Waits for and returns the single widget with a matching widget name, retrying until it appears or
+ * the timeout elapses. Rejects when none or more than one matches.
+ */
+const findByName = builtinQueries.findByName;
+/**
+ * Returns the single widget with matching placeholder text, or null when none match.
+ * Throws when more than one matches.
+ */
+const queryByPlaceholderText = builtinQueries.queryByPlaceholderText;
+/** Returns every widget with matching placeholder text. Throws when none match. */
+const getAllByPlaceholderText = builtinQueries.getAllByPlaceholderText;
+/** Returns the single widget with matching placeholder text. Throws when none or more than one matches. */
+const getByPlaceholderText = builtinQueries.getByPlaceholderText;
+/**
+ * Waits for and returns every widget with matching placeholder text, retrying until at least one
+ * appears or the timeout elapses.
+ */
+const findAllByPlaceholderText = builtinQueries.findAllByPlaceholderText;
+/**
+ * Waits for and returns the single widget with matching placeholder text, retrying until it appears
+ * or the timeout elapses. Rejects when none or more than one matches.
+ */
+const findByPlaceholderText = builtinQueries.findByPlaceholderText;
+/**
+ * Returns the single widget with a matching display value, or null when none match.
+ * Throws when more than one matches.
+ */
+const queryByDisplayValue = builtinQueries.queryByDisplayValue;
+/** Returns every widget with a matching display value. Throws when none match. */
+const getAllByDisplayValue = builtinQueries.getAllByDisplayValue;
+/** Returns the single widget with a matching display value. Throws when none or more than one matches. */
+const getByDisplayValue = builtinQueries.getByDisplayValue;
+/**
+ * Waits for and returns every widget with a matching display value, retrying until at least one
+ * appears or the timeout elapses.
+ */
+const findAllByDisplayValue = builtinQueries.findAllByDisplayValue;
+/**
+ * Waits for and returns the single widget with a matching display value, retrying until it appears
+ * or the timeout elapses. Rejects when none or more than one matches.
+ */
+const findByDisplayValue = builtinQueries.findByDisplayValue;
 const buildNormalizer = (options) => {
     const { normalizer, trim, collapseWhitespace } = options ?? {};
     if (!normalizer) {
@@ -28,7 +143,7 @@ const buildNormalizer = (options) => {
     if (trim !== undefined || collapseWhitespace !== undefined) {
         throw new Error("trim and collapseWhitespace are not supported with a normalizer. " +
             "If you want to use the default trim and collapseWhitespace logic in your normalizer, " +
-            'use "getDefaultNormalizer({ trim, collapseWhitespace })" and compose that into your normalizer');
+            "use \"getDefaultNormalizer({ trim, collapseWhitespace })\" and compose that into your normalizer");
     }
     return normalizer;
 };
@@ -36,9 +151,10 @@ const normalizeText = (text, options) => {
     const normalizer = buildNormalizer(options);
     return normalizer(text);
 };
-const matchText = (actual, expected, widget, options) => {
-    if (actual === null)
+const isTextMatch = (actual, expected, widget, options) => {
+    if (actual === null) {
         return false;
+    }
     const normalizedActual = normalizeText(actual, options);
     if (typeof expected === "function") {
         return expected(normalizedActual, widget);
@@ -48,61 +164,67 @@ const matchText = (actual, expected, widget, options) => {
         return expected.test(normalizedActual);
     }
     const normalizedExpected = normalizeText(String(expected), options);
-    const exact = options?.exact ?? true;
-    return exact
+    const isExact = options?.exact ?? true;
+    return isExact
         ? normalizedActual === normalizedExpected
         : normalizedActual.toLowerCase().includes(normalizedExpected.toLowerCase());
 };
-const matchAccessibleName = (widget, options) => {
-    if (options.name === undefined)
+const hasMatchingAccessibleName = (widget, options) => {
+    if (options.name === undefined) {
         return true;
+    }
     const text = getWidgetAccessibleName(widget);
-    return matchText(text, options.name, widget, options);
+    return isTextMatch(text, options.name, widget, options);
 };
-const matchAccessibleValue = (widget, value, options) => {
+const isNumericValueMatch = (expected, actual) => expected === undefined || actual === expected;
+const hasMatchingAccessibleValue = (widget, value, options) => {
     const actual = getWidgetValue(widget);
-    if (value.now !== undefined && actual.now !== value.now)
-        return false;
-    if (value.min !== undefined && actual.min !== value.min)
-        return false;
-    if (value.max !== undefined && actual.max !== value.max)
-        return false;
-    if (value.text !== undefined && !matchText(actual.text, value.text, widget, options))
-        return false;
-    return true;
-};
-const matchBooleanStates = (widget, options) => {
-    if (options.checked !== undefined && getWidgetCheckedState(widget) !== options.checked)
-        return false;
-    if (options.pressed !== undefined && getWidgetPressedState(widget) !== options.pressed)
-        return false;
-    if (options.expanded !== undefined && getWidgetExpandedState(widget) !== options.expanded)
-        return false;
-    if (options.selected !== undefined && getWidgetSelectedState(widget) !== options.selected)
-        return false;
-    if (options.busy !== undefined && (getWidgetBusyState(widget) ?? false) !== options.busy)
-        return false;
-    return true;
+    const numericChecks = [
+        [value.now, actual.now],
+        [value.min, actual.min],
+        [value.max, actual.max],
+    ];
+    for (const [expected, current] of numericChecks) {
+        if (!isNumericValueMatch(expected, current)) {
+            return false;
+        }
+    }
+    return value.text === undefined || isTextMatch(actual.text, value.text, widget, options);
 };
-const matchAccessibleStates = (widget, options) => {
-    if (!matchBooleanStates(widget, options))
-        return false;
-    if (options.level !== undefined && getWidgetLevel(widget) !== options.level)
-        return false;
-    if (options.description !== undefined &&
-        !matchText(getWidgetDescription(widget), options.description, widget, options))
-        return false;
-    if (options.value !== undefined && !matchAccessibleValue(widget, options.value, options))
-        return false;
+const hasMatchingBooleanStates = (widget, options) => {
+    const stateChecks = [
+        [options.checked, () => isWidgetChecked(widget)],
+        [options.pressed, () => getWidgetPressedState(widget)],
+        [options.expanded, () => getWidgetExpandedState(widget)],
+        [options.selected, () => getWidgetSelectedState(widget)],
+        [options.busy, () => getWidgetBusyState(widget) ?? false],
+    ];
+    for (const [expected, getActual] of stateChecks) {
+        if (expected !== undefined && getActual() !== expected) {
+            return false;
+        }
+    }
     return true;
 };
-const matchByRoleOptions = (widget, options) => {
-    if (!options)
+const hasMatchingLevelState = (widget, options) => options.level === undefined || getWidgetLevel(widget) === options.level;
+const hasMatchingDescriptionState = (widget, options) => options.description === undefined ||
+    isTextMatch(getWidgetDescription(widget), options.description, widget, options);
+const hasMatchingValueState = (widget, options) => options.value === undefined || hasMatchingAccessibleValue(widget, options.value, options);
+const hasMatchingAccessibleStates = (widget, options) => hasMatchingBooleanStates(widget, options) &&
+    hasMatchingLevelState(widget, options) &&
+    hasMatchingDescriptionState(widget, options) &&
+    hasMatchingValueState(widget, options);
+const isMatchingWidgetType = (widget, options) => options?.as === undefined || widget instanceof options.as;
+const hasMatchingByRoleOptions = (widget, options) => {
+    if (!options) {
         return true;
-    return matchAccessibleName(widget, options) && matchAccessibleStates(widget, options);
+    }
+    return (isMatchingWidgetType(widget, options) &&
+        hasMatchingAccessibleName(widget, options) &&
+        hasMatchingAccessibleStates(widget, options));
 };
-const nameQueryFamily = (suffix, queryAllBy, built) => {
-    const family = {
+function nameQueryFamily(suffix, queryAllBy, built) {
+    return {
         [`queryBy${suffix}`]: built.queryBy,
         [`queryAllBy${suffix}`]: queryAllBy,
         [`getBy${suffix}`]: built.getBy,
@@ -110,8 +232,7 @@ const nameQueryFamily = (suffix, queryAllBy, built) => {
         [`findBy${suffix}`]: built.findBy,
         [`findAllBy${suffix}`]: built.findAllBy,
     };
-    return family;
-};
+}
 /**
  * Finds every widget under the container whose accessible role matches `role` and that satisfies the given options.
  * Widgets excluded from the accessibility tree are skipped unless `options.hidden` is set.
@@ -120,45 +241,56 @@ const nameQueryFamily = (suffix, queryAllBy, built) => {
  * @param options Additional accessible name, state, and value constraints.
  * @returns Every matching widget, or an empty array when none match.
  */
-export const queryAllByRole = (container, role, options) => findAll(container, (widget) => {
-    if (widget.getAccessibleRole() !== role)
-        return false;
-    if (!options?.hidden && isInaccessible(widget))
-        return false;
-    return matchByRoleOptions(widget, options);
-});
-const roleQueries = nameQueryFamily("Role", queryAllByRole, buildQueries("Role", queryAllByRole, (container, matches, role, options) => multipleFoundError(container, { queryType: "role", role, options }, matches), (container, role, options) => notFoundError(container, { queryType: "role", role, options })));
+function queryAllByRole(container, role, options) {
+    return findAll(container, (widget) => {
+        if (widget.getAccessibleRole() !== role) {
+            return false;
+        }
+        if (!options?.hidden && isInaccessible(widget)) {
+            return false;
+        }
+        return hasMatchingByRoleOptions(widget, options);
+    });
+}
 const collectMnemonicMatch = (widget, text, options) => {
-    if (!(widget instanceof Gtk.Label))
+    if (!(widget instanceof Gtk.Label)) {
         return null;
+    }
     const labelText = widget.getLabel();
-    if (!labelText || !matchText(labelText, text, widget, options))
+    if (!labelText || !isTextMatch(labelText, text, widget, options)) {
         return null;
+    }
     return widget.getMnemonicWidget();
 };
+const collectLabelMatches = (results, widget, text, options) => {
+    const mnemonicTarget = collectMnemonicMatch(widget, text, options);
+    if (mnemonicTarget) {
+        results.add(mnemonicTarget);
+    }
+    const ownLabel = getWidgetOwnLabel(widget);
+    if (ownLabel !== null && isTextMatch(ownLabel, text, widget, options)) {
+        results.add(widget);
+    }
+    const labelledByText = getWidgetLabelledByText(widget);
+    if (labelledByText !== null && isTextMatch(labelledByText, text, widget, options)) {
+        results.add(widget);
+    }
+};
 /**
- * Finds every widget associated with a label whose text matches: a Gtk.Label mnemonic target, the widget's own accessible label, or its labelled-by relation.
+ * Finds every widget associated with a label whose text matches: a Gtk.Label mnemonic target, the
+ * widget's own accessible label, or its labelled-by relation.
  * @param container Widget subtree to search.
  * @param text Matcher for the label text.
  * @param options Text matching options.
  * @returns Every matching widget, or an empty array when none match.
  */
-export const queryAllByLabelText = (container, text, options) => {
+function queryAllByLabelText(container, text, options) {
     const results = new Set();
     for (const widget of traverse(container)) {
-        const mnemonicTarget = collectMnemonicMatch(widget, text, options);
-        if (mnemonicTarget)
-            results.add(mnemonicTarget);
-        const ownLabel = getWidgetOwnLabel(widget);
-        if (ownLabel !== null && matchText(ownLabel, text, widget, options))
-            results.add(widget);
-        const labelledByText = getWidgetLabelledByText(widget);
-        if (labelledByText !== null && matchText(labelledByText, text, widget, options))
-            results.add(widget);
+        collectLabelMatches(results, widget, text, options);
     }
-    return [...results];
-};
-const labelTextQueries = nameQueryFamily("LabelText", queryAllByLabelText, buildQueries("LabelText", queryAllByLabelText, (container, matches, text) => multipleFoundError(container, { queryType: "labelText", text }, matches), (container, text) => notFoundError(container, { queryType: "labelText", text })));
+    return [...results].filter((widget) => isMatchingWidgetType(widget, options));
+}
 /**
  * Finds every widget whose rendered text content matches.
  * @param container Widget subtree to search.
@@ -166,8 +298,9 @@ const labelTextQueries = nameQueryFamily("LabelText", queryAllByLabelText, build
  * @param options Text matching options.
  * @returns Every matching widget, or an empty array when none match.
  */
-export const queryAllByText = (container, text, options) => findAll(container, (widget) => matchText(getWidgetLabelText(widget), text, widget, options));
-const textQueries = nameQueryFamily("Text", queryAllByText, buildQueries("Text", queryAllByText, (container, matches, text) => multipleFoundError(container, { queryType: "text", text }, matches), (container, text) => notFoundError(container, { queryType: "text", text })));
+function queryAllByText(container, text, options) {
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetLabelText(widget), text, widget, options));
+}
 /**
  * Finds every widget whose widget name matches.
  * @param container Widget subtree to search.
@@ -175,8 +308,9 @@ const textQueries = nameQueryFamily("Text", queryAllByText, buildQueries("Text",
  * @param options Text matching options.
  * @returns Every matching widget, or an empty array when none match.
  */
-export const queryAllByName = (container, name, options) => findAll(container, (widget) => matchText(getWidgetName(widget), name, widget, options));
-const nameQueries = nameQueryFamily("Name", queryAllByName, buildQueries("Name", queryAllByName, (container, matches, name) => multipleFoundError(container, { queryType: "name", name }, matches), (container, name) => notFoundError(container, { queryType: "name", name })));
+function queryAllByName(container, name, options) {
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetName(widget), name, widget, options));
+}
 /**
  * Finds every widget whose placeholder text matches.
  * @param container Widget subtree to search.
@@ -184,8 +318,10 @@ const nameQueries = nameQueryFamily("Name", queryAllByName, buildQueries("Name",
  * @param options Text matching options.
  * @returns Every matching widget, or an empty array when none match.
  */
-export const queryAllByPlaceholderText = (container, text, options) => findAll(container, (widget) => matchText(getWidgetPlaceholderText(widget), text, widget, options));
-const placeholderTextQueries = nameQueryFamily("PlaceholderText", queryAllByPlaceholderText, buildQueries("PlaceholderText", queryAllByPlaceholderText, (container, matches, text) => multipleFoundError(container, { queryType: "placeholderText", text }, matches), (container, text) => notFoundError(container, { queryType: "placeholderText", text })));
+function queryAllByPlaceholderText(container, text, options) {
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) &&
+        isTextMatch(getWidgetPlaceholderText(widget), text, widget, options));
+}
 /**
  * Finds every widget whose current display value matches.
  * @param container Widget subtree to search.
@@ -193,74 +329,9 @@ const placeholderTextQueries = nameQueryFamily("PlaceholderText", queryAllByPlac
  * @param options Text matching options.
  * @returns Every matching widget, or an empty array when none match.
  */
-export const queryAllByDisplayValue = (container, value, options) => findAll(container, (widget) => matchText(getWidgetDisplayValue(widget), value, widget, options));
-const displayValueQueries = nameQueryFamily("DisplayValue", queryAllByDisplayValue, buildQueries("DisplayValue", queryAllByDisplayValue, (container, matches, value) => multipleFoundError(container, { queryType: "displayValue", value }, matches), (container, value) => notFoundError(container, { queryType: "displayValue", value })));
-export const builtinQueries = {
-    ...roleQueries,
-    ...labelTextQueries,
-    ...textQueries,
-    ...nameQueries,
-    ...placeholderTextQueries,
-    ...displayValueQueries,
-};
-/** Returns the single widget with a matching accessible role and options, or null when none match. Throws when more than one matches. */
-export const queryByRole = roleQueries.queryByRole;
-/** Returns every widget with a matching accessible role and options. Throws when none match. */
-export const getAllByRole = roleQueries.getAllByRole;
-/** Returns the single widget with a matching accessible role and options. Throws when none or more than one matches. */
-export const getByRole = roleQueries.getByRole;
-/** Waits for and returns every widget with a matching accessible role and options, retrying until at least one appears or the timeout elapses. */
-export const findAllByRole = roleQueries.findAllByRole;
-/** Waits for and returns the single widget with a matching accessible role and options, retrying until it appears or the timeout elapses. Rejects when none or more than one matches. */
-export const findByRole = roleQueries.findByRole;
-/** Returns the single widget with matching associated label text, or null when none match. Throws when more than one matches. */
-export const queryByLabelText = labelTextQueries.queryByLabelText;
-/** Returns every widget with matching associated label text. Throws when none match. */
-export const getAllByLabelText = labelTextQueries.getAllByLabelText;
-/** Returns the single widget with matching associated label text. Throws when none or more than one matches. */
-export const getByLabelText = labelTextQueries.getByLabelText;
-/** Waits for and returns every widget with matching associated label text, retrying until at least one appears or the timeout elapses. */
-export const findAllByLabelText = labelTextQueries.findAllByLabelText;
-/** Waits for and returns the single widget with matching associated label text, retrying until it appears or the timeout elapses. Rejects when none or more than one matches. */
-export const findByLabelText = labelTextQueries.findByLabelText;
-/** Returns the single widget with matching rendered text content, or null when none match. Throws when more than one matches. */
-export const queryByText = textQueries.queryByText;
-/** Returns every widget with matching rendered text content. Throws when none match. */
-export const getAllByText = textQueries.getAllByText;
-/** Returns the single widget with matching rendered text content. Throws when none or more than one matches. */
-export const getByText = textQueries.getByText;
-/** Waits for and returns every widget with matching rendered text content, retrying until at least one appears or the timeout elapses. */
-export const findAllByText = textQueries.findAllByText;
-/** Waits for and returns the single widget with matching rendered text content, retrying until it appears or the timeout elapses. Rejects when none or more than one matches. */
-export const findByText = textQueries.findByText;
-/** Returns the single widget with a matching widget name, or null when none match. Throws when more than one matches. */
-export const queryByName = nameQueries.queryByName;
-/** Returns every widget with a matching widget name. Throws when none match. */
-export const getAllByName = nameQueries.getAllByName;
-/** Returns the single widget with a matching widget name. Throws when none or more than one matches. */
-export const getByName = nameQueries.getByName;
-/** Waits for and returns every widget with a matching widget name, retrying until at least one appears or the timeout elapses. */
-export const findAllByName = nameQueries.findAllByName;
-/** Waits for and returns the single widget with a matching widget name, retrying until it appears or the timeout elapses. Rejects when none or more than one matches. */
-export const findByName = nameQueries.findByName;
-/** Returns the single widget with matching placeholder text, or null when none match. Throws when more than one matches. */
-export const queryByPlaceholderText = placeholderTextQueries.queryByPlaceholderText;
-/** Returns every widget with matching placeholder text. Throws when none match. */
-export const getAllByPlaceholderText = placeholderTextQueries.getAllByPlaceholderText;
-/** Returns the single widget with matching placeholder text. Throws when none or more than one matches. */
-export const getByPlaceholderText = placeholderTextQueries.getByPlaceholderText;
-/** Waits for and returns every widget with matching placeholder text, retrying until at least one appears or the timeout elapses. */
-export const findAllByPlaceholderText = placeholderTextQueries.findAllByPlaceholderText;
-/** Waits for and returns the single widget with matching placeholder text, retrying until it appears or the timeout elapses. Rejects when none or more than one matches. */
-export const findByPlaceholderText = placeholderTextQueries.findByPlaceholderText;
-/** Returns the single widget with a matching display value, or null when none match. Throws when more than one matches. */
-export const queryByDisplayValue = displayValueQueries.queryByDisplayValue;
-/** Returns every widget with a matching display value. Throws when none match. */
-export const getAllByDisplayValue = displayValueQueries.getAllByDisplayValue;
-/** Returns the single widget with a matching display value. Throws when none or more than one matches. */
-export const getByDisplayValue = displayValueQueries.getByDisplayValue;
-/** Waits for and returns every widget with a matching display value, retrying until at least one appears or the timeout elapses. */
-export const findAllByDisplayValue = displayValueQueries.findAllByDisplayValue;
-/** Waits for and returns the single widget with a matching display value, retrying until it appears or the timeout elapses. Rejects when none or more than one matches. */
-export const findByDisplayValue = displayValueQueries.findByDisplayValue;
+function queryAllByDisplayValue(container, value, options) {
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) &&
+        isTextMatch(getWidgetDisplayValue(widget), value, widget, options));
+}
+export { builtinQueries, queryByRole, getAllByRole, getByRole, findAllByRole, findByRole, queryByLabelText, getAllByLabelText, getByLabelText, findAllByLabelText, findByLabelText, queryByText, getAllByText, getByText, findAllByText, findByText, queryByName, getAllByName, getByName, findAllByName, findByName, queryByPlaceholderText, getAllByPlaceholderText, getByPlaceholderText, findAllByPlaceholderText, findByPlaceholderText, queryByDisplayValue, getAllByDisplayValue, getByDisplayValue, findAllByDisplayValue, findByDisplayValue, queryAllByRole, queryAllByLabelText, queryAllByText, queryAllByName, queryAllByPlaceholderText, queryAllByDisplayValue, };
 //# sourceMappingURL=queries.js.map