@gtkx/testing 1.0.0-rc.3 → 1.0.0

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

@@ -4,12 +4,16 @@ import * as Gtk from "@gtkx/gi/gtk";
 type DropContent = string | number | boolean | GObject.Value;
 /** Options for a drop: the drop coordinates within the target. */
 type DropOptions = {
+    /** Horizontal drop coordinate within the target, in pixels. */
     x?: number;
+    /** Vertical drop coordinate within the target, in pixels. */
     y?: number;
 };
 /** A drag offset relative to the drag start point. */
 type DragOffset = {
+    /** Horizontal distance from the drag start point, in pixels. */
     x: number;
+    /** Vertical distance from the drag start point, in pixels. */
     y: number;
 };
 /**
@@ -17,19 +21,66 @@ type DragOffset = {
  * explicit intermediate offsets emitted before the final one.
  */
 type DragOptions = {
+    /** Horizontal coordinate the drag begins at; defaults to 0. */
     startX?: number;
+    /** Vertical coordinate the drag begins at; defaults to 0. */
     startY?: number;
+    /** Number of evenly interpolated drag updates, the last of which is the requested offset; defaults to 2. */
     steps?: number;
+    /** Explicit intermediate offsets emitted before the requested one, used instead of `steps`. */
     offsets?: DragOffset[];
 };
+/** Emits `enter` at the widget's origin on its motion controllers, adding one when it has none. */
 declare const hover: (widget: Gtk.Widget) => Promise<void>;
+/** Emits `leave` on the widget's motion controllers, adding one when it has none. */
 declare const unhover: (widget: Gtk.Widget) => Promise<void>;
+/**
+ * Emits `angle-changed` on the widget's rotate gestures.
+ *
+ * @param angle Current angle, in radians.
+ * @param deltaAngle Difference from the angle the gesture started at; defaults to `angle`.
+ * @throws When the widget has no Gtk.GestureRotate.
+ */
 declare const rotate: (widget: Gtk.Widget, angle: number, deltaAngle?: number) => Promise<void>;
+/**
+ * Emits `scale-changed` with the given scale delta on the widget's zoom gestures.
+ *
+ * @throws When the widget has no Gtk.GestureZoom.
+ */
 declare const zoom: (widget: Gtk.Widget, scale: number) => Promise<void>;
+/**
+ * Emits `swipe` with the given per-axis velocity, in pixels per second, on the widget's swipe gestures.
+ *
+ * @throws When the widget has no Gtk.GestureSwipe.
+ */
 declare const swipe: (widget: Gtk.Widget, velocityX: number, velocityY: number) => Promise<void>;
+/**
+ * Emits `pressed` at the given point in widget coordinates on the widget's long-press gestures.
+ *
+ * @throws When the widget has no Gtk.GestureLongPress.
+ */
 declare const longPress: (widget: Gtk.Widget, x?: number, y?: number) => Promise<void>;
+/**
+ * Runs a `drag-begin`, `drag-update`, `drag-end` sequence ending at the offset `dx`, `dy` on the
+ * widget's drag gestures, overriding each gesture's start point and offset for the duration so
+ * handlers read the simulated values back.
+ *
+ * @throws When the widget is a Gtk.Range, whose slider reads pointer coordinates from the display,
+ * or when it has no Gtk.GestureDrag.
+ */
 declare const drag: (widget: Gtk.Widget, dx: number, dy: number, options?: DragOptions) => Promise<void>;
+/**
+ * Emits `drop` with the given content on every drop target attached to the widget.
+ *
+ * @throws When the widget has no Gtk.DropTarget.
+ */
 declare const drop: (widget: Gtk.Widget, content: DropContent, options?: DropOptions) => Promise<void>;
+/**
+ * Emits `drop` with the given content on the target's drop targets, after checking that the source
+ * carries a drag source.
+ *
+ * @throws When the source has no Gtk.DragSource, or the target no Gtk.DropTarget.
+ */
 declare const dragAndDrop: (source: Gtk.Widget, target: Gtk.Widget, content: DropContent, options?: DropOptions) => Promise<void>;
 export { hover, unhover, rotate, zoom, swipe, longPress, drag, drop, dragAndDrop, type DropContent, type DropOptions, type DragOffset, type DragOptions, };
 //# sourceMappingURL=gesture.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gesture.d.ts","sourceRoot":"","sources":["../../src/user-event/gesture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAKpC,qHAAqH;AACrH,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;AAE7D,kEAAkE;AAClE,KAAK,WAAW,GAAG;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,sDAAsD;AACtD,KAAK,UAAU,GAAG;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;GAGG;AACH,KAAK,WAAW,GAAG;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CAC1B,CAAC;AAqCF,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAG1C,CAAC;AAEP,QAAA,MAAM,OAAO,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAG5C,CAAC;AAEP,QAAA,MAAM,MAAM,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,EAAE,aAAY,MAAc,KAAG,OAAO,CAAC,IAAI,CAIvF,CAAC;AAEN,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAGxD,CAAC;AAEP,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,WAAW,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAAC,IAAI,CAGhF,CAAC;AAEP,QAAA,MAAM,SAAS,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAK,EAAE,UAAK,KAAG,OAAO,CAAC,IAAI,CAG5D,CAAC;AAmFP,QAAA,MAAM,IAAI,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,IAAI,CAevG,CAAC;AAUF,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,IAAI,CAG1F,CAAC;AAEP,QAAA,MAAM,WAAW,GACb,QAAQ,GAAG,CAAC,MAAM,EAClB,QAAQ,GAAG,CAAC,MAAM,EAClB,SAAS,WAAW,EACpB,UAAS,WAAgB,KAC1B,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF,OAAO,EACH,KAAK,EACL,OAAO,EACP,MAAM,EACN,IAAI,EACJ,KAAK,EACL,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,GACnB,CAAC"}
+{"version":3,"file":"gesture.d.ts","sourceRoot":"","sources":["../../src/user-event/gesture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAKpC,qHAAqH;AACrH,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;AAE7D,kEAAkE;AAClE,KAAK,WAAW,GAAG;IACf,+DAA+D;IAC/D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,sDAAsD;AACtD,KAAK,UAAU,GAAG;IACd,gEAAgE;IAChE,CAAC,EAAE,MAAM,CAAC;IACV,8DAA8D;IAC9D,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;GAGG;AACH,KAAK,WAAW,GAAG;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CAC1B,CAAC;AAqCF,mGAAmG;AACnG,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAG1C,CAAC;AAEP,qFAAqF;AACrF,QAAA,MAAM,OAAO,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAG5C,CAAC;AAEP;;;;;;GAMG;AACH,QAAA,MAAM,MAAM,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,EAAE,aAAY,MAAc,KAAG,OAAO,CAAC,IAAI,CAIvF,CAAC;AAEN;;;;GAIG;AACH,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAGxD,CAAC;AAEP;;;;GAIG;AACH,QAAA,MAAM,KAAK,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,WAAW,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAAC,IAAI,CAGhF,CAAC;AAEP;;;;GAIG;AACH,QAAA,MAAM,SAAS,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAK,EAAE,UAAK,KAAG,OAAO,CAAC,IAAI,CAG5D,CAAC;AAmFP;;;;;;;GAOG;AACH,QAAA,MAAM,IAAI,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,IAAI,CAevG,CAAC;AAUF;;;;GAIG;AACH,QAAA,MAAM,IAAI,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,IAAI,CAG1F,CAAC;AAEP;;;;;GAKG;AACH,QAAA,MAAM,WAAW,GACb,QAAQ,GAAG,CAAC,MAAM,EAClB,QAAQ,GAAG,CAAC,MAAM,EAClB,SAAS,WAAW,EACpB,UAAS,WAAgB,KAC1B,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF,OAAO,EACH,KAAK,EACL,OAAO,EACP,MAAM,EACN,IAAI,EACJ,KAAK,EACL,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,GACnB,CAAC"}

package/dist/user-event/gesture.js

@@ -21,33 +21,57 @@ const buildDropValue = (content) => {
         v.setDouble(content);
     });
 };
+/** Emits `enter` at the widget's origin on its motion controllers, adding one when it has none. */
 const hover = (widget) => dispatchOnOrCreateControllers(widget, Gtk.EventControllerMotion, (controller) => {
     controller.emit("enter", 0, 0);
 });
+/** Emits `leave` on the widget's motion controllers, adding one when it has none. */
 const unhover = (widget) => dispatchOnOrCreateControllers(widget, Gtk.EventControllerMotion, (controller) => {
     controller.emit("leave");
 });
+/**
+ * Emits `angle-changed` on the widget's rotate gestures.
+ *
+ * @param angle Current angle, in radians.
+ * @param deltaAngle Difference from the angle the gesture started at; defaults to `angle`.
+ * @throws When the widget has no Gtk.GestureRotate.
+ */
 const rotate = (widget, angle, deltaAngle = angle) => dispatchOnControllers(widget, Gtk.GestureRotate, (controller) => {
     controller.emit("angle-changed", angle, deltaAngle);
 });
+/**
+ * Emits `scale-changed` with the given scale delta on the widget's zoom gestures.
+ *
+ * @throws When the widget has no Gtk.GestureZoom.
+ */
 const zoom = (widget, scale) => dispatchOnControllers(widget, Gtk.GestureZoom, (controller) => {
     controller.emit("scale-changed", scale);
 });
+/**
+ * Emits `swipe` with the given per-axis velocity, in pixels per second, on the widget's swipe gestures.
+ *
+ * @throws When the widget has no Gtk.GestureSwipe.
+ */
 const swipe = (widget, velocityX, velocityY) => dispatchOnControllers(widget, Gtk.GestureSwipe, (controller) => {
     controller.emit("swipe", velocityX, velocityY);
 });
+/**
+ * Emits `pressed` at the given point in widget coordinates on the widget's long-press gestures.
+ *
+ * @throws When the widget has no Gtk.GestureLongPress.
+ */
 const longPress = (widget, x = 0, y = 0) => dispatchOnControllers(widget, Gtk.GestureLongPress, (controller) => {
     controller.emit("pressed", x, y);
 });
 const restoreDragState = (saved) => {
     const { instance } = saved;
-    if (saved.ownsStartPoint) {
+    if (saved.hasOwnStartPoint) {
         instance.getStartPoint = saved.previousStartPoint;
     }
     else {
         delete instance.getStartPoint;
     }
-    if (saved.ownsOffset) {
+    if (saved.hasOwnOffset) {
         instance.getOffset = saved.previousOffset;
     }
     else {
@@ -58,8 +82,8 @@ const patchDragState = (controller, start, offset) => {
     const instance = controller;
     const saved = {
         instance,
-        ownsStartPoint: Object.hasOwn(instance, "getStartPoint"),
-        ownsOffset: Object.hasOwn(instance, "getOffset"),
+        hasOwnStartPoint: Object.hasOwn(instance, "getStartPoint"),
+        hasOwnOffset: Object.hasOwn(instance, "getOffset"),
         previousStartPoint: instance.getStartPoint,
         previousOffset: instance.getOffset,
     };
@@ -105,6 +129,14 @@ const resolveDragUpdates = (dx, dy, options) => {
     }
     return updates;
 };
+/**
+ * Runs a `drag-begin`, `drag-update`, `drag-end` sequence ending at the offset `dx`, `dy` on the
+ * widget's drag gestures, overriding each gesture's start point and offset for the duration so
+ * handlers read the simulated values back.
+ *
+ * @throws When the widget is a Gtk.Range, whose slider reads pointer coordinates from the display,
+ * or when it has no Gtk.GestureDrag.
+ */
 const drag = async (widget, dx, dy, options = {}) => {
     if (widget instanceof Gtk.Range) {
         throw new TypeError("userEvent.drag cannot drive a Gtk.Range's built-in slider " +
@@ -123,9 +155,20 @@ const emitDrop = (target, content, options) => {
         dropTarget.emit("drop", buildDropValue(content), options.x ?? 0, options.y ?? 0);
     }
 };
+/**
+ * Emits `drop` with the given content on every drop target attached to the widget.
+ *
+ * @throws When the widget has no Gtk.DropTarget.
+ */
 const drop = (widget, content, options = {}) => wrapEvent(widget, () => {
     emitDrop(widget, content, options);
 });
+/**
+ * Emits `drop` with the given content on the target's drop targets, after checking that the source
+ * carries a drag source.
+ *
+ * @throws When the source has no Gtk.DragSource, or the target no Gtk.DropTarget.
+ */
 const dragAndDrop = async (source, target, content, options = {}) => {
     await wrapEvent(source, () => {
         getAllControllers(source, Gtk.DragSource);

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

@@ -1 +1 @@
-{"version":3,"file":"gesture.js","sourceRoot":"","sources":["../../src/user-event/gesture.ts"],"names":[],"mappings":"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","sourcesContent":["import * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { getAllControllers } from \"./controller.js\";\nimport { dispatchOnControllers, dispatchOnOrCreateControllers } from \"./dispatch.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** The value delivered to a drop target: a primitive (converted to a GObject.Value) or an explicit GObject.Value. */\ntype DropContent = string | number | boolean | GObject.Value;\n\n/** Options for a drop: the drop coordinates within the target. */\ntype DropOptions = {\n    x?: number;\n    y?: number;\n};\n\n/** A drag offset relative to the drag start point. */\ntype DragOffset = {\n    x: number;\n    y: number;\n};\n\n/**\n * Options for a drag gesture: the starting point, the number of interpolated drag updates, or\n * explicit intermediate offsets emitted before the final one.\n */\ntype DragOptions = {\n    startX?: number;\n    startY?: number;\n    steps?: number;\n    offsets?: DragOffset[];\n};\n\ntype DragInstancePatch = {\n    getStartPoint?: Gtk.GestureDrag[\"getStartPoint\"] | undefined;\n    getOffset?: Gtk.GestureDrag[\"getOffset\"] | undefined;\n};\n\ntype SavedDragState = {\n    instance: DragInstancePatch;\n    ownsStartPoint: boolean;\n    ownsOffset: boolean;\n    previousStartPoint: DragInstancePatch[\"getStartPoint\"];\n    previousOffset: DragInstancePatch[\"getOffset\"];\n};\n\nconst buildDropValue = (content: DropContent): GObject.Value => {\n    if (content instanceof GObject.Value) {\n        return content;\n    }\n\n    if (typeof content === \"string\") {\n        return GObject.buildValue(GObject.TYPE_STRING, (v) => {\n            v.setString(content);\n        });\n    }\n\n    if (typeof content === \"boolean\") {\n        return GObject.buildValue(GObject.TYPE_BOOLEAN, (v) => {\n            v.setBoolean(content);\n        });\n    }\n\n    return GObject.buildValue(GObject.TYPE_DOUBLE, (v) => {\n        v.setDouble(content);\n    });\n};\n\nconst hover = (widget: Gtk.Widget): Promise<void> =>\n    dispatchOnOrCreateControllers(widget, Gtk.EventControllerMotion, (controller) => {\n        controller.emit(\"enter\", 0, 0);\n    });\n\nconst unhover = (widget: Gtk.Widget): Promise<void> =>\n    dispatchOnOrCreateControllers(widget, Gtk.EventControllerMotion, (controller) => {\n        controller.emit(\"leave\");\n    });\n\nconst rotate = (widget: Gtk.Widget, angle: number, deltaAngle: number = angle): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureRotate, (controller) => {\n        controller.emit(\"angle-changed\", angle, deltaAngle);\n    },\n    );\n\nconst zoom = (widget: Gtk.Widget, scale: number): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureZoom, (controller) => {\n        controller.emit(\"scale-changed\", scale);\n    });\n\nconst swipe = (widget: Gtk.Widget, velocityX: number, velocityY: number): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureSwipe, (controller) => {\n        controller.emit(\"swipe\", velocityX, velocityY);\n    });\n\nconst longPress = (widget: Gtk.Widget, x = 0, y = 0): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureLongPress, (controller) => {\n        controller.emit(\"pressed\", x, y);\n    });\n\nconst restoreDragState = (saved: SavedDragState): void => {\n    const { instance } = saved;\n\n    if (saved.ownsStartPoint) {\n        instance.getStartPoint = saved.previousStartPoint;\n    } else {\n        delete instance.getStartPoint;\n    }\n\n    if (saved.ownsOffset) {\n        instance.getOffset = saved.previousOffset;\n    } else {\n        delete instance.getOffset;\n    }\n};\n\nconst patchDragState = (controller: Gtk.GestureDrag, start: DragOffset, offset: () => DragOffset): (() => void) => {\n    const instance: DragInstancePatch = controller;\n\n    const saved: SavedDragState = {\n        instance,\n        ownsStartPoint: Object.hasOwn(instance, \"getStartPoint\"),\n        ownsOffset: Object.hasOwn(instance, \"getOffset\"),\n        previousStartPoint: instance.getStartPoint,\n        previousOffset: instance.getOffset,\n    };\n\n    instance.getStartPoint = () => [true, start.x, start.y];\n\n    instance.getOffset = () => {\n        const current = offset();\n\n        return [true, current.x, current.y];\n    };\n\n    return () => {\n        restoreDragState(saved);\n    };\n};\n\nconst emitToControllers = (controllers: Gtk.GestureDrag[], signal: string, x: number, y: number): void => {\n    for (const controller of controllers) {\n        controller.emit(signal, x, y);\n    }\n};\n\nconst runDragSequence = (controllers: Gtk.GestureDrag[], start: DragOffset, updates: DragOffset[]): void => {\n    let current: DragOffset = { x: 0, y: 0 };\n    const restores = controllers.map((controller) => patchDragState(controller, start, () => current));\n\n    try {\n        emitToControllers(controllers, \"drag-begin\", start.x, start.y);\n\n        for (const update of updates) {\n            current = update;\n            emitToControllers(controllers, \"drag-update\", update.x, update.y);\n        }\n\n        emitToControllers(controllers, \"drag-end\", current.x, current.y);\n    } finally {\n        for (const restore of restores) {\n            restore();\n        }\n    }\n};\n\nconst resolveDragUpdates = (dx: number, dy: number, options: DragOptions): DragOffset[] => {\n    if (options.offsets) {\n        return [...options.offsets, { x: dx, y: dy }];\n    }\n\n    const steps = Math.max(1, Math.floor(options.steps ?? 2));\n    const updates: DragOffset[] = [];\n\n    for (let i = 1; i <= steps; i++) {\n        updates.push({ x: (dx * i) / steps, y: (dy * i) / steps });\n    }\n\n    return updates;\n};\n\nconst drag = async (widget: Gtk.Widget, dx: number, dy: number, options: DragOptions = {}): Promise<void> => {\n    if (widget instanceof Gtk.Range) {\n        throw new TypeError(\n            \"userEvent.drag cannot drive a Gtk.Range's built-in slider \" +\n            \"(its drag reads pointer coordinates from the display); \" +\n            \"use userEvent.slide(range, value) or userEvent.keyboard for sliders\",\n        );\n    }\n\n    const start = { x: options.startX ?? 0, y: options.startY ?? 0 };\n    const updates = resolveDragUpdates(dx, dy, options);\n\n    await wrapEvent(widget, () => {\n        runDragSequence(getAllControllers(widget, Gtk.GestureDrag), start, updates);\n    });\n};\n\nconst emitDrop = (target: Gtk.Widget, content: DropContent, options: DropOptions): void => {\n    const dropTargets = getAllControllers(target, Gtk.DropTarget);\n\n    for (const dropTarget of dropTargets) {\n        dropTarget.emit(\"drop\", buildDropValue(content), options.x ?? 0, options.y ?? 0);\n    }\n};\n\nconst drop = (widget: Gtk.Widget, content: DropContent, options: DropOptions = {}): Promise<void> =>\n    wrapEvent(widget, () => {\n        emitDrop(widget, content, options);\n    });\n\nconst dragAndDrop = async (\n    source: Gtk.Widget,\n    target: Gtk.Widget,\n    content: DropContent,\n    options: DropOptions = {},\n): Promise<void> => {\n    await wrapEvent(source, () => {\n        getAllControllers(source, Gtk.DragSource);\n    });\n\n    await wrapEvent(target, () => {\n        emitDrop(target, content, options);\n    });\n};\n\nexport {\n    hover,\n    unhover,\n    rotate,\n    zoom,\n    swipe,\n    longPress,\n    drag,\n    drop,\n    dragAndDrop,\n    type DropContent,\n    type DropOptions,\n    type DragOffset,\n    type DragOptions,\n};\n"]}
+{"version":3,"file":"gesture.js","sourceRoot":"","sources":["../../src/user-event/gesture.ts"],"names":[],"mappings":"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","sourcesContent":["import * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { getAllControllers } from \"./controller.js\";\nimport { dispatchOnControllers, dispatchOnOrCreateControllers } from \"./dispatch.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** The value delivered to a drop target: a primitive (converted to a GObject.Value) or an explicit GObject.Value. */\ntype DropContent = string | number | boolean | GObject.Value;\n\n/** Options for a drop: the drop coordinates within the target. */\ntype DropOptions = {\n    /** Horizontal drop coordinate within the target, in pixels. */\n    x?: number;\n    /** Vertical drop coordinate within the target, in pixels. */\n    y?: number;\n};\n\n/** A drag offset relative to the drag start point. */\ntype DragOffset = {\n    /** Horizontal distance from the drag start point, in pixels. */\n    x: number;\n    /** Vertical distance from the drag start point, in pixels. */\n    y: number;\n};\n\n/**\n * Options for a drag gesture: the starting point, the number of interpolated drag updates, or\n * explicit intermediate offsets emitted before the final one.\n */\ntype DragOptions = {\n    /** Horizontal coordinate the drag begins at; defaults to 0. */\n    startX?: number;\n    /** Vertical coordinate the drag begins at; defaults to 0. */\n    startY?: number;\n    /** Number of evenly interpolated drag updates, the last of which is the requested offset; defaults to 2. */\n    steps?: number;\n    /** Explicit intermediate offsets emitted before the requested one, used instead of `steps`. */\n    offsets?: DragOffset[];\n};\n\ntype DragInstancePatch = {\n    getStartPoint?: Gtk.GestureDrag[\"getStartPoint\"] | undefined;\n    getOffset?: Gtk.GestureDrag[\"getOffset\"] | undefined;\n};\n\ntype SavedDragState = {\n    instance: DragInstancePatch;\n    hasOwnStartPoint: boolean;\n    hasOwnOffset: boolean;\n    previousStartPoint: DragInstancePatch[\"getStartPoint\"];\n    previousOffset: DragInstancePatch[\"getOffset\"];\n};\n\nconst buildDropValue = (content: DropContent): GObject.Value => {\n    if (content instanceof GObject.Value) {\n        return content;\n    }\n\n    if (typeof content === \"string\") {\n        return GObject.buildValue(GObject.TYPE_STRING, (v) => {\n            v.setString(content);\n        });\n    }\n\n    if (typeof content === \"boolean\") {\n        return GObject.buildValue(GObject.TYPE_BOOLEAN, (v) => {\n            v.setBoolean(content);\n        });\n    }\n\n    return GObject.buildValue(GObject.TYPE_DOUBLE, (v) => {\n        v.setDouble(content);\n    });\n};\n\n/** Emits `enter` at the widget's origin on its motion controllers, adding one when it has none. */\nconst hover = (widget: Gtk.Widget): Promise<void> =>\n    dispatchOnOrCreateControllers(widget, Gtk.EventControllerMotion, (controller) => {\n        controller.emit(\"enter\", 0, 0);\n    });\n\n/** Emits `leave` on the widget's motion controllers, adding one when it has none. */\nconst unhover = (widget: Gtk.Widget): Promise<void> =>\n    dispatchOnOrCreateControllers(widget, Gtk.EventControllerMotion, (controller) => {\n        controller.emit(\"leave\");\n    });\n\n/**\n * Emits `angle-changed` on the widget's rotate gestures.\n *\n * @param angle Current angle, in radians.\n * @param deltaAngle Difference from the angle the gesture started at; defaults to `angle`.\n * @throws When the widget has no Gtk.GestureRotate.\n */\nconst rotate = (widget: Gtk.Widget, angle: number, deltaAngle: number = angle): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureRotate, (controller) => {\n        controller.emit(\"angle-changed\", angle, deltaAngle);\n    },\n    );\n\n/**\n * Emits `scale-changed` with the given scale delta on the widget's zoom gestures.\n *\n * @throws When the widget has no Gtk.GestureZoom.\n */\nconst zoom = (widget: Gtk.Widget, scale: number): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureZoom, (controller) => {\n        controller.emit(\"scale-changed\", scale);\n    });\n\n/**\n * Emits `swipe` with the given per-axis velocity, in pixels per second, on the widget's swipe gestures.\n *\n * @throws When the widget has no Gtk.GestureSwipe.\n */\nconst swipe = (widget: Gtk.Widget, velocityX: number, velocityY: number): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureSwipe, (controller) => {\n        controller.emit(\"swipe\", velocityX, velocityY);\n    });\n\n/**\n * Emits `pressed` at the given point in widget coordinates on the widget's long-press gestures.\n *\n * @throws When the widget has no Gtk.GestureLongPress.\n */\nconst longPress = (widget: Gtk.Widget, x = 0, y = 0): Promise<void> =>\n    dispatchOnControllers(widget, Gtk.GestureLongPress, (controller) => {\n        controller.emit(\"pressed\", x, y);\n    });\n\nconst restoreDragState = (saved: SavedDragState): void => {\n    const { instance } = saved;\n\n    if (saved.hasOwnStartPoint) {\n        instance.getStartPoint = saved.previousStartPoint;\n    } else {\n        delete instance.getStartPoint;\n    }\n\n    if (saved.hasOwnOffset) {\n        instance.getOffset = saved.previousOffset;\n    } else {\n        delete instance.getOffset;\n    }\n};\n\nconst patchDragState = (controller: Gtk.GestureDrag, start: DragOffset, offset: () => DragOffset): (() => void) => {\n    const instance: DragInstancePatch = controller;\n\n    const saved: SavedDragState = {\n        instance,\n        hasOwnStartPoint: Object.hasOwn(instance, \"getStartPoint\"),\n        hasOwnOffset: Object.hasOwn(instance, \"getOffset\"),\n        previousStartPoint: instance.getStartPoint,\n        previousOffset: instance.getOffset,\n    };\n\n    instance.getStartPoint = () => [true, start.x, start.y];\n\n    instance.getOffset = () => {\n        const current = offset();\n\n        return [true, current.x, current.y];\n    };\n\n    return () => {\n        restoreDragState(saved);\n    };\n};\n\nconst emitToControllers = (controllers: Gtk.GestureDrag[], signal: string, x: number, y: number): void => {\n    for (const controller of controllers) {\n        controller.emit(signal, x, y);\n    }\n};\n\nconst runDragSequence = (controllers: Gtk.GestureDrag[], start: DragOffset, updates: DragOffset[]): void => {\n    let current: DragOffset = { x: 0, y: 0 };\n    const restores = controllers.map((controller) => patchDragState(controller, start, () => current));\n\n    try {\n        emitToControllers(controllers, \"drag-begin\", start.x, start.y);\n\n        for (const update of updates) {\n            current = update;\n            emitToControllers(controllers, \"drag-update\", update.x, update.y);\n        }\n\n        emitToControllers(controllers, \"drag-end\", current.x, current.y);\n    } finally {\n        for (const restore of restores) {\n            restore();\n        }\n    }\n};\n\nconst resolveDragUpdates = (dx: number, dy: number, options: DragOptions): DragOffset[] => {\n    if (options.offsets) {\n        return [...options.offsets, { x: dx, y: dy }];\n    }\n\n    const steps = Math.max(1, Math.floor(options.steps ?? 2));\n    const updates: DragOffset[] = [];\n\n    for (let i = 1; i <= steps; i++) {\n        updates.push({ x: (dx * i) / steps, y: (dy * i) / steps });\n    }\n\n    return updates;\n};\n\n/**\n * Runs a `drag-begin`, `drag-update`, `drag-end` sequence ending at the offset `dx`, `dy` on the\n * widget's drag gestures, overriding each gesture's start point and offset for the duration so\n * handlers read the simulated values back.\n *\n * @throws When the widget is a Gtk.Range, whose slider reads pointer coordinates from the display,\n * or when it has no Gtk.GestureDrag.\n */\nconst drag = async (widget: Gtk.Widget, dx: number, dy: number, options: DragOptions = {}): Promise<void> => {\n    if (widget instanceof Gtk.Range) {\n        throw new TypeError(\n            \"userEvent.drag cannot drive a Gtk.Range's built-in slider \" +\n            \"(its drag reads pointer coordinates from the display); \" +\n            \"use userEvent.slide(range, value) or userEvent.keyboard for sliders\",\n        );\n    }\n\n    const start = { x: options.startX ?? 0, y: options.startY ?? 0 };\n    const updates = resolveDragUpdates(dx, dy, options);\n\n    await wrapEvent(widget, () => {\n        runDragSequence(getAllControllers(widget, Gtk.GestureDrag), start, updates);\n    });\n};\n\nconst emitDrop = (target: Gtk.Widget, content: DropContent, options: DropOptions): void => {\n    const dropTargets = getAllControllers(target, Gtk.DropTarget);\n\n    for (const dropTarget of dropTargets) {\n        dropTarget.emit(\"drop\", buildDropValue(content), options.x ?? 0, options.y ?? 0);\n    }\n};\n\n/**\n * Emits `drop` with the given content on every drop target attached to the widget.\n *\n * @throws When the widget has no Gtk.DropTarget.\n */\nconst drop = (widget: Gtk.Widget, content: DropContent, options: DropOptions = {}): Promise<void> =>\n    wrapEvent(widget, () => {\n        emitDrop(widget, content, options);\n    });\n\n/**\n * Emits `drop` with the given content on the target's drop targets, after checking that the source\n * carries a drag source.\n *\n * @throws When the source has no Gtk.DragSource, or the target no Gtk.DropTarget.\n */\nconst dragAndDrop = async (\n    source: Gtk.Widget,\n    target: Gtk.Widget,\n    content: DropContent,\n    options: DropOptions = {},\n): Promise<void> => {\n    await wrapEvent(source, () => {\n        getAllControllers(source, Gtk.DragSource);\n    });\n\n    await wrapEvent(target, () => {\n        emitDrop(target, content, options);\n    });\n};\n\nexport {\n    hover,\n    unhover,\n    rotate,\n    zoom,\n    swipe,\n    longPress,\n    drag,\n    drop,\n    dragAndDrop,\n    type DropContent,\n    type DropOptions,\n    type DragOffset,\n    type DragOptions,\n};\n"]}

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

@@ -6,39 +6,107 @@ import { tab } from "./keyboard.js";
 import { type PointerInput } from "./pointer.js";
 import { deselectOptions, selectOptions } from "./selection.js";
 import { clear, copy, cut, paste, type } from "./text.js";
+/** Options shared by every helper on a {@link UserEvent} instance. */
+type UserEventOptions = {
+    /** Milliseconds to wait after each helper resolves; null, the default, waits not at all. */
+    delay?: number | null | undefined;
+};
 /**
  * The set of user interaction helpers exposed by {@link userEvent}, covering clicks, typing,
  * keyboard, pointer, gestures, selection, and scrolling.
  */
 type UserEvent = {
+    /**
+     * Returns a fresh instance whose helpers share one keyboard and pointer state, so held modifiers
+     * and buttons carry across its calls but not across instances.
+     */
+    setup: (options?: UserEventOptions) => UserEvent;
+    /**
+     * Activates a widget that neither claims the click nor carries a click gesture of its own, and
+     * otherwise presses and releases outwards from the clicked widget through every widget carrying
+     * a click gesture, stopping at the first button or indexed child. A list box row or flow box
+     * child receives its click gesture at the clicked position, passes one on to the gestures its
+     * container carries, and is then activated, or exclusively selected when its container does not
+     * activate on a single click. The press also stops at a widget whose click GTK4 implements
+     * itself, where the gestures that widget carries of its own still take the press and the same
+     * outcome is then applied through GTK's own public action: a list, grid, or column-view row is
+     * focused and selected, and activated as well when its view activates on a single click; an
+     * expandable tree expander that is itself the clicked widget toggles its expansion; a column
+     * header sorts by its column. A column-view cell and the row carrying the column headers stand
+     * in the way of the click rather than taking it, so a click on either reaches the row or the
+     * view behind it.
+     */
     click: typeof click;
+    /**
+     * Delivers a two-press click gesture along the same path a single click takes, without trying
+     * activation first, activating a list box row or flow box child on that path and replacing its
+     * container's selection whether or not that container activates on a single click. A widget
+     * whose click GTK4 implements itself receives that outcome once per press, so a row is selected
+     * and activated by the second press, a tree expander ends back where it started, and a column
+     * header inverts its order after sorting.
+     */
     dblClick: typeof dblClick;
+    /**
+     * Delivers a three-press click gesture the same way a double click is delivered, applying the
+     * same outcome to a list box row or flow box child, and applying the outcome GTK4 implements
+     * itself once per press to a row, tree expander, or column header.
+     */
     tripleClick: typeof tripleClick;
+    /** Moves focus within the widget's root, forward by default and backward with `isShiftHeld`. */
     tab: typeof tab;
+    /** Focuses an editable widget, applies any initial selection, and inserts the text at the cursor. */
     type: typeof type;
+    /** Focuses an editable widget and deletes its whole text, leaving nothing selected. */
     clear: typeof clear;
+    /** Writes an editable widget's current selection to the clipboard. */
     copy: typeof copy;
+    /** Writes an editable widget's current selection to the clipboard and deletes it. */
     cut: typeof cut;
+    /** Inserts the given text, or the clipboard's text, at an editable widget's cursor. */
     paste: typeof paste;
+    /**
+     * Selects the items at those positions in a view or drop-down, or selects the indexed children of
+     * a list box or flow box through their container, without activating them.
+     */
     selectOptions: typeof selectOptions;
+    /** Unselects the items at those positions, leaving list box and flow box children unactivated. */
     deselectOptions: typeof deselectOptions;
+    /** Emits a motion `enter` on the widget, adding a motion controller when it has none. */
     hover: typeof hover;
+    /** Emits a motion `leave` on the widget, adding a motion controller when it has none. */
     unhover: typeof unhover;
+    /** Emits `angle-changed` on the widget's rotate gestures. */
     rotate: typeof rotate;
+    /** Emits `scale-changed` on the widget's zoom gestures. */
     zoom: typeof zoom;
+    /** Emits `swipe` with the given velocity on the widget's swipe gestures. */
     swipe: typeof swipe;
+    /** Emits `pressed` at the given point on the widget's long-press gestures. */
     longPress: typeof longPress;
+    /** Runs a begin, update, and end sequence on the widget's drag gestures, ending at the given offset. */
     drag: typeof drag;
+    /** Emits `drop` with the given content on the widget's drop targets. */
     drop: typeof drop;
+    /** Requires a drag source on the source widget, then emits `drop` with the content on the target's drop targets. */
     dragAndDrop: typeof dragAndDrop;
+    /** Emits a jump `change-value` on a Gtk.Range so it moves to the given value. */
     slide: typeof slide;
+    /** Adds the delta to the adjustments of the widget itself, or of its nearest scrollable ancestor. */
     scroll: typeof scroll;
+    /** Sends a key sequence, dispatching matching shortcuts and tracking held modifiers across calls. */
     keyboard: (widget: Gtk.Widget, input: string) => Promise<void>;
+    /**
+     * Applies a pointer token to the click gestures the widget already carries, tracking whether the
+     * left button is held across calls. On a widget whose click GTK4 implements itself, the release
+     * also applies GTK's own outcome, the way {@link UserEvent.click} does, and a column-view cell
+     * or the row carrying the column headers passes the token to the row or view behind it.
+     */
     pointer: (widget: Gtk.Widget, input: PointerInput) => Promise<void>;
 };
 /**
  * High-level helpers that drive widgets by dispatching the same events and gestures GTK4 delivers
- * when someone clicks, types, or drags.
+ * when someone clicks, types, or drags. Call `setup` for an instance with its own keyboard and
+ * pointer state.
  */
 declare const userEvent: UserEvent;
 export type { ScrollDelta } from "./adjustment.js";
@@ -47,5 +115,5 @@ export type { TabOptions } from "./keyboard.js";
 export type { PointerInput } from "./pointer.js";
 export type { TypeOptions } from "./text.js";
 export { resetClipboard } from "./text.js";
-export { userEvent, type UserEvent };
+export { userEvent, type UserEvent, type UserEventOptions };
 //# sourceMappingURL=index.d.ts.map

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":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAY,GAAG,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1D;;;GAGG;AACH,KAAK,SAAS,GAAG;IACb,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE,CAAC;AAIF;;;GAGG;AACH,QAAA,MAAM,SAAS,EAAE,SAyBhB,CAAC;AAEF,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,CAAC"}
+{"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

@@ -6,37 +6,54 @@ 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 state = createInitialState();
 /**
  * High-level helpers that drive widgets by dispatching the same events and gestures GTK4 delivers
- * when someone clicks, types, or drags.
+ * when someone clicks, types, or drags. Call `setup` for an instance with its own keyboard and
+ * pointer state.
  */
 const userEvent = {
-    click,
-    dblClick,
-    tripleClick,
-    tab,
-    type,
-    clear,
-    copy,
-    cut,
-    paste,
-    selectOptions,
-    deselectOptions,
-    hover,
-    unhover,
-    rotate,
-    zoom,
-    swipe,
-    longPress,
-    drag,
-    drop,
-    dragAndDrop,
-    slide,
-    scroll,
-    keyboard: (widget, input) => keyboard(state, widget, input),
-    pointer: (widget, input) => pointer(state, widget, input),
+    ...createInstance(createInitialState(), {}),
+    setup: (options) => createInstance(createInitialState(), options ?? {}),
 };
+const settle = (delay) => {
+    if (delay === null || delay === undefined) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => setTimeout(resolve, delay));
+};
+function createInstance(state, options) {
+    const after = (helper) => async (...args) => {
+        await helper(...args);
+        await settle(options.delay);
+    };
+    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)),
+    };
+}
 export { resetClipboard } from "./text.js";
 export { userEvent };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user-event/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAqB,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiC1D,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;AAEnC;;;GAGG;AACH,MAAM,SAAS,GAAc;IACzB,KAAK;IACL,QAAQ;IACR,WAAW;IACX,GAAG;IACH,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,GAAG;IACH,KAAK;IACL,aAAa;IACb,eAAe;IACf,KAAK;IACL,OAAO;IACP,MAAM;IACN,IAAI;IACJ,KAAK;IACL,SAAS;IACT,IAAI;IACJ,IAAI;IACJ,WAAW;IACX,KAAK;IACL,MAAM;IACN,QAAQ,EAAE,CAAC,MAAkB,EAAE,KAAa,EAAiB,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;IAC9F,OAAO,EAAE,CAAC,MAAkB,EAAE,KAAmB,EAAiB,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;CACrG,CAAC;AAOF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAkB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { scroll, slide } from \"./adjustment.js\";\nimport { click, dblClick, tripleClick } from \"./click.js\";\nimport { drag, dragAndDrop, drop, hover, longPress, rotate, swipe, unhover, zoom } from \"./gesture.js\";\nimport { keyboard, tab } from \"./keyboard.js\";\nimport { pointer, type PointerInput } from \"./pointer.js\";\nimport { deselectOptions, selectOptions } from \"./selection.js\";\nimport { createInitialState } from \"./state.js\";\nimport { clear, copy, cut, paste, type } from \"./text.js\";\n\n/**\n * The set of user interaction helpers exposed by {@link userEvent}, covering clicks, typing,\n * keyboard, pointer, gestures, selection, and scrolling.\n */\ntype UserEvent = {\n    click: typeof click;\n    dblClick: typeof dblClick;\n    tripleClick: typeof tripleClick;\n    tab: typeof tab;\n    type: typeof type;\n    clear: typeof clear;\n    copy: typeof copy;\n    cut: typeof cut;\n    paste: typeof paste;\n    selectOptions: typeof selectOptions;\n    deselectOptions: typeof deselectOptions;\n    hover: typeof hover;\n    unhover: typeof unhover;\n    rotate: typeof rotate;\n    zoom: typeof zoom;\n    swipe: typeof swipe;\n    longPress: typeof longPress;\n    drag: typeof drag;\n    drop: typeof drop;\n    dragAndDrop: typeof dragAndDrop;\n    slide: typeof slide;\n    scroll: typeof scroll;\n    keyboard: (widget: Gtk.Widget, input: string) => Promise<void>;\n    pointer: (widget: Gtk.Widget, input: PointerInput) => Promise<void>;\n};\n\nconst state = createInitialState();\n\n/**\n * High-level helpers that drive widgets by dispatching the same events and gestures GTK4 delivers\n * when someone clicks, types, or drags.\n */\nconst userEvent: UserEvent = {\n    click,\n    dblClick,\n    tripleClick,\n    tab,\n    type,\n    clear,\n    copy,\n    cut,\n    paste,\n    selectOptions,\n    deselectOptions,\n    hover,\n    unhover,\n    rotate,\n    zoom,\n    swipe,\n    longPress,\n    drag,\n    drop,\n    dragAndDrop,\n    slide,\n    scroll,\n    keyboard: (widget: Gtk.Widget, input: string): Promise<void> => keyboard(state, widget, input),\n    pointer: (widget: Gtk.Widget, input: PointerInput): Promise<void> => pointer(state, widget, input),\n};\n\nexport type { ScrollDelta } from \"./adjustment.js\";\nexport type { DragOffset, DragOptions, DropContent, DropOptions } from \"./gesture.js\";\nexport type { TabOptions } from \"./keyboard.js\";\nexport type { PointerInput } from \"./pointer.js\";\nexport type { TypeOptions } from \"./text.js\";\nexport { resetClipboard } from \"./text.js\";\nexport { userEvent, type UserEvent };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user-event/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { scroll, slide } from \"./adjustment.js\";\nimport { click, dblClick, tripleClick } from \"./click.js\";\nimport { drag, dragAndDrop, drop, hover, longPress, rotate, swipe, unhover, zoom } from \"./gesture.js\";\nimport { keyboard, tab } from \"./keyboard.js\";\nimport { pointer, type PointerInput } from \"./pointer.js\";\nimport { deselectOptions, selectOptions } from \"./selection.js\";\nimport { createInitialState, type UserEventState } from \"./state.js\";\nimport { clear, copy, cut, paste, type } from \"./text.js\";\n\n/** Options shared by every helper on a {@link UserEvent} instance. */\ntype UserEventOptions = {\n    /** Milliseconds to wait after each helper resolves; null, the default, waits not at all. */\n    delay?: number | null | undefined;\n};\n\n/**\n * The set of user interaction helpers exposed by {@link userEvent}, covering clicks, typing,\n * keyboard, pointer, gestures, selection, and scrolling.\n */\ntype UserEvent = {\n    /**\n     * Returns a fresh instance whose helpers share one keyboard and pointer state, so held modifiers\n     * and buttons carry across its calls but not across instances.\n     */\n    setup: (options?: UserEventOptions) => UserEvent;\n    /**\n     * Activates a widget that neither claims the click nor carries a click gesture of its own, and\n     * otherwise presses and releases outwards from the clicked widget through every widget carrying\n     * a click gesture, stopping at the first button or indexed child. A list box row or flow box\n     * child receives its click gesture at the clicked position, passes one on to the gestures its\n     * container carries, and is then activated, or exclusively selected when its container does not\n     * activate on a single click. The press also stops at a widget whose click GTK4 implements\n     * itself, where the gestures that widget carries of its own still take the press and the same\n     * outcome is then applied through GTK's own public action: a list, grid, or column-view row is\n     * focused and selected, and activated as well when its view activates on a single click; an\n     * expandable tree expander that is itself the clicked widget toggles its expansion; a column\n     * header sorts by its column. A column-view cell and the row carrying the column headers stand\n     * in the way of the click rather than taking it, so a click on either reaches the row or the\n     * view behind it.\n     */\n    click: typeof click;\n    /**\n     * Delivers a two-press click gesture along the same path a single click takes, without trying\n     * activation first, activating a list box row or flow box child on that path and replacing its\n     * container's selection whether or not that container activates on a single click. A widget\n     * whose click GTK4 implements itself receives that outcome once per press, so a row is selected\n     * and activated by the second press, a tree expander ends back where it started, and a column\n     * header inverts its order after sorting.\n     */\n    dblClick: typeof dblClick;\n    /**\n     * Delivers a three-press click gesture the same way a double click is delivered, applying the\n     * same outcome to a list box row or flow box child, and applying the outcome GTK4 implements\n     * itself once per press to a row, tree expander, or column header.\n     */\n    tripleClick: typeof tripleClick;\n    /** Moves focus within the widget's root, forward by default and backward with `isShiftHeld`. */\n    tab: typeof tab;\n    /** Focuses an editable widget, applies any initial selection, and inserts the text at the cursor. */\n    type: typeof type;\n    /** Focuses an editable widget and deletes its whole text, leaving nothing selected. */\n    clear: typeof clear;\n    /** Writes an editable widget's current selection to the clipboard. */\n    copy: typeof copy;\n    /** Writes an editable widget's current selection to the clipboard and deletes it. */\n    cut: typeof cut;\n    /** Inserts the given text, or the clipboard's text, at an editable widget's cursor. */\n    paste: typeof paste;\n    /**\n     * Selects the items at those positions in a view or drop-down, or selects the indexed children of\n     * a list box or flow box through their container, without activating them.\n     */\n    selectOptions: typeof selectOptions;\n    /** Unselects the items at those positions, leaving list box and flow box children unactivated. */\n    deselectOptions: typeof deselectOptions;\n    /** Emits a motion `enter` on the widget, adding a motion controller when it has none. */\n    hover: typeof hover;\n    /** Emits a motion `leave` on the widget, adding a motion controller when it has none. */\n    unhover: typeof unhover;\n    /** Emits `angle-changed` on the widget's rotate gestures. */\n    rotate: typeof rotate;\n    /** Emits `scale-changed` on the widget's zoom gestures. */\n    zoom: typeof zoom;\n    /** Emits `swipe` with the given velocity on the widget's swipe gestures. */\n    swipe: typeof swipe;\n    /** Emits `pressed` at the given point on the widget's long-press gestures. */\n    longPress: typeof longPress;\n    /** Runs a begin, update, and end sequence on the widget's drag gestures, ending at the given offset. */\n    drag: typeof drag;\n    /** Emits `drop` with the given content on the widget's drop targets. */\n    drop: typeof drop;\n    /** Requires a drag source on the source widget, then emits `drop` with the content on the target's drop targets. */\n    dragAndDrop: typeof dragAndDrop;\n    /** Emits a jump `change-value` on a Gtk.Range so it moves to the given value. */\n    slide: typeof slide;\n    /** Adds the delta to the adjustments of the widget itself, or of its nearest scrollable ancestor. */\n    scroll: typeof scroll;\n    /** Sends a key sequence, dispatching matching shortcuts and tracking held modifiers across calls. */\n    keyboard: (widget: Gtk.Widget, input: string) => Promise<void>;\n    /**\n     * Applies a pointer token to the click gestures the widget already carries, tracking whether the\n     * left button is held across calls. On a widget whose click GTK4 implements itself, the release\n     * also applies GTK's own outcome, the way {@link UserEvent.click} does, and a column-view cell\n     * or the row carrying the column headers passes the token to the row or view behind it.\n     */\n    pointer: (widget: Gtk.Widget, input: PointerInput) => Promise<void>;\n};\n\n/**\n * High-level helpers that drive widgets by dispatching the same events and gestures GTK4 delivers\n * when someone clicks, types, or drags. Call `setup` for an instance with its own keyboard and\n * pointer state.\n */\nconst userEvent: UserEvent = {\n    ...createInstance(createInitialState(), {}),\n    setup: (options?: UserEventOptions): UserEvent => createInstance(createInitialState(), options ?? {}),\n};\n\nconst settle = (delay: number | null | undefined): Promise<void> => {\n    if (delay === null || delay === undefined) {\n        return Promise.resolve();\n    }\n\n    return new Promise((resolve) => setTimeout(resolve, delay));\n};\n\nfunction createInstance(state: UserEventState, options: UserEventOptions): UserEvent {\n    const after =\n        <Args extends unknown[]>(helper: (...args: Args) => Promise<void>) =>\n            async (...args: Args): Promise<void> => {\n                await helper(...args);\n                await settle(options.delay);\n            };\n\n    return {\n        setup: (overrides?: UserEventOptions): UserEvent => createInstance(state, { ...options, ...overrides }),\n        click: after(click),\n        dblClick: after(dblClick),\n        tripleClick: after(tripleClick),\n        tab: after(tab),\n        type: after(type),\n        clear: after(clear),\n        copy: after(copy),\n        cut: after(cut),\n        paste: after(paste),\n        selectOptions: after(selectOptions),\n        deselectOptions: after(deselectOptions),\n        hover: after(hover),\n        unhover: after(unhover),\n        rotate: after(rotate),\n        zoom: after(zoom),\n        swipe: after(swipe),\n        longPress: after(longPress),\n        drag: after(drag),\n        drop: after(drop),\n        dragAndDrop: after(dragAndDrop),\n        slide: after(slide),\n        scroll: after(scroll),\n        keyboard: after((widget: Gtk.Widget, input: string): Promise<void> => keyboard(state, widget, input)),\n        pointer: after((widget: Gtk.Widget, input: PointerInput): Promise<void> => pointer(state, widget, input)),\n    };\n}\n\nexport type { ScrollDelta } from \"./adjustment.js\";\nexport type { DragOffset, DragOptions, DropContent, DropOptions } from \"./gesture.js\";\nexport type { TabOptions } from \"./keyboard.js\";\nexport type { PointerInput } from \"./pointer.js\";\nexport type { TypeOptions } from \"./text.js\";\nexport { resetClipboard } from \"./text.js\";\nexport { userEvent, type UserEvent, type UserEventOptions };\n"]}

package/dist/user-event/indexed-children.d.ts

@@ -0,0 +1,10 @@
+import type * as Gtk from "@gtkx/gi/gtk";
+declare const SELECTED_PROBE = "isSelected";
+declare const hasIndexedChildren: (widget: Gtk.Widget) => boolean;
+declare const getChildAtIndex: (widget: Gtk.Widget, index: number) => Gtk.Widget | null;
+declare const selectContainerChild: (container: Gtk.Widget, child: Gtk.Widget) => void;
+declare const unselectContainerChild: (container: Gtk.Widget, child: Gtk.Widget) => void;
+declare const isChildSelected: (child: Gtk.Widget) => boolean;
+declare const unselectOtherChildren: (container: Gtk.Widget, child: Gtk.Widget) => void;
+export { getChildAtIndex, hasIndexedChildren, isChildSelected, SELECTED_PROBE, selectContainerChild, unselectContainerChild, unselectOtherChildren, };
+//# sourceMappingURL=indexed-children.d.ts.map

package/dist/user-event/indexed-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-children.d.ts","sourceRoot":"","sources":["../../src/user-event/indexed-children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAOzC,QAAA,MAAM,cAAc,eAAe,CAAC;AAEpC,QAAA,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAC2B,CAAC;AAE7E,QAAA,MAAM,eAAe,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,GAAG,CAAC,MAAM,GAAG,IAUzE,CAAC;AAcF,QAAA,MAAM,oBAAoB,GAAI,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAG,IAExE,CAAC;AAEF,QAAA,MAAM,sBAAsB,GAAI,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAG,IAE1E,CAAC;AAEF,QAAA,MAAM,eAAe,GAAI,OAAO,GAAG,CAAC,MAAM,KAAG,OAA4D,CAAC;AAc1G,QAAA,MAAM,qBAAqB,GAAI,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAG,IAMzE,CAAC;AAEF,OAAO,EACH,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACxB,CAAC"}

package/dist/user-event/indexed-children.js

@@ -0,0 +1,50 @@
+import { callBooleanGetter, getCallableMethod, hasWidgetMethod } from "../widget-getters.js";
+const CHILD_AT_INDEX_GETTERS = ["getRowAtIndex", "getChildAtIndex"];
+const CHILD_SELECTORS = ["selectRow", "selectChild"];
+const CHILD_DESELECTORS = ["unselectRow", "unselectChild"];
+const SELECTED_CHILD_GETTERS = ["getSelectedRows", "getSelectedChildren"];
+const SELECTED_PROBE = "isSelected";
+const hasIndexedChildren = (widget) => CHILD_AT_INDEX_GETTERS.some((getter) => hasWidgetMethod(widget, getter));
+const getChildAtIndex = (widget, index) => {
+    for (const getter of CHILD_AT_INDEX_GETTERS) {
+        const fn = getCallableMethod(widget, getter);
+        if (fn) {
+            return fn(index) ?? null;
+        }
+    }
+    return null;
+};
+const applyChildMethod = (container, names, child) => {
+    for (const name of names) {
+        const fn = getCallableMethod(container, name);
+        if (fn) {
+            fn(child);
+            return;
+        }
+    }
+};
+const selectContainerChild = (container, child) => {
+    applyChildMethod(container, CHILD_SELECTORS, child);
+};
+const unselectContainerChild = (container, child) => {
+    applyChildMethod(container, CHILD_DESELECTORS, child);
+};
+const isChildSelected = (child) => callBooleanGetter(child, SELECTED_PROBE) ?? false;
+const getSelectedChildren = (container) => {
+    for (const getter of SELECTED_CHILD_GETTERS) {
+        const fn = getCallableMethod(container, getter);
+        if (fn) {
+            return fn();
+        }
+    }
+    return [];
+};
+const unselectOtherChildren = (container, child) => {
+    for (const selected of getSelectedChildren(container)) {
+        if (selected !== child) {
+            unselectContainerChild(container, selected);
+        }
+    }
+};
+export { getChildAtIndex, hasIndexedChildren, isChildSelected, SELECTED_PROBE, selectContainerChild, unselectContainerChild, unselectOtherChildren, };
+//# sourceMappingURL=indexed-children.js.map

package/dist/user-event/indexed-children.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-children.js","sourceRoot":"","sources":["../../src/user-event/indexed-children.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE7F,MAAM,sBAAsB,GAAG,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AACpE,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACrD,MAAM,iBAAiB,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AAC3D,MAAM,sBAAsB,GAAG,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;AAC1E,MAAM,cAAc,GAAG,YAAY,CAAC;AAEpC,MAAM,kBAAkB,GAAG,CAAC,MAAkB,EAAW,EAAE,CACvD,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7E,MAAM,eAAe,GAAG,CAAC,MAAkB,EAAE,KAAa,EAAqB,EAAE;IAC7E,KAAK,MAAM,MAAM,IAAI,sBAAsB,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,iBAAiB,CAA8B,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1E,IAAI,EAAE,EAAE,CAAC;YACL,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,SAAqB,EAAE,KAAe,EAAE,KAAiB,EAAQ,EAAE;IACzF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,iBAAiB,CAAwB,SAAS,EAAE,IAAI,CAAC,CAAC;QAErE,IAAI,EAAE,EAAE,CAAC;YACL,EAAE,CAAC,KAAK,CAAC,CAAC;YAEV,OAAO;QACX,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,SAAqB,EAAE,KAAiB,EAAQ,EAAE;IAC5E,gBAAgB,CAAC,SAAS,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,SAAqB,EAAE,KAAiB,EAAQ,EAAE;IAC9E,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAiB,EAAW,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,IAAI,KAAK,CAAC;AAE1G,MAAM,mBAAmB,GAAG,CAAC,SAAqB,EAAgB,EAAE;IAChE,KAAK,MAAM,MAAM,IAAI,sBAAsB,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,iBAAiB,CAAmB,SAAS,EAAE,MAAM,CAAC,CAAC;QAElE,IAAI,EAAE,EAAE,CAAC;YACL,OAAO,EAAE,EAAE,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,SAAqB,EAAE,KAAiB,EAAQ,EAAE;IAC7E,KAAK,MAAM,QAAQ,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACrB,sBAAsB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EACH,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACxB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { callBooleanGetter, getCallableMethod, hasWidgetMethod } from \"../widget-getters.js\";\n\nconst CHILD_AT_INDEX_GETTERS = [\"getRowAtIndex\", \"getChildAtIndex\"];\nconst CHILD_SELECTORS = [\"selectRow\", \"selectChild\"];\nconst CHILD_DESELECTORS = [\"unselectRow\", \"unselectChild\"];\nconst SELECTED_CHILD_GETTERS = [\"getSelectedRows\", \"getSelectedChildren\"];\nconst SELECTED_PROBE = \"isSelected\";\n\nconst hasIndexedChildren = (widget: Gtk.Widget): boolean =>\n    CHILD_AT_INDEX_GETTERS.some((getter) => hasWidgetMethod(widget, getter));\n\nconst getChildAtIndex = (widget: Gtk.Widget, index: number): Gtk.Widget | null => {\n    for (const getter of CHILD_AT_INDEX_GETTERS) {\n        const fn = getCallableMethod<[number], Gtk.Widget | null>(widget, getter);\n\n        if (fn) {\n            return fn(index) ?? null;\n        }\n    }\n\n    return null;\n};\n\nconst applyChildMethod = (container: Gtk.Widget, names: string[], child: Gtk.Widget): void => {\n    for (const name of names) {\n        const fn = getCallableMethod<[Gtk.Widget], unknown>(container, name);\n\n        if (fn) {\n            fn(child);\n\n            return;\n        }\n    }\n};\n\nconst selectContainerChild = (container: Gtk.Widget, child: Gtk.Widget): void => {\n    applyChildMethod(container, CHILD_SELECTORS, child);\n};\n\nconst unselectContainerChild = (container: Gtk.Widget, child: Gtk.Widget): void => {\n    applyChildMethod(container, CHILD_DESELECTORS, child);\n};\n\nconst isChildSelected = (child: Gtk.Widget): boolean => callBooleanGetter(child, SELECTED_PROBE) ?? false;\n\nconst getSelectedChildren = (container: Gtk.Widget): Gtk.Widget[] => {\n    for (const getter of SELECTED_CHILD_GETTERS) {\n        const fn = getCallableMethod<[], Gtk.Widget[]>(container, getter);\n\n        if (fn) {\n            return fn();\n        }\n    }\n\n    return [];\n};\n\nconst unselectOtherChildren = (container: Gtk.Widget, child: Gtk.Widget): void => {\n    for (const selected of getSelectedChildren(container)) {\n        if (selected !== child) {\n            unselectContainerChild(container, selected);\n        }\n    }\n};\n\nexport {\n    getChildAtIndex,\n    hasIndexedChildren,\n    isChildSelected,\n    SELECTED_PROBE,\n    selectContainerChild,\n    unselectContainerChild,\n    unselectOtherChildren,\n};\n"]}

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

@@ -1,9 +1,11 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import type { UserEventState } from "./state.js";
-/** Options for {@link tab}: when `shift` is set, move focus backward instead of forward. */
+/** Options for `userEvent.tab`. */
 type TabOptions = {
-    shift?: boolean;
+    /** Move focus backward instead of forward. */
+    isShiftHeld?: boolean;
 };
+/** Moves focus within the widget's root, forward by default and backward when `isShiftHeld` is set. */
 declare const tab: (widget: Gtk.Widget, options?: TabOptions) => Promise<void>;
 declare const keyboard: (state: UserEventState, widget: Gtk.Widget, input: string) => Promise<void>;
 export { tab, keyboard, type TabOptions };

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

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/user-event/keyboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,4FAA4F;AAC5F,KAAK,UAAU,GAAG;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAiDF,QAAA,MAAM,GAAG,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAU,UAAU,KAAG,OAAO,CAAC,IAAI,CAQ9D,CAAC;AAoNP,QAAA,MAAM,QAAQ,GAAI,OAAO,cAAc,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAOnF,CAAC;AAEP,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,CAAC"}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/user-event/keyboard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,mCAAmC;AACnC,KAAK,UAAU,GAAG;IACd,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAiDF,uGAAuG;AACvG,QAAA,MAAM,GAAG,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAU,UAAU,KAAG,OAAO,CAAC,IAAI,CAQ9D,CAAC;AAmQP,QAAA,MAAM,QAAQ,GAAI,OAAO,cAAc,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAOnF,CAAC;AAEP,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,CAAC"}