@gtkx/testing 1.0.0 → 1.2.0

package/dist/user-event/adjustment.js

@@ -1,5 +1,6 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { scheduleNextFrame } from "../frame-sync.js";
+import { getTypeTag } from "../widget-getters.js";
 import { wrapEvent } from "./event-wrapper.js";
 /**
  * Emits a jump `change-value` so a Gtk.Range moves to the given value.
@@ -8,7 +9,7 @@ import { wrapEvent } from "./event-wrapper.js";
  */
 const slide = (widget, value) => wrapEvent(widget, () => {
     if (!(widget instanceof Gtk.Range)) {
-        throw new TypeError(`userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`);
+        throw new TypeError(`userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${getTypeTag(widget)}`);
     }
     widget.emit("change-value", Gtk.ScrollType.JUMP, value);
 });

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

@@ -1 +1 @@
-{"version":3,"file":"adjustment.js","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { scheduleNextFrame } from \"../frame-sync.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** A scroll distance in pixels along each axis. */\ntype ScrollDelta = {\n    /** Distance added to the horizontal adjustment. */\n    x?: number;\n    /** Distance added to the vertical adjustment. */\n    y?: number;\n};\n\ntype ScrollAdjustments = {\n    horizontal: Gtk.Adjustment | null;\n    vertical: Gtk.Adjustment | null;\n};\n\n/**\n * Emits a jump `change-value` so a Gtk.Range moves to the given value.\n *\n * @throws When the widget is not a Gtk.Range.\n */\nconst slide = (widget: Gtk.Widget, value: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        if (!(widget instanceof Gtk.Range)) {\n            throw new TypeError(\n                `userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${widget.constructor.name}`,\n            );\n        }\n\n        widget.emit(\"change-value\", Gtk.ScrollType.JUMP, value);\n    });\n\nconst resolveScrollAdjustments = (widget: Gtk.Widget): ScrollAdjustments | null => {\n    for (let current: Gtk.Widget | null = widget; current; current = current.getParent()) {\n        if (current instanceof Gtk.ScrolledWindow) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n\n        if (current instanceof Gtk.Scrollable) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n    }\n\n    return null;\n};\n\nconst stepToward = (adjustment: Gtk.Adjustment, target: number, step: number): number => {\n    const value = adjustment.getValue();\n    adjustment.setValue(value < target ? Math.min(value + step, target) : Math.max(value - step, target));\n\n    return adjustment.getValue();\n};\n\nconst rampTo = (adjustment: Gtk.Adjustment, target: number, step: number): void => {\n    let value = adjustment.getValue();\n\n    while (value !== target) {\n        const moved = stepToward(adjustment, target, step);\n\n        if (moved === value) {\n            return;\n        }\n\n        value = moved;\n    }\n};\n\nconst applyScrollDelta = (adjustment: Gtk.Adjustment | null, delta: number): void => {\n    if (!adjustment || delta === 0) {\n        return;\n    }\n\n    const pageSize = adjustment.getPageSize();\n    rampTo(adjustment, adjustment.getValue() + delta, pageSize > 0 ? pageSize : Math.abs(delta));\n};\n\n/**\n * Adds the delta to the adjustments of the widget itself, or of its nearest Gtk.ScrolledWindow or\n * Gtk.Scrollable ancestor.\n *\n * Each adjustment advances in viewport-sized steps rather than one jump, so virtualized views such\n * as Gtk.ListView, Gtk.GridView and Gtk.ColumnView re-anchor onto the rows the new offset shows.\n *\n * @throws When neither the widget nor any of its ancestors is scrollable.\n */\nconst scroll = (widget: Gtk.Widget, delta: ScrollDelta): Promise<void> =>\n    wrapEvent(widget, async () => {\n        const adjustments = resolveScrollAdjustments(widget);\n\n        if (!adjustments) {\n            throw new Error(\n                \"userEvent.scroll: no Gtk.ScrolledWindow or Gtk.Scrollable found on the widget or its ancestors\",\n            );\n        }\n\n        applyScrollDelta(adjustments.horizontal, delta.x ?? 0);\n        applyScrollDelta(adjustments.vertical, delta.y ?? 0);\n        await scheduleNextFrame(widget);\n    });\n\nexport { slide, scroll, type ScrollDelta };\n"]}
+{"version":3,"file":"adjustment.js","sourceRoot":"","sources":["../../src/user-event/adjustment.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { scheduleNextFrame } from \"../frame-sync.js\";\nimport { getTypeTag } from \"../widget-getters.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** A scroll distance in pixels along each axis. */\ntype ScrollDelta = {\n    /** Distance added to the horizontal adjustment. */\n    x?: number;\n    /** Distance added to the vertical adjustment. */\n    y?: number;\n};\n\ntype ScrollAdjustments = {\n    horizontal: Gtk.Adjustment | null;\n    vertical: Gtk.Adjustment | null;\n};\n\n/**\n * Emits a jump `change-value` so a Gtk.Range moves to the given value.\n *\n * @throws When the widget is not a Gtk.Range.\n */\nconst slide = (widget: Gtk.Widget, value: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        if (!(widget instanceof Gtk.Range)) {\n            throw new TypeError(\n                `userEvent.slide requires a Gtk.Range (e.g. Gtk.Scale), got ${getTypeTag(widget)}`,\n            );\n        }\n\n        widget.emit(\"change-value\", Gtk.ScrollType.JUMP, value);\n    });\n\nconst resolveScrollAdjustments = (widget: Gtk.Widget): ScrollAdjustments | null => {\n    for (let current: Gtk.Widget | null = widget; current; current = current.getParent()) {\n        if (current instanceof Gtk.ScrolledWindow) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n\n        if (current instanceof Gtk.Scrollable) {\n            return { horizontal: current.getHadjustment(), vertical: current.getVadjustment() };\n        }\n    }\n\n    return null;\n};\n\nconst stepToward = (adjustment: Gtk.Adjustment, target: number, step: number): number => {\n    const value = adjustment.getValue();\n    adjustment.setValue(value < target ? Math.min(value + step, target) : Math.max(value - step, target));\n\n    return adjustment.getValue();\n};\n\nconst rampTo = (adjustment: Gtk.Adjustment, target: number, step: number): void => {\n    let value = adjustment.getValue();\n\n    while (value !== target) {\n        const moved = stepToward(adjustment, target, step);\n\n        if (moved === value) {\n            return;\n        }\n\n        value = moved;\n    }\n};\n\nconst applyScrollDelta = (adjustment: Gtk.Adjustment | null, delta: number): void => {\n    if (!adjustment || delta === 0) {\n        return;\n    }\n\n    const pageSize = adjustment.getPageSize();\n    rampTo(adjustment, adjustment.getValue() + delta, pageSize > 0 ? pageSize : Math.abs(delta));\n};\n\n/**\n * Adds the delta to the adjustments of the widget itself, or of its nearest Gtk.ScrolledWindow or\n * Gtk.Scrollable ancestor.\n *\n * Each adjustment advances in viewport-sized steps rather than one jump, so virtualized views such\n * as Gtk.ListView, Gtk.GridView and Gtk.ColumnView re-anchor onto the rows the new offset shows.\n *\n * @throws When neither the widget nor any of its ancestors is scrollable.\n */\nconst scroll = (widget: Gtk.Widget, delta: ScrollDelta): Promise<void> =>\n    wrapEvent(widget, async () => {\n        const adjustments = resolveScrollAdjustments(widget);\n\n        if (!adjustments) {\n            throw new Error(\n                \"userEvent.scroll: no Gtk.ScrolledWindow or Gtk.Scrollable found on the widget or its ancestors\",\n            );\n        }\n\n        applyScrollDelta(adjustments.horizontal, delta.x ?? 0);\n        applyScrollDelta(adjustments.vertical, delta.y ?? 0);\n        await scheduleNextFrame(widget);\n    });\n\nexport { slide, scroll, type ScrollDelta };\n"]}

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

@@ -23,7 +23,8 @@ declare const getAuthoredClickGestures: (widget: Gtk.Widget) => Gtk.GestureClick
  * handler invokes: a list, grid, or column-view row is focused and selected, and activated as well
  * on a second press or when its view activates on a single click; an expandable tree expander
  * toggles its expansion, once per press, and only when it is the widget clicked, so a click on its
- * child falls through to the enclosing row; a column header sorts by its column. Sorting goes
+ * child falls through to the enclosing row; a notebook tab, clicked directly or through its label,
+ * focuses its notebook and switches to its page; a column header sorts by its column. Sorting goes
  * through Gtk.ColumnView.sortByColumn, so the primary sort column and order match what a pointer
  * produces while previously sorted columns are dropped rather than kept as secondary keys. A
  * column-view cell and the row that carries the column headers stand in the way of the click rather
@@ -36,14 +37,14 @@ declare const click: (widget: Gtk.Widget) => Promise<void>;
  * a descendant, is activated and exclusively selected, as GTK's double-click path does whether or
  * not the container activates on a single click. A widget whose click GTK4 implements itself
  * receives that outcome once per press, so a list, grid, or column-view row is selected and then
- * activated by the second press, a tree expander ends back where it started, and a column header
- * sorts and then inverts its order.
+ * activated by the second press, a tree expander ends back where it started, a notebook tab stays on
+ * the page the first press opened, and a column header sorts and then inverts its order.
  */
 declare const dblClick: (widget: Gtk.Widget) => Promise<void>;
 /**
  * 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 the presses reach, and applying the outcome GTK4
- * implements itself once per press to a row, tree expander, or column header.
+ * implements itself once per press to a row, tree expander, notebook tab, or column header.
  */
 declare const tripleClick: (widget: Gtk.Widget) => Promise<void>;
 export { clickGestures, emitClickPhase, getAuthoredClickGestures, click, dblClick, tripleClick };

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

@@ -1 +1 @@
-{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AASpC,KAAK,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AA8CzC,QAAA,MAAM,cAAc,GAChB,QAAQ,GAAG,CAAC,MAAM,EAClB,aAAa,GAAG,CAAC,YAAY,EAAE,EAC/B,QAAQ,MAAM,EACd,OAAO,UAAU,KAClB,IAEF,CAAC;AAyBF,QAAA,MAAM,aAAa,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,YAAY,EACoC,CAAC;AAEjG,QAAA,MAAM,wBAAwB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,YAAY,EACC,CAAC;AA6JzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAA,MAAM,KAAK,GAAU,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAMrD,CAAC;AAEF;;;;;;;;GAQG;AACH,QAAA,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;AAChF;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,wBAAwB,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AASpC,KAAK,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AA8CzC,QAAA,MAAM,cAAc,GAChB,QAAQ,GAAG,CAAC,MAAM,EAClB,aAAa,GAAG,CAAC,YAAY,EAAE,EAC/B,QAAQ,MAAM,EACd,OAAO,UAAU,KAClB,IAEF,CAAC;AAyBF,QAAA,MAAM,aAAa,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,YAAY,EACoC,CAAC;AAEjG,QAAA,MAAM,wBAAwB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,YAAY,EACC,CAAC;AA6JzE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,KAAK,GAAU,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAMrD,CAAC;AAEF;;;;;;;;GAQG;AACH,QAAA,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;AAChF;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,wBAAwB,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}

package/dist/user-event/click.js

@@ -179,7 +179,8 @@ const tryActivate = async (widget) => {
  * handler invokes: a list, grid, or column-view row is focused and selected, and activated as well
  * on a second press or when its view activates on a single click; an expandable tree expander
  * toggles its expansion, once per press, and only when it is the widget clicked, so a click on its
- * child falls through to the enclosing row; a column header sorts by its column. Sorting goes
+ * child falls through to the enclosing row; a notebook tab, clicked directly or through its label,
+ * focuses its notebook and switches to its page; a column header sorts by its column. Sorting goes
  * through Gtk.ColumnView.sortByColumn, so the primary sort column and order match what a pointer
  * produces while previously sorted columns are dropped rather than kept as secondary keys. A
  * column-view cell and the row that carries the column headers stand in the way of the click rather
@@ -197,14 +198,14 @@ const click = async (widget) => {
  * a descendant, is activated and exclusively selected, as GTK's double-click path does whether or
  * not the container activates on a single click. A widget whose click GTK4 implements itself
  * receives that outcome once per press, so a list, grid, or column-view row is selected and then
- * activated by the second press, a tree expander ends back where it started, and a column header
- * sorts and then inverts its order.
+ * activated by the second press, a tree expander ends back where it started, a notebook tab stays on
+ * the page the first press opened, and a column header sorts and then inverts its order.
  */
 const dblClick = (widget) => deliverClick(widget, 2);
 /**
  * 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 the presses reach, and applying the outcome GTK4
- * implements itself once per press to a row, tree expander, or column header.
+ * implements itself once per press to a row, tree expander, notebook tab, or column header.
  */
 const tripleClick = (widget) => deliverClick(widget, 3);
 export { clickGestures, emitClickPhase, getAuthoredClickGestures, click, dblClick, tripleClick };

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

@@ -1 +1 @@
-{"version":3,"file":"click.js","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gdk from \"@gtkx/gi/gdk\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { hasSignalListener } from \"@gtkx/runtime/internal\";\nimport { callBooleanGetter, getCallableMethod, hasWidgetMethod } from \"../widget-getters.js\";\nimport { queryAllControllers } from \"./controller.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\nimport { hasIndexedChildren, selectContainerChild, SELECTED_PROBE, unselectOtherChildren } from \"./indexed-children.js\";\nimport { isClickTransparent, type NativeClick, nativeClickFor } from \"./native-click.js\";\n\ntype PressPoint = { x: number; y: number };\ntype ClickPhase = \"pressed\" | \"released\";\ntype ClickSite = { gestures: Gtk.GestureClick[]; point: PressPoint };\ntype ClickScope = { isClicked: boolean; isInternalAllowed: boolean };\n\ntype ClickTarget = {\n    widget: Gtk.Widget;\n    container: Gtk.Widget | null;\n    gestures: Gtk.GestureClick[];\n    isClaiming: boolean;\n    native: NativeClick | null;\n};\n\nconst CLICK_SIGNALS = [\"pressed\", \"released\"];\nconst PRIMARY_BUTTONS: Set<number> = new Set([0, Gdk.BUTTON_PRIMARY]);\n\nconst getCenterPoint = (widget: Gtk.Widget): PressPoint => {\n    const width = widget.getWidth();\n    const height = widget.getHeight();\n\n    if (width > 0 && height > 0) {\n        return { x: width / 2, y: height / 2 };\n    }\n\n    return { x: 0, y: 0 };\n};\n\nconst getClickPoint = (clicked: Gtk.Widget, carrier: Gtk.Widget): PressPoint => {\n    if (clicked === carrier) {\n        return getCenterPoint(clicked);\n    }\n\n    const [isComputed, bounds] = clicked.computeBounds(carrier);\n\n    if (!isComputed) {\n        return getCenterPoint(carrier);\n    }\n\n    return { x: bounds.getX() + bounds.getWidth() / 2, y: bounds.getY() + bounds.getHeight() / 2 };\n};\n\nconst emitGesture = (point: PressPoint, controllers: Gtk.GestureClick[], nPress: number, signal: string): void => {\n    for (const controller of controllers) {\n        controller.emit(signal, nPress, point.x, point.y);\n    }\n};\n\nconst emitClickPhase = (\n    widget: Gtk.Widget,\n    controllers: Gtk.GestureClick[],\n    nPress: number,\n    phase: ClickPhase,\n): void => {\n    emitGesture(getCenterPoint(widget), controllers, nPress, phase);\n};\n\nconst emitSitePhase = (sites: ClickSite[], nPress: number, phase: ClickPhase): void => {\n    for (const site of sites) {\n        emitGesture(site.point, site.gestures, nPress, phase);\n    }\n};\n\nconst emitClickSequence = (sites: ClickSite[], nPress: number): void => {\n    for (let i = 1; i <= nPress; i++) {\n        emitSitePhase(sites, i, \"pressed\");\n        emitSitePhase(sites, i, \"released\");\n    }\n};\n\nconst containerFor = (widget: Gtk.Widget): Gtk.Widget | null => {\n    const parent = widget.getParent();\n\n    return parent !== null && hasWidgetMethod(widget, SELECTED_PROBE) && hasIndexedChildren(parent) ? parent : null;\n};\n\nconst hasClickHandlers = (gesture: Gtk.GestureClick): boolean => hasSignalListener(gesture, CLICK_SIGNALS);\nconst isInternalGesture = (gesture: Gtk.GestureClick): boolean => !hasSignalListener(gesture);\nconst isPrimaryGesture = (gesture: Gtk.GestureClick): boolean => PRIMARY_BUTTONS.has(gesture.getButton());\n\nconst clickGestures = (widget: Gtk.Widget): Gtk.GestureClick[] =>\n    queryAllControllers(widget, Gtk.GestureClick).filter((gesture) => isPrimaryGesture(gesture));\n\nconst getAuthoredClickGestures = (widget: Gtk.Widget): Gtk.GestureClick[] =>\n    clickGestures(widget).filter((gesture) => hasClickHandlers(gesture));\n\nconst isClaimingTarget = (widget: Gtk.Widget): boolean =>\n    widget instanceof Gtk.Button || containerFor(widget) !== null;\n\nconst gestureTargetFor = (widget: Gtk.Widget, isInternalAllowed: boolean): ClickTarget | null => {\n    const gestures = clickGestures(widget);\n\n    if (isClaimingTarget(widget)) {\n        return { widget, container: containerFor(widget), gestures, isClaiming: true, native: null };\n    }\n\n    const authored = gestures.filter((gesture) => hasClickHandlers(gesture));\n\n    if (authored.length > 0) {\n        return { widget, container: null, gestures: authored, isClaiming: false, native: null };\n    }\n\n    if (isInternalAllowed && gestures.some((gesture) => isInternalGesture(gesture))) {\n        return { widget, container: null, gestures, isClaiming: true, native: null };\n    }\n\n    return null;\n};\n\nconst clickTargetFor = (widget: Gtk.Widget, scope: ClickScope): ClickTarget | null => {\n    if (isClickTransparent(widget)) {\n        return null;\n    }\n\n    const native = nativeClickFor(widget, scope.isClicked);\n\n    if (native !== null) {\n        return { widget, container: null, gestures: getAuthoredClickGestures(widget), isClaiming: true, native };\n    }\n\n    return gestureTargetFor(widget, scope.isInternalAllowed);\n};\n\nconst isSelfClickTarget = (widget: Gtk.Widget): boolean =>\n    isClickTransparent(widget) || clickTargetFor(widget, { isClicked: true, isInternalAllowed: false }) !== null;\n\nconst nextClickWidget = (current: Gtk.Widget, target: ClickTarget | null): Gtk.Widget | null =>\n    target?.isClaiming === true ? null : current.getParent();\n\nconst collectClickTargets = (widget: Gtk.Widget): ClickTarget[] => {\n    const targets: ClickTarget[] = [];\n    let current: Gtk.Widget | null = widget;\n\n    while (current !== null) {\n        const isClicked = current === widget;\n        const scope = { isClicked, isInternalAllowed: !isClicked && targets.length === 0 };\n        const target = clickTargetFor(current, scope);\n        const next = nextClickWidget(current, target);\n\n        if (target !== null) {\n            targets.push(target);\n        }\n\n        current = next;\n    }\n\n    return targets;\n};\n\nconst targetSites = (clicked: Gtk.Widget, target: ClickTarget): ClickSite[] => {\n    const { container } = target;\n    const site = { gestures: target.gestures, point: getClickPoint(clicked, target.widget) };\n\n    if (container === null) {\n        return [site];\n    }\n\n    return [site, { gestures: getAuthoredClickGestures(container), point: getClickPoint(clicked, container) }];\n};\n\nconst isSingleClickActivating = (container: Gtk.Widget): boolean =>\n    callBooleanGetter(container, \"getActivateOnSingleClick\") ?? true;\n\nconst isMultipleSelection = (container: Gtk.Widget): boolean =>\n    getCallableMethod<[], Gtk.SelectionMode>(container, \"getSelectionMode\")?.() === Gtk.SelectionMode.MULTIPLE;\n\nconst isChildSelectable = (child: Gtk.Widget): boolean => callBooleanGetter(child, \"getSelectable\") ?? true;\n\nconst replaceContainerSelection = (container: Gtk.Widget, child: Gtk.Widget): void => {\n    if (!isChildSelectable(child)) {\n        return;\n    }\n\n    selectContainerChild(container, child);\n\n    if (isMultipleSelection(container)) {\n        unselectOtherChildren(container, child);\n    }\n};\n\nconst isActivatedByClick = (container: Gtk.Widget, nPress: number): boolean =>\n    isSingleClickActivating(container) || nPress > 1;\n\nconst isSelectionReplacedByClick = (container: Gtk.Widget, nPress: number): boolean =>\n    nPress > 1 || !isSingleClickActivating(container);\n\nconst applyContainerOutcome = (target: ClickTarget, nPress: number): void => {\n    const { container, widget } = target;\n\n    if (container === null || widget.getParent() !== container) {\n        return;\n    }\n\n    if (isActivatedByClick(container, nPress)) {\n        widget.activate();\n    }\n\n    if (isSelectionReplacedByClick(container, nPress)) {\n        replaceContainerSelection(container, widget);\n    }\n};\n\nconst applyClickOutcome = (target: ClickTarget, nPress: number): void => {\n    if (target.native === null) {\n        applyContainerOutcome(target, nPress);\n\n        return;\n    }\n\n    target.native(target.widget, nPress);\n};\n\nconst applyClickOutcomes = (targets: ClickTarget[], nPress: number): void => {\n    for (const target of targets) {\n        applyClickOutcome(target, nPress);\n    }\n};\n\nconst deliverClick = (widget: Gtk.Widget, nPress: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        const targets = collectClickTargets(widget);\n        const sites = targets.flatMap((target) => targetSites(widget, target));\n        emitClickSequence(sites, nPress);\n        applyClickOutcomes(targets, nPress);\n    });\n\n/* eslint-disable-next-line unicorn/consistent-boolean-name -- the boolean reports whether activation succeeded */\nconst tryActivate = async (widget: Gtk.Widget): Promise<boolean> => {\n    if (widget.getAccessibleRole() === Gtk.AccessibleRole.LABEL) {\n        return false;\n    }\n\n    let isActivated = false;\n\n    await wrapEvent(widget, () => {\n        isActivated = widget.activate();\n    });\n\n    return isActivated;\n};\n\n/**\n * Activates a widget that neither claims the click nor carries a click gesture of its own, and\n * otherwise delivers a press and release. The press travels outwards from the clicked widget\n * through every widget carrying a click gesture with a pressed or released handler, the way GTK\n * hands the same press to each of them, and stops at the first Gtk.Button or indexed child of a\n * list box or flow box, which claims it. A gesture GTK attached itself takes the press only when no\n * widget below it handles one, and stops it there, so an expander or a notebook tab nested in a row\n * opens instead of activating the row. Coordinates are the clicked widget's position in each\n * carrier, so a gesture the container of an indexed child carries reads the child's position rather\n * than the container's center. An indexed child that the press reaches is then activated, or\n * exclusively selected when its container does not activate on a single click. A widget with the\n * label role is never activated, but does consume the click when it carries a gesture of its own.\n *\n * The press also stops at a widget whose click GTK4 implements in C on a gesture it attached\n * itself, reading a GdkEvent that off-screen synthesis cannot produce. Gestures that widget carries\n * of its own still take the press and release, the way GTK hands them the press before its own\n * gesture claims it, and the same outcome is then applied through the public action GTK's own\n * handler invokes: a list, grid, or column-view row is focused and selected, and activated as well\n * on a second press or when its view activates on a single click; an expandable tree expander\n * toggles its expansion, once per press, and only when it is the widget clicked, so a click on its\n * child falls through to the enclosing row; a column header sorts by its column. Sorting goes\n * through Gtk.ColumnView.sortByColumn, so the primary sort column and order match what a pointer\n * produces while previously sorted columns are dropped rather than kept as secondary keys. A\n * column-view cell and the row that carries the column headers stand in the way of the click rather\n * than taking it, so a click on either reaches the row or the view behind it.\n */\nconst click = async (widget: Gtk.Widget): Promise<void> => {\n    if (!isSelfClickTarget(widget) && (await tryActivate(widget))) {\n        return;\n    }\n\n    await deliverClick(widget, 1);\n};\n\n/**\n * Delivers a two-press click gesture the way {@link click} delivers a single press, without trying\n * activation first. A list box row or flow box child the presses reach, clicked directly or through\n * a descendant, is activated and exclusively selected, as GTK's double-click path does whether or\n * not the container activates on a single click. A widget whose click GTK4 implements itself\n * receives that outcome once per press, so a list, grid, or column-view row is selected and then\n * activated by the second press, a tree expander ends back where it started, and a column header\n * sorts and then inverts its order.\n */\nconst dblClick = (widget: Gtk.Widget): Promise<void> => deliverClick(widget, 2);\n/**\n * Delivers a three-press click gesture the same way a double click is delivered, applying the same\n * outcome to a list box row or flow box child the presses reach, and applying the outcome GTK4\n * implements itself once per press to a row, tree expander, or column header.\n */\nconst tripleClick = (widget: Gtk.Widget): Promise<void> => deliverClick(widget, 3);\n\nexport { clickGestures, emitClickPhase, getAuthoredClickGestures, click, dblClick, tripleClick };\n"]}
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../src/user-event/click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACxH,OAAO,EAAE,kBAAkB,EAAoB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAezF,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAC9C,MAAM,eAAe,GAAgB,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAEtE,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAc,EAAE;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAElC,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,OAAmB,EAAE,OAAmB,EAAc,EAAE;IAC3E,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAE5D,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;AACnG,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAE,WAA+B,EAAE,MAAc,EAAE,MAAc,EAAQ,EAAE;IAC7G,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACnC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACnB,MAAkB,EAClB,WAA+B,EAC/B,MAAc,EACd,KAAiB,EACb,EAAE;IACN,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAkB,EAAE,MAAc,EAAE,KAAiB,EAAQ,EAAE;IAClF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAAkB,EAAE,MAAc,EAAQ,EAAE;IACnE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACnC,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAqB,EAAE;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAElC,OAAO,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,OAAyB,EAAW,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC3G,MAAM,iBAAiB,GAAG,CAAC,OAAyB,EAAW,EAAE,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC9F,MAAM,gBAAgB,GAAG,CAAC,OAAyB,EAAW,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;AAE1G,MAAM,aAAa,GAAG,CAAC,MAAkB,EAAsB,EAAE,CAC7D,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAEjG,MAAM,wBAAwB,GAAG,CAAC,MAAkB,EAAsB,EAAE,CACxE,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAEzE,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAAW,EAAE,CACrD,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AAElE,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAAE,iBAA0B,EAAsB,EAAE;IAC5F,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjG,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC5F,CAAC;IAED,IAAI,iBAAiB,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjF,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,KAAiB,EAAsB,EAAE;IACjF,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAEvD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,wBAAwB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7G,CAAC;IAED,OAAO,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,MAAkB,EAAW,EAAE,CACtD,kBAAkB,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEjH,MAAM,eAAe,GAAG,CAAC,OAAmB,EAAE,MAA0B,EAAqB,EAAE,CAC3F,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;AAE7D,MAAM,mBAAmB,GAAG,CAAC,MAAkB,EAAiB,EAAE;IAC9D,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,IAAI,OAAO,GAAsB,MAAM,CAAC;IAExC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,OAAO,KAAK,MAAM,CAAC;QACrC,MAAM,KAAK,GAAG,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE9C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAAmB,EAAE,MAAmB,EAAe,EAAE;IAC1E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC7B,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAEzF,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,wBAAwB,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;AAC/G,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,SAAqB,EAAW,EAAE,CAC/D,iBAAiB,CAAC,SAAS,EAAE,0BAA0B,CAAC,IAAI,IAAI,CAAC;AAErE,MAAM,mBAAmB,GAAG,CAAC,SAAqB,EAAW,EAAE,CAC3D,iBAAiB,CAAwB,SAAS,EAAE,kBAAkB,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC;AAE/G,MAAM,iBAAiB,GAAG,CAAC,KAAiB,EAAW,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,eAAe,CAAC,IAAI,IAAI,CAAC;AAE5G,MAAM,yBAAyB,GAAG,CAAC,SAAqB,EAAE,KAAiB,EAAQ,EAAE;IACjF,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACX,CAAC;IAED,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAEvC,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,SAAqB,EAAE,MAAc,EAAW,EAAE,CAC1E,uBAAuB,CAAC,SAAS,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AAErD,MAAM,0BAA0B,GAAG,CAAC,SAAqB,EAAE,MAAc,EAAW,EAAE,CAClF,MAAM,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAEtD,MAAM,qBAAqB,GAAG,CAAC,MAAmB,EAAE,MAAc,EAAQ,EAAE;IACxE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAErC,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO;IACX,CAAC;IAED,IAAI,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;QAChD,yBAAyB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,MAAmB,EAAE,MAAc,EAAQ,EAAE;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACzB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO;IACX,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,OAAsB,EAAE,MAAc,EAAQ,EAAE;IACxE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAE,MAAc,EAAiB,EAAE,CACvE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvE,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEP,kHAAkH;AAClH,MAAM,WAAW,GAAG,KAAK,EAAE,MAAkB,EAAoB,EAAE;IAC/D,IAAI,MAAM,CAAC,iBAAiB,EAAE,KAAK,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,MAAM,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;QACzB,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,KAAK,GAAG,KAAK,EAAE,MAAkB,EAAiB,EAAE;IACtD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO;IACX,CAAC;IAED,MAAM,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,QAAQ,GAAG,CAAC,MAAkB,EAAiB,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAChF;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAiB,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,wBAAwB,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC","sourcesContent":["import * as Gdk from \"@gtkx/gi/gdk\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { hasSignalListener } from \"@gtkx/runtime/internal\";\nimport { callBooleanGetter, getCallableMethod, hasWidgetMethod } from \"../widget-getters.js\";\nimport { queryAllControllers } from \"./controller.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\nimport { hasIndexedChildren, selectContainerChild, SELECTED_PROBE, unselectOtherChildren } from \"./indexed-children.js\";\nimport { isClickTransparent, type NativeClick, nativeClickFor } from \"./native-click.js\";\n\ntype PressPoint = { x: number; y: number };\ntype ClickPhase = \"pressed\" | \"released\";\ntype ClickSite = { gestures: Gtk.GestureClick[]; point: PressPoint };\ntype ClickScope = { isClicked: boolean; isInternalAllowed: boolean };\n\ntype ClickTarget = {\n    widget: Gtk.Widget;\n    container: Gtk.Widget | null;\n    gestures: Gtk.GestureClick[];\n    isClaiming: boolean;\n    native: NativeClick | null;\n};\n\nconst CLICK_SIGNALS = [\"pressed\", \"released\"];\nconst PRIMARY_BUTTONS: Set<number> = new Set([0, Gdk.BUTTON_PRIMARY]);\n\nconst getCenterPoint = (widget: Gtk.Widget): PressPoint => {\n    const width = widget.getWidth();\n    const height = widget.getHeight();\n\n    if (width > 0 && height > 0) {\n        return { x: width / 2, y: height / 2 };\n    }\n\n    return { x: 0, y: 0 };\n};\n\nconst getClickPoint = (clicked: Gtk.Widget, carrier: Gtk.Widget): PressPoint => {\n    if (clicked === carrier) {\n        return getCenterPoint(clicked);\n    }\n\n    const [isComputed, bounds] = clicked.computeBounds(carrier);\n\n    if (!isComputed) {\n        return getCenterPoint(carrier);\n    }\n\n    return { x: bounds.getX() + bounds.getWidth() / 2, y: bounds.getY() + bounds.getHeight() / 2 };\n};\n\nconst emitGesture = (point: PressPoint, controllers: Gtk.GestureClick[], nPress: number, signal: string): void => {\n    for (const controller of controllers) {\n        controller.emit(signal, nPress, point.x, point.y);\n    }\n};\n\nconst emitClickPhase = (\n    widget: Gtk.Widget,\n    controllers: Gtk.GestureClick[],\n    nPress: number,\n    phase: ClickPhase,\n): void => {\n    emitGesture(getCenterPoint(widget), controllers, nPress, phase);\n};\n\nconst emitSitePhase = (sites: ClickSite[], nPress: number, phase: ClickPhase): void => {\n    for (const site of sites) {\n        emitGesture(site.point, site.gestures, nPress, phase);\n    }\n};\n\nconst emitClickSequence = (sites: ClickSite[], nPress: number): void => {\n    for (let i = 1; i <= nPress; i++) {\n        emitSitePhase(sites, i, \"pressed\");\n        emitSitePhase(sites, i, \"released\");\n    }\n};\n\nconst containerFor = (widget: Gtk.Widget): Gtk.Widget | null => {\n    const parent = widget.getParent();\n\n    return parent !== null && hasWidgetMethod(widget, SELECTED_PROBE) && hasIndexedChildren(parent) ? parent : null;\n};\n\nconst hasClickHandlers = (gesture: Gtk.GestureClick): boolean => hasSignalListener(gesture, CLICK_SIGNALS);\nconst isInternalGesture = (gesture: Gtk.GestureClick): boolean => !hasSignalListener(gesture);\nconst isPrimaryGesture = (gesture: Gtk.GestureClick): boolean => PRIMARY_BUTTONS.has(gesture.getButton());\n\nconst clickGestures = (widget: Gtk.Widget): Gtk.GestureClick[] =>\n    queryAllControllers(widget, Gtk.GestureClick).filter((gesture) => isPrimaryGesture(gesture));\n\nconst getAuthoredClickGestures = (widget: Gtk.Widget): Gtk.GestureClick[] =>\n    clickGestures(widget).filter((gesture) => hasClickHandlers(gesture));\n\nconst isClaimingTarget = (widget: Gtk.Widget): boolean =>\n    widget instanceof Gtk.Button || containerFor(widget) !== null;\n\nconst gestureTargetFor = (widget: Gtk.Widget, isInternalAllowed: boolean): ClickTarget | null => {\n    const gestures = clickGestures(widget);\n\n    if (isClaimingTarget(widget)) {\n        return { widget, container: containerFor(widget), gestures, isClaiming: true, native: null };\n    }\n\n    const authored = gestures.filter((gesture) => hasClickHandlers(gesture));\n\n    if (authored.length > 0) {\n        return { widget, container: null, gestures: authored, isClaiming: false, native: null };\n    }\n\n    if (isInternalAllowed && gestures.some((gesture) => isInternalGesture(gesture))) {\n        return { widget, container: null, gestures, isClaiming: true, native: null };\n    }\n\n    return null;\n};\n\nconst clickTargetFor = (widget: Gtk.Widget, scope: ClickScope): ClickTarget | null => {\n    if (isClickTransparent(widget)) {\n        return null;\n    }\n\n    const native = nativeClickFor(widget, scope.isClicked);\n\n    if (native !== null) {\n        return { widget, container: null, gestures: getAuthoredClickGestures(widget), isClaiming: true, native };\n    }\n\n    return gestureTargetFor(widget, scope.isInternalAllowed);\n};\n\nconst isSelfClickTarget = (widget: Gtk.Widget): boolean =>\n    isClickTransparent(widget) || clickTargetFor(widget, { isClicked: true, isInternalAllowed: false }) !== null;\n\nconst nextClickWidget = (current: Gtk.Widget, target: ClickTarget | null): Gtk.Widget | null =>\n    target?.isClaiming === true ? null : current.getParent();\n\nconst collectClickTargets = (widget: Gtk.Widget): ClickTarget[] => {\n    const targets: ClickTarget[] = [];\n    let current: Gtk.Widget | null = widget;\n\n    while (current !== null) {\n        const isClicked = current === widget;\n        const scope = { isClicked, isInternalAllowed: !isClicked && targets.length === 0 };\n        const target = clickTargetFor(current, scope);\n        const next = nextClickWidget(current, target);\n\n        if (target !== null) {\n            targets.push(target);\n        }\n\n        current = next;\n    }\n\n    return targets;\n};\n\nconst targetSites = (clicked: Gtk.Widget, target: ClickTarget): ClickSite[] => {\n    const { container } = target;\n    const site = { gestures: target.gestures, point: getClickPoint(clicked, target.widget) };\n\n    if (container === null) {\n        return [site];\n    }\n\n    return [site, { gestures: getAuthoredClickGestures(container), point: getClickPoint(clicked, container) }];\n};\n\nconst isSingleClickActivating = (container: Gtk.Widget): boolean =>\n    callBooleanGetter(container, \"getActivateOnSingleClick\") ?? true;\n\nconst isMultipleSelection = (container: Gtk.Widget): boolean =>\n    getCallableMethod<[], Gtk.SelectionMode>(container, \"getSelectionMode\")?.() === Gtk.SelectionMode.MULTIPLE;\n\nconst isChildSelectable = (child: Gtk.Widget): boolean => callBooleanGetter(child, \"getSelectable\") ?? true;\n\nconst replaceContainerSelection = (container: Gtk.Widget, child: Gtk.Widget): void => {\n    if (!isChildSelectable(child)) {\n        return;\n    }\n\n    selectContainerChild(container, child);\n\n    if (isMultipleSelection(container)) {\n        unselectOtherChildren(container, child);\n    }\n};\n\nconst isActivatedByClick = (container: Gtk.Widget, nPress: number): boolean =>\n    isSingleClickActivating(container) || nPress > 1;\n\nconst isSelectionReplacedByClick = (container: Gtk.Widget, nPress: number): boolean =>\n    nPress > 1 || !isSingleClickActivating(container);\n\nconst applyContainerOutcome = (target: ClickTarget, nPress: number): void => {\n    const { container, widget } = target;\n\n    if (container === null || widget.getParent() !== container) {\n        return;\n    }\n\n    if (isActivatedByClick(container, nPress)) {\n        widget.activate();\n    }\n\n    if (isSelectionReplacedByClick(container, nPress)) {\n        replaceContainerSelection(container, widget);\n    }\n};\n\nconst applyClickOutcome = (target: ClickTarget, nPress: number): void => {\n    if (target.native === null) {\n        applyContainerOutcome(target, nPress);\n\n        return;\n    }\n\n    target.native(target.widget, nPress);\n};\n\nconst applyClickOutcomes = (targets: ClickTarget[], nPress: number): void => {\n    for (const target of targets) {\n        applyClickOutcome(target, nPress);\n    }\n};\n\nconst deliverClick = (widget: Gtk.Widget, nPress: number): Promise<void> =>\n    wrapEvent(widget, () => {\n        const targets = collectClickTargets(widget);\n        const sites = targets.flatMap((target) => targetSites(widget, target));\n        emitClickSequence(sites, nPress);\n        applyClickOutcomes(targets, nPress);\n    });\n\n/* eslint-disable-next-line unicorn/consistent-boolean-name -- the boolean reports whether activation succeeded */\nconst tryActivate = async (widget: Gtk.Widget): Promise<boolean> => {\n    if (widget.getAccessibleRole() === Gtk.AccessibleRole.LABEL) {\n        return false;\n    }\n\n    let isActivated = false;\n\n    await wrapEvent(widget, () => {\n        isActivated = widget.activate();\n    });\n\n    return isActivated;\n};\n\n/**\n * Activates a widget that neither claims the click nor carries a click gesture of its own, and\n * otherwise delivers a press and release. The press travels outwards from the clicked widget\n * through every widget carrying a click gesture with a pressed or released handler, the way GTK\n * hands the same press to each of them, and stops at the first Gtk.Button or indexed child of a\n * list box or flow box, which claims it. A gesture GTK attached itself takes the press only when no\n * widget below it handles one, and stops it there, so an expander or a notebook tab nested in a row\n * opens instead of activating the row. Coordinates are the clicked widget's position in each\n * carrier, so a gesture the container of an indexed child carries reads the child's position rather\n * than the container's center. An indexed child that the press reaches is then activated, or\n * exclusively selected when its container does not activate on a single click. A widget with the\n * label role is never activated, but does consume the click when it carries a gesture of its own.\n *\n * The press also stops at a widget whose click GTK4 implements in C on a gesture it attached\n * itself, reading a GdkEvent that off-screen synthesis cannot produce. Gestures that widget carries\n * of its own still take the press and release, the way GTK hands them the press before its own\n * gesture claims it, and the same outcome is then applied through the public action GTK's own\n * handler invokes: a list, grid, or column-view row is focused and selected, and activated as well\n * on a second press or when its view activates on a single click; an expandable tree expander\n * toggles its expansion, once per press, and only when it is the widget clicked, so a click on its\n * child falls through to the enclosing row; a notebook tab, clicked directly or through its label,\n * focuses its notebook and switches to its page; a column header sorts by its column. Sorting goes\n * through Gtk.ColumnView.sortByColumn, so the primary sort column and order match what a pointer\n * produces while previously sorted columns are dropped rather than kept as secondary keys. A\n * column-view cell and the row that carries the column headers stand in the way of the click rather\n * than taking it, so a click on either reaches the row or the view behind it.\n */\nconst click = async (widget: Gtk.Widget): Promise<void> => {\n    if (!isSelfClickTarget(widget) && (await tryActivate(widget))) {\n        return;\n    }\n\n    await deliverClick(widget, 1);\n};\n\n/**\n * Delivers a two-press click gesture the way {@link click} delivers a single press, without trying\n * activation first. A list box row or flow box child the presses reach, clicked directly or through\n * a descendant, is activated and exclusively selected, as GTK's double-click path does whether or\n * not the container activates on a single click. A widget whose click GTK4 implements itself\n * receives that outcome once per press, so a list, grid, or column-view row is selected and then\n * activated by the second press, a tree expander ends back where it started, a notebook tab stays on\n * the page the first press opened, and a column header sorts and then inverts its order.\n */\nconst dblClick = (widget: Gtk.Widget): Promise<void> => deliverClick(widget, 2);\n/**\n * Delivers a three-press click gesture the same way a double click is delivered, applying the same\n * outcome to a list box row or flow box child the presses reach, and applying the outcome GTK4\n * implements itself once per press to a row, tree expander, notebook tab, or column header.\n */\nconst tripleClick = (widget: Gtk.Widget): Promise<void> => deliverClick(widget, 3);\n\nexport { clickGestures, emitClickPhase, getAuthoredClickGestures, click, dblClick, tripleClick };\n"]}

package/dist/user-event/column-header-click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-header-click.d.ts","sourceRoot":"","sources":["../../src/user-event/column-header-click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AA4EpC,QAAA,MAAM,gBAAgB,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,KAAG,IAW9D,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"column-header-click.d.ts","sourceRoot":"","sources":["../../src/user-event/column-header-click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AA8DpC,QAAA,MAAM,gBAAgB,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,MAAM,KAAG,IAW9D,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/user-event/column-header-click.js

@@ -1,16 +1,6 @@
 import * as Gtk from "@gtkx/gi/gtk";
-import { children } from "../traversal.js";
+import { ancestorFor, children } from "../traversal.js";
 import { getWidgetTextContent } from "../widget-accessible-properties.js";
-const columnViewFor = (header) => {
-    let current = header.getParent();
-    while (current !== null) {
-        if (current instanceof Gtk.ColumnView) {
-            return current;
-        }
-        current = current.getParent();
-    }
-    return null;
-};
 const columnsFor = (view) => {
     const model = view.getColumns();
     const columns = [];
@@ -52,7 +42,7 @@ const nextSortDirection = (view, column) => {
     return invertedSortDirection(sorter.getPrimarySortOrder());
 };
 const applyHeaderClick = (header, nPress) => {
-    const view = columnViewFor(header);
+    const view = ancestorFor(header, Gtk.ColumnView);
     const column = view === null ? null : sortableColumnFor(header, view);
     if (view === null || column === null) {
         return;

package/dist/user-event/column-header-click.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-header-click.js","sourceRoot":"","sources":["../../src/user-event/column-header-click.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { children } from \"../traversal.js\";\nimport { getWidgetTextContent } from \"../widget-accessible-properties.js\";\n\nconst columnViewFor = (header: Gtk.Widget): Gtk.ColumnView | null => {\n    let current: Gtk.Widget | null = header.getParent();\n\n    while (current !== null) {\n        if (current instanceof Gtk.ColumnView) {\n            return current;\n        }\n\n        current = current.getParent();\n    }\n\n    return null;\n};\n\nconst columnsFor = (view: Gtk.ColumnView): Gtk.ColumnViewColumn[] => {\n    const model = view.getColumns();\n    const columns: Gtk.ColumnViewColumn[] = [];\n\n    for (let index = 0; index < model.getNItems(); index++) {\n        const column = model.getItem(index);\n\n        if (column instanceof Gtk.ColumnViewColumn) {\n            columns.push(column);\n        }\n    }\n\n    return columns;\n};\n\nconst headerIndexFor = (header: Gtk.Widget): number => {\n    const parent = header.getParent();\n\n    return parent === null ? -1 : [...children(parent)].indexOf(header);\n};\n\nconst titledColumnFor = (columns: Gtk.ColumnViewColumn[], title: string | null): Gtk.ColumnViewColumn | null => {\n    const matches = columns.filter((column) => column.getTitle() === title);\n\n    return matches.length === 1 ? matches[0] ?? null : null;\n};\n\nconst columnFor = (header: Gtk.Widget, view: Gtk.ColumnView): Gtk.ColumnViewColumn | null => {\n    const columns = columnsFor(view);\n    const picked = columns[headerIndexFor(header)] ?? null;\n    const title = getWidgetTextContent(header);\n\n    if (picked !== null && picked.getTitle() === title) {\n        return picked;\n    }\n\n    return titledColumnFor(columns, title) ?? picked;\n};\n\nconst sortableColumnFor = (header: Gtk.Widget, view: Gtk.ColumnView): Gtk.ColumnViewColumn | null => {\n    const column = columnFor(header, view);\n\n    return column !== null && column.getSorter() !== null ? column : null;\n};\n\nconst invertedSortDirection = (order: Gtk.SortType): Gtk.SortType =>\n    order === Gtk.SortType.ASCENDING ? Gtk.SortType.DESCENDING : Gtk.SortType.ASCENDING;\n\nconst nextSortDirection = (view: Gtk.ColumnView, column: Gtk.ColumnViewColumn): Gtk.SortType => {\n    const sorter = view.getSorter();\n\n    if (!(sorter instanceof Gtk.ColumnViewSorter) || sorter.getPrimarySortColumn() !== column) {\n        return Gtk.SortType.ASCENDING;\n    }\n\n    return invertedSortDirection(sorter.getPrimarySortOrder());\n};\n\nconst applyHeaderClick = (header: Gtk.Widget, nPress: number): void => {\n    const view = columnViewFor(header);\n    const column = view === null ? null : sortableColumnFor(header, view);\n\n    if (view === null || column === null) {\n        return;\n    }\n\n    for (let press = 1; press <= nPress; press++) {\n        view.sortByColumn(column, nextSortDirection(view, column));\n    }\n};\n\nexport { applyHeaderClick };\n"]}
+{"version":3,"file":"column-header-click.js","sourceRoot":"","sources":["../../src/user-event/column-header-click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,MAAM,UAAU,GAAG,CAAC,IAAoB,EAA0B,EAAE;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAChC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEpC,IAAI,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAU,EAAE;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAElC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,OAA+B,EAAE,KAAoB,EAA+B,EAAE;IAC3G,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,KAAK,CAAC,CAAC;IAExE,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,MAAkB,EAAE,IAAoB,EAA+B,EAAE;IACxF,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC;IACvD,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE3C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,KAAK,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,MAAkB,EAAE,IAAoB,EAA+B,EAAE;IAChG,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEvC,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,KAAmB,EAAgB,EAAE,CAChE,KAAK,KAAK,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;AAExF,MAAM,iBAAiB,GAAG,CAAC,IAAoB,EAAE,MAA4B,EAAgB,EAAE;IAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAEhC,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,oBAAoB,EAAE,KAAK,MAAM,EAAE,CAAC;QACxF,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,OAAO,qBAAqB,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC/D,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAAE,MAAc,EAAQ,EAAE;IAClE,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEtE,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO;IACX,CAAC;IAED,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { ancestorFor, children } from \"../traversal.js\";\nimport { getWidgetTextContent } from \"../widget-accessible-properties.js\";\n\nconst columnsFor = (view: Gtk.ColumnView): Gtk.ColumnViewColumn[] => {\n    const model = view.getColumns();\n    const columns: Gtk.ColumnViewColumn[] = [];\n\n    for (let index = 0; index < model.getNItems(); index++) {\n        const column = model.getItem(index);\n\n        if (column instanceof Gtk.ColumnViewColumn) {\n            columns.push(column);\n        }\n    }\n\n    return columns;\n};\n\nconst headerIndexFor = (header: Gtk.Widget): number => {\n    const parent = header.getParent();\n\n    return parent === null ? -1 : [...children(parent)].indexOf(header);\n};\n\nconst titledColumnFor = (columns: Gtk.ColumnViewColumn[], title: string | null): Gtk.ColumnViewColumn | null => {\n    const matches = columns.filter((column) => column.getTitle() === title);\n\n    return matches.length === 1 ? matches[0] ?? null : null;\n};\n\nconst columnFor = (header: Gtk.Widget, view: Gtk.ColumnView): Gtk.ColumnViewColumn | null => {\n    const columns = columnsFor(view);\n    const picked = columns[headerIndexFor(header)] ?? null;\n    const title = getWidgetTextContent(header);\n\n    if (picked !== null && picked.getTitle() === title) {\n        return picked;\n    }\n\n    return titledColumnFor(columns, title) ?? picked;\n};\n\nconst sortableColumnFor = (header: Gtk.Widget, view: Gtk.ColumnView): Gtk.ColumnViewColumn | null => {\n    const column = columnFor(header, view);\n\n    return column !== null && column.getSorter() !== null ? column : null;\n};\n\nconst invertedSortDirection = (order: Gtk.SortType): Gtk.SortType =>\n    order === Gtk.SortType.ASCENDING ? Gtk.SortType.DESCENDING : Gtk.SortType.ASCENDING;\n\nconst nextSortDirection = (view: Gtk.ColumnView, column: Gtk.ColumnViewColumn): Gtk.SortType => {\n    const sorter = view.getSorter();\n\n    if (!(sorter instanceof Gtk.ColumnViewSorter) || sorter.getPrimarySortColumn() !== column) {\n        return Gtk.SortType.ASCENDING;\n    }\n\n    return invertedSortDirection(sorter.getPrimarySortOrder());\n};\n\nconst applyHeaderClick = (header: Gtk.Widget, nPress: number): void => {\n    const view = ancestorFor(header, Gtk.ColumnView);\n    const column = view === null ? null : sortableColumnFor(header, view);\n\n    if (view === null || column === null) {\n        return;\n    }\n\n    for (let press = 1; press <= nPress; press++) {\n        view.sortByColumn(column, nextSortDirection(view, column));\n    }\n};\n\nexport { applyHeaderClick };\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"event-wrapper.d.ts","sourceRoot":"","sources":["../../src/user-event/event-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAyEpC,QAAA,MAAM,SAAS,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,IAAI,CAM/F,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"event-wrapper.d.ts","sourceRoot":"","sources":["../../src/user-event/event-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAyFpC,QAAA,MAAM,SAAS,GAAU,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,IAAI,CAM/F,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/user-event/event-wrapper.js

@@ -2,47 +2,60 @@ import * as Gtk from "@gtkx/gi/gtk";
 import { runInAct } from "../act.js";
 import { getConfig } from "../config.js";
 import { formatRole } from "../role-helpers.js";
+import { delay, now } from "../timers.js";
+import { getWidgetAccessibleName } from "../widget-accessible-properties.js";
+import { getTypeTag, isDefaultWidgetName } from "../widget-getters.js";
+import { isWindowAllocated, isWindowBlockedByModal } from "../window-state.js";
 const NOT_SENSITIVE = "it is not sensitive (the widget or one of its ancestors is disabled)";
+const NOT_ROOTED = "it is not inside a toplevel (it was removed from the widget tree, or was never added to one)";
+const WINDOW_NOT_VISIBLE = "its window is not visible (it was hidden, or it was never shown)";
 const WINDOW_NOT_ALLOCATED = "its window has not been allocated a size";
 const NOT_MAPPED = "it is not mapped (it is not shown on screen, e.g. it is hidden or on a non-visible page)";
-const WINDOW_NOT_ACTIVE = "its window never became active";
-const actionableHop = () => new Promise((resolve) => setTimeout(resolve, 1));
-const canDisplayDeliverActivation = (window) => window.getDisplay().getDefaultSeat() !== null;
-const findWindowActionabilityFailure = (widget, root) => {
-    const [isComputed, allocation] = root.computeBounds(root);
-    if (!isComputed || allocation.getWidth() === 0) {
-        return WINDOW_NOT_ALLOCATED;
+const BLOCKED_BY_MODAL = "its window is blocked by a modal window holding the grab";
+const ACTIONABLE_HOP_MS = 1;
+const findWindowActionabilityFailure = (window) => {
+    if (!window.getVisible()) {
+        return WINDOW_NOT_VISIBLE;
     }
-    if (!widget.getMapped()) {
-        return NOT_MAPPED;
+    if (!isWindowAllocated(window)) {
+        return WINDOW_NOT_ALLOCATED;
     }
-    if (canDisplayDeliverActivation(root) && !root.isActive()) {
-        return WINDOW_NOT_ACTIVE;
+    if (isWindowBlockedByModal(window)) {
+        return BLOCKED_BY_MODAL;
     }
     return null;
 };
+const findRootActionabilityFailure = (root) => root instanceof Gtk.Window ? findWindowActionabilityFailure(root) : null;
 const findActionabilityFailure = (widget) => {
     if (!widget.isSensitive()) {
         return NOT_SENSITIVE;
     }
     const root = widget.getRoot();
-    if (!(root instanceof Gtk.Window) || !root.getVisible()) {
-        return null;
+    if (root === null) {
+        return NOT_ROOTED;
+    }
+    const rootFailure = findRootActionabilityFailure(root);
+    if (rootFailure !== null) {
+        return rootFailure;
     }
-    return findWindowActionabilityFailure(widget, root);
+    return widget.getMapped() ? null : NOT_MAPPED;
 };
-const describeWidget = (widget) => {
-    const tag = widget.constructor.name;
+const attribute = (key, value) => (value === null ? "" : ` ${key}="${value}"`);
+const widgetNameAttribute = (widget) => {
     const name = widget.getName();
-    const nameAttribute = name && !name.endsWith(tag) ? ` name="${name}"` : "";
-    return `<${tag}${nameAttribute} role="${formatRole(widget.getAccessibleRole())}">`;
+    return attribute("name", isDefaultWidgetName(widget, name) ? null : name);
+};
+const describeWidget = (widget) => {
+    const accessibleName = attribute("accessible-name", getWidgetAccessibleName(widget));
+    const role = attribute("role", formatRole(widget.getAccessibleRole()));
+    return `<${getTypeTag(widget)}${accessibleName}${widgetNameAttribute(widget)}${role}>`;
 };
 const waitForActionable = async (widget) => {
     const timeout = getConfig().actionabilityTimeout;
-    const deadline = Date.now() + timeout;
+    const deadline = now() + timeout;
     let failure = findActionabilityFailure(widget);
-    while (failure !== null && Date.now() < deadline) {
-        await actionableHop();
+    while (failure !== null && now() < deadline) {
+        await delay(ACTIONABLE_HOP_MS);
         failure = findActionabilityFailure(widget);
     }
     if (failure !== null) {

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

@@ -1 +1 @@
-{"version":3,"file":"event-wrapper.js","sourceRoot":"","sources":["../../src/user-event/event-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { runInAct } from \"../act.js\";\nimport { getConfig } from \"../config.js\";\nimport { formatRole } from \"../role-helpers.js\";\n\nconst NOT_SENSITIVE = \"it is not sensitive (the widget or one of its ancestors is disabled)\";\nconst WINDOW_NOT_ALLOCATED = \"its window has not been allocated a size\";\nconst NOT_MAPPED = \"it is not mapped (it is not shown on screen, e.g. it is hidden or on a non-visible page)\";\nconst WINDOW_NOT_ACTIVE = \"its window never became active\";\n\nconst actionableHop = (): Promise<void> => new Promise((resolve) => setTimeout(resolve, 1));\n\nconst canDisplayDeliverActivation = (window: Gtk.Window): boolean =>\n    window.getDisplay().getDefaultSeat() !== null;\n\nconst findWindowActionabilityFailure = (widget: Gtk.Widget, root: Gtk.Window): string | null => {\n    const [isComputed, allocation] = root.computeBounds(root);\n\n    if (!isComputed || allocation.getWidth() === 0) {\n        return WINDOW_NOT_ALLOCATED;\n    }\n\n    if (!widget.getMapped()) {\n        return NOT_MAPPED;\n    }\n\n    if (canDisplayDeliverActivation(root) && !root.isActive()) {\n        return WINDOW_NOT_ACTIVE;\n    }\n\n    return null;\n};\n\nconst findActionabilityFailure = (widget: Gtk.Widget): string | null => {\n    if (!widget.isSensitive()) {\n        return NOT_SENSITIVE;\n    }\n\n    const root = widget.getRoot();\n\n    if (!(root instanceof Gtk.Window) || !root.getVisible()) {\n        return null;\n    }\n\n    return findWindowActionabilityFailure(widget, root);\n};\n\nconst describeWidget = (widget: Gtk.Widget): string => {\n    const tag = widget.constructor.name;\n    const name = widget.getName();\n    const nameAttribute = name && !name.endsWith(tag) ? ` name=\"${name}\"` : \"\";\n\n    return `<${tag}${nameAttribute} role=\"${formatRole(widget.getAccessibleRole())}\">`;\n};\n\nconst waitForActionable = async (widget: Gtk.Widget): Promise<void> => {\n    const timeout = getConfig().actionabilityTimeout;\n    const deadline = Date.now() + timeout;\n    let failure = findActionabilityFailure(widget);\n\n    while (failure !== null && Date.now() < deadline) {\n        await actionableHop();\n        failure = findActionabilityFailure(widget);\n    }\n\n    if (failure !== null) {\n        throw new Error(\n            `Cannot dispatch user event: ${describeWidget(widget)} did not become actionable ` +\n            `within ${String(timeout)}ms because ${failure}`,\n        );\n    }\n};\n\nconst wrapEvent = async (widget: Gtk.Widget, body: () => void | PromiseLike<void>): Promise<void> => {\n    await waitForActionable(widget);\n\n    await runInAct(async () => {\n        await body();\n    });\n};\n\nexport { wrapEvent };\n"]}
+{"version":3,"file":"event-wrapper.js","sourceRoot":"","sources":["../../src/user-event/event-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { runInAct } from \"../act.js\";\nimport { getConfig } from \"../config.js\";\nimport { formatRole } from \"../role-helpers.js\";\nimport { delay, now } from \"../timers.js\";\nimport { getWidgetAccessibleName } from \"../widget-accessible-properties.js\";\nimport { getTypeTag, isDefaultWidgetName } from \"../widget-getters.js\";\nimport { isWindowAllocated, isWindowBlockedByModal } from \"../window-state.js\";\n\nconst NOT_SENSITIVE = \"it is not sensitive (the widget or one of its ancestors is disabled)\";\nconst NOT_ROOTED = \"it is not inside a toplevel (it was removed from the widget tree, or was never added to one)\";\nconst WINDOW_NOT_VISIBLE = \"its window is not visible (it was hidden, or it was never shown)\";\nconst WINDOW_NOT_ALLOCATED = \"its window has not been allocated a size\";\nconst NOT_MAPPED = \"it is not mapped (it is not shown on screen, e.g. it is hidden or on a non-visible page)\";\nconst BLOCKED_BY_MODAL = \"its window is blocked by a modal window holding the grab\";\nconst ACTIONABLE_HOP_MS = 1;\n\nconst findWindowActionabilityFailure = (window: Gtk.Window): string | null => {\n    if (!window.getVisible()) {\n        return WINDOW_NOT_VISIBLE;\n    }\n\n    if (!isWindowAllocated(window)) {\n        return WINDOW_NOT_ALLOCATED;\n    }\n\n    if (isWindowBlockedByModal(window)) {\n        return BLOCKED_BY_MODAL;\n    }\n\n    return null;\n};\n\nconst findRootActionabilityFailure = (root: Gtk.Root): string | null =>\n    root instanceof Gtk.Window ? findWindowActionabilityFailure(root) : null;\n\nconst findActionabilityFailure = (widget: Gtk.Widget): string | null => {\n    if (!widget.isSensitive()) {\n        return NOT_SENSITIVE;\n    }\n\n    const root = widget.getRoot();\n\n    if (root === null) {\n        return NOT_ROOTED;\n    }\n\n    const rootFailure = findRootActionabilityFailure(root);\n\n    if (rootFailure !== null) {\n        return rootFailure;\n    }\n\n    return widget.getMapped() ? null : NOT_MAPPED;\n};\n\nconst attribute = (key: string, value: string | null): string => (value === null ? \"\" : ` ${key}=\"${value}\"`);\n\nconst widgetNameAttribute = (widget: Gtk.Widget): string => {\n    const name = widget.getName();\n\n    return attribute(\"name\", isDefaultWidgetName(widget, name) ? null : name);\n};\n\nconst describeWidget = (widget: Gtk.Widget): string => {\n    const accessibleName = attribute(\"accessible-name\", getWidgetAccessibleName(widget));\n    const role = attribute(\"role\", formatRole(widget.getAccessibleRole()));\n\n    return `<${getTypeTag(widget)}${accessibleName}${widgetNameAttribute(widget)}${role}>`;\n};\n\nconst waitForActionable = async (widget: Gtk.Widget): Promise<void> => {\n    const timeout = getConfig().actionabilityTimeout;\n    const deadline = now() + timeout;\n    let failure = findActionabilityFailure(widget);\n\n    while (failure !== null && now() < deadline) {\n        await delay(ACTIONABLE_HOP_MS);\n        failure = findActionabilityFailure(widget);\n    }\n\n    if (failure !== null) {\n        throw new Error(\n            `Cannot dispatch user event: ${describeWidget(widget)} did not become actionable ` +\n            `within ${String(timeout)}ms because ${failure}`,\n        );\n    }\n};\n\nconst wrapEvent = async (widget: Gtk.Widget, body: () => void | PromiseLike<void>): Promise<void> => {\n    await waitForActionable(widget);\n\n    await runInAct(async () => {\n        await body();\n    });\n};\n\nexport { wrapEvent };\n"]}

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

@@ -31,10 +31,11 @@ type UserEvent = {
      * 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.
+     * expandable tree expander that is itself the clicked widget toggles its expansion; a notebook
+     * tab, clicked directly or through its label, focuses its notebook and switches to its page; 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;
     /**
@@ -42,19 +43,23 @@ type UserEvent = {
      * 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.
+     * and activated by the second press, a tree expander ends back where it started, a notebook tab
+     * stays on the page the first press opened, 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.
+     * itself once per press to a row, tree expander, notebook tab, 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. */
+    /**
+     * Focuses an editable widget the way clicking into it does, leaving its text unselected, applies
+     * any initial selection, and inserts the text at the cursor, deleting the text the widget has
+     * selected first, the way GTK4 does.
+     */
     type: typeof type;
     /** Focuses an editable widget and deletes its whole text, leaving nothing selected. */
     clear: typeof clear;
@@ -62,7 +67,10 @@ type UserEvent = {
     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. */
+    /**
+     * Inserts the given text, or the clipboard's text, at an editable widget's cursor, deleting the
+     * text the widget has selected first, the way GTK4 does.
+     */
     paste: typeof paste;
     /**
      * Selects the items at those positions in a view or drop-down, or selects the indexed children of
@@ -93,7 +101,25 @@ type UserEvent = {
     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. */
+    /**
+     * Sends a key sequence along the chain GTK4 propagates a key event through: the application's
+     * accelerators first, then the capture-phase controllers from the root down to the event widget,
+     * the event widget's target-phase controllers, and the bubble-phase controllers from it back up
+     * to the root, so a key controller or shortcut controller a container or window above the widget
+     * carries receives the key too, each in the phase it declares. The event widget is the editable
+     * delegate GTK4 focuses when the widget has one, the `Gtk.Text` inside a `Gtk.Entry` for
+     * instance, so the delegate stands ahead of the widget in the chain. A shortcut controller whose
+     * scope is not local runs where it registered instead, the root for a global one and the nearest
+     * `Gtk.ShortcutManager` for a managed one, so it fires wherever focus sits inside that subtree
+     * and never at its own widget, while a shortcut whose widget is insensitive or unmapped stays
+     * inert wherever it sits. The first controller that handles a press ends the chain, and a
+     * `Gdk.KEY_Return` press none of them handled reaches an editable widget's activate handler.
+     * Built-in key bindings take part, since GTK4 carries them on a shortcut controller: a
+     * `Gtk.Text`'s arrow keys or a `Gtk.TextView`'s undo can consume a press before an ancestor
+     * sees it. Key controllers GTK4 attaches itself are the exception, since they read a GDK event
+     * that off-screen synthesis cannot produce, so only the key controllers the tree connected a
+     * `key-pressed` or `key-released` handler to take part. Held modifiers carry 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

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

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

package/dist/user-event/index.js

@@ -1,3 +1,4 @@
+import { delay } from "../timers.js";
 import { scroll, slide } from "./adjustment.js";
 import { click, dblClick, tripleClick } from "./click.js";
 import { drag, dragAndDrop, drop, hover, longPress, rotate, swipe, unhover, zoom } from "./gesture.js";
@@ -15,11 +16,11 @@ const userEvent = {
     ...createInstance(createInitialState(), {}),
     setup: (options) => createInstance(createInitialState(), options ?? {}),
 };
-const settle = (delay) => {
-    if (delay === null || delay === undefined) {
+const settle = (ms) => {
+    if (ms === null || ms === undefined) {
         return Promise.resolve();
     }
-    return new Promise((resolve) => setTimeout(resolve, delay));
+    return delay(ms);
 };
 function createInstance(state, options) {
     const after = (helper) => async (...args) => {

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

@@ -1 +1 @@
-{"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"]}
+{"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 { delay } from \"../timers.js\";\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 notebook\n     * tab, clicked directly or through its label, focuses its notebook and switches to its page; a\n     * column header sorts by its column. A column-view cell and the row carrying the column headers\n     * stand in the way of the click rather than taking it, so a click on either reaches the row or\n     * the 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, a notebook tab\n     * stays on the page the first press opened, and a column 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, notebook tab, 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    /**\n     * Focuses an editable widget the way clicking into it does, leaving its text unselected, applies\n     * any initial selection, and inserts the text at the cursor, deleting the text the widget has\n     * selected first, the way GTK4 does.\n     */\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    /**\n     * Inserts the given text, or the clipboard's text, at an editable widget's cursor, deleting the\n     * text the widget has selected first, the way GTK4 does.\n     */\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    /**\n     * Sends a key sequence along the chain GTK4 propagates a key event through: the application's\n     * accelerators first, then the capture-phase controllers from the root down to the event widget,\n     * the event widget's target-phase controllers, and the bubble-phase controllers from it back up\n     * to the root, so a key controller or shortcut controller a container or window above the widget\n     * carries receives the key too, each in the phase it declares. The event widget is the editable\n     * delegate GTK4 focuses when the widget has one, the `Gtk.Text` inside a `Gtk.Entry` for\n     * instance, so the delegate stands ahead of the widget in the chain. A shortcut controller whose\n     * scope is not local runs where it registered instead, the root for a global one and the nearest\n     * `Gtk.ShortcutManager` for a managed one, so it fires wherever focus sits inside that subtree\n     * and never at its own widget, while a shortcut whose widget is insensitive or unmapped stays\n     * inert wherever it sits. The first controller that handles a press ends the chain, and a\n     * `Gdk.KEY_Return` press none of them handled reaches an editable widget's activate handler.\n     * Built-in key bindings take part, since GTK4 carries them on a shortcut controller: a\n     * `Gtk.Text`'s arrow keys or a `Gtk.TextView`'s undo can consume a press before an ancestor\n     * sees it. Key controllers GTK4 attaches itself are the exception, since they read a GDK event\n     * that off-screen synthesis cannot produce, so only the key controllers the tree connected a\n     * `key-pressed` or `key-released` handler to take part. Held modifiers carry across calls.\n     */\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 = (ms: number | null | undefined): Promise<void> => {\n    if (ms === null || ms === undefined) {\n        return Promise.resolve();\n    }\n\n    return delay(ms);\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/keyboard.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/user-event/keyboard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,mCAAmC;AACnC,KAAK,UAAU,GAAG;IACd,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAqDF,uGAAuG;AACvG,QAAA,MAAM,GAAG,GAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,UAAU,UAAU,KAAG,OAAO,CAAC,IAAI,CAQ9D,CAAC;AAsUP,QAAA,MAAM,QAAQ,GAAI,OAAO,cAAc,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAKnF,CAAC;AAEP,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,CAAC"}