@gtkx/testing 1.0.0-rc.2 → 1.0.0-rc.4

package/dist/queries.js

@@ -1,8 +1,9 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { buildQueries } from "./build-queries.js";
 import { multipleFoundError, notFoundError } from "./errors.js";
+import { getDefaultNormalizer } from "./normalize.js";
 import { findAll, traverse } from "./traversal.js";
-import { getWidgetAccessibleName, getWidgetBusyState, getWidgetCheckedState, getWidgetDescription, getWidgetDisplayValue, getWidgetExpandedState, getWidgetLabelledByText, getWidgetLabelText, getWidgetLevel, getWidgetName, getWidgetOwnLabel, getWidgetPlaceholderText, getWidgetPressedState, getWidgetSelectedState, getWidgetValue, isInaccessible, } from "./widget-accessible-properties.js";
+import { getWidgetAccessibleName, getWidgetBusyState, getWidgetDescription, getWidgetDisplayValue, getWidgetExpandedState, getWidgetLabelledByText, getWidgetLabelText, getWidgetLevel, getWidgetName, getWidgetOwnLabel, getWidgetPlaceholderText, getWidgetPressedState, getWidgetSelectedState, getWidgetValue, isInaccessible, isWidgetChecked, } from "./widget-accessible-properties.js";
 const roleQueries = nameQueryFamily("Role", queryAllByRole, buildQueries("Role", queryAllByRole, (container, matches, role, options) => multipleFoundError(container, { queryType: "role", role, options }, matches), (container, role, options) => notFoundError(container, { queryType: "role", role, options })));
 const labelTextQueries = nameQueryFamily("LabelText", queryAllByLabelText, buildQueries("LabelText", queryAllByLabelText, (container, matches, text) => multipleFoundError(container, { queryType: "labelText", text }, matches), (container, text) => notFoundError(container, { queryType: "labelText", text })));
 const textQueries = nameQueryFamily("Text", queryAllByText, buildQueries("Text", queryAllByText, (container, matches, text) => multipleFoundError(container, { queryType: "text", text }, matches), (container, text) => notFoundError(container, { queryType: "text", text })));
@@ -21,137 +22,119 @@ const builtinQueries = {
  * Returns the single widget with a matching accessible role and options, or null when none match.
  * Throws when more than one matches.
  */
-const queryByRole = roleQueries.queryByRole;
+const queryByRole = builtinQueries.queryByRole;
 /** Returns every widget with a matching accessible role and options. Throws when none match. */
-const getAllByRole = roleQueries.getAllByRole;
+const getAllByRole = builtinQueries.getAllByRole;
 /**
  * Returns the single widget with a matching accessible role and options.
  * Throws when none or more than one matches.
  */
-const getByRole = roleQueries.getByRole;
+const getByRole = builtinQueries.getByRole;
 /**
  * Waits for and returns every widget with a matching accessible role and options, retrying until at
  * least one appears or the timeout elapses.
  */
-const findAllByRole = roleQueries.findAllByRole;
+const findAllByRole = builtinQueries.findAllByRole;
 /**
  * Waits for and returns the single widget with a matching accessible role and options, retrying
  * until it appears or the timeout elapses. Rejects when none or more than one matches.
  */
-const findByRole = roleQueries.findByRole;
+const findByRole = builtinQueries.findByRole;
 /**
  * Returns the single widget with matching associated label text, or null when none match.
  * Throws when more than one matches.
  */
-const queryByLabelText = labelTextQueries.queryByLabelText;
+const queryByLabelText = builtinQueries.queryByLabelText;
 /** Returns every widget with matching associated label text. Throws when none match. */
-const getAllByLabelText = labelTextQueries.getAllByLabelText;
+const getAllByLabelText = builtinQueries.getAllByLabelText;
 /** Returns the single widget with matching associated label text. Throws when none or more than one matches. */
-const getByLabelText = labelTextQueries.getByLabelText;
+const getByLabelText = builtinQueries.getByLabelText;
 /**
  * Waits for and returns every widget with matching associated label text, retrying until at least
  * one appears or the timeout elapses.
  */
-const findAllByLabelText = labelTextQueries.findAllByLabelText;
+const findAllByLabelText = builtinQueries.findAllByLabelText;
 /**
  * Waits for and returns the single widget with matching associated label text, retrying until it
  * appears or the timeout elapses. Rejects when none or more than one matches.
  */
-const findByLabelText = labelTextQueries.findByLabelText;
+const findByLabelText = builtinQueries.findByLabelText;
 /**
  * Returns the single widget with matching rendered text content, or null when none match.
  * Throws when more than one matches.
  */
-const queryByText = textQueries.queryByText;
+const queryByText = builtinQueries.queryByText;
 /** Returns every widget with matching rendered text content. Throws when none match. */
-const getAllByText = textQueries.getAllByText;
+const getAllByText = builtinQueries.getAllByText;
 /** Returns the single widget with matching rendered text content. Throws when none or more than one matches. */
-const getByText = textQueries.getByText;
+const getByText = builtinQueries.getByText;
 /**
  * Waits for and returns every widget with matching rendered text content, retrying until at least
  * one appears or the timeout elapses.
  */
-const findAllByText = textQueries.findAllByText;
+const findAllByText = builtinQueries.findAllByText;
 /**
  * Waits for and returns the single widget with matching rendered text content, retrying until it
  * appears or the timeout elapses. Rejects when none or more than one matches.
  */
-const findByText = textQueries.findByText;
+const findByText = builtinQueries.findByText;
 /**
  * Returns the single widget with a matching widget name, or null when none match.
  * Throws when more than one matches.
  */
-const queryByName = nameQueries.queryByName;
+const queryByName = builtinQueries.queryByName;
 /** Returns every widget with a matching widget name. Throws when none match. */
-const getAllByName = nameQueries.getAllByName;
+const getAllByName = builtinQueries.getAllByName;
 /** Returns the single widget with a matching widget name. Throws when none or more than one matches. */
-const getByName = nameQueries.getByName;
+const getByName = builtinQueries.getByName;
 /**
  * Waits for and returns every widget with a matching widget name, retrying until at least one
  * appears or the timeout elapses.
  */
-const findAllByName = nameQueries.findAllByName;
+const findAllByName = builtinQueries.findAllByName;
 /**
  * Waits for and returns the single widget with a matching widget name, retrying until it appears or
  * the timeout elapses. Rejects when none or more than one matches.
  */
-const findByName = nameQueries.findByName;
+const findByName = builtinQueries.findByName;
 /**
  * Returns the single widget with matching placeholder text, or null when none match.
  * Throws when more than one matches.
  */
-const queryByPlaceholderText = placeholderTextQueries.queryByPlaceholderText;
+const queryByPlaceholderText = builtinQueries.queryByPlaceholderText;
 /** Returns every widget with matching placeholder text. Throws when none match. */
-const getAllByPlaceholderText = placeholderTextQueries.getAllByPlaceholderText;
+const getAllByPlaceholderText = builtinQueries.getAllByPlaceholderText;
 /** Returns the single widget with matching placeholder text. Throws when none or more than one matches. */
-const getByPlaceholderText = placeholderTextQueries.getByPlaceholderText;
+const getByPlaceholderText = builtinQueries.getByPlaceholderText;
 /**
  * Waits for and returns every widget with matching placeholder text, retrying until at least one
  * appears or the timeout elapses.
  */
-const findAllByPlaceholderText = placeholderTextQueries.findAllByPlaceholderText;
+const findAllByPlaceholderText = builtinQueries.findAllByPlaceholderText;
 /**
  * Waits for and returns the single widget with matching placeholder text, retrying until it appears
  * or the timeout elapses. Rejects when none or more than one matches.
  */
-const findByPlaceholderText = placeholderTextQueries.findByPlaceholderText;
+const findByPlaceholderText = builtinQueries.findByPlaceholderText;
 /**
  * Returns the single widget with a matching display value, or null when none match.
  * Throws when more than one matches.
  */
-const queryByDisplayValue = displayValueQueries.queryByDisplayValue;
+const queryByDisplayValue = builtinQueries.queryByDisplayValue;
 /** Returns every widget with a matching display value. Throws when none match. */
-const getAllByDisplayValue = displayValueQueries.getAllByDisplayValue;
+const getAllByDisplayValue = builtinQueries.getAllByDisplayValue;
 /** Returns the single widget with a matching display value. Throws when none or more than one matches. */
-const getByDisplayValue = displayValueQueries.getByDisplayValue;
+const getByDisplayValue = builtinQueries.getByDisplayValue;
 /**
  * Waits for and returns every widget with a matching display value, retrying until at least one
  * appears or the timeout elapses.
  */
-const findAllByDisplayValue = displayValueQueries.findAllByDisplayValue;
+const findAllByDisplayValue = builtinQueries.findAllByDisplayValue;
 /**
  * Waits for and returns the single widget with a matching display value, retrying until it appears
  * or the timeout elapses. Rejects when none or more than one matches.
  */
-const findByDisplayValue = displayValueQueries.findByDisplayValue;
-/**
- * Builds the default text normalizer, which optionally trims surrounding whitespace and collapses
- * runs of whitespace into single spaces.
- * @param options Toggles for trimming and whitespace collapsing.
- * @returns A function that normalizes a string for comparison against a matcher.
- */
-const getDefaultNormalizer = ({ trim = true, collapseWhitespace = true, } = {}) => {
-    return (text) => {
-        let result = text;
-        if (trim) {
-            result = result.trim();
-        }
-        if (collapseWhitespace) {
-            result = result.replaceAll(/\s+/g, " ");
-        }
-        return result;
-    };
-};
+const findByDisplayValue = builtinQueries.findByDisplayValue;
 const buildNormalizer = (options) => {
     const { normalizer, trim, collapseWhitespace } = options ?? {};
     if (!normalizer) {
@@ -210,7 +193,7 @@ const hasMatchingAccessibleValue = (widget, value, options) => {
 };
 const hasMatchingBooleanStates = (widget, options) => {
     const stateChecks = [
-        [options.checked, () => getWidgetCheckedState(widget)],
+        [options.checked, () => isWidgetChecked(widget)],
         [options.pressed, () => getWidgetPressedState(widget)],
         [options.expanded, () => getWidgetExpandedState(widget)],
         [options.selected, () => getWidgetSelectedState(widget)],
@@ -231,14 +214,17 @@ const hasMatchingAccessibleStates = (widget, options) => hasMatchingBooleanState
     hasMatchingLevelState(widget, options) &&
     hasMatchingDescriptionState(widget, options) &&
     hasMatchingValueState(widget, options);
+const isMatchingWidgetType = (widget, options) => options?.as === undefined || widget instanceof options.as;
 const hasMatchingByRoleOptions = (widget, options) => {
     if (!options) {
         return true;
     }
-    return hasMatchingAccessibleName(widget, options) && hasMatchingAccessibleStates(widget, options);
+    return (isMatchingWidgetType(widget, options) &&
+        hasMatchingAccessibleName(widget, options) &&
+        hasMatchingAccessibleStates(widget, options));
 };
 function nameQueryFamily(suffix, queryAllBy, built) {
-    const family = {
+    return {
         [`queryBy${suffix}`]: built.queryBy,
         [`queryAllBy${suffix}`]: queryAllBy,
         [`getBy${suffix}`]: built.getBy,
@@ -246,7 +232,6 @@ function nameQueryFamily(suffix, queryAllBy, built) {
         [`findBy${suffix}`]: built.findBy,
         [`findAllBy${suffix}`]: built.findAllBy,
     };
-    return family;
 }
 /**
  * Finds every widget under the container whose accessible role matches `role` and that satisfies the given options.
@@ -304,7 +289,7 @@ function queryAllByLabelText(container, text, options) {
     for (const widget of traverse(container)) {
         collectLabelMatches(results, widget, text, options);
     }
-    return [...results];
+    return [...results].filter((widget) => isMatchingWidgetType(widget, options));
 }
 /**
  * Finds every widget whose rendered text content matches.
@@ -314,7 +299,7 @@ function queryAllByLabelText(container, text, options) {
  * @returns Every matching widget, or an empty array when none match.
  */
 function queryAllByText(container, text, options) {
-    return findAll(container, (widget) => isTextMatch(getWidgetLabelText(widget), text, widget, options));
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetLabelText(widget), text, widget, options));
 }
 /**
  * Finds every widget whose widget name matches.
@@ -324,7 +309,7 @@ function queryAllByText(container, text, options) {
  * @returns Every matching widget, or an empty array when none match.
  */
 function queryAllByName(container, name, options) {
-    return findAll(container, (widget) => isTextMatch(getWidgetName(widget), name, widget, options));
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) && isTextMatch(getWidgetName(widget), name, widget, options));
 }
 /**
  * Finds every widget whose placeholder text matches.
@@ -334,7 +319,8 @@ function queryAllByName(container, name, options) {
  * @returns Every matching widget, or an empty array when none match.
  */
 function queryAllByPlaceholderText(container, text, options) {
-    return findAll(container, (widget) => isTextMatch(getWidgetPlaceholderText(widget), text, widget, options));
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) &&
+        isTextMatch(getWidgetPlaceholderText(widget), text, widget, options));
 }
 /**
  * Finds every widget whose current display value matches.
@@ -344,7 +330,8 @@ function queryAllByPlaceholderText(container, text, options) {
  * @returns Every matching widget, or an empty array when none match.
  */
 function queryAllByDisplayValue(container, value, options) {
-    return findAll(container, (widget) => isTextMatch(getWidgetDisplayValue(widget), value, widget, options));
+    return findAll(container, (widget) => isMatchingWidgetType(widget, options) &&
+        isTextMatch(getWidgetDisplayValue(widget), value, widget, options));
 }
-export { builtinQueries, queryByRole, getAllByRole, getByRole, findAllByRole, findByRole, queryByLabelText, getAllByLabelText, getByLabelText, findAllByLabelText, findByLabelText, queryByText, getAllByText, getByText, findAllByText, findByText, queryByName, getAllByName, getByName, findAllByName, findByName, queryByPlaceholderText, getAllByPlaceholderText, getByPlaceholderText, findAllByPlaceholderText, findByPlaceholderText, queryByDisplayValue, getAllByDisplayValue, getByDisplayValue, findAllByDisplayValue, findByDisplayValue, getDefaultNormalizer, queryAllByRole, queryAllByLabelText, queryAllByText, queryAllByName, queryAllByPlaceholderText, queryAllByDisplayValue, };
+export { builtinQueries, queryByRole, getAllByRole, getByRole, findAllByRole, findByRole, queryByLabelText, getAllByLabelText, getByLabelText, findAllByLabelText, findByLabelText, queryByText, getAllByText, getByText, findAllByText, findByText, queryByName, getAllByName, getByName, findAllByName, findByName, queryByPlaceholderText, getAllByPlaceholderText, getByPlaceholderText, findAllByPlaceholderText, findByPlaceholderText, queryByDisplayValue, getAllByDisplayValue, getByDisplayValue, findAllByDisplayValue, findByDisplayValue, queryAllByRole, queryAllByLabelText, queryAllByText, queryAllByName, queryAllByPlaceholderText, queryAllByDisplayValue, };
 //# sourceMappingURL=queries.js.map

package/dist/queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"queries.js","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAsC,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAkB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACH,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,cAAc,GACjB,MAAM,mCAAmC,CAAC;AAyB3C,MAAM,WAAW,GAAG,eAAe,CAC/B,MAAM,EACN,cAAc,EACd,YAAY,CACR,MAAM,EACN,cAAc,EACd,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAClC,kBAAkB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAChF,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAC/F,CACJ,CAAC;AAEF,MAAM,gBAAgB,GAAG,eAAe,CACpC,WAAW,EACX,mBAAmB,EACnB,YAAY,CACR,WAAW,EACX,mBAAmB,EACnB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EACtG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAClF,CACJ,CAAC;AAEF,MAAM,WAAW,GAAG,eAAe,CAC/B,MAAM,EACN,cAAc,EACd,YAAY,CACR,MAAM,EACN,cAAc,EACd,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EACjG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAC7E,CACJ,CAAC;AAEF,MAAM,WAAW,GAAG,eAAe,CAC/B,MAAM,EACN,cAAc,EACd,YAAY,CACR,MAAM,EACN,cAAc,EACd,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EACjG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAC7E,CACJ,CAAC;AAEF,MAAM,sBAAsB,GAAG,eAAe,CAC1C,iBAAiB,EACjB,yBAAyB,EACzB,YAAY,CACR,iBAAiB,EACjB,yBAAyB,EACzB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EAC5G,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CACxF,CACJ,CAAC;AAEF,MAAM,mBAAmB,GAAG,eAAe,CACvC,cAAc,EACd,sBAAsB,EACtB,YAAY,CACR,cAAc,EACd,sBAAsB,EACtB,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,EAC3G,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CACvF,CACJ,CAAC;AAEF,MAAM,cAAc,GAAmB;IACnC,GAAG,WAAW;IACd,GAAG,gBAAgB;IACnB,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,sBAAsB;IACzB,GAAG,mBAAmB;CACzB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,GAAkC,WAAW,CAAC,WAAW,CAAC;AAC3E,gGAAgG;AAChG,MAAM,YAAY,GAAmC,WAAW,CAAC,YAAY,CAAC;AAC9E;;;GAGG;AACH,MAAM,SAAS,GAAgC,WAAW,CAAC,SAAS,CAAC;AACrE;;;GAGG;AACH,MAAM,aAAa,GAAoC,WAAW,CAAC,aAAa,CAAC;AACjF;;;GAGG;AACH,MAAM,UAAU,GAAiC,WAAW,CAAC,UAAU,CAAC;AACxE;;;GAGG;AACH,MAAM,gBAAgB,GAAuC,gBAAgB,CAAC,gBAAgB,CAAC;AAC/F,wFAAwF;AACxF,MAAM,iBAAiB,GAAwC,gBAAgB,CAAC,iBAAiB,CAAC;AAClG,gHAAgH;AAChH,MAAM,cAAc,GAAqC,gBAAgB,CAAC,cAAc,CAAC;AACzF;;;GAGG;AACH,MAAM,kBAAkB,GAAyC,gBAAgB,CAAC,kBAAkB,CAAC;AACrG;;;GAGG;AACH,MAAM,eAAe,GAAsC,gBAAgB,CAAC,eAAe,CAAC;AAC5F;;;GAGG;AACH,MAAM,WAAW,GAAkC,WAAW,CAAC,WAAW,CAAC;AAC3E,wFAAwF;AACxF,MAAM,YAAY,GAAmC,WAAW,CAAC,YAAY,CAAC;AAC9E,gHAAgH;AAChH,MAAM,SAAS,GAAgC,WAAW,CAAC,SAAS,CAAC;AACrE;;;GAGG;AACH,MAAM,aAAa,GAAoC,WAAW,CAAC,aAAa,CAAC;AACjF;;;GAGG;AACH,MAAM,UAAU,GAAiC,WAAW,CAAC,UAAU,CAAC;AACxE;;;GAGG;AACH,MAAM,WAAW,GAAkC,WAAW,CAAC,WAAW,CAAC;AAC3E,gFAAgF;AAChF,MAAM,YAAY,GAAmC,WAAW,CAAC,YAAY,CAAC;AAC9E,wGAAwG;AACxG,MAAM,SAAS,GAAgC,WAAW,CAAC,SAAS,CAAC;AACrE;;;GAGG;AACH,MAAM,aAAa,GAAoC,WAAW,CAAC,aAAa,CAAC;AACjF;;;GAGG;AACH,MAAM,UAAU,GAAiC,WAAW,CAAC,UAAU,CAAC;AAExE;;;GAGG;AACH,MAAM,sBAAsB,GACxB,sBAAsB,CAAC,sBAAsB,CAAC;AAElD,mFAAmF;AACnF,MAAM,uBAAuB,GACzB,sBAAsB,CAAC,uBAAuB,CAAC;AAEnD,2GAA2G;AAC3G,MAAM,oBAAoB,GAA2C,sBAAsB,CAAC,oBAAoB,CAAC;AAEjH;;;GAGG;AACH,MAAM,wBAAwB,GAC1B,sBAAsB,CAAC,wBAAwB,CAAC;AAEpD;;;GAGG;AACH,MAAM,qBAAqB,GACvB,sBAAsB,CAAC,qBAAqB,CAAC;AAEjD;;;GAGG;AACH,MAAM,mBAAmB,GAA0C,mBAAmB,CAAC,mBAAmB,CAAC;AAC3G,kFAAkF;AAClF,MAAM,oBAAoB,GAA2C,mBAAmB,CAAC,oBAAoB,CAAC;AAC9G,0GAA0G;AAC1G,MAAM,iBAAiB,GAAwC,mBAAmB,CAAC,iBAAiB,CAAC;AACrG;;;GAGG;AACH,MAAM,qBAAqB,GAA4C,mBAAmB,CAAC,qBAAqB,CAAC;AACjH;;;GAGG;AACH,MAAM,kBAAkB,GAAyC,mBAAmB,CAAC,kBAAkB,CAAC;AAExG;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,CAAC,EAC1B,IAAI,GAAG,IAAI,EACX,kBAAkB,GAAG,IAAI,MACN,EAAE,EAAgB,EAAE;IACvC,OAAO,CAAC,IAAY,EAAU,EAAE;QAC5B,IAAI,MAAM,GAAG,IAAI,CAAC;QAElB,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YACrB,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,OAAwB,EAAgB,EAAE;IAC/D,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAE/D,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,oBAAoB,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACX,mEAAmE;YACnE,uFAAuF;YACvF,kGAAkG,CACrG,CAAC;IACN,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,OAAwB,EAAU,EAAE;IACrE,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAChB,MAAqB,EACrB,QAAiB,EACjB,MAAkB,EAClB,OAAwB,EACjB,EAAE;IACT,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,QAAQ,YAAY,MAAM,EAAE,CAAC;QAC7B,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;QAEvB,OAAO,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;IAEvC,OAAO,OAAO;QACV,CAAC,CAAC,gBAAgB,KAAK,kBAAkB;QACzC,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC;AACpF,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG,CAAC,MAAkB,EAAE,OAAsB,EAAW,EAAE;IACtF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,QAA4B,EAAE,MAAqB,EAAW,EAAE,CACzF,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,CAAC;AAElD,MAAM,0BAA0B,GAAG,CAAC,MAAkB,EAAE,KAAkB,EAAE,OAAsB,EAAW,EAAE;IAC3G,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,aAAa,GAA0C;QACzD,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;QACvB,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;QACvB,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;KAC1B,CAAC;IAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9C,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,MAAkB,EAAE,OAAsB,EAAW,EAAE;IACrF,MAAM,WAAW,GAAkD;QAC/D,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;KAC5D,CAAC;IAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,WAAW,EAAE,CAAC;QAC9C,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,EAAE,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,MAAkB,EAAE,OAAsB,EAAW,EAAE,CAClF,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC;AAE5E,MAAM,2BAA2B,GAAG,CAAC,MAAkB,EAAE,OAAsB,EAAW,EAAE,CACxF,OAAO,CAAC,WAAW,KAAK,SAAS;IACjC,WAAW,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpF,MAAM,qBAAqB,GAAG,CAAC,MAAkB,EAAE,OAAsB,EAAW,EAAE,CAClF,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAE9F,MAAM,2BAA2B,GAAG,CAAC,MAAkB,EAAE,OAAsB,EAAW,EAAE,CACxF,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC;IACzC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC;IACtC,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5C,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,MAAM,wBAAwB,GAAG,CAAC,MAAkB,EAAE,OAAuB,EAAW,EAAE;IACtF,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtG,CAAC,CAAC;AAEF,SAAS,eAAe,CACpB,MAAc,EACd,UAA4B,EAC5B,KAAyB;IAEzB,MAAM,MAAM,GAAG;QACX,CAAC,UAAU,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO;QACnC,CAAC,aAAa,MAAM,EAAE,CAAC,EAAE,UAAU;QACnC,CAAC,QAAQ,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK;QAC/B,CAAC,WAAW,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,QAAQ;QACrC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM;QACjC,CAAC,YAAY,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,SAAS;KAC1C,CAAC;IAEF,OAAO,MAAmC,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CACnB,SAAoB,EACpB,IAAwB,EACxB,OAAuB;IAEvB,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;QACjC,IAAI,MAAM,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,oBAAoB,GAAG,CACzB,MAAkB,EAClB,IAAa,EACb,OAAmC,EAClB,EAAE;IACnB,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEpC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC,iBAAiB,EAAE,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CACxB,OAAwB,EACxB,MAAkB,EAClB,IAAa,EACb,OAAmC,EAC/B,EAAE;IACN,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEnE,IAAI,cAAc,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE3C,IAAI,QAAQ,KAAK,IAAI,IAAI,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,cAAc,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEvD,IAAI,cAAc,KAAK,IAAI,IAAI,WAAW,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAChF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAAC,SAAoB,EAAE,IAAa,EAAE,OAAwB;IACtF,MAAM,OAAO,GAAoB,IAAI,GAAG,EAAE,CAAC;IAE3C,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,SAAoB,EAAE,IAAa,EAAE,OAAwB;IACjF,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1G,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,SAAoB,EAAE,IAAa,EAAE,OAAwB;IACjF,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACrG,CAAC;AAED;;;;;;GAMG;AACH,SAAS,yBAAyB,CAC9B,SAAoB,EACpB,IAAa,EACb,OAAwB;IAExB,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAChH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,SAAoB,EAAE,KAAc,EAAE,OAAwB;IAC1F,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,OAAO,EACH,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,sBAAsB,GAEzB,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport type { ByRoleOptions, ByRoleValue, Matcher, MatcherOptions, NormalizerFn, NormalizerOptions } from \"./types.js\";\nimport { buildQueries, type BuiltQueries, type QueryAllBy } from \"./build-queries.js\";\nimport { multipleFoundError, notFoundError } from \"./errors.js\";\nimport { type Container, findAll, traverse } from \"./traversal.js\";\nimport {\n    getWidgetAccessibleName,\n    getWidgetBusyState,\n    getWidgetCheckedState,\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} from \"./widget-accessible-properties.js\";\n\ntype QueryFamilyReturns = {\n    queryBy: Gtk.Widget | null;\n    queryAllBy: Gtk.Widget[];\n    getBy: Gtk.Widget;\n    getAllBy: Gtk.Widget[];\n    findBy: Promise<Gtk.Widget>;\n    findAllBy: Promise<Gtk.Widget[]>;\n};\n\ntype NamedFamily<Suffix extends string, Args extends unknown[]> = {\n    [K in keyof QueryFamilyReturns as `${K & string}${Suffix}`]: (\n        container: Container,\n        ...args: Args\n    ) => QueryFamilyReturns[K];\n};\n\ntype BuiltinQueries = NamedFamily<\"Role\", [role: Gtk.AccessibleRole, options?: ByRoleOptions]> &\n    NamedFamily<\"LabelText\", [text: Matcher, options?: MatcherOptions]> &\n    NamedFamily<\"Text\", [text: Matcher, options?: MatcherOptions]> &\n    NamedFamily<\"Name\", [name: Matcher, options?: MatcherOptions]> &\n    NamedFamily<\"PlaceholderText\", [text: Matcher, options?: MatcherOptions]> &\n    NamedFamily<\"DisplayValue\", [value: Matcher, options?: MatcherOptions]>;\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: BuiltinQueries = {\n    ...roleQueries,\n    ...labelTextQueries,\n    ...textQueries,\n    ...nameQueries,\n    ...placeholderTextQueries,\n    ...displayValueQueries,\n};\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\"] = roleQueries.queryByRole;\n/** Returns every widget with a matching accessible role and options. Throws when none match. */\nconst getAllByRole: BuiltinQueries[\"getAllByRole\"] = roleQueries.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\"] = roleQueries.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\"] = roleQueries.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\"] = roleQueries.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\"] = labelTextQueries.queryByLabelText;\n/** Returns every widget with matching associated label text. Throws when none match. */\nconst getAllByLabelText: BuiltinQueries[\"getAllByLabelText\"] = labelTextQueries.getAllByLabelText;\n/** Returns the single widget with matching associated label text. Throws when none or more than one matches. */\nconst getByLabelText: BuiltinQueries[\"getByLabelText\"] = labelTextQueries.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\"] = labelTextQueries.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\"] = labelTextQueries.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\"] = textQueries.queryByText;\n/** Returns every widget with matching rendered text content. Throws when none match. */\nconst getAllByText: BuiltinQueries[\"getAllByText\"] = textQueries.getAllByText;\n/** Returns the single widget with matching rendered text content. Throws when none or more than one matches. */\nconst getByText: BuiltinQueries[\"getByText\"] = textQueries.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\"] = textQueries.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\"] = textQueries.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\"] = nameQueries.queryByName;\n/** Returns every widget with a matching widget name. Throws when none match. */\nconst getAllByName: BuiltinQueries[\"getAllByName\"] = nameQueries.getAllByName;\n/** Returns the single widget with a matching widget name. Throws when none or more than one matches. */\nconst getByName: BuiltinQueries[\"getByName\"] = nameQueries.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\"] = nameQueries.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\"] = nameQueries.findByName;\n\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\"] =\n    placeholderTextQueries.queryByPlaceholderText;\n\n/** Returns every widget with matching placeholder text. Throws when none match. */\nconst getAllByPlaceholderText: BuiltinQueries[\"getAllByPlaceholderText\"] =\n    placeholderTextQueries.getAllByPlaceholderText;\n\n/** Returns the single widget with matching placeholder text. Throws when none or more than one matches. */\nconst getByPlaceholderText: BuiltinQueries[\"getByPlaceholderText\"] = placeholderTextQueries.getByPlaceholderText;\n\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\"] =\n    placeholderTextQueries.findAllByPlaceholderText;\n\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\"] =\n    placeholderTextQueries.findByPlaceholderText;\n\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\"] = displayValueQueries.queryByDisplayValue;\n/** Returns every widget with a matching display value. Throws when none match. */\nconst getAllByDisplayValue: BuiltinQueries[\"getAllByDisplayValue\"] = displayValueQueries.getAllByDisplayValue;\n/** Returns the single widget with a matching display value. Throws when none or more than one matches. */\nconst getByDisplayValue: BuiltinQueries[\"getByDisplayValue\"] = displayValueQueries.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\"] = displayValueQueries.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\"] = displayValueQueries.findByDisplayValue;\n\n/**\n * Builds the default text normalizer, which optionally trims surrounding whitespace and collapses\n * runs of whitespace into single spaces.\n * @param options Toggles for trimming and whitespace collapsing.\n * @returns A function that normalizes a string for comparison against a matcher.\n */\nconst getDefaultNormalizer = ({\n    trim = true,\n    collapseWhitespace = true,\n}: NormalizerOptions = {}): NormalizerFn => {\n    return (text: string): string => {\n        let result = text;\n\n        if (trim) {\n            result = result.trim();\n        }\n\n        if (collapseWhitespace) {\n            result = result.replaceAll(/\\s+/g, \" \");\n        }\n\n        return result;\n    };\n};\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, () => getWidgetCheckedState(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 hasMatchingByRoleOptions = (widget: Gtk.Widget, options?: ByRoleOptions): boolean => {\n    if (!options) {\n        return true;\n    }\n\n    return hasMatchingAccessibleName(widget, options) && hasMatchingAccessibleStates(widget, options);\n};\n\nfunction nameQueryFamily<Suffix extends string, Args extends unknown[]>(\n    suffix: Suffix,\n    queryAllBy: QueryAllBy<Args>,\n    built: BuiltQueries<Args>,\n): NamedFamily<Suffix, Args> {\n    const family = {\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    return family as NamedFamily<Suffix, Args>;\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];\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(container, (widget) => isTextMatch(getWidgetLabelText(widget), text, widget, options));\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(container, (widget) => isTextMatch(getWidgetName(widget), name, widget, options));\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(container, (widget) => isTextMatch(getWidgetPlaceholderText(widget), text, widget, options));\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(container, (widget) => isTextMatch(getWidgetDisplayValue(widget), value, widget, options));\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    getDefaultNormalizer,\n    queryAllByRole,\n    queryAllByLabelText,\n    queryAllByText,\n    queryAllByName,\n    queryAllByPlaceholderText,\n    queryAllByDisplayValue,\n    type BuiltinQueries,\n};\n"]}
+{"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\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        \"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"]}

package/dist/render.js

@@ -61,7 +61,7 @@ const resolveContainer = (container) => {
         return { containerInfo: container, window: null };
     }
     const window = new Gtk.Window({ defaultWidth: HARNESS_WINDOW_WIDTH, defaultHeight: HARNESS_WINDOW_HEIGHT });
-    window.setTitlebar(new Gtk.HeaderBar({ showTitleButtons: false }));
+    window.setDecorated(false);
     return { containerInfo: window, window };
 };
 const firstToplevelWidget = (baseElement) => {
@@ -110,7 +110,7 @@ const applyEnableAnimations = (areAnimationsEnabled) => {
  */
 const render = async (element, options) => {
     installErrorHandler();
-    applyEnableAnimations(options?.animations === true);
+    applyEnableAnimations(options?.areAnimationsEnabled === true);
     const baseElement = options?.baseElement ?? TOPLEVELS;
     const Wrapper = options?.wrapper;
     const resolved = resolveContainer(options?.container);
@@ -125,7 +125,7 @@ const render = async (element, options) => {
     addToCleanupQueue(resetClipboard);
     const wrap = (node) => {
         const wrapped = Wrapper ? _jsx(Wrapper, { children: node }) : node;
-        return options?.reactStrictMode ? _jsx(StrictMode, { children: wrapped }) : wrapped;
+        return options?.isReactStrictMode ? _jsx(StrictMode, { children: wrapped }) : wrapped;
     };
     await update(wrap(element), root);
     resolved.window?.present();

package/dist/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { RootElement } from \"@gtkx/react\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    createReconcilerRoot,\n    isRootElement,\n    type ReconcilerRoot,\n    setReconcilerErrorHandler,\n} from \"@gtkx/react/internal\";\nimport { type ErrorInfo, type ReactNode, StrictMode } from \"react\";\nimport type { RenderResult } from \"./bound-queries.js\";\nimport type { QueryMap, RenderOptions, ScreenshotOptions, WindowSelector } from \"./types.js\";\nimport { runInAct } from \"./act.js\";\nimport { addToCleanupQueue, runCleanup } from \"./cleanup-registry.js\";\nimport { scheduleAfterLayout } from \"./frame-sync.js\";\nimport { logWidget, type PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport { logRoles } from \"./role-helpers.js\";\nimport { clearScreen, setScreen } from \"./screen.js\";\nimport { captureAndSaveScreenshot } from \"./screenshot.js\";\nimport { type Container, TOPLEVELS, traverse } from \"./traversal.js\";\nimport { resetClipboard } from \"./user-event/index.js\";\nimport { within } from \"./within.js\";\n\ntype ActiveRender = {\n    root: ReconcilerRoot;\n    window: Gtk.Window | null;\n};\n\ntype ResolvedContainer = {\n    containerInfo: Gtk.Widget | RootElement;\n    window: Gtk.Window | null;\n};\n\ntype ReconcilerErrorState = {\n    lastError: Error | null;\n    isHandlerInstalled: boolean;\n};\n\nconst reconcilerErrors: ReconcilerErrorState = { lastError: null, isHandlerInstalled: false };\nconst activeRenders: Set<ActiveRender> = new Set();\nconst HARNESS_WINDOW_WIDTH = 800;\nconst HARNESS_WINDOW_HEIGHT = 600;\n\nconst flushLayout = (window: Gtk.Window | null): Promise<void> =>\n    new Promise((resolve) => {\n        scheduleAfterLayout(window, resolve);\n    });\n\nconst update = async (element: ReactNode, root: ReconcilerRoot): Promise<void> => {\n    await runInAct(() => {\n        root.update(element);\n    });\n\n    if (reconcilerErrors.lastError) {\n        const captured = reconcilerErrors.lastError;\n        reconcilerErrors.lastError = null;\n        throw captured;\n    }\n};\n\nconst disposeActiveRender = async (active: ActiveRender): Promise<void> => {\n    if (!activeRenders.delete(active)) {\n        return;\n    }\n\n    await active.root.unmount(async (root) => {\n        await update(null, root);\n        active.window?.destroy();\n    });\n};\n\nconst disposeAllActiveRenders = async (): Promise<void> => {\n    for (const active of activeRenders) {\n        await disposeActiveRender(active);\n    }\n};\n\nconst handleError = (error: unknown): void => {\n    reconcilerErrors.lastError = error instanceof Error ? error : new Error(String(error));\n};\n\nconst installErrorHandler = (): void => {\n    if (reconcilerErrors.isHandlerInstalled) {\n        return;\n    }\n\n    setReconcilerErrorHandler(handleError);\n    reconcilerErrors.isHandlerInstalled = true;\n};\n\nconst resolveContainer = (container: RenderOptions[\"container\"]): ResolvedContainer => {\n    if (isRootElement(container)) {\n        return { containerInfo: container, window: null };\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return { containerInfo: container, window: null };\n    }\n\n    const window = new Gtk.Window({ defaultWidth: HARNESS_WINDOW_WIDTH, defaultHeight: HARNESS_WINDOW_HEIGHT });\n    window.setTitlebar(new Gtk.HeaderBar({ showTitleButtons: false }));\n\n    return { containerInfo: window, window };\n};\n\nconst firstToplevelWidget = (baseElement: Container): Gtk.Widget => {\n    if (baseElement instanceof Gtk.Widget) {\n        return baseElement;\n    }\n\n    const [first] = traverse(baseElement);\n\n    if (first) {\n        return first;\n    }\n\n    throw new Error(\"render() produced no widgets: ensure the element renders visible content\");\n};\n\nconst resolveResultContainer = (\n    resolved: ResolvedContainer,\n    container: RenderOptions[\"container\"],\n    baseElement: Container,\n): Gtk.Widget => {\n    if (resolved.window) {\n        return resolved.window;\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return container;\n    }\n\n    return firstToplevelWidget(baseElement);\n};\n\nconst renderErrorHandlers = <Q extends QueryMap>(options: RenderOptions<Q> | undefined) => ({\n    onUncaughtError: handleError,\n    onCaughtError: (error: unknown, errorInfo: ErrorInfo): void => {\n        handleError(error);\n        options?.onCaughtError?.(error, errorInfo);\n    },\n    onRecoverableError: (error: unknown, errorInfo: ErrorInfo): void => {\n        options?.onRecoverableError?.(error, errorInfo);\n    },\n});\n\nconst applyEnableAnimations = (areAnimationsEnabled: boolean): void => {\n    const settings = Gtk.Settings.getDefault();\n\n    if (settings) {\n        settings.gtkEnableAnimations = areAnimationsEnabled;\n    }\n};\n\n/**\n * Renders a React element into a GTK4 widget tree and returns queries\n * scoped to it along with controls for rerendering and unmounting. When no\n * container is supplied, a harness window is created and presented.\n *\n * @param element The React element to render.\n * @param options Optional container, wrapper, custom queries, and other render settings.\n * @returns A render result with bound queries, debug helpers, and lifecycle controls.\n */\nconst render = async <Q extends QueryMap = Record<never, never>>(\n    element: ReactNode,\n    options?: RenderOptions<Q>,\n): Promise<RenderResult<Q>> => {\n    installErrorHandler();\n    applyEnableAnimations(options?.animations === true);\n    const baseElement: Container = options?.baseElement ?? TOPLEVELS;\n    const Wrapper = options?.wrapper;\n    const resolved = resolveContainer(options?.container);\n\n    const root = createReconcilerRoot({\n        containerInfo: resolved.containerInfo,\n        ...renderErrorHandlers(options),\n    });\n\n    const active: ActiveRender = { root, window: resolved.window };\n    activeRenders.add(active);\n    addToCleanupQueue(disposeAllActiveRenders);\n    addToCleanupQueue(clearScreen);\n    addToCleanupQueue(resetClipboard);\n\n    const wrap = (node: ReactNode): ReactNode => {\n        const wrapped = Wrapper ? <Wrapper>{node}</Wrapper> : node;\n\n        return options?.reactStrictMode ? <StrictMode>{wrapped}</StrictMode> : wrapped;\n    };\n\n    await update(wrap(element), root);\n    resolved.window?.present();\n    await flushLayout(resolved.window);\n    const container = resolveResultContainer(resolved, options?.container, baseElement);\n\n    const result: RenderResult<Q> = {\n        ...within(baseElement, options?.queries),\n        container,\n        baseElement,\n        unmount: async () => {\n            await disposeActiveRender(active);\n        },\n        rerender: async (newElement: ReactNode) => {\n            await update(wrap(newElement), root);\n            await flushLayout(resolved.window);\n        },\n        debug: (element: Container | Container[] = baseElement, debugOptions?: PrettyWidgetOptions) => {\n            logWidget(element, debugOptions);\n        },\n        logRoles: () => {\n            logRoles(baseElement);\n        },\n        screenshot: (selector?: WindowSelector, screenshotOptions?: ScreenshotOptions) =>\n            captureAndSaveScreenshot(selector, screenshotOptions),\n    };\n\n    setScreen(result);\n\n    return result;\n};\n\n/**\n * Unmounts every active render and runs all registered cleanup callbacks,\n * resetting the screen and clipboard. Called automatically after each test.\n */\nconst cleanup = async (): Promise<void> => {\n    await runCleanup();\n};\n\nexport { render, cleanup };\n"]}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { RootElement } from \"@gtkx/react\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    createReconcilerRoot,\n    isRootElement,\n    type ReconcilerRoot,\n    setReconcilerErrorHandler,\n} from \"@gtkx/react/internal\";\nimport { type ErrorInfo, type ReactNode, StrictMode } from \"react\";\nimport type { RenderResult } from \"./bound-queries.js\";\nimport type { QueryMap, RenderOptions, ScreenshotOptions, WindowSelector } from \"./types.js\";\nimport { runInAct } from \"./act.js\";\nimport { addToCleanupQueue, runCleanup } from \"./cleanup-registry.js\";\nimport { scheduleAfterLayout } from \"./frame-sync.js\";\nimport { logWidget, type PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport { logRoles } from \"./role-helpers.js\";\nimport { clearScreen, setScreen } from \"./screen.js\";\nimport { captureAndSaveScreenshot } from \"./screenshot.js\";\nimport { type Container, TOPLEVELS, traverse } from \"./traversal.js\";\nimport { resetClipboard } from \"./user-event/index.js\";\nimport { within } from \"./within.js\";\n\ntype ActiveRender = {\n    root: ReconcilerRoot;\n    window: Gtk.Window | null;\n};\n\ntype ResolvedContainer = {\n    containerInfo: Gtk.Widget | RootElement;\n    window: Gtk.Window | null;\n};\n\ntype ReconcilerErrorState = {\n    lastError: Error | null;\n    isHandlerInstalled: boolean;\n};\n\nconst reconcilerErrors: ReconcilerErrorState = { lastError: null, isHandlerInstalled: false };\nconst activeRenders: Set<ActiveRender> = new Set();\nconst HARNESS_WINDOW_WIDTH = 800;\nconst HARNESS_WINDOW_HEIGHT = 600;\n\nconst flushLayout = (window: Gtk.Window | null): Promise<void> =>\n    new Promise((resolve) => {\n        scheduleAfterLayout(window, resolve);\n    });\n\nconst update = async (element: ReactNode, root: ReconcilerRoot): Promise<void> => {\n    await runInAct(() => {\n        root.update(element);\n    });\n\n    if (reconcilerErrors.lastError) {\n        const captured = reconcilerErrors.lastError;\n        reconcilerErrors.lastError = null;\n        throw captured;\n    }\n};\n\nconst disposeActiveRender = async (active: ActiveRender): Promise<void> => {\n    if (!activeRenders.delete(active)) {\n        return;\n    }\n\n    await active.root.unmount(async (root) => {\n        await update(null, root);\n        active.window?.destroy();\n    });\n};\n\nconst disposeAllActiveRenders = async (): Promise<void> => {\n    for (const active of activeRenders) {\n        await disposeActiveRender(active);\n    }\n};\n\nconst handleError = (error: unknown): void => {\n    reconcilerErrors.lastError = error instanceof Error ? error : new Error(String(error));\n};\n\nconst installErrorHandler = (): void => {\n    if (reconcilerErrors.isHandlerInstalled) {\n        return;\n    }\n\n    setReconcilerErrorHandler(handleError);\n    reconcilerErrors.isHandlerInstalled = true;\n};\n\nconst resolveContainer = (container: RenderOptions[\"container\"]): ResolvedContainer => {\n    if (isRootElement(container)) {\n        return { containerInfo: container, window: null };\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return { containerInfo: container, window: null };\n    }\n\n    const window = new Gtk.Window({ defaultWidth: HARNESS_WINDOW_WIDTH, defaultHeight: HARNESS_WINDOW_HEIGHT });\n    window.setDecorated(false);\n\n    return { containerInfo: window, window };\n};\n\nconst firstToplevelWidget = (baseElement: Container): Gtk.Widget => {\n    if (baseElement instanceof Gtk.Widget) {\n        return baseElement;\n    }\n\n    const [first] = traverse(baseElement);\n\n    if (first) {\n        return first;\n    }\n\n    throw new Error(\"render() produced no widgets: ensure the element renders visible content\");\n};\n\nconst resolveResultContainer = (\n    resolved: ResolvedContainer,\n    container: RenderOptions[\"container\"],\n    baseElement: Container,\n): Gtk.Widget => {\n    if (resolved.window) {\n        return resolved.window;\n    }\n\n    if (container instanceof Gtk.Widget) {\n        return container;\n    }\n\n    return firstToplevelWidget(baseElement);\n};\n\nconst renderErrorHandlers = <Q extends QueryMap>(options: RenderOptions<Q> | undefined) => ({\n    onUncaughtError: handleError,\n    onCaughtError: (error: unknown, errorInfo: ErrorInfo): void => {\n        handleError(error);\n        options?.onCaughtError?.(error, errorInfo);\n    },\n    onRecoverableError: (error: unknown, errorInfo: ErrorInfo): void => {\n        options?.onRecoverableError?.(error, errorInfo);\n    },\n});\n\nconst applyEnableAnimations = (areAnimationsEnabled: boolean): void => {\n    const settings = Gtk.Settings.getDefault();\n\n    if (settings) {\n        settings.gtkEnableAnimations = areAnimationsEnabled;\n    }\n};\n\n/**\n * Renders a React element into a GTK4 widget tree and returns queries\n * scoped to it along with controls for rerendering and unmounting. When no\n * container is supplied, a harness window is created and presented.\n *\n * @param element The React element to render.\n * @param options Optional container, wrapper, custom queries, and other render settings.\n * @returns A render result with bound queries, debug helpers, and lifecycle controls.\n */\nconst render = async <Q extends QueryMap = Record<never, never>>(\n    element: ReactNode,\n    options?: RenderOptions<Q>,\n): Promise<RenderResult<Q>> => {\n    installErrorHandler();\n    applyEnableAnimations(options?.areAnimationsEnabled === true);\n    const baseElement: Container = options?.baseElement ?? TOPLEVELS;\n    const Wrapper = options?.wrapper;\n    const resolved = resolveContainer(options?.container);\n\n    const root = createReconcilerRoot({\n        containerInfo: resolved.containerInfo,\n        ...renderErrorHandlers(options),\n    });\n\n    const active: ActiveRender = { root, window: resolved.window };\n    activeRenders.add(active);\n    addToCleanupQueue(disposeAllActiveRenders);\n    addToCleanupQueue(clearScreen);\n    addToCleanupQueue(resetClipboard);\n\n    const wrap = (node: ReactNode): ReactNode => {\n        const wrapped = Wrapper ? <Wrapper>{node}</Wrapper> : node;\n\n        return options?.isReactStrictMode ? <StrictMode>{wrapped}</StrictMode> : wrapped;\n    };\n\n    await update(wrap(element), root);\n    resolved.window?.present();\n    await flushLayout(resolved.window);\n    const container = resolveResultContainer(resolved, options?.container, baseElement);\n\n    const result: RenderResult<Q> = {\n        ...within(baseElement, options?.queries),\n        container,\n        baseElement,\n        unmount: async () => {\n            await disposeActiveRender(active);\n        },\n        rerender: async (newElement: ReactNode) => {\n            await update(wrap(newElement), root);\n            await flushLayout(resolved.window);\n        },\n        debug: (element: Container | Container[] = baseElement, debugOptions?: PrettyWidgetOptions) => {\n            logWidget(element, debugOptions);\n        },\n        logRoles: () => {\n            logRoles(baseElement);\n        },\n        screenshot: (selector?: WindowSelector, screenshotOptions?: ScreenshotOptions) =>\n            captureAndSaveScreenshot(selector, screenshotOptions),\n    };\n\n    setScreen(result);\n\n    return result;\n};\n\n/**\n * Unmounts every active render and runs all registered cleanup callbacks,\n * resetting the screen and clipboard. Called automatically after each test.\n */\nconst cleanup = async (): Promise<void> => {\n    await runCleanup();\n};\n\nexport { render, cleanup };\n"]}

package/dist/suggestions.d.ts

@@ -8,10 +8,13 @@ type Method = "Role" | "LabelText" | "PlaceholderText" | "Text" | "DisplayValue"
  * `toString` that renders the full call.
  */
 type Suggestion = {
+    /** The query family, such as `Role`. */
     queryName: Method;
     /** The full query function name, such as `getByRole`. */
     queryMethod: string;
+    /** The variant the suggestion was asked for, which prefixes `Suggestion.queryMethod`. */
     variant: Variant;
+    /** Renders the suggested call with its arguments, such as `getByRole(Gtk.AccessibleRole.BUTTON)`. */
     toString: () => string;
 };
 /**

package/dist/suggestions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAYpC,8CAA8C;AAC9C,KAAK,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAC5E,6CAA6C;AAC7C,KAAK,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC;AAE1F;;;GAGG;AACH,KAAK,UAAU,GAAG;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAsCF;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,GACnB,QAAQ,GAAG,CAAC,MAAM,EAClB,UAAS,OAAe,EACxB,SAAS,MAAM,KAChB,UAAU,GAAG,SA0Bf,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,CAAC"}
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAYpC,8CAA8C;AAC9C,KAAK,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAC5E,6CAA6C;AAC7C,KAAK,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC;AAE1F;;;GAGG;AACH,KAAK,UAAU,GAAG;IACd,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;IACjB,qGAAqG;IACrG,QAAQ,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAsCF;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,GACnB,QAAQ,GAAG,CAAC,MAAM,EAClB,UAAS,OAAe,EACxB,SAAS,MAAM,KAChB,UAAU,GAAG,SA0Bf,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,CAAC"}

package/dist/suggestions.js.map

@@ -1 +1 @@
-{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { formatRole } from \"./role-helpers.js\";\nimport {\n    getWidgetAccessibleName,\n    getWidgetDisplayValue,\n    getWidgetLabelledByText,\n    getWidgetLabelText,\n    getWidgetName,\n    getWidgetOwnLabel,\n    getWidgetPlaceholderText,\n} from \"./widget-accessible-properties.js\";\n\n/** The query variant a suggestion targets. */\ntype Variant = \"get\" | \"getAll\" | \"query\" | \"queryAll\" | \"find\" | \"findAll\";\n/** The query family a suggestion targets. */\ntype Method = \"Role\" | \"LabelText\" | \"PlaceholderText\" | \"Text\" | \"DisplayValue\" | \"Name\";\n\n/**\n * A suggested query for reaching a widget, including its family, variant, method name, and a\n * `toString` that renders the full call.\n */\ntype Suggestion = {\n    queryName: Method;\n    /** The full query function name, such as `getByRole`. */\n    queryMethod: string;\n    variant: Variant;\n    toString: () => string;\n};\n\nconst makeSuggestion = (queryName: Method, variant: Variant, argsText: string): Suggestion => {\n    const queryMethod = `${variant}By${queryName}`;\n\n    return {\n        queryName,\n        queryMethod,\n        variant,\n        toString: () => `${queryMethod}(${argsText})`,\n    };\n};\n\nconst roleSuggestion = (widget: Gtk.Widget, variant: Variant): Suggestion | undefined => {\n    const role = widget.getAccessibleRole();\n\n    if (role === Gtk.AccessibleRole.NONE || role === Gtk.AccessibleRole.GENERIC) {\n        return undefined;\n    }\n\n    const roleText = `Gtk.AccessibleRole.${formatRole(role).toUpperCase()}`;\n    const name = getWidgetAccessibleName(widget);\n\n    if (name === null) {\n        return makeSuggestion(\"Role\", variant, roleText);\n    }\n\n    return makeSuggestion(\"Role\", variant, `${roleText}, { name: '${name}' }`);\n};\n\nconst textSuggestion = (queryName: Method, variant: Variant, value: string | null): Suggestion | undefined => {\n    if (value === null) {\n        return undefined;\n    }\n\n    return makeSuggestion(queryName, variant, `'${value}'`);\n};\n\n/**\n * Computes the recommended query for reaching the given widget, preferring role, then label text,\n * placeholder text, text, display value, and name.\n * @param widget Widget to build a suggestion for.\n * @param variant Query variant the suggestion should use.\n * @param method Restrict the suggestion to a specific query family instead of choosing by priority.\n * @returns The best available suggestion, or undefined when no query applies.\n */\nconst getSuggestedQuery = (\n    widget: Gtk.Widget,\n    variant: Variant = \"get\",\n    method?: Method,\n): Suggestion | undefined => {\n    const builders: Record<Method, () => Suggestion | undefined> = {\n        Role: () => roleSuggestion(widget, variant),\n        LabelText: () =>\n            textSuggestion(\"LabelText\", variant, getWidgetOwnLabel(widget) ?? getWidgetLabelledByText(widget)),\n        PlaceholderText: () => textSuggestion(\"PlaceholderText\", variant, getWidgetPlaceholderText(widget)),\n        Text: () => textSuggestion(\"Text\", variant, getWidgetLabelText(widget)),\n        DisplayValue: () => textSuggestion(\"DisplayValue\", variant, getWidgetDisplayValue(widget)),\n        Name: () => textSuggestion(\"Name\", variant, getWidgetName(widget)),\n    };\n\n    if (method) {\n        return builders[method]();\n    }\n\n    const priority: Method[] = [\"Role\", \"LabelText\", \"PlaceholderText\", \"Text\", \"DisplayValue\", \"Name\"];\n\n    for (const candidate of priority) {\n        const suggestion = builders[candidate]();\n\n        if (suggestion) {\n            return suggestion;\n        }\n    }\n\n    return undefined;\n};\n\nexport { getSuggestedQuery, type Variant, type Method, type Suggestion };\n"]}
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { formatRole } from \"./role-helpers.js\";\nimport {\n    getWidgetAccessibleName,\n    getWidgetDisplayValue,\n    getWidgetLabelledByText,\n    getWidgetLabelText,\n    getWidgetName,\n    getWidgetOwnLabel,\n    getWidgetPlaceholderText,\n} from \"./widget-accessible-properties.js\";\n\n/** The query variant a suggestion targets. */\ntype Variant = \"get\" | \"getAll\" | \"query\" | \"queryAll\" | \"find\" | \"findAll\";\n/** The query family a suggestion targets. */\ntype Method = \"Role\" | \"LabelText\" | \"PlaceholderText\" | \"Text\" | \"DisplayValue\" | \"Name\";\n\n/**\n * A suggested query for reaching a widget, including its family, variant, method name, and a\n * `toString` that renders the full call.\n */\ntype Suggestion = {\n    /** The query family, such as `Role`. */\n    queryName: Method;\n    /** The full query function name, such as `getByRole`. */\n    queryMethod: string;\n    /** The variant the suggestion was asked for, which prefixes `Suggestion.queryMethod`. */\n    variant: Variant;\n    /** Renders the suggested call with its arguments, such as `getByRole(Gtk.AccessibleRole.BUTTON)`. */\n    toString: () => string;\n};\n\nconst makeSuggestion = (queryName: Method, variant: Variant, argsText: string): Suggestion => {\n    const queryMethod = `${variant}By${queryName}`;\n\n    return {\n        queryName,\n        queryMethod,\n        variant,\n        toString: () => `${queryMethod}(${argsText})`,\n    };\n};\n\nconst roleSuggestion = (widget: Gtk.Widget, variant: Variant): Suggestion | undefined => {\n    const role = widget.getAccessibleRole();\n\n    if (role === Gtk.AccessibleRole.NONE || role === Gtk.AccessibleRole.GENERIC) {\n        return undefined;\n    }\n\n    const roleText = `Gtk.AccessibleRole.${formatRole(role).toUpperCase()}`;\n    const name = getWidgetAccessibleName(widget);\n\n    if (name === null) {\n        return makeSuggestion(\"Role\", variant, roleText);\n    }\n\n    return makeSuggestion(\"Role\", variant, `${roleText}, { name: '${name}' }`);\n};\n\nconst textSuggestion = (queryName: Method, variant: Variant, value: string | null): Suggestion | undefined => {\n    if (value === null) {\n        return undefined;\n    }\n\n    return makeSuggestion(queryName, variant, `'${value}'`);\n};\n\n/**\n * Computes the recommended query for reaching the given widget, preferring role, then label text,\n * placeholder text, text, display value, and name.\n * @param widget Widget to build a suggestion for.\n * @param variant Query variant the suggestion should use.\n * @param method Restrict the suggestion to a specific query family instead of choosing by priority.\n * @returns The best available suggestion, or undefined when no query applies.\n */\nconst getSuggestedQuery = (\n    widget: Gtk.Widget,\n    variant: Variant = \"get\",\n    method?: Method,\n): Suggestion | undefined => {\n    const builders: Record<Method, () => Suggestion | undefined> = {\n        Role: () => roleSuggestion(widget, variant),\n        LabelText: () =>\n            textSuggestion(\"LabelText\", variant, getWidgetOwnLabel(widget) ?? getWidgetLabelledByText(widget)),\n        PlaceholderText: () => textSuggestion(\"PlaceholderText\", variant, getWidgetPlaceholderText(widget)),\n        Text: () => textSuggestion(\"Text\", variant, getWidgetLabelText(widget)),\n        DisplayValue: () => textSuggestion(\"DisplayValue\", variant, getWidgetDisplayValue(widget)),\n        Name: () => textSuggestion(\"Name\", variant, getWidgetName(widget)),\n    };\n\n    if (method) {\n        return builders[method]();\n    }\n\n    const priority: Method[] = [\"Role\", \"LabelText\", \"PlaceholderText\", \"Text\", \"DisplayValue\", \"Name\"];\n\n    for (const candidate of priority) {\n        const suggestion = builders[candidate]();\n\n        if (suggestion) {\n            return suggestion;\n        }\n    }\n\n    return undefined;\n};\n\nexport { getSuggestedQuery, type Variant, type Method, type Suggestion };\n"]}

package/dist/traversal.d.ts

@@ -1,4 +1,8 @@
 import * as Gtk from "@gtkx/gi/gtk";
+/**
+ * A scope that resolves to a single root widget: the widget itself, the widget a controller or
+ * layout manager is attached to, or a list item's or header's child.
+ */
 type QueryContainer = Gtk.Widget | Gtk.EventController | Gtk.LayoutManager | Gtk.ListItem | Gtk.ListHeader;
 /**
  * A scope that queries and traversal can run against: a widget, an event
@@ -6,6 +10,7 @@ type QueryContainer = Gtk.Widget | Gtk.EventController | Gtk.LayoutManager | Gtk
  * sentinel representing all current toplevel windows.
  */
 type Container = QueryContainer | Gtk.Application | typeof TOPLEVELS;
+/** Container sentinel that widens a query to every toplevel window currently open. */
 declare const TOPLEVELS: unique symbol;
 declare const descendants: (widget: Gtk.Widget) => Generator<Gtk.Widget>;
 declare const roots: (container: Container) => Generator<Gtk.Widget>;

package/dist/traversal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC;AAC3G;;;;GAIG;AACH,KAAK,SAAS,GAAG,cAAc,GAAG,GAAG,CAAC,WAAW,GAAG,OAAO,SAAS,CAAC;AAErE,QAAA,MAAM,SAAS,EAAE,OAAO,MAAiC,CAAC;AAc1D,QAAA,MAAM,WAAW,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAIvE,CAAC;AAsBF,QAAA,MAAM,KAAK,GAAc,WAAW,SAAS,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAYnE,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAc,WAAW,SAAS,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAItE,CAAC;AAEF,QAAA,MAAM,OAAO,GAAI,WAAW,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,OAAO,KAAG,GAAG,CAAC,MAAM,EAUzF,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC"}
+{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC;;;GAGG;AACH,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC;AAC3G;;;;GAIG;AACH,KAAK,SAAS,GAAG,cAAc,GAAG,GAAG,CAAC,WAAW,GAAG,OAAO,SAAS,CAAC;AAErE,sFAAsF;AACtF,QAAA,MAAM,SAAS,EAAE,OAAO,MAAiC,CAAC;AAc1D,QAAA,MAAM,WAAW,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAIvE,CAAC;AAsBF,QAAA,MAAM,KAAK,GAAc,WAAW,SAAS,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAYnE,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAc,WAAW,SAAS,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAItE,CAAC;AAEF,QAAA,MAAM,OAAO,GAAI,WAAW,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,OAAO,KAAG,GAAG,CAAC,MAAM,EAUzF,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC"}

package/dist/traversal.js

@@ -1,4 +1,5 @@
 import * as Gtk from "@gtkx/gi/gtk";
+/** Container sentinel that widens a query to every toplevel window currently open. */
 const TOPLEVELS = Symbol("gtkx.toplevels");
 const isApplication = (container) => container instanceof Gtk.Application;
 const traverseWidgetTree = function* (root) {