@gtkx/testing 1.0.0-rc.4 → 1.1.0

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

@@ -6,35 +6,78 @@ import { tab } from "./keyboard.js";
 import { type PointerInput } from "./pointer.js";
 import { deselectOptions, selectOptions } from "./selection.js";
 import { clear, copy, cut, paste, type } from "./text.js";
+/** Options shared by every helper on a {@link UserEvent} instance. */
+type UserEventOptions = {
+    /** Milliseconds to wait after each helper resolves; null, the default, waits not at all. */
+    delay?: number | null | undefined;
+};
 /**
  * The set of user interaction helpers exposed by {@link userEvent}, covering clicks, typing,
  * keyboard, pointer, gestures, selection, and scrolling.
  */
 type UserEvent = {
     /**
-     * Clicks a button, toggles a switch, and otherwise activates the widget, falling back to a click
-     * gesture on its nearest clickable ancestor when activation does nothing.
+     * Returns a fresh instance whose helpers share one keyboard and pointer state, so held modifiers
+     * and buttons carry across its calls but not across instances.
+     */
+    setup: (options?: UserEventOptions) => UserEvent;
+    /**
+     * Activates a widget that neither claims the click nor carries a click gesture of its own, and
+     * otherwise presses and releases outwards from the clicked widget through every widget carrying
+     * a click gesture, stopping at the first button or indexed child. A list box row or flow box
+     * child receives its click gesture at the clicked position, passes one on to the gestures its
+     * container carries, and is then activated, or exclusively selected when its container does not
+     * activate on a single click. The press also stops at a widget whose click GTK4 implements
+     * itself, where the gestures that widget carries of its own still take the press and the same
+     * outcome is then applied through GTK's own public action: a list, grid, or column-view row is
+     * focused and selected, and activated as well when its view activates on a single click; an
+     * expandable tree expander that is itself the clicked widget toggles its expansion; a 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;
-    /** Emits a two-press click gesture on the widget. */
+    /**
+     * Delivers a two-press click gesture along the same path a single click takes, without trying
+     * activation first, activating a list box row or flow box child on that path and replacing its
+     * container's selection whether or not that container activates on a single click. A widget
+     * whose click GTK4 implements itself receives that outcome once per press, so a row is selected
+     * and activated by the second press, a tree expander ends back where it started, a notebook tab
+     * stays on the page the first press opened, and a column header inverts its order after sorting.
+     */
     dblClick: typeof dblClick;
-    /** Emits a three-press click gesture on the widget. */
+    /**
+     * 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, 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;
-    /** Empties an editable widget's text. */
+    /** Focuses an editable widget and deletes its whole text, leaving nothing selected. */
     clear: typeof clear;
     /** Writes an editable widget's current selection to the clipboard. */
     copy: typeof copy;
     /** Writes an editable widget's current selection to the clipboard and deletes it. */
     cut: typeof cut;
-    /** Inserts the given text, or the clipboard's text, at an editable widget's cursor. */
+    /**
+     * 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 the given positions in a list view, drop-down, combo box, or list box. */
+    /**
+     * Selects the items at those positions in a view or drop-down, or selects the indexed children of
+     * a list box or flow box through their container, without activating them.
+     */
     selectOptions: typeof selectOptions;
-    /** Deselects the items at the given positions in a list view or list box. */
+    /** Unselects the items at those positions, leaving list box and flow box children unactivated. */
     deselectOptions: typeof deselectOptions;
     /** Emits a motion `enter` on the widget, adding a motion controller when it has none. */
     hover: typeof hover;
@@ -58,14 +101,38 @@ 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, tracking whether the left button is held across calls. */
+    /**
+     * Applies a pointer token to the click gestures the widget already carries, tracking whether the
+     * left button is held across calls. On a widget whose click GTK4 implements itself, the release
+     * also applies GTK's own outcome, the way {@link UserEvent.click} does, and a column-view cell
+     * or the row carrying the column headers passes the token to the row or view behind it.
+     */
     pointer: (widget: Gtk.Widget, input: PointerInput) => Promise<void>;
 };
 /**
  * High-level helpers that drive widgets by dispatching the same events and gestures GTK4 delivers
- * when someone clicks, types, or drags.
+ * when someone clicks, types, or drags. Call `setup` for an instance with its own keyboard and
+ * pointer state.
  */
 declare const userEvent: UserEvent;
 export type { ScrollDelta } from "./adjustment.js";
@@ -74,5 +141,5 @@ export type { TabOptions } from "./keyboard.js";
 export type { PointerInput } from "./pointer.js";
 export type { TypeOptions } from "./text.js";
 export { resetClipboard } from "./text.js";
-export { userEvent, type UserEvent };
+export { userEvent, type UserEvent, type UserEventOptions };
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user-event/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAqB,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA4D1D,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;AAEnC;;;GAGG;AACH,MAAM,SAAS,GAAc;IACzB,KAAK;IACL,QAAQ;IACR,WAAW;IACX,GAAG;IACH,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,GAAG;IACH,KAAK;IACL,aAAa;IACb,eAAe;IACf,KAAK;IACL,OAAO;IACP,MAAM;IACN,IAAI;IACJ,KAAK;IACL,SAAS;IACT,IAAI;IACJ,IAAI;IACJ,WAAW;IACX,KAAK;IACL,MAAM;IACN,QAAQ,EAAE,CAAC,MAAkB,EAAE,KAAa,EAAiB,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;IAC9F,OAAO,EAAE,CAAC,MAAkB,EAAE,KAAmB,EAAiB,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;CACrG,CAAC;AAOF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAkB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { scroll, slide } from \"./adjustment.js\";\nimport { click, dblClick, tripleClick } from \"./click.js\";\nimport { drag, dragAndDrop, drop, hover, longPress, rotate, swipe, unhover, zoom } from \"./gesture.js\";\nimport { keyboard, tab } from \"./keyboard.js\";\nimport { pointer, type PointerInput } from \"./pointer.js\";\nimport { deselectOptions, selectOptions } from \"./selection.js\";\nimport { createInitialState } from \"./state.js\";\nimport { clear, copy, cut, paste, type } from \"./text.js\";\n\n/**\n * The set of user interaction helpers exposed by {@link userEvent}, covering clicks, typing,\n * keyboard, pointer, gestures, selection, and scrolling.\n */\ntype UserEvent = {\n    /**\n     * Clicks a button, toggles a switch, and otherwise activates the widget, falling back to a click\n     * gesture on its nearest clickable ancestor when activation does nothing.\n     */\n    click: typeof click;\n    /** Emits a two-press click gesture on the widget. */\n    dblClick: typeof dblClick;\n    /** Emits a three-press click gesture on the widget. */\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    /** Empties an editable widget's text. */\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    /** Selects the items at the given positions in a list view, drop-down, combo box, or list box. */\n    selectOptions: typeof selectOptions;\n    /** Deselects the items at the given positions in a list view or list box. */\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    /** Applies a pointer token, tracking whether the left button is held across calls. */\n    pointer: (widget: Gtk.Widget, input: PointerInput) => Promise<void>;\n};\n\nconst state = createInitialState();\n\n/**\n * High-level helpers that drive widgets by dispatching the same events and gestures GTK4 delivers\n * when someone clicks, types, or drags.\n */\nconst userEvent: UserEvent = {\n    click,\n    dblClick,\n    tripleClick,\n    tab,\n    type,\n    clear,\n    copy,\n    cut,\n    paste,\n    selectOptions,\n    deselectOptions,\n    hover,\n    unhover,\n    rotate,\n    zoom,\n    swipe,\n    longPress,\n    drag,\n    drop,\n    dragAndDrop,\n    slide,\n    scroll,\n    keyboard: (widget: Gtk.Widget, input: string): Promise<void> => keyboard(state, widget, input),\n    pointer: (widget: Gtk.Widget, input: PointerInput): Promise<void> => pointer(state, widget, input),\n};\n\nexport type { ScrollDelta } from \"./adjustment.js\";\nexport type { DragOffset, DragOptions, DropContent, DropOptions } from \"./gesture.js\";\nexport type { TabOptions } from \"./keyboard.js\";\nexport type { PointerInput } from \"./pointer.js\";\nexport type { TypeOptions } from \"./text.js\";\nexport { resetClipboard } from \"./text.js\";\nexport { userEvent, type UserEvent };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user-event/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { 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/indexed-children.d.ts

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/user-event/keyboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,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;AAoNP,QAAA,MAAM,QAAQ,GAAI,OAAO,cAAc,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAOnF,CAAC;AAEP,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,CAAC"}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/user-event/keyboard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;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"}

package/dist/user-event/keyboard.js

@@ -1,8 +1,10 @@
 import * as Gdk from "@gtkx/gi/gdk";
+import * as Gio from "@gtkx/gi/gio";
 import * as Gtk from "@gtkx/gi/gtk";
+import { hasSignalListener } from "@gtkx/runtime/internal";
 import { getEditableDelegate } from "../editable.js";
 import { fireEvent } from "../fire-event.js";
-import { getOrCreateControllers } from "./controller.js";
+import { ancestors, descendants } from "../traversal.js";
 import { wrapEvent } from "./event-wrapper.js";
 const KEY_MAP = {
     Enter: Gdk.KEY_Return,
@@ -36,6 +38,7 @@ const KEY_MAP = {
     F11: Gdk.KEY_F11,
     F12: Gdk.KEY_F12,
 };
+const KEY_CONTROLLER_SIGNALS = ["key-pressed", "key-released"];
 const MODIFIER_KEYVAL_TO_MASK = {
     [Gdk.KEY_Shift_L]: Gdk.ModifierType.SHIFT_MASK,
     [Gdk.KEY_Shift_R]: Gdk.ModifierType.SHIFT_MASK,
@@ -133,15 +136,50 @@ const isTriggerMatch = (trigger, keyval, modifiers) => {
     }
     return false;
 };
-const didActivateShortcut = (shortcut, widget, keyval, modifiers) => {
-    if (!isTriggerMatch(shortcut.getTrigger(), keyval, modifiers)) {
-        return false;
+const controllersOn = function* (widget) {
+    const controllers = widget.observeControllers();
+    const count = controllers.getNItems();
+    for (let i = 0; i < count; i++) {
+        const controller = controllers.getItem(i);
+        if (controller instanceof Gtk.EventController) {
+            yield controller;
+        }
+    }
+};
+const hasShortcut = (controller, shortcut) => {
+    const count = controller.getNItems();
+    for (let i = 0; i < count; i++) {
+        if (controller.getItem(i) === shortcut) {
+            return true;
+        }
     }
+    return false;
+};
+const isManagingShortcut = (controller, shortcut) => controller instanceof Gtk.ShortcutController &&
+    controller.getScope() !== Gtk.ShortcutScope.LOCAL &&
+    hasShortcut(controller, shortcut);
+const managedShortcutHost = (manager, shortcut) => {
+    for (const current of [manager, ...descendants(manager)]) {
+        if (controllersOn(current).some((controller) => isManagingShortcut(controller, shortcut))) {
+            return current;
+        }
+    }
+    return null;
+};
+const isMovingFocus = (action) => action instanceof Gtk.SignalAction && action.getSignalName() === "move-focus";
+const isShortcutLive = (host) => host.isSensitive() && host.getMapped();
+const didRunShortcutAction = (shortcut, host) => {
     const action = shortcut.getAction();
-    if (action instanceof Gtk.SignalAction && action.getSignalName() === "move-focus") {
+    if (action === null || isMovingFocus(action) || !isShortcutLive(host)) {
         return false;
     }
-    return action?.activate(0, widget, shortcut.getArguments()) ?? false;
+    return action.activate(0, host, shortcut.getArguments());
+};
+const didActivateShortcut = (shortcut, widget, keyval, modifiers) => {
+    if (!isTriggerMatch(shortcut.getTrigger(), keyval, modifiers)) {
+        return false;
+    }
+    return didRunShortcutAction(shortcut, managedShortcutHost(widget, shortcut) ?? widget);
 };
 const didActivateMatchingShortcut = (controller, widget, keyval, modifiers) => {
     const count = controller.getNItems();
@@ -156,49 +194,95 @@ const didActivateMatchingShortcut = (controller, widget, keyval, modifiers) => {
     }
     return false;
 };
-const didDispatchShortcutsOnWidget = (widget, keyval, modifiers) => {
-    const controllers = widget.observeControllers();
-    for (let i = 0; i < controllers.getNItems(); i++) {
-        const controller = controllers.getItem(i);
-        if (controller instanceof Gtk.ShortcutController &&
-            didActivateMatchingShortcut(controller, widget, keyval, modifiers)) {
-            return true;
+const isAccelMatch = (accel, keyval, modifiers) => {
+    const [isParsed, accelKeyval, accelModifiers] = Gtk.acceleratorParse(accel);
+    return isParsed && accelKeyval === keyval && accelModifiers === modifiers;
+};
+const hasMatchingAccel = (application, detailedActionName, keyval, modifiers) => application.getAccelsForAction(detailedActionName).some((accel) => isAccelMatch(accel, keyval, modifiers));
+const didActivateDetailedAction = (window, detailedActionName) => {
+    const [isParsed, actionName, target] = Gio.Action.parseDetailedName(detailedActionName);
+    return isParsed && window.activateAction(actionName, target);
+};
+const didDispatchAccelsOnWindow = (window, keyval, modifiers) => {
+    const application = window.getApplication();
+    if (!application) {
+        return false;
+    }
+    for (const detailedActionName of application.listActionDescriptions()) {
+        if (hasMatchingAccel(application, detailedActionName, keyval, modifiers)) {
+            return didActivateDetailedAction(window, detailedActionName);
         }
     }
     return false;
 };
-const didDispatchShortcuts = (widget, keyval, modifiers) => {
+const didDispatchApplicationAccels = (widget, keyval, modifiers) => {
+    const root = widget.getRoot();
+    return root instanceof Gtk.Window && didDispatchAccelsOnWindow(root, keyval, modifiers);
+};
+const isKeyStopController = (controller) => {
+    if (controller instanceof Gtk.ShortcutController) {
+        return controller.getScope() === Gtk.ShortcutScope.LOCAL;
+    }
+    return controller instanceof Gtk.EventControllerKey && hasSignalListener(controller, KEY_CONTROLLER_SIGNALS);
+};
+const keyStopsInPhase = (widget, phase) => {
+    const stops = [];
+    for (const controller of controllersOn(widget)) {
+        if (controller.getPropagationPhase() === phase && isKeyStopController(controller)) {
+            stops.push({ widget, controller });
+        }
+    }
+    return stops;
+};
+const propagationChain = (widget) => {
     const delegate = getEditableDelegate(widget);
-    if (delegate && didDispatchShortcutsOnWidget(delegate, keyval, modifiers)) {
-        return true;
+    const below = delegate === null ? [] : [delegate];
+    return [...below, widget, ...ancestors(widget)];
+};
+const keyPropagationChain = (widget) => {
+    const chain = propagationChain(widget);
+    const [eventWidget = widget] = chain;
+    return [
+        ...chain.toReversed().flatMap((current) => keyStopsInPhase(current, Gtk.PropagationPhase.CAPTURE)),
+        ...keyStopsInPhase(eventWidget, Gtk.PropagationPhase.TARGET),
+        ...chain.flatMap((current) => keyStopsInPhase(current, Gtk.PropagationPhase.BUBBLE)),
+    ];
+};
+const didStopHandlePress = (stop, keyval, modifiers) => {
+    const { controller, widget } = stop;
+    if (controller instanceof Gtk.ShortcutController) {
+        return didActivateMatchingShortcut(controller, widget, keyval, modifiers);
     }
-    for (let current = widget; current; current = current.getParent()) {
-        if (didDispatchShortcutsOnWidget(current, keyval, modifiers)) {
-            return true;
+    return controller.emit("key-pressed", keyval, 0, modifiers);
+};
+const didHandlePress = (widget, keyval, modifiers) => didDispatchApplicationAccels(widget, keyval, modifiers) ||
+    keyPropagationChain(widget).some((stop) => didStopHandlePress(stop, keyval, modifiers));
+const emitKeyReleased = (widget, keyval, modifiers) => {
+    for (const stop of keyPropagationChain(widget)) {
+        if (stop.controller instanceof Gtk.EventControllerKey) {
+            stop.controller.emit("key-released", keyval, 0, modifiers);
         }
     }
-    return false;
 };
-const handleKeyPress = async (widget, keyval, modifiers) => {
-    const isHandled = didDispatchShortcuts(widget, keyval, modifiers);
-    if (!isHandled && keyval === Gdk.KEY_Return && widget instanceof Gtk.Editable) {
+const applyKeyPress = async (widget, keyval, modifiers) => {
+    if (didHandlePress(widget, keyval, modifiers)) {
+        return;
+    }
+    if (keyval === Gdk.KEY_Return && widget instanceof Gtk.Editable) {
         await fireEvent(widget, "activate");
     }
 };
-const applyKeyAction = async (widget, controllers, state, action) => {
+const applyKeyAction = async (widget, state, action) => {
     updateModifierState(state, action);
-    const signalName = action.isPress ? "key-pressed" : "key-released";
-    for (const controller of controllers) {
-        controller.emit(signalName, action.keyval, 0, state.modifierState);
-    }
     if (action.isPress) {
-        await handleKeyPress(widget, action.keyval, state.modifierState);
+        await applyKeyPress(widget, action.keyval, state.modifierState);
+        return;
     }
+    emitKeyReleased(widget, action.keyval, state.modifierState);
 };
 const keyboard = (state, widget, input) => wrapEvent(widget, async () => {
-    const controllers = getOrCreateControllers(widget, Gtk.EventControllerKey);
     for (const action of parseKeyboardInput(input)) {
-        await applyKeyAction(widget, controllers, state, action);
+        await applyKeyAction(widget, state, action);
     }
 });
 export { tab, keyboard };