@girs/atspi-2.0 2.0.0-3.2.2 → 2.0.0-3.2.4

package/README.md

@@ -5,7 +5,7 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/atspi-2.0)
 
 
-GJS TypeScript type definitions for Atspi-2.0, generated from library version 2.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.2.
+GJS TypeScript type definitions for Atspi-2.0, generated from library version 2.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.4.
 
 AT-SPI2 is a D-Bus based accessibility framework. It defines a D-Bus protocol for providing and accessing application accessibility information. The project includes a library for bridging the D-Bus protocol to the ATK API, allowing Gtk based applications to be made accessible.
 

package/atspi-2.0.d.cts

@@ -288,6 +288,26 @@ export enum KeySynthType {
      */
     UNLOCKMODIFIERS,
 }
+/**
+ * Enumeration used to indicate a type of live region and how assertive it
+ * should be in terms of speaking notifications. Currently, this is only used
+ * for "announcement" events, but it may be used for additional purposes
+ * in the future.
+ */
+export enum Live {
+    /**
+     * No live region.
+     */
+    NONE,
+    /**
+     * This live region should be considered polite.
+     */
+    POLITE,
+    /**
+     * This live region should be considered assertive.
+     */
+    ASSERTIVE,
+}
 /**
  * Used by interfaces #AtspiText and #AtspiDocument, this
  * enumeration corresponds to the POSIX 'setlocale' enum values.
@@ -603,7 +623,7 @@ export enum Role {
      */
     DATE_EDITOR,
     /**
-     * An inconifed internal frame within a DESKTOP_PANE.
+     * An inconifed internal frame within a DESKTOP_FRAME.
      */
     DESKTOP_ICON,
     /**
@@ -626,14 +646,14 @@ export enum Role {
      */
     DIRECTORY_PANE,
     /**
-     * A specialized dialog that displays the files in
-     * the directory and lets the user select a file, browse a different
-     * directory, or specify a filename.
+     * An object used for drawing custom user interface
+     * elements.
      */
     DRAWING_AREA,
     /**
-     * An object used for drawing custom user interface
-     * elements.
+     * A specialized dialog that displays the files in
+     * the directory and lets the user select a file, browse a different
+     * directory, or specify a filename.
      */
     FILE_CHOOSER,
     /**
@@ -793,14 +813,13 @@ export enum Role {
     SEPARATOR,
     /**
      * An object that allows the user to select from a bounded
-     * range.
+     * range.  Unlike `ATSPI_ROLE_SCROLL_BAR,` `ATSPI_ROLE_SLIDER` objects need not control
+     * 'viewport'-like objects.
      */
     SLIDER,
     /**
      * An object which allows one of a set of choices to
-     * be selected, and which displays the current choice.  Unlike
-     * `ATSPI_ROLE_SCROLL_BAR,` `ATSPI_ROLE_SLIDER` objects need not control
-     * 'viewport'-like objects.
+     * be selected, and which displays the current choice.
      */
     SPIN_BUTTON,
     /**
@@ -923,7 +942,7 @@ export enum Role {
     /**
      * An object corresponding to the toplevel accessible
      * of an application, which may contain `ATSPI_ROLE_FRAME` objects or other
-     * accessible objects. Children of #AccessibleDesktop objects  are generally
+     * accessible objects. Children of objects with the #ATSPI_ROLE_DESKTOP_FRAME role are generally
      * `ATSPI_ROLE_APPLICATION` objects.
      */
     APPLICATION,
@@ -1259,14 +1278,18 @@ export enum Role {
     /**
      * A container for content that is called out as a proposed
      * change from the current version of the document, such as by a reviewer of the
-     * content. This role should include either %ATSPI_ROLE_CONTENT_DELETION and/or
-     * %ATSPI_ROLE_CONTENT_INSERTION children, in any order, to indicate what the
+     * content. An object with this role should include children with %ATSPI_ROLE_CONTENT_DELETION and/or
+     * %ATSPI_ROLE_CONTENT_INSERTION, in any order, to indicate what the
      * actual change is. `Since:` 2.36
      */
     SUGGESTION,
+    /**
+     * A specialized push button to open a menu. `Since` 2.46
+     */
+    PUSH_BUTTON_MENU,
     /**
      * Not a valid role, used for finding end of
-     *  enumeration.
+     * enumeration.
      */
     LAST_DEFINED,
 }
@@ -1769,7 +1792,7 @@ export enum KeyListenerSyncType {
     NOSYNC,
     /**
      * Events are delivered synchronously, before the
-     * currently focussed application sees them.
+     * currently focused application sees them.
      */
     SYNCHRONOUS,
     /**
@@ -1938,6 +1961,14 @@ export function generate_keyboard_event(keyval: number, keystring: string | null
  * @returns %TRUE if successful, otherwise %FALSE.
  */
 export function generate_mouse_event(x: number, y: number, name: string | null): boolean
+/**
+ * Like atspi_generate_mouse_event, but asynchronous.
+ * @param x a #glong indicating the screen x coordinate of the mouse event.
+ * @param y a #glong indicating the screen y coordinate of the mouse event.
+ * @param name a string indicating which mouse event to be synthesized        (e.g. "b1p", "b1c", "b2r", "rel", "abs").
+ * @param callback a callback to be called when a reply is received. May be NULL.
+ */
+export function generate_mouse_event_async(x: number, y: number, name: string | null, callback: GenerateMouseEventCB | null): void
 /**
  * Gets the virtual desktop indicated by index `i`.
  * NOTE: currently multiple virtual desktops are not implemented;
@@ -1966,6 +1997,10 @@ export function get_desktop_count(): number
  * @returns a #GArray of desktops.
  */
 export function get_desktop_list(): Accessible[]
+/**
+ * Returns the version of the AT-SPI library being used at runtime.
+ */
+export function get_version(): [ /* major */ number, /* minor */ number, /* micro */ number ]
 /**
  * Connects to the accessibility registry and initializes the SPI.
  * @returns 0 on success, 1 if already initialized, or an integer error code.
@@ -1977,11 +2012,11 @@ export function init(): number
  */
 export function is_initialized(): boolean
 /**
- * Registers a listener for device events, for instance button events.
- * @param listener a pointer to the #AtspiDeviceListener which requests             the events.
- * @param event_types an #AtspiDeviceEventMask mask indicating which             types of key events are requested (%ATSPI_KEY_PRESSED, etc.).
- * @param filter Unused parameter.
- * @returns %TRUE if successful, otherwise %FALSE.
+ * This function does nothing and should not be called.
+ * @param listener 
+ * @param event_types 
+ * @param filter 
+ * @returns Always returns %FALSE.
  */
 export function register_device_event_listener(listener: DeviceListener, event_types: DeviceEventMask, filter: any | null): boolean
 /**
@@ -2000,9 +2035,14 @@ export function register_device_event_listener(listener: DeviceListener, event_t
  * @returns %TRUE if successful, otherwise %FALSE.
  */
 export function register_keystroke_listener(listener: DeviceListener, key_set: KeyDefinition[] | null, modmask: KeyMaskType, event_types: KeyEventMask, sync_type: KeyListenerSyncType): boolean
+/**
+ * Gets the localized description string describing the #AtspiRole `role`.
+ * @param role an #AtspiRole object to query.
+ * @returns the localized string describing the AtspiRole
+ */
+export function role_get_localized_name(role: Role): string | null
 /**
  * Gets a localizable string that indicates the name of an #AtspiRole.
- * <em>DEPRECATED.</em>
  * @param role an #AtspiRole object to query.
  * @returns a localizable string name for an #AtspiRole enumerated type.
  */
@@ -2016,18 +2056,13 @@ export function role_get_name(role: Role): string | null
  */
 export function set_main_context(cnx: GLib.MainContext): void
 /**
- * Sets the reference window that will be used when atspi_generate_mouse_event
- * is called. Coordinates will be assumed to be relative to this window. This
- * is needed because, due to Wayland's security model, it is not currently
- * possible to retrieve global coordinates.
- * If NULL is passed, then AT-SPI will use the window that has focus at the
- * time that atspi_generate_mouse_event is called.
+ * Deprecated. This function no longer does anything and should not be used.
  * @param accessible the #AtspiAccessible corresponding to the window to select.              should be a top-level window with a role of              ATSPI_ROLE_APPLICATION.
  */
 export function set_reference_window(accessible: Accessible): void
 /**
  * Set the timeout used for method calls. If this is not set explicitly,
- * a default of 0.8 ms is used.
+ * a default of 800 ms is used.
  * Note that at-spi2-registryd currently uses a timeout of 3 seconds when
  * sending a keyboard event notification. This means that, if an AT makes
  * a call in response to the keyboard notification and the application
@@ -2077,6 +2112,9 @@ export interface EventListenerCB {
 export interface EventListenerSimpleCB {
     (event: Event): void
 }
+export interface GenerateMouseEventCB {
+    (): void
+}
 /**
  * A callback that will be invoked when a key is pressed.
  * @callback 
@@ -2246,6 +2284,15 @@ export interface Collection {
     disconnect(id: number): void
 }
 
+/**
+ * An interface designed to allow accessibles which satisfy a set of
+ * criteria to be returned.
+ * 
+ * An interface designed to allow accessibles which satisfy a set of
+ * criteria to be returned. This interface can be used to avoid iteration
+ * or client-side search of the object tree.
+ * @interface 
+ */
 export class Collection extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Collection
@@ -2352,8 +2399,8 @@ export interface Component {
     scroll_to_point(coords: CoordType, x: number, y: number): boolean
     /**
      * Moves and resizes the specified component.
-     * @param x the new vertical position to which the component should be moved.
-     * @param y the new horizontal position to which the component should be moved.
+     * @param x the new horizontal position to which the component should be moved.
+     * @param y the new vertical position to which the component should be moved.
      * @param width the width to which the component should be resized.
      * @param height the height to which the component should be resized.
      * @param ctype the coordinate system in which the position is specified.         (e.g. ATSPI_COORD_TYPE_WINDOW, ATSPI_COORD_TYPE_SCREEN).
@@ -2362,14 +2409,14 @@ export interface Component {
     set_extents(x: number, y: number, width: number, height: number, ctype: CoordType): boolean
     /**
      * Moves the component to the specified position.
-     * @param x the new vertical position to which the component should be moved.
-     * @param y the new horizontal position to which the component should be moved.
+     * @param x the new horizontal position to which the component should be moved.
+     * @param y the new vertical position to which the component should be moved.
      * @param ctype the coordinate system in which the position is specified.         (e.g. ATSPI_COORD_TYPE_WINDOW, ATSPI_COORD_TYPE_SCREEN).
      * @returns #TRUE if successful; #FALSE otherwise.
      */
     set_position(x: number, y: number, ctype: CoordType): boolean
     /**
-     * Resizes the specified component to the given coordinates.
+     * Resizes the specified component to the given pixel dimensions.
      * @param width the width to which the component should be resized.
      * @param height the height to which the component should be resized.
      * @returns #TRUE if successful; #FALSE otherwise.
@@ -2384,6 +2431,20 @@ export interface Component {
     disconnect(id: number): void
 }
 
+/**
+ * An interface implemented by objects which have onscreen visual
+ * representations.
+ * 
+ * The Component interface is implemented by objects which occupy on-screen
+ * space, e.g. objects which have onscreen visual representations. The methods
+ * in Component allow clients to identify where the objects lie in the onscreen
+ * coordinate system, their relative size, stacking order, and position. It
+ * also provides a mechanism whereby keyboard focus may be transferred to
+ * specific user interface elements programmatically.  This is a 2D API.
+ * Coordinates of 3D objects are projected into the 2-dimensional screen view
+ * for purposes of this interface.
+ * @interface 
+ */
 export class Component extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Component
@@ -2591,6 +2652,17 @@ export interface Hypertext {
     disconnect(id: number): void
 }
 
+/**
+ * An interface used for objects which implement linking between
+ * multiple resource locations.
+ * 
+ * An interface used for objects which implement linking between
+ * multiple resource or content locations, or multiple 'markers'
+ * within a single document. A hypertext instance is associated
+ * with one or more hyperlinks which are associated with particular
+ * offsets within the hypertext's content.
+ * @interface 
+ */
 export class Hypertext extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Hypertext
@@ -2764,6 +2836,17 @@ export interface Selection {
     disconnect(id: number): void
 }
 
+/**
+ * An interface which indicates that an object exposes a 'selection' model,
+ * allowing the selection of one or more of its children.
+ * 
+ * An interface which indicates that an object exposes a 'selection'
+ * model, allowing the selection of one or more of its children.
+ * Read-only Selection instances are possible, in which case the
+ * interface is used to programmatically determine the selected-ness
+ * of its children.
+ * @interface 
+ */
 export class Selection extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Selection
@@ -3011,6 +3094,20 @@ export interface Table {
     disconnect(id: number): void
 }
 
+/**
+ * An interface used by containers whose data is arranged in a tabular form.
+ * 
+ * An interface used by containers whose contained data is arranged
+ * in a tabular (i.e. row-column) form. Tables may resemble
+ * a two-dimensional grid, as in a spreadsheet, or may feature objects
+ * which span multiple rows and/or columns, but whose bounds are
+ * aligned on a row/column matrix. Objects within tables are children
+ * of the table object, and they may be referenced either via a child
+ * index or via a row/column pair. Table 'cells' may implement other
+ * interfaces, such as Text, Action, Image, and Component, and should do
+ * so as appropriate to their onscreen presentation and/or behavior.
+ * @interface 
+ */
 export class Table extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Table
@@ -3139,7 +3236,6 @@ export interface Text {
      * Gets the attributes applied to a range of text from an #AtspiText
      * object. The text attributes correspond to CSS attributes
      * where possible.
-     * <em>DEPRECATED</em>
      * @param offset a #gint indicating the offset from which the attribute        search is based.
      * @returns a #GHashTable describing the attributes at the given character offset.
      */
@@ -3340,6 +3436,18 @@ export interface Text {
     disconnect(id: number): void
 }
 
+/**
+ * An interface implemented by objects which place textual
+ * information onscreen.
+ * 
+ * The text interface should be implemented by objects which place textual
+ * information onscreen as character strings or glyphs. The text interface
+ * allows access to textual content including display attributes and
+ * semantic hints associated with runs of text, and to bounding
+ * information for glyphs and substrings. It also allows portions of text to
+ * be selected, if the objects StateSet includes STATE_SELECTABLE_TEXT.
+ * @interface 
+ */
 export class Text extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Text
@@ -3407,6 +3515,16 @@ export interface Value {
     disconnect(id: number): void
 }
 
+/**
+ * An interface supporting a one-dimensional scalar
+ * to be modified, or which reflects its value.
+ * 
+ * An interface supporting a one-dimensional scalar
+ * to be modified, or which reflects its value. If
+ * STATE_EDITABLE is not present, the value is
+ * treated as "read only".
+ * @interface 
+ */
 export class Value extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Value
@@ -3469,6 +3587,10 @@ export interface Accessible extends Action, Collection, Component, Document, Edi
      * descendants.
      */
     clear_cache(): void
+    /**
+     * Clears the cached information only for the given accessible.
+     */
+    clear_cache_single(): void
     /**
      * Gets the accessible id of the accessible.  This is not meant to be presented
      * to the user, but to be an id which is stable over application development.
@@ -3729,6 +3851,14 @@ export interface Accessible extends Action, Collection, Component, Document, Edi
     disconnect(id: number): void
 }
 
+/**
+ * The base interface which is implemented by all accessible objects.
+ * 
+ * All objects support interfaces for querying their contained 'children'
+ * and position in the accessible-object hierarchy, whether or not they
+ * actually have children.
+ * @class 
+ */
 export class Accessible extends Object {
 
     // Own properties of Atspi-2.0.Atspi.Accessible
@@ -3774,6 +3904,14 @@ export interface Application {
     disconnect(id: number): void
 }
 
+/**
+ * An interface identifying the root object associated
+ * with a running application.
+ * 
+ * An interface identifying an object which is the root of the
+ * hierarchy associated with a running application.
+ * @class 
+ */
 export class Application extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Application
@@ -3818,7 +3956,7 @@ export interface Device {
      */
     get_locked_modifiers(): number
     /**
-     * Gets the modifier for a given keycode, if one exists. Does not creatt a new
+     * Gets the modifier for a given keycode, if one exists. Does not create a new
      * mapping. This function should be used when the intention is to query a
      * locking modifier such as num lock via atspi_device_get_locked_modifiers,
      * rather than to add key grabs.
@@ -3873,7 +4011,7 @@ export interface Device {
      */
     vfunc_get_locked_modifiers(): number
     /**
-     * Gets the modifier for a given keycode, if one exists. Does not creatt a new
+     * Gets the modifier for a given keycode, if one exists. Does not create a new
      * mapping. This function should be used when the intention is to query a
      * locking modifier such as num lock via atspi_device_get_locked_modifiers,
      * rather than to add key grabs.
@@ -4203,6 +4341,7 @@ export interface EventListener {
      *            object:column-deleted
      *            object:model-changed
      *            object:active-descendant-changed
+     *            object:announcement
      * 
      *  (screen reader events)
      *             screen-reader:region-changed
@@ -4277,6 +4416,16 @@ export interface EventListener {
     disconnect(id: number): void
 }
 
+/**
+ * A generic interface implemented by objects for the receipt of event
+ * notifications.
+ * 
+ * A generic interface implemented by objects for the receipt of event
+ * notifications. atspi-event-listener is the interface via which clients of
+ * the atspi-registry receive notification of changes to an application's user
+ * interface and content.
+ * @class 
+ */
 export class EventListener extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.EventListener
@@ -4391,6 +4540,19 @@ export interface Hyperlink {
     disconnect(id: number): void
 }
 
+/**
+ * Instances of atspi-hyperlink are the means by which end users
+ * and clients interact with linked content.
+ * 
+ *  Instances of atspi-hyperlink are returned by
+ * atspi-hypertext objects, and are the means by
+ * which end users and clients interact with linked,
+ * and in some cases embedded, content. These instances
+ * may have multiple "anchors", where an anchor corresponds to a
+ * reference to a particular resource with a corresponding resource
+ * identified (URI).
+ * @class 
+ */
 export class Hyperlink extends Object {
 
     // Own properties of Atspi-2.0.Atspi.Hyperlink
@@ -4436,6 +4598,11 @@ export interface MatchRule {
     disconnect(id: number): void
 }
 
+/**
+ * An interface that allows the definition of match rules
+ * for accessible objects.
+ * @class 
+ */
 export class MatchRule extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.MatchRule
@@ -4456,7 +4623,7 @@ export class MatchRule extends GObject.Object {
      * @param attributematchtype An #AtspiCollectionMatchType specifying how to          interpret `attributes`.
      * @param roles A #GArray of roles to match, or NULL if          not applicable.
      * @param rolematchtype An #AtspiCollectionMatchType specifying how to          interpret `roles`.
-     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by their DBus names (org.a11y.Atspi.Accessible,          org.a11y.Atspi.Component, etc).
+     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by the final component of their DBus names (Accessible,          Component, etc).
      * @param interfacematchtype An #AtspiCollectionMatchType specifying how to          interpret `interfaces`.
      * @param invert if #TRUE, the match rule should be denied (inverted); if #FALSE,          it should not. For example, if the match rule defines that a match is          an object of ROLE_HEADING which has STATE_FOCUSABLE and a click action,          inverting it would match all objects that are not of ROLE_HEADING,          focusable and clickable at the same time.
      * @returns A new #AtspiMatchRule.
@@ -4472,7 +4639,7 @@ export class MatchRule extends GObject.Object {
      * @param attributematchtype An #AtspiCollectionMatchType specifying how to          interpret `attributes`.
      * @param roles A #GArray of roles to match, or NULL if          not applicable.
      * @param rolematchtype An #AtspiCollectionMatchType specifying how to          interpret `roles`.
-     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by their DBus names (org.a11y.Atspi.Accessible,          org.a11y.Atspi.Component, etc).
+     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by the final component of their DBus names (Accessible,          Component, etc).
      * @param interfacematchtype An #AtspiCollectionMatchType specifying how to          interpret `interfaces`.
      * @param invert if #TRUE, the match rule should be denied (inverted); if #FALSE,          it should not. For example, if the match rule defines that a match is          an object of ROLE_HEADING which has STATE_FOCUSABLE and a click action,          inverting it would match all objects that are not of ROLE_HEADING,          focusable and clickable at the same time.
      * @returns A new #AtspiMatchRule.
@@ -4565,6 +4732,15 @@ export interface Relation {
     disconnect(id: number): void
 }
 
+/**
+ * An interface via which non-hierarchical relationships
+ * are indicated.
+ * 
+ * An interface via which non-hierarchical relationships
+ * are indicated. An instance of this interface represents
+ * a "one-to-many" correspondence.
+ * @class 
+ */
 export class Relation extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Relation
@@ -4655,6 +4831,11 @@ export interface StateSet {
     disconnect(id: number): void
 }
 
+/**
+ * The atspi-stateset objects implement wrappers around a
+ * bitmap of accessible states.
+ * @class 
+ */
 export class StateSet extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.StateSet

package/atspi-2.0.d.ts

@@ -290,6 +290,26 @@ enum KeySynthType {
      */
     UNLOCKMODIFIERS,
 }
+/**
+ * Enumeration used to indicate a type of live region and how assertive it
+ * should be in terms of speaking notifications. Currently, this is only used
+ * for "announcement" events, but it may be used for additional purposes
+ * in the future.
+ */
+enum Live {
+    /**
+     * No live region.
+     */
+    NONE,
+    /**
+     * This live region should be considered polite.
+     */
+    POLITE,
+    /**
+     * This live region should be considered assertive.
+     */
+    ASSERTIVE,
+}
 /**
  * Used by interfaces #AtspiText and #AtspiDocument, this
  * enumeration corresponds to the POSIX 'setlocale' enum values.
@@ -605,7 +625,7 @@ enum Role {
      */
     DATE_EDITOR,
     /**
-     * An inconifed internal frame within a DESKTOP_PANE.
+     * An inconifed internal frame within a DESKTOP_FRAME.
      */
     DESKTOP_ICON,
     /**
@@ -628,14 +648,14 @@ enum Role {
      */
     DIRECTORY_PANE,
     /**
-     * A specialized dialog that displays the files in
-     * the directory and lets the user select a file, browse a different
-     * directory, or specify a filename.
+     * An object used for drawing custom user interface
+     * elements.
      */
     DRAWING_AREA,
     /**
-     * An object used for drawing custom user interface
-     * elements.
+     * A specialized dialog that displays the files in
+     * the directory and lets the user select a file, browse a different
+     * directory, or specify a filename.
      */
     FILE_CHOOSER,
     /**
@@ -795,14 +815,13 @@ enum Role {
     SEPARATOR,
     /**
      * An object that allows the user to select from a bounded
-     * range.
+     * range.  Unlike `ATSPI_ROLE_SCROLL_BAR,` `ATSPI_ROLE_SLIDER` objects need not control
+     * 'viewport'-like objects.
      */
     SLIDER,
     /**
      * An object which allows one of a set of choices to
-     * be selected, and which displays the current choice.  Unlike
-     * `ATSPI_ROLE_SCROLL_BAR,` `ATSPI_ROLE_SLIDER` objects need not control
-     * 'viewport'-like objects.
+     * be selected, and which displays the current choice.
      */
     SPIN_BUTTON,
     /**
@@ -925,7 +944,7 @@ enum Role {
     /**
      * An object corresponding to the toplevel accessible
      * of an application, which may contain `ATSPI_ROLE_FRAME` objects or other
-     * accessible objects. Children of #AccessibleDesktop objects  are generally
+     * accessible objects. Children of objects with the #ATSPI_ROLE_DESKTOP_FRAME role are generally
      * `ATSPI_ROLE_APPLICATION` objects.
      */
     APPLICATION,
@@ -1261,14 +1280,18 @@ enum Role {
     /**
      * A container for content that is called out as a proposed
      * change from the current version of the document, such as by a reviewer of the
-     * content. This role should include either %ATSPI_ROLE_CONTENT_DELETION and/or
-     * %ATSPI_ROLE_CONTENT_INSERTION children, in any order, to indicate what the
+     * content. An object with this role should include children with %ATSPI_ROLE_CONTENT_DELETION and/or
+     * %ATSPI_ROLE_CONTENT_INSERTION, in any order, to indicate what the
      * actual change is. `Since:` 2.36
      */
     SUGGESTION,
+    /**
+     * A specialized push button to open a menu. `Since` 2.46
+     */
+    PUSH_BUTTON_MENU,
     /**
      * Not a valid role, used for finding end of
-     *  enumeration.
+     * enumeration.
      */
     LAST_DEFINED,
 }
@@ -1771,7 +1794,7 @@ enum KeyListenerSyncType {
     NOSYNC,
     /**
      * Events are delivered synchronously, before the
-     * currently focussed application sees them.
+     * currently focused application sees them.
      */
     SYNCHRONOUS,
     /**
@@ -1940,6 +1963,14 @@ function generate_keyboard_event(keyval: number, keystring: string | null, synth
  * @returns %TRUE if successful, otherwise %FALSE.
  */
 function generate_mouse_event(x: number, y: number, name: string | null): boolean
+/**
+ * Like atspi_generate_mouse_event, but asynchronous.
+ * @param x a #glong indicating the screen x coordinate of the mouse event.
+ * @param y a #glong indicating the screen y coordinate of the mouse event.
+ * @param name a string indicating which mouse event to be synthesized        (e.g. "b1p", "b1c", "b2r", "rel", "abs").
+ * @param callback a callback to be called when a reply is received. May be NULL.
+ */
+function generate_mouse_event_async(x: number, y: number, name: string | null, callback: GenerateMouseEventCB | null): void
 /**
  * Gets the virtual desktop indicated by index `i`.
  * NOTE: currently multiple virtual desktops are not implemented;
@@ -1968,6 +1999,10 @@ function get_desktop_count(): number
  * @returns a #GArray of desktops.
  */
 function get_desktop_list(): Accessible[]
+/**
+ * Returns the version of the AT-SPI library being used at runtime.
+ */
+function get_version(): [ /* major */ number, /* minor */ number, /* micro */ number ]
 /**
  * Connects to the accessibility registry and initializes the SPI.
  * @returns 0 on success, 1 if already initialized, or an integer error code.
@@ -1979,11 +2014,11 @@ function init(): number
  */
 function is_initialized(): boolean
 /**
- * Registers a listener for device events, for instance button events.
- * @param listener a pointer to the #AtspiDeviceListener which requests             the events.
- * @param event_types an #AtspiDeviceEventMask mask indicating which             types of key events are requested (%ATSPI_KEY_PRESSED, etc.).
- * @param filter Unused parameter.
- * @returns %TRUE if successful, otherwise %FALSE.
+ * This function does nothing and should not be called.
+ * @param listener 
+ * @param event_types 
+ * @param filter 
+ * @returns Always returns %FALSE.
  */
 function register_device_event_listener(listener: DeviceListener, event_types: DeviceEventMask, filter: any | null): boolean
 /**
@@ -2002,9 +2037,14 @@ function register_device_event_listener(listener: DeviceListener, event_types: D
  * @returns %TRUE if successful, otherwise %FALSE.
  */
 function register_keystroke_listener(listener: DeviceListener, key_set: KeyDefinition[] | null, modmask: KeyMaskType, event_types: KeyEventMask, sync_type: KeyListenerSyncType): boolean
+/**
+ * Gets the localized description string describing the #AtspiRole `role`.
+ * @param role an #AtspiRole object to query.
+ * @returns the localized string describing the AtspiRole
+ */
+function role_get_localized_name(role: Role): string | null
 /**
  * Gets a localizable string that indicates the name of an #AtspiRole.
- * <em>DEPRECATED.</em>
  * @param role an #AtspiRole object to query.
  * @returns a localizable string name for an #AtspiRole enumerated type.
  */
@@ -2018,18 +2058,13 @@ function role_get_name(role: Role): string | null
  */
 function set_main_context(cnx: GLib.MainContext): void
 /**
- * Sets the reference window that will be used when atspi_generate_mouse_event
- * is called. Coordinates will be assumed to be relative to this window. This
- * is needed because, due to Wayland's security model, it is not currently
- * possible to retrieve global coordinates.
- * If NULL is passed, then AT-SPI will use the window that has focus at the
- * time that atspi_generate_mouse_event is called.
+ * Deprecated. This function no longer does anything and should not be used.
  * @param accessible the #AtspiAccessible corresponding to the window to select.              should be a top-level window with a role of              ATSPI_ROLE_APPLICATION.
  */
 function set_reference_window(accessible: Accessible): void
 /**
  * Set the timeout used for method calls. If this is not set explicitly,
- * a default of 0.8 ms is used.
+ * a default of 800 ms is used.
  * Note that at-spi2-registryd currently uses a timeout of 3 seconds when
  * sending a keyboard event notification. This means that, if an AT makes
  * a call in response to the keyboard notification and the application
@@ -2079,6 +2114,9 @@ interface EventListenerCB {
 interface EventListenerSimpleCB {
     (event: Event): void
 }
+interface GenerateMouseEventCB {
+    (): void
+}
 /**
  * A callback that will be invoked when a key is pressed.
  * @callback 
@@ -2248,6 +2286,15 @@ interface Collection {
     disconnect(id: number): void
 }
 
+/**
+ * An interface designed to allow accessibles which satisfy a set of
+ * criteria to be returned.
+ * 
+ * An interface designed to allow accessibles which satisfy a set of
+ * criteria to be returned. This interface can be used to avoid iteration
+ * or client-side search of the object tree.
+ * @interface 
+ */
 class Collection extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Collection
@@ -2354,8 +2401,8 @@ interface Component {
     scroll_to_point(coords: CoordType, x: number, y: number): boolean
     /**
      * Moves and resizes the specified component.
-     * @param x the new vertical position to which the component should be moved.
-     * @param y the new horizontal position to which the component should be moved.
+     * @param x the new horizontal position to which the component should be moved.
+     * @param y the new vertical position to which the component should be moved.
      * @param width the width to which the component should be resized.
      * @param height the height to which the component should be resized.
      * @param ctype the coordinate system in which the position is specified.         (e.g. ATSPI_COORD_TYPE_WINDOW, ATSPI_COORD_TYPE_SCREEN).
@@ -2364,14 +2411,14 @@ interface Component {
     set_extents(x: number, y: number, width: number, height: number, ctype: CoordType): boolean
     /**
      * Moves the component to the specified position.
-     * @param x the new vertical position to which the component should be moved.
-     * @param y the new horizontal position to which the component should be moved.
+     * @param x the new horizontal position to which the component should be moved.
+     * @param y the new vertical position to which the component should be moved.
      * @param ctype the coordinate system in which the position is specified.         (e.g. ATSPI_COORD_TYPE_WINDOW, ATSPI_COORD_TYPE_SCREEN).
      * @returns #TRUE if successful; #FALSE otherwise.
      */
     set_position(x: number, y: number, ctype: CoordType): boolean
     /**
-     * Resizes the specified component to the given coordinates.
+     * Resizes the specified component to the given pixel dimensions.
      * @param width the width to which the component should be resized.
      * @param height the height to which the component should be resized.
      * @returns #TRUE if successful; #FALSE otherwise.
@@ -2386,6 +2433,20 @@ interface Component {
     disconnect(id: number): void
 }
 
+/**
+ * An interface implemented by objects which have onscreen visual
+ * representations.
+ * 
+ * The Component interface is implemented by objects which occupy on-screen
+ * space, e.g. objects which have onscreen visual representations. The methods
+ * in Component allow clients to identify where the objects lie in the onscreen
+ * coordinate system, their relative size, stacking order, and position. It
+ * also provides a mechanism whereby keyboard focus may be transferred to
+ * specific user interface elements programmatically.  This is a 2D API.
+ * Coordinates of 3D objects are projected into the 2-dimensional screen view
+ * for purposes of this interface.
+ * @interface 
+ */
 class Component extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Component
@@ -2593,6 +2654,17 @@ interface Hypertext {
     disconnect(id: number): void
 }
 
+/**
+ * An interface used for objects which implement linking between
+ * multiple resource locations.
+ * 
+ * An interface used for objects which implement linking between
+ * multiple resource or content locations, or multiple 'markers'
+ * within a single document. A hypertext instance is associated
+ * with one or more hyperlinks which are associated with particular
+ * offsets within the hypertext's content.
+ * @interface 
+ */
 class Hypertext extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Hypertext
@@ -2766,6 +2838,17 @@ interface Selection {
     disconnect(id: number): void
 }
 
+/**
+ * An interface which indicates that an object exposes a 'selection' model,
+ * allowing the selection of one or more of its children.
+ * 
+ * An interface which indicates that an object exposes a 'selection'
+ * model, allowing the selection of one or more of its children.
+ * Read-only Selection instances are possible, in which case the
+ * interface is used to programmatically determine the selected-ness
+ * of its children.
+ * @interface 
+ */
 class Selection extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Selection
@@ -3013,6 +3096,20 @@ interface Table {
     disconnect(id: number): void
 }
 
+/**
+ * An interface used by containers whose data is arranged in a tabular form.
+ * 
+ * An interface used by containers whose contained data is arranged
+ * in a tabular (i.e. row-column) form. Tables may resemble
+ * a two-dimensional grid, as in a spreadsheet, or may feature objects
+ * which span multiple rows and/or columns, but whose bounds are
+ * aligned on a row/column matrix. Objects within tables are children
+ * of the table object, and they may be referenced either via a child
+ * index or via a row/column pair. Table 'cells' may implement other
+ * interfaces, such as Text, Action, Image, and Component, and should do
+ * so as appropriate to their onscreen presentation and/or behavior.
+ * @interface 
+ */
 class Table extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Table
@@ -3141,7 +3238,6 @@ interface Text {
      * Gets the attributes applied to a range of text from an #AtspiText
      * object. The text attributes correspond to CSS attributes
      * where possible.
-     * <em>DEPRECATED</em>
      * @param offset a #gint indicating the offset from which the attribute        search is based.
      * @returns a #GHashTable describing the attributes at the given character offset.
      */
@@ -3342,6 +3438,18 @@ interface Text {
     disconnect(id: number): void
 }
 
+/**
+ * An interface implemented by objects which place textual
+ * information onscreen.
+ * 
+ * The text interface should be implemented by objects which place textual
+ * information onscreen as character strings or glyphs. The text interface
+ * allows access to textual content including display attributes and
+ * semantic hints associated with runs of text, and to bounding
+ * information for glyphs and substrings. It also allows portions of text to
+ * be selected, if the objects StateSet includes STATE_SELECTABLE_TEXT.
+ * @interface 
+ */
 class Text extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Text
@@ -3409,6 +3517,16 @@ interface Value {
     disconnect(id: number): void
 }
 
+/**
+ * An interface supporting a one-dimensional scalar
+ * to be modified, or which reflects its value.
+ * 
+ * An interface supporting a one-dimensional scalar
+ * to be modified, or which reflects its value. If
+ * STATE_EDITABLE is not present, the value is
+ * treated as "read only".
+ * @interface 
+ */
 class Value extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Value
@@ -3471,6 +3589,10 @@ interface Accessible extends Action, Collection, Component, Document, EditableTe
      * descendants.
      */
     clear_cache(): void
+    /**
+     * Clears the cached information only for the given accessible.
+     */
+    clear_cache_single(): void
     /**
      * Gets the accessible id of the accessible.  This is not meant to be presented
      * to the user, but to be an id which is stable over application development.
@@ -3731,6 +3853,14 @@ interface Accessible extends Action, Collection, Component, Document, EditableTe
     disconnect(id: number): void
 }
 
+/**
+ * The base interface which is implemented by all accessible objects.
+ * 
+ * All objects support interfaces for querying their contained 'children'
+ * and position in the accessible-object hierarchy, whether or not they
+ * actually have children.
+ * @class 
+ */
 class Accessible extends Object {
 
     // Own properties of Atspi-2.0.Atspi.Accessible
@@ -3776,6 +3906,14 @@ interface Application {
     disconnect(id: number): void
 }
 
+/**
+ * An interface identifying the root object associated
+ * with a running application.
+ * 
+ * An interface identifying an object which is the root of the
+ * hierarchy associated with a running application.
+ * @class 
+ */
 class Application extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Application
@@ -3820,7 +3958,7 @@ interface Device {
      */
     get_locked_modifiers(): number
     /**
-     * Gets the modifier for a given keycode, if one exists. Does not creatt a new
+     * Gets the modifier for a given keycode, if one exists. Does not create a new
      * mapping. This function should be used when the intention is to query a
      * locking modifier such as num lock via atspi_device_get_locked_modifiers,
      * rather than to add key grabs.
@@ -3875,7 +4013,7 @@ interface Device {
      */
     vfunc_get_locked_modifiers(): number
     /**
-     * Gets the modifier for a given keycode, if one exists. Does not creatt a new
+     * Gets the modifier for a given keycode, if one exists. Does not create a new
      * mapping. This function should be used when the intention is to query a
      * locking modifier such as num lock via atspi_device_get_locked_modifiers,
      * rather than to add key grabs.
@@ -4205,6 +4343,7 @@ interface EventListener {
      *            object:column-deleted
      *            object:model-changed
      *            object:active-descendant-changed
+     *            object:announcement
      * 
      *  (screen reader events)
      *             screen-reader:region-changed
@@ -4279,6 +4418,16 @@ interface EventListener {
     disconnect(id: number): void
 }
 
+/**
+ * A generic interface implemented by objects for the receipt of event
+ * notifications.
+ * 
+ * A generic interface implemented by objects for the receipt of event
+ * notifications. atspi-event-listener is the interface via which clients of
+ * the atspi-registry receive notification of changes to an application's user
+ * interface and content.
+ * @class 
+ */
 class EventListener extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.EventListener
@@ -4393,6 +4542,19 @@ interface Hyperlink {
     disconnect(id: number): void
 }
 
+/**
+ * Instances of atspi-hyperlink are the means by which end users
+ * and clients interact with linked content.
+ * 
+ *  Instances of atspi-hyperlink are returned by
+ * atspi-hypertext objects, and are the means by
+ * which end users and clients interact with linked,
+ * and in some cases embedded, content. These instances
+ * may have multiple "anchors", where an anchor corresponds to a
+ * reference to a particular resource with a corresponding resource
+ * identified (URI).
+ * @class 
+ */
 class Hyperlink extends Object {
 
     // Own properties of Atspi-2.0.Atspi.Hyperlink
@@ -4438,6 +4600,11 @@ interface MatchRule {
     disconnect(id: number): void
 }
 
+/**
+ * An interface that allows the definition of match rules
+ * for accessible objects.
+ * @class 
+ */
 class MatchRule extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.MatchRule
@@ -4458,7 +4625,7 @@ class MatchRule extends GObject.Object {
      * @param attributematchtype An #AtspiCollectionMatchType specifying how to          interpret `attributes`.
      * @param roles A #GArray of roles to match, or NULL if          not applicable.
      * @param rolematchtype An #AtspiCollectionMatchType specifying how to          interpret `roles`.
-     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by their DBus names (org.a11y.Atspi.Accessible,          org.a11y.Atspi.Component, etc).
+     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by the final component of their DBus names (Accessible,          Component, etc).
      * @param interfacematchtype An #AtspiCollectionMatchType specifying how to          interpret `interfaces`.
      * @param invert if #TRUE, the match rule should be denied (inverted); if #FALSE,          it should not. For example, if the match rule defines that a match is          an object of ROLE_HEADING which has STATE_FOCUSABLE and a click action,          inverting it would match all objects that are not of ROLE_HEADING,          focusable and clickable at the same time.
      * @returns A new #AtspiMatchRule.
@@ -4474,7 +4641,7 @@ class MatchRule extends GObject.Object {
      * @param attributematchtype An #AtspiCollectionMatchType specifying how to          interpret `attributes`.
      * @param roles A #GArray of roles to match, or NULL if          not applicable.
      * @param rolematchtype An #AtspiCollectionMatchType specifying how to          interpret `roles`.
-     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by their DBus names (org.a11y.Atspi.Accessible,          org.a11y.Atspi.Component, etc).
+     * @param interfaces An array of interfaces to match, or          NULL if not applicable.  Interface names should be specified          by the final component of their DBus names (Accessible,          Component, etc).
      * @param interfacematchtype An #AtspiCollectionMatchType specifying how to          interpret `interfaces`.
      * @param invert if #TRUE, the match rule should be denied (inverted); if #FALSE,          it should not. For example, if the match rule defines that a match is          an object of ROLE_HEADING which has STATE_FOCUSABLE and a click action,          inverting it would match all objects that are not of ROLE_HEADING,          focusable and clickable at the same time.
      * @returns A new #AtspiMatchRule.
@@ -4567,6 +4734,15 @@ interface Relation {
     disconnect(id: number): void
 }
 
+/**
+ * An interface via which non-hierarchical relationships
+ * are indicated.
+ * 
+ * An interface via which non-hierarchical relationships
+ * are indicated. An instance of this interface represents
+ * a "one-to-many" correspondence.
+ * @class 
+ */
 class Relation extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.Relation
@@ -4657,6 +4833,11 @@ interface StateSet {
     disconnect(id: number): void
 }
 
+/**
+ * The atspi-stateset objects implement wrappers around a
+ * bitmap of accessible states.
+ * @class 
+ */
 class StateSet extends GObject.Object {
 
     // Own properties of Atspi-2.0.Atspi.StateSet

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girs/atspi-2.0",
-  "version": "2.0.0-3.2.2",
+  "version": "2.0.0-3.2.4",
   "description": "GJS TypeScript type definitions for Atspi-2.0, generated from library version 2.0.0",
   "type": "module",
   "module": "atspi-2.0.js",
@@ -25,10 +25,10 @@
     "test:cjs": "NODE_OPTIONS=--max_old_space_size=9216 tsc --noEmit atspi-2.0.d.cts"
   },
   "dependencies": {
-    "@girs/dbus-1.0": "^1.0.0-3.2.2",
-    "@girs/gjs": "^3.2.2",
-    "@girs/glib-2.0": "^2.77.0-3.2.2",
-    "@girs/gobject-2.0": "^2.77.0-3.2.2"
+    "@girs/dbus-1.0": "^1.0.0-3.2.4",
+    "@girs/gjs": "^3.2.4",
+    "@girs/glib-2.0": "^2.78.0-3.2.4",
+    "@girs/gobject-2.0": "^2.78.0-3.2.4"
   },
   "devDependencies": {
     "typescript": "*"