@gtkx/testing 1.0.0-rc.3 → 1.0.0

package/dist/widget-getters.js

@@ -0,0 +1,19 @@
+import { getInstanceType, typeName } from "@gtkx/runtime";
+const getWidgetMethod = (widget, name) => Reflect.get(widget, name);
+const getWidgetTypeName = (widget) => typeName(getInstanceType(widget));
+const hasWidgetMethod = (widget, name) => typeof getWidgetMethod(widget, name) === "function";
+/* eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- callers name the signature */
+const getCallableMethod = (widget, name) => {
+    const fn = getWidgetMethod(widget, name);
+    return typeof fn === "function" ? fn.bind(widget) : null;
+};
+const callBooleanGetter = (widget, method) => {
+    const value = getCallableMethod(widget, method)?.();
+    return typeof value === "boolean" ? value : null;
+};
+const callStringGetter = (widget, method) => {
+    const value = getCallableMethod(widget, method)?.();
+    return typeof value === "string" ? value : null;
+};
+export { callBooleanGetter, callStringGetter, getCallableMethod, getWidgetTypeName, hasWidgetMethod };
+//# sourceMappingURL=widget-getters.js.map

package/dist/widget-getters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-getters.js","sourceRoot":"","sources":["../src/widget-getters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,eAAe,GAAG,CAAC,MAAkB,EAAE,IAAY,EAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACjG,MAAM,iBAAiB,GAAG,CAAC,MAAkB,EAAiB,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;AAEnG,MAAM,eAAe,GAAG,CAAC,MAAkB,EAAE,IAAY,EAAW,EAAE,CAClE,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,UAAU,CAAC;AAExD,8GAA8G;AAC9G,MAAM,iBAAiB,GAAG,CACtB,MAAkB,EAClB,IAAY,EACsB,EAAE;IACpC,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEzC,OAAO,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAE,EAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,MAAkB,EAAE,MAAc,EAAkB,EAAE;IAC7E,MAAM,KAAK,GAAG,iBAAiB,CAAc,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;IAEjE,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAAE,MAAc,EAAiB,EAAE;IAC3E,MAAM,KAAK,GAAG,iBAAiB,CAAc,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;IAEjE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { getInstanceType, typeName } from \"@gtkx/runtime\";\n\nconst getWidgetMethod = (widget: Gtk.Widget, name: string): unknown => Reflect.get(widget, name);\nconst getWidgetTypeName = (widget: Gtk.Widget): string | null => typeName(getInstanceType(widget));\n\nconst hasWidgetMethod = (widget: Gtk.Widget, name: string): boolean =>\n    typeof getWidgetMethod(widget, name) === \"function\";\n\n/* eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- callers name the signature */\nconst getCallableMethod = <Args extends unknown[], Result>(\n    widget: Gtk.Widget,\n    name: string,\n): ((...args: Args) => Result) | null => {\n    const fn = getWidgetMethod(widget, name);\n\n    return typeof fn === \"function\" ? (fn as (...args: Args) => Result).bind(widget) : null;\n};\n\nconst callBooleanGetter = (widget: Gtk.Widget, method: string): boolean | null => {\n    const value = getCallableMethod<[], unknown>(widget, method)?.();\n\n    return typeof value === \"boolean\" ? value : null;\n};\n\nconst callStringGetter = (widget: Gtk.Widget, method: string): string | null => {\n    const value = getCallableMethod<[], unknown>(widget, method)?.();\n\n    return typeof value === \"string\" ? value : null;\n};\n\nexport { callBooleanGetter, callStringGetter, getCallableMethod, getWidgetTypeName, hasWidgetMethod };\n"]}

package/dist/within.d.ts

@@ -3,12 +3,13 @@ import type { Container } from "./traversal.js";
 import type { BoundCustomQueries, QueryMap } from "./types.js";
 /**
  * Binds the built-in queries, and any custom queries, to a specific container
- * so they search only within that scope.
+ * so they search only within that scope. Also exported as `getQueriesForElement`,
+ * which reads better in library code.
  *
  * @param container The scope the returned queries operate on.
  * @param queries Optional custom queries to bind alongside the built-in ones.
  * @returns The queries bound to the container.
  */
 declare const within: <Q extends QueryMap = Record<never, never>>(container: Container, queries?: Q) => BoundQueries & BoundCustomQueries<Q>;
-export { within };
+export { within, within as getQueriesForElement };
 //# sourceMappingURL=within.d.ts.map

package/dist/within.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"within.d.ts","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAc/D;;;;;;;GAOG;AACH,QAAA,MAAM,MAAM,GAAI,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACrD,WAAW,SAAS,EACpB,UAAU,CAAC,KACZ,YAAY,GAAG,kBAAkB,CAAC,CAAC,CAGpC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"within.d.ts","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAc/D;;;;;;;;GAQG;AACH,QAAA,MAAM,MAAM,GAAI,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACrD,WAAW,SAAS,EACpB,UAAU,CAAC,KACZ,YAAY,GAAG,kBAAkB,CAAC,CAAC,CAGpC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/within.js

@@ -6,7 +6,8 @@ const bindCustomQueries = (customQueries, container) => {
 };
 /**
  * Binds the built-in queries, and any custom queries, to a specific container
- * so they search only within that scope.
+ * so they search only within that scope. Also exported as `getQueriesForElement`,
+ * which reads better in library code.
  *
  * @param container The scope the returned queries operate on.
  * @param queries Optional custom queries to bind alongside the built-in ones.
@@ -16,5 +17,5 @@ const within = (container, queries) => ({
     ...bindCustomQueries(builtinQueries, container),
     ...(queries ? bindCustomQueries(queries, container) : {}),
 });
-export { within };
+export { within, within as getQueriesForElement };
 //# sourceMappingURL=within.js.map

package/dist/within.js.map

@@ -1 +1 @@
-{"version":3,"file":"within.js","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,SAAS,GACX,CAAiC,KAAsD,EAAE,SAAoB,EAAE,EAAE,CAC7G,CAAC,GAAG,IAAU,EAAU,EAAE,CACtB,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AAEtC,MAAM,iBAAiB,GAAG,CAAqB,aAAgB,EAAE,SAAoB,EAAyB,EAAE;IAC5G,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAU,CAAC,CAAC;IAEjH,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAA0B,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,CACX,SAAoB,EACpB,OAAW,EACyB,EAAE,CAAC,CAAC;IACxC,GAAI,iBAAiB,CAAC,cAAc,EAAE,SAAS,CAAkB;IACjE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAE,EAA4B,CAAC;CACvF,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC","sourcesContent":["import type { BoundQueries } from \"./bound-queries.js\";\nimport type { Container } from \"./traversal.js\";\nimport type { BoundCustomQueries, QueryMap } from \"./types.js\";\nimport { builtinQueries } from \"./queries.js\";\n\nconst bindQuery =\n    <Args extends unknown[], Result>(query: (container: Container, ...args: Args) => Result, container: Container) =>\n        (...args: Args): Result =>\n            query(container, ...args);\n\nconst bindCustomQueries = <Q extends QueryMap>(customQueries: Q, container: Container): BoundCustomQueries<Q> => {\n    const entries = Object.entries(customQueries).map(([key, query]) => [key, bindQuery(query, container)] as const);\n\n    return Object.fromEntries(entries) as BoundCustomQueries<Q>;\n};\n\n/**\n * Binds the built-in queries, and any custom queries, to a specific container\n * so they search only within that scope.\n *\n * @param container The scope the returned queries operate on.\n * @param queries Optional custom queries to bind alongside the built-in ones.\n * @returns The queries bound to the container.\n */\nconst within = <Q extends QueryMap = Record<never, never>>(\n    container: Container,\n    queries?: Q,\n): BoundQueries & BoundCustomQueries<Q> => ({\n    ...(bindCustomQueries(builtinQueries, container) as BoundQueries),\n    ...(queries ? bindCustomQueries(queries, container) : ({} as BoundCustomQueries<Q>)),\n});\n\nexport { within };\n"]}
+{"version":3,"file":"within.js","sourceRoot":"","sources":["../src/within.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,SAAS,GACX,CAAiC,KAAsD,EAAE,SAAoB,EAAE,EAAE,CAC7G,CAAC,GAAG,IAAU,EAAU,EAAE,CACtB,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AAEtC,MAAM,iBAAiB,GAAG,CAAqB,aAAgB,EAAE,SAAoB,EAAyB,EAAE;IAC5G,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAU,CAAC,CAAC;IAEjH,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAA0B,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,GAAG,CACX,SAAoB,EACpB,OAAW,EACyB,EAAE,CAAC,CAAC;IACxC,GAAI,iBAAiB,CAAC,cAAc,EAAE,SAAS,CAAkB;IACjE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAE,EAA4B,CAAC;CACvF,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC","sourcesContent":["import type { BoundQueries } from \"./bound-queries.js\";\nimport type { Container } from \"./traversal.js\";\nimport type { BoundCustomQueries, QueryMap } from \"./types.js\";\nimport { builtinQueries } from \"./queries.js\";\n\nconst bindQuery =\n    <Args extends unknown[], Result>(query: (container: Container, ...args: Args) => Result, container: Container) =>\n        (...args: Args): Result =>\n            query(container, ...args);\n\nconst bindCustomQueries = <Q extends QueryMap>(customQueries: Q, container: Container): BoundCustomQueries<Q> => {\n    const entries = Object.entries(customQueries).map(([key, query]) => [key, bindQuery(query, container)] as const);\n\n    return Object.fromEntries(entries) as BoundCustomQueries<Q>;\n};\n\n/**\n * Binds the built-in queries, and any custom queries, to a specific container\n * so they search only within that scope. Also exported as `getQueriesForElement`,\n * which reads better in library code.\n *\n * @param container The scope the returned queries operate on.\n * @param queries Optional custom queries to bind alongside the built-in ones.\n * @returns The queries bound to the container.\n */\nconst within = <Q extends QueryMap = Record<never, never>>(\n    container: Container,\n    queries?: Q,\n): BoundQueries & BoundCustomQueries<Q> => ({\n    ...(bindCustomQueries(builtinQueries, container) as BoundQueries),\n    ...(queries ? bindCustomQueries(queries, container) : ({} as BoundCustomQueries<Q>)),\n});\n\nexport { within, within as getQueriesForElement };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/testing",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0",
   "description": "Testing Library-style queries, user events, and screenshots for GTK4 widget trees rendered by GTKX",
   "keywords": [
     "gtkx",
@@ -30,6 +30,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
     }
   },
   "sideEffects": [
@@ -44,20 +48,21 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@gtkx/runtime": "1.0.0-rc.3",
-    "@gtkx/react": "1.0.0-rc.3",
-    "@gtkx/utils": "1.0.0-rc.3"
+    "@vitest/expect": "^4.1.10",
+    "@vitest/pretty-format": "^4.1.10",
+    "@gtkx/react": "1.0.0",
+    "@gtkx/utils": "1.0.0",
+    "@gtkx/runtime": "1.0.0"
   },
   "peerDependencies": {
     "@types/react": "^19.2",
     "react": "^19.2"
   },
   "devDependencies": {
-    "@types/react": "^19.2.17",
-    "@vitest/expect": "^4.1.10",
+    "@types/react": "^19.2.18",
     "vitest": "^4.1.10",
-    "@gtkx/config": "1.0.0-rc.3",
-    "@gtkx/vitest": "1.0.0-rc.3"
+    "@gtkx/config": "1.0.0",
+    "@gtkx/vitest": "1.0.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/accessible-native.ts

@@ -0,0 +1,333 @@
+import * as Gtk from "@gtkx/gi/gtk";
+import { getHandle, t } from "@gtkx/runtime";
+
+type CheckInt = (handle: unknown, attribute: number, expected: number) => string | null;
+type CheckString = (handle: unknown, attribute: number, expected: string | null) => string | null;
+type CheckDouble = (handle: unknown, attribute: number, expected: number) => string | null;
+type CheckRelation = (...args: unknown[]) => string | null;
+/** A value GTK holds for an accessible property: a string, a number, a token, or a boolean. */
+type AccessibleAttributeValue = boolean | number | string;
+type PropertyReader = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty) => AccessibleAttributeValue | null;
+type NativeCall = (...inputs: unknown[]) => unknown;
+type CheckArg = typeof DOUBLE_ARG | typeof INT_ARG | typeof OBJECT_ARG | typeof STRING_ARG;
+
+const LIB = "libgtk-4.so.1";
+const MAX_RELATION_TARGETS = 8;
+const relationBindings: Map<number, CheckRelation> = new Map();
+
+const REVERSE_RELATIONS: Partial<Record<Gtk.AccessibleRelation, Gtk.AccessibleRelation>> = {
+    [Gtk.AccessibleRelation.LABELLED_BY]: Gtk.AccessibleRelation.LABEL_FOR,
+    [Gtk.AccessibleRelation.DESCRIBED_BY]: Gtk.AccessibleRelation.DESCRIPTION_FOR,
+    [Gtk.AccessibleRelation.ERROR_MESSAGE]: Gtk.AccessibleRelation.ERROR_MESSAGE_FOR,
+    [Gtk.AccessibleRelation.CONTROLS]: Gtk.AccessibleRelation.CONTROLLED_BY,
+    [Gtk.AccessibleRelation.DETAILS]: Gtk.AccessibleRelation.DETAILS_FOR,
+    [Gtk.AccessibleRelation.FLOW_TO]: Gtk.AccessibleRelation.FLOW_FROM,
+};
+
+const UNDEFINED_VALUE = -1;
+const INT_SENTINEL = -2_147_483_648;
+const NUMBER_SENTINEL = -Number.MAX_VALUE;
+const ACCESSIBLE_NUMBER_TOLERANCE = 0.001;
+const BOOLEAN_DOMAIN = [0, 1];
+const OPTIONAL_BOOLEAN_DOMAIN = [0, 1, UNDEFINED_VALUE];
+const TRISTATE_DOMAIN = [Gtk.AccessibleTristate.FALSE, Gtk.AccessibleTristate.TRUE, Gtk.AccessibleTristate.MIXED];
+
+const INVALID_DOMAIN = [
+    Gtk.AccessibleInvalidState.FALSE,
+    Gtk.AccessibleInvalidState.TRUE,
+    Gtk.AccessibleInvalidState.GRAMMAR,
+    Gtk.AccessibleInvalidState.SPELLING,
+];
+
+const STATE_DOMAINS: Partial<Record<Gtk.AccessibleState, number[]>> = {
+    [Gtk.AccessibleState.BUSY]: BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.CHECKED]: TRISTATE_DOMAIN,
+    [Gtk.AccessibleState.DISABLED]: BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.EXPANDED]: OPTIONAL_BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.HIDDEN]: BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.INVALID]: INVALID_DOMAIN,
+    [Gtk.AccessibleState.PRESSED]: TRISTATE_DOMAIN,
+    [Gtk.AccessibleState.SELECTED]: OPTIONAL_BOOLEAN_DOMAIN,
+    [Gtk.AccessibleState.VISITED]: OPTIONAL_BOOLEAN_DOMAIN,
+};
+
+const AUTOCOMPLETE_DOMAIN = [
+    Gtk.AccessibleAutocomplete.NONE,
+    Gtk.AccessibleAutocomplete.INLINE,
+    Gtk.AccessibleAutocomplete.LIST,
+    Gtk.AccessibleAutocomplete.BOTH,
+];
+
+const ORIENTATION_DOMAIN = [Gtk.Orientation.HORIZONTAL, Gtk.Orientation.VERTICAL];
+
+const SORT_DOMAIN = [
+    Gtk.AccessibleSort.NONE,
+    Gtk.AccessibleSort.ASCENDING,
+    Gtk.AccessibleSort.DESCENDING,
+    Gtk.AccessibleSort.OTHER,
+];
+
+const TOKEN_DOMAINS: Partial<Record<Gtk.AccessibleProperty, number[]>> = {
+    [Gtk.AccessibleProperty.AUTOCOMPLETE]: AUTOCOMPLETE_DOMAIN,
+    [Gtk.AccessibleProperty.ORIENTATION]: ORIENTATION_DOMAIN,
+    [Gtk.AccessibleProperty.SORT]: SORT_DOMAIN,
+};
+
+const STRING_PROPERTIES: Set<Gtk.AccessibleProperty> = new Set<Gtk.AccessibleProperty>([
+    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,
+]);
+
+const BOOLEAN_PROPERTIES: Set<Gtk.AccessibleProperty> = new Set<Gtk.AccessibleProperty>([
+    Gtk.AccessibleProperty.HAS_POPUP,
+    Gtk.AccessibleProperty.MODAL,
+    Gtk.AccessibleProperty.MULTI_LINE,
+    Gtk.AccessibleProperty.MULTI_SELECTABLE,
+    Gtk.AccessibleProperty.READ_ONLY,
+    Gtk.AccessibleProperty.REQUIRED,
+]);
+
+const NUMBER_PROPERTIES: Set<Gtk.AccessibleProperty> = new Set<Gtk.AccessibleProperty>([
+    Gtk.AccessibleProperty.VALUE_MAX,
+    Gtk.AccessibleProperty.VALUE_MIN,
+    Gtk.AccessibleProperty.VALUE_NOW,
+]);
+
+const OBJECT_ARG = { type: t.object("borrowed") };
+const INT_ARG = { type: t.int32 };
+const DOUBLE_ARG = { type: t.float64 };
+const STRING_ARG = { type: t.string("borrowed") };
+const CHECK_PROPERTY = "gtk_test_accessible_check_property";
+const checkStateInt = buildAccessibleCheck("gtk_test_accessible_check_state", [INT_ARG]) as CheckInt;
+const checkPropertyInt = buildAccessibleCheck(CHECK_PROPERTY, [INT_ARG]) as CheckInt;
+const checkPropertyDouble = buildAccessibleCheck(CHECK_PROPERTY, [DOUBLE_ARG]) as CheckDouble;
+const checkPropertyString = buildAccessibleCheck(CHECK_PROPERTY, [STRING_ARG]) as CheckString;
+
+function buildAccessibleCheck(symbol: string, varargs: CheckArg[]): NativeCall {
+    return t.fn(LIB, symbol, {
+        args: [OBJECT_ARG, INT_ARG, ...varargs],
+        returns: t.string("full"),
+        fixedArgCount: 2,
+    });
+}
+
+const buildRelationBinding = (targetCount: number): CheckRelation => {
+    const targets = Array.from({ length: targetCount + 1 }, () => OBJECT_ARG);
+
+    return buildAccessibleCheck("gtk_test_accessible_check_relation", targets) as CheckRelation;
+};
+
+const relationBindingFor = (targetCount: number): CheckRelation => {
+    const cached = relationBindings.get(targetCount);
+
+    if (cached !== undefined) {
+        return cached;
+    }
+
+    const built = buildRelationBinding(targetCount);
+    relationBindings.set(targetCount, built);
+
+    return built;
+};
+
+const isRelationExactly = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    candidate: Gtk.Accessible,
+    targetCount: number,
+): boolean => {
+    const call = relationBindingFor(targetCount);
+    const repeated = Array.from({ length: targetCount }, () => getHandle(candidate));
+
+    return call(getHandle(accessible), relation, ...repeated, null) === null;
+};
+
+const hasRelationSize = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    candidates: Gtk.Accessible[],
+    size: number,
+): boolean => candidates.some((candidate) => isRelationExactly(accessible, relation, candidate, size));
+
+const findRelationSize = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    candidates: Gtk.Accessible[],
+): number => {
+    for (let size = 1; size <= MAX_RELATION_TARGETS; size += 1) {
+        if (hasRelationSize(accessible, relation, candidates, size)) {
+            return size;
+        }
+    }
+
+    return 0;
+};
+
+const possibleTargets = (relation: Gtk.AccessibleRelation, candidates: Gtk.Accessible[]): Gtk.Accessible[] => {
+    const reverse = REVERSE_RELATIONS[relation];
+
+    if (reverse === undefined) {
+        return candidates;
+    }
+
+    return candidates.filter((candidate) => Gtk.testAccessibleHasRelation(candidate, reverse));
+};
+
+const readAccessibleRelation = (
+    accessible: Gtk.Accessible,
+    relation: Gtk.AccessibleRelation,
+    pool: Gtk.Accessible[],
+): Gtk.Accessible[] => {
+    if (!Gtk.testAccessibleHasRelation(accessible, relation)) {
+        return [];
+    }
+
+    const candidates = possibleTargets(relation, pool);
+    const size = findRelationSize(accessible, relation, candidates);
+
+    if (size === 0) {
+        return [];
+    }
+
+    return candidates.filter((candidate) => isRelationExactly(accessible, relation, candidate, size));
+};
+
+const memberOfDomain = (check: CheckInt, handle: unknown, attribute: number, domain: number[]): number | null => {
+    for (const candidate of domain) {
+        if (check(handle, attribute, candidate) === null) {
+            return candidate;
+        }
+    }
+
+    return null;
+};
+
+const readAccessibleState = (accessible: Gtk.Accessible, state: Gtk.AccessibleState): number | null => {
+    const domain = STATE_DOMAINS[state];
+
+    if (domain === undefined || !Gtk.testAccessibleHasState(accessible, state)) {
+        return null;
+    }
+
+    const member = memberOfDomain(checkStateInt, getHandle(accessible), state, domain);
+
+    return member === UNDEFINED_VALUE ? null : member;
+};
+
+const readAccessibleFlag = (accessible: Gtk.Accessible, state: Gtk.AccessibleState): boolean | null => {
+    const value = readAccessibleState(accessible, state);
+
+    return value === null ? null : value === 1;
+};
+
+const readAccessibleString = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty): string | null => {
+    if (!Gtk.testAccessibleHasProperty(accessible, property)) {
+        return null;
+    }
+
+    return checkPropertyString(getHandle(accessible), property, null);
+};
+
+const readAccessibleToken = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+    domain: number[],
+): number | null => {
+    if (!Gtk.testAccessibleHasProperty(accessible, property)) {
+        return null;
+    }
+
+    return memberOfDomain(checkPropertyInt, getHandle(accessible), property, domain);
+};
+
+const readAccessibleBooleanProperty = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+): boolean | null => {
+    const member = readAccessibleToken(accessible, property, BOOLEAN_DOMAIN);
+
+    return member === null ? null : member === 1;
+};
+
+const readAgainstSentinel = (
+    check: CheckDouble,
+    sentinel: number,
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+): number | null => {
+    if (!Gtk.testAccessibleHasProperty(accessible, property)) {
+        return null;
+    }
+
+    const reported = check(getHandle(accessible), property, sentinel);
+
+    return reported === null ? sentinel : Number(reported);
+};
+
+const readAccessibleInt = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty): number | null =>
+    readAgainstSentinel(checkPropertyInt, INT_SENTINEL, accessible, property);
+
+const readAccessibleNumber = (accessible: Gtk.Accessible, property: Gtk.AccessibleProperty): number | null =>
+    readAgainstSentinel(checkPropertyDouble, NUMBER_SENTINEL, accessible, property);
+
+const isAccessibleNumberProperty = (property: Gtk.AccessibleProperty): boolean => NUMBER_PROPERTIES.has(property);
+
+const isAccessibleNumberMatch = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+    expected: number,
+): boolean =>
+    Gtk.testAccessibleHasProperty(accessible, property) &&
+    checkPropertyDouble(getHandle(accessible), property, expected) === null;
+
+const tokenReaderFor =
+    (domain: number[]): PropertyReader =>
+        (accessible, property) =>
+            readAccessibleToken(accessible, property, domain);
+
+const propertyReaderFor = (property: Gtk.AccessibleProperty): PropertyReader => {
+    const domain = TOKEN_DOMAINS[property];
+
+    if (domain !== undefined) {
+        return tokenReaderFor(domain);
+    }
+
+    if (STRING_PROPERTIES.has(property)) {
+        return readAccessibleString;
+    }
+
+    if (BOOLEAN_PROPERTIES.has(property)) {
+        return readAccessibleBooleanProperty;
+    }
+
+    if (NUMBER_PROPERTIES.has(property)) {
+        return readAccessibleNumber;
+    }
+
+    return readAccessibleInt;
+};
+
+const readAccessibleProperty = (
+    accessible: Gtk.Accessible,
+    property: Gtk.AccessibleProperty,
+): AccessibleAttributeValue | null => propertyReaderFor(property)(accessible, property);
+
+export {
+    ACCESSIBLE_NUMBER_TOLERANCE,
+    isAccessibleNumberMatch,
+    isAccessibleNumberProperty,
+    readAccessibleBooleanProperty,
+    readAccessibleFlag,
+    readAccessibleInt,
+    readAccessibleNumber,
+    readAccessibleProperty,
+    readAccessibleRelation,
+    readAccessibleState,
+    readAccessibleString,
+    type AccessibleAttributeValue,
+};

package/src/act.ts

@@ -4,7 +4,9 @@ declare global {
     var IS_REACT_ACT_ENVIRONMENT: boolean | undefined;
 }
 
+/** Work run inside the act environment, either synchronous or asynchronous. */
 type ActCallback<T> = () => T | PromiseLike<T>;
+/** Runs a callback inside React's act environment and settles with its result once updates flush. */
 type ActImplementation = <T>(callback: ActCallback<T>) => PromiseLike<T>;
 
 const actImplementation: ActImplementation = reactAct;