@girs/atk-1.0 2.45.1-3.0.0 → 2.48.2-3.0.3

package/README.md

@@ -1,7 +1,11 @@
 
 # Atk-1.0
 
-GJS TypeScript type definitions for Atk-1.0, generated from library version 2.45.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.0.0.
+![version](https://img.shields.io/npm/v/@girs/atk-1.0)
+![downloads/week](https://img.shields.io/npm/dw/@girs/atk-1.0)
+
+
+GJS TypeScript type definitions for Atk-1.0, generated from library version 2.48.2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.0.3.
 
 ATK provides the set of accessibility interfaces that are implemented by other toolkits and applications. Using the ATK interfaces, accessibility tools have full access to view and control running applications.
 

package/atk-1.0.d.cts

@@ -805,6 +805,11 @@ export enum Role {
      * 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 the enumeration
      */
@@ -1638,7 +1643,7 @@ export function value_type_get_name(value_type: ValueType): string | null
  * supported are events of type "focus:".  Most clients of ATK will prefer to
  * attach signal handlers for the various ATK signals instead.
  * 
- * see atk_add_focus_tracker.
+ * see [id`atk_add_focus_tracker]`
  * @callback 
  * @param obj An #AtkObject instance for whom the callback will be called when the specified event (e.g. 'focus:') takes place.
  */
@@ -1650,7 +1655,7 @@ export interface EventListener {
  * called in order to initialize the per-object event registration system
  * used by #AtkEventListener, if any preparation is required.
  * 
- * see atk_focus_tracker_init.
+ * see [id`atk_focus_tracker_init]`
  * @callback 
  */
 export interface EventListenerInit {
@@ -1683,7 +1688,7 @@ export interface Function {
  * interception of key events via the return code as described below.
  * @callback 
  * @param event an AtkKeyEventStruct containing information about the key event for which notification is being given.
- * @returns TRUE (nonzero) if the event emission should be stopped and the event discarded without being passed to the normal GUI recipient; FALSE (zero) if the event dispatch to the client application should proceed as normal. see atk_add_key_event_listener.
+ * @returns TRUE (nonzero) if the event emission should be stopped and the event discarded without being passed to the normal GUI recipient; FALSE (zero) if the event dispatch to the client application should proceed as normal. see [id@atk_add_key_event_listener]
  */
 export interface KeySnoopFunc {
     (event: KeyEventStruct): number
@@ -1888,6 +1893,9 @@ export interface Action {
 }
 
 /**
+ * The ATK interface provided by UI components
+ * which the user can activate/interact with.
+ * 
  * #AtkAction should be implemented by instances of #AtkObject classes
  * with which the user can interact directly, i.e. buttons,
  * checkboxes, scrollbars, e.g. components which are not "passive"
@@ -2222,6 +2230,10 @@ export interface Component {
 }
 
 /**
+ * The ATK interface provided by UI components
+ * which occupy a physical area on the screen.
+ * which the user can activate/interact with.
+ * 
  * #AtkComponent should be implemented by most if not all UI elements
  * with an actual on-screen presence, i.e. components which can be
  * said to have a screen-coordinate bounding box.  Virtually all
@@ -2427,6 +2439,9 @@ export interface Document {
 }
 
 /**
+ * The ATK interface which represents the toplevel
+ *  container for document content.
+ * 
  * The AtkDocument interface should be supported by any object whose
  * content is a representation or view of a document.  The AtkDocument
  * interface should appear on the toplevel container for the document
@@ -2578,6 +2593,8 @@ export interface EditableText {
 }
 
 /**
+ * The ATK interface implemented by components containing user-editable text content.
+ * 
  * #AtkEditableText should be implemented by UI components which
  * contain text which the user can edit, via the #AtkObject
  * corresponding to that component (see #AtkObject).
@@ -2586,7 +2603,7 @@ export interface EditableText {
  * which implements #AtkEditableText is by definition an #AtkText
  * implementor as well.
  * 
- * See also: #AtkText
+ * See [iface`AtkText]`
  * @interface 
  */
 export class EditableText extends GObject.Object {
@@ -2639,34 +2656,11 @@ export interface HyperlinkImpl {
 }
 
 /**
- * AtkHyperlinkImpl allows AtkObjects to refer to their associated
- * AtkHyperlink instance, if one exists.  AtkHyperlinkImpl differs
- * from AtkHyperlink in that AtkHyperlinkImpl is an interface, whereas
- * AtkHyperlink is a object type.  The AtkHyperlinkImpl interface
- * allows a client to query an AtkObject for the availability of an
- * associated AtkHyperlink instance, and obtain that instance.  It is
- * thus particularly useful in cases where embedded content or inline
- * content within a text object is present, since the embedding text
- * object implements AtkHypertext and the inline/embedded objects are
- * exposed as children which implement AtkHyperlinkImpl, in addition
- * to their being obtainable via AtkHypertext:getLink followed by
- * AtkHyperlink:getObject.
- * 
- * The AtkHyperlinkImpl interface should be supported by objects
- * exposed within the hierarchy as children of an AtkHypertext
- * container which correspond to "links" or embedded content within
- * the text.  HTML anchors are not, for instance, normally exposed
- * this way, but embedded images and components which appear inline in
- * the content of a text object are. The AtkHyperlinkIface interface
- * allows a means of determining which children are hyperlinks in this
- * sense of the word, and for obtaining their corresponding
- * AtkHyperlink object, from which the embedding range, URI, etc. can
- * be obtained.
- * 
- * To some extent this interface exists because, for historical
- * reasons, AtkHyperlink was defined as an object type, not an
- * interface.  Thus, in order to interact with AtkObjects via
- * AtkHyperlink semantics, a new interface was required.
+ * A queryable interface which allows AtkHyperlink instances
+ * associated with an AtkObject to be obtained.  AtkHyperlinkImpl
+ * corresponds to AT-SPI's Hyperlink interface, and differs from
+ * AtkHyperlink in that AtkHyperlink is an object type, rather than an
+ * interface, and thus cannot be directly queried. FTW
  * @interface 
  */
 export class HyperlinkImpl extends GObject.Object {
@@ -2766,6 +2760,8 @@ export interface Hypertext {
 }
 
 /**
+ * The ATK interface which provides standard mechanism for manipulating hyperlinks.
+ * 
  * 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
@@ -2888,6 +2884,9 @@ export interface Image {
 }
 
 /**
+ * The ATK Interface implemented by components
+ *  which expose image or pixmap content on-screen.
+ * 
  * #AtkImage should be implemented by #AtkObject subtypes on behalf of
  * components which display image/pixmap information onscreen, and
  * which provide information (other than just widget borders, etc.)
@@ -3114,6 +3113,8 @@ export interface Selection {
 }
 
 /**
+ * The ATK interface implemented by container objects whose #AtkObject children can be selected.
+ * 
  * #AtkSelection should be implemented by UI components with children
  * which are exposed by #atk_object_ref_child and
  * #atk_object_get_n_children, if the use of the parent UI component
@@ -3231,6 +3232,8 @@ export interface StreamableContent {
 }
 
 /**
+ * The ATK interface which provides access to streamable content.
+ * 
  * An interface whereby an object allows its backing content to be
  * streamed to clients.  Typical implementors would be images or
  * icons, HTML content, or multimedia display/rendering widgets.
@@ -3764,6 +3767,8 @@ export interface Table {
 }
 
 /**
+ * The ATK interface implemented for UI components which contain tabular or row/column information.
+ * 
  * #AtkTable should be implemented by components which present
  * elements ordered via rows and columns.  It may also be used to
  * present tree-structured information if the nodes of the trees can
@@ -3960,11 +3965,13 @@ export interface TableCell extends Object {
 }
 
 /**
+ * The ATK interface implemented for a cell inside a two-dimentional #AtkTable
+ * 
  * Being #AtkTable a component which present elements ordered via rows
  * and columns, an #AtkTableCell is the interface which each of those
  * elements, so "cells" should implement.
  * 
- * See also #AtkTable.
+ * See [iface`AtkTable]`
  * @interface 
  */
 export class TableCell extends GObject.Object {
@@ -4568,6 +4575,8 @@ export interface Text {
 }
 
 /**
+ * The ATK interface implemented by components with text content.
+ * 
  * #AtkText should be implemented by #AtkObjects on behalf of widgets
  * that have text content which is either attributed or otherwise
  * non-trivial.  #AtkObjects whose text content is simple,
@@ -4795,6 +4804,8 @@ export interface Value {
 }
 
 /**
+ * The ATK interface implemented by valuators and components which display or select a value from a bounded range of values.
+ * 
  * #AtkValue should be implemented for components which either display
  * a value from a bounded range, or which allow the user to specify a
  * value from a bounded range, or both. For instance, most sliders and
@@ -5108,9 +5119,13 @@ export interface Window extends Object {
 }
 
 /**
+ * The ATK Interface provided by UI components that represent a top-level window.
+ * 
  * #AtkWindow should be implemented by the UI elements that represent
  * a top-level window, such as the main window of an application or
  * dialog.
+ * 
+ * See [class`AtkObject]`
  * @interface 
  */
 export class Window extends GObject.Object {
@@ -5200,6 +5215,8 @@ export interface GObjectAccessible {
 }
 
 /**
+ * This object class is derived from AtkObject and can be used as a basis implementing accessible objects.
+ * 
  * This object class is derived from AtkObject. It can be used as a
  * basis for implementing accessible objects for GObjects which are
  * not derived from GtkWidget. One example of its use is in providing
@@ -5404,6 +5421,8 @@ export interface Hyperlink extends Action {
 }
 
 /**
+ * An ATK object which encapsulates a link or set of links in a hypertext document.
+ * 
  * An ATK object which encapsulates a link or set of links (for
  * instance in the case of client-side image maps) in a hypertext
  * document.  It may implement the AtkAction interface.  AtkHyperlink
@@ -5495,6 +5514,8 @@ export interface Misc {
 }
 
 /**
+ * A set of ATK utility functions for thread locking
+ * 
  * A set of utility functions for thread locking. This interface and
  * all his related methods are deprecated since 2.12.
  * @class 
@@ -5752,6 +5773,8 @@ export interface NoOpObject extends Action, Component, Document, EditableText, H
 }
 
 /**
+ * An AtkObject which purports to implement all ATK interfaces.
+ * 
  * An AtkNoOpObject is an AtkObject which purports to implement all
  * ATK interfaces. It is the type of AtkObject which is created if an
  * accessible object is requested for an object type for which no
@@ -5811,6 +5834,8 @@ export interface NoOpObjectFactory {
 }
 
 /**
+ * The AtkObjectFactory which creates an AtkNoOpObject.
+ * 
  * The AtkObjectFactory which creates an AtkNoOpObject. An instance of
  * this is created by an AtkRegistry if no factory type has not been
  * specified to create an accessible object of a particular type.
@@ -5854,6 +5879,13 @@ export module Object {
         ($obj: Object, arg1: Object): void
     }
 
+    /**
+     * Signal callback interface for `announcement`
+     */
+    export interface AnnouncementSignalCallback {
+        ($obj: Object, arg1: string | null): void
+    }
+
     /**
      * Signal callback interface for `children-changed`
      */
@@ -6289,6 +6321,9 @@ export interface Object {
     connect(sigName: "active-descendant-changed", callback: Object.ActiveDescendantChangedSignalCallback): number
     connect_after(sigName: "active-descendant-changed", callback: Object.ActiveDescendantChangedSignalCallback): number
     emit(sigName: "active-descendant-changed", arg1: Object, ...args: any[]): void
+    connect(sigName: "announcement", callback: Object.AnnouncementSignalCallback): number
+    connect_after(sigName: "announcement", callback: Object.AnnouncementSignalCallback): number
+    emit(sigName: "announcement", arg1: string | null, ...args: any[]): void
     connect(sigName: "children-changed", callback: Object.ChildrenChangedSignalCallback): number
     connect_after(sigName: "children-changed", callback: Object.ChildrenChangedSignalCallback): number
     emit(sigName: "children-changed", arg1: number, arg2: Object, ...args: any[]): void
@@ -6356,6 +6391,8 @@ export interface Object {
 }
 
 /**
+ * The base object class for the Accessibility Toolkit API.
+ * 
  * This class is the primary class for accessibility support via the
  * Accessibility ToolKit (ATK).  Objects which are instances of
  * #AtkObject (or instances of AtkObject-derived types) are queried
@@ -6374,7 +6411,7 @@ export interface Object {
  * implementation is insufficient, via instances of a new #AtkObject
  * subclass.
  * 
- * See also: #AtkObjectFactory, #AtkRegistry.  (GTK+ users see also
+ * See [class`AtkObjectFactory]`, [class`AtkRegistry]`.  (GTK+ users see also
  * #GtkAccessible).
  * @interface 
  */
@@ -6450,6 +6487,9 @@ export interface ObjectFactory {
 }
 
 /**
+ * The base object class for a factory used to
+ *  create accessible objects for objects of a specific GType.
+ * 
  * This class is the base object class for a factory used to create an
  * accessible object for a specific GType. The function
  * atk_registry_set_factory_type() is normally called to store in the
@@ -6568,7 +6608,9 @@ export interface Plug extends Component {
 }
 
 /**
- * See #AtkSocket
+ * Toplevel for embedding into other processes
+ * 
+ * See [class`AtkSocket]`
  * @class 
  */
 export class Plug extends Object {
@@ -6648,6 +6690,10 @@ export interface Registry {
 }
 
 /**
+ * An object used to store the GType of the
+ * factories used to create an accessible object for an object of a
+ * particular GType.
+ * 
  * The AtkRegistry is normally used to create appropriate ATK "peers"
  * for user interface components.  Application developers usually need
  * only interact with the AtkRegistry by associating appropriate ATK
@@ -6732,6 +6778,9 @@ export interface Relation {
 }
 
 /**
+ * An object used to describe a relation between a
+ *  object and one or more other objects.
+ * 
  * An AtkRelation describes a relation between an object and one or
  * more other objects. The actual relations that an object has with
  * other objects are defined as an AtkRelationSet, which is a set of
@@ -6855,6 +6904,9 @@ export interface RelationSet {
 }
 
 /**
+ * A set of AtkRelations, normally the set of
+ *  AtkRelations which an AtkObject has.
+ * 
  * The AtkRelationSet held by an object establishes its relationships
  * with objects beyond the normal "parent/child" hierarchical
  * relationships that all user interface objects have.
@@ -6996,6 +7048,8 @@ export interface Socket extends Component {
 }
 
 /**
+ * Container for AtkPlug objects from other processes
+ * 
  * Together with #AtkPlug, #AtkSocket provides the ability to embed
  * accessibles from one process into another in a fashion that is
  * transparent to assistive technologies. #AtkSocket works as the
@@ -7018,6 +7072,8 @@ export interface Socket extends Component {
  * atk_object_get_n_accessible_children() and
  * atk_object_ref_accessible_child(). All the logic related to those
  * functions will be implemented by the IPC layer.
+ * 
+ * See [class`AtkPlug]`
  * @class 
  */
 export class Socket extends Object {
@@ -7148,6 +7204,8 @@ export interface StateSet {
 }
 
 /**
+ * An AtkStateSet contains the states of an object.
+ * 
  * An AtkStateSet is a read-only representation of the full set of #AtkStates
  * that apply to an object at a given time. This set is not meant to be
  * modified, but rather created when #atk_object_ref_state_set() is called.
@@ -7202,6 +7260,8 @@ export interface Util {
 }
 
 /**
+ * A set of ATK utility functions for event and toolkit support.
+ * 
  * A set of ATK utility functions which are used to support event
  * registration of various types, and obtaining the 'root' accessible
  * of a process and information about the current ATK implementation
@@ -7732,6 +7792,8 @@ export interface Range {
 }
 
 /**
+ * A given range or subrange, to be used with #AtkValue
+ * 
  * #AtkRange are used on #AtkValue, in order to represent the full
  * range of a given component (for example an slider or a range
  * control), or to define each individual subrange this full range is

package/atk-1.0.d.ts

@@ -807,6 +807,11 @@ enum Role {
      * 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 the enumeration
      */
@@ -1640,7 +1645,7 @@ function value_type_get_name(value_type: ValueType): string | null
  * supported are events of type "focus:".  Most clients of ATK will prefer to
  * attach signal handlers for the various ATK signals instead.
  * 
- * see atk_add_focus_tracker.
+ * see [id`atk_add_focus_tracker]`
  * @callback 
  * @param obj An #AtkObject instance for whom the callback will be called when the specified event (e.g. 'focus:') takes place.
  */
@@ -1652,7 +1657,7 @@ interface EventListener {
  * called in order to initialize the per-object event registration system
  * used by #AtkEventListener, if any preparation is required.
  * 
- * see atk_focus_tracker_init.
+ * see [id`atk_focus_tracker_init]`
  * @callback 
  */
 interface EventListenerInit {
@@ -1685,7 +1690,7 @@ interface Function {
  * interception of key events via the return code as described below.
  * @callback 
  * @param event an AtkKeyEventStruct containing information about the key event for which notification is being given.
- * @returns TRUE (nonzero) if the event emission should be stopped and the event discarded without being passed to the normal GUI recipient; FALSE (zero) if the event dispatch to the client application should proceed as normal. see atk_add_key_event_listener.
+ * @returns TRUE (nonzero) if the event emission should be stopped and the event discarded without being passed to the normal GUI recipient; FALSE (zero) if the event dispatch to the client application should proceed as normal. see [id@atk_add_key_event_listener]
  */
 interface KeySnoopFunc {
     (event: KeyEventStruct): number
@@ -1890,6 +1895,9 @@ interface Action {
 }
 
 /**
+ * The ATK interface provided by UI components
+ * which the user can activate/interact with.
+ * 
  * #AtkAction should be implemented by instances of #AtkObject classes
  * with which the user can interact directly, i.e. buttons,
  * checkboxes, scrollbars, e.g. components which are not "passive"
@@ -2224,6 +2232,10 @@ interface Component {
 }
 
 /**
+ * The ATK interface provided by UI components
+ * which occupy a physical area on the screen.
+ * which the user can activate/interact with.
+ * 
  * #AtkComponent should be implemented by most if not all UI elements
  * with an actual on-screen presence, i.e. components which can be
  * said to have a screen-coordinate bounding box.  Virtually all
@@ -2429,6 +2441,9 @@ interface Document {
 }
 
 /**
+ * The ATK interface which represents the toplevel
+ *  container for document content.
+ * 
  * The AtkDocument interface should be supported by any object whose
  * content is a representation or view of a document.  The AtkDocument
  * interface should appear on the toplevel container for the document
@@ -2580,6 +2595,8 @@ interface EditableText {
 }
 
 /**
+ * The ATK interface implemented by components containing user-editable text content.
+ * 
  * #AtkEditableText should be implemented by UI components which
  * contain text which the user can edit, via the #AtkObject
  * corresponding to that component (see #AtkObject).
@@ -2588,7 +2605,7 @@ interface EditableText {
  * which implements #AtkEditableText is by definition an #AtkText
  * implementor as well.
  * 
- * See also: #AtkText
+ * See [iface`AtkText]`
  * @interface 
  */
 class EditableText extends GObject.Object {
@@ -2641,34 +2658,11 @@ interface HyperlinkImpl {
 }
 
 /**
- * AtkHyperlinkImpl allows AtkObjects to refer to their associated
- * AtkHyperlink instance, if one exists.  AtkHyperlinkImpl differs
- * from AtkHyperlink in that AtkHyperlinkImpl is an interface, whereas
- * AtkHyperlink is a object type.  The AtkHyperlinkImpl interface
- * allows a client to query an AtkObject for the availability of an
- * associated AtkHyperlink instance, and obtain that instance.  It is
- * thus particularly useful in cases where embedded content or inline
- * content within a text object is present, since the embedding text
- * object implements AtkHypertext and the inline/embedded objects are
- * exposed as children which implement AtkHyperlinkImpl, in addition
- * to their being obtainable via AtkHypertext:getLink followed by
- * AtkHyperlink:getObject.
- * 
- * The AtkHyperlinkImpl interface should be supported by objects
- * exposed within the hierarchy as children of an AtkHypertext
- * container which correspond to "links" or embedded content within
- * the text.  HTML anchors are not, for instance, normally exposed
- * this way, but embedded images and components which appear inline in
- * the content of a text object are. The AtkHyperlinkIface interface
- * allows a means of determining which children are hyperlinks in this
- * sense of the word, and for obtaining their corresponding
- * AtkHyperlink object, from which the embedding range, URI, etc. can
- * be obtained.
- * 
- * To some extent this interface exists because, for historical
- * reasons, AtkHyperlink was defined as an object type, not an
- * interface.  Thus, in order to interact with AtkObjects via
- * AtkHyperlink semantics, a new interface was required.
+ * A queryable interface which allows AtkHyperlink instances
+ * associated with an AtkObject to be obtained.  AtkHyperlinkImpl
+ * corresponds to AT-SPI's Hyperlink interface, and differs from
+ * AtkHyperlink in that AtkHyperlink is an object type, rather than an
+ * interface, and thus cannot be directly queried. FTW
  * @interface 
  */
 class HyperlinkImpl extends GObject.Object {
@@ -2768,6 +2762,8 @@ interface Hypertext {
 }
 
 /**
+ * The ATK interface which provides standard mechanism for manipulating hyperlinks.
+ * 
  * 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
@@ -2890,6 +2886,9 @@ interface Image {
 }
 
 /**
+ * The ATK Interface implemented by components
+ *  which expose image or pixmap content on-screen.
+ * 
  * #AtkImage should be implemented by #AtkObject subtypes on behalf of
  * components which display image/pixmap information onscreen, and
  * which provide information (other than just widget borders, etc.)
@@ -3116,6 +3115,8 @@ interface Selection {
 }
 
 /**
+ * The ATK interface implemented by container objects whose #AtkObject children can be selected.
+ * 
  * #AtkSelection should be implemented by UI components with children
  * which are exposed by #atk_object_ref_child and
  * #atk_object_get_n_children, if the use of the parent UI component
@@ -3233,6 +3234,8 @@ interface StreamableContent {
 }
 
 /**
+ * The ATK interface which provides access to streamable content.
+ * 
  * An interface whereby an object allows its backing content to be
  * streamed to clients.  Typical implementors would be images or
  * icons, HTML content, or multimedia display/rendering widgets.
@@ -3766,6 +3769,8 @@ interface Table {
 }
 
 /**
+ * The ATK interface implemented for UI components which contain tabular or row/column information.
+ * 
  * #AtkTable should be implemented by components which present
  * elements ordered via rows and columns.  It may also be used to
  * present tree-structured information if the nodes of the trees can
@@ -3962,11 +3967,13 @@ interface TableCell extends Object {
 }
 
 /**
+ * The ATK interface implemented for a cell inside a two-dimentional #AtkTable
+ * 
  * Being #AtkTable a component which present elements ordered via rows
  * and columns, an #AtkTableCell is the interface which each of those
  * elements, so "cells" should implement.
  * 
- * See also #AtkTable.
+ * See [iface`AtkTable]`
  * @interface 
  */
 class TableCell extends GObject.Object {
@@ -4570,6 +4577,8 @@ interface Text {
 }
 
 /**
+ * The ATK interface implemented by components with text content.
+ * 
  * #AtkText should be implemented by #AtkObjects on behalf of widgets
  * that have text content which is either attributed or otherwise
  * non-trivial.  #AtkObjects whose text content is simple,
@@ -4797,6 +4806,8 @@ interface Value {
 }
 
 /**
+ * The ATK interface implemented by valuators and components which display or select a value from a bounded range of values.
+ * 
  * #AtkValue should be implemented for components which either display
  * a value from a bounded range, or which allow the user to specify a
  * value from a bounded range, or both. For instance, most sliders and
@@ -5110,9 +5121,13 @@ interface Window extends Object {
 }
 
 /**
+ * The ATK Interface provided by UI components that represent a top-level window.
+ * 
  * #AtkWindow should be implemented by the UI elements that represent
  * a top-level window, such as the main window of an application or
  * dialog.
+ * 
+ * See [class`AtkObject]`
  * @interface 
  */
 class Window extends GObject.Object {
@@ -5202,6 +5217,8 @@ interface GObjectAccessible {
 }
 
 /**
+ * This object class is derived from AtkObject and can be used as a basis implementing accessible objects.
+ * 
  * This object class is derived from AtkObject. It can be used as a
  * basis for implementing accessible objects for GObjects which are
  * not derived from GtkWidget. One example of its use is in providing
@@ -5406,6 +5423,8 @@ interface Hyperlink extends Action {
 }
 
 /**
+ * An ATK object which encapsulates a link or set of links in a hypertext document.
+ * 
  * An ATK object which encapsulates a link or set of links (for
  * instance in the case of client-side image maps) in a hypertext
  * document.  It may implement the AtkAction interface.  AtkHyperlink
@@ -5497,6 +5516,8 @@ interface Misc {
 }
 
 /**
+ * A set of ATK utility functions for thread locking
+ * 
  * A set of utility functions for thread locking. This interface and
  * all his related methods are deprecated since 2.12.
  * @class 
@@ -5754,6 +5775,8 @@ interface NoOpObject extends Action, Component, Document, EditableText, Hypertex
 }
 
 /**
+ * An AtkObject which purports to implement all ATK interfaces.
+ * 
  * An AtkNoOpObject is an AtkObject which purports to implement all
  * ATK interfaces. It is the type of AtkObject which is created if an
  * accessible object is requested for an object type for which no
@@ -5813,6 +5836,8 @@ interface NoOpObjectFactory {
 }
 
 /**
+ * The AtkObjectFactory which creates an AtkNoOpObject.
+ * 
  * The AtkObjectFactory which creates an AtkNoOpObject. An instance of
  * this is created by an AtkRegistry if no factory type has not been
  * specified to create an accessible object of a particular type.
@@ -5856,6 +5881,13 @@ module Object {
         ($obj: Object, arg1: Object): void
     }
 
+    /**
+     * Signal callback interface for `announcement`
+     */
+    interface AnnouncementSignalCallback {
+        ($obj: Object, arg1: string | null): void
+    }
+
     /**
      * Signal callback interface for `children-changed`
      */
@@ -6291,6 +6323,9 @@ interface Object {
     connect(sigName: "active-descendant-changed", callback: Object.ActiveDescendantChangedSignalCallback): number
     connect_after(sigName: "active-descendant-changed", callback: Object.ActiveDescendantChangedSignalCallback): number
     emit(sigName: "active-descendant-changed", arg1: Object, ...args: any[]): void
+    connect(sigName: "announcement", callback: Object.AnnouncementSignalCallback): number
+    connect_after(sigName: "announcement", callback: Object.AnnouncementSignalCallback): number
+    emit(sigName: "announcement", arg1: string | null, ...args: any[]): void
     connect(sigName: "children-changed", callback: Object.ChildrenChangedSignalCallback): number
     connect_after(sigName: "children-changed", callback: Object.ChildrenChangedSignalCallback): number
     emit(sigName: "children-changed", arg1: number, arg2: Object, ...args: any[]): void
@@ -6358,6 +6393,8 @@ interface Object {
 }
 
 /**
+ * The base object class for the Accessibility Toolkit API.
+ * 
  * This class is the primary class for accessibility support via the
  * Accessibility ToolKit (ATK).  Objects which are instances of
  * #AtkObject (or instances of AtkObject-derived types) are queried
@@ -6376,7 +6413,7 @@ interface Object {
  * implementation is insufficient, via instances of a new #AtkObject
  * subclass.
  * 
- * See also: #AtkObjectFactory, #AtkRegistry.  (GTK+ users see also
+ * See [class`AtkObjectFactory]`, [class`AtkRegistry]`.  (GTK+ users see also
  * #GtkAccessible).
  * @interface 
  */
@@ -6452,6 +6489,9 @@ interface ObjectFactory {
 }
 
 /**
+ * The base object class for a factory used to
+ *  create accessible objects for objects of a specific GType.
+ * 
  * This class is the base object class for a factory used to create an
  * accessible object for a specific GType. The function
  * atk_registry_set_factory_type() is normally called to store in the
@@ -6570,7 +6610,9 @@ interface Plug extends Component {
 }
 
 /**
- * See #AtkSocket
+ * Toplevel for embedding into other processes
+ * 
+ * See [class`AtkSocket]`
  * @class 
  */
 class Plug extends Object {
@@ -6650,6 +6692,10 @@ interface Registry {
 }
 
 /**
+ * An object used to store the GType of the
+ * factories used to create an accessible object for an object of a
+ * particular GType.
+ * 
  * The AtkRegistry is normally used to create appropriate ATK "peers"
  * for user interface components.  Application developers usually need
  * only interact with the AtkRegistry by associating appropriate ATK
@@ -6734,6 +6780,9 @@ interface Relation {
 }
 
 /**
+ * An object used to describe a relation between a
+ *  object and one or more other objects.
+ * 
  * An AtkRelation describes a relation between an object and one or
  * more other objects. The actual relations that an object has with
  * other objects are defined as an AtkRelationSet, which is a set of
@@ -6857,6 +6906,9 @@ interface RelationSet {
 }
 
 /**
+ * A set of AtkRelations, normally the set of
+ *  AtkRelations which an AtkObject has.
+ * 
  * The AtkRelationSet held by an object establishes its relationships
  * with objects beyond the normal "parent/child" hierarchical
  * relationships that all user interface objects have.
@@ -6998,6 +7050,8 @@ interface Socket extends Component {
 }
 
 /**
+ * Container for AtkPlug objects from other processes
+ * 
  * Together with #AtkPlug, #AtkSocket provides the ability to embed
  * accessibles from one process into another in a fashion that is
  * transparent to assistive technologies. #AtkSocket works as the
@@ -7020,6 +7074,8 @@ interface Socket extends Component {
  * atk_object_get_n_accessible_children() and
  * atk_object_ref_accessible_child(). All the logic related to those
  * functions will be implemented by the IPC layer.
+ * 
+ * See [class`AtkPlug]`
  * @class 
  */
 class Socket extends Object {
@@ -7150,6 +7206,8 @@ interface StateSet {
 }
 
 /**
+ * An AtkStateSet contains the states of an object.
+ * 
  * An AtkStateSet is a read-only representation of the full set of #AtkStates
  * that apply to an object at a given time. This set is not meant to be
  * modified, but rather created when #atk_object_ref_state_set() is called.
@@ -7204,6 +7262,8 @@ interface Util {
 }
 
 /**
+ * A set of ATK utility functions for event and toolkit support.
+ * 
  * A set of ATK utility functions which are used to support event
  * registration of various types, and obtaining the 'root' accessible
  * of a process and information about the current ATK implementation
@@ -7734,6 +7794,8 @@ interface Range {
 }
 
 /**
+ * A given range or subrange, to be used with #AtkValue
+ * 
  * #AtkRange are used on #AtkValue, in order to represent the full
  * range of a given component (for example an slider or a range
  * control), or to define each individual subrange this full range is

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@girs/atk-1.0",
-  "version": "2.45.1-3.0.0",
-  "description": "GJS TypeScript type definitions for Atk-1.0, generated from library version 2.45.1",
+  "version": "2.48.2-3.0.3",
+  "description": "GJS TypeScript type definitions for Atk-1.0, generated from library version 2.48.2",
   "type": "module",
   "module": "atk-1.0.js",
   "main": "atk-1.0.js",
@@ -31,12 +31,12 @@
     "test:cjs": "tsc --noEmit atk-1.0.d.cts"
   },
   "dependencies": {
-    "@girs/gjs": "^3.0.0",
-    "@girs/gobject-2.0": "^2.76.1-3.0.0",
-    "@girs/glib-2.0": "^2.76.1-3.0.0"
+    "@girs/gjs": "^3.0.3",
+    "@girs/glib-2.0": "^2.76.1-3.0.3",
+    "@girs/gobject-2.0": "^2.76.1-3.0.3"
   },
   "devDependencies": {
-    "typescript": "^5.0.4"
+    "typescript": "*"
   },
   "keywords": [
     "Gir",