@gtkx/testing 1.0.0-rc.4 → 1.0.0

package/dist/user-event/list-row-click.js

@@ -0,0 +1,39 @@
+import * as GLib from "@gtkx/gi/glib";
+import { callBooleanGetter, hasWidgetMethod } from "../widget-getters.js";
+const SELECT_ACTION = "listitem.select";
+const SINGLE_CLICK_ACTIVATE_GETTER = "getSingleClickActivate";
+const DOUBLE_CLICK_PRESS = 2;
+const viewFor = (row) => {
+    let current = row.getParent();
+    while (current !== null) {
+        if (hasWidgetMethod(current, SINGLE_CLICK_ACTIVATE_GETTER)) {
+            return current;
+        }
+        current = current.getParent();
+    }
+    return null;
+};
+const isViewSingleClickActivating = (row) => {
+    const view = viewFor(row);
+    return view === null ? false : callBooleanGetter(view, SINGLE_CLICK_ACTIVATE_GETTER) ?? false;
+};
+const selectRow = (row) => {
+    row.activateAction(SELECT_ACTION, GLib.Variant.newTuple([GLib.Variant.newBoolean(false), GLib.Variant.newBoolean(false)]));
+};
+const isRowActivatedByPress = (row, press) => press === DOUBLE_CLICK_PRESS || isViewSingleClickActivating(row);
+const applyRowPress = (row, press) => {
+    if (row.getFocusOnClick()) {
+        row.grabFocus();
+    }
+    selectRow(row);
+    if (isRowActivatedByPress(row, press)) {
+        row.activate();
+    }
+};
+const applyRowClick = (row, nPress) => {
+    for (let press = 1; press <= nPress; press++) {
+        applyRowPress(row, press);
+    }
+};
+export { applyRowClick };
+//# sourceMappingURL=list-row-click.js.map

package/dist/user-event/list-row-click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-row-click.js","sourceRoot":"","sources":["../../src/user-event/list-row-click.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,aAAa,GAAG,iBAAiB,CAAC;AACxC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAC9D,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,OAAO,GAAG,CAAC,GAAe,EAAqB,EAAE;IACnD,IAAI,OAAO,GAAsB,GAAG,CAAC,SAAS,EAAE,CAAC;IAEjD,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,IAAI,eAAe,CAAC,OAAO,EAAE,4BAA4B,CAAC,EAAE,CAAC;YACzD,OAAO,OAAO,CAAC;QACnB,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAAC,GAAe,EAAW,EAAE;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,4BAA4B,CAAC,IAAI,KAAK,CAAC;AAClG,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,GAAe,EAAQ,EAAE;IACxC,GAAG,CAAC,cAAc,CACd,aAAa,EACb,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAC1F,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,GAAe,EAAE,KAAa,EAAW,EAAE,CACtE,KAAK,KAAK,kBAAkB,IAAI,2BAA2B,CAAC,GAAG,CAAC,CAAC;AAErE,MAAM,aAAa,GAAG,CAAC,GAAe,EAAE,KAAa,EAAQ,EAAE;IAC3D,IAAI,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC;QACxB,GAAG,CAAC,SAAS,EAAE,CAAC;IACpB,CAAC;IAED,SAAS,CAAC,GAAG,CAAC,CAAC;IAEf,IAAI,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,EAAE,CAAC;IACnB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,GAAe,EAAE,MAAc,EAAQ,EAAE;IAC5D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport * as GLib from \"@gtkx/gi/glib\";\nimport { callBooleanGetter, hasWidgetMethod } from \"../widget-getters.js\";\n\nconst SELECT_ACTION = \"listitem.select\";\nconst SINGLE_CLICK_ACTIVATE_GETTER = \"getSingleClickActivate\";\nconst DOUBLE_CLICK_PRESS = 2;\n\nconst viewFor = (row: Gtk.Widget): Gtk.Widget | null => {\n    let current: Gtk.Widget | null = row.getParent();\n\n    while (current !== null) {\n        if (hasWidgetMethod(current, SINGLE_CLICK_ACTIVATE_GETTER)) {\n            return current;\n        }\n\n        current = current.getParent();\n    }\n\n    return null;\n};\n\nconst isViewSingleClickActivating = (row: Gtk.Widget): boolean => {\n    const view = viewFor(row);\n\n    return view === null ? false : callBooleanGetter(view, SINGLE_CLICK_ACTIVATE_GETTER) ?? false;\n};\n\nconst selectRow = (row: Gtk.Widget): void => {\n    row.activateAction(\n        SELECT_ACTION,\n        GLib.Variant.newTuple([GLib.Variant.newBoolean(false), GLib.Variant.newBoolean(false)]),\n    );\n};\n\nconst isRowActivatedByPress = (row: Gtk.Widget, press: number): boolean =>\n    press === DOUBLE_CLICK_PRESS || isViewSingleClickActivating(row);\n\nconst applyRowPress = (row: Gtk.Widget, press: number): void => {\n    if (row.getFocusOnClick()) {\n        row.grabFocus();\n    }\n\n    selectRow(row);\n\n    if (isRowActivatedByPress(row, press)) {\n        row.activate();\n    }\n};\n\nconst applyRowClick = (row: Gtk.Widget, nPress: number): void => {\n    for (let press = 1; press <= nPress; press++) {\n        applyRowPress(row, press);\n    }\n};\n\nexport { applyRowClick };\n"]}

package/dist/user-event/native-click.d.ts

@@ -0,0 +1,6 @@
+import * as Gtk from "@gtkx/gi/gtk";
+type NativeClick = (widget: Gtk.Widget, nPress: number) => void;
+declare const isClickTransparent: (widget: Gtk.Widget) => boolean;
+declare const nativeClickFor: (widget: Gtk.Widget, isClicked: boolean) => NativeClick | null;
+export { isClickTransparent, type NativeClick, nativeClickFor };
+//# sourceMappingURL=native-click.d.ts.map

package/dist/user-event/native-click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-click.d.ts","sourceRoot":"","sources":["../../src/user-event/native-click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAKpC,KAAK,WAAW,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAWhE,QAAA,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OACsB,CAAC;AAgBxE,QAAA,MAAM,cAAc,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,WAAW,OAAO,KAAG,WAAW,GAAG,IAU9E,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,cAAc,EAAE,CAAC"}

package/dist/user-event/native-click.js

@@ -0,0 +1,32 @@
+import * as Gtk from "@gtkx/gi/gtk";
+import { getWidgetTypeName } from "../widget-getters.js";
+import { applyHeaderClick } from "./column-header-click.js";
+import { applyRowClick } from "./list-row-click.js";
+const COLUMN_ROW_TYPE_NAME = "GtkColumnViewRowWidget";
+const ROW_TYPE_NAMES = new Set([COLUMN_ROW_TYPE_NAME, "GtkListItemWidget"]);
+const CELL_TYPE_NAME = "GtkColumnViewCellWidget";
+const TITLE_TYPE_NAME = "GtkColumnViewTitle";
+const TOGGLE_EXPAND_ACTION = "listitem.toggle-expand";
+const isHeaderRow = (widget) => getWidgetTypeName(widget) === COLUMN_ROW_TYPE_NAME && widget.getParent() instanceof Gtk.ColumnView;
+const isClickTransparent = (widget) => getWidgetTypeName(widget) === CELL_TYPE_NAME || isHeaderRow(widget);
+const isExpanderToggling = (widget) => widget instanceof Gtk.TreeExpander &&
+    widget.getListRow()?.isExpandable() === true &&
+    !widget.getHideExpander();
+const isColumnHeader = (widget) => getWidgetTypeName(widget) === TITLE_TYPE_NAME;
+const isFactoryRow = (widget) => ROW_TYPE_NAMES.has(getWidgetTypeName(widget) ?? "");
+const toggleExpander = (widget, nPress) => {
+    for (let press = 1; press <= nPress; press++) {
+        widget.activateAction(TOGGLE_EXPAND_ACTION, null);
+    }
+};
+const nativeClickFor = (widget, isClicked) => {
+    if (isClicked && isExpanderToggling(widget)) {
+        return toggleExpander;
+    }
+    if (isColumnHeader(widget)) {
+        return applyHeaderClick;
+    }
+    return isFactoryRow(widget) ? applyRowClick : null;
+};
+export { isClickTransparent, nativeClickFor };
+//# sourceMappingURL=native-click.js.map

package/dist/user-event/native-click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-click.js","sourceRoot":"","sources":["../../src/user-event/native-click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AACtD,MAAM,cAAc,GAAgB,IAAI,GAAG,CAAC,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AACzF,MAAM,cAAc,GAAG,yBAAyB,CAAC;AACjD,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAC7C,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAEtD,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAW,EAAE,CAChD,iBAAiB,CAAC,MAAM,CAAC,KAAK,oBAAoB,IAAI,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,CAAC,UAAU,CAAC;AAEvG,MAAM,kBAAkB,GAAG,CAAC,MAAkB,EAAW,EAAE,CACvD,iBAAiB,CAAC,MAAM,CAAC,KAAK,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,kBAAkB,GAAG,CAAC,MAAkB,EAAW,EAAE,CACvD,MAAM,YAAY,GAAG,CAAC,YAAY;IAClC,MAAM,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,KAAK,IAAI;IAC5C,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;AAE9B,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAW,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,eAAe,CAAC;AACtG,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAW,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAE1G,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,MAAc,EAAQ,EAAE;IAChE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,cAAc,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,SAAkB,EAAsB,EAAE;IAClF,IAAI,SAAS,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,gBAAgB,CAAC;IAC5B,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAoB,cAAc,EAAE,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { getWidgetTypeName } from \"../widget-getters.js\";\nimport { applyHeaderClick } from \"./column-header-click.js\";\nimport { applyRowClick } from \"./list-row-click.js\";\n\ntype NativeClick = (widget: Gtk.Widget, nPress: number) => void;\n\nconst COLUMN_ROW_TYPE_NAME = \"GtkColumnViewRowWidget\";\nconst ROW_TYPE_NAMES: Set<string> = new Set([COLUMN_ROW_TYPE_NAME, \"GtkListItemWidget\"]);\nconst CELL_TYPE_NAME = \"GtkColumnViewCellWidget\";\nconst TITLE_TYPE_NAME = \"GtkColumnViewTitle\";\nconst TOGGLE_EXPAND_ACTION = \"listitem.toggle-expand\";\n\nconst isHeaderRow = (widget: Gtk.Widget): boolean =>\n    getWidgetTypeName(widget) === COLUMN_ROW_TYPE_NAME && widget.getParent() instanceof Gtk.ColumnView;\n\nconst isClickTransparent = (widget: Gtk.Widget): boolean =>\n    getWidgetTypeName(widget) === CELL_TYPE_NAME || isHeaderRow(widget);\n\nconst isExpanderToggling = (widget: Gtk.Widget): boolean =>\n    widget instanceof Gtk.TreeExpander &&\n    widget.getListRow()?.isExpandable() === true &&\n    !widget.getHideExpander();\n\nconst isColumnHeader = (widget: Gtk.Widget): boolean => getWidgetTypeName(widget) === TITLE_TYPE_NAME;\nconst isFactoryRow = (widget: Gtk.Widget): boolean => ROW_TYPE_NAMES.has(getWidgetTypeName(widget) ?? \"\");\n\nconst toggleExpander = (widget: Gtk.Widget, nPress: number): void => {\n    for (let press = 1; press <= nPress; press++) {\n        widget.activateAction(TOGGLE_EXPAND_ACTION, null);\n    }\n};\n\nconst nativeClickFor = (widget: Gtk.Widget, isClicked: boolean): NativeClick | null => {\n    if (isClicked && isExpanderToggling(widget)) {\n        return toggleExpander;\n    }\n\n    if (isColumnHeader(widget)) {\n        return applyHeaderClick;\n    }\n\n    return isFactoryRow(widget) ? applyRowClick : null;\n};\n\nexport { isClickTransparent, type NativeClick, nativeClickFor };\n"]}

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

@@ -1,4 +1,4 @@
-import * as Gtk from "@gtkx/gi/gtk";
+import type * as Gtk from "@gtkx/gi/gtk";
 import type { UserEventState } from "./state.js";
 /**
  * A pointer action token: a full click (`click`, `[MouseLeft]`), a button press (`down`,

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

@@ -1 +1 @@
-{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../src/user-event/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD;;;GAGG;AACH,KAAK,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AA8B9F,QAAA,MAAM,OAAO,GAAI,OAAO,cAAc,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAGxF,CAAC;AAEP,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,CAAC"}
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../src/user-event/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD;;;GAGG;AACH,KAAK,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AAoE9F,QAAA,MAAM,OAAO,GAAI,OAAO,cAAc,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,IAAI,CAGxF,CAAC;AAEP,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/user-event/pointer.js

@@ -1,25 +1,49 @@
-import * as Gtk from "@gtkx/gi/gtk";
-import { emitPress, emitRelease } from "./click.js";
-import { getOrCreateControllers } from "./controller.js";
+import { clickGestures, emitClickPhase, getAuthoredClickGestures } from "./click.js";
 import { wrapEvent } from "./event-wrapper.js";
+import { isClickTransparent, nativeClickFor } from "./native-click.js";
 const PRESS_INPUTS = new Set(["[MouseLeft>]", "down"]);
 const RELEASE_INPUTS = new Set(["[/MouseLeft]", "up"]);
 const CLICK_INPUTS = new Set(["[MouseLeft]", "click"]);
+const pointerWidgetFor = (widget) => {
+    let current = widget;
+    while (isClickTransparent(current)) {
+        const parent = current.getParent();
+        if (parent === null) {
+            return current;
+        }
+        current = parent;
+    }
+    return current;
+};
+const pointerGesturesFor = (widget, native) => native === null ? clickGestures(widget) : getAuthoredClickGestures(widget);
+const pointerTargetFor = (widget) => {
+    const target = pointerWidgetFor(widget);
+    const native = nativeClickFor(target, true);
+    return { widget: target, gestures: pointerGesturesFor(target, native), native };
+};
+const pressPointer = ({ widget, gestures }) => {
+    emitClickPhase(widget, gestures, 1, "pressed");
+};
+const releasePointer = ({ widget, gestures, native }) => {
+    emitClickPhase(widget, gestures, 1, "released");
+    native?.(widget, 1);
+};
+const isPointerPressable = (target) => target.native !== null || target.gestures.length > 0;
 const applyPointerInput = (widget, state, input) => {
-    const controllers = getOrCreateControllers(widget, Gtk.GestureClick);
+    const target = pointerTargetFor(widget);
     if (CLICK_INPUTS.has(input)) {
-        emitPress(widget, controllers, 1);
-        emitRelease(widget, controllers, 1);
+        pressPointer(target);
+        releasePointer(target);
         state.isMouseLeftDown = false;
         return;
     }
-    if (PRESS_INPUTS.has(input) && !state.isMouseLeftDown) {
-        emitPress(widget, controllers, 1);
+    if (PRESS_INPUTS.has(input) && !state.isMouseLeftDown && isPointerPressable(target)) {
+        pressPointer(target);
         state.isMouseLeftDown = true;
         return;
     }
     if (RELEASE_INPUTS.has(input) && state.isMouseLeftDown) {
-        emitRelease(widget, controllers, 1);
+        releasePointer(target);
         state.isMouseLeftDown = false;
     }
 };

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

@@ -1 +1 @@
-{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../../src/user-event/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/C,MAAM,YAAY,GAAsB,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1E,MAAM,cAAc,GAAsB,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC;AAC1E,MAAM,YAAY,GAAsB,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1E,MAAM,iBAAiB,GAAG,CAAC,MAAkB,EAAE,KAAqB,EAAE,KAAmB,EAAQ,EAAE;IAC/F,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IAErE,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAClC,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC;QAE9B,OAAO;IACX,CAAC;IAED,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QACpD,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAClC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;QAE7B,OAAO;IACX,CAAC;IAED,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QACrD,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC;IAClC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,KAAqB,EAAE,MAAkB,EAAE,KAAmB,EAAiB,EAAE,CAC9F,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEP,OAAO,EAAE,OAAO,EAAqB,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport type { UserEventState } from \"./state.js\";\nimport { emitPress, emitRelease } from \"./click.js\";\nimport { getOrCreateControllers } from \"./controller.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/**\n * A pointer action token: a full click (`click`, `[MouseLeft]`), a button press (`down`,\n * `[MouseLeft>]`), or a button release (`up`, `[/MouseLeft]`).\n */\ntype PointerInput = \"click\" | \"down\" | \"up\" | \"[MouseLeft]\" | \"[MouseLeft>]\" | \"[/MouseLeft]\";\n\nconst PRESS_INPUTS: Set<PointerInput> = new Set([\"[MouseLeft>]\", \"down\"]);\nconst RELEASE_INPUTS: Set<PointerInput> = new Set([\"[/MouseLeft]\", \"up\"]);\nconst CLICK_INPUTS: Set<PointerInput> = new Set([\"[MouseLeft]\", \"click\"]);\n\nconst applyPointerInput = (widget: Gtk.Widget, state: UserEventState, input: PointerInput): void => {\n    const controllers = getOrCreateControllers(widget, Gtk.GestureClick);\n\n    if (CLICK_INPUTS.has(input)) {\n        emitPress(widget, controllers, 1);\n        emitRelease(widget, controllers, 1);\n        state.isMouseLeftDown = false;\n\n        return;\n    }\n\n    if (PRESS_INPUTS.has(input) && !state.isMouseLeftDown) {\n        emitPress(widget, controllers, 1);\n        state.isMouseLeftDown = true;\n\n        return;\n    }\n\n    if (RELEASE_INPUTS.has(input) && state.isMouseLeftDown) {\n        emitRelease(widget, controllers, 1);\n        state.isMouseLeftDown = false;\n    }\n};\n\nconst pointer = (state: UserEventState, widget: Gtk.Widget, input: PointerInput): Promise<void> =>\n    wrapEvent(widget, () => {\n        applyPointerInput(widget, state, input);\n    });\n\nexport { pointer, type PointerInput };\n"]}
+{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../../src/user-event/pointer.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { NativeClick } from \"./native-click.js\";\nimport type { UserEventState } from \"./state.js\";\nimport { clickGestures, emitClickPhase, getAuthoredClickGestures } from \"./click.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\nimport { isClickTransparent, nativeClickFor } from \"./native-click.js\";\n\n/**\n * A pointer action token: a full click (`click`, `[MouseLeft]`), a button press (`down`,\n * `[MouseLeft>]`), or a button release (`up`, `[/MouseLeft]`).\n */\ntype PointerInput = \"click\" | \"down\" | \"up\" | \"[MouseLeft]\" | \"[MouseLeft>]\" | \"[/MouseLeft]\";\ntype PointerTarget = { widget: Gtk.Widget; gestures: Gtk.GestureClick[]; native: NativeClick | null };\n\nconst PRESS_INPUTS: Set<PointerInput> = new Set([\"[MouseLeft>]\", \"down\"]);\nconst RELEASE_INPUTS: Set<PointerInput> = new Set([\"[/MouseLeft]\", \"up\"]);\nconst CLICK_INPUTS: Set<PointerInput> = new Set([\"[MouseLeft]\", \"click\"]);\n\nconst pointerWidgetFor = (widget: Gtk.Widget): Gtk.Widget => {\n    let current = widget;\n\n    while (isClickTransparent(current)) {\n        const parent = current.getParent();\n\n        if (parent === null) {\n            return current;\n        }\n\n        current = parent;\n    }\n\n    return current;\n};\n\nconst pointerGesturesFor = (widget: Gtk.Widget, native: NativeClick | null): Gtk.GestureClick[] =>\n    native === null ? clickGestures(widget) : getAuthoredClickGestures(widget);\n\nconst pointerTargetFor = (widget: Gtk.Widget): PointerTarget => {\n    const target = pointerWidgetFor(widget);\n    const native = nativeClickFor(target, true);\n\n    return { widget: target, gestures: pointerGesturesFor(target, native), native };\n};\n\nconst pressPointer = ({ widget, gestures }: PointerTarget): void => {\n    emitClickPhase(widget, gestures, 1, \"pressed\");\n};\n\nconst releasePointer = ({ widget, gestures, native }: PointerTarget): void => {\n    emitClickPhase(widget, gestures, 1, \"released\");\n    native?.(widget, 1);\n};\n\nconst isPointerPressable = (target: PointerTarget): boolean => target.native !== null || target.gestures.length > 0;\n\nconst applyPointerInput = (widget: Gtk.Widget, state: UserEventState, input: PointerInput): void => {\n    const target = pointerTargetFor(widget);\n\n    if (CLICK_INPUTS.has(input)) {\n        pressPointer(target);\n        releasePointer(target);\n        state.isMouseLeftDown = false;\n\n        return;\n    }\n\n    if (PRESS_INPUTS.has(input) && !state.isMouseLeftDown && isPointerPressable(target)) {\n        pressPointer(target);\n        state.isMouseLeftDown = true;\n\n        return;\n    }\n\n    if (RELEASE_INPUTS.has(input) && state.isMouseLeftDown) {\n        releasePointer(target);\n        state.isMouseLeftDown = false;\n    }\n};\n\nconst pointer = (state: UserEventState, widget: Gtk.Widget, input: PointerInput): Promise<void> =>\n    wrapEvent(widget, () => {\n        applyPointerInput(widget, state, input);\n    });\n\nexport { pointer, type PointerInput };\n"]}

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

@@ -1,19 +1,22 @@
 import * as Gtk from "@gtkx/gi/gtk";
 /**
  * Selects the items at the given positions through a list, grid, or column view's selection model,
- * by setting the active item of a drop-down or combo box, or by selecting list box rows. An empty
- * array clears a view's selection.
+ * by setting the selected position of a widget with the COMBO_BOX role, or by selecting the indexed
+ * children of a list box or flow box through their container. An empty array clears a view's
+ * selection. The children are never activated, so no row-activated handler runs.
  *
- * @throws When a view has no selection model, when a combo box is given more than one position, or
- * when the widget is neither a view nor something with the combo box or list role.
+ * @throws When a view has no selection model, when a COMBO_BOX-role widget is given more than one
+ * position or exposes no `setSelected`, or when the widget's role is none of COMBO_BOX, GRID, or
+ * LIST.
  */
 declare const selectOptions: (widget: Gtk.Widget, values: number | number[]) => Promise<void>;
 /**
- * Unselects the items at the given positions in a list, grid, or column view, or the rows at those
- * indices in a Gtk.ListBox.
+ * Unselects the items at the given positions in a list, grid, or column view, or unselects the
+ * indexed children of a list box or flow box through their container. A child that is not selected
+ * is left alone, and no child is activated.
  *
- * @throws When a view has no selection model, or when the widget is neither one of those views nor
- * a Gtk.ListBox.
+ * @throws When a view has no selection model, when the widget's role is none of COMBO_BOX, GRID, or
+ * LIST, or when it exposes no indexed children.
  */
 declare const deselectOptions: (widget: Gtk.Widget, values: number | number[]) => Promise<void>;
 export { selectOptions, deselectOptions };

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

@@ -1 +1 @@
-{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/user-event/selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAwIpC;;;;;;;GAOG;AACH,QAAA,MAAM,aAAa,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,GAAG,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CACd,CAAC;AAkBtE;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,GAAG,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CACZ,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/user-event/selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AA6JpC;;;;;;;;;GASG;AACH,QAAA,MAAM,aAAa,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,GAAG,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CACd,CAAC;AAoBtE;;;;;;;GAOG;AACH,QAAA,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,GAAG,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CACZ,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC"}

package/dist/user-event/selection.js

@@ -1,7 +1,13 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { formatRoleList } from "../role-helpers.js";
+import { getCallableMethod } from "../widget-getters.js";
 import { wrapEvent } from "./event-wrapper.js";
-const SELECTABLE_ROLES = new Set([Gtk.AccessibleRole.COMBO_BOX, Gtk.AccessibleRole.LIST]);
+import { getChildAtIndex, hasIndexedChildren, isChildSelected, selectContainerChild, unselectContainerChild, } from "./indexed-children.js";
+const SELECTABLE_ROLES = new Set([
+    Gtk.AccessibleRole.COMBO_BOX,
+    Gtk.AccessibleRole.GRID,
+    Gtk.AccessibleRole.LIST,
+]);
 const isSelectable = (widget) => {
     return SELECTABLE_ROLES.has(widget.getAccessibleRole());
 };
@@ -24,35 +30,31 @@ const selectListViewItems = (selectionModel, positions, isExclusive) => {
     selectionModel.setSelection(selected, mask);
 };
 const isListView = (widget) => widget instanceof Gtk.ListView || widget instanceof Gtk.GridView || widget instanceof Gtk.ColumnView;
-const selectComboBoxOption = (widget, valueArray) => {
+const getIndexSelector = (widget) => getCallableMethod(widget, "setSelected");
+const selectDropDownOption = (widget, valueArray) => {
+    const setSelected = getIndexSelector(widget);
+    if (!setSelected) {
+        throw new TypeError("Cannot select options: the COMBO_BOX role needs a widget exposing setSelected");
+    }
     if (valueArray.length > 1) {
-        throw new Error("Cannot select multiple options: ComboBox only supports single selection");
+        throw new Error("Cannot select multiple options: a drop-down only supports single selection");
     }
     const [selection] = valueArray;
-    if (selection === undefined) {
-        return;
-    }
-    if (widget instanceof Gtk.DropDown) {
-        widget.setSelected(selection);
+    if (selection !== undefined) {
+        setSelected(selection);
     }
-    else if (widget instanceof Gtk.ComboBox) {
-        widget.setActive(selection);
-    }
-};
-const selectListBoxRow = (listBox, row) => {
-    listBox.selectRow(row);
-    row.activate();
 };
-const unselectListBoxRow = (listBox, row) => {
-    listBox.unselectRow(row);
+const unselectChildRow = (container, child) => {
+    if (isChildSelected(child)) {
+        unselectContainerChild(container, child);
+    }
 };
-const applyListBoxRows = (listBox, valueArray, apply) => {
+const applyIndexedChildren = (widget, valueArray, apply) => {
     for (const value of valueArray) {
-        const row = listBox.getRowAtIndex(value);
-        if (!row) {
-            continue;
+        const child = getChildAtIndex(widget, value);
+        if (child) {
+            apply(widget, child);
         }
-        apply(listBox, row);
     }
 };
 const requireSelectionModel = (widget, verb) => {
@@ -67,17 +69,22 @@ const selectInListView = (widget, valueArray) => {
     const isMultiSelection = selectionModel instanceof Gtk.MultiSelection;
     selectListViewItems(selectionModel, valueArray, !isMultiSelection);
 };
-const selectByRole = (widget, valueArray) => {
+const requireSelectableRole = (widget, verb) => {
     if (!isSelectable(widget)) {
-        throw new Error(`Cannot select options: expected selectable widget (${formatRoleList(SELECTABLE_ROLES)})`);
+        throw new Error(`Cannot ${verb} options: expected selectable widget (${formatRoleList(SELECTABLE_ROLES)})`);
     }
+};
+const selectByRole = (widget, valueArray) => {
+    requireSelectableRole(widget, "select");
     const role = widget.getAccessibleRole();
     if (role === Gtk.AccessibleRole.COMBO_BOX) {
-        selectComboBoxOption(widget, valueArray);
+        selectDropDownOption(widget, valueArray);
+        return;
     }
-    else if (widget instanceof Gtk.ListBox) {
-        applyListBoxRows(widget, valueArray, selectListBoxRow);
+    if (!hasIndexedChildren(widget)) {
+        throw new TypeError("Cannot select options: the widget exposes no children to select by index");
     }
+    applyIndexedChildren(widget, valueArray, selectContainerChild);
 };
 const runSelectionEvent = (widget, values, inListView, byRole) => wrapEvent(widget, () => {
     const valueArray = Array.isArray(values) ? values : [values];
@@ -89,11 +96,13 @@ const runSelectionEvent = (widget, values, inListView, byRole) => wrapEvent(widg
 });
 /**
  * Selects the items at the given positions through a list, grid, or column view's selection model,
- * by setting the active item of a drop-down or combo box, or by selecting list box rows. An empty
- * array clears a view's selection.
+ * by setting the selected position of a widget with the COMBO_BOX role, or by selecting the indexed
+ * children of a list box or flow box through their container. An empty array clears a view's
+ * selection. The children are never activated, so no row-activated handler runs.
  *
- * @throws When a view has no selection model, when a combo box is given more than one position, or
- * when the widget is neither a view nor something with the combo box or list role.
+ * @throws When a view has no selection model, when a COMBO_BOX-role widget is given more than one
+ * position or exposes no `setSelected`, or when the widget's role is none of COMBO_BOX, GRID, or
+ * LIST.
  */
 const selectOptions = (widget, values) => runSelectionEvent(widget, values, selectInListView, selectByRole);
 const deselectInListView = (widget, valueArray) => {
@@ -103,17 +112,19 @@ const deselectInListView = (widget, valueArray) => {
     }
 };
 const deselectByRole = (widget, valueArray) => {
-    if (!(widget instanceof Gtk.ListBox)) {
-        throw new TypeError("Cannot deselect options: only ListBox supports deselection");
+    requireSelectableRole(widget, "deselect");
+    if (!hasIndexedChildren(widget)) {
+        throw new TypeError("Cannot deselect options: the widget exposes no children to deselect by index");
     }
-    applyListBoxRows(widget, valueArray, unselectListBoxRow);
+    applyIndexedChildren(widget, valueArray, unselectChildRow);
 };
 /**
- * Unselects the items at the given positions in a list, grid, or column view, or the rows at those
- * indices in a Gtk.ListBox.
+ * Unselects the items at the given positions in a list, grid, or column view, or unselects the
+ * indexed children of a list box or flow box through their container. A child that is not selected
+ * is left alone, and no child is activated.
  *
- * @throws When a view has no selection model, or when the widget is neither one of those views nor
- * a Gtk.ListBox.
+ * @throws When a view has no selection model, when the widget's role is none of COMBO_BOX, GRID, or
+ * LIST, or when it exposes no indexed children.
  */
 const deselectOptions = (widget, values) => runSelectionEvent(widget, values, deselectInListView, deselectByRole);
 export { selectOptions, deselectOptions };

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

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/user-event/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { formatRoleList } from \"../role-helpers.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\ntype CollectionWidget = Gtk.ListView | Gtk.GridView | Gtk.ColumnView;\ntype ListBoxRowAction = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow) => void;\n\nconst SELECTABLE_ROLES: Set<Gtk.AccessibleRole> = new Set([Gtk.AccessibleRole.COMBO_BOX, Gtk.AccessibleRole.LIST]);\n\nconst isSelectable = (widget: Gtk.Widget): boolean => {\n    return SELECTABLE_ROLES.has(widget.getAccessibleRole());\n};\n\nconst selectListViewItems = (\n    selectionModel: Gtk.SelectionModel,\n    positions: number[],\n    isExclusive: boolean,\n): void => {\n    if (positions.length === 0) {\n        selectionModel.unselectRange(0, selectionModel.getNItems());\n\n        return;\n    }\n\n    const [first] = positions;\n\n    if (isExclusive && first !== undefined && positions.length === 1) {\n        selectionModel.selectItem(first, true);\n\n        return;\n    }\n\n    const nItems = selectionModel.getNItems();\n    const selected = Gtk.Bitset.newEmpty();\n    const mask = Gtk.Bitset.newRange(0, nItems);\n\n    for (const pos of positions) {\n        selected.add(pos);\n    }\n\n    selectionModel.setSelection(selected, mask);\n};\n\nconst isListView = (widget: Gtk.Widget): widget is CollectionWidget =>\n    widget instanceof Gtk.ListView || widget instanceof Gtk.GridView || widget instanceof Gtk.ColumnView;\n\nconst selectComboBoxOption = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (valueArray.length > 1) {\n        throw new Error(\"Cannot select multiple options: ComboBox only supports single selection\");\n    }\n\n    const [selection] = valueArray;\n\n    if (selection === undefined) {\n        return;\n    }\n\n    if (widget instanceof Gtk.DropDown) {\n        widget.setSelected(selection);\n    } else if (widget instanceof Gtk.ComboBox) {\n        widget.setActive(selection);\n    }\n};\n\nconst selectListBoxRow = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow): void => {\n    listBox.selectRow(row);\n    row.activate();\n};\n\nconst unselectListBoxRow = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow): void => {\n    listBox.unselectRow(row);\n};\n\nconst applyListBoxRows = (listBox: Gtk.ListBox, valueArray: number[], apply: ListBoxRowAction): void => {\n    for (const value of valueArray) {\n        const row = listBox.getRowAtIndex(value);\n\n        if (!row) {\n            continue;\n        }\n\n        apply(listBox, row);\n    }\n};\n\nconst requireSelectionModel = (\n    widget: CollectionWidget,\n    verb: string,\n): Gtk.SelectionModel => {\n    const selectionModel = widget.getModel();\n\n    if (selectionModel === null) {\n        throw new Error(`Cannot ${verb} options: list view has no selection model`);\n    }\n\n    return selectionModel;\n};\n\nconst selectInListView = (widget: CollectionWidget, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"select\");\n    const isMultiSelection = selectionModel instanceof Gtk.MultiSelection;\n    selectListViewItems(selectionModel, valueArray, !isMultiSelection);\n};\n\nconst selectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (!isSelectable(widget)) {\n        throw new Error(`Cannot select options: expected selectable widget (${formatRoleList(SELECTABLE_ROLES)})`);\n    }\n\n    const role = widget.getAccessibleRole();\n\n    if (role === Gtk.AccessibleRole.COMBO_BOX) {\n        selectComboBoxOption(widget, valueArray);\n    } else if (widget instanceof Gtk.ListBox) {\n        applyListBoxRows(widget, valueArray, selectListBoxRow);\n    }\n};\n\nconst runSelectionEvent = (\n    widget: Gtk.Widget,\n    values: number | number[],\n    inListView: (view: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]) => void,\n    byRole: (widget: Gtk.Widget, valueArray: number[]) => void,\n): Promise<void> =>\n    wrapEvent(widget, () => {\n        const valueArray = Array.isArray(values) ? values : [values];\n\n        if (isListView(widget)) {\n            inListView(widget, valueArray);\n\n            return;\n        }\n\n        byRole(widget, valueArray);\n    });\n\n/**\n * Selects the items at the given positions through a list, grid, or column view's selection model,\n * by setting the active item of a drop-down or combo box, or by selecting list box rows. An empty\n * array clears a view's selection.\n *\n * @throws When a view has no selection model, when a combo box is given more than one position, or\n * when the widget is neither a view nor something with the combo box or list role.\n */\nconst selectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, selectInListView, selectByRole);\n\nconst deselectInListView = (widget: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"deselect\");\n\n    for (const pos of valueArray) {\n        selectionModel.unselectItem(pos);\n    }\n};\n\nconst deselectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (!(widget instanceof Gtk.ListBox)) {\n        throw new TypeError(\"Cannot deselect options: only ListBox supports deselection\");\n    }\n\n    applyListBoxRows(widget, valueArray, unselectListBoxRow);\n};\n\n/**\n * Unselects the items at the given positions in a list, grid, or column view, or the rows at those\n * indices in a Gtk.ListBox.\n *\n * @throws When a view has no selection model, or when the widget is neither one of those views nor\n * a Gtk.ListBox.\n */\nconst deselectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, deselectInListView, deselectByRole);\n\nexport { selectOptions, deselectOptions };\n"]}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/user-event/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { formatRoleList } from \"../role-helpers.js\";\nimport { getCallableMethod } from \"../widget-getters.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\nimport {\n    getChildAtIndex,\n    hasIndexedChildren,\n    isChildSelected,\n    selectContainerChild,\n    unselectContainerChild,\n} from \"./indexed-children.js\";\n\ntype CollectionWidget = Gtk.ListView | Gtk.GridView | Gtk.ColumnView;\ntype IndexedChildAction = (container: Gtk.Widget, child: Gtk.Widget) => void;\n\nconst SELECTABLE_ROLES: Set<Gtk.AccessibleRole> = new Set([\n    Gtk.AccessibleRole.COMBO_BOX,\n    Gtk.AccessibleRole.GRID,\n    Gtk.AccessibleRole.LIST,\n]);\n\nconst isSelectable = (widget: Gtk.Widget): boolean => {\n    return SELECTABLE_ROLES.has(widget.getAccessibleRole());\n};\n\nconst selectListViewItems = (\n    selectionModel: Gtk.SelectionModel,\n    positions: number[],\n    isExclusive: boolean,\n): void => {\n    if (positions.length === 0) {\n        selectionModel.unselectRange(0, selectionModel.getNItems());\n\n        return;\n    }\n\n    const [first] = positions;\n\n    if (isExclusive && first !== undefined && positions.length === 1) {\n        selectionModel.selectItem(first, true);\n\n        return;\n    }\n\n    const nItems = selectionModel.getNItems();\n    const selected = Gtk.Bitset.newEmpty();\n    const mask = Gtk.Bitset.newRange(0, nItems);\n\n    for (const pos of positions) {\n        selected.add(pos);\n    }\n\n    selectionModel.setSelection(selected, mask);\n};\n\nconst isListView = (widget: Gtk.Widget): widget is CollectionWidget =>\n    widget instanceof Gtk.ListView || widget instanceof Gtk.GridView || widget instanceof Gtk.ColumnView;\n\nconst getIndexSelector = (widget: Gtk.Widget): ((position: number) => void) | null =>\n    getCallableMethod<[number], unknown>(widget, \"setSelected\");\n\nconst selectDropDownOption = (widget: Gtk.Widget, valueArray: number[]): void => {\n    const setSelected = getIndexSelector(widget);\n\n    if (!setSelected) {\n        throw new TypeError(\"Cannot select options: the COMBO_BOX role needs a widget exposing setSelected\");\n    }\n\n    if (valueArray.length > 1) {\n        throw new Error(\"Cannot select multiple options: a drop-down only supports single selection\");\n    }\n\n    const [selection] = valueArray;\n\n    if (selection !== undefined) {\n        setSelected(selection);\n    }\n};\n\nconst unselectChildRow = (container: Gtk.Widget, child: Gtk.Widget): void => {\n    if (isChildSelected(child)) {\n        unselectContainerChild(container, child);\n    }\n};\n\nconst applyIndexedChildren = (widget: Gtk.Widget, valueArray: number[], apply: IndexedChildAction): void => {\n    for (const value of valueArray) {\n        const child = getChildAtIndex(widget, value);\n\n        if (child) {\n            apply(widget, child);\n        }\n    }\n};\n\nconst requireSelectionModel = (\n    widget: CollectionWidget,\n    verb: string,\n): Gtk.SelectionModel => {\n    const selectionModel = widget.getModel();\n\n    if (selectionModel === null) {\n        throw new Error(`Cannot ${verb} options: list view has no selection model`);\n    }\n\n    return selectionModel;\n};\n\nconst selectInListView = (widget: CollectionWidget, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"select\");\n    const isMultiSelection = selectionModel instanceof Gtk.MultiSelection;\n    selectListViewItems(selectionModel, valueArray, !isMultiSelection);\n};\n\nconst requireSelectableRole = (widget: Gtk.Widget, verb: string): void => {\n    if (!isSelectable(widget)) {\n        throw new Error(\n            `Cannot ${verb} options: expected selectable widget (${formatRoleList(SELECTABLE_ROLES)})`,\n        );\n    }\n};\n\nconst selectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    requireSelectableRole(widget, \"select\");\n    const role = widget.getAccessibleRole();\n\n    if (role === Gtk.AccessibleRole.COMBO_BOX) {\n        selectDropDownOption(widget, valueArray);\n\n        return;\n    }\n\n    if (!hasIndexedChildren(widget)) {\n        throw new TypeError(\"Cannot select options: the widget exposes no children to select by index\");\n    }\n\n    applyIndexedChildren(widget, valueArray, selectContainerChild);\n};\n\nconst runSelectionEvent = (\n    widget: Gtk.Widget,\n    values: number | number[],\n    inListView: (view: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]) => void,\n    byRole: (widget: Gtk.Widget, valueArray: number[]) => void,\n): Promise<void> =>\n    wrapEvent(widget, () => {\n        const valueArray = Array.isArray(values) ? values : [values];\n\n        if (isListView(widget)) {\n            inListView(widget, valueArray);\n\n            return;\n        }\n\n        byRole(widget, valueArray);\n    });\n\n/**\n * Selects the items at the given positions through a list, grid, or column view's selection model,\n * by setting the selected position of a widget with the COMBO_BOX role, or by selecting the indexed\n * children of a list box or flow box through their container. An empty array clears a view's\n * selection. The children are never activated, so no row-activated handler runs.\n *\n * @throws When a view has no selection model, when a COMBO_BOX-role widget is given more than one\n * position or exposes no `setSelected`, or when the widget's role is none of COMBO_BOX, GRID, or\n * LIST.\n */\nconst selectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, selectInListView, selectByRole);\n\nconst deselectInListView = (widget: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"deselect\");\n\n    for (const pos of valueArray) {\n        selectionModel.unselectItem(pos);\n    }\n};\n\nconst deselectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    requireSelectableRole(widget, \"deselect\");\n\n    if (!hasIndexedChildren(widget)) {\n        throw new TypeError(\"Cannot deselect options: the widget exposes no children to deselect by index\");\n    }\n\n    applyIndexedChildren(widget, valueArray, unselectChildRow);\n};\n\n/**\n * Unselects the items at the given positions in a list, grid, or column view, or unselects the\n * indexed children of a list box or flow box through their container. A child that is not selected\n * is left alone, and no child is activated.\n *\n * @throws When a view has no selection model, when the widget's role is none of COMBO_BOX, GRID, or\n * LIST, or when it exposes no indexed children.\n */\nconst deselectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, deselectInListView, deselectByRole);\n\nexport { selectOptions, deselectOptions };\n"]}

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

@@ -17,9 +17,13 @@ declare const resetClipboard: () => void;
  */
 declare const type: (widget: Gtk.Widget, text: string, options?: TypeOptions) => Promise<void>;
 /**
- * Replaces an editable widget's text with the empty string.
+ * Focuses an editable widget and deletes its whole text through the widget's own editing API, so the
+ * deletion emits the signals an edit made by hand emits. Text a tag protects is detected before the
+ * deletion runs, leaving such a widget untouched. A widget that writes a new value back in response
+ * to the deletion, as an input mask does, is cleared successfully and keeps whatever it wrote.
  *
- * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView, when it refuses edits, when
+ * a tag protects part of its text, or when a handler blocks the deletion.
  */
 declare const clear: (widget: Gtk.Widget) => Promise<void>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/user-event/text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAKpC,oCAAoC;AACpC,KAAK,WAAW,GAAG;IACf,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,CAAC;AAqGF,QAAA,MAAM,cAAc,QAAO,IAE1B,CAAC;AAeF;;;;;GAKG;AACH,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,UAAU,WAAW,KAAG,OAAO,CAAC,IAAI,CAQ9E,CAAC;AAEP;;;;GAIG;AACH,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAG1C,CAAC;AAEP;;;;GAIG;AACH,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAGzC,CAAC;AAEP;;;;GAIG;AACH,QAAA,MAAM,GAAG,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAIxC,CAAC;AAEP;;;;;GAKG;AACH,QAAA,MAAM,KAAK,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAUpE,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/user-event/text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAYpC,oCAAoC;AACpC,KAAK,WAAW,GAAG;IACf,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,CAAC;AA4FF,QAAA,MAAM,cAAc,QAAO,IAE1B,CAAC;AAeF;;;;;GAKG;AACH,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,UAAU,WAAW,KAAG,OAAO,CAAC,IAAI,CAQ9E,CAAC;AAyEP;;;;;;;;GAQG;AACH,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CACmB,CAAC;AAEpE;;;;GAIG;AACH,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAGzC,CAAC;AAEP;;;;GAIG;AACH,QAAA,MAAM,GAAG,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAIxC,CAAC;AAEP;;;;;GAKG;AACH,QAAA,MAAM,KAAK,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAUpE,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,CAAC"}

package/dist/user-event/text.js

@@ -1,10 +1,13 @@
 import * as Gdk from "@gtkx/gi/gdk";
 import * as GObject from "@gtkx/gi/gobject";
 import * as Gtk from "@gtkx/gi/gtk";
-import { EDITABLE_ROLES, getEditableDelegate, isEditable } from "../editable.js";
+import { EDITABLE_ROLES, getEditableDelegate, isEditable, readEditableText } from "../editable.js";
 import { formatRoleList } from "../role-helpers.js";
+import { getWidgetSelection } from "../widget-accessible-properties.js";
+import { callBooleanGetter } from "../widget-getters.js";
 import { wrapEvent } from "./event-wrapper.js";
 const EDITABLE_REQUIRED = `expected editable widget (${formatRoleList(EDITABLE_ROLES)})`;
+const CLEAR_REFUSED = "Cannot clear element: the widget refuses to delete part of its text";
 const insertEditableText = (widget, text) => {
     if (widget instanceof Gtk.TextView) {
         widget.emit("insert-at-cursor", text);
@@ -19,15 +22,7 @@ const insertEditableText = (widget, text) => {
     const newPosition = widget.insertText(text, text.length, position);
     widget.setPosition(newPosition);
 };
-const readSelection = (widget) => {
-    if (widget instanceof Gtk.TextView) {
-        const buffer = widget.getBuffer();
-        const [hasSelection, start, end] = buffer.getSelectionBounds();
-        return hasSelection ? buffer.getText(start, end, true) : "";
-    }
-    const [hasSelection, start, end] = widget.getSelectionBounds();
-    return hasSelection ? widget.getChars(start, end) : "";
-};
+const readSelection = (widget) => getWidgetSelection(widget) ?? "";
 const deleteSelection = (widget) => {
     if (widget instanceof Gtk.TextView) {
         widget.getBuffer().deleteSelection(false, true);
@@ -35,12 +30,13 @@ const deleteSelection = (widget) => {
     }
     widget.deleteSelection();
 };
-const setEditableText = (widget, text) => {
+const deleteAllText = (widget) => {
     if (widget instanceof Gtk.TextView) {
-        widget.getBuffer().setText(text, text.length);
+        const buffer = widget.getBuffer();
+        buffer.deleteInteractive(buffer.getStartIter(), buffer.getEndIter(), widget.getEditable());
         return;
     }
-    widget.setText(text);
+    widget.deleteText(0, -1);
 };
 const applyTextViewSelection = (widget, start, end) => {
     const buffer = widget.getBuffer();
@@ -96,14 +92,68 @@ const type = (widget, text, options) => runEditableEvent(widget, "Cannot type in
     applyInitialSelection(editable, options ?? {});
     insertEditableText(editable, text);
 });
+const isWidgetEditable = (widget) => callBooleanGetter(widget, "getEditable") ?? true;
+const hasNonEditableChar = (iter, isDefaultEditable) => {
+    while (!iter.isEnd()) {
+        if (!iter.editable(isDefaultEditable)) {
+            return true;
+        }
+        if (!iter.forwardChar()) {
+            return false;
+        }
+    }
+    return false;
+};
+const hasProtectedText = (widget) => widget instanceof Gtk.TextView && hasNonEditableChar(widget.getBuffer().getStartIter(), widget.getEditable());
+const requireClearableText = (editable) => {
+    if (!isWidgetEditable(editable)) {
+        throw new Error("Cannot clear element: the widget is not editable");
+    }
+    if (hasProtectedText(editable)) {
+        throw new Error(CLEAR_REFUSED);
+    }
+};
+const deletionSignalFor = (widget) => widget instanceof Gtk.TextView ? [widget.getBuffer(), "delete-range"] : [widget, "delete-text"];
+const isDeletionApplied = (emitter, signal, apply) => {
+    let isApplied = false;
+    const watch = () => {
+        isApplied = true;
+    };
+    emitter.on(signal, watch, true);
+    try {
+        apply();
+    }
+    finally {
+        emitter.off(signal, watch);
+    }
+    return isApplied;
+};
+const didDeleteAllText = (widget) => {
+    const [emitter, signal] = deletionSignalFor(widget);
+    return isDeletionApplied(emitter, signal, () => {
+        deleteAllText(widget);
+    });
+};
+const clearEditable = (editable) => {
+    requireClearableText(editable);
+    editable.grabFocus();
+    if (readEditableText(editable) === "") {
+        return;
+    }
+    if (!didDeleteAllText(editable)) {
+        throw new Error(CLEAR_REFUSED);
+    }
+};
 /**
- * Replaces an editable widget's text with the empty string.
+ * Focuses an editable widget and deletes its whole text through the widget's own editing API, so the
+ * deletion emits the signals an edit made by hand emits. Text a tag protects is detected before the
+ * deletion runs, leaving such a widget untouched. A widget that writes a new value back in response
+ * to the deletion, as an input mask does, is cleared successfully and keeps whatever it wrote.
  *
- * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView, when it refuses edits, when
+ * a tag protects part of its text, or when a handler blocks the deletion.
  */
-const clear = (widget) => runEditableEvent(widget, "Cannot clear element", (editable) => {
-    setEditableText(editable, "");
-});
+const clear = (widget) => runEditableEvent(widget, "Cannot clear element", clearEditable);
 /**
  * Writes an editable widget's selected text to its clipboard, or the empty string when nothing is selected.
  *