@gtkx/testing 1.0.0-rc.2 → 1.0.0-rc.4

package/dist/user-event/selection.js

@@ -87,6 +87,14 @@ const runSelectionEvent = (widget, values, inListView, byRole) => wrapEvent(widg
     }
     byRole(widget, valueArray);
 });
+/**
+ * Selects the items at the given positions through a list, grid, or column view's selection model,
+ * by setting the active item of a drop-down or combo box, or by selecting list box rows. An empty
+ * array clears a view's selection.
+ *
+ * @throws When a view has no selection model, when a combo box is given more than one position, or
+ * when the widget is neither a view nor something with the combo box or list role.
+ */
 const selectOptions = (widget, values) => runSelectionEvent(widget, values, selectInListView, selectByRole);
 const deselectInListView = (widget, valueArray) => {
     const selectionModel = requireSelectionModel(widget, "deselect");
@@ -100,6 +108,13 @@ const deselectByRole = (widget, valueArray) => {
     }
     applyListBoxRows(widget, valueArray, unselectListBoxRow);
 };
+/**
+ * Unselects the items at the given positions in a list, grid, or column view, or the rows at those
+ * indices in a Gtk.ListBox.
+ *
+ * @throws When a view has no selection model, or when the widget is neither one of those views nor
+ * a Gtk.ListBox.
+ */
 const deselectOptions = (widget, values) => runSelectionEvent(widget, values, deselectInListView, deselectByRole);
 export { selectOptions, deselectOptions };
 //# sourceMappingURL=selection.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/user-event/selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAK/C,MAAM,gBAAgB,GAA4B,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AAEnH,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAW,EAAE;IACjD,OAAO,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CACxB,cAAkC,EAClC,SAAmB,EACnB,WAAoB,EAChB,EAAE;IACN,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,cAAc,CAAC,aAAa,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;QAE5D,OAAO;IACX,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAE1B,IAAI,WAAW,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,cAAc,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEvC,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAE5C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC1B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,cAAc,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,MAAkB,EAA8B,EAAE,CAClE,MAAM,YAAY,GAAG,CAAC,QAAQ,IAAI,MAAM,YAAY,GAAG,CAAC,QAAQ,IAAI,MAAM,YAAY,GAAG,CAAC,UAAU,CAAC;AAEzG,MAAM,oBAAoB,GAAG,CAAC,MAAkB,EAAE,UAAoB,EAAQ,EAAE;IAC5E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC;IAE/B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACX,CAAC;IAED,IAAI,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;SAAM,IAAI,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,OAAoB,EAAE,GAAmB,EAAQ,EAAE;IACzE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,GAAG,CAAC,QAAQ,EAAE,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,OAAoB,EAAE,GAAmB,EAAQ,EAAE;IAC3E,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,OAAoB,EAAE,UAAoB,EAAE,KAAuB,EAAQ,EAAE;IACnG,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,SAAS;QACb,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC1B,MAAwB,EACxB,IAAY,EACM,EAAE;IACpB,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEzC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,4CAA4C,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,cAAc,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,MAAwB,EAAE,UAAoB,EAAQ,EAAE;IAC9E,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,cAAc,YAAY,GAAG,CAAC,cAAc,CAAC;IACtE,mBAAmB,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC,gBAAgB,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,MAAkB,EAAE,UAAoB,EAAQ,EAAE;IACpE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sDAAsD,cAAc,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/G,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAExC,IAAI,IAAI,KAAK,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;QACxC,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC;QACvC,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAC3D,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACtB,MAAkB,EAClB,MAAyB,EACzB,UAA8F,EAC9F,MAA0D,EAC7C,EAAE,CACf,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE;IACnB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAE7D,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE/B,OAAO;IACX,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEP,MAAM,aAAa,GAAG,CAAC,MAAkB,EAAE,MAAyB,EAAiB,EAAE,CACnF,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;AAEtE,MAAM,kBAAkB,GAAG,CAAC,MAAoD,EAAE,UAAoB,EAAQ,EAAE;IAC5G,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEjE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,UAAoB,EAAQ,EAAE;IACtE,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,SAAS,CAAC,4DAA4D,CAAC,CAAC;IACtF,CAAC;IAED,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,MAAkB,EAAE,MAAyB,EAAiB,EAAE,CACrF,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { formatRoleList } from \"../role-helpers.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\ntype CollectionWidget = Gtk.ListView | Gtk.GridView | Gtk.ColumnView;\ntype ListBoxRowAction = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow) => void;\n\nconst SELECTABLE_ROLES: Set<Gtk.AccessibleRole> = new Set([Gtk.AccessibleRole.COMBO_BOX, Gtk.AccessibleRole.LIST]);\n\nconst isSelectable = (widget: Gtk.Widget): boolean => {\n    return SELECTABLE_ROLES.has(widget.getAccessibleRole());\n};\n\nconst selectListViewItems = (\n    selectionModel: Gtk.SelectionModel,\n    positions: number[],\n    isExclusive: boolean,\n): void => {\n    if (positions.length === 0) {\n        selectionModel.unselectRange(0, selectionModel.getNItems());\n\n        return;\n    }\n\n    const [first] = positions;\n\n    if (isExclusive && first !== undefined && positions.length === 1) {\n        selectionModel.selectItem(first, true);\n\n        return;\n    }\n\n    const nItems = selectionModel.getNItems();\n    const selected = Gtk.Bitset.newEmpty();\n    const mask = Gtk.Bitset.newRange(0, nItems);\n\n    for (const pos of positions) {\n        selected.add(pos);\n    }\n\n    selectionModel.setSelection(selected, mask);\n};\n\nconst isListView = (widget: Gtk.Widget): widget is CollectionWidget =>\n    widget instanceof Gtk.ListView || widget instanceof Gtk.GridView || widget instanceof Gtk.ColumnView;\n\nconst selectComboBoxOption = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (valueArray.length > 1) {\n        throw new Error(\"Cannot select multiple options: ComboBox only supports single selection\");\n    }\n\n    const [selection] = valueArray;\n\n    if (selection === undefined) {\n        return;\n    }\n\n    if (widget instanceof Gtk.DropDown) {\n        widget.setSelected(selection);\n    } else if (widget instanceof Gtk.ComboBox) {\n        widget.setActive(selection);\n    }\n};\n\nconst selectListBoxRow = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow): void => {\n    listBox.selectRow(row);\n    row.activate();\n};\n\nconst unselectListBoxRow = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow): void => {\n    listBox.unselectRow(row);\n};\n\nconst applyListBoxRows = (listBox: Gtk.ListBox, valueArray: number[], apply: ListBoxRowAction): void => {\n    for (const value of valueArray) {\n        const row = listBox.getRowAtIndex(value);\n\n        if (!row) {\n            continue;\n        }\n\n        apply(listBox, row);\n    }\n};\n\nconst requireSelectionModel = (\n    widget: CollectionWidget,\n    verb: string,\n): Gtk.SelectionModel => {\n    const selectionModel = widget.getModel();\n\n    if (selectionModel === null) {\n        throw new Error(`Cannot ${verb} options: list view has no selection model`);\n    }\n\n    return selectionModel;\n};\n\nconst selectInListView = (widget: CollectionWidget, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"select\");\n    const isMultiSelection = selectionModel instanceof Gtk.MultiSelection;\n    selectListViewItems(selectionModel, valueArray, !isMultiSelection);\n};\n\nconst selectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (!isSelectable(widget)) {\n        throw new Error(`Cannot select options: expected selectable widget (${formatRoleList(SELECTABLE_ROLES)})`);\n    }\n\n    const role = widget.getAccessibleRole();\n\n    if (role === Gtk.AccessibleRole.COMBO_BOX) {\n        selectComboBoxOption(widget, valueArray);\n    } else if (widget instanceof Gtk.ListBox) {\n        applyListBoxRows(widget, valueArray, selectListBoxRow);\n    }\n};\n\nconst runSelectionEvent = (\n    widget: Gtk.Widget,\n    values: number | number[],\n    inListView: (view: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]) => void,\n    byRole: (widget: Gtk.Widget, valueArray: number[]) => void,\n): Promise<void> =>\n    wrapEvent(widget, () => {\n        const valueArray = Array.isArray(values) ? values : [values];\n\n        if (isListView(widget)) {\n            inListView(widget, valueArray);\n\n            return;\n        }\n\n        byRole(widget, valueArray);\n    });\n\nconst selectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, selectInListView, selectByRole);\n\nconst deselectInListView = (widget: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"deselect\");\n\n    for (const pos of valueArray) {\n        selectionModel.unselectItem(pos);\n    }\n};\n\nconst deselectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (!(widget instanceof Gtk.ListBox)) {\n        throw new TypeError(\"Cannot deselect options: only ListBox supports deselection\");\n    }\n\n    applyListBoxRows(widget, valueArray, unselectListBoxRow);\n};\n\nconst deselectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, deselectInListView, deselectByRole);\n\nexport { selectOptions, deselectOptions };\n"]}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/user-event/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport { formatRoleList } from \"../role-helpers.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\ntype CollectionWidget = Gtk.ListView | Gtk.GridView | Gtk.ColumnView;\ntype ListBoxRowAction = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow) => void;\n\nconst SELECTABLE_ROLES: Set<Gtk.AccessibleRole> = new Set([Gtk.AccessibleRole.COMBO_BOX, Gtk.AccessibleRole.LIST]);\n\nconst isSelectable = (widget: Gtk.Widget): boolean => {\n    return SELECTABLE_ROLES.has(widget.getAccessibleRole());\n};\n\nconst selectListViewItems = (\n    selectionModel: Gtk.SelectionModel,\n    positions: number[],\n    isExclusive: boolean,\n): void => {\n    if (positions.length === 0) {\n        selectionModel.unselectRange(0, selectionModel.getNItems());\n\n        return;\n    }\n\n    const [first] = positions;\n\n    if (isExclusive && first !== undefined && positions.length === 1) {\n        selectionModel.selectItem(first, true);\n\n        return;\n    }\n\n    const nItems = selectionModel.getNItems();\n    const selected = Gtk.Bitset.newEmpty();\n    const mask = Gtk.Bitset.newRange(0, nItems);\n\n    for (const pos of positions) {\n        selected.add(pos);\n    }\n\n    selectionModel.setSelection(selected, mask);\n};\n\nconst isListView = (widget: Gtk.Widget): widget is CollectionWidget =>\n    widget instanceof Gtk.ListView || widget instanceof Gtk.GridView || widget instanceof Gtk.ColumnView;\n\nconst selectComboBoxOption = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (valueArray.length > 1) {\n        throw new Error(\"Cannot select multiple options: ComboBox only supports single selection\");\n    }\n\n    const [selection] = valueArray;\n\n    if (selection === undefined) {\n        return;\n    }\n\n    if (widget instanceof Gtk.DropDown) {\n        widget.setSelected(selection);\n    } else if (widget instanceof Gtk.ComboBox) {\n        widget.setActive(selection);\n    }\n};\n\nconst selectListBoxRow = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow): void => {\n    listBox.selectRow(row);\n    row.activate();\n};\n\nconst unselectListBoxRow = (listBox: Gtk.ListBox, row: Gtk.ListBoxRow): void => {\n    listBox.unselectRow(row);\n};\n\nconst applyListBoxRows = (listBox: Gtk.ListBox, valueArray: number[], apply: ListBoxRowAction): void => {\n    for (const value of valueArray) {\n        const row = listBox.getRowAtIndex(value);\n\n        if (!row) {\n            continue;\n        }\n\n        apply(listBox, row);\n    }\n};\n\nconst requireSelectionModel = (\n    widget: CollectionWidget,\n    verb: string,\n): Gtk.SelectionModel => {\n    const selectionModel = widget.getModel();\n\n    if (selectionModel === null) {\n        throw new Error(`Cannot ${verb} options: list view has no selection model`);\n    }\n\n    return selectionModel;\n};\n\nconst selectInListView = (widget: CollectionWidget, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"select\");\n    const isMultiSelection = selectionModel instanceof Gtk.MultiSelection;\n    selectListViewItems(selectionModel, valueArray, !isMultiSelection);\n};\n\nconst selectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (!isSelectable(widget)) {\n        throw new Error(`Cannot select options: expected selectable widget (${formatRoleList(SELECTABLE_ROLES)})`);\n    }\n\n    const role = widget.getAccessibleRole();\n\n    if (role === Gtk.AccessibleRole.COMBO_BOX) {\n        selectComboBoxOption(widget, valueArray);\n    } else if (widget instanceof Gtk.ListBox) {\n        applyListBoxRows(widget, valueArray, selectListBoxRow);\n    }\n};\n\nconst runSelectionEvent = (\n    widget: Gtk.Widget,\n    values: number | number[],\n    inListView: (view: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]) => void,\n    byRole: (widget: Gtk.Widget, valueArray: number[]) => void,\n): Promise<void> =>\n    wrapEvent(widget, () => {\n        const valueArray = Array.isArray(values) ? values : [values];\n\n        if (isListView(widget)) {\n            inListView(widget, valueArray);\n\n            return;\n        }\n\n        byRole(widget, valueArray);\n    });\n\n/**\n * Selects the items at the given positions through a list, grid, or column view's selection model,\n * by setting the active item of a drop-down or combo box, or by selecting list box rows. An empty\n * array clears a view's selection.\n *\n * @throws When a view has no selection model, when a combo box is given more than one position, or\n * when the widget is neither a view nor something with the combo box or list role.\n */\nconst selectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, selectInListView, selectByRole);\n\nconst deselectInListView = (widget: Gtk.ListView | Gtk.GridView | Gtk.ColumnView, valueArray: number[]): void => {\n    const selectionModel = requireSelectionModel(widget, \"deselect\");\n\n    for (const pos of valueArray) {\n        selectionModel.unselectItem(pos);\n    }\n};\n\nconst deselectByRole = (widget: Gtk.Widget, valueArray: number[]): void => {\n    if (!(widget instanceof Gtk.ListBox)) {\n        throw new TypeError(\"Cannot deselect options: only ListBox supports deselection\");\n    }\n\n    applyListBoxRows(widget, valueArray, unselectListBoxRow);\n};\n\n/**\n * Unselects the items at the given positions in a list, grid, or column view, or the rows at those\n * indices in a Gtk.ListBox.\n *\n * @throws When a view has no selection model, or when the widget is neither one of those views nor\n * a Gtk.ListBox.\n */\nconst deselectOptions = (widget: Gtk.Widget, values: number | number[]): Promise<void> =>\n    runSelectionEvent(widget, values, deselectInListView, deselectByRole);\n\nexport { selectOptions, deselectOptions };\n"]}

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

@@ -1,6 +1,6 @@
 type UserEventState = {
     modifierState: number;
-    mouseLeftDown: boolean;
+    isMouseLeftDown: boolean;
 };
 declare const createInitialState: () => UserEventState;
 export { createInitialState, type UserEventState };

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

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/user-event/state.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,QAAA,MAAM,kBAAkB,QAAO,cAA8D,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/user-event/state.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,QAAA,MAAM,kBAAkB,QAAO,cAAgE,CAAC;AAEhG,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,CAAC"}

package/dist/user-event/state.js

@@ -1,3 +1,3 @@
-const createInitialState = () => ({ modifierState: 0, mouseLeftDown: false });
+const createInitialState = () => ({ modifierState: 0, isMouseLeftDown: false });
 export { createInitialState };
 //# sourceMappingURL=state.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/user-event/state.ts"],"names":[],"mappings":"AAKA,MAAM,kBAAkB,GAAG,GAAmB,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAuB,CAAC","sourcesContent":["type UserEventState = {\n    modifierState: number;\n    mouseLeftDown: boolean;\n};\n\nconst createInitialState = (): UserEventState => ({ modifierState: 0, mouseLeftDown: false });\n\nexport { createInitialState, type UserEventState };\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/user-event/state.ts"],"names":[],"mappings":"AAKA,MAAM,kBAAkB,GAAG,GAAmB,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;AAEhG,OAAO,EAAE,kBAAkB,EAAuB,CAAC","sourcesContent":["type UserEventState = {\n    modifierState: number;\n    isMouseLeftDown: boolean;\n};\n\nconst createInitialState = (): UserEventState => ({ modifierState: 0, isMouseLeftDown: false });\n\nexport { createInitialState, type UserEventState };\n"]}

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

@@ -1,18 +1,45 @@
 import * as Gtk from "@gtkx/gi/gtk";
-/** Options for {@link type}. */
+/** Options for `userEvent.type`. */
 type TypeOptions = {
-    /** Do not focus the widget before typing. */
-    skipClick?: boolean | undefined;
+    /** Focus the widget before typing; defaults to true. */
+    shouldFocus?: boolean | undefined;
     /** Select from this offset before typing, replacing the selected range with the typed text. */
     initialSelectionStart?: number | undefined;
     /** End offset of the initial selection (defaults to the start offset). */
     initialSelectionEnd?: number | undefined;
 };
 declare const resetClipboard: () => void;
+/**
+ * Focuses the widget unless `shouldFocus` is false, applies any initial selection, and inserts the text
+ * at the cursor.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 declare const type: (widget: Gtk.Widget, text: string, options?: TypeOptions) => Promise<void>;
+/**
+ * Replaces an editable widget's text with the empty string.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 declare const clear: (widget: Gtk.Widget) => Promise<void>;
+/**
+ * Writes an editable widget's selected text to its clipboard, or the empty string when nothing is selected.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 declare const copy: (widget: Gtk.Widget) => Promise<void>;
+/**
+ * Writes an editable widget's selected text to its clipboard, then deletes that selection.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 declare const cut: (widget: Gtk.Widget) => Promise<void>;
+/**
+ * Inserts the given text at an editable widget's cursor, reading the clipboard instead when no text
+ * is given.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 declare const paste: (widget: Gtk.Widget, text?: string) => Promise<void>;
 export { resetClipboard, type, clear, copy, cut, paste, type TypeOptions };
 //# sourceMappingURL=text.d.ts.map

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

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

package/dist/user-event/text.js

@@ -83,23 +83,50 @@ const runEditableEvent = (widget, failure, action) => wrapEvent(widget, () => {
     }
     action(widget);
 });
+/**
+ * Focuses the widget unless `shouldFocus` is false, applies any initial selection, and inserts the text
+ * at the cursor.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 const type = (widget, text, options) => runEditableEvent(widget, "Cannot type into element", (editable) => {
-    if (!options?.skipClick) {
+    if (options?.shouldFocus ?? true) {
         editable.grabFocus();
     }
     applyInitialSelection(editable, options ?? {});
     insertEditableText(editable, text);
 });
+/**
+ * Replaces an editable widget's text with the empty string.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 const clear = (widget) => runEditableEvent(widget, "Cannot clear element", (editable) => {
     setEditableText(editable, "");
 });
+/**
+ * Writes an editable widget's selected text to its clipboard, or the empty string when nothing is selected.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 const copy = (widget) => runEditableEvent(widget, "Cannot copy", (editable) => {
     writeClipboardText(editable, readSelection(editable));
 });
+/**
+ * Writes an editable widget's selected text to its clipboard, then deletes that selection.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 const cut = (widget) => runEditableEvent(widget, "Cannot cut", (editable) => {
     writeClipboardText(editable, readSelection(editable));
     deleteSelection(editable);
 });
+/**
+ * Inserts the given text at an editable widget's cursor, reading the clipboard instead when no text
+ * is given.
+ *
+ * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.
+ */
 const paste = async (widget, text) => {
     if (!isEditable(widget)) {
         throw new Error(`Cannot paste: ${EDITABLE_REQUIRED}`);

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

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/user-event/text.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gdk from \"@gtkx/gi/gdk\";\nimport * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { EDITABLE_ROLES, type EditableTarget, getEditableDelegate, isEditable } from \"../editable.js\";\nimport { formatRoleList } from \"../role-helpers.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** Options for {@link type}. */\ntype TypeOptions = {\n    /** Do not focus the widget before typing. */\n    skipClick?: boolean | undefined;\n    /** Select from this offset before typing, replacing the selected range with the typed text. */\n    initialSelectionStart?: number | undefined;\n    /** End offset of the initial selection (defaults to the start offset). */\n    initialSelectionEnd?: number | undefined;\n};\n\nconst EDITABLE_REQUIRED = `expected editable widget (${formatRoleList(EDITABLE_ROLES)})`;\n\nconst insertEditableText = (widget: EditableTarget, text: string): void => {\n    if (widget instanceof Gtk.TextView) {\n        widget.emit(\"insert-at-cursor\", text);\n\n        return;\n    }\n\n    const target = getEditableDelegate(widget) ?? widget;\n\n    if (target instanceof Gtk.Text) {\n        target.emit(\"insert-at-cursor\", text);\n\n        return;\n    }\n\n    const position = widget.getPosition();\n    const newPosition = widget.insertText(text, text.length, position);\n    widget.setPosition(newPosition);\n};\n\nconst readSelection = (widget: EditableTarget): string => {\n    if (widget instanceof Gtk.TextView) {\n        const buffer = widget.getBuffer();\n        const [hasSelection, start, end] = buffer.getSelectionBounds();\n\n        return hasSelection ? buffer.getText(start, end, true) : \"\";\n    }\n\n    const [hasSelection, start, end] = widget.getSelectionBounds();\n\n    return hasSelection ? widget.getChars(start, end) : \"\";\n};\n\nconst deleteSelection = (widget: EditableTarget): void => {\n    if (widget instanceof Gtk.TextView) {\n        widget.getBuffer().deleteSelection(false, true);\n\n        return;\n    }\n\n    widget.deleteSelection();\n};\n\nconst setEditableText = (widget: EditableTarget, text: string): void => {\n    if (widget instanceof Gtk.TextView) {\n        widget.getBuffer().setText(text, text.length);\n\n        return;\n    }\n\n    widget.setText(text);\n};\n\nconst applyTextViewSelection = (widget: Gtk.TextView, start: number, end: number): void => {\n    const buffer = widget.getBuffer();\n    buffer.selectRange(buffer.getIterAtOffset(start), buffer.getIterAtOffset(end));\n\n    if (end !== start) {\n        deleteSelection(widget);\n    }\n};\n\nconst applyEditableSelection = (widget: Gtk.Editable, start: number, end: number): void => {\n    widget.selectRegion(start, end);\n\n    if (end !== start) {\n        widget.deleteSelection();\n    }\n\n    widget.setPosition(start);\n};\n\nconst applyInitialSelection = (widget: EditableTarget, options: TypeOptions): void => {\n    if (options.initialSelectionStart === undefined) {\n        return;\n    }\n\n    const start = options.initialSelectionStart;\n    const end = options.initialSelectionEnd ?? start;\n\n    if (widget instanceof Gtk.TextView) {\n        applyTextViewSelection(widget, start, end);\n\n        return;\n    }\n\n    applyEditableSelection(widget, start, end);\n};\n\nconst writeClipboardText = (widget: Gtk.Widget, text: string): void => {\n    const value = GObject.buildValue(GObject.TYPE_STRING, (v) => {\n        v.setString(text);\n    });\n\n    widget.getClipboard().set(value);\n};\n\nconst resetClipboard = (): void => {\n    Gdk.Display.getDefault()?.getClipboard().setContent(null);\n};\n\nconst runEditableEvent = (\n    widget: Gtk.Widget,\n    failure: string,\n    action: (editable: EditableTarget) => void,\n): Promise<void> =>\n    wrapEvent(widget, () => {\n        if (!isEditable(widget)) {\n            throw new Error(`${failure}: ${EDITABLE_REQUIRED}`);\n        }\n\n        action(widget);\n    });\n\nconst type = (widget: Gtk.Widget, text: string, options?: TypeOptions): Promise<void> =>\n    runEditableEvent(widget, \"Cannot type into element\", (editable) => {\n        if (!options?.skipClick) {\n            editable.grabFocus();\n        }\n\n        applyInitialSelection(editable, options ?? {});\n        insertEditableText(editable, text);\n    });\n\nconst clear = (widget: Gtk.Widget): Promise<void> =>\n    runEditableEvent(widget, \"Cannot clear element\", (editable) => {\n        setEditableText(editable, \"\");\n    });\n\nconst copy = (widget: Gtk.Widget): Promise<void> =>\n    runEditableEvent(widget, \"Cannot copy\", (editable) => {\n        writeClipboardText(editable, readSelection(editable));\n    });\n\nconst cut = (widget: Gtk.Widget): Promise<void> =>\n    runEditableEvent(widget, \"Cannot cut\", (editable) => {\n        writeClipboardText(editable, readSelection(editable));\n        deleteSelection(editable);\n    });\n\nconst paste = async (widget: Gtk.Widget, text?: string): Promise<void> => {\n    if (!isEditable(widget)) {\n        throw new Error(`Cannot paste: ${EDITABLE_REQUIRED}`);\n    }\n\n    const content = text ?? (await widget.getClipboard().readTextAsync(null)) ?? \"\";\n\n    await wrapEvent(widget, () => {\n        insertEditableText(widget, content);\n    });\n};\n\nexport { resetClipboard, type, clear, copy, cut, paste, type TypeOptions };\n"]}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/user-event/text.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gdk from \"@gtkx/gi/gdk\";\nimport * as GObject from \"@gtkx/gi/gobject\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { EDITABLE_ROLES, type EditableTarget, getEditableDelegate, isEditable } from \"../editable.js\";\nimport { formatRoleList } from \"../role-helpers.js\";\nimport { wrapEvent } from \"./event-wrapper.js\";\n\n/** Options for `userEvent.type`. */\ntype TypeOptions = {\n    /** Focus the widget before typing; defaults to true. */\n    shouldFocus?: boolean | undefined;\n    /** Select from this offset before typing, replacing the selected range with the typed text. */\n    initialSelectionStart?: number | undefined;\n    /** End offset of the initial selection (defaults to the start offset). */\n    initialSelectionEnd?: number | undefined;\n};\n\nconst EDITABLE_REQUIRED = `expected editable widget (${formatRoleList(EDITABLE_ROLES)})`;\n\nconst insertEditableText = (widget: EditableTarget, text: string): void => {\n    if (widget instanceof Gtk.TextView) {\n        widget.emit(\"insert-at-cursor\", text);\n\n        return;\n    }\n\n    const target = getEditableDelegate(widget) ?? widget;\n\n    if (target instanceof Gtk.Text) {\n        target.emit(\"insert-at-cursor\", text);\n\n        return;\n    }\n\n    const position = widget.getPosition();\n    const newPosition = widget.insertText(text, text.length, position);\n    widget.setPosition(newPosition);\n};\n\nconst readSelection = (widget: EditableTarget): string => {\n    if (widget instanceof Gtk.TextView) {\n        const buffer = widget.getBuffer();\n        const [hasSelection, start, end] = buffer.getSelectionBounds();\n\n        return hasSelection ? buffer.getText(start, end, true) : \"\";\n    }\n\n    const [hasSelection, start, end] = widget.getSelectionBounds();\n\n    return hasSelection ? widget.getChars(start, end) : \"\";\n};\n\nconst deleteSelection = (widget: EditableTarget): void => {\n    if (widget instanceof Gtk.TextView) {\n        widget.getBuffer().deleteSelection(false, true);\n\n        return;\n    }\n\n    widget.deleteSelection();\n};\n\nconst setEditableText = (widget: EditableTarget, text: string): void => {\n    if (widget instanceof Gtk.TextView) {\n        widget.getBuffer().setText(text, text.length);\n\n        return;\n    }\n\n    widget.setText(text);\n};\n\nconst applyTextViewSelection = (widget: Gtk.TextView, start: number, end: number): void => {\n    const buffer = widget.getBuffer();\n    buffer.selectRange(buffer.getIterAtOffset(start), buffer.getIterAtOffset(end));\n\n    if (end !== start) {\n        deleteSelection(widget);\n    }\n};\n\nconst applyEditableSelection = (widget: Gtk.Editable, start: number, end: number): void => {\n    widget.selectRegion(start, end);\n\n    if (end !== start) {\n        widget.deleteSelection();\n    }\n\n    widget.setPosition(start);\n};\n\nconst applyInitialSelection = (widget: EditableTarget, options: TypeOptions): void => {\n    if (options.initialSelectionStart === undefined) {\n        return;\n    }\n\n    const start = options.initialSelectionStart;\n    const end = options.initialSelectionEnd ?? start;\n\n    if (widget instanceof Gtk.TextView) {\n        applyTextViewSelection(widget, start, end);\n\n        return;\n    }\n\n    applyEditableSelection(widget, start, end);\n};\n\nconst writeClipboardText = (widget: Gtk.Widget, text: string): void => {\n    const value = GObject.buildValue(GObject.TYPE_STRING, (v) => {\n        v.setString(text);\n    });\n\n    widget.getClipboard().set(value);\n};\n\nconst resetClipboard = (): void => {\n    Gdk.Display.getDefault()?.getClipboard().setContent(null);\n};\n\nconst runEditableEvent = (\n    widget: Gtk.Widget,\n    failure: string,\n    action: (editable: EditableTarget) => void,\n): Promise<void> =>\n    wrapEvent(widget, () => {\n        if (!isEditable(widget)) {\n            throw new Error(`${failure}: ${EDITABLE_REQUIRED}`);\n        }\n\n        action(widget);\n    });\n\n/**\n * Focuses the widget unless `shouldFocus` is false, applies any initial selection, and inserts the text\n * at the cursor.\n *\n * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.\n */\nconst type = (widget: Gtk.Widget, text: string, options?: TypeOptions): Promise<void> =>\n    runEditableEvent(widget, \"Cannot type into element\", (editable) => {\n        if (options?.shouldFocus ?? true) {\n            editable.grabFocus();\n        }\n\n        applyInitialSelection(editable, options ?? {});\n        insertEditableText(editable, text);\n    });\n\n/**\n * Replaces an editable widget's text with the empty string.\n *\n * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.\n */\nconst clear = (widget: Gtk.Widget): Promise<void> =>\n    runEditableEvent(widget, \"Cannot clear element\", (editable) => {\n        setEditableText(editable, \"\");\n    });\n\n/**\n * Writes an editable widget's selected text to its clipboard, or the empty string when nothing is selected.\n *\n * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.\n */\nconst copy = (widget: Gtk.Widget): Promise<void> =>\n    runEditableEvent(widget, \"Cannot copy\", (editable) => {\n        writeClipboardText(editable, readSelection(editable));\n    });\n\n/**\n * Writes an editable widget's selected text to its clipboard, then deletes that selection.\n *\n * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.\n */\nconst cut = (widget: Gtk.Widget): Promise<void> =>\n    runEditableEvent(widget, \"Cannot cut\", (editable) => {\n        writeClipboardText(editable, readSelection(editable));\n        deleteSelection(editable);\n    });\n\n/**\n * Inserts the given text at an editable widget's cursor, reading the clipboard instead when no text\n * is given.\n *\n * @throws When the widget is neither a Gtk.Editable nor a Gtk.TextView.\n */\nconst paste = async (widget: Gtk.Widget, text?: string): Promise<void> => {\n    if (!isEditable(widget)) {\n        throw new Error(`Cannot paste: ${EDITABLE_REQUIRED}`);\n    }\n\n    const content = text ?? (await widget.getClipboard().readTextAsync(null)) ?? \"\";\n\n    await wrapEvent(widget, () => {\n        insertEditableText(widget, content);\n    });\n};\n\nexport { resetClipboard, type, clear, copy, cut, paste, type TypeOptions };\n"]}

package/dist/wait-for.d.ts

@@ -1,6 +1,8 @@
 import type * as Gtk from "@gtkx/gi/gtk";
 import type { WaitForOptions } from "./types.js";
+/** Widgets watched for removal; null counts as already removed. */
 type RemovalTarget = Gtk.Widget | Gtk.Widget[] | null;
+/** The widgets to watch for removal, or a function re-read on every poll to locate them. */
 type ElementOrCallback = Gtk.Widget | Gtk.Widget[] | (() => RemovalTarget);
 /**
  * Repeatedly invokes a callback until it succeeds without throwing or the

package/dist/wait-for.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait-for.d.ts","sourceRoot":"","sources":["../src/wait-for.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,KAAK,aAAa,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;AACtD,KAAK,iBAAiB,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;AA6D3E;;;;;;;GAOG;AACH,QAAA,MAAM,OAAO,GAAI,CAAC,EAAE,UAAU,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,cAAc,KAAG,OAAO,CAAC,CAAC,CAoBvF,CAAC;AAyBF;;;;;;;GAOG;AACH,QAAA,MAAM,yBAAyB,GAC3B,mBAAmB,iBAAiB,EACpC,UAAU,cAAc,KACzB,OAAO,CAAC,IAAI,CAmBd,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC"}
+{"version":3,"file":"wait-for.d.ts","sourceRoot":"","sources":["../src/wait-for.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,mEAAmE;AACnE,KAAK,aAAa,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;AACtD,4FAA4F;AAC5F,KAAK,iBAAiB,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;AA6D3E;;;;;;;GAOG;AACH,QAAA,MAAM,OAAO,GAAI,CAAC,EAAE,UAAU,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,cAAc,KAAG,OAAO,CAAC,CAAC,CAoBvF,CAAC;AAyBF;;;;;;;GAOG;AACH,QAAA,MAAM,yBAAyB,GAC3B,mBAAmB,iBAAiB,EACpC,UAAU,cAAc,KACzB,OAAO,CAAC,IAAI,CAmBd,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/wait-for.js.map

@@ -1 +1 @@
-{"version":3,"file":"wait-for.js","sourceRoot":"","sources":["../src/wait-for.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { WaitForOptions } from \"./types.js\";\nimport { runWithActEnvironment } from \"./act.js\";\nimport { getConfig } from \"./config.js\";\nimport { timeoutError } from \"./errors.js\";\n\ntype PollResult<T> = { status: \"resolved\"; value: T } | { status: \"timedout\"; lastError: Error | null };\ntype RemovalTarget = Gtk.Widget | Gtk.Widget[] | null;\ntype ElementOrCallback = Gtk.Widget | Gtk.Widget[] | (() => RemovalTarget);\n\nconst DEFAULT_INTERVAL = 50;\nconst ELEMENT_NOT_REMOVED = new Error(\"Element not yet removed\");\n\nconst delay = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nconst copyStackTrace = (target: Error, source: Error): void => {\n    const { stack } = source;\n\n    if (stack === undefined) {\n        return;\n    }\n\n    const index = stack.indexOf(source.message);\n\n    if (index === -1) {\n        target.stack = stack;\n\n        return;\n    }\n\n    target.stack = stack.slice(0, index) + target.message + stack.slice(index + source.message.length);\n};\n\nconst pollUntilSuccess = async <T>(\n    callback: () => T | Promise<T>,\n    timeout: number,\n    interval: number,\n): Promise<PollResult<T>> => {\n    const startTime = Date.now();\n    let lastError: Error | null = null;\n\n    while (Date.now() - startTime < timeout) {\n        try {\n            const result = await callback();\n            await delay(0);\n\n            return { status: \"resolved\", value: result };\n        } catch (error) {\n            lastError = error as Error;\n            await delay(interval);\n        }\n    }\n\n    return { status: \"timedout\", lastError };\n};\n\nconst buildTimeoutError = (\n    timeout: number,\n    lastError: Error | null,\n    stackTraceError: Error,\n    onTimeout: ((error: Error) => Error) | undefined,\n): Error => {\n    const error = timeoutError(timeout, lastError);\n    const finalError = onTimeout ? onTimeout(error) : error;\n    copyStackTrace(finalError, stackTraceError);\n\n    return finalError;\n};\n\n/**\n * Repeatedly invokes a callback until it succeeds without throwing or the\n * timeout elapses, retrying on each rejection at a fixed interval.\n *\n * @param callback The assertion or query to retry; its resolved value is returned.\n * @param options Optional timeout, interval, and timeout error customization.\n * @returns The callback's result once it succeeds.\n */\nconst waitFor = <T>(callback: () => T | Promise<T>, options?: WaitForOptions): Promise<T> => {\n    if (typeof callback !== \"function\") {\n        throw new TypeError(\"Received `callback` arg must be a function\");\n    }\n\n    const stackTraceError = options?.stackTraceError ?? new Error(\"STACK_TRACE_MESSAGE\");\n\n    return Promise.resolve(\n        runWithActEnvironment(false, async () => {\n            const config = getConfig();\n            const { timeout = config.asyncUtilTimeout, interval = DEFAULT_INTERVAL, onTimeout } = options ?? {};\n            const result = await pollUntilSuccess(callback, timeout, interval);\n\n            if (result.status === \"resolved\") {\n                return result.value;\n            }\n\n            throw buildTimeoutError(timeout, result.lastError, stackTraceError, onTimeout);\n        }),\n    );\n};\n\nconst getTarget = (elementOrCallback: ElementOrCallback): RemovalTarget =>\n    typeof elementOrCallback === \"function\" ? elementOrCallback() : elementOrCallback;\n\nconst isWidgetRemoved = (widget: Gtk.Widget | null): boolean => {\n    if (widget === null) {\n        return true;\n    }\n\n    try {\n        return widget.getRoot() === null;\n    } catch {\n        return true;\n    }\n};\n\nconst isTargetRemoved = (target: RemovalTarget): boolean => {\n    if (Array.isArray(target)) {\n        return target.every((widget) => isWidgetRemoved(widget));\n    }\n\n    return isWidgetRemoved(target);\n};\n\n/**\n * Waits until the given widget or widgets are detached from the tree. Rejects\n * immediately if the target is already absent when called.\n *\n * @param elementOrCallback The widget, array of widgets, or a function\n * returning them to observe for removal.\n * @param options Optional timeout and interval settings.\n */\nconst waitForElementToBeRemoved = (\n    elementOrCallback: ElementOrCallback,\n    options?: WaitForOptions,\n): Promise<void> => {\n    const stackTraceError = new Error(\"STACK_TRACE_MESSAGE\");\n\n    if (isTargetRemoved(getTarget(elementOrCallback))) {\n        return Promise.reject(\n            new Error(\n                \"Element already removed: waitForElementToBeRemoved requires the element to be present initially\",\n            ),\n        );\n    }\n\n    return waitFor(\n        () => {\n            if (!isTargetRemoved(getTarget(elementOrCallback))) {\n                throw ELEMENT_NOT_REMOVED;\n            }\n        },\n        { ...options, stackTraceError },\n    );\n};\n\nexport { waitFor, waitForElementToBeRemoved };\n"]}
+{"version":3,"file":"wait-for.js","sourceRoot":"","sources":["../src/wait-for.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { WaitForOptions } from \"./types.js\";\nimport { runWithActEnvironment } from \"./act.js\";\nimport { getConfig } from \"./config.js\";\nimport { timeoutError } from \"./errors.js\";\n\ntype PollResult<T> = { status: \"resolved\"; value: T } | { status: \"timedout\"; lastError: Error | null };\n/** Widgets watched for removal; null counts as already removed. */\ntype RemovalTarget = Gtk.Widget | Gtk.Widget[] | null;\n/** The widgets to watch for removal, or a function re-read on every poll to locate them. */\ntype ElementOrCallback = Gtk.Widget | Gtk.Widget[] | (() => RemovalTarget);\n\nconst DEFAULT_INTERVAL = 50;\nconst ELEMENT_NOT_REMOVED = new Error(\"Element not yet removed\");\n\nconst delay = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms));\n\nconst copyStackTrace = (target: Error, source: Error): void => {\n    const { stack } = source;\n\n    if (stack === undefined) {\n        return;\n    }\n\n    const index = stack.indexOf(source.message);\n\n    if (index === -1) {\n        target.stack = stack;\n\n        return;\n    }\n\n    target.stack = stack.slice(0, index) + target.message + stack.slice(index + source.message.length);\n};\n\nconst pollUntilSuccess = async <T>(\n    callback: () => T | Promise<T>,\n    timeout: number,\n    interval: number,\n): Promise<PollResult<T>> => {\n    const startTime = Date.now();\n    let lastError: Error | null = null;\n\n    while (Date.now() - startTime < timeout) {\n        try {\n            const result = await callback();\n            await delay(0);\n\n            return { status: \"resolved\", value: result };\n        } catch (error) {\n            lastError = error as Error;\n            await delay(interval);\n        }\n    }\n\n    return { status: \"timedout\", lastError };\n};\n\nconst buildTimeoutError = (\n    timeout: number,\n    lastError: Error | null,\n    stackTraceError: Error,\n    onTimeout: ((error: Error) => Error) | undefined,\n): Error => {\n    const error = timeoutError(timeout, lastError);\n    const finalError = onTimeout ? onTimeout(error) : error;\n    copyStackTrace(finalError, stackTraceError);\n\n    return finalError;\n};\n\n/**\n * Repeatedly invokes a callback until it succeeds without throwing or the\n * timeout elapses, retrying on each rejection at a fixed interval.\n *\n * @param callback The assertion or query to retry; its resolved value is returned.\n * @param options Optional timeout, interval, and timeout error customization.\n * @returns The callback's result once it succeeds.\n */\nconst waitFor = <T>(callback: () => T | Promise<T>, options?: WaitForOptions): Promise<T> => {\n    if (typeof callback !== \"function\") {\n        throw new TypeError(\"Received `callback` arg must be a function\");\n    }\n\n    const stackTraceError = options?.stackTraceError ?? new Error(\"STACK_TRACE_MESSAGE\");\n\n    return Promise.resolve(\n        runWithActEnvironment(false, async () => {\n            const config = getConfig();\n            const { timeout = config.asyncUtilTimeout, interval = DEFAULT_INTERVAL, onTimeout } = options ?? {};\n            const result = await pollUntilSuccess(callback, timeout, interval);\n\n            if (result.status === \"resolved\") {\n                return result.value;\n            }\n\n            throw buildTimeoutError(timeout, result.lastError, stackTraceError, onTimeout);\n        }),\n    );\n};\n\nconst getTarget = (elementOrCallback: ElementOrCallback): RemovalTarget =>\n    typeof elementOrCallback === \"function\" ? elementOrCallback() : elementOrCallback;\n\nconst isWidgetRemoved = (widget: Gtk.Widget | null): boolean => {\n    if (widget === null) {\n        return true;\n    }\n\n    try {\n        return widget.getRoot() === null;\n    } catch {\n        return true;\n    }\n};\n\nconst isTargetRemoved = (target: RemovalTarget): boolean => {\n    if (Array.isArray(target)) {\n        return target.every((widget) => isWidgetRemoved(widget));\n    }\n\n    return isWidgetRemoved(target);\n};\n\n/**\n * Waits until the given widget or widgets are detached from the tree. Rejects\n * immediately if the target is already absent when called.\n *\n * @param elementOrCallback The widget, array of widgets, or a function\n * returning them to observe for removal.\n * @param options Optional timeout and interval settings.\n */\nconst waitForElementToBeRemoved = (\n    elementOrCallback: ElementOrCallback,\n    options?: WaitForOptions,\n): Promise<void> => {\n    const stackTraceError = new Error(\"STACK_TRACE_MESSAGE\");\n\n    if (isTargetRemoved(getTarget(elementOrCallback))) {\n        return Promise.reject(\n            new Error(\n                \"Element already removed: waitForElementToBeRemoved requires the element to be present initially\",\n            ),\n        );\n    }\n\n    return waitFor(\n        () => {\n            if (!isTargetRemoved(getTarget(elementOrCallback))) {\n                throw ELEMENT_NOT_REMOVED;\n            }\n        },\n        { ...options, stackTraceError },\n    );\n};\n\nexport { waitFor, waitForElementToBeRemoved };\n"]}

package/dist/widget-accessible-properties.d.ts

@@ -5,6 +5,7 @@ type WidgetValue = {
     max: number | null;
     text: string | null;
 };
+type CheckedState = "checked" | "unchecked" | "mixed";
 /**
  * Returns a widget's own text by trying its label, text, and title getters in
  * order, or null when none produce a value.
@@ -13,22 +14,47 @@ type WidgetValue = {
  */
 declare const getWidgetNodeText: (widget: Gtk.Widget) => string | null;
 declare const getWidgetLabelText: (widget: Gtk.Widget) => string | null;
+/**
+ * Returns a widget's own text, or the space-joined text of its descendants when it has none of its
+ * own, or null when neither produces a value.
+ *
+ * @param widget The widget whose subtree is read.
+ */
+declare const getWidgetTextContent: (widget: Gtk.Widget) => string | null;
 declare const getWidgetAccessibleName: (widget: Gtk.Widget) => string | null;
 declare const getWidgetName: (widget: Gtk.Widget) => string | null;
 declare const getWidgetPlaceholderText: (widget: Gtk.Widget) => string | null;
 declare const getWidgetDisplayValue: (widget: Gtk.Widget) => string | null;
-declare const getWidgetCheckedState: (widget: Gtk.Widget) => boolean | null;
+declare const hasDisplayValue: (widget: Gtk.Widget) => boolean;
+declare const isWidgetDisabled: (widget: Gtk.Widget) => boolean;
+declare const isWidgetVisible: (widget: Gtk.Widget) => boolean;
+declare const getWidgetRequiredState: (widget: Gtk.Widget) => boolean | null;
+declare const getWidgetSelection: (widget: Gtk.Widget) => string | null;
+declare const getWidgetCheckedState: (widget: Gtk.Widget) => CheckedState | null;
+declare const isWidgetChecked: (widget: Gtk.Widget) => boolean | null;
 declare const getWidgetPressedState: (widget: Gtk.Widget) => boolean | null;
 declare const getWidgetExpandedState: (widget: Gtk.Widget) => boolean | null;
 declare const getWidgetSelectedState: (widget: Gtk.Widget) => boolean | null;
 declare const getWidgetLevel: (widget: Gtk.Widget) => number | null;
+/**
+ * Returns the accessible invalid state declared on a widget, or null when it declares none.
+ *
+ * @param widget The widget to read the state from.
+ */
 declare const getWidgetInvalidState: (widget: Gtk.Widget) => Gtk.AccessibleInvalidState | null;
+/**
+ * Returns the widgets a widget's accessible error-message relation points at, or null when it
+ * declares none.
+ *
+ * @param widget The widget to read the relation from.
+ */
 declare const getWidgetErrorMessage: (widget: Gtk.Widget) => Gtk.Widget[] | null;
 declare const getWidgetBusyState: (widget: Gtk.Widget) => boolean | null;
 declare const getWidgetDescription: (widget: Gtk.Widget) => string | null;
 declare const getWidgetValue: (widget: Gtk.Widget) => WidgetValue;
 declare const getWidgetOwnLabel: (widget: Gtk.Widget) => string | null;
 declare const getWidgetLabelledByText: (widget: Gtk.Widget) => string | null;
+declare const getWidgetDescribedByText: (widget: Gtk.Widget) => string | null;
 declare const isInaccessible: (widget: Gtk.Widget) => boolean;
-export { getWidgetNodeText, getWidgetLabelText, getWidgetAccessibleName, getWidgetName, getWidgetPlaceholderText, getWidgetDisplayValue, getWidgetCheckedState, getWidgetPressedState, getWidgetExpandedState, getWidgetSelectedState, getWidgetLevel, getWidgetInvalidState, getWidgetErrorMessage, getWidgetBusyState, getWidgetDescription, getWidgetValue, getWidgetOwnLabel, getWidgetLabelledByText, isInaccessible, type WidgetValue, };
+export { getWidgetNodeText, getWidgetTextContent, getWidgetLabelText, getWidgetAccessibleName, getWidgetName, getWidgetPlaceholderText, getWidgetDisplayValue, hasDisplayValue, isWidgetDisabled, isWidgetVisible, getWidgetRequiredState, getWidgetSelection, getWidgetDescribedByText, getWidgetCheckedState, isWidgetChecked, getWidgetPressedState, getWidgetExpandedState, getWidgetSelectedState, getWidgetLevel, getWidgetInvalidState, getWidgetErrorMessage, getWidgetBusyState, getWidgetDescription, getWidgetValue, getWidgetOwnLabel, getWidgetLabelledByText, isInaccessible, type CheckedState, type WidgetValue, };
 //# sourceMappingURL=widget-accessible-properties.d.ts.map

package/dist/widget-accessible-properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-accessible-properties.d.ts","sourceRoot":"","sources":["../src/widget-accessible-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAKpC,KAAK,WAAW,GAAG;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AA4DF;;;;;GAKG;AACH,QAAA,MAAM,iBAAiB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAUxD,CAAC;AAqCF,QAAA,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAMzD,CAAC;AAYF,QAAA,MAAM,uBAAuB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IA0B9D,CAAC;AAEF,QAAA,MAAM,aAAa,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAEpD,CAAC;AAEF,QAAA,MAAM,wBAAwB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAM/D,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAM5D,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,GAAG,IAc7D,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,GAAG,IAM7D,CAAC;AAEF,QAAA,MAAM,sBAAsB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,GAAG,IAU9D,CAAC;AAEF,QAAA,MAAM,sBAAsB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,GAAG,IAU9D,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAErD,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,sBAAsB,GAAG,IAIhF,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,GAAG,CAAC,MAAM,EAAE,GAAG,IACR,CAAC;AAE5D,QAAA,MAAM,kBAAkB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAAO,GAAG,IAE1D,CAAC;AAEF,QAAA,MAAM,oBAAoB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAE3D,CAAC;AA8CF,QAAA,MAAM,cAAc,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,WAc5C,CAAC;AAEF,QAAA,MAAM,iBAAiB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAExD,CAAC;AAgBF,QAAA,MAAM,uBAAuB,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,MAAM,GAAG,IAU9D,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,QAAQ,GAAG,CAAC,MAAM,KAAG,OAgB5C,CAAC;AAEF,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,KAAK,WAAW,GACnB,CAAC"}
+{"version":3,"file":"widget-accessible-properties.d.ts","sourceRoot":"","sources":["../src/widget-accessible-properties.ts"],"names":[],"mappings":"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"}

package/dist/widget-accessible-properties.js

@@ -3,6 +3,13 @@ import { getAccessibleMetadata } from "@gtkx/react/internal";
 import { EDITABLE_ROLES, isEditable, readEditableText } from "./editable.js";
 import { descendants } from "./traversal.js";
 const DEFAULT_TEXT_GETTERS = ["getLabel", "getText", "getTitle"];
+const SELECTABLE_ROLES = new Set([
+    Gtk.AccessibleRole.ROW,
+    Gtk.AccessibleRole.LIST_ITEM,
+    Gtk.AccessibleRole.GRID_CELL,
+    Gtk.AccessibleRole.OPTION,
+    Gtk.AccessibleRole.TREE_ITEM,
+]);
 const callStringGetter = (widget, method) => {
     const fn = Reflect.get(widget, method);
     if (typeof fn !== "function") {
@@ -85,6 +92,41 @@ const getWidgetLabelText = (widget) => {
     }
     return getLabelText(widget);
 };
+const getChildren = function* (widget) {
+    let child = widget.getFirstChild();
+    while (child) {
+        yield child;
+        child = child.getNextSibling();
+    }
+};
+const textContentParts = (widget) => {
+    const own = getWidgetNodeText(widget);
+    if (own !== null) {
+        return [own];
+    }
+    return [...getChildren(widget)].flatMap((child) => textContentParts(child));
+};
+/**
+ * Returns a widget's own text, or the space-joined text of its descendants when it has none of its
+ * own, or null when neither produces a value.
+ *
+ * @param widget The widget whose subtree is read.
+ */
+const getWidgetTextContent = (widget) => {
+    const parts = textContentParts(widget);
+    return parts.length > 0 ? parts.join(" ") : null;
+};
+const isComboBoxFaceCandidate = (widget) => !(widget instanceof Gtk.Popover) && widget.getChildVisible();
+const comboBoxChildFaceText = (child) => isComboBoxFaceCandidate(child) ? getWidgetLabelText(child) ?? comboBoxFaceText(child) : null;
+const comboBoxFaceText = (widget) => {
+    for (const child of getChildren(widget)) {
+        const text = comboBoxChildFaceText(child);
+        if (text !== null) {
+            return text;
+        }
+    }
+    return null;
+};
 const tabPanelTitle = (widget) => {
     const parent = widget.getParent();
     if (parent instanceof Gtk.Stack) {
@@ -97,6 +139,10 @@ const getWidgetAccessibleName = (widget) => {
     if (role === Gtk.AccessibleRole.TAB_PANEL) {
         return tabPanelTitle(widget);
     }
+    const labelledByText = getWidgetLabelledByText(widget);
+    if (labelledByText) {
+        return labelledByText;
+    }
     const accessibleLabel = readAccessibleString(widget, "accessibleLabel");
     if (accessibleLabel) {
         return accessibleLabel;
@@ -118,26 +164,73 @@ const getWidgetPlaceholderText = (widget) => {
     if (!EDITABLE_ROLES.has(widget.getAccessibleRole()) || !(widget instanceof Gtk.Editable)) {
         return null;
     }
-    return callStringGetter(widget, "getPlaceholderText");
+    const fromGetter = callStringGetter(widget, "getPlaceholderText");
+    if (fromGetter !== null) {
+        return fromGetter;
+    }
+    const fromAccessor = Reflect.get(widget, "placeholderText");
+    return typeof fromAccessor === "string" && fromAccessor !== "" ? fromAccessor : null;
 };
 const getWidgetDisplayValue = (widget) => {
     if (EDITABLE_ROLES.has(widget.getAccessibleRole()) && isEditable(widget)) {
         return readEditableText(widget);
     }
+    if (widget.getAccessibleRole() === Gtk.AccessibleRole.COMBO_BOX) {
+        return comboBoxFaceText(widget);
+    }
+    return null;
+};
+const hasDisplayValue = (widget) => {
+    const role = widget.getAccessibleRole();
+    return (EDITABLE_ROLES.has(role) && isEditable(widget)) || role === Gtk.AccessibleRole.COMBO_BOX;
+};
+const isWidgetDisabled = (widget) => !widget.isSensitive();
+const hasZeroOpacityAncestor = (widget) => {
+    let current = widget;
+    while (current) {
+        if (current.getOpacity() === 0) {
+            return true;
+        }
+        current = current.getParent();
+    }
+    return false;
+};
+const isWidgetVisible = (widget) => widget.isVisible() && !hasZeroOpacityAncestor(widget);
+const getWidgetRequiredState = (widget) => readAccessibleBoolean(widget, "accessibleRequired");
+const readTextViewSelection = (view) => {
+    const buffer = view.getBuffer();
+    const [hasSelection, start, end] = buffer.getSelectionBounds();
+    return hasSelection ? buffer.getText(start, end, true) : null;
+};
+const readEditableSelection = (editable) => {
+    const [hasSelection, start, end] = editable.getSelectionBounds();
+    return hasSelection ? editable.getChars(start, end) : null;
+};
+const getWidgetSelection = (widget) => {
+    if (widget instanceof Gtk.TextView) {
+        return readTextViewSelection(widget);
+    }
+    if (widget instanceof Gtk.Editable) {
+        return readEditableSelection(widget);
+    }
     return null;
 };
+const checkedFromActive = (isActive) => (isActive ? "checked" : "unchecked");
+const isCheckableToggle = (widget) => widget instanceof Gtk.Switch ||
+    (widget instanceof Gtk.ToggleButton && widget.getAccessibleRole() === Gtk.AccessibleRole.RADIO);
 const getWidgetCheckedState = (widget) => {
     if (widget instanceof Gtk.CheckButton) {
-        return widget.getActive();
+        return widget.getInconsistent() ? "mixed" : checkedFromActive(widget.getActive());
     }
-    if (widget instanceof Gtk.Switch) {
-        return widget.getActive();
-    }
-    if (widget instanceof Gtk.ToggleButton && widget.getAccessibleRole() === Gtk.AccessibleRole.RADIO) {
-        return widget.getActive();
+    if (isCheckableToggle(widget)) {
+        return checkedFromActive(Reflect.get(widget, "active") === true);
     }
     return null;
 };
+const isWidgetChecked = (widget) => {
+    const state = getWidgetCheckedState(widget);
+    return state === null || state === "mixed" ? null : state === "checked";
+};
 const getWidgetPressedState = (widget) => {
     if (widget instanceof Gtk.ToggleButton) {
         return widget.getActive();
@@ -154,10 +247,10 @@ const getWidgetExpandedState = (widget) => {
     return null;
 };
 const getWidgetSelectedState = (widget) => {
-    if (widget instanceof Gtk.ListBoxRow) {
+    if (widget instanceof Gtk.ListBoxRow || widget instanceof Gtk.FlowBoxChild) {
         return widget.isSelected();
     }
-    if (widget.getAccessibleRole() === Gtk.AccessibleRole.ROW) {
+    if (SELECTABLE_ROLES.has(widget.getAccessibleRole())) {
         return (widget.getStateFlags() & Gtk.StateFlags.SELECTED) !== 0;
     }
     return null;
@@ -165,10 +258,21 @@ const getWidgetSelectedState = (widget) => {
 const getWidgetLevel = (widget) => {
     return readAccessibleNumber(widget, "accessibleLevel");
 };
+/**
+ * Returns the accessible invalid state declared on a widget, or null when it declares none.
+ *
+ * @param widget The widget to read the state from.
+ */
 const getWidgetInvalidState = (widget) => {
     const value = readAccessibleNumber(widget, "accessibleInvalid");
     return value ?? null;
 };
+/**
+ * Returns the widgets a widget's accessible error-message relation points at, or null when it
+ * declares none.
+ *
+ * @param widget The widget to read the relation from.
+ */
 const getWidgetErrorMessage = (widget) => readAccessibleWidgets(widget, "accessibleErrorMessage");
 const getWidgetBusyState = (widget) => {
     return readAccessibleBoolean(widget, "accessibleBusy");
@@ -243,6 +347,21 @@ const getWidgetLabelledByText = (widget) => {
     const texts = collectAccessibleNames(targets);
     return texts.length > 0 ? texts.join(" ") : null;
 };
+const isTooltipUsedAsName = (widget) => readAccessibleString(widget, "accessibleLabel") === null &&
+    getWidgetNodeText(widget) === null &&
+    collectLabels(widget).length === 0;
+const getWidgetDescribedByText = (widget) => {
+    const targets = readAccessibleWidgets(widget, "accessibleDescribedBy");
+    const texts = targets === null ? [] : collectAccessibleNames(targets);
+    if (texts.length > 0) {
+        return texts.join(" ");
+    }
+    const description = readAccessibleString(widget, "accessibleDescription");
+    if (description !== null) {
+        return description;
+    }
+    return isTooltipUsedAsName(widget) ? null : callStringGetter(widget, "getTooltipText");
+};
 const isInaccessible = (widget) => {
     let current = widget;
     while (current) {
@@ -256,5 +375,5 @@ const isInaccessible = (widget) => {
     }
     return false;
 };
-export { getWidgetNodeText, getWidgetLabelText, getWidgetAccessibleName, getWidgetName, getWidgetPlaceholderText, getWidgetDisplayValue, getWidgetCheckedState, getWidgetPressedState, getWidgetExpandedState, getWidgetSelectedState, getWidgetLevel, getWidgetInvalidState, getWidgetErrorMessage, getWidgetBusyState, getWidgetDescription, getWidgetValue, getWidgetOwnLabel, getWidgetLabelledByText, isInaccessible, };
+export { getWidgetNodeText, getWidgetTextContent, getWidgetLabelText, getWidgetAccessibleName, getWidgetName, getWidgetPlaceholderText, getWidgetDisplayValue, hasDisplayValue, isWidgetDisabled, isWidgetVisible, getWidgetRequiredState, getWidgetSelection, getWidgetDescribedByText, getWidgetCheckedState, isWidgetChecked, getWidgetPressedState, getWidgetExpandedState, getWidgetSelectedState, getWidgetLevel, getWidgetInvalidState, getWidgetErrorMessage, getWidgetBusyState, getWidgetDescription, getWidgetValue, getWidgetOwnLabel, getWidgetLabelledByText, isInaccessible, };
 //# sourceMappingURL=widget-accessible-properties.js.map