@gtkx/testing 1.0.0-rc.3 → 1.0.0

package/dist/matchers.d.ts

@@ -1,4 +1,7 @@
+import type { SyncExpectationResult } from "@vitest/expect";
 import * as Gtk from "@gtkx/gi/gtk";
+import type { ByRoleOptions, Matcher, MatcherOptions } from "./types.js";
+import { type AccessibleAttributeValue } from "./accessible-native.js";
 /** The expected value for a text matcher: an exact string or a regular expression. */
 type TextExpectation = string | RegExp;
 /** Options controlling how `toHaveTextContent` normalizes the text it reads. */
@@ -11,72 +14,136 @@ type TextContentOptions = {
 };
 /** The expected value for a style class: an exact class name or a regular expression. */
 type ClassExpectation = string | RegExp;
-type MatcherResult = {
-    pass: boolean;
-    message: () => string;
-};
+/** The outcome of a matcher: whether it passed, and the failure text built on demand. */
+type MatcherResult = Pick<SyncExpectationResult, "message" | "pass">;
+/** The matcher state bound as `this`, supplying the test runner's deep equality check. */
 type MatcherContext = {
+    /** Compares a received value against an expected one, resolving asymmetric matchers. */
     equals: (actual: unknown, expected: unknown) => boolean;
 };
+/** Compares text read from the received widget; with no expected value, asserts the text is non-empty. */
 type TextMatcher = (received: unknown, expected?: TextExpectation) => MatcherResult;
+/** Asserts a single state of the received widget, taking no expected value. */
 type StateMatcher = (received: unknown) => MatcherResult;
+/** Trailing arguments of the `ByRole` query family, as a containment matcher takes them. */
+type RoleQueryArgs = [role: Gtk.AccessibleRole, options?: ByRoleOptions];
+/** Trailing arguments of the text-based query families, as a containment matcher takes them. */
+type TextQueryArgs = [text: Matcher, options?: MatcherOptions];
+/** Counts the descendants a query family finds under the received widget. */
+type ContainmentMatcher<Args extends unknown[]> = (received: unknown, ...args: Args) => MatcherResult;
+type BooleanAccessibleState = Gtk.AccessibleState.BUSY | Gtk.AccessibleState.DISABLED | Gtk.AccessibleState.EXPANDED | Gtk.AccessibleState.HIDDEN | Gtk.AccessibleState.SELECTED | Gtk.AccessibleState.VISITED;
+type TristateAccessibleState = Gtk.AccessibleState.CHECKED | Gtk.AccessibleState.PRESSED;
+type StringAccessibleProperty = Gtk.AccessibleProperty.DESCRIPTION | Gtk.AccessibleProperty.HELP_TEXT | Gtk.AccessibleProperty.KEY_SHORTCUTS | Gtk.AccessibleProperty.LABEL | Gtk.AccessibleProperty.PLACEHOLDER | Gtk.AccessibleProperty.ROLE_DESCRIPTION | Gtk.AccessibleProperty.VALUE_TEXT;
+type BooleanAccessibleProperty = Gtk.AccessibleProperty.HAS_POPUP | Gtk.AccessibleProperty.MODAL | Gtk.AccessibleProperty.MULTI_LINE | Gtk.AccessibleProperty.MULTI_SELECTABLE | Gtk.AccessibleProperty.READ_ONLY | Gtk.AccessibleProperty.REQUIRED;
+type NumberAccessibleProperty = Gtk.AccessibleProperty.LEVEL | Gtk.AccessibleProperty.VALUE_MAX | Gtk.AccessibleProperty.VALUE_MIN | Gtk.AccessibleProperty.VALUE_NOW;
+/** A text matcher that also takes normalization options for the text it reads. */
 type TextContentMatcher = (received: unknown, expected?: TextExpectation, options?: TextContentOptions) => MatcherResult;
+/** Signatures of the widget assertion matchers, keyed by the name each is registered under. */
 type MatcherImplementations = {
+    /** Asserts the text an editable widget or combo box shows; with no argument, that it is not empty. */
     toHaveDisplayValue: TextMatcher;
+    /** Asserts the widget's own text, or its descendants' when it has none, contains or matches the expectation. */
     toHaveTextContent: TextContentMatcher;
+    /** Asserts the widget's accessible name; with no argument, that it has one. */
     toHaveAccessibleName: TextMatcher;
+    /**
+     * Asserts the joined accessible names of the widget's `described-by` targets, falling back to its
+     * `description` and then to its tooltip.
+     */
     toHaveAccessibleDescription: TextMatcher;
+    /** Asserts the joined accessible names of the widget's `error-message` targets, read only while it is invalid. */
     toHaveAccessibleErrorMessage: TextMatcher;
-    toHavePlaceholderText: TextMatcher;
+    /** Asserts the text currently selected in an editable widget. */
     toHaveSelection: TextMatcher;
+    /**
+     * Asserts an accessible state GTK holds for the widget, taking the value type that state carries.
+     * With no expected value, asserts only that the state is set to something determinate.
+     */
+    toHaveAccessibleState: (received: unknown, state: Gtk.AccessibleState, expected?: boolean | number) => MatcherResult;
+    /**
+     * Asserts an accessible property GTK holds for the widget, taking the value type that property
+     * carries. With no expected value, asserts only that the property is set. Numeric properties
+     * compare the way `toHaveValue` and the `value` option of the `ByRole` queries do, within 0.001.
+     */
+    toHaveAccessibleProperty: (received: unknown, property: Gtk.AccessibleProperty, expected?: AccessibleAttributeValue) => MatcherResult;
+    /** Asserts the widget's checked state is checked rather than unchecked or mixed. */
     toBeChecked: StateMatcher;
+    /** Asserts the widget's checked state is mixed. */
     toBePartiallyChecked: StateMatcher;
+    /** Asserts a `Gtk.ToggleButton` is active, and throws for any other widget. */
     toBePressed: StateMatcher;
-    toBeExpanded: StateMatcher;
-    toBeSelected: StateMatcher;
+    /** Asserts the widget's accessible pressed state is mixed, and throws when it exposes none. */
+    toBePartiallyPressed: StateMatcher;
+    /** Asserts the widget is insensitive, or sits inside an insensitive ancestor. */
     toBeDisabled: StateMatcher;
+    /** Asserts the widget and all of its ancestors are sensitive. */
     toBeEnabled: StateMatcher;
+    /** Asserts the widget and its ancestors are all visible, and that none of them is fully transparent. */
     toBeVisible: StateMatcher;
+    /** Asserts the widget's root is a window that is still in the toplevel list. */
     toBeRooted: StateMatcher;
-    toBeEmpty: StateMatcher;
+    /** Asserts the widget has neither a child nor label text. */
+    toBeEmptyWidget: StateMatcher;
+    /** Asserts the widget's accessible invalid state is set to anything other than false. */
     toBeInvalid: StateMatcher;
+    /** Asserts the widget's accessible invalid state is unset or false. */
     toBeValid: StateMatcher;
+    /** Asserts the widget's accessible required state. */
     toBeRequired: StateMatcher;
+    /** Asserts the widget holds the platform focus state. */
     toHaveFocus: StateMatcher;
+    /**
+     * Asserts a widget's numeric value, or its display value when a string is given.
+     *
+     * Numbers come from the accessibility tree, which GTK keeps to a resolution of 0.001: it drops an
+     * update whose value is nearer than that to the one already published, so a widget that moves by
+     * less keeps its previous value. Numbers therefore match within 0.001, the same tolerance the
+     * `value` option of the `ByRole` queries and `toHaveAccessibleProperty` apply. That option reads
+     * the same tree, where the maximum of a paged widget such as a scrollbar is the last value it can
+     * reach, its adjustment's upper bound less one page.
+     */
     toHaveValue: (received: unknown, expected?: number | string) => MatcherResult;
+    /** Asserts the widget's accessible role. */
     toHaveRole: (received: unknown, expected: Gtk.AccessibleRole) => MatcherResult;
+    /** Asserts the widget is, or is an ancestor of, the given widget. */
     toContainElement: (received: unknown, descendant: Gtk.Widget | null) => MatcherResult;
+    /** Asserts the widget comes before the given widget in the widget tree, neither containing the other. */
+    toAppearBefore: (received: unknown, other: Gtk.Widget) => MatcherResult;
+    /** Asserts the widget comes after the given widget in the widget tree, neither containing the other. */
+    toAppearAfter: (received: unknown, other: Gtk.Widget) => MatcherResult;
+    /** Asserts at least one widget under the received one matches the `ByRole` query. */
+    toContainAnyByRole: ContainmentMatcher<RoleQueryArgs>;
+    /** Asserts exactly one widget under the received one matches the `ByRole` query. */
+    toContainOneByRole: ContainmentMatcher<RoleQueryArgs>;
+    /** Asserts at least one widget under the received one matches the `ByText` query. */
+    toContainAnyByText: ContainmentMatcher<TextQueryArgs>;
+    /** Asserts exactly one widget under the received one matches the `ByText` query. */
+    toContainOneByText: ContainmentMatcher<TextQueryArgs>;
+    /** Asserts at least one widget under the received one matches the `ByLabelText` query. */
+    toContainAnyByLabelText: ContainmentMatcher<TextQueryArgs>;
+    /** Asserts exactly one widget under the received one matches the `ByLabelText` query. */
+    toContainOneByLabelText: ContainmentMatcher<TextQueryArgs>;
+    /** Asserts at least one widget under the received one matches the `ByPlaceholderText` query. */
+    toContainAnyByPlaceholderText: ContainmentMatcher<TextQueryArgs>;
+    /** Asserts exactly one widget under the received one matches the `ByPlaceholderText` query. */
+    toContainOneByPlaceholderText: ContainmentMatcher<TextQueryArgs>;
+    /** Asserts at least one widget under the received one matches the `ByDisplayValue` query. */
+    toContainAnyByDisplayValue: ContainmentMatcher<TextQueryArgs>;
+    /** Asserts exactly one widget under the received one matches the `ByDisplayValue` query. */
+    toContainOneByDisplayValue: ContainmentMatcher<TextQueryArgs>;
+    /**
+     * Asserts the widget carries every given style class, each a name, a space-separated list, or a pattern.
+     * Pass `{ exact: true }` last to require exactly that set, which rules out patterns.
+     */
     toHaveClass: (received: unknown, ...args: unknown[]) => MatcherResult;
+    /**
+     * Asserts a GObject property, named as in GObject and looked up by its camel-cased accessor, equals the
+     * expected value. With no expected value, asserts the property is set. GObject values compare by identity.
+     */
     toHaveObjectProperty: (this: MatcherContext, received: unknown, ...args: unknown[]) => MatcherResult;
 };
-declare const toHaveAccessibleName: TextMatcher;
-declare const toHaveAccessibleDescription: TextMatcher;
-declare const toHaveAccessibleErrorMessage: TextMatcher;
-declare const toHavePlaceholderText: TextMatcher;
-declare const toHaveSelection: TextMatcher;
-declare const toBePressed: StateMatcher;
-declare const toBeExpanded: StateMatcher;
-declare const toBeSelected: StateMatcher;
-declare const toBeRequired: StateMatcher;
 /** The widget assertion matchers keyed by name, suitable for passing to `expect.extend`. */
 declare const matchers: MatcherImplementations;
-declare function toHaveTextContent(received: unknown, expected?: TextExpectation, options?: TextContentOptions): MatcherResult;
-declare function toBeChecked(received: unknown): MatcherResult;
-declare function toBePartiallyChecked(received: unknown): MatcherResult;
-declare function toHaveDisplayValue(received: unknown, expected?: TextExpectation): MatcherResult;
-declare function toHaveValue(received: unknown, expected?: number | string): MatcherResult;
-declare function toBeDisabled(received: unknown): MatcherResult;
-declare function toBeEnabled(received: unknown): MatcherResult;
-declare function toBeVisible(received: unknown): MatcherResult;
-declare function toBeRooted(received: unknown): MatcherResult;
-declare function toBeEmpty(received: unknown): MatcherResult;
-declare function toBeInvalid(received: unknown): MatcherResult;
-declare function toBeValid(received: unknown): MatcherResult;
-declare function toHaveFocus(received: unknown): MatcherResult;
-declare function toHaveRole(received: unknown, expected: Gtk.AccessibleRole): MatcherResult;
-declare function toContainElement(received: unknown, descendant: Gtk.Widget | null): MatcherResult;
-declare function toHaveClass(received: unknown, ...args: unknown[]): MatcherResult;
-declare function toHaveObjectProperty(this: MatcherContext, received: unknown, ...args: unknown[]): MatcherResult;
 /** Registers the widget matchers on the global `expect`, when one is available. Safe to call more than once. */
 declare const registerMatchers: () => void;
 declare module "@vitest/expect" {
@@ -86,18 +153,25 @@ declare module "@vitest/expect" {
         toHaveAccessibleName(expected?: TextExpectation): void;
         toHaveAccessibleDescription(expected?: TextExpectation): void;
         toHaveAccessibleErrorMessage(expected?: TextExpectation): void;
-        toHavePlaceholderText(expected?: TextExpectation): void;
         toHaveSelection(expected?: TextExpectation): void;
+        toHaveAccessibleState(state: BooleanAccessibleState, expected?: boolean): void;
+        toHaveAccessibleState(state: TristateAccessibleState, expected?: Gtk.AccessibleTristate): void;
+        toHaveAccessibleState(state: Gtk.AccessibleState.INVALID, expected?: Gtk.AccessibleInvalidState): void;
+        toHaveAccessibleProperty(property: StringAccessibleProperty, expected?: string): void;
+        toHaveAccessibleProperty(property: BooleanAccessibleProperty, expected?: boolean): void;
+        toHaveAccessibleProperty(property: NumberAccessibleProperty, expected?: number): void;
+        toHaveAccessibleProperty(property: Gtk.AccessibleProperty.AUTOCOMPLETE, expected?: Gtk.AccessibleAutocomplete): void;
+        toHaveAccessibleProperty(property: Gtk.AccessibleProperty.ORIENTATION, expected?: Gtk.Orientation): void;
+        toHaveAccessibleProperty(property: Gtk.AccessibleProperty.SORT, expected?: Gtk.AccessibleSort): void;
         toBeChecked(): void;
         toBePartiallyChecked(): void;
         toBePressed(): void;
-        toBeExpanded(): void;
-        toBeSelected(): void;
+        toBePartiallyPressed(): void;
         toBeDisabled(): void;
         toBeEnabled(): void;
         toBeVisible(): void;
         toBeRooted(): void;
-        toBeEmpty(): void;
+        toBeEmptyWidget(): void;
         toBeInvalid(): void;
         toBeValid(): void;
         toBeRequired(): void;
@@ -105,6 +179,18 @@ declare module "@vitest/expect" {
         toHaveValue(expected?: number | string): void;
         toHaveRole(expected: Gtk.AccessibleRole): void;
         toContainElement(descendant: Gtk.Widget | null): void;
+        toAppearBefore(other: Gtk.Widget): void;
+        toAppearAfter(other: Gtk.Widget): void;
+        toContainAnyByRole(...args: RoleQueryArgs): void;
+        toContainOneByRole(...args: RoleQueryArgs): void;
+        toContainAnyByText(...args: TextQueryArgs): void;
+        toContainOneByText(...args: TextQueryArgs): void;
+        toContainAnyByLabelText(...args: TextQueryArgs): void;
+        toContainOneByLabelText(...args: TextQueryArgs): void;
+        toContainAnyByPlaceholderText(...args: TextQueryArgs): void;
+        toContainOneByPlaceholderText(...args: TextQueryArgs): void;
+        toContainAnyByDisplayValue(...args: TextQueryArgs): void;
+        toContainOneByDisplayValue(...args: TextQueryArgs): void;
         toHaveClass(...args: (ClassExpectation | {
             exact: boolean;
         })[]): void;
@@ -115,5 +201,5 @@ declare module "@vitest/expect" {
     interface AsymmetricMatchersContaining extends WidgetMatchers {
     }
 }
-export { toHaveDisplayValue, toHaveTextContent, toHaveAccessibleName, toHaveAccessibleDescription, toHaveAccessibleErrorMessage, toHavePlaceholderText, toHaveSelection, toBeChecked, toBePartiallyChecked, toBePressed, toBeExpanded, toBeSelected, toBeDisabled, toBeEnabled, toBeVisible, toBeRooted, toBeEmpty, toBeInvalid, toBeValid, toBeRequired, toHaveFocus, toHaveValue, toHaveRole, toContainElement, toHaveClass, toHaveObjectProperty, matchers, registerMatchers, type ClassExpectation, type TextContentOptions, type TextExpectation, };
+export { matchers, registerMatchers, type ClassExpectation, type TextContentOptions, type TextExpectation };
 //# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

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

package/dist/matchers.js

@@ -1,20 +1,31 @@
-/// <reference types="@vitest/expect" />
 import * as GObject from "@gtkx/gi/gobject";
 import * as Gtk from "@gtkx/gi/gtk";
+import { ACCESSIBLE_NUMBER_TOLERANCE, isAccessibleNumberMatch, isAccessibleNumberProperty, readAccessibleProperty, readAccessibleState, } from "./accessible-native.js";
 import { getDefaultNormalizer } from "./normalize.js";
+import { queryAllByDisplayValue, queryAllByLabelText, queryAllByPlaceholderText, queryAllByRole, queryAllByText, } from "./queries.js";
 import { formatRole } from "./role-helpers.js";
-import { getWidgetAccessibleName, getWidgetCheckedState, getWidgetDescribedByText, getWidgetDisplayValue, getWidgetErrorMessage, getWidgetExpandedState, getWidgetInvalidState, getWidgetLabelText, getWidgetPlaceholderText, getWidgetPressedState, getWidgetRequiredState, getWidgetSelectedState, getWidgetSelection, getWidgetTextContent, getWidgetValue, hasDisplayValue, isWidgetDisabled, isWidgetVisible, } from "./widget-accessible-properties.js";
+import { descendants } from "./traversal.js";
+import { getWidgetAccessibleName, getWidgetCheckedState, getWidgetDescribedByText, getWidgetDisplayValue, getWidgetErrorMessage, getWidgetInvalidState, getWidgetLabelText, getWidgetPressedState, getWidgetRequiredState, getWidgetSelection, getWidgetTextContent, getWidgetValueNow, hasDisplayValue, isWidgetDisabled, isWidgetValueMatch, isWidgetVisible, } from "./widget-accessible-properties.js";
 const registration = { isRegistered: false };
+const MIXED_TRISTATE = Gtk.AccessibleTristate.MIXED;
+const ROUNDED_READING = ", which the accessibility tree rounds to six significant digits";
 const displayValueMatcher = textMatcher("toHaveDisplayValue", getWidgetDisplayValue, "exact");
 const toHaveAccessibleName = textMatcher("toHaveAccessibleName", getWidgetAccessibleName, "exact");
 const toHaveAccessibleDescription = textMatcher("toHaveAccessibleDescription", getWidgetDescribedByText, "exact");
 const toHaveAccessibleErrorMessage = textMatcher("toHaveAccessibleErrorMessage", readErrorMessageText, "exact");
-const toHavePlaceholderText = textMatcher("toHavePlaceholderText", getWidgetPlaceholderText, "exact");
 const toHaveSelection = textMatcher("toHaveSelection", getWidgetSelection, "exact");
 const toBePressed = booleanStateMatcher("toBePressed", "pressed", getWidgetPressedState);
-const toBeExpanded = booleanStateMatcher("toBeExpanded", "expanded", getWidgetExpandedState);
-const toBeSelected = booleanStateMatcher("toBeSelected", "selected", getWidgetSelectedState);
 const toBeRequired = booleanStateMatcher("toBeRequired", "required", getWidgetRequiredState);
+const toContainAnyByRole = containmentMatcher("toContainAnyByRole", false, queryAllByRole);
+const toContainOneByRole = containmentMatcher("toContainOneByRole", true, queryAllByRole);
+const toContainAnyByText = containmentMatcher("toContainAnyByText", false, queryAllByText);
+const toContainOneByText = containmentMatcher("toContainOneByText", true, queryAllByText);
+const toContainAnyByLabelText = containmentMatcher("toContainAnyByLabelText", false, queryAllByLabelText);
+const toContainOneByLabelText = containmentMatcher("toContainOneByLabelText", true, queryAllByLabelText);
+const toContainAnyByPlaceholderText = containmentMatcher("toContainAnyByPlaceholderText", false, queryAllByPlaceholderText);
+const toContainOneByPlaceholderText = containmentMatcher("toContainOneByPlaceholderText", true, queryAllByPlaceholderText);
+const toContainAnyByDisplayValue = containmentMatcher("toContainAnyByDisplayValue", false, queryAllByDisplayValue);
+const toContainOneByDisplayValue = containmentMatcher("toContainOneByDisplayValue", true, queryAllByDisplayValue);
 /** The widget assertion matchers keyed by name, suitable for passing to `expect.extend`. */
 const matchers = {
     toHaveDisplayValue,
@@ -22,18 +33,18 @@ const matchers = {
     toHaveAccessibleName,
     toHaveAccessibleDescription,
     toHaveAccessibleErrorMessage,
-    toHavePlaceholderText,
     toHaveSelection,
+    toHaveAccessibleState,
+    toHaveAccessibleProperty,
     toBeChecked,
     toBePartiallyChecked,
     toBePressed,
-    toBeExpanded,
-    toBeSelected,
+    toBePartiallyPressed,
     toBeDisabled,
     toBeEnabled,
     toBeVisible,
     toBeRooted,
-    toBeEmpty,
+    toBeEmptyWidget,
     toBeInvalid,
     toBeValid,
     toBeRequired,
@@ -41,6 +52,18 @@ const matchers = {
     toHaveValue,
     toHaveRole,
     toContainElement,
+    toAppearBefore,
+    toAppearAfter,
+    toContainAnyByRole,
+    toContainOneByRole,
+    toContainAnyByText,
+    toContainOneByText,
+    toContainAnyByLabelText,
+    toContainOneByLabelText,
+    toContainAnyByPlaceholderText,
+    toContainOneByPlaceholderText,
+    toContainAnyByDisplayValue,
+    toContainOneByDisplayValue,
     toHaveClass,
     toHaveObjectProperty,
 };
@@ -88,6 +111,51 @@ const stateResult = (widget, stateName, isPass) => ({
     pass: isPass,
     message: () => `expected widget ${negationPrefix(isPass)}to be ${stateName}\n${describeWidget(widget)}`,
 });
+const describeAttributeValue = (value) => value === null ? "unset" : JSON.stringify(value);
+const attributeSetResult = (widget, label, actual) => {
+    const isSet = actual !== null;
+    return {
+        pass: isSet,
+        message: () => `expected widget ${negationPrefix(isSet)}to have ${label} set\n${describeWidget(widget)}`,
+    };
+};
+const describeReading = (expectation) => `${describeAttributeValue(expectation.actual)}${expectation.isReadingRounded ? ROUNDED_READING : ""}`;
+const attributeValueResult = (widget, expectation) => ({
+    pass: expectation.isPass,
+    message: () => `expected widget ${negationPrefix(expectation.isPass)}to have ${expectation.label} ` +
+        `${expectation.comparison} ${describeAttributeValue(expectation.expected)}, but received ` +
+        `${describeReading(expectation)}\n${describeWidget(widget)}`,
+});
+const orderResult = (widget, other, position, isPass) => ({
+    pass: isPass,
+    message: () => `expected widget ${negationPrefix(isPass)}to appear ${position} ${describeWidget(other)} ` +
+        `in the widget tree\n${describeWidget(widget)}`,
+});
+const getTreeRoot = (widget) => {
+    let root = widget;
+    let parent = root.getParent();
+    while (parent) {
+        root = parent;
+        parent = root.getParent();
+    }
+    return root;
+};
+const isSeparateWidget = (first, second) => first !== second && !first.isAncestor(second) && !second.isAncestor(first);
+const isPrecedingWidget = (root, first, second) => {
+    for (const widget of descendants(root)) {
+        if (widget === first) {
+            return true;
+        }
+        if (widget === second) {
+            return false;
+        }
+    }
+    return false;
+};
+const isAppearingBefore = (first, second) => {
+    const root = getTreeRoot(first);
+    return isSeparateWidget(first, second) && root === getTreeRoot(second) && isPrecedingWidget(root, first, second);
+};
 const camelCase = (name) => name.replaceAll(/-([a-z])/g, (_match, letter) => letter.toUpperCase());
 const isAsymmetricMatcher = (value) => typeof value === "object" && value !== null && typeof Reflect.get(value, "asymmetricMatch") === "function";
 const isEqualValue = (context, actual, expected) => {
@@ -206,6 +274,77 @@ function booleanStateMatcher(matcherName, stateName, read) {
         return stateResult(widget, stateName, state);
     };
 }
+function containmentMatcher(matcherName, isSingle, queryAll) {
+    const quantity = isSingle ? "exactly one widget" : "any widget";
+    return (received, ...args) => {
+        const widget = asWidget(received, matcherName);
+        const matches = queryAll(widget, ...args);
+        const isPass = isSingle ? matches.length === 1 : matches.length > 0;
+        return {
+            pass: isPass,
+            message: () => `expected widget ${negationPrefix(isPass)}to contain ${quantity} matching ${matcherName}, ` +
+                `but found ${String(matches.length)}\n${describeWidget(widget)}`,
+        };
+    };
+}
+function toHaveAccessibleState(received, state, expected) {
+    const widget = asWidget(received, "toHaveAccessibleState");
+    const actual = readAccessibleState(widget, state);
+    const label = `accessible state ${Gtk.AccessibleState[state]}`;
+    if (expected === undefined) {
+        return attributeSetResult(widget, label, actual);
+    }
+    const wanted = typeof expected === "boolean" ? Number(expected) : expected;
+    return attributeValueResult(widget, {
+        label,
+        comparison: "equal to",
+        expected: wanted,
+        actual,
+        isPass: actual === wanted,
+        isReadingRounded: false,
+    });
+}
+const propertyLabel = (property) => `accessible property ${Gtk.AccessibleProperty[property]}`;
+const propertyExpectation = (widget, property, expected, actual) => {
+    const label = propertyLabel(property);
+    if (typeof expected === "number" && isAccessibleNumberProperty(property)) {
+        return {
+            label,
+            comparison: `within ${String(ACCESSIBLE_NUMBER_TOLERANCE)} of`,
+            expected,
+            actual,
+            isPass: isAccessibleNumberMatch(widget, property, expected),
+            isReadingRounded: actual !== null,
+        };
+    }
+    return { label, comparison: "equal to", expected, actual, isPass: actual === expected, isReadingRounded: false };
+};
+function toHaveAccessibleProperty(received, property, expected) {
+    const widget = asWidget(received, "toHaveAccessibleProperty");
+    const actual = readAccessibleProperty(widget, property);
+    if (expected === undefined) {
+        return attributeSetResult(widget, propertyLabel(property), actual);
+    }
+    return attributeValueResult(widget, propertyExpectation(widget, property, expected, actual));
+}
+function toBePartiallyPressed(received) {
+    const widget = asWidget(received, "toBePartiallyPressed");
+    const state = readAccessibleState(widget, Gtk.AccessibleState.PRESSED);
+    if (state === null) {
+        throw notApplicable("toBePartiallyPressed", "pressed state", widget);
+    }
+    return stateResult(widget, "partially pressed", state === MIXED_TRISTATE);
+}
+function toAppearBefore(received, other) {
+    const widget = asWidget(received, "toAppearBefore");
+    const target = asWidget(other, "toAppearBefore");
+    return orderResult(widget, target, "before", isAppearingBefore(widget, target));
+}
+function toAppearAfter(received, other) {
+    const widget = asWidget(received, "toAppearAfter");
+    const target = asWidget(other, "toAppearAfter");
+    return orderResult(widget, target, "after", isAppearingBefore(target, widget));
+}
 function readCheckedState(widget, matcherName) {
     const state = getWidgetCheckedState(widget);
     if (state === null) {
@@ -228,20 +367,21 @@ function toHaveDisplayValue(received, expected) {
     }
     return displayValueMatcher(received, expected);
 }
+const describeValueExpectation = (expected) => expected === undefined ? "set" : `within ${String(ACCESSIBLE_NUMBER_TOLERANCE)} of ${String(expected)}`;
 function toHaveValue(received, expected) {
     const widget = asWidget(received, "toHaveValue");
     if (typeof expected === "string") {
         return displayValueMatcher(received, expected);
     }
-    const actual = getWidgetValue(widget).now;
+    const actual = getWidgetValueNow(widget);
     if (actual === null) {
         throw notApplicable("toHaveValue", "numeric value", widget);
     }
-    const isPass = expected === undefined || actual === expected;
+    const isPass = expected === undefined || isWidgetValueMatch(widget, "now", expected);
     return {
         pass: isPass,
-        message: () => `expected widget ${negationPrefix(isPass)}to have value ${String(expected)}, ` +
-            `but received ${String(actual)}\n${describeWidget(widget)}`,
+        message: () => `expected widget ${negationPrefix(isPass)}to have value ${describeValueExpectation(expected)}, ` +
+            `but received ${String(actual)}${ROUNDED_READING}\n${describeWidget(widget)}`,
     };
 }
 function toBeDisabled(received) {
@@ -263,8 +403,8 @@ function toBeRooted(received) {
     const widget = asWidget(received, "toBeRooted");
     return stateResult(widget, "rooted in a window", isWidgetRooted(widget));
 }
-function toBeEmpty(received) {
-    const widget = asWidget(received, "toBeEmpty");
+function toBeEmptyWidget(received) {
+    const widget = asWidget(received, "toBeEmptyWidget");
     return stateResult(widget, "empty", widget.getFirstChild() === null && getWidgetLabelText(widget) === null);
 }
 function toBeInvalid(received) {
@@ -329,8 +469,6 @@ function toHaveObjectProperty(received, ...args) {
                 `"${String(name)}", but received ${JSON.stringify(actual)}`,
         };
     }
-    /* eslint-disable-next-line unicorn/no-this-outside-of-class --
-       expect.extend invokes matchers with the matcher state as `this` */
     const isPass = isEqualValue(this, actual, expected);
     return {
         pass: isPass,
@@ -350,5 +488,5 @@ const registerMatchers = () => {
     expect.extend(matchers);
     registration.isRegistered = true;
 };
-export { toHaveDisplayValue, toHaveTextContent, toHaveAccessibleName, toHaveAccessibleDescription, toHaveAccessibleErrorMessage, toHavePlaceholderText, toHaveSelection, toBeChecked, toBePartiallyChecked, toBePressed, toBeExpanded, toBeSelected, toBeDisabled, toBeEnabled, toBeVisible, toBeRooted, toBeEmpty, toBeInvalid, toBeValid, toBeRequired, toHaveFocus, toHaveValue, toHaveRole, toContainElement, toHaveClass, toHaveObjectProperty, matchers, registerMatchers, };
+export { matchers, registerMatchers };
 //# sourceMappingURL=matchers.js.map