@gtkx/testing 1.0.0-rc.3 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (215) hide show
  1. package/README.md +8 -9
  2. package/dist/accessible-native.d.ts +16 -0
  3. package/dist/accessible-native.d.ts.map +1 -0
  4. package/dist/accessible-native.js +206 -0
  5. package/dist/accessible-native.js.map +1 -0
  6. package/dist/act.d.ts +2 -0
  7. package/dist/act.d.ts.map +1 -1
  8. package/dist/act.js.map +1 -1
  9. package/dist/build-queries.d.ts +27 -10
  10. package/dist/build-queries.d.ts.map +1 -1
  11. package/dist/build-queries.js +39 -30
  12. package/dist/build-queries.js.map +1 -1
  13. package/dist/cleanup-registry.d.ts +1 -1
  14. package/dist/cleanup-registry.d.ts.map +1 -1
  15. package/dist/cleanup-registry.js.map +1 -1
  16. package/dist/config.d.ts +1 -0
  17. package/dist/config.d.ts.map +1 -1
  18. package/dist/config.js +3 -3
  19. package/dist/config.js.map +1 -1
  20. package/dist/errors.d.ts +10 -1
  21. package/dist/errors.d.ts.map +1 -1
  22. package/dist/errors.js +12 -3
  23. package/dist/errors.js.map +1 -1
  24. package/dist/fire-event.d.ts +35 -6
  25. package/dist/fire-event.d.ts.map +1 -1
  26. package/dist/fire-event.js +23 -7
  27. package/dist/fire-event.js.map +1 -1
  28. package/dist/frame-sync.d.ts +2 -1
  29. package/dist/frame-sync.d.ts.map +1 -1
  30. package/dist/frame-sync.js +15 -5
  31. package/dist/frame-sync.js.map +1 -1
  32. package/dist/harness-window.d.ts +4 -0
  33. package/dist/harness-window.d.ts.map +1 -0
  34. package/dist/harness-window.js +6 -0
  35. package/dist/harness-window.js.map +1 -0
  36. package/dist/index.d.ts +14 -7
  37. package/dist/index.d.ts.map +1 -1
  38. package/dist/index.js +9 -5
  39. package/dist/index.js.map +1 -1
  40. package/dist/internal.d.ts +4 -0
  41. package/dist/internal.d.ts.map +1 -0
  42. package/dist/internal.js +4 -0
  43. package/dist/internal.js.map +1 -0
  44. package/dist/matchers.d.ts +125 -39
  45. package/dist/matchers.d.ts.map +1 -1
  46. package/dist/matchers.js +156 -18
  47. package/dist/matchers.js.map +1 -1
  48. package/dist/pretty-format.d.ts +2 -0
  49. package/dist/pretty-format.d.ts.map +1 -0
  50. package/dist/pretty-format.js +2 -0
  51. package/dist/pretty-format.js.map +1 -0
  52. package/dist/pretty-widget.d.ts +7 -3
  53. package/dist/pretty-widget.d.ts.map +1 -1
  54. package/dist/pretty-widget.js +74 -57
  55. package/dist/pretty-widget.js.map +1 -1
  56. package/dist/production.d.ts +8 -0
  57. package/dist/production.d.ts.map +1 -0
  58. package/dist/production.js +34 -0
  59. package/dist/production.js.map +1 -0
  60. package/dist/queries.d.ts +99 -56
  61. package/dist/queries.d.ts.map +1 -1
  62. package/dist/queries.js +123 -83
  63. package/dist/queries.js.map +1 -1
  64. package/dist/query-helpers.d.ts +44 -0
  65. package/dist/query-helpers.d.ts.map +1 -0
  66. package/dist/query-helpers.js +57 -0
  67. package/dist/query-helpers.js.map +1 -0
  68. package/dist/render-children.d.ts +9 -0
  69. package/dist/render-children.d.ts.map +1 -0
  70. package/dist/render-children.js +11 -0
  71. package/dist/render-children.js.map +1 -0
  72. package/dist/render.d.ts.map +1 -1
  73. package/dist/render.js +13 -11
  74. package/dist/render.js.map +1 -1
  75. package/dist/role-helpers.d.ts +12 -3
  76. package/dist/role-helpers.d.ts.map +1 -1
  77. package/dist/role-helpers.js +13 -4
  78. package/dist/role-helpers.js.map +1 -1
  79. package/dist/role-naming.d.ts +5 -0
  80. package/dist/role-naming.d.ts.map +1 -0
  81. package/dist/role-naming.js +96 -0
  82. package/dist/role-naming.js.map +1 -0
  83. package/dist/screenshot.d.ts +12 -20
  84. package/dist/screenshot.d.ts.map +1 -1
  85. package/dist/screenshot.js +183 -91
  86. package/dist/screenshot.js.map +1 -1
  87. package/dist/suggestions.d.ts +3 -0
  88. package/dist/suggestions.d.ts.map +1 -1
  89. package/dist/suggestions.js.map +1 -1
  90. package/dist/traversal.d.ts +9 -1
  91. package/dist/traversal.d.ts.map +1 -1
  92. package/dist/traversal.js +26 -6
  93. package/dist/traversal.js.map +1 -1
  94. package/dist/types.d.ts +67 -17
  95. package/dist/types.d.ts.map +1 -1
  96. package/dist/types.js.map +1 -1
  97. package/dist/user-event/adjustment.d.ts +16 -0
  98. package/dist/user-event/adjustment.d.ts.map +1 -1
  99. package/dist/user-event/adjustment.js +34 -2
  100. package/dist/user-event/adjustment.js.map +1 -1
  101. package/dist/user-event/click.d.ts +45 -3
  102. package/dist/user-event/click.d.ts.map +1 -1
  103. package/dist/user-event/click.js +177 -39
  104. package/dist/user-event/click.js.map +1 -1
  105. package/dist/user-event/column-header-click.d.ts +4 -0
  106. package/dist/user-event/column-header-click.d.ts.map +1 -0
  107. package/dist/user-event/column-header-click.js +65 -0
  108. package/dist/user-event/column-header-click.js.map +1 -0
  109. package/dist/user-event/controller.d.ts +29 -0
  110. package/dist/user-event/controller.d.ts.map +1 -1
  111. package/dist/user-event/controller.js +28 -0
  112. package/dist/user-event/controller.js.map +1 -1
  113. package/dist/user-event/event-wrapper.d.ts.map +1 -1
  114. package/dist/user-event/event-wrapper.js +2 -1
  115. package/dist/user-event/event-wrapper.js.map +1 -1
  116. package/dist/user-event/gesture.d.ts +51 -0
  117. package/dist/user-event/gesture.d.ts.map +1 -1
  118. package/dist/user-event/gesture.js +47 -4
  119. package/dist/user-event/gesture.js.map +1 -1
  120. package/dist/user-event/index.d.ts +70 -2
  121. package/dist/user-event/index.d.ts.map +1 -1
  122. package/dist/user-event/index.js +43 -26
  123. package/dist/user-event/index.js.map +1 -1
  124. package/dist/user-event/indexed-children.d.ts +10 -0
  125. package/dist/user-event/indexed-children.d.ts.map +1 -0
  126. package/dist/user-event/indexed-children.js +50 -0
  127. package/dist/user-event/indexed-children.js.map +1 -0
  128. package/dist/user-event/keyboard.d.ts +4 -2
  129. package/dist/user-event/keyboard.d.ts.map +1 -1
  130. package/dist/user-event/keyboard.js +46 -16
  131. package/dist/user-event/keyboard.js.map +1 -1
  132. package/dist/user-event/list-row-click.d.ts +4 -0
  133. package/dist/user-event/list-row-click.d.ts.map +1 -0
  134. package/dist/user-event/list-row-click.js +39 -0
  135. package/dist/user-event/list-row-click.js.map +1 -0
  136. package/dist/user-event/native-click.d.ts +6 -0
  137. package/dist/user-event/native-click.d.ts.map +1 -0
  138. package/dist/user-event/native-click.js +32 -0
  139. package/dist/user-event/native-click.js.map +1 -0
  140. package/dist/user-event/pointer.d.ts +1 -1
  141. package/dist/user-event/pointer.d.ts.map +1 -1
  142. package/dist/user-event/pointer.js +37 -13
  143. package/dist/user-event/pointer.js.map +1 -1
  144. package/dist/user-event/selection.d.ts +18 -0
  145. package/dist/user-event/selection.d.ts.map +1 -1
  146. package/dist/user-event/selection.js +56 -30
  147. package/dist/user-event/selection.js.map +1 -1
  148. package/dist/user-event/state.d.ts +1 -1
  149. package/dist/user-event/state.d.ts.map +1 -1
  150. package/dist/user-event/state.js +1 -1
  151. package/dist/user-event/state.js.map +1 -1
  152. package/dist/user-event/text.d.ts +34 -3
  153. package/dist/user-event/text.d.ts.map +1 -1
  154. package/dist/user-event/text.js +94 -17
  155. package/dist/user-event/text.js.map +1 -1
  156. package/dist/wait-for.d.ts +2 -0
  157. package/dist/wait-for.d.ts.map +1 -1
  158. package/dist/wait-for.js.map +1 -1
  159. package/dist/widget-accessible-properties.d.ts +14 -10
  160. package/dist/widget-accessible-properties.d.ts.map +1 -1
  161. package/dist/widget-accessible-properties.js +135 -173
  162. package/dist/widget-accessible-properties.js.map +1 -1
  163. package/dist/widget-getters.d.ts +8 -0
  164. package/dist/widget-getters.d.ts.map +1 -0
  165. package/dist/widget-getters.js +19 -0
  166. package/dist/widget-getters.js.map +1 -0
  167. package/dist/within.d.ts +3 -2
  168. package/dist/within.d.ts.map +1 -1
  169. package/dist/within.js +3 -2
  170. package/dist/within.js.map +1 -1
  171. package/package.json +13 -8
  172. package/src/accessible-native.ts +333 -0
  173. package/src/act.ts +2 -0
  174. package/src/build-queries.ts +66 -48
  175. package/src/cleanup-registry.ts +1 -1
  176. package/src/config.ts +4 -3
  177. package/src/errors.ts +14 -3
  178. package/src/fire-event.ts +61 -8
  179. package/src/frame-sync.ts +21 -5
  180. package/src/harness-window.ts +9 -0
  181. package/src/index.ts +18 -11
  182. package/src/internal.ts +11 -0
  183. package/src/matchers.ts +466 -64
  184. package/src/pretty-format.ts +1 -0
  185. package/src/pretty-widget.ts +100 -72
  186. package/src/production.ts +52 -0
  187. package/src/queries.ts +128 -89
  188. package/src/query-helpers.ts +97 -0
  189. package/src/render-children.ts +25 -0
  190. package/src/render.tsx +18 -13
  191. package/src/role-helpers.ts +14 -4
  192. package/src/role-naming.ts +99 -0
  193. package/src/screenshot.ts +272 -103
  194. package/src/suggestions.ts +3 -0
  195. package/src/traversal.ts +49 -6
  196. package/src/types.ts +69 -19
  197. package/src/user-event/adjustment.ts +42 -2
  198. package/src/user-event/click.ts +248 -46
  199. package/src/user-event/column-header-click.ts +90 -0
  200. package/src/user-event/controller.ts +29 -0
  201. package/src/user-event/event-wrapper.ts +3 -1
  202. package/src/user-event/gesture.ts +57 -6
  203. package/src/user-event/index.ts +119 -29
  204. package/src/user-event/indexed-children.ts +75 -0
  205. package/src/user-event/keyboard.ts +70 -20
  206. package/src/user-event/list-row-click.ts +57 -0
  207. package/src/user-event/native-click.ts +46 -0
  208. package/src/user-event/pointer.ts +52 -13
  209. package/src/user-event/selection.ts +74 -33
  210. package/src/user-event/state.ts +2 -2
  211. package/src/user-event/text.ts +121 -23
  212. package/src/wait-for.ts +2 -0
  213. package/src/widget-accessible-properties.ts +183 -214
  214. package/src/widget-getters.ts +32 -0
  215. package/src/within.ts +3 -2
package/dist/queries.js CHANGED
@@ -3,13 +3,13 @@ import { buildQueries } from "./build-queries.js";
3
3
  import { multipleFoundError, notFoundError } from "./errors.js";
4
4
  import { getDefaultNormalizer } from "./normalize.js";
5
5
  import { findAll, traverse } from "./traversal.js";
6
- import { getWidgetAccessibleName, getWidgetBusyState, getWidgetDescription, getWidgetDisplayValue, getWidgetExpandedState, getWidgetLabelledByText, getWidgetLabelText, getWidgetLevel, getWidgetName, getWidgetOwnLabel, getWidgetPlaceholderText, getWidgetPressedState, getWidgetSelectedState, getWidgetValue, isInaccessible, isWidgetChecked, } from "./widget-accessible-properties.js";
7
- 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 })));
8
- const labelTextQueries = nameQueryFamily("LabelText", queryAllByLabelText, buildQueries("LabelText", queryAllByLabelText, (container, matches, text) => multipleFoundError(container, { queryType: "labelText", text }, matches), (container, text) => notFoundError(container, { queryType: "labelText", text })));
9
- const textQueries = nameQueryFamily("Text", queryAllByText, buildQueries("Text", queryAllByText, (container, matches, text) => multipleFoundError(container, { queryType: "text", text }, matches), (container, text) => notFoundError(container, { queryType: "text", text })));
10
- const nameQueries = nameQueryFamily("Name", queryAllByName, buildQueries("Name", queryAllByName, (container, matches, name) => multipleFoundError(container, { queryType: "name", name }, matches), (container, name) => notFoundError(container, { queryType: "name", name })));
11
- const placeholderTextQueries = nameQueryFamily("PlaceholderText", queryAllByPlaceholderText, buildQueries("PlaceholderText", queryAllByPlaceholderText, (container, matches, text) => multipleFoundError(container, { queryType: "placeholderText", text }, matches), (container, text) => notFoundError(container, { queryType: "placeholderText", text })));
12
- const displayValueQueries = nameQueryFamily("DisplayValue", queryAllByDisplayValue, buildQueries("DisplayValue", queryAllByDisplayValue, (container, matches, value) => multipleFoundError(container, { queryType: "displayValue", value }, matches), (container, value) => notFoundError(container, { queryType: "displayValue", value })));
6
+ import { getWidgetAccessibleName, getWidgetBusyState, getWidgetDescription, getWidgetDisplayValue, getWidgetExpandedState, getWidgetExternalLabelText, getWidgetLabelText, getWidgetLevel, getWidgetName, getWidgetOwnLabel, getWidgetPlaceholderText, getWidgetPressedState, getWidgetSelectedState, getWidgetValueText, isInaccessible, isWidgetChecked, isWidgetValueMatch, namingLabelText, } from "./widget-accessible-properties.js";
7
+ const roleQueries = nameQueryFamily("Role", queryAllByRole, buildQueries(queryAllByRole, (container, matches, role, options) => multipleFoundError(container, { queryType: "role", role, options }, matches), (container, role, options) => notFoundError(container, { queryType: "role", role, options })));
8
+ const labelTextQueries = nameQueryFamily("LabelText", queryAllByLabelText, buildQueries(queryAllByLabelText, (container, matches, text) => multipleFoundError(container, { queryType: "labelText", text }, matches), (container, text) => notFoundError(container, { queryType: "labelText", text })));
9
+ const textQueries = nameQueryFamily("Text", queryAllByText, buildQueries(queryAllByText, (container, matches, text) => multipleFoundError(container, { queryType: "text", text }, matches), (container, text) => notFoundError(container, { queryType: "text", text })));
10
+ const nameQueries = nameQueryFamily("Name", queryAllByName, buildQueries(queryAllByName, (container, matches, name) => multipleFoundError(container, { queryType: "name", name }, matches), (container, name) => notFoundError(container, { queryType: "name", name })));
11
+ const placeholderTextQueries = nameQueryFamily("PlaceholderText", queryAllByPlaceholderText, buildQueries(queryAllByPlaceholderText, (container, matches, text) => multipleFoundError(container, { queryType: "placeholderText", text }, matches), (container, text) => notFoundError(container, { queryType: "placeholderText", text })));
12
+ const displayValueQueries = nameQueryFamily("DisplayValue", queryAllByDisplayValue, buildQueries(queryAllByDisplayValue, (container, matches, value) => multipleFoundError(container, { queryType: "displayValue", value }, matches), (container, value) => notFoundError(container, { queryType: "displayValue", value })));
13
13
  const builtinQueries = {
14
14
  ...roleQueries,
15
15
  ...labelTextQueries,
@@ -19,120 +19,159 @@ const builtinQueries = {
19
19
  ...displayValueQueries,
20
20
  };
21
21
  /**
22
- * Returns the single widget with a matching accessible role and options, or null when none match.
23
- * Throws when more than one matches.
22
+ * Returns the single mapped widget with a matching accessible role and options, or null when none
23
+ * match. Widgets that are not mapped are never matched. Throws when more than one matches.
24
24
  */
25
25
  const queryByRole = builtinQueries.queryByRole;
26
- /** Returns every widget with a matching accessible role and options. Throws when none match. */
26
+ /**
27
+ * Returns every mapped widget with a matching accessible role and options. Widgets that are not
28
+ * mapped are never matched. Throws when none match.
29
+ */
27
30
  const getAllByRole = builtinQueries.getAllByRole;
28
31
  /**
29
- * Returns the single widget with a matching accessible role and options.
30
- * Throws when none or more than one matches.
32
+ * Returns the single mapped widget with a matching accessible role and options. Widgets that are not
33
+ * mapped are never matched. Throws when none or more than one matches.
31
34
  */
32
35
  const getByRole = builtinQueries.getByRole;
33
36
  /**
34
- * Waits for and returns every widget with a matching accessible role and options, retrying until at
35
- * least one appears or the timeout elapses.
37
+ * Waits for and returns every mapped widget with a matching accessible role and options, retrying
38
+ * until at least one appears or the timeout elapses. Widgets that are not mapped are never matched.
36
39
  */
37
40
  const findAllByRole = builtinQueries.findAllByRole;
38
41
  /**
39
- * Waits for and returns the single widget with a matching accessible role and options, retrying
40
- * until it appears or the timeout elapses. Rejects when none or more than one matches.
42
+ * Waits for and returns the single mapped widget with a matching accessible role and options,
43
+ * retrying until it appears or the timeout elapses. Widgets that are not mapped are never matched.
44
+ * Rejects when none or more than one matches.
41
45
  */
42
46
  const findByRole = builtinQueries.findByRole;
43
47
  /**
44
- * Returns the single widget with matching associated label text, or null when none match.
45
- * Throws when more than one matches.
48
+ * Returns the single mapped widget with matching associated label text, or null when none match.
49
+ * Widgets that are not mapped are never matched. Throws when more than one matches.
46
50
  */
47
51
  const queryByLabelText = builtinQueries.queryByLabelText;
48
- /** Returns every widget with matching associated label text. Throws when none match. */
52
+ /**
53
+ * Returns every mapped widget with matching associated label text. Widgets that are not mapped are
54
+ * never matched. Throws when none match.
55
+ */
49
56
  const getAllByLabelText = builtinQueries.getAllByLabelText;
50
- /** Returns the single widget with matching associated label text. Throws when none or more than one matches. */
57
+ /**
58
+ * Returns the single mapped widget with matching associated label text. Widgets that are not mapped
59
+ * are never matched. Throws when none or more than one matches.
60
+ */
51
61
  const getByLabelText = builtinQueries.getByLabelText;
52
62
  /**
53
- * Waits for and returns every widget with matching associated label text, retrying until at least
54
- * one appears or the timeout elapses.
63
+ * Waits for and returns every mapped widget with matching associated label text, retrying until at
64
+ * least one appears or the timeout elapses. Widgets that are not mapped are never matched.
55
65
  */
56
66
  const findAllByLabelText = builtinQueries.findAllByLabelText;
57
67
  /**
58
- * Waits for and returns the single widget with matching associated label text, retrying until it
59
- * appears or the timeout elapses. Rejects when none or more than one matches.
68
+ * Waits for and returns the single mapped widget with matching associated label text, retrying until
69
+ * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when
70
+ * none or more than one matches.
60
71
  */
61
72
  const findByLabelText = builtinQueries.findByLabelText;
62
73
  /**
63
- * Returns the single widget with matching rendered text content, or null when none match.
64
- * Throws when more than one matches.
74
+ * Returns the single mapped widget with matching rendered text content, or null when none match.
75
+ * Widgets that are not mapped are never matched. Throws when more than one matches.
65
76
  */
66
77
  const queryByText = builtinQueries.queryByText;
67
- /** Returns every widget with matching rendered text content. Throws when none match. */
78
+ /**
79
+ * Returns every mapped widget with matching rendered text content. Widgets that are not mapped are
80
+ * never matched. Throws when none match.
81
+ */
68
82
  const getAllByText = builtinQueries.getAllByText;
69
- /** Returns the single widget with matching rendered text content. Throws when none or more than one matches. */
83
+ /**
84
+ * Returns the single mapped widget with matching rendered text content. Widgets that are not mapped
85
+ * are never matched. Throws when none or more than one matches.
86
+ */
70
87
  const getByText = builtinQueries.getByText;
71
88
  /**
72
- * Waits for and returns every widget with matching rendered text content, retrying until at least
73
- * one appears or the timeout elapses.
89
+ * Waits for and returns every mapped widget with matching rendered text content, retrying until at
90
+ * least one appears or the timeout elapses. Widgets that are not mapped are never matched.
74
91
  */
75
92
  const findAllByText = builtinQueries.findAllByText;
76
93
  /**
77
- * Waits for and returns the single widget with matching rendered text content, retrying until it
78
- * appears or the timeout elapses. Rejects when none or more than one matches.
94
+ * Waits for and returns the single mapped widget with matching rendered text content, retrying until
95
+ * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when
96
+ * none or more than one matches.
79
97
  */
80
98
  const findByText = builtinQueries.findByText;
81
99
  /**
82
- * Returns the single widget with a matching widget name, or null when none match.
83
- * Throws when more than one matches.
100
+ * Returns the single mapped widget with a matching widget name, or null when none match. Widgets
101
+ * that are not mapped are never matched. Throws when more than one matches.
84
102
  */
85
103
  const queryByName = builtinQueries.queryByName;
86
- /** Returns every widget with a matching widget name. Throws when none match. */
104
+ /**
105
+ * Returns every mapped widget with a matching widget name. Widgets that are not mapped are never
106
+ * matched. Throws when none match.
107
+ */
87
108
  const getAllByName = builtinQueries.getAllByName;
88
- /** Returns the single widget with a matching widget name. Throws when none or more than one matches. */
109
+ /**
110
+ * Returns the single mapped widget with a matching widget name. Widgets that are not mapped are
111
+ * never matched. Throws when none or more than one matches.
112
+ */
89
113
  const getByName = builtinQueries.getByName;
90
114
  /**
91
- * Waits for and returns every widget with a matching widget name, retrying until at least one
92
- * appears or the timeout elapses.
115
+ * Waits for and returns every mapped widget with a matching widget name, retrying until at least one
116
+ * appears or the timeout elapses. Widgets that are not mapped are never matched.
93
117
  */
94
118
  const findAllByName = builtinQueries.findAllByName;
95
119
  /**
96
- * Waits for and returns the single widget with a matching widget name, retrying until it appears or
97
- * the timeout elapses. Rejects when none or more than one matches.
120
+ * Waits for and returns the single mapped widget with a matching widget name, retrying until it
121
+ * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
122
+ * or more than one matches.
98
123
  */
99
124
  const findByName = builtinQueries.findByName;
100
125
  /**
101
- * Returns the single widget with matching placeholder text, or null when none match.
102
- * Throws when more than one matches.
126
+ * Returns the single mapped widget with matching placeholder text, or null when none match. Widgets
127
+ * that are not mapped are never matched. Throws when more than one matches.
103
128
  */
104
129
  const queryByPlaceholderText = builtinQueries.queryByPlaceholderText;
105
- /** Returns every widget with matching placeholder text. Throws when none match. */
130
+ /**
131
+ * Returns every mapped widget with matching placeholder text. Widgets that are not mapped are never
132
+ * matched. Throws when none match.
133
+ */
106
134
  const getAllByPlaceholderText = builtinQueries.getAllByPlaceholderText;
107
- /** Returns the single widget with matching placeholder text. Throws when none or more than one matches. */
135
+ /**
136
+ * Returns the single mapped widget with matching placeholder text. Widgets that are not mapped are
137
+ * never matched. Throws when none or more than one matches.
138
+ */
108
139
  const getByPlaceholderText = builtinQueries.getByPlaceholderText;
109
140
  /**
110
- * Waits for and returns every widget with matching placeholder text, retrying until at least one
111
- * appears or the timeout elapses.
141
+ * Waits for and returns every mapped widget with matching placeholder text, retrying until at least
142
+ * one appears or the timeout elapses. Widgets that are not mapped are never matched.
112
143
  */
113
144
  const findAllByPlaceholderText = builtinQueries.findAllByPlaceholderText;
114
145
  /**
115
- * Waits for and returns the single widget with matching placeholder text, retrying until it appears
116
- * or the timeout elapses. Rejects when none or more than one matches.
146
+ * Waits for and returns the single mapped widget with matching placeholder text, retrying until it
147
+ * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
148
+ * or more than one matches.
117
149
  */
118
150
  const findByPlaceholderText = builtinQueries.findByPlaceholderText;
119
151
  /**
120
- * Returns the single widget with a matching display value, or null when none match.
121
- * Throws when more than one matches.
152
+ * Returns the single mapped widget with a matching display value, or null when none match. Widgets
153
+ * that are not mapped are never matched. Throws when more than one matches.
122
154
  */
123
155
  const queryByDisplayValue = builtinQueries.queryByDisplayValue;
124
- /** Returns every widget with a matching display value. Throws when none match. */
156
+ /**
157
+ * Returns every mapped widget with a matching display value. Widgets that are not mapped are never
158
+ * matched. Throws when none match.
159
+ */
125
160
  const getAllByDisplayValue = builtinQueries.getAllByDisplayValue;
126
- /** Returns the single widget with a matching display value. Throws when none or more than one matches. */
161
+ /**
162
+ * Returns the single mapped widget with a matching display value. Widgets that are not mapped are
163
+ * never matched. Throws when none or more than one matches.
164
+ */
127
165
  const getByDisplayValue = builtinQueries.getByDisplayValue;
128
166
  /**
129
- * Waits for and returns every widget with a matching display value, retrying until at least one
130
- * appears or the timeout elapses.
167
+ * Waits for and returns every mapped widget with a matching display value, retrying until at least
168
+ * one appears or the timeout elapses. Widgets that are not mapped are never matched.
131
169
  */
132
170
  const findAllByDisplayValue = builtinQueries.findAllByDisplayValue;
133
171
  /**
134
- * Waits for and returns the single widget with a matching display value, retrying until it appears
135
- * or the timeout elapses. Rejects when none or more than one matches.
172
+ * Waits for and returns the single mapped widget with a matching display value, retrying until it
173
+ * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none
174
+ * or more than one matches.
136
175
  */
137
176
  const findByDisplayValue = builtinQueries.findByDisplayValue;
138
177
  const buildNormalizer = (options) => {
@@ -176,20 +215,19 @@ const hasMatchingAccessibleName = (widget, options) => {
176
215
  const text = getWidgetAccessibleName(widget);
177
216
  return isTextMatch(text, options.name, widget, options);
178
217
  };
179
- const isNumericValueMatch = (expected, actual) => expected === undefined || actual === expected;
218
+ const isNumericValueMatch = (widget, field, expected) => expected === undefined || isWidgetValueMatch(widget, field, expected);
180
219
  const hasMatchingAccessibleValue = (widget, value, options) => {
181
- const actual = getWidgetValue(widget);
182
220
  const numericChecks = [
183
- [value.now, actual.now],
184
- [value.min, actual.min],
185
- [value.max, actual.max],
221
+ ["now", value.now],
222
+ ["min", value.min],
223
+ ["max", value.max],
186
224
  ];
187
- for (const [expected, current] of numericChecks) {
188
- if (!isNumericValueMatch(expected, current)) {
225
+ for (const [field, expected] of numericChecks) {
226
+ if (!isNumericValueMatch(widget, field, expected)) {
189
227
  return false;
190
228
  }
191
229
  }
192
- return value.text === undefined || isTextMatch(actual.text, value.text, widget, options);
230
+ return value.text === undefined || isTextMatch(getWidgetValueText(widget), value.text, widget, options);
193
231
  };
194
232
  const hasMatchingBooleanStates = (widget, options) => {
195
233
  const stateChecks = [
@@ -224,18 +262,20 @@ const hasMatchingByRoleOptions = (widget, options) => {
224
262
  hasMatchingAccessibleStates(widget, options));
225
263
  };
226
264
  function nameQueryFamily(suffix, queryAllBy, built) {
265
+ const [queryBy, getAllBy, getBy, findAllBy, findBy] = built;
227
266
  return {
228
- [`queryBy${suffix}`]: built.queryBy,
267
+ [`queryBy${suffix}`]: queryBy,
229
268
  [`queryAllBy${suffix}`]: queryAllBy,
230
- [`getBy${suffix}`]: built.getBy,
231
- [`getAllBy${suffix}`]: built.getAllBy,
232
- [`findBy${suffix}`]: built.findBy,
233
- [`findAllBy${suffix}`]: built.findAllBy,
269
+ [`getBy${suffix}`]: getBy,
270
+ [`getAllBy${suffix}`]: getAllBy,
271
+ [`findBy${suffix}`]: findBy,
272
+ [`findAllBy${suffix}`]: findAllBy,
234
273
  };
235
274
  }
236
275
  /**
237
276
  * Finds every widget under the container whose accessible role matches `role` and that satisfies the given options.
238
- * Widgets excluded from the accessibility tree are skipped unless `options.hidden` is set.
277
+ * Widgets that are not mapped are never matched, and widgets excluded from the accessibility tree are
278
+ * skipped unless `options.hidden` is set.
239
279
  * @param container Widget subtree to search.
240
280
  * @param role Accessible role to match.
241
281
  * @param options Additional accessible name, state, and value constraints.
@@ -256,29 +296,29 @@ const collectMnemonicMatch = (widget, text, options) => {
256
296
  if (!(widget instanceof Gtk.Label)) {
257
297
  return null;
258
298
  }
259
- const labelText = widget.getLabel();
299
+ const labelText = namingLabelText(widget);
260
300
  if (!labelText || !isTextMatch(labelText, text, widget, options)) {
261
301
  return null;
262
302
  }
263
303
  return widget.getMnemonicWidget();
264
304
  };
305
+ const labellingText = (widget) => {
306
+ const ownLabel = widget.getAccessibleRole() === Gtk.AccessibleRole.LABEL ? null : getWidgetOwnLabel(widget);
307
+ return ownLabel ?? getWidgetExternalLabelText(widget);
308
+ };
265
309
  const collectLabelMatches = (results, widget, text, options) => {
266
310
  const mnemonicTarget = collectMnemonicMatch(widget, text, options);
267
311
  if (mnemonicTarget) {
268
312
  results.add(mnemonicTarget);
269
313
  }
270
- const ownLabel = getWidgetOwnLabel(widget);
271
- if (ownLabel !== null && isTextMatch(ownLabel, text, widget, options)) {
272
- results.add(widget);
273
- }
274
- const labelledByText = getWidgetLabelledByText(widget);
275
- if (labelledByText !== null && isTextMatch(labelledByText, text, widget, options)) {
314
+ const labelText = labellingText(widget);
315
+ if (labelText !== null && isTextMatch(labelText, text, widget, options)) {
276
316
  results.add(widget);
277
317
  }
278
318
  };
279
319
  /**
280
320
  * Finds every widget associated with a label whose text matches: a Gtk.Label mnemonic target, the
281
- * widget's own accessible label, or its labelled-by relation.
321
+ * widget's own accessible label, or its labelled-by relation. Widgets that are not mapped are never matched.
282
322
  * @param container Widget subtree to search.
283
323
  * @param text Matcher for the label text.
284
324
  * @param options Text matching options.
@@ -292,7 +332,7 @@ function queryAllByLabelText(container, text, options) {
292
332
  return [...results].filter((widget) => isMatchingWidgetType(widget, options));
293
333
  }
294
334
  /**
295
- * Finds every widget whose rendered text content matches.
335
+ * Finds every widget whose rendered text content matches. Widgets that are not mapped are never matched.
296
336
  * @param container Widget subtree to search.
297
337
  * @param text Matcher for the widget text.
298
338
  * @param options Text matching options.
@@ -302,7 +342,7 @@ function queryAllByText(container, text, options) {
302
342
  return findAll(container, (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetLabelText(widget), text, widget, options));
303
343
  }
304
344
  /**
305
- * Finds every widget whose widget name matches.
345
+ * Finds every widget whose widget name matches. Widgets that are not mapped are never matched.
306
346
  * @param container Widget subtree to search.
307
347
  * @param name Matcher for the widget name.
308
348
  * @param options Text matching options.
@@ -312,7 +352,7 @@ function queryAllByName(container, name, options) {
312
352
  return findAll(container, (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetName(widget), name, widget, options));
313
353
  }
314
354
  /**
315
- * Finds every widget whose placeholder text matches.
355
+ * Finds every widget whose placeholder text matches. Widgets that are not mapped are never matched.
316
356
  * @param container Widget subtree to search.
317
357
  * @param text Matcher for the placeholder text.
318
358
  * @param options Text matching options.
@@ -323,7 +363,7 @@ function queryAllByPlaceholderText(container, text, options) {
323
363
  isTextMatch(getWidgetPlaceholderText(widget), text, widget, options));
324
364
  }
325
365
  /**
326
- * Finds every widget whose current display value matches.
366
+ * Finds every widget whose current display value matches. Widgets that are not mapped are never matched.
327
367
  * @param container Widget subtree to search.
328
368
  * @param value Matcher for the display value.
329
369
  * @param options Text matching options.
@@ -333,5 +373,5 @@ function queryAllByDisplayValue(container, value, options) {
333
373
  return findAll(container, (widget) => isMatchingWidgetType(widget, options) &&
334
374
  isTextMatch(getWidgetDisplayValue(widget), value, widget, options));
335
375
  }
336
- 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, };
376
+ export { builtinQueries, isMatchingWidgetType, isTextMatch, 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, };
337
377
  //# sourceMappingURL=queries.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"queries.js","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport type {\n ByRoleOptions,\n ByRoleValue,\n Matcher,\n MatcherOptions,\n NormalizerFn,\n QueryFamilies,\n} from \"./types.js\";\nimport { buildQueries, type BuiltQueries, type QueryAllBy } from \"./build-queries.js\";\nimport { multipleFoundError, notFoundError } from \"./errors.js\";\nimport { getDefaultNormalizer } from \"./normalize.js\";\nimport { type Container, findAll, traverse } from \"./traversal.js\";\nimport {\n getWidgetAccessibleName,\n getWidgetBusyState,\n getWidgetDescription,\n getWidgetDisplayValue,\n getWidgetExpandedState,\n getWidgetLabelledByText,\n getWidgetLabelText,\n getWidgetLevel,\n getWidgetName,\n getWidgetOwnLabel,\n getWidgetPlaceholderText,\n getWidgetPressedState,\n getWidgetSelectedState,\n getWidgetValue,\n isInaccessible,\n isWidgetChecked,\n} from \"./widget-accessible-properties.js\";\n\ntype BuiltinQueries = QueryFamilies<[container: Container]>;\n\nconst roleQueries = nameQueryFamily(\n \"Role\",\n queryAllByRole,\n buildQueries<[role: Gtk.AccessibleRole, options?: ByRoleOptions]>(\n \"Role\",\n queryAllByRole,\n (container, matches, role, options) =>\n multipleFoundError(container, { queryType: \"role\", role, options }, matches),\n (container, role, options) => notFoundError(container, { queryType: \"role\", role, options }),\n ),\n);\n\nconst labelTextQueries = nameQueryFamily(\n \"LabelText\",\n queryAllByLabelText,\n buildQueries<[text: Matcher, options?: MatcherOptions]>(\n \"LabelText\",\n queryAllByLabelText,\n (container, matches, text) => multipleFoundError(container, { queryType: \"labelText\", text }, matches),\n (container, text) => notFoundError(container, { queryType: \"labelText\", text }),\n ),\n);\n\nconst textQueries = nameQueryFamily(\n \"Text\",\n queryAllByText,\n buildQueries<[text: Matcher, options?: MatcherOptions]>(\n \"Text\",\n queryAllByText,\n (container, matches, text) => multipleFoundError(container, { queryType: \"text\", text }, matches),\n (container, text) => notFoundError(container, { queryType: \"text\", text }),\n ),\n);\n\nconst nameQueries = nameQueryFamily(\n \"Name\",\n queryAllByName,\n buildQueries<[name: Matcher, options?: MatcherOptions]>(\n \"Name\",\n queryAllByName,\n (container, matches, name) => multipleFoundError(container, { queryType: \"name\", name }, matches),\n (container, name) => notFoundError(container, { queryType: \"name\", name }),\n ),\n);\n\nconst placeholderTextQueries = nameQueryFamily(\n \"PlaceholderText\",\n queryAllByPlaceholderText,\n buildQueries<[text: Matcher, options?: MatcherOptions]>(\n \"PlaceholderText\",\n queryAllByPlaceholderText,\n (container, matches, text) => multipleFoundError(container, { queryType: \"placeholderText\", text }, matches),\n (container, text) => notFoundError(container, { queryType: \"placeholderText\", text }),\n ),\n);\n\nconst displayValueQueries = nameQueryFamily(\n \"DisplayValue\",\n queryAllByDisplayValue,\n buildQueries<[value: Matcher, options?: MatcherOptions]>(\n \"DisplayValue\",\n queryAllByDisplayValue,\n (container, matches, value) => multipleFoundError(container, { queryType: \"displayValue\", value }, matches),\n (container, value) => notFoundError(container, { queryType: \"displayValue\", value }),\n ),\n);\n\nconst builtinQueries = {\n ...roleQueries,\n ...labelTextQueries,\n ...textQueries,\n ...nameQueries,\n ...placeholderTextQueries,\n ...displayValueQueries,\n} as BuiltinQueries;\n\n/**\n * Returns the single widget with a matching accessible role and options, or null when none match.\n * Throws when more than one matches.\n */\nconst queryByRole: BuiltinQueries[\"queryByRole\"] = builtinQueries.queryByRole;\n/** Returns every widget with a matching accessible role and options. Throws when none match. */\nconst getAllByRole: BuiltinQueries[\"getAllByRole\"] = builtinQueries.getAllByRole;\n/**\n * Returns the single widget with a matching accessible role and options.\n * Throws when none or more than one matches.\n */\nconst getByRole: BuiltinQueries[\"getByRole\"] = builtinQueries.getByRole;\n/**\n * Waits for and returns every widget with a matching accessible role and options, retrying until at\n * least one appears or the timeout elapses.\n */\nconst findAllByRole: BuiltinQueries[\"findAllByRole\"] = builtinQueries.findAllByRole;\n/**\n * Waits for and returns the single widget with a matching accessible role and options, retrying\n * until it appears or the timeout elapses. Rejects when none or more than one matches.\n */\nconst findByRole: BuiltinQueries[\"findByRole\"] = builtinQueries.findByRole;\n/**\n * Returns the single widget with matching associated label text, or null when none match.\n * Throws when more than one matches.\n */\nconst queryByLabelText: BuiltinQueries[\"queryByLabelText\"] = builtinQueries.queryByLabelText;\n/** Returns every widget with matching associated label text. Throws when none match. */\nconst getAllByLabelText: BuiltinQueries[\"getAllByLabelText\"] = builtinQueries.getAllByLabelText;\n/** Returns the single widget with matching associated label text. Throws when none or more than one matches. */\nconst getByLabelText: BuiltinQueries[\"getByLabelText\"] = builtinQueries.getByLabelText;\n/**\n * Waits for and returns every widget with matching associated label text, retrying until at least\n * one appears or the timeout elapses.\n */\nconst findAllByLabelText: BuiltinQueries[\"findAllByLabelText\"] = builtinQueries.findAllByLabelText;\n/**\n * Waits for and returns the single widget with matching associated label text, retrying until it\n * appears or the timeout elapses. Rejects when none or more than one matches.\n */\nconst findByLabelText: BuiltinQueries[\"findByLabelText\"] = builtinQueries.findByLabelText;\n/**\n * Returns the single widget with matching rendered text content, or null when none match.\n * Throws when more than one matches.\n */\nconst queryByText: BuiltinQueries[\"queryByText\"] = builtinQueries.queryByText;\n/** Returns every widget with matching rendered text content. Throws when none match. */\nconst getAllByText: BuiltinQueries[\"getAllByText\"] = builtinQueries.getAllByText;\n/** Returns the single widget with matching rendered text content. Throws when none or more than one matches. */\nconst getByText: BuiltinQueries[\"getByText\"] = builtinQueries.getByText;\n/**\n * Waits for and returns every widget with matching rendered text content, retrying until at least\n * one appears or the timeout elapses.\n */\nconst findAllByText: BuiltinQueries[\"findAllByText\"] = builtinQueries.findAllByText;\n/**\n * Waits for and returns the single widget with matching rendered text content, retrying until it\n * appears or the timeout elapses. Rejects when none or more than one matches.\n */\nconst findByText: BuiltinQueries[\"findByText\"] = builtinQueries.findByText;\n/**\n * Returns the single widget with a matching widget name, or null when none match.\n * Throws when more than one matches.\n */\nconst queryByName: BuiltinQueries[\"queryByName\"] = builtinQueries.queryByName;\n/** Returns every widget with a matching widget name. Throws when none match. */\nconst getAllByName: BuiltinQueries[\"getAllByName\"] = builtinQueries.getAllByName;\n/** Returns the single widget with a matching widget name. Throws when none or more than one matches. */\nconst getByName: BuiltinQueries[\"getByName\"] = builtinQueries.getByName;\n/**\n * Waits for and returns every widget with a matching widget name, retrying until at least one\n * appears or the timeout elapses.\n */\nconst findAllByName: BuiltinQueries[\"findAllByName\"] = builtinQueries.findAllByName;\n/**\n * Waits for and returns the single widget with a matching widget name, retrying until it appears or\n * the timeout elapses. Rejects when none or more than one matches.\n */\nconst findByName: BuiltinQueries[\"findByName\"] = builtinQueries.findByName;\n/**\n * Returns the single widget with matching placeholder text, or null when none match.\n * Throws when more than one matches.\n */\nconst queryByPlaceholderText: BuiltinQueries[\"queryByPlaceholderText\"] = builtinQueries.queryByPlaceholderText;\n/** Returns every widget with matching placeholder text. Throws when none match. */\nconst getAllByPlaceholderText: BuiltinQueries[\"getAllByPlaceholderText\"] = builtinQueries.getAllByPlaceholderText;\n/** Returns the single widget with matching placeholder text. Throws when none or more than one matches. */\nconst getByPlaceholderText: BuiltinQueries[\"getByPlaceholderText\"] = builtinQueries.getByPlaceholderText;\n/**\n * Waits for and returns every widget with matching placeholder text, retrying until at least one\n * appears or the timeout elapses.\n */\nconst findAllByPlaceholderText: BuiltinQueries[\"findAllByPlaceholderText\"] = builtinQueries.findAllByPlaceholderText;\n/**\n * Waits for and returns the single widget with matching placeholder text, retrying until it appears\n * or the timeout elapses. Rejects when none or more than one matches.\n */\nconst findByPlaceholderText: BuiltinQueries[\"findByPlaceholderText\"] = builtinQueries.findByPlaceholderText;\n/**\n * Returns the single widget with a matching display value, or null when none match.\n * Throws when more than one matches.\n */\nconst queryByDisplayValue: BuiltinQueries[\"queryByDisplayValue\"] = builtinQueries.queryByDisplayValue;\n/** Returns every widget with a matching display value. Throws when none match. */\nconst getAllByDisplayValue: BuiltinQueries[\"getAllByDisplayValue\"] = builtinQueries.getAllByDisplayValue;\n/** Returns the single widget with a matching display value. Throws when none or more than one matches. */\nconst getByDisplayValue: BuiltinQueries[\"getByDisplayValue\"] = builtinQueries.getByDisplayValue;\n/**\n * Waits for and returns every widget with a matching display value, retrying until at least one\n * appears or the timeout elapses.\n */\nconst findAllByDisplayValue: BuiltinQueries[\"findAllByDisplayValue\"] = builtinQueries.findAllByDisplayValue;\n/**\n * Waits for and returns the single widget with a matching display value, retrying until it appears\n * or the timeout elapses. Rejects when none or more than one matches.\n */\nconst findByDisplayValue: BuiltinQueries[\"findByDisplayValue\"] = builtinQueries.findByDisplayValue;\n\nconst buildNormalizer = (options?: MatcherOptions): NormalizerFn => {\n const { normalizer, trim, collapseWhitespace } = options ?? {};\n\n if (!normalizer) {\n return getDefaultNormalizer({ trim, collapseWhitespace });\n }\n\n if (trim !== undefined || collapseWhitespace !== undefined) {\n throw new Error(\n \"trim and collapseWhitespace are not supported with a normalizer. \" +\n \"If you want to use the default trim and collapseWhitespace logic in your normalizer, \" +\n \"use \\\"getDefaultNormalizer({ trim, collapseWhitespace })\\\" and compose that into your normalizer\",\n );\n }\n\n return normalizer;\n};\n\nconst normalizeText = (text: string, options?: MatcherOptions): string => {\n const normalizer = buildNormalizer(options);\n\n return normalizer(text);\n};\n\nconst isTextMatch = (\n actual: string | null,\n expected: Matcher,\n widget: Gtk.Widget,\n options?: MatcherOptions,\n): boolean => {\n if (actual === null) {\n return false;\n }\n\n const normalizedActual = normalizeText(actual, options);\n\n if (typeof expected === \"function\") {\n return expected(normalizedActual, widget);\n }\n\n if (expected instanceof RegExp) {\n expected.lastIndex = 0;\n\n return expected.test(normalizedActual);\n }\n\n const normalizedExpected = normalizeText(String(expected), options);\n const isExact = options?.exact ?? true;\n\n return isExact\n ? normalizedActual === normalizedExpected\n : normalizedActual.toLowerCase().includes(normalizedExpected.toLowerCase());\n};\n\nconst hasMatchingAccessibleName = (widget: Gtk.Widget, options: ByRoleOptions): boolean => {\n if (options.name === undefined) {\n return true;\n }\n\n const text = getWidgetAccessibleName(widget);\n\n return isTextMatch(text, options.name, widget, options);\n};\n\nconst isNumericValueMatch = (expected: number | undefined, actual: number | null): boolean =>\n expected === undefined || actual === expected;\n\nconst hasMatchingAccessibleValue = (widget: Gtk.Widget, value: ByRoleValue, options: ByRoleOptions): boolean => {\n const actual = getWidgetValue(widget);\n\n const numericChecks: [number | undefined, number | null][] = [\n [value.now, actual.now],\n [value.min, actual.min],\n [value.max, actual.max],\n ];\n\n for (const [expected, current] of numericChecks) {\n if (!isNumericValueMatch(expected, current)) {\n return false;\n }\n }\n\n return value.text === undefined || isTextMatch(actual.text, value.text, widget, options);\n};\n\nconst hasMatchingBooleanStates = (widget: Gtk.Widget, options: ByRoleOptions): boolean => {\n const stateChecks: [boolean | undefined, () => boolean | null][] = [\n [options.checked, () => isWidgetChecked(widget)],\n [options.pressed, () => getWidgetPressedState(widget)],\n [options.expanded, () => getWidgetExpandedState(widget)],\n [options.selected, () => getWidgetSelectedState(widget)],\n [options.busy, () => getWidgetBusyState(widget) ?? false],\n ];\n\n for (const [expected, getActual] of stateChecks) {\n if (expected !== undefined && getActual() !== expected) {\n return false;\n }\n }\n\n return true;\n};\n\nconst hasMatchingLevelState = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n options.level === undefined || getWidgetLevel(widget) === options.level;\n\nconst hasMatchingDescriptionState = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n options.description === undefined ||\n isTextMatch(getWidgetDescription(widget), options.description, widget, options);\n\nconst hasMatchingValueState = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n options.value === undefined || hasMatchingAccessibleValue(widget, options.value, options);\n\nconst hasMatchingAccessibleStates = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n hasMatchingBooleanStates(widget, options) &&\n hasMatchingLevelState(widget, options) &&\n hasMatchingDescriptionState(widget, options) &&\n hasMatchingValueState(widget, options);\n\nconst isMatchingWidgetType = (widget: Gtk.Widget, options?: MatcherOptions): boolean =>\n options?.as === undefined || widget instanceof options.as;\n\nconst hasMatchingByRoleOptions = (widget: Gtk.Widget, options?: ByRoleOptions): boolean => {\n if (!options) {\n return true;\n }\n\n return (\n isMatchingWidgetType(widget, options) &&\n hasMatchingAccessibleName(widget, options) &&\n hasMatchingAccessibleStates(widget, options)\n );\n};\n\nfunction nameQueryFamily<Args extends unknown[]>(\n suffix: string,\n queryAllBy: QueryAllBy<Args>,\n built: BuiltQueries<Args>,\n): Record<string, unknown> {\n return {\n [`queryBy${suffix}`]: built.queryBy,\n [`queryAllBy${suffix}`]: queryAllBy,\n [`getBy${suffix}`]: built.getBy,\n [`getAllBy${suffix}`]: built.getAllBy,\n [`findBy${suffix}`]: built.findBy,\n [`findAllBy${suffix}`]: built.findAllBy,\n };\n}\n\n/**\n * Finds every widget under the container whose accessible role matches `role` and that satisfies the given options.\n * Widgets excluded from the accessibility tree are skipped unless `options.hidden` is set.\n * @param container Widget subtree to search.\n * @param role Accessible role to match.\n * @param options Additional accessible name, state, and value constraints.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByRole(\n container: Container,\n role: Gtk.AccessibleRole,\n options?: ByRoleOptions,\n): Gtk.Widget[] {\n return findAll(container, (widget) => {\n if (widget.getAccessibleRole() !== role) {\n return false;\n }\n\n if (!options?.hidden && isInaccessible(widget)) {\n return false;\n }\n\n return hasMatchingByRoleOptions(widget, options);\n });\n}\n\nconst collectMnemonicMatch = (\n widget: Gtk.Widget,\n text: Matcher,\n options: MatcherOptions | undefined,\n): Gtk.Widget | null => {\n if (!(widget instanceof Gtk.Label)) {\n return null;\n }\n\n const labelText = widget.getLabel();\n\n if (!labelText || !isTextMatch(labelText, text, widget, options)) {\n return null;\n }\n\n return widget.getMnemonicWidget();\n};\n\nconst collectLabelMatches = (\n results: Set<Gtk.Widget>,\n widget: Gtk.Widget,\n text: Matcher,\n options: MatcherOptions | undefined,\n): void => {\n const mnemonicTarget = collectMnemonicMatch(widget, text, options);\n\n if (mnemonicTarget) {\n results.add(mnemonicTarget);\n }\n\n const ownLabel = getWidgetOwnLabel(widget);\n\n if (ownLabel !== null && isTextMatch(ownLabel, text, widget, options)) {\n results.add(widget);\n }\n\n const labelledByText = getWidgetLabelledByText(widget);\n\n if (labelledByText !== null && isTextMatch(labelledByText, text, widget, options)) {\n results.add(widget);\n }\n};\n\n/**\n * Finds every widget associated with a label whose text matches: a Gtk.Label mnemonic target, the\n * widget's own accessible label, or its labelled-by relation.\n * @param container Widget subtree to search.\n * @param text Matcher for the label text.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByLabelText(container: Container, text: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n const results: Set<Gtk.Widget> = new Set();\n\n for (const widget of traverse(container)) {\n collectLabelMatches(results, widget, text, options);\n }\n\n return [...results].filter((widget) => isMatchingWidgetType(widget, options));\n}\n\n/**\n * Finds every widget whose rendered text content matches.\n * @param container Widget subtree to search.\n * @param text Matcher for the widget text.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByText(container: Container, text: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n return findAll(\n container,\n (widget) =>\n isMatchingWidgetType(widget, options) && isTextMatch(getWidgetLabelText(widget), text, widget, options),\n );\n}\n\n/**\n * Finds every widget whose widget name matches.\n * @param container Widget subtree to search.\n * @param name Matcher for the widget name.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByName(container: Container, name: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n return findAll(\n container,\n (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetName(widget), name, widget, options),\n );\n}\n\n/**\n * Finds every widget whose placeholder text matches.\n * @param container Widget subtree to search.\n * @param text Matcher for the placeholder text.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByPlaceholderText(\n container: Container,\n text: Matcher,\n options?: MatcherOptions,\n): Gtk.Widget[] {\n return findAll(\n container,\n (widget) =>\n isMatchingWidgetType(widget, options) &&\n isTextMatch(getWidgetPlaceholderText(widget), text, widget, options),\n );\n}\n\n/**\n * Finds every widget whose current display value matches.\n * @param container Widget subtree to search.\n * @param value Matcher for the display value.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByDisplayValue(container: Container, value: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n return findAll(\n container,\n (widget) =>\n isMatchingWidgetType(widget, options) &&\n isTextMatch(getWidgetDisplayValue(widget), value, widget, options),\n );\n}\n\nexport {\n builtinQueries,\n queryByRole,\n getAllByRole,\n getByRole,\n findAllByRole,\n findByRole,\n queryByLabelText,\n getAllByLabelText,\n getByLabelText,\n findAllByLabelText,\n findByLabelText,\n queryByText,\n getAllByText,\n getByText,\n findAllByText,\n findByText,\n queryByName,\n getAllByName,\n getByName,\n findAllByName,\n findByName,\n queryByPlaceholderText,\n getAllByPlaceholderText,\n getByPlaceholderText,\n findAllByPlaceholderText,\n findByPlaceholderText,\n queryByDisplayValue,\n getAllByDisplayValue,\n getByDisplayValue,\n findAllByDisplayValue,\n findByDisplayValue,\n queryAllByRole,\n queryAllByLabelText,\n queryAllByText,\n queryAllByName,\n queryAllByPlaceholderText,\n queryAllByDisplayValue,\n type BuiltinQueries,\n};\n"]}
1
+ {"version":3,"file":"queries.js","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport type {\n ByRoleOptions,\n ByRoleValue,\n Matcher,\n MatcherOptions,\n NormalizerFn,\n QueryFamilies,\n} from \"./types.js\";\nimport { buildQueries, type BuiltQueries, type QueryAllBy } from \"./build-queries.js\";\nimport { multipleFoundError, notFoundError } from \"./errors.js\";\nimport { getDefaultNormalizer } from \"./normalize.js\";\nimport { type Container, findAll, traverse } from \"./traversal.js\";\nimport {\n getWidgetAccessibleName,\n getWidgetBusyState,\n getWidgetDescription,\n getWidgetDisplayValue,\n getWidgetExpandedState,\n getWidgetExternalLabelText,\n getWidgetLabelText,\n getWidgetLevel,\n getWidgetName,\n getWidgetOwnLabel,\n getWidgetPlaceholderText,\n getWidgetPressedState,\n getWidgetSelectedState,\n getWidgetValueText,\n isInaccessible,\n isWidgetChecked,\n isWidgetValueMatch,\n namingLabelText,\n type WidgetValueField,\n} from \"./widget-accessible-properties.js\";\n\n/** The built-in queries in their unbound form, each taking the container to search as its first argument. */\ntype BuiltinQueries = QueryFamilies<[container: Container]>;\n\nconst roleQueries = nameQueryFamily(\n \"Role\",\n queryAllByRole,\n buildQueries<[role: Gtk.AccessibleRole, options?: ByRoleOptions]>(\n queryAllByRole,\n (container, matches, role, options) =>\n multipleFoundError(container, { queryType: \"role\", role, options }, matches),\n (container, role, options) => notFoundError(container, { queryType: \"role\", role, options }),\n ),\n);\n\nconst labelTextQueries = nameQueryFamily(\n \"LabelText\",\n queryAllByLabelText,\n buildQueries<[text: Matcher, options?: MatcherOptions]>(\n queryAllByLabelText,\n (container, matches, text) => multipleFoundError(container, { queryType: \"labelText\", text }, matches),\n (container, text) => notFoundError(container, { queryType: \"labelText\", text }),\n ),\n);\n\nconst textQueries = nameQueryFamily(\n \"Text\",\n queryAllByText,\n buildQueries<[text: Matcher, options?: MatcherOptions]>(\n queryAllByText,\n (container, matches, text) => multipleFoundError(container, { queryType: \"text\", text }, matches),\n (container, text) => notFoundError(container, { queryType: \"text\", text }),\n ),\n);\n\nconst nameQueries = nameQueryFamily(\n \"Name\",\n queryAllByName,\n buildQueries<[name: Matcher, options?: MatcherOptions]>(\n queryAllByName,\n (container, matches, name) => multipleFoundError(container, { queryType: \"name\", name }, matches),\n (container, name) => notFoundError(container, { queryType: \"name\", name }),\n ),\n);\n\nconst placeholderTextQueries = nameQueryFamily(\n \"PlaceholderText\",\n queryAllByPlaceholderText,\n buildQueries<[text: Matcher, options?: MatcherOptions]>(\n queryAllByPlaceholderText,\n (container, matches, text) => multipleFoundError(container, { queryType: \"placeholderText\", text }, matches),\n (container, text) => notFoundError(container, { queryType: \"placeholderText\", text }),\n ),\n);\n\nconst displayValueQueries = nameQueryFamily(\n \"DisplayValue\",\n queryAllByDisplayValue,\n buildQueries<[value: Matcher, options?: MatcherOptions]>(\n queryAllByDisplayValue,\n (container, matches, value) => multipleFoundError(container, { queryType: \"displayValue\", value }, matches),\n (container, value) => notFoundError(container, { queryType: \"displayValue\", value }),\n ),\n);\n\nconst builtinQueries = {\n ...roleQueries,\n ...labelTextQueries,\n ...textQueries,\n ...nameQueries,\n ...placeholderTextQueries,\n ...displayValueQueries,\n} as BuiltinQueries;\n\n/**\n * Returns the single mapped widget with a matching accessible role and options, or null when none\n * match. Widgets that are not mapped are never matched. Throws when more than one matches.\n */\nconst queryByRole: BuiltinQueries[\"queryByRole\"] = builtinQueries.queryByRole;\n/**\n * Returns every mapped widget with a matching accessible role and options. Widgets that are not\n * mapped are never matched. Throws when none match.\n */\nconst getAllByRole: BuiltinQueries[\"getAllByRole\"] = builtinQueries.getAllByRole;\n/**\n * Returns the single mapped widget with a matching accessible role and options. Widgets that are not\n * mapped are never matched. Throws when none or more than one matches.\n */\nconst getByRole: BuiltinQueries[\"getByRole\"] = builtinQueries.getByRole;\n/**\n * Waits for and returns every mapped widget with a matching accessible role and options, retrying\n * until at least one appears or the timeout elapses. Widgets that are not mapped are never matched.\n */\nconst findAllByRole: BuiltinQueries[\"findAllByRole\"] = builtinQueries.findAllByRole;\n/**\n * Waits for and returns the single mapped widget with a matching accessible role and options,\n * retrying until it appears or the timeout elapses. Widgets that are not mapped are never matched.\n * Rejects when none or more than one matches.\n */\nconst findByRole: BuiltinQueries[\"findByRole\"] = builtinQueries.findByRole;\n/**\n * Returns the single mapped widget with matching associated label text, or null when none match.\n * Widgets that are not mapped are never matched. Throws when more than one matches.\n */\nconst queryByLabelText: BuiltinQueries[\"queryByLabelText\"] = builtinQueries.queryByLabelText;\n/**\n * Returns every mapped widget with matching associated label text. Widgets that are not mapped are\n * never matched. Throws when none match.\n */\nconst getAllByLabelText: BuiltinQueries[\"getAllByLabelText\"] = builtinQueries.getAllByLabelText;\n/**\n * Returns the single mapped widget with matching associated label text. Widgets that are not mapped\n * are never matched. Throws when none or more than one matches.\n */\nconst getByLabelText: BuiltinQueries[\"getByLabelText\"] = builtinQueries.getByLabelText;\n/**\n * Waits for and returns every mapped widget with matching associated label text, retrying until at\n * least one appears or the timeout elapses. Widgets that are not mapped are never matched.\n */\nconst findAllByLabelText: BuiltinQueries[\"findAllByLabelText\"] = builtinQueries.findAllByLabelText;\n/**\n * Waits for and returns the single mapped widget with matching associated label text, retrying until\n * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when\n * none or more than one matches.\n */\nconst findByLabelText: BuiltinQueries[\"findByLabelText\"] = builtinQueries.findByLabelText;\n/**\n * Returns the single mapped widget with matching rendered text content, or null when none match.\n * Widgets that are not mapped are never matched. Throws when more than one matches.\n */\nconst queryByText: BuiltinQueries[\"queryByText\"] = builtinQueries.queryByText;\n/**\n * Returns every mapped widget with matching rendered text content. Widgets that are not mapped are\n * never matched. Throws when none match.\n */\nconst getAllByText: BuiltinQueries[\"getAllByText\"] = builtinQueries.getAllByText;\n/**\n * Returns the single mapped widget with matching rendered text content. Widgets that are not mapped\n * are never matched. Throws when none or more than one matches.\n */\nconst getByText: BuiltinQueries[\"getByText\"] = builtinQueries.getByText;\n/**\n * Waits for and returns every mapped widget with matching rendered text content, retrying until at\n * least one appears or the timeout elapses. Widgets that are not mapped are never matched.\n */\nconst findAllByText: BuiltinQueries[\"findAllByText\"] = builtinQueries.findAllByText;\n/**\n * Waits for and returns the single mapped widget with matching rendered text content, retrying until\n * it appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when\n * none or more than one matches.\n */\nconst findByText: BuiltinQueries[\"findByText\"] = builtinQueries.findByText;\n/**\n * Returns the single mapped widget with a matching widget name, or null when none match. Widgets\n * that are not mapped are never matched. Throws when more than one matches.\n */\nconst queryByName: BuiltinQueries[\"queryByName\"] = builtinQueries.queryByName;\n/**\n * Returns every mapped widget with a matching widget name. Widgets that are not mapped are never\n * matched. Throws when none match.\n */\nconst getAllByName: BuiltinQueries[\"getAllByName\"] = builtinQueries.getAllByName;\n/**\n * Returns the single mapped widget with a matching widget name. Widgets that are not mapped are\n * never matched. Throws when none or more than one matches.\n */\nconst getByName: BuiltinQueries[\"getByName\"] = builtinQueries.getByName;\n/**\n * Waits for and returns every mapped widget with a matching widget name, retrying until at least one\n * appears or the timeout elapses. Widgets that are not mapped are never matched.\n */\nconst findAllByName: BuiltinQueries[\"findAllByName\"] = builtinQueries.findAllByName;\n/**\n * Waits for and returns the single mapped widget with a matching widget name, retrying until it\n * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none\n * or more than one matches.\n */\nconst findByName: BuiltinQueries[\"findByName\"] = builtinQueries.findByName;\n/**\n * Returns the single mapped widget with matching placeholder text, or null when none match. Widgets\n * that are not mapped are never matched. Throws when more than one matches.\n */\nconst queryByPlaceholderText: BuiltinQueries[\"queryByPlaceholderText\"] = builtinQueries.queryByPlaceholderText;\n/**\n * Returns every mapped widget with matching placeholder text. Widgets that are not mapped are never\n * matched. Throws when none match.\n */\nconst getAllByPlaceholderText: BuiltinQueries[\"getAllByPlaceholderText\"] = builtinQueries.getAllByPlaceholderText;\n/**\n * Returns the single mapped widget with matching placeholder text. Widgets that are not mapped are\n * never matched. Throws when none or more than one matches.\n */\nconst getByPlaceholderText: BuiltinQueries[\"getByPlaceholderText\"] = builtinQueries.getByPlaceholderText;\n/**\n * Waits for and returns every mapped widget with matching placeholder text, retrying until at least\n * one appears or the timeout elapses. Widgets that are not mapped are never matched.\n */\nconst findAllByPlaceholderText: BuiltinQueries[\"findAllByPlaceholderText\"] = builtinQueries.findAllByPlaceholderText;\n/**\n * Waits for and returns the single mapped widget with matching placeholder text, retrying until it\n * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none\n * or more than one matches.\n */\nconst findByPlaceholderText: BuiltinQueries[\"findByPlaceholderText\"] = builtinQueries.findByPlaceholderText;\n/**\n * Returns the single mapped widget with a matching display value, or null when none match. Widgets\n * that are not mapped are never matched. Throws when more than one matches.\n */\nconst queryByDisplayValue: BuiltinQueries[\"queryByDisplayValue\"] = builtinQueries.queryByDisplayValue;\n/**\n * Returns every mapped widget with a matching display value. Widgets that are not mapped are never\n * matched. Throws when none match.\n */\nconst getAllByDisplayValue: BuiltinQueries[\"getAllByDisplayValue\"] = builtinQueries.getAllByDisplayValue;\n/**\n * Returns the single mapped widget with a matching display value. Widgets that are not mapped are\n * never matched. Throws when none or more than one matches.\n */\nconst getByDisplayValue: BuiltinQueries[\"getByDisplayValue\"] = builtinQueries.getByDisplayValue;\n/**\n * Waits for and returns every mapped widget with a matching display value, retrying until at least\n * one appears or the timeout elapses. Widgets that are not mapped are never matched.\n */\nconst findAllByDisplayValue: BuiltinQueries[\"findAllByDisplayValue\"] = builtinQueries.findAllByDisplayValue;\n/**\n * Waits for and returns the single mapped widget with a matching display value, retrying until it\n * appears or the timeout elapses. Widgets that are not mapped are never matched. Rejects when none\n * or more than one matches.\n */\nconst findByDisplayValue: BuiltinQueries[\"findByDisplayValue\"] = builtinQueries.findByDisplayValue;\n\nconst buildNormalizer = (options?: MatcherOptions): NormalizerFn => {\n const { normalizer, trim, collapseWhitespace } = options ?? {};\n\n if (!normalizer) {\n return getDefaultNormalizer({ trim, collapseWhitespace });\n }\n\n if (trim !== undefined || collapseWhitespace !== undefined) {\n throw new Error(\n \"trim and collapseWhitespace are not supported with a normalizer. \" +\n \"If you want to use the default trim and collapseWhitespace logic in your normalizer, \" +\n \"use \\\"getDefaultNormalizer({ trim, collapseWhitespace })\\\" and compose that into your normalizer\",\n );\n }\n\n return normalizer;\n};\n\nconst normalizeText = (text: string, options?: MatcherOptions): string => {\n const normalizer = buildNormalizer(options);\n\n return normalizer(text);\n};\n\nconst isTextMatch = (\n actual: string | null,\n expected: Matcher,\n widget: Gtk.Widget,\n options?: MatcherOptions,\n): boolean => {\n if (actual === null) {\n return false;\n }\n\n const normalizedActual = normalizeText(actual, options);\n\n if (typeof expected === \"function\") {\n return expected(normalizedActual, widget);\n }\n\n if (expected instanceof RegExp) {\n expected.lastIndex = 0;\n\n return expected.test(normalizedActual);\n }\n\n const normalizedExpected = normalizeText(String(expected), options);\n const isExact = options?.exact ?? true;\n\n return isExact\n ? normalizedActual === normalizedExpected\n : normalizedActual.toLowerCase().includes(normalizedExpected.toLowerCase());\n};\n\nconst hasMatchingAccessibleName = (widget: Gtk.Widget, options: ByRoleOptions): boolean => {\n if (options.name === undefined) {\n return true;\n }\n\n const text = getWidgetAccessibleName(widget);\n\n return isTextMatch(text, options.name, widget, options);\n};\n\nconst isNumericValueMatch = (widget: Gtk.Widget, field: WidgetValueField, expected: number | undefined): boolean =>\n expected === undefined || isWidgetValueMatch(widget, field, expected);\n\nconst hasMatchingAccessibleValue = (widget: Gtk.Widget, value: ByRoleValue, options: ByRoleOptions): boolean => {\n const numericChecks: [WidgetValueField, number | undefined][] = [\n [\"now\", value.now],\n [\"min\", value.min],\n [\"max\", value.max],\n ];\n\n for (const [field, expected] of numericChecks) {\n if (!isNumericValueMatch(widget, field, expected)) {\n return false;\n }\n }\n\n return value.text === undefined || isTextMatch(getWidgetValueText(widget), value.text, widget, options);\n};\n\nconst hasMatchingBooleanStates = (widget: Gtk.Widget, options: ByRoleOptions): boolean => {\n const stateChecks: [boolean | undefined, () => boolean | null][] = [\n [options.checked, () => isWidgetChecked(widget)],\n [options.pressed, () => getWidgetPressedState(widget)],\n [options.expanded, () => getWidgetExpandedState(widget)],\n [options.selected, () => getWidgetSelectedState(widget)],\n [options.busy, () => getWidgetBusyState(widget) ?? false],\n ];\n\n for (const [expected, getActual] of stateChecks) {\n if (expected !== undefined && getActual() !== expected) {\n return false;\n }\n }\n\n return true;\n};\n\nconst hasMatchingLevelState = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n options.level === undefined || getWidgetLevel(widget) === options.level;\n\nconst hasMatchingDescriptionState = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n options.description === undefined ||\n isTextMatch(getWidgetDescription(widget), options.description, widget, options);\n\nconst hasMatchingValueState = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n options.value === undefined || hasMatchingAccessibleValue(widget, options.value, options);\n\nconst hasMatchingAccessibleStates = (widget: Gtk.Widget, options: ByRoleOptions): boolean =>\n hasMatchingBooleanStates(widget, options) &&\n hasMatchingLevelState(widget, options) &&\n hasMatchingDescriptionState(widget, options) &&\n hasMatchingValueState(widget, options);\n\nconst isMatchingWidgetType = (widget: Gtk.Widget, options?: MatcherOptions): boolean =>\n options?.as === undefined || widget instanceof options.as;\n\nconst hasMatchingByRoleOptions = (widget: Gtk.Widget, options?: ByRoleOptions): boolean => {\n if (!options) {\n return true;\n }\n\n return (\n isMatchingWidgetType(widget, options) &&\n hasMatchingAccessibleName(widget, options) &&\n hasMatchingAccessibleStates(widget, options)\n );\n};\n\nfunction nameQueryFamily<Args extends unknown[]>(\n suffix: string,\n queryAllBy: QueryAllBy<Args>,\n built: BuiltQueries<Args>,\n): Record<string, unknown> {\n const [queryBy, getAllBy, getBy, findAllBy, findBy] = built;\n\n return {\n [`queryBy${suffix}`]: queryBy,\n [`queryAllBy${suffix}`]: queryAllBy,\n [`getBy${suffix}`]: getBy,\n [`getAllBy${suffix}`]: getAllBy,\n [`findBy${suffix}`]: findBy,\n [`findAllBy${suffix}`]: findAllBy,\n };\n}\n\n/**\n * Finds every widget under the container whose accessible role matches `role` and that satisfies the given options.\n * Widgets that are not mapped are never matched, and widgets excluded from the accessibility tree are\n * skipped unless `options.hidden` is set.\n * @param container Widget subtree to search.\n * @param role Accessible role to match.\n * @param options Additional accessible name, state, and value constraints.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByRole(\n container: Container,\n role: Gtk.AccessibleRole,\n options?: ByRoleOptions,\n): Gtk.Widget[] {\n return findAll(container, (widget) => {\n if (widget.getAccessibleRole() !== role) {\n return false;\n }\n\n if (!options?.hidden && isInaccessible(widget)) {\n return false;\n }\n\n return hasMatchingByRoleOptions(widget, options);\n });\n}\n\nconst collectMnemonicMatch = (\n widget: Gtk.Widget,\n text: Matcher,\n options: MatcherOptions | undefined,\n): Gtk.Widget | null => {\n if (!(widget instanceof Gtk.Label)) {\n return null;\n }\n\n const labelText = namingLabelText(widget);\n\n if (!labelText || !isTextMatch(labelText, text, widget, options)) {\n return null;\n }\n\n return widget.getMnemonicWidget();\n};\n\nconst labellingText = (widget: Gtk.Widget): string | null => {\n const ownLabel = widget.getAccessibleRole() === Gtk.AccessibleRole.LABEL ? null : getWidgetOwnLabel(widget);\n\n return ownLabel ?? getWidgetExternalLabelText(widget);\n};\n\nconst collectLabelMatches = (\n results: Set<Gtk.Widget>,\n widget: Gtk.Widget,\n text: Matcher,\n options: MatcherOptions | undefined,\n): void => {\n const mnemonicTarget = collectMnemonicMatch(widget, text, options);\n\n if (mnemonicTarget) {\n results.add(mnemonicTarget);\n }\n\n const labelText = labellingText(widget);\n\n if (labelText !== null && isTextMatch(labelText, text, widget, options)) {\n results.add(widget);\n }\n};\n\n/**\n * Finds every widget associated with a label whose text matches: a Gtk.Label mnemonic target, the\n * widget's own accessible label, or its labelled-by relation. Widgets that are not mapped are never matched.\n * @param container Widget subtree to search.\n * @param text Matcher for the label text.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByLabelText(container: Container, text: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n const results: Set<Gtk.Widget> = new Set();\n\n for (const widget of traverse(container)) {\n collectLabelMatches(results, widget, text, options);\n }\n\n return [...results].filter((widget) => isMatchingWidgetType(widget, options));\n}\n\n/**\n * Finds every widget whose rendered text content matches. Widgets that are not mapped are never matched.\n * @param container Widget subtree to search.\n * @param text Matcher for the widget text.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByText(container: Container, text: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n return findAll(\n container,\n (widget) =>\n isMatchingWidgetType(widget, options) && isTextMatch(getWidgetLabelText(widget), text, widget, options),\n );\n}\n\n/**\n * Finds every widget whose widget name matches. Widgets that are not mapped are never matched.\n * @param container Widget subtree to search.\n * @param name Matcher for the widget name.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByName(container: Container, name: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n return findAll(\n container,\n (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetName(widget), name, widget, options),\n );\n}\n\n/**\n * Finds every widget whose placeholder text matches. Widgets that are not mapped are never matched.\n * @param container Widget subtree to search.\n * @param text Matcher for the placeholder text.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByPlaceholderText(\n container: Container,\n text: Matcher,\n options?: MatcherOptions,\n): Gtk.Widget[] {\n return findAll(\n container,\n (widget) =>\n isMatchingWidgetType(widget, options) &&\n isTextMatch(getWidgetPlaceholderText(widget), text, widget, options),\n );\n}\n\n/**\n * Finds every widget whose current display value matches. Widgets that are not mapped are never matched.\n * @param container Widget subtree to search.\n * @param value Matcher for the display value.\n * @param options Text matching options.\n * @returns Every matching widget, or an empty array when none match.\n */\nfunction queryAllByDisplayValue(container: Container, value: Matcher, options?: MatcherOptions): Gtk.Widget[] {\n return findAll(\n container,\n (widget) =>\n isMatchingWidgetType(widget, options) &&\n isTextMatch(getWidgetDisplayValue(widget), value, widget, options),\n );\n}\n\nexport {\n builtinQueries,\n isMatchingWidgetType,\n isTextMatch,\n queryByRole,\n getAllByRole,\n getByRole,\n findAllByRole,\n findByRole,\n queryByLabelText,\n getAllByLabelText,\n getByLabelText,\n findAllByLabelText,\n findByLabelText,\n queryByText,\n getAllByText,\n getByText,\n findAllByText,\n findByText,\n queryByName,\n getAllByName,\n getByName,\n findAllByName,\n findByName,\n queryByPlaceholderText,\n getAllByPlaceholderText,\n getByPlaceholderText,\n findAllByPlaceholderText,\n findByPlaceholderText,\n queryByDisplayValue,\n getAllByDisplayValue,\n getByDisplayValue,\n findAllByDisplayValue,\n findByDisplayValue,\n queryAllByRole,\n queryAllByLabelText,\n queryAllByText,\n queryAllByName,\n queryAllByPlaceholderText,\n queryAllByDisplayValue,\n};\n"]}
@@ -0,0 +1,44 @@
1
+ import type * as Gtk from "@gtkx/gi/gtk";
2
+ import type { Matcher, MatcherOptions } from "./types.js";
3
+ import { buildQueries } from "./build-queries.js";
4
+ import { getElementError } from "./errors.js";
5
+ import { type Container } from "./traversal.js";
6
+ /** The helpers used to build custom queries, bundled the way DOM Testing Library exposes them. */
7
+ type QueryHelpers = {
8
+ /** Derives a query family's variants from its `queryAllBy` function. */
9
+ buildQueries: typeof buildQueries;
10
+ /** Builds the error a failing query throws. */
11
+ getElementError: typeof getElementError;
12
+ /** Finds every widget whose GObject property matches. */
13
+ queryAllByObjectProperty: typeof queryAllByObjectProperty;
14
+ /** Finds the single widget whose GObject property matches. */
15
+ queryByObjectProperty: typeof queryByObjectProperty;
16
+ };
17
+ /** The query-building helpers, bundled so they can be reached under a single import. */
18
+ declare const queryHelpers: QueryHelpers;
19
+ /**
20
+ * Finds every widget carrying a GObject property whose value matches, the counterpart of DOM Testing
21
+ * Library's `queryAllByAttribute`. The property name may be given in kebab-case or camelCase, and
22
+ * widgets that are not mapped are never matched.
23
+ *
24
+ * @param property Name of the GObject property to read.
25
+ * @param container Widget subtree to search.
26
+ * @param text Matcher for the property's value.
27
+ * @param options Text matching options.
28
+ * @returns Every matching widget, or an empty array when none match.
29
+ */
30
+ declare function queryAllByObjectProperty(property: string, container: Container, text: Matcher, options?: MatcherOptions): Gtk.Widget[];
31
+ /**
32
+ * Returns the single widget carrying a GObject property whose value matches, or null when none do,
33
+ * the counterpart of DOM Testing Library's `queryByAttribute`.
34
+ *
35
+ * @param property Name of the GObject property to read.
36
+ * @param container Widget subtree to search.
37
+ * @param text Matcher for the property's value.
38
+ * @param options Text matching options.
39
+ * @returns The matching widget, or null when none match.
40
+ * @throws When more than one widget matches.
41
+ */
42
+ declare function queryByObjectProperty(property: string, container: Container, text: Matcher, options?: MatcherOptions): Gtk.Widget | null;
43
+ export { queryAllByObjectProperty, queryByObjectProperty, queryHelpers, type QueryHelpers };
44
+ //# sourceMappingURL=query-helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-helpers.d.ts","sourceRoot":"","sources":["../src/query-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,gBAAgB,CAAC;AAEzD,kGAAkG;AAClG,KAAK,YAAY,GAAG;IAChB,wEAAwE;IACxE,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,+CAA+C;IAC/C,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,yDAAyD;IACzD,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;IAC1D,8DAA8D;IAC9D,qBAAqB,EAAE,OAAO,qBAAqB,CAAC;CACvD,CAAC;AAEF,wFAAwF;AACxF,QAAA,MAAM,YAAY,EAAE,YAKnB,CAAC;AAgBF;;;;;;;;;;GAUG;AACH,iBAAS,wBAAwB,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACzB,GAAG,CAAC,MAAM,EAAE,CAOd;AAED;;;;;;;;;;GAUG;AACH,iBAAS,qBAAqB,CAC1B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACzB,GAAG,CAAC,MAAM,GAAG,IAAI,CAWnB;AAED,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,CAAC"}