@gtkx/testing 2.0.0-beta.2 → 2.0.0-beta.4

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,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"}
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAapC,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,UAAU,EACtB,UAAS,OAAe,EACxB,SAAS,MAAM,KAChB,UAAU,GAAG,SA2Bf,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,CAAC"}

package/dist/suggestions.js

@@ -1,6 +1,7 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { formatRole } from "./role-helpers.js";
 import { getWidgetAccessibleName, getWidgetDisplayValue, getWidgetLabelledByText, getWidgetLabelText, getWidgetName, getWidgetOwnLabel, getWidgetPlaceholderText, } from "./widget-accessible-properties.js";
+import { requireWidget } from "./widget-target.js";
 const makeSuggestion = (queryName, variant, argsText) => {
     const queryMethod = `${variant}By${queryName}`;
     return {
@@ -36,7 +37,8 @@ const textSuggestion = (queryName, variant, value) => {
  * @param method Restrict the suggestion to a specific query family instead of choosing by priority.
  * @returns The best available suggestion, or undefined when no query applies.
  */
-const getSuggestedQuery = (widget, variant = "get", method) => {
+const getSuggestedQuery = (target, variant = "get", method) => {
+    const widget = requireWidget(target);
     const builders = {
         Role: () => roleSuggestion(widget, variant),
         LabelText: () => textSuggestion("LabelText", variant, getWidgetOwnLabel(widget) ?? getWidgetLabelledByText(widget)),

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    /** 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"]}
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EACH,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAsBnD,MAAM,cAAc,GAAG,CAAC,SAAiB,EAAE,OAAgB,EAAE,QAAgB,EAAc,EAAE;IACzF,MAAM,WAAW,GAAG,GAAG,OAAO,KAAK,SAAS,EAAE,CAAC;IAE/C,OAAO;QACH,SAAS;QACT,WAAW;QACX,OAAO;QACP,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,WAAW,IAAI,QAAQ,GAAG;KAChD,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,OAAgB,EAA0B,EAAE;IACpF,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAExC,IAAI,IAAI,KAAK,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC1E,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,UAAU,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IACxE,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,cAAc,IAAI,KAAK,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,SAAiB,EAAE,OAAgB,EAAE,KAAoB,EAA0B,EAAE;IACzG,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,iBAAiB,GAAG,CACtB,MAAsB,EACtB,UAAmB,KAAK,EACxB,MAAe,EACO,EAAE;IACxB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAiD;QAC3D,IAAI,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;QAC3C,SAAS,EAAE,GAAG,EAAE,CACZ,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACtG,eAAe,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,iBAAiB,EAAE,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACnG,IAAI,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvE,YAAY,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC1F,IAAI,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KACrE,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,QAAQ,GAAa,CAAC,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAEpG,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAEzC,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,UAAU,CAAC;QACtB,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAA8C,CAAC","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\";\nimport { requireWidget } from \"./widget-target.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    target: Gtk.Accessible,\n    variant: Variant = \"get\",\n    method?: Method,\n): Suggestion | undefined => {\n    const widget = requireWidget(target);\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

@@ -3,21 +3,21 @@ 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;
+type QueryContainer = Gtk.Accessible | Gtk.EventController | Gtk.LayoutManager | Gtk.ListItem | Gtk.ListHeader;
 /**
  * A scope that queries and traversal can run against: a widget, an event
  * controller, a layout manager, a list item or header, an application, or the
  * sentinel representing all current toplevel windows.
  */
 type Container = QueryContainer | Gtk.Application | typeof TOPLEVELS;
-type WidgetClass<T extends Gtk.Widget> = abstract new (...args: never[]) => T;
+type WidgetClass<T extends object> = abstract new (...args: never[]) => T;
 /** Container sentinel that widens a query to every toplevel window currently open. */
 declare const TOPLEVELS: unique symbol;
 declare const isOnScreen: (widget: Gtk.Widget) => boolean;
 declare const children: (widget: Gtk.Widget) => Generator<Gtk.Widget>;
 declare const descendants: (widget: Gtk.Widget) => Generator<Gtk.Widget>;
 declare const ancestors: (widget: Gtk.Widget) => Generator<Gtk.Widget>;
-declare const ancestorFor: <T extends Gtk.Widget>(widget: Gtk.Widget, type: WidgetClass<T>) => T | null;
+declare const ancestorFor: <T extends object>(widget: Gtk.Widget, type: WidgetClass<T>) => T | null;
 declare const relationCandidates: (widget: Gtk.Widget) => Gtk.Accessible[];
 declare const roots: (container: Container) => Generator<Gtk.Widget>;
 declare const traverse: (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;;;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;AACrE,KAAK,WAAW,CAAC,CAAC,SAAS,GAAG,CAAC,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAE9E,sFAAsF;AACtF,QAAA,MAAM,SAAS,EAAE,OAAO,MAAiC,CAAC;AAI1D,QAAA,MAAM,UAAU,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAA6B,CAAC;AAkBvE,QAAA,MAAM,QAAQ,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAOpE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAIvE,CAAC;AAEF,QAAA,MAAM,SAAS,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAOrE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,KAAG,CAAC,GAAG,IAQzF,CAAC;AAEF,QAAA,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,UAAU,EAS9D,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,EACH,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,KAAK,EACL,QAAQ,EACR,KAAK,SAAS,GACjB,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,UAAU,GAAG,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC;AAC/G;;;;GAIG;AACH,KAAK,SAAS,GAAG,cAAc,GAAG,GAAG,CAAC,WAAW,GAAG,OAAO,SAAS,CAAC;AACrE,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAE1E,sFAAsF;AACtF,QAAA,MAAM,SAAS,EAAE,OAAO,MAAiC,CAAC;AAI1D,QAAA,MAAM,UAAU,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAA6B,CAAC;AAkBvE,QAAA,MAAM,QAAQ,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAOpE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAIvE,CAAC;AAEF,QAAA,MAAM,SAAS,GAAc,QAAQ,GAAG,CAAC,MAAM,KAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAOrE,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,KAAG,CAAC,GAAG,IAQrF,CAAC;AAEF,QAAA,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,UAAU,EAS9D,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,EACH,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,KAAK,EACL,QAAQ,EACR,KAAK,SAAS,GACjB,CAAC"}

package/dist/traversal.js

@@ -62,7 +62,7 @@ const resolveRoot = (container) => {
     if (container instanceof Gtk.ListItem || container instanceof Gtk.ListHeader) {
         return container.getChild();
     }
-    return null;
+    throw new TypeError("Query container must resolve to a Gtk.Widget");
 };
 const roots = function* (container) {
     if (container === TOPLEVELS || isApplication(container)) {

package/dist/traversal.js.map

@@ -1 +1 @@
-{"version":3,"file":"traversal.js","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\n\n/**\n * A scope that resolves to a single root widget: the widget itself, the widget a controller or\n * layout manager is attached to, or a list item's or header's child.\n */\ntype QueryContainer = Gtk.Widget | Gtk.EventController | Gtk.LayoutManager | Gtk.ListItem | Gtk.ListHeader;\n/**\n * A scope that queries and traversal can run against: a widget, an event\n * controller, a layout manager, a list item or header, an application, or the\n * sentinel representing all current toplevel windows.\n */\ntype Container = QueryContainer | Gtk.Application | typeof TOPLEVELS;\ntype WidgetClass<T extends Gtk.Widget> = abstract new (...args: never[]) => T;\n\n/** Container sentinel that widens a query to every toplevel window currently open. */\nconst TOPLEVELS: unique symbol = Symbol(\"gtkx.toplevels\");\n\nconst isApplication = (container: Container): container is Gtk.Application => container instanceof Gtk.Application;\nconst isAnyWidget = (): boolean => true;\nconst isOnScreen = (widget: Gtk.Widget): boolean => widget.getMapped();\n\nconst traverseWidgetTree = function* (\n    root: Gtk.Widget,\n    isIncluded: (widget: Gtk.Widget) => boolean,\n): Generator<Gtk.Widget> {\n    if (isIncluded(root)) {\n        yield root;\n    }\n\n    let child = root.getFirstChild();\n\n    while (child) {\n        yield* traverseWidgetTree(child, isIncluded);\n        child = child.getNextSibling();\n    }\n};\n\nconst children = function* (widget: Gtk.Widget): Generator<Gtk.Widget> {\n    let child = widget.getFirstChild();\n\n    while (child) {\n        yield child;\n        child = child.getNextSibling();\n    }\n};\n\nconst descendants = function* (widget: Gtk.Widget): Generator<Gtk.Widget> {\n    const tree = traverseWidgetTree(widget, isAnyWidget);\n    tree.next();\n    yield* tree;\n};\n\nconst ancestors = function* (widget: Gtk.Widget): Generator<Gtk.Widget> {\n    let parent = widget.getParent();\n\n    while (parent) {\n        yield parent;\n        parent = parent.getParent();\n    }\n};\n\nconst ancestorFor = <T extends Gtk.Widget>(widget: Gtk.Widget, type: WidgetClass<T>): T | null => {\n    for (const ancestor of ancestors(widget)) {\n        if (ancestor instanceof type) {\n            return ancestor;\n        }\n    }\n\n    return null;\n};\n\nconst relationCandidates = (widget: Gtk.Widget): Gtk.Accessible[] => {\n    const pool: Gtk.Accessible[] = [...widget.listMnemonicLabels(), ...descendants(widget)];\n    const root = widget.getRoot();\n\n    if (root instanceof Gtk.Widget) {\n        pool.push(...traverseWidgetTree(root, isAnyWidget));\n    }\n\n    return [...new Set(pool)];\n};\n\nconst resolveRoot = (container: QueryContainer): Gtk.Widget | null => {\n    if (container instanceof Gtk.Widget) {\n        return container;\n    }\n\n    if (container instanceof Gtk.EventController) {\n        return container.getWidget();\n    }\n\n    if (container instanceof Gtk.LayoutManager) {\n        return container.getWidget();\n    }\n\n    if (container instanceof Gtk.ListItem || container instanceof Gtk.ListHeader) {\n        return container.getChild();\n    }\n\n    return null;\n};\n\nconst roots = function* (container: Container): Generator<Gtk.Widget> {\n    if (container === TOPLEVELS || isApplication(container)) {\n        yield* Gtk.Window.listToplevels();\n\n        return;\n    }\n\n    const root = resolveRoot(container);\n\n    if (root) {\n        yield root;\n    }\n};\n\nconst traverse = function* (container: Container): Generator<Gtk.Widget> {\n    for (const root of roots(container)) {\n        yield* traverseWidgetTree(root, isOnScreen);\n    }\n};\n\nconst findAll = (container: Container, isMatch: (node: Gtk.Widget) => boolean): Gtk.Widget[] => {\n    const results: Gtk.Widget[] = [];\n\n    for (const node of traverse(container)) {\n        if (isMatch(node)) {\n            results.push(node);\n        }\n    }\n\n    return results;\n};\n\nexport {\n    TOPLEVELS,\n    ancestorFor,\n    ancestors,\n    children,\n    descendants,\n    findAll,\n    isOnScreen,\n    relationCandidates,\n    roots,\n    traverse,\n    type Container,\n};\n"]}
+{"version":3,"file":"traversal.js","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\n\n/**\n * A scope that resolves to a single root widget: the widget itself, the widget a controller or\n * layout manager is attached to, or a list item's or header's child.\n */\ntype QueryContainer = Gtk.Accessible | Gtk.EventController | Gtk.LayoutManager | Gtk.ListItem | Gtk.ListHeader;\n/**\n * A scope that queries and traversal can run against: a widget, an event\n * controller, a layout manager, a list item or header, an application, or the\n * sentinel representing all current toplevel windows.\n */\ntype Container = QueryContainer | Gtk.Application | typeof TOPLEVELS;\ntype WidgetClass<T extends object> = abstract new (...args: never[]) => T;\n\n/** Container sentinel that widens a query to every toplevel window currently open. */\nconst TOPLEVELS: unique symbol = Symbol(\"gtkx.toplevels\");\n\nconst isApplication = (container: Container): container is Gtk.Application => container instanceof Gtk.Application;\nconst isAnyWidget = (): boolean => true;\nconst isOnScreen = (widget: Gtk.Widget): boolean => widget.getMapped();\n\nconst traverseWidgetTree = function* (\n    root: Gtk.Widget,\n    isIncluded: (widget: Gtk.Widget) => boolean,\n): Generator<Gtk.Widget> {\n    if (isIncluded(root)) {\n        yield root;\n    }\n\n    let child = root.getFirstChild();\n\n    while (child) {\n        yield* traverseWidgetTree(child, isIncluded);\n        child = child.getNextSibling();\n    }\n};\n\nconst children = function* (widget: Gtk.Widget): Generator<Gtk.Widget> {\n    let child = widget.getFirstChild();\n\n    while (child) {\n        yield child;\n        child = child.getNextSibling();\n    }\n};\n\nconst descendants = function* (widget: Gtk.Widget): Generator<Gtk.Widget> {\n    const tree = traverseWidgetTree(widget, isAnyWidget);\n    tree.next();\n    yield* tree;\n};\n\nconst ancestors = function* (widget: Gtk.Widget): Generator<Gtk.Widget> {\n    let parent = widget.getParent();\n\n    while (parent) {\n        yield parent;\n        parent = parent.getParent();\n    }\n};\n\nconst ancestorFor = <T extends object>(widget: Gtk.Widget, type: WidgetClass<T>): T | null => {\n    for (const ancestor of ancestors(widget)) {\n        if (ancestor instanceof type) {\n            return ancestor;\n        }\n    }\n\n    return null;\n};\n\nconst relationCandidates = (widget: Gtk.Widget): Gtk.Accessible[] => {\n    const pool: Gtk.Accessible[] = [...widget.listMnemonicLabels(), ...descendants(widget)];\n    const root = widget.getRoot();\n\n    if (root instanceof Gtk.Widget) {\n        pool.push(...traverseWidgetTree(root, isAnyWidget));\n    }\n\n    return [...new Set(pool)];\n};\n\nconst resolveRoot = (container: QueryContainer): Gtk.Widget | null => {\n    if (container instanceof Gtk.Widget) {\n        return container;\n    }\n\n    if (container instanceof Gtk.EventController) {\n        return container.getWidget();\n    }\n\n    if (container instanceof Gtk.LayoutManager) {\n        return container.getWidget();\n    }\n\n    if (container instanceof Gtk.ListItem || container instanceof Gtk.ListHeader) {\n        return container.getChild();\n    }\n\n    throw new TypeError(\"Query container must resolve to a Gtk.Widget\");\n};\n\nconst roots = function* (container: Container): Generator<Gtk.Widget> {\n    if (container === TOPLEVELS || isApplication(container)) {\n        yield* Gtk.Window.listToplevels();\n\n        return;\n    }\n\n    const root = resolveRoot(container);\n\n    if (root) {\n        yield root;\n    }\n};\n\nconst traverse = function* (container: Container): Generator<Gtk.Widget> {\n    for (const root of roots(container)) {\n        yield* traverseWidgetTree(root, isOnScreen);\n    }\n};\n\nconst findAll = (container: Container, isMatch: (node: Gtk.Widget) => boolean): Gtk.Widget[] => {\n    const results: Gtk.Widget[] = [];\n\n    for (const node of traverse(container)) {\n        if (isMatch(node)) {\n            results.push(node);\n        }\n    }\n\n    return results;\n};\n\nexport {\n    TOPLEVELS,\n    ancestorFor,\n    ancestors,\n    children,\n    descendants,\n    findAll,\n    isOnScreen,\n    relationCandidates,\n    roots,\n    traverse,\n    type Container,\n};\n"]}

package/dist/types.d.ts

@@ -14,9 +14,9 @@ type Matcher = string | number | RegExp | MatcherFunction;
 type NormalizerFn = (text: string) => string;
 /**
  * A widget class usable as a query's `as` constraint, such as `Gtk.Button`. Abstract classes and
- * generated GInterface pseudo-classes are accepted.
+ * generated GInterface pseudo-classes that extend `Gtk.Accessible` are accepted.
  */
-type WidgetType<T extends Gtk.Widget = Gtk.Widget> = abstract new (...args: never[]) => T;
+type WidgetType<T extends Gtk.Accessible = Gtk.Accessible> = abstract new (...args: never[]) => T;
 /** Options controlling the default text normalizer. */
 type NormalizerOptions = {
     /** Trim leading and trailing whitespace. */
@@ -36,7 +36,7 @@ type WaitForOptions = {
     stackTraceError?: Error | undefined;
 };
 /** Options controlling text matching and, for asynchronous queries, polling behavior. */
-type MatcherOptions<T extends Gtk.Widget = Gtk.Widget> = {
+type MatcherOptions<T extends Gtk.Accessible = Gtk.Accessible> = {
     /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */
     exact?: boolean | undefined;
     /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */
@@ -68,7 +68,7 @@ type ByRoleValue = {
     text?: Matcher | undefined;
 };
 /** Options for role queries: an accessible name matcher plus accessible state and value constraints. */
-type ByRoleOptions<T extends Gtk.Widget = Gtk.Widget> = MatcherOptions<T> & {
+type ByRoleOptions<T extends Gtk.Accessible = Gtk.Accessible> = MatcherOptions<T> & {
     /** Matcher for the widget's accessible name. */
     name?: Matcher | undefined;
     /** Required checked state; a mixed check button reads as neither, so it matches neither value. */
@@ -105,7 +105,7 @@ type BoundCustomQueries<Q extends QueryMap> = {
     [K in keyof Q]: BoundQuery<Q[K]>;
 };
 /** What each variant of a query family yields for the widget type it matched. */
-type QueryFamilyReturns<T extends Gtk.Widget> = {
+type QueryFamilyReturns<T extends Gtk.Accessible> = {
     /** The single match, or null when nothing matched; throws when more than one matched. */
     queryBy: T | null;
     /** Every match, empty when nothing matched. */
@@ -122,13 +122,13 @@ type QueryFamilyReturns<T extends Gtk.Widget> = {
 /** What a query family matches against, which fixes the arguments it takes. */
 type QueryKind = "role" | "text" | "name" | "value";
 /** The arguments a query of the given kind takes after the family's leading ones. */
-type QueryArgs<Kind extends QueryKind, T extends Gtk.Widget> = Kind extends "role" ? [role: Gtk.AccessibleRole, options?: ByRoleOptions<T>] : Kind extends "name" ? [name: Matcher, options?: MatcherOptions<T>] : Kind extends "value" ? [value: Matcher, options?: MatcherOptions<T>] : [text: Matcher, options?: MatcherOptions<T>];
+type QueryArgs<Kind extends QueryKind, T extends Gtk.Accessible> = Kind extends "role" ? [role: Gtk.AccessibleRole, options?: ByRoleOptions<T>] : Kind extends "name" ? [name: Matcher, options?: MatcherOptions<T>] : Kind extends "value" ? [value: Matcher, options?: MatcherOptions<T>] : [text: Matcher, options?: MatcherOptions<T>];
 /**
  * One family's query variants, each named for its variant followed by `Suffix` and taking `Head`
  * ahead of the family's own arguments.
  */
 type QueryFamily<Suffix extends string, Kind extends QueryKind, Head extends unknown[]> = {
-    [K in keyof QueryFamilyReturns<Gtk.Widget> as `${K & string}${Suffix}`]: <T extends Gtk.Widget = Gtk.Widget>(...args: [...Head, ...QueryArgs<Kind, T>]) => QueryFamilyReturns<T>[K];
+    [K in keyof QueryFamilyReturns<Gtk.Widget> as `${K & string}${Suffix}`]: <T extends Gtk.Accessible = Gtk.Widget>(...args: [...Head, ...QueryArgs<Kind, T>]) => QueryFamilyReturns<T>[K];
 };
 /**
  * Every built-in query, spanning the Role, LabelText, Text, Name, PlaceholderText, and DisplayValue
@@ -146,7 +146,7 @@ type RenderOptions<Q extends QueryMap = Record<never, never>> = {
      * out of reach of a pointer and a keyboard, so every `userEvent` helper aimed at it rejects
      * after `actionabilityTimeout`; `fireEvent` drives such a tree instead.
      */
-    container?: Gtk.Widget | RootElement | undefined;
+    container?: Gtk.Accessible | RootElement | undefined;
     /** Root of the subtree that bound queries search. */
     baseElement?: Container | undefined;
     /** Component wrapped around the rendered element, such as a context provider. */

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsQA,OAAO,EAoBN,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { RootElement } from \"@gtkx/react\";\nimport type { ComponentType, ErrorInfo, ReactNode } from \"react\";\nimport type { PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport type { Container } from \"./traversal.js\";\n\n/**\n * A custom matcher predicate: given a candidate widget's normalized text content and the widget\n * itself, returns whether it matches.\n */\ntype MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;\n/** A value used to match widget text: a string or number, a regular expression, or a custom {@link MatcherFunction}. */\ntype Matcher = string | number | RegExp | MatcherFunction;\n/** Normalizes a widget's text before it is compared against a matcher. */\ntype NormalizerFn = (text: string) => string;\n/**\n * A widget class usable as a query's `as` constraint, such as `Gtk.Button`. Abstract classes and\n * generated GInterface pseudo-classes are accepted.\n */\ntype WidgetType<T extends Gtk.Widget = Gtk.Widget> = abstract new (...args: never[]) => T;\n\n/** Options controlling the default text normalizer. */\ntype NormalizerOptions = {\n    /** Trim leading and trailing whitespace. */\n    trim?: boolean | undefined;\n    /** Collapse runs of whitespace into a single space. */\n    collapseWhitespace?: boolean | undefined;\n};\n\n/** Options controlling how asynchronous queries and waits poll for a condition. */\ntype WaitForOptions = {\n    /** Maximum time in milliseconds to keep retrying before failing. */\n    timeout?: number | undefined;\n    /** Delay in milliseconds between retries. */\n    interval?: number | undefined;\n    /** Transforms the error thrown when the timeout elapses. */\n    onTimeout?: ((error: Error) => Error) | undefined;\n    /** Error whose stack trace attributes the timeout failure to the calling code. */\n    stackTraceError?: Error | undefined;\n};\n\n/** Options controlling text matching and, for asynchronous queries, polling behavior. */\ntype MatcherOptions<T extends Gtk.Widget = Gtk.Widget> = {\n    /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */\n    exact?: boolean | undefined;\n    /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */\n    normalizer?: NormalizerFn | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    trim?: boolean | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    collapseWhitespace?: boolean | undefined;\n    /** Whether to include a suggested better query in error messages. */\n    suggest?: boolean | undefined;\n    /** Restricts matches to instances of this widget class, and narrows the query's return type to it. */\n    as?: WidgetType<T> | undefined;\n} & WaitForOptions;\n\n/**\n * Constraints on a widget's numeric range value used by role queries. The numbers come from the\n * accessibility tree and match within 0.001, the resolution GTK keeps them to.\n */\ntype ByRoleValue = {\n    /** The current value. */\n    now?: number | undefined;\n    /** The lower bound of the value's range. */\n    min?: number | undefined;\n    /**\n     * The highest value the widget can reach, which on a paged widget such as a scrollbar is its\n     * adjustment's upper bound less one page.\n     */\n    max?: number | undefined;\n    /** Matcher for the value's textual representation. */\n    text?: Matcher | undefined;\n};\n\n/** Options for role queries: an accessible name matcher plus accessible state and value constraints. */\ntype ByRoleOptions<T extends Gtk.Widget = Gtk.Widget> = MatcherOptions<T> & {\n    /** Matcher for the widget's accessible name. */\n    name?: Matcher | undefined;\n    /** Required checked state; a mixed check button reads as neither, so it matches neither value. */\n    checked?: boolean | undefined;\n    /** Required active state of a toggle button; any other widget matches neither value. */\n    pressed?: boolean | undefined;\n    /** Required selected state of a row, list item, grid cell, option or tree item. */\n    selected?: boolean | undefined;\n    /** Required expanded state of an expander or tree expander. */\n    expanded?: boolean | undefined;\n    /** Heading or hierarchy level. */\n    level?: number | undefined;\n    /** Required busy state, which an unset state satisfies as false. */\n    busy?: boolean | undefined;\n    /** Matcher for the widget's own accessible description, ignoring its `described-by` targets. */\n    description?: Matcher | undefined;\n    /** Constraints on the widget's range value, each checked only when given. */\n    value?: ByRoleValue | undefined;\n    /** When true, include widgets excluded from the accessibility tree. Widgets that are not mapped stay excluded. */\n    hidden?: boolean | undefined;\n};\n\n/** A React component that wraps rendered content, receiving it as its children. */\ntype WrapperComponent = ComponentType<{\n    children: ReactNode;\n}>;\n\n/** A custom query, taking the scope to search as its first argument and its matcher arguments after it. */\ntype Query = (container: Container, ...args: never[]) => unknown;\n/** Custom queries keyed by the name each is bound under. */\ntype QueryMap = Record<string, Query>;\n\n/** A query with its container argument already applied. */\ntype BoundQuery<Q extends Query> = Q extends (container: Container, ...args: infer A) => infer R\n    ? (...args: A) => R\n    : never;\n\n/** Custom queries with their container argument already applied, keyed as they were passed in. */\ntype BoundCustomQueries<Q extends QueryMap> = { [K in keyof Q]: BoundQuery<Q[K]> };\n\n/** What each variant of a query family yields for the widget type it matched. */\ntype QueryFamilyReturns<T extends Gtk.Widget> = {\n    /** The single match, or null when nothing matched; throws when more than one matched. */\n    queryBy: T | null;\n    /** Every match, empty when nothing matched. */\n    queryAllBy: T[];\n    /** The single match; throws when nothing or more than one matched. */\n    getBy: T;\n    /** Every match; throws when nothing matched. */\n    getAllBy: T[];\n    /** The single match, retried until it appears or the timeout elapses. */\n    findBy: Promise<T>;\n    /** Every match, retried until at least one appears or the timeout elapses. */\n    findAllBy: Promise<T[]>;\n};\n\n/** What a query family matches against, which fixes the arguments it takes. */\ntype QueryKind = \"role\" | \"text\" | \"name\" | \"value\";\n\n/** The arguments a query of the given kind takes after the family's leading ones. */\ntype QueryArgs<Kind extends QueryKind, T extends Gtk.Widget> = Kind extends \"role\"\n    ? [role: Gtk.AccessibleRole, options?: ByRoleOptions<T>]\n    : Kind extends \"name\"\n        ? [name: Matcher, options?: MatcherOptions<T>]\n        : Kind extends \"value\"\n            ? [value: Matcher, options?: MatcherOptions<T>]\n            : [text: Matcher, options?: MatcherOptions<T>];\n\n/**\n * One family's query variants, each named for its variant followed by `Suffix` and taking `Head`\n * ahead of the family's own arguments.\n */\ntype QueryFamily<Suffix extends string, Kind extends QueryKind, Head extends unknown[]> = {\n    [K in keyof QueryFamilyReturns<Gtk.Widget> as `${K & string}${Suffix}`]: <T extends Gtk.Widget = Gtk.Widget>(\n        ...args: [...Head, ...QueryArgs<Kind, T>]\n    ) => QueryFamilyReturns<T>[K];\n};\n\n/**\n * Every built-in query, spanning the Role, LabelText, Text, Name, PlaceholderText, and DisplayValue\n * families, with `Head` prepended to each signature.\n */\ntype QueryFamilies<Head extends unknown[]> = QueryFamily<\"Role\", \"role\", Head> &\n    QueryFamily<\"LabelText\", \"text\", Head> &\n    QueryFamily<\"Text\", \"text\", Head> &\n    QueryFamily<\"Name\", \"name\", Head> &\n    QueryFamily<\"PlaceholderText\", \"text\", Head> &\n    QueryFamily<\"DisplayValue\", \"value\", Head>;\n\n/**\n * Options for {@link render}: the container and base element to mount into, an optional wrapper,\n * React behavior toggles, error callbacks, and custom queries to bind.\n */\ntype RenderOptions<Q extends QueryMap = Record<never, never>> = {\n    /**\n     * Widget or root element to mount into; an undecorated harness window is created when omitted.\n     * A widget container that sits outside every toplevel, such as a bare `Gtk.Box`, keeps the tree\n     * out of reach of a pointer and a keyboard, so every `userEvent` helper aimed at it rejects\n     * after `actionabilityTimeout`; `fireEvent` drives such a tree instead.\n     */\n    container?: Gtk.Widget | RootElement | undefined;\n    /** Root of the subtree that bound queries search. */\n    baseElement?: Container | undefined;\n    /** Component wrapped around the rendered element, such as a context provider. */\n    wrapper?: WrapperComponent | undefined;\n    /** Render inside React StrictMode. */\n    isReactStrictMode?: boolean | undefined;\n    /** Enable widget animations during the test. */\n    areAnimationsEnabled?: boolean | undefined;\n    /** Called for errors caught by React error boundaries. */\n    onCaughtError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Called for errors React recovered from automatically. */\n    onRecoverableError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Custom queries to bind to the rendered result. */\n    queries?: Q | undefined;\n};\n\n/** Console helpers bundled with the bound queries on {@link screen} and on a render result. */\ntype DebugUtilities = {\n    /** Prints the widget tree of the given containers, or of the whole scope, to the console. */\n    debug: (element?: Container | Container[], options?: PrettyWidgetOptions) => void;\n    /** Prints the accessible roles found in the scope, with the widgets carrying each one. */\n    logRoles: () => void;\n    /**\n     * Captures what is on screen, which is the active toplevel window: GTK4 exposes no position for\n     * a toplevel, so windows cannot be composited into a single image.\n     */\n    screenshot: (options?: ScreenshotOptions) => Promise<ScreenshotResult>;\n};\n\n/** A captured screenshot: base64-encoded image data, its MIME type, and pixel dimensions. */\ntype ScreenshotResult = {\n    /** Base64-encoded image bytes. */\n    data: string;\n    /** MIME type of the encoded image, always `image/png`. */\n    mimeType: string;\n    /** Image width in pixels, after the scale factor is applied. */\n    width: number;\n    /** Image height in pixels, after the scale factor is applied. */\n    height: number;\n};\n\n/**\n * Options for capturing a screenshot: the poll timeout and interval, a rendering scale factor, and\n * a file to write the PNG to.\n */\ntype ScreenshotOptions = Pick<WaitForOptions, \"timeout\" | \"interval\"> & {\n    /** Device scale factor applied when rendering. */\n    scale?: number | undefined;\n    /** File the PNG is written to, with its parent directories created as needed. */\n    path?: string | undefined;\n};\n\n/**\n * Options for {@link renderHook}: an optional wrapper and the initial props (required unless the\n * props type permits undefined).\n */\ntype RenderHookOptions<Props> = {\n    /** Component wrapped around the one calling the hook, such as a context provider. */\n    wrapper?: WrapperComponent;\n} & (undefined extends Props\n    ? {\n            /** Props the hook is invoked with until `rerender` is given new ones. */\n            initialProps?: Props;\n        }\n    : {\n            initialProps: Props;\n        });\n\n/**\n * The result of {@link renderHook}: the latest hook return value plus functions to rerender with new\n * props and to unmount.\n */\ntype RenderHookResult<Result, Props> = {\n    /** Stable object the hook's return value is written to on every render. */\n    result: {\n        /** The hook's latest return value. */\n        current: Result;\n    };\n    /** Re-invokes the hook, keeping the previous props when none are given. */\n    rerender: (newProps?: Props) => Promise<void>;\n    /** Unmounts the component that calls the hook. */\n    unmount: () => Promise<void>;\n};\n\nexport {\n    type MatcherFunction,\n    type Matcher,\n    type NormalizerFn,\n    type NormalizerOptions,\n    type WaitForOptions,\n    type MatcherOptions,\n    type ByRoleValue,\n    type ByRoleOptions,\n    type WidgetType,\n    type WrapperComponent,\n    type QueryMap,\n    type BoundCustomQueries,\n    type QueryFamilies,\n    type RenderOptions,\n    type DebugUtilities,\n    type ScreenshotResult,\n    type ScreenshotOptions,\n    type RenderHookOptions,\n    type RenderHookResult,\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA0QA,OAAO,EAoBN,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { RootElement } from \"@gtkx/react\";\nimport type { ComponentType, ErrorInfo, ReactNode } from \"react\";\nimport type { PrettyWidgetOptions } from \"./pretty-widget.js\";\nimport type { Container } from \"./traversal.js\";\n\n/**\n * A custom matcher predicate: given a candidate widget's normalized text content and the widget\n * itself, returns whether it matches.\n */\ntype MatcherFunction = (content: string, widget: Gtk.Widget) => boolean;\n/** A value used to match widget text: a string or number, a regular expression, or a custom {@link MatcherFunction}. */\ntype Matcher = string | number | RegExp | MatcherFunction;\n/** Normalizes a widget's text before it is compared against a matcher. */\ntype NormalizerFn = (text: string) => string;\n/**\n * A widget class usable as a query's `as` constraint, such as `Gtk.Button`. Abstract classes and\n * generated GInterface pseudo-classes that extend `Gtk.Accessible` are accepted.\n */\ntype WidgetType<T extends Gtk.Accessible = Gtk.Accessible> = abstract new (\n    ...args: never[]\n) => T;\n\n/** Options controlling the default text normalizer. */\ntype NormalizerOptions = {\n    /** Trim leading and trailing whitespace. */\n    trim?: boolean | undefined;\n    /** Collapse runs of whitespace into a single space. */\n    collapseWhitespace?: boolean | undefined;\n};\n\n/** Options controlling how asynchronous queries and waits poll for a condition. */\ntype WaitForOptions = {\n    /** Maximum time in milliseconds to keep retrying before failing. */\n    timeout?: number | undefined;\n    /** Delay in milliseconds between retries. */\n    interval?: number | undefined;\n    /** Transforms the error thrown when the timeout elapses. */\n    onTimeout?: ((error: Error) => Error) | undefined;\n    /** Error whose stack trace attributes the timeout failure to the calling code. */\n    stackTraceError?: Error | undefined;\n};\n\n/** Options controlling text matching and, for asynchronous queries, polling behavior. */\ntype MatcherOptions<T extends Gtk.Accessible = Gtk.Accessible> = {\n    /** When true (the default), require an exact match; when false, match case-insensitively as a substring. */\n    exact?: boolean | undefined;\n    /** Custom normalizer replacing the default; cannot be combined with `trim` or `collapseWhitespace`. */\n    normalizer?: NormalizerFn | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    trim?: boolean | undefined;\n    /** Forwarded to the default normalizer when no custom `normalizer` is given. */\n    collapseWhitespace?: boolean | undefined;\n    /** Whether to include a suggested better query in error messages. */\n    suggest?: boolean | undefined;\n    /** Restricts matches to instances of this widget class, and narrows the query's return type to it. */\n    as?: WidgetType<T> | undefined;\n} & WaitForOptions;\n\n/**\n * Constraints on a widget's numeric range value used by role queries. The numbers come from the\n * accessibility tree and match within 0.001, the resolution GTK keeps them to.\n */\ntype ByRoleValue = {\n    /** The current value. */\n    now?: number | undefined;\n    /** The lower bound of the value's range. */\n    min?: number | undefined;\n    /**\n     * The highest value the widget can reach, which on a paged widget such as a scrollbar is its\n     * adjustment's upper bound less one page.\n     */\n    max?: number | undefined;\n    /** Matcher for the value's textual representation. */\n    text?: Matcher | undefined;\n};\n\n/** Options for role queries: an accessible name matcher plus accessible state and value constraints. */\ntype ByRoleOptions<T extends Gtk.Accessible = Gtk.Accessible> = MatcherOptions<T> & {\n    /** Matcher for the widget's accessible name. */\n    name?: Matcher | undefined;\n    /** Required checked state; a mixed check button reads as neither, so it matches neither value. */\n    checked?: boolean | undefined;\n    /** Required active state of a toggle button; any other widget matches neither value. */\n    pressed?: boolean | undefined;\n    /** Required selected state of a row, list item, grid cell, option or tree item. */\n    selected?: boolean | undefined;\n    /** Required expanded state of an expander or tree expander. */\n    expanded?: boolean | undefined;\n    /** Heading or hierarchy level. */\n    level?: number | undefined;\n    /** Required busy state, which an unset state satisfies as false. */\n    busy?: boolean | undefined;\n    /** Matcher for the widget's own accessible description, ignoring its `described-by` targets. */\n    description?: Matcher | undefined;\n    /** Constraints on the widget's range value, each checked only when given. */\n    value?: ByRoleValue | undefined;\n    /** When true, include widgets excluded from the accessibility tree. Widgets that are not mapped stay excluded. */\n    hidden?: boolean | undefined;\n};\n\n/** A React component that wraps rendered content, receiving it as its children. */\ntype WrapperComponent = ComponentType<{\n    children: ReactNode;\n}>;\n\n/** A custom query, taking the scope to search as its first argument and its matcher arguments after it. */\ntype Query = (container: Container, ...args: never[]) => unknown;\n/** Custom queries keyed by the name each is bound under. */\ntype QueryMap = Record<string, Query>;\n\n/** A query with its container argument already applied. */\ntype BoundQuery<Q extends Query> = Q extends (container: Container, ...args: infer A) => infer R\n    ? (...args: A) => R\n    : never;\n\n/** Custom queries with their container argument already applied, keyed as they were passed in. */\ntype BoundCustomQueries<Q extends QueryMap> = { [K in keyof Q]: BoundQuery<Q[K]> };\n\n/** What each variant of a query family yields for the widget type it matched. */\ntype QueryFamilyReturns<T extends Gtk.Accessible> = {\n    /** The single match, or null when nothing matched; throws when more than one matched. */\n    queryBy: T | null;\n    /** Every match, empty when nothing matched. */\n    queryAllBy: T[];\n    /** The single match; throws when nothing or more than one matched. */\n    getBy: T;\n    /** Every match; throws when nothing matched. */\n    getAllBy: T[];\n    /** The single match, retried until it appears or the timeout elapses. */\n    findBy: Promise<T>;\n    /** Every match, retried until at least one appears or the timeout elapses. */\n    findAllBy: Promise<T[]>;\n};\n\n/** What a query family matches against, which fixes the arguments it takes. */\ntype QueryKind = \"role\" | \"text\" | \"name\" | \"value\";\n\n/** The arguments a query of the given kind takes after the family's leading ones. */\ntype QueryArgs<Kind extends QueryKind, T extends Gtk.Accessible> = Kind extends \"role\"\n    ? [role: Gtk.AccessibleRole, options?: ByRoleOptions<T>]\n    : Kind extends \"name\"\n        ? [name: Matcher, options?: MatcherOptions<T>]\n        : Kind extends \"value\"\n            ? [value: Matcher, options?: MatcherOptions<T>]\n            : [text: Matcher, options?: MatcherOptions<T>];\n\n/**\n * One family's query variants, each named for its variant followed by `Suffix` and taking `Head`\n * ahead of the family's own arguments.\n */\ntype QueryFamily<Suffix extends string, Kind extends QueryKind, Head extends unknown[]> = {\n    [K in keyof QueryFamilyReturns<Gtk.Widget> as `${K & string}${Suffix}`]: <\n        T extends Gtk.Accessible = Gtk.Widget,\n    >(\n        ...args: [...Head, ...QueryArgs<Kind, T>]\n    ) => QueryFamilyReturns<T>[K];\n};\n\n/**\n * Every built-in query, spanning the Role, LabelText, Text, Name, PlaceholderText, and DisplayValue\n * families, with `Head` prepended to each signature.\n */\ntype QueryFamilies<Head extends unknown[]> = QueryFamily<\"Role\", \"role\", Head> &\n    QueryFamily<\"LabelText\", \"text\", Head> &\n    QueryFamily<\"Text\", \"text\", Head> &\n    QueryFamily<\"Name\", \"name\", Head> &\n    QueryFamily<\"PlaceholderText\", \"text\", Head> &\n    QueryFamily<\"DisplayValue\", \"value\", Head>;\n\n/**\n * Options for {@link render}: the container and base element to mount into, an optional wrapper,\n * React behavior toggles, error callbacks, and custom queries to bind.\n */\ntype RenderOptions<Q extends QueryMap = Record<never, never>> = {\n    /**\n     * Widget or root element to mount into; an undecorated harness window is created when omitted.\n     * A widget container that sits outside every toplevel, such as a bare `Gtk.Box`, keeps the tree\n     * out of reach of a pointer and a keyboard, so every `userEvent` helper aimed at it rejects\n     * after `actionabilityTimeout`; `fireEvent` drives such a tree instead.\n     */\n    container?: Gtk.Accessible | RootElement | undefined;\n    /** Root of the subtree that bound queries search. */\n    baseElement?: Container | undefined;\n    /** Component wrapped around the rendered element, such as a context provider. */\n    wrapper?: WrapperComponent | undefined;\n    /** Render inside React StrictMode. */\n    isReactStrictMode?: boolean | undefined;\n    /** Enable widget animations during the test. */\n    areAnimationsEnabled?: boolean | undefined;\n    /** Called for errors caught by React error boundaries. */\n    onCaughtError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Called for errors React recovered from automatically. */\n    onRecoverableError?: ((error: unknown, errorInfo: ErrorInfo) => void) | undefined;\n    /** Custom queries to bind to the rendered result. */\n    queries?: Q | undefined;\n};\n\n/** Console helpers bundled with the bound queries on {@link screen} and on a render result. */\ntype DebugUtilities = {\n    /** Prints the widget tree of the given containers, or of the whole scope, to the console. */\n    debug: (element?: Container | Container[], options?: PrettyWidgetOptions) => void;\n    /** Prints the accessible roles found in the scope, with the widgets carrying each one. */\n    logRoles: () => void;\n    /**\n     * Captures what is on screen, which is the active toplevel window: GTK4 exposes no position for\n     * a toplevel, so windows cannot be composited into a single image.\n     */\n    screenshot: (options?: ScreenshotOptions) => Promise<ScreenshotResult>;\n};\n\n/** A captured screenshot: base64-encoded image data, its MIME type, and pixel dimensions. */\ntype ScreenshotResult = {\n    /** Base64-encoded image bytes. */\n    data: string;\n    /** MIME type of the encoded image, always `image/png`. */\n    mimeType: string;\n    /** Image width in pixels, after the scale factor is applied. */\n    width: number;\n    /** Image height in pixels, after the scale factor is applied. */\n    height: number;\n};\n\n/**\n * Options for capturing a screenshot: the poll timeout and interval, a rendering scale factor, and\n * a file to write the PNG to.\n */\ntype ScreenshotOptions = Pick<WaitForOptions, \"timeout\" | \"interval\"> & {\n    /** Device scale factor applied when rendering. */\n    scale?: number | undefined;\n    /** File the PNG is written to, with its parent directories created as needed. */\n    path?: string | undefined;\n};\n\n/**\n * Options for {@link renderHook}: an optional wrapper and the initial props (required unless the\n * props type permits undefined).\n */\ntype RenderHookOptions<Props> = {\n    /** Component wrapped around the one calling the hook, such as a context provider. */\n    wrapper?: WrapperComponent;\n} & (undefined extends Props\n    ? {\n            /** Props the hook is invoked with until `rerender` is given new ones. */\n            initialProps?: Props;\n        }\n    : {\n            initialProps: Props;\n        });\n\n/**\n * The result of {@link renderHook}: the latest hook return value plus functions to rerender with new\n * props and to unmount.\n */\ntype RenderHookResult<Result, Props> = {\n    /** Stable object the hook's return value is written to on every render. */\n    result: {\n        /** The hook's latest return value. */\n        current: Result;\n    };\n    /** Re-invokes the hook, keeping the previous props when none are given. */\n    rerender: (newProps?: Props) => Promise<void>;\n    /** Unmounts the component that calls the hook. */\n    unmount: () => Promise<void>;\n};\n\nexport {\n    type MatcherFunction,\n    type Matcher,\n    type NormalizerFn,\n    type NormalizerOptions,\n    type WaitForOptions,\n    type MatcherOptions,\n    type ByRoleValue,\n    type ByRoleOptions,\n    type WidgetType,\n    type WrapperComponent,\n    type QueryMap,\n    type BoundCustomQueries,\n    type QueryFamilies,\n    type RenderOptions,\n    type DebugUtilities,\n    type ScreenshotResult,\n    type ScreenshotOptions,\n    type RenderHookOptions,\n    type RenderHookResult,\n};\n"]}

package/dist/user-event/controller.d.ts

@@ -8,7 +8,7 @@ type ControllerConstructor<T extends Gtk.EventController> = new () => T;
  * @param controllerType The controller class to match.
  * @returns The matching controllers, or an empty array when the widget has none.
  */
-declare const queryAllControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
+declare const queryAllControllers: <T extends Gtk.EventController>(target: Gtk.Accessible, controllerType: ControllerConstructor<T>) => T[];
 /**
  * Returns the first controller of the given type attached to a widget.
  *
@@ -16,7 +16,7 @@ declare const queryAllControllers: <T extends Gtk.EventController>(widget: Gtk.W
  * @param controllerType The controller class to match.
  * @returns The first matching controller, or null when the widget has none.
  */
-declare const queryController: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T | null;
+declare const queryController: <T extends Gtk.EventController>(widget: Gtk.Accessible, controllerType: ControllerConstructor<T>) => T | null;
 /**
  * Returns every controller of the given type attached to a widget.
  *
@@ -24,7 +24,7 @@ declare const queryController: <T extends Gtk.EventController>(widget: Gtk.Widge
  * @param controllerType The controller class to match.
  * @throws When the widget has no controller of that type.
  */
-declare const getAllControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
+declare const getAllControllers: <T extends Gtk.EventController>(widget: Gtk.Accessible, controllerType: ControllerConstructor<T>) => T[];
 /**
  * Returns the first controller of the given type attached to a widget.
  *
@@ -32,7 +32,7 @@ declare const getAllControllers: <T extends Gtk.EventController>(widget: Gtk.Wid
  * @param controllerType The controller class to match.
  * @throws When the widget has no controller of that type.
  */
-declare const getController: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T;
-declare const getOrCreateControllers: <T extends Gtk.EventController>(widget: Gtk.Widget, controllerType: ControllerConstructor<T>) => T[];
+declare const getController: <T extends Gtk.EventController>(widget: Gtk.Accessible, controllerType: ControllerConstructor<T>) => T;
+declare const getOrCreateControllers: <T extends Gtk.EventController>(target: Gtk.Accessible, controllerType: ControllerConstructor<T>) => T[];
 export { queryAllControllers, queryController, getAllControllers, getController, getOrCreateControllers, type ControllerConstructor, };
 //# sourceMappingURL=controller.d.ts.map

package/dist/user-event/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAEzC,uGAAuG;AACvG,KAAK,qBAAqB,CAAC,CAAC,SAAS,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC,CAAC;AAExE;;;;;;GAMG;AACH,QAAA,MAAM,mBAAmB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACtD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAcH,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EAClD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,GAAG,IAA8D,CAAC;AAEtE;;;;;;GAMG;AACH,QAAA,MAAM,iBAAiB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACpD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAQH,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EAChD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAQF,CAAC;AAEF,QAAA,MAAM,sBAAsB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACzD,QAAQ,GAAG,CAAC,MAAM,EAClB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAWH,CAAC;AAEF,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,KAAK,qBAAqB,GAC7B,CAAC"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAGzC,uGAAuG;AACvG,KAAK,qBAAqB,CAAC,CAAC,SAAS,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC,CAAC;AAExE;;;;;;GAMG;AACH,QAAA,MAAM,mBAAmB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACtD,QAAQ,GAAG,CAAC,UAAU,EACtB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAeH,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EAClD,QAAQ,GAAG,CAAC,UAAU,EACtB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,GAAG,IAA8D,CAAC;AAEtE;;;;;;GAMG;AACH,QAAA,MAAM,iBAAiB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACpD,QAAQ,GAAG,CAAC,UAAU,EACtB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAQH,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EAChD,QAAQ,GAAG,CAAC,UAAU,EACtB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAQF,CAAC;AAEF,QAAA,MAAM,sBAAsB,GAAI,CAAC,SAAS,GAAG,CAAC,eAAe,EACzD,QAAQ,GAAG,CAAC,UAAU,EACtB,gBAAgB,qBAAqB,CAAC,CAAC,CAAC,KACzC,CAAC,EAYH,CAAC;AAEF,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,KAAK,qBAAqB,GAC7B,CAAC"}

package/dist/user-event/controller.js

@@ -1,3 +1,4 @@
+import { requireWidget } from "../widget-target.js";
 /**
  * Returns every controller of the given type attached to a widget, in the order GTK4 reports them.
  *
@@ -5,7 +6,8 @@
  * @param controllerType The controller class to match.
  * @returns The matching controllers, or an empty array when the widget has none.
  */
-const queryAllControllers = (widget, controllerType) => {
+const queryAllControllers = (target, controllerType) => {
+    const widget = requireWidget(target);
     const controllers = widget.observeControllers();
     const nItems = controllers.getNItems();
     const matches = [];
@@ -53,7 +55,8 @@ const getController = (widget, controllerType) => {
     }
     return controller;
 };
-const getOrCreateControllers = (widget, controllerType) => {
+const getOrCreateControllers = (target, controllerType) => {
+    const widget = requireWidget(target);
     const existing = queryAllControllers(widget, controllerType);
     if (existing.length > 0) {
         return existing;

package/dist/user-event/controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,CACxB,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,WAAW,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE1C,IAAI,UAAU,YAAY,cAAc,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,CACpB,MAAkB,EAClB,cAAwC,EAChC,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,CACtB,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEhE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAClB,MAAkB,EAClB,cAAwC,EACvC,EAAE;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE/D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAC3B,MAAkB,EAClB,cAAwC,EACrC,EAAE;IACL,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE7D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAEjC,OAAO,CAAC,UAAU,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,GAEzB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\n\n/** An event controller class that can be constructed without arguments, such as `Gtk.GestureClick`. */\ntype ControllerConstructor<T extends Gtk.EventController> = new () => T;\n\n/**\n * Returns every controller of the given type attached to a widget, in the order GTK4 reports them.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @returns The matching controllers, or an empty array when the widget has none.\n */\nconst queryAllControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const controllers = widget.observeControllers();\n    const nItems = controllers.getNItems();\n    const matches: T[] = [];\n\n    for (let i = 0; i < nItems; i++) {\n        const controller = controllers.getItem(i);\n\n        if (controller instanceof controllerType) {\n            matches.push(controller);\n        }\n    }\n\n    return matches;\n};\n\n/**\n * Returns the first controller of the given type attached to a widget.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @returns The first matching controller, or null when the widget has none.\n */\nconst queryController = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T | null => queryAllControllers(widget, controllerType)[0] ?? null;\n\n/**\n * Returns every controller of the given type attached to a widget.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @throws When the widget has no controller of that type.\n */\nconst getAllControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const controllers = queryAllControllers(widget, controllerType);\n\n    if (controllers.length === 0) {\n        throw new Error(`No ${controllerType.name} controller is attached to the widget`);\n    }\n\n    return controllers;\n};\n\n/**\n * Returns the first controller of the given type attached to a widget.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @throws When the widget has no controller of that type.\n */\nconst getController = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T => {\n    const [controller] = getAllControllers(widget, controllerType);\n\n    if (controller === undefined) {\n        throw new Error(`No ${controllerType.name} controller is attached to the widget`);\n    }\n\n    return controller;\n};\n\nconst getOrCreateControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Widget,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const existing = queryAllControllers(widget, controllerType);\n\n    if (existing.length > 0) {\n        return existing;\n    }\n\n    const controller = new controllerType();\n    widget.addController(controller);\n\n    return [controller];\n};\n\nexport {\n    queryAllControllers,\n    queryController,\n    getAllControllers,\n    getController,\n    getOrCreateControllers,\n    type ControllerConstructor,\n};\n"]}
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/user-event/controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,CACxB,MAAsB,EACtB,cAAwC,EACrC,EAAE;IACL,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE1C,IAAI,UAAU,YAAY,cAAc,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,CACpB,MAAsB,EACtB,cAAwC,EAChC,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,CACtB,MAAsB,EACtB,cAAwC,EACrC,EAAE;IACL,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAEhE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAClB,MAAsB,EACtB,cAAwC,EACvC,EAAE;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE/D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAC3B,MAAsB,EACtB,cAAwC,EACrC,EAAE;IACL,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE7D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAEjC,OAAO,CAAC,UAAU,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,GAEzB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { requireWidget } from \"../widget-target.js\";\n\n/** An event controller class that can be constructed without arguments, such as `Gtk.GestureClick`. */\ntype ControllerConstructor<T extends Gtk.EventController> = new () => T;\n\n/**\n * Returns every controller of the given type attached to a widget, in the order GTK4 reports them.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @returns The matching controllers, or an empty array when the widget has none.\n */\nconst queryAllControllers = <T extends Gtk.EventController>(\n    target: Gtk.Accessible,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const widget = requireWidget(target);\n    const controllers = widget.observeControllers();\n    const nItems = controllers.getNItems();\n    const matches: T[] = [];\n\n    for (let i = 0; i < nItems; i++) {\n        const controller = controllers.getItem(i);\n\n        if (controller instanceof controllerType) {\n            matches.push(controller);\n        }\n    }\n\n    return matches;\n};\n\n/**\n * Returns the first controller of the given type attached to a widget.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @returns The first matching controller, or null when the widget has none.\n */\nconst queryController = <T extends Gtk.EventController>(\n    widget: Gtk.Accessible,\n    controllerType: ControllerConstructor<T>,\n): T | null => queryAllControllers(widget, controllerType)[0] ?? null;\n\n/**\n * Returns every controller of the given type attached to a widget.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @throws When the widget has no controller of that type.\n */\nconst getAllControllers = <T extends Gtk.EventController>(\n    widget: Gtk.Accessible,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const controllers = queryAllControllers(widget, controllerType);\n\n    if (controllers.length === 0) {\n        throw new Error(`No ${controllerType.name} controller is attached to the widget`);\n    }\n\n    return controllers;\n};\n\n/**\n * Returns the first controller of the given type attached to a widget.\n *\n * @param widget The widget whose controllers are inspected.\n * @param controllerType The controller class to match.\n * @throws When the widget has no controller of that type.\n */\nconst getController = <T extends Gtk.EventController>(\n    widget: Gtk.Accessible,\n    controllerType: ControllerConstructor<T>,\n): T => {\n    const [controller] = getAllControllers(widget, controllerType);\n\n    if (controller === undefined) {\n        throw new Error(`No ${controllerType.name} controller is attached to the widget`);\n    }\n\n    return controller;\n};\n\nconst getOrCreateControllers = <T extends Gtk.EventController>(\n    target: Gtk.Accessible,\n    controllerType: ControllerConstructor<T>,\n): T[] => {\n    const widget = requireWidget(target);\n    const existing = queryAllControllers(widget, controllerType);\n\n    if (existing.length > 0) {\n        return existing;\n    }\n\n    const controller = new controllerType();\n    widget.addController(controller);\n\n    return [controller];\n};\n\nexport {\n    queryAllControllers,\n    queryController,\n    getAllControllers,\n    getController,\n    getOrCreateControllers,\n    type ControllerConstructor,\n};\n"]}

package/dist/user-event/index.d.ts

@@ -16,53 +16,53 @@ type UserEvent = {
     /** Creates an instance with shared keyboard and pointer state. */
     setup: (options?: UserEventOptions) => UserEvent;
     /** Activates or presses and releases a widget. */
-    click: typeof click;
+    click: (widget: Gtk.Accessible, ...args: Parameters<typeof click> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Delivers a double-click gesture. */
-    dblClick: typeof dblClick;
+    dblClick: (widget: Gtk.Accessible, ...args: Parameters<typeof dblClick> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Delivers a triple-click gesture. */
-    tripleClick: typeof tripleClick;
+    tripleClick: (widget: Gtk.Accessible, ...args: Parameters<typeof tripleClick> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Moves focus forward or backward within the root. */
-    tab: typeof tab;
+    tab: (widget: Gtk.Accessible, ...args: Parameters<typeof tab> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Types into an editable widget. */
-    type: typeof type;
+    type: (widget: Gtk.Accessible, ...args: Parameters<typeof type> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Deletes all text from an editable widget. */
-    clear: typeof clear;
+    clear: (widget: Gtk.Accessible, ...args: Parameters<typeof clear> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Copies the current selection. */
-    copy: typeof copy;
+    copy: (widget: Gtk.Accessible, ...args: Parameters<typeof copy> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Cuts the current selection. */
-    cut: typeof cut;
+    cut: (widget: Gtk.Accessible, ...args: Parameters<typeof cut> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Pastes text or clipboard contents. */
-    paste: typeof paste;
+    paste: (widget: Gtk.Accessible, ...args: Parameters<typeof paste> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Selects positions without activating them. */
     selectOptions: typeof selectOptions;
     /** Unselects positions without activating them. */
     deselectOptions: typeof deselectOptions;
     /** Emits a motion `enter` on the widget, adding a motion controller when it has none. */
-    hover: typeof hover;
+    hover: (widget: Gtk.Accessible, ...args: Parameters<typeof hover> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Emits a motion `leave` on the widget, adding a motion controller when it has none. */
-    unhover: typeof unhover;
+    unhover: (widget: Gtk.Accessible, ...args: Parameters<typeof unhover> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Emits `angle-changed` on the widget's rotate gestures. */
-    rotate: typeof rotate;
+    rotate: (widget: Gtk.Accessible, ...args: Parameters<typeof rotate> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Emits `scale-changed` on the widget's zoom gestures. */
-    zoom: typeof zoom;
+    zoom: (widget: Gtk.Accessible, ...args: Parameters<typeof zoom> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Emits `swipe` with the given velocity on the widget's swipe gestures. */
-    swipe: typeof swipe;
+    swipe: (widget: Gtk.Accessible, ...args: Parameters<typeof swipe> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Emits `pressed` at the given point on the widget's long-press gestures. */
-    longPress: typeof longPress;
+    longPress: (widget: Gtk.Accessible, ...args: Parameters<typeof longPress> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Runs a begin, update, and end sequence on the widget's drag gestures, ending at the given offset. */
-    drag: typeof drag;
+    drag: (widget: Gtk.Accessible, ...args: Parameters<typeof drag> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Emits `drop` with the given content on the widget's drop targets. */
-    drop: typeof drop;
+    drop: (widget: Gtk.Accessible, ...args: Parameters<typeof drop> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Requires a drag source on the source widget, then emits `drop` with the content on the target's drop targets. */
-    dragAndDrop: typeof dragAndDrop;
+    dragAndDrop: (source: Gtk.Accessible, target: Gtk.Accessible, ...args: Parameters<typeof dragAndDrop> extends [Gtk.Widget, Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Emits a jump `change-value` on a Gtk.Range so it moves to the given value. */
-    slide: typeof slide;
+    slide: (widget: Gtk.Accessible, ...args: Parameters<typeof slide> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Adds the delta to the adjustments of the widget itself, or of its nearest scrollable ancestor. */
-    scroll: typeof scroll;
+    scroll: (widget: Gtk.Accessible, ...args: Parameters<typeof scroll> extends [Gtk.Widget, ...infer Args] ? Args : never) => Promise<void>;
     /** Sends a key sequence through GTK's propagation chain. */
-    keyboard: (widget: Gtk.Widget, input: string) => Promise<void>;
+    keyboard: (widget: Gtk.Accessible, input: string) => Promise<void>;
     /** Applies a pointer token while preserving held-button state. */
-    pointer: (widget: Gtk.Widget, input: PointerInput) => Promise<void>;
+    pointer: (widget: Gtk.Accessible, input: PointerInput) => Promise<void>;
 };
 /** User interactions that dispatch GTK events and gestures. */
 declare const userEvent: UserEvent;

package/dist/user-event/index.d.ts.map

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

package/dist/user-event/index.js

@@ -1,12 +1,15 @@
 import { delay } from "../timers.js";
+import { requireWidget } from "../widget-target.js";
 import { scroll, slide } from "./adjustment.js";
 import { click, dblClick, tripleClick } from "./click.js";
-import { drag, dragAndDrop, drop, hover, longPress, rotate, swipe, unhover, zoom } from "./gesture.js";
+import { drag, dragAndDrop, drop, hover, longPress, rotate, swipe, unhover, zoom, } from "./gesture.js";
 import { keyboard, tab } from "./keyboard.js";
 import { pointer } from "./pointer.js";
 import { deselectOptions, selectOptions } from "./selection.js";
 import { createInitialState } from "./state.js";
 import { clear, copy, cut, paste, type } from "./text.js";
+const onWidget = (helper) => (target, ...args) => helper(requireWidget(target), ...args);
+const onWidgetPair = (helper) => (source, target, ...args) => helper(requireWidget(source), requireWidget(target), ...args);
 /** User interactions that dispatch GTK events and gestures. */
 const userEvent = {
     ...createInstance(createInitialState(), {}),
@@ -25,30 +28,30 @@ function createInstance(state, options) {
     };
     return {
         setup: (overrides) => createInstance(state, { ...options, ...overrides }),
-        click: after(click),
-        dblClick: after(dblClick),
-        tripleClick: after(tripleClick),
-        tab: after(tab),
-        type: after(type),
-        clear: after(clear),
-        copy: after(copy),
-        cut: after(cut),
-        paste: after(paste),
-        selectOptions: after(selectOptions),
-        deselectOptions: after(deselectOptions),
-        hover: after(hover),
-        unhover: after(unhover),
-        rotate: after(rotate),
-        zoom: after(zoom),
-        swipe: after(swipe),
-        longPress: after(longPress),
-        drag: after(drag),
-        drop: after(drop),
-        dragAndDrop: after(dragAndDrop),
-        slide: after(slide),
-        scroll: after(scroll),
-        keyboard: after((widget, input) => keyboard(state, widget, input)),
-        pointer: after((widget, input) => pointer(state, widget, input)),
+        click: after(onWidget(click)),
+        dblClick: after(onWidget(dblClick)),
+        tripleClick: after(onWidget(tripleClick)),
+        tab: after(onWidget(tab)),
+        type: after(onWidget(type)),
+        clear: after(onWidget(clear)),
+        copy: after(onWidget(copy)),
+        cut: after(onWidget(cut)),
+        paste: after(onWidget(paste)),
+        selectOptions: after(onWidget(selectOptions)),
+        deselectOptions: after(onWidget(deselectOptions)),
+        hover: after(onWidget(hover)),
+        unhover: after(onWidget(unhover)),
+        rotate: after(onWidget(rotate)),
+        zoom: after(onWidget(zoom)),
+        swipe: after(onWidget(swipe)),
+        longPress: after(onWidget(longPress)),
+        drag: after(onWidget(drag)),
+        drop: after(onWidget(drop)),
+        dragAndDrop: after(onWidgetPair(dragAndDrop)),
+        slide: after(onWidget(slide)),
+        scroll: after(onWidget(scroll)),
+        keyboard: after(onWidget((widget, input) => keyboard(state, widget, input))),
+        pointer: after(onWidget((widget, input) => pointer(state, widget, input))),
     };
 }
 export { resetClipboard } from "./text.js";