@girs/gobject-2.0 2.82.4-4.0.0-beta.20 → 2.84.0-4.0.0-beta.23

package/README.md

@@ -5,7 +5,7 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/gobject-2.0)
 
 
-GJS TypeScript type definitions for GObject-2.0, generated from library version 2.82.4 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.20.
+GJS TypeScript type definitions for GObject-2.0, generated from library version 2.84.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.23.
 
 
 ## Install

package/gobject-2.0.d.ts

@@ -7,6 +7,8 @@
  * The based EJS template file is used for the generated .d.ts file of each GIR module like Gtk-4.0, GObject-2.0, ...
  */
 
+import '@girs/gjs';
+
 // Module dependencies
 import type GLib from '@girs/glib-2.0';
 
@@ -856,10 +858,10 @@ export namespace GObject {
      * generate a my_enum_get_type() function from a usual C enumeration
      * definition  than to write one yourself using g_enum_register_static().
      * @param name A nul-terminated string used as the name of the new type.
-     * @param const_static_values An array of #GEnumValue structs for the possible  enumeration values. The array is terminated by a struct with all  members being 0. GObject keeps a reference to the data, so it cannot  be stack-allocated.
+     * @param const_static_values An array of  #GEnumValue structs for the possible enumeration values. The array is  terminated by a struct with all members being 0. GObject keeps a  reference to the data, so it cannot be stack-allocated.
      * @returns The new type identifier.
      */
-    function enum_register_static(name: string, const_static_values: EnumValue): GType;
+    function enum_register_static(name: string, const_static_values: EnumValue[]): GType;
     /**
      * Pretty-prints `value` in the form of the enum’s name.
      *
@@ -906,10 +908,10 @@ export namespace GObject {
      * generate a my_flags_get_type() function from a usual C enumeration
      * definition than to write one yourself using g_flags_register_static().
      * @param name A nul-terminated string used as the name of the new type.
-     * @param const_static_values An array of #GFlagsValue structs for the possible  flags values. The array is terminated by a struct with all members being 0.  GObject keeps a reference to the data, so it cannot be stack-allocated.
+     * @param const_static_values An array of  #GFlagsValue structs for the possible flags values. The array is  terminated by a struct with all members being 0. GObject keeps a  reference to the data, so it cannot be stack-allocated.
      * @returns The new type identifier.
      */
-    function flags_register_static(name: string, const_static_values: FlagsValue): GType;
+    function flags_register_static(name: string, const_static_values: FlagsValue[]): GType;
     /**
      * Pretty-prints `value` in the form of the flag names separated by ` | ` and
      * sorted. Any extra bits will be shown at the end as a hexadecimal number.
@@ -1491,12 +1493,14 @@ export namespace GObject {
      * for signals which don't have %G_SIGNAL_NO_HOOKS flag set.
      * @param signal_id the signal identifier, as returned by g_signal_lookup().
      * @param detail the detail on which to call the hook.
+     * @param hook_func a #GSignalEmissionHook function.
      * @param data_destroy a #GDestroyNotify for @hook_data.
      * @returns the hook id, for later use with g_signal_remove_emission_hook().
      */
     function signal_add_emission_hook(
         signal_id: number,
         detail: GLib.Quark,
+        hook_func: SignalEmissionHook,
         data_destroy?: GLib.DestroyNotify | null,
     ): number;
     /**
@@ -1513,11 +1517,19 @@ export namespace GObject {
      *
      * If `closure` is a floating reference (see g_closure_sink()), this function
      * takes ownership of `closure`.
+     *
+     * This function cannot fail. If the given signal name doesn’t exist,
+     * a critical warning is emitted. No validation is performed on the
+     * ‘detail’ string when specified in `detailed_signal,` other than a
+     * non-empty check.
+     *
+     * Refer to the [signals documentation](signals.html) for more
+     * details.
      * @param instance the instance to connect to.
      * @param detailed_signal a string of the form "signal-name::detail".
      * @param closure the closure to connect.
      * @param after whether the handler should be called before or after the  default handler of the signal.
-     * @returns the handler ID (always greater than 0 for successful connections)
+     * @returns the handler ID (always greater than 0)
      */
     function signal_connect_closure(
         instance: Object,
@@ -1530,12 +1542,20 @@ export namespace GObject {
      *
      * If `closure` is a floating reference (see g_closure_sink()), this function
      * takes ownership of `closure`.
+     *
+     * This function cannot fail. If the given signal name doesn’t exist,
+     * a critical warning is emitted. No validation is performed on the
+     * ‘detail’ string when specified in `detailed_signal,` other than a
+     * non-empty check.
+     *
+     * Refer to the [signals documentation](signals.html) for more
+     * details.
      * @param instance the instance to connect to.
      * @param signal_id the id of the signal.
      * @param detail the detail.
      * @param closure the closure to connect.
      * @param after whether the handler should be called before or after the  default handler of the signal.
-     * @returns the handler ID (always greater than 0 for successful connections)
+     * @returns the handler ID (always greater than 0)
      */
     function signal_connect_closure_by_id(
         instance: Object,
@@ -1634,6 +1654,7 @@ export namespace GObject {
      * @param mask Mask indicating which of @signal_id, @detail, @closure, @func  and/or @data the handlers have to match.
      * @param signal_id Signal the handlers have to be connected to.
      * @param detail Signal detail the handlers have to be connected to.
+     * @param closure The closure the handlers will invoke.
      * @param func The C closure callback of the handlers (useless for non-C closures).
      * @param data The closure data of the handlers' closures.
      * @returns The number of handlers that matched.
@@ -1643,6 +1664,7 @@ export namespace GObject {
         mask: SignalMatchType | null,
         signal_id: number,
         detail: GLib.Quark,
+        closure?: Closure | null,
         func?: any | null,
         data?: any | null,
     ): number;
@@ -1672,6 +1694,7 @@ export namespace GObject {
      * @param mask Mask indicating which of @signal_id, @detail, @closure, @func  and/or @data the handlers have to match.
      * @param signal_id Signal the handlers have to be connected to.
      * @param detail Signal detail the handlers have to be connected to.
+     * @param closure The closure the handlers will invoke.
      * @param func The C closure callback of the handlers (useless for non-C closures).
      * @param data The closure data of the handlers' closures.
      * @returns The number of handlers that matched.
@@ -1681,6 +1704,7 @@ export namespace GObject {
         mask: SignalMatchType | null,
         signal_id: number,
         detail: GLib.Quark,
+        closure?: Closure | null,
         func?: any | null,
         data?: any | null,
     ): number;
@@ -1704,6 +1728,7 @@ export namespace GObject {
      * @param mask Mask indicating which of @signal_id, @detail, @closure, @func  and/or @data the handlers have to match.
      * @param signal_id Signal the handlers have to be connected to.
      * @param detail Signal detail the handlers have to be connected to.
+     * @param closure The closure the handlers will invoke.
      * @param func The C closure callback of the handlers (useless for non-C closures).
      * @param data The closure data of the handlers' closures.
      * @returns The number of handlers that matched.
@@ -1713,6 +1738,7 @@ export namespace GObject {
         mask: SignalMatchType | null,
         signal_id: number,
         detail: GLib.Quark,
+        closure?: Closure | null,
         func?: any | null,
         data?: any | null,
     ): number;
@@ -1749,9 +1775,8 @@ export namespace GObject {
      * Validate a signal name. This can be useful for dynamically-generated signals
      * which need to be validated at run-time before actually trying to create them.
      *
-     * See [canonical parameter names][canonical-parameter-names] for details of
-     * the rules for valid names. The rules for signal names are the same as those
-     * for property names.
+     * See [func`GObject`.signal_new] for details of the rules for valid names.
+     * The rules for signal names are the same as those for property names.
      * @param name the canonical name of the signal
      * @returns %TRUE if @name is a valid signal name, %FALSE otherwise.
      */
@@ -1789,31 +1814,6 @@ export namespace GObject {
      * @returns the signal name, or %NULL if the signal number was invalid.
      */
     function signal_name(signal_id: number): string | null;
-    /**
-     * Creates a new signal. (This is usually done in the class initializer.)
-     *
-     * See g_signal_new() for details on allowed signal names.
-     *
-     * If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as
-     * the marshaller for this signal.
-     * @param signal_name the name for the signal
-     * @param itype the type this signal pertains to. It will also pertain to     types which are derived from this type
-     * @param signal_flags a combination of #GSignalFlags specifying detail of when     the default handler is to be invoked. You should at least specify     %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST
-     * @param class_closure The closure to invoke on signal emission;     may be %NULL
-     * @param c_marshaller the function to translate arrays of     parameter values to signal emissions into C language callback     invocations or %NULL
-     * @param return_type the type of return value, or %G_TYPE_NONE for a signal     without a return value
-     * @param param_types an array of types, one for     each parameter (may be %NULL if @n_params is zero)
-     * @returns the signal id
-     */
-    function signal_newv(
-        signal_name: string,
-        itype: GType,
-        signal_flags: SignalFlags | null,
-        class_closure: Closure | null,
-        c_marshaller: SignalCMarshaller | null,
-        return_type: GType,
-        param_types?: GType[] | null,
-    ): number;
     /**
      * Overrides the class closure (i.e. the default handler) for the given signal
      * for emissions on instances of `instance_type`. `instance_type` must be derived
@@ -1870,20 +1870,6 @@ export namespace GObject {
      * @param hook_id the id of the emission hook, as returned by  g_signal_add_emission_hook()
      */
     function signal_remove_emission_hook(signal_id: number, hook_id: number): void;
-    /**
-     * Change the #GSignalCVaMarshaller used for a given signal.  This is a
-     * specialised form of the marshaller that can often be used for the
-     * common case of a single connected signal handler and avoids the
-     * overhead of #GValue.  Its use is optional.
-     * @param signal_id the signal id
-     * @param instance_type the instance type on which to set the marshaller.
-     * @param va_marshaller the marshaller to set.
-     */
-    function signal_set_va_marshaller(
-        signal_id: number,
-        instance_type: GType,
-        va_marshaller: SignalCVaMarshaller,
-    ): void;
     /**
      * Stops a signal's current emission.
      *
@@ -2004,35 +1990,68 @@ export namespace GObject {
     function type_children(type: GType): GType[];
     function type_class_adjust_private_offset(g_class: any | null, private_size_or_offset: number): void;
     /**
-     * This function is essentially the same as g_type_class_ref(),
-     * except that the classes reference count isn't incremented.
+     * Retrieves the type class of the given `type`.
+     *
+     * This function will create the class on demand if it does not exist
+     * already.
+     *
+     * If you don't want to create the class, use g_type_class_peek() instead.
+     * @param type type ID of a classed type
+     * @returns the class structure   for the type
+     */
+    function type_class_get(type: GType): TypeClass;
+    /**
+     * Retrieves the class for a give type.
+     *
+     * This function is essentially the same as g_type_class_get(),
+     * except that the class may have not been instantiated yet.
+     *
      * As a consequence, this function may return %NULL if the class
      * of the type passed in does not currently exist (hasn't been
      * referenced before).
      * @param type type ID of a classed type
-     * @returns the #GTypeClass     structure for the given type ID or %NULL if the class does not     currently exist
+     * @returns the   #GTypeClass structure for the given type ID or %NULL if the class   does not currently exist
      */
-    function type_class_peek(type: GType): TypeClass;
+    function type_class_peek(type: GType): TypeClass | null;
     /**
      * A more efficient version of g_type_class_peek() which works only for
      * static types.
      * @param type type ID of a classed type
-     * @returns the #GTypeClass     structure for the given type ID or %NULL if the class does not     currently exist or is dynamically loaded
+     * @returns the   #GTypeClass structure for the given type ID or %NULL if the class   does not currently exist or is dynamically loaded
      */
-    function type_class_peek_static(type: GType): TypeClass;
+    function type_class_peek_static(type: GType): TypeClass | null;
     /**
      * Increments the reference count of the class structure belonging to
-     * `type`. This function will demand-create the class if it doesn't
-     * exist already.
+     * `type`.
+     *
+     * This function will demand-create the class if it doesn't exist already.
      * @param type type ID of a classed type
-     * @returns the #GTypeClass     structure for the given type ID
+     * @returns the #GTypeClass   structure for the given type ID
      */
     function type_class_ref(type: GType): TypeClass;
+    /**
+     * Returns the default interface vtable for the given `g_type`.
+     *
+     * If the type is not currently in use, then the default vtable
+     * for the type will be created and initialized by calling
+     * the base interface init and default vtable init functions for
+     * the type (the `base_init` and `class_init` members of #GTypeInfo).
+     *
+     * If you don't want to create the interface vtable, you should use
+     * g_type_default_interface_peek() instead.
+     *
+     * Calling g_type_default_interface_get() is useful when you
+     * want to make sure that signals and properties for an interface
+     * have been installed.
+     * @param g_type an interface type
+     * @returns the default   vtable for the interface.
+     */
+    function type_default_interface_get(g_type: GType): TypeInterface;
     /**
      * If the interface type `g_type` is currently in use, returns its
      * default interface vtable.
      * @param g_type an interface type
-     * @returns the default     vtable for the interface, or %NULL if the type is not currently     in use
+     * @returns the default   vtable for the interface, or %NULL if the type is not currently   in use
      */
     function type_default_interface_peek(g_type: GType): TypeInterface;
     /**
@@ -2047,15 +2066,16 @@ export namespace GObject {
      * want to make sure that signals and properties for an interface
      * have been installed.
      * @param g_type an interface type
-     * @returns the default     vtable for the interface; call g_type_default_interface_unref()     when you are done using the interface.
+     * @returns the default   vtable for the interface; call g_type_default_interface_unref()   when you are done using the interface.
      */
     function type_default_interface_ref(g_type: GType): TypeInterface;
     /**
      * Decrements the reference count for the type corresponding to the
-     * interface default vtable `g_iface`. If the type is dynamic, then
-     * when no one is using the interface and all references have
-     * been released, the finalize function for the interface's default
-     * vtable (the `class_finalize` member of #GTypeInfo) will be called.
+     * interface default vtable `g_iface`.
+     *
+     * If the type is dynamic, then when no one is using the interface and all
+     * references have been released, the finalize function for the interface's
+     * default vtable (the `class_finalize` member of #GTypeInfo) will be called.
      * @param g_iface the default vtable     structure for an interface, as returned by g_type_default_interface_ref()
      */
     function type_default_interface_unref(g_iface: TypeInterface): void;
@@ -2203,9 +2223,9 @@ export namespace GObject {
      * passed in class conforms.
      * @param instance_class a #GTypeClass structure
      * @param iface_type an interface ID which this class conforms to
-     * @returns the #GTypeInterface     structure of @iface_type if implemented by @instance_class, %NULL     otherwise
+     * @returns the #GTypeInterface   structure of @iface_type if implemented by @instance_class, %NULL   otherwise
      */
-    function type_interface_peek(instance_class: TypeClass, iface_type: GType): TypeInterface;
+    function type_interface_peek(instance_class: TypeClass, iface_type: GType): TypeInterface | null;
     /**
      * Returns the prerequisites of an interfaces type.
      * @param interface_type an interface type
@@ -2229,11 +2249,12 @@ export namespace GObject {
      */
     function type_is_a(type: GType, is_a_type: GType): boolean;
     /**
-     * Get the unique name that is assigned to a type ID.  Note that this
-     * function (like all other GType API) cannot cope with invalid type
-     * IDs. %G_TYPE_INVALID may be passed to this function, as may be any
-     * other validly registered type ID, but randomized type IDs should
-     * not be passed in and will most likely lead to a crash.
+     * Get the unique name that is assigned to a type ID.
+     *
+     * Note that this function (like all other GType API) cannot cope with
+     * invalid type IDs. %G_TYPE_INVALID may be passed to this function, as
+     * may be any other validly registered type ID, but randomized type IDs
+     * should not be passed in and will most likely lead to a crash.
      * @param type type to return name for
      * @returns static type name or %NULL
      */
@@ -2628,11 +2649,13 @@ export namespace GObject {
          */
         READWRITE,
         /**
-         * the parameter will be set upon object construction
+         * the parameter will be set upon object construction.
+         *   See [vfunc`Object`.constructed] for more details
          */
         CONSTRUCT,
         /**
-         * the parameter can only be set upon object construction
+         * the parameter can only be set upon object construction.
+         *   See [vfunc`Object`.constructed] for more details
          */
         CONSTRUCT_ONLY,
         /**
@@ -2729,20 +2752,23 @@ export namespace GObject {
          */
         NO_HOOKS,
         /**
-         * Varargs signal emission will always collect the
-         *   arguments, even if there are no signal handlers connected.  Since 2.30.
+         * Varargs signal emission will always collect the arguments, even if there
+         * are no signal handlers connected.
          */
         MUST_COLLECT,
         /**
-         * The signal is deprecated and will be removed
-         *   in a future version. A warning will be generated if it is connected while
-         *   running with G_ENABLE_DIAGNOSTIC=1.  Since 2.32.
+         * The signal is deprecated and will be removed in a future version.
+         *
+         * A warning will be generated if it is connected while running with
+         * `G_ENABLE_DIAGNOSTIC=1`.
          */
         DEPRECATED,
         /**
-         * Only used in #GSignalAccumulator accumulator
-         *   functions for the #GSignalInvocationHint::run_type field to mark the first
-         *   call to the accumulator function for a signal emission.  Since 2.68.
+         * The signal accumulator was invoked for the first time.
+         *
+         * This flag is only used in [callback`GObject`.SignalAccumulator][accumulator functions]
+         * for the `run_type` field of the [struct`GObject`.SignalInvocationHint], to
+         * mark the first call to the accumulator function for a signal emission.
          */
         ACCUMULATOR_FIRST_RUN,
     }
@@ -3573,7 +3599,21 @@ export namespace GObject {
          * @returns the data if found,          or %NULL if no such data exists.
          */
         get_data(key: string): any | null;
-        get_property(property_name: string): any;
+        /**
+         * Gets a property of an object.
+         *
+         * The value can be:
+         * - an empty GObject.Value initialized by G_VALUE_INIT, which will be automatically initialized with the expected type of the property (since GLib 2.60)
+         * - a GObject.Value initialized with the expected type of the property
+         * - a GObject.Value initialized with a type to which the expected type of the property can be transformed
+         *
+         * In general, a copy is made of the property contents and the caller is responsible for freeing the memory by calling GObject.Value.unset.
+         *
+         * Note that GObject.Object.get_property is really intended for language bindings, GObject.Object.get is much more convenient for C programming.
+         * @param property_name The name of the property to get
+         * @param value Return location for the property value. Can be an empty GObject.Value initialized by G_VALUE_INIT (auto-initialized with expected type since GLib 2.60), a GObject.Value initialized with the expected property type, or a GObject.Value initialized with a transformable type
+         */
+        get_property(property_name: string, value: Value | any): any;
         /**
          * This function gets back user data pointers stored via
          * g_object_set_qdata().
@@ -3701,7 +3741,12 @@ export namespace GObject {
          * @param data data to associate with that key
          */
         set_data(key: string, data?: any | null): void;
-        set_property(property_name: string, value: any): void;
+        /**
+         * Sets a property on an object.
+         * @param property_name The name of the property to set
+         * @param value The value to set the property to
+         */
+        set_property(property_name: string, value: Value | any): void;
         /**
          * Remove a specified datum from the object's data associations,
          * without invoking the association's destroy handler.
@@ -3786,11 +3831,31 @@ export namespace GObject {
          * @param closure #GClosure to watch
          */
         watch_closure(closure: Closure): void;
+        /**
+         * Disconnects a handler from an instance so it will not be called during any future or currently ongoing emissions of the signal it has been connected to.
+         * @param id Handler ID of the handler to be disconnected
+         */
         disconnect(id: number): void;
+        /**
+         * Sets multiple properties of an object at once. The properties argument should be a dictionary mapping property names to values.
+         * @param properties Object containing the properties to set
+         */
         set(properties: { [key: string]: any }): void;
-        block_signal_handler(id: number): any;
-        unblock_signal_handler(id: number): any;
-        stop_emission_by_name(detailedName: string): any;
+        /**
+         * Blocks a handler of an instance so it will not be called during any signal emissions
+         * @param id Handler ID of the handler to be blocked
+         */
+        block_signal_handler(id: number): void;
+        /**
+         * Unblocks a handler so it will be called again during any signal emissions
+         * @param id Handler ID of the handler to be unblocked
+         */
+        unblock_signal_handler(id: number): void;
+        /**
+         * Stops a signal's emission by the given signal name. This will prevent the default handler and any subsequent signal handlers from being invoked.
+         * @param detailedName Name of the signal to stop emission of
+         */
+        stop_emission_by_name(detailedName: string): void;
     }
 
     /**
@@ -3818,8 +3883,8 @@ export namespace GObject {
          * dynamically-generated properties which need to be validated at run-time
          * before actually trying to create them.
          *
-         * See [canonical parameter names][canonical-parameter-names] for details of
-         * the rules for valid names.
+         * See [canonical parameter names][class`GObject`.ParamSpec#parameter-names]
+         * for details of the rules for valid names.
          * @param name the canonical name of the property
          */
         static is_valid_name(name: string): boolean;
@@ -4075,11 +4140,19 @@ export namespace GObject {
             flags: ParamFlags | number,
             boxedType: GType<T> | { $gtype: GType<T> },
         ): ParamSpec<T>;
+        /**
+         * Creates a new GParamSpecObject instance specifying a property holding object references.
+         * @param name The name of the property
+         * @param nick A human readable name for the property (can be null)
+         * @param blurb A longer description of the property (can be null)
+         * @param flags The flags for this property (e.g. READABLE, WRITABLE)
+         * @param objectType The GType of the object
+         */
         static object<T>(
             name: string,
             nick: string | null,
             blurb: string | null,
-            flags: string,
+            flags: ParamFlags | number,
             objectType: GType<T> | { $gtype: GType<T> },
         ): ParamSpec<T>;
         /**
@@ -4097,7 +4170,19 @@ export namespace GObject {
             flags: ParamFlags | number,
             paramType: any,
         ): ParamSpec;
-        static jsobject<T>(name: string, nick: string | null, blurb: string | null, flags: any): ParamSpec<T>;
+        /**
+         * Creates a new ParamSpec instance for JavaScript object properties.
+         * @param name The name of the property
+         * @param nick A human readable name for the property (can be null)
+         * @param blurb A longer description of the property (can be null)
+         * @param flags The flags for this property (e.g. READABLE, WRITABLE)
+         */
+        static jsobject<T>(
+            name: string,
+            nick: string | null,
+            blurb: string | null,
+            flags: ParamFlags | number,
+        ): ParamSpec<T>;
 
         // Virtual methods
 
@@ -4214,6 +4299,11 @@ export namespace GObject {
          * @returns the user data pointer set, or %NULL
          */
         steal_qdata(quark: GLib.Quark): any | null;
+        /**
+         * Registers a property override for a property introduced in a parent class or inherited interface.
+         * @param name The name of the property to override
+         * @param oclass The object class or type that contains the property to override
+         */
         override(name: string, oclass: Object | Function | GType): void;
     }
 
@@ -4666,7 +4756,21 @@ export namespace GObject {
          * @returns the data if found,          or %NULL if no such data exists.
          */
         get_data(key: string): any | null;
-        get_property(property_name: string): any;
+        /**
+         * Gets a property of an object.
+         *
+         * The value can be:
+         * - an empty GObject.Value initialized by G_VALUE_INIT, which will be automatically initialized with the expected type of the property (since GLib 2.60)
+         * - a GObject.Value initialized with the expected type of the property
+         * - a GObject.Value initialized with a type to which the expected type of the property can be transformed
+         *
+         * In general, a copy is made of the property contents and the caller is responsible for freeing the memory by calling GObject.Value.unset.
+         *
+         * Note that GObject.Object.get_property is really intended for language bindings, GObject.Object.get is much more convenient for C programming.
+         * @param property_name The name of the property to get
+         * @param value Return location for the property value. Can be an empty GObject.Value initialized by G_VALUE_INIT (auto-initialized with expected type since GLib 2.60), a GObject.Value initialized with the expected property type, or a GObject.Value initialized with a transformable type
+         */
+        get_property(property_name: string, value: Value | any): any;
         /**
          * This function gets back user data pointers stored via
          * g_object_set_qdata().
@@ -4794,7 +4898,12 @@ export namespace GObject {
          * @param data data to associate with that key
          */
         set_data(key: string, data?: any | null): void;
-        set_property(property_name: string, value: any): void;
+        /**
+         * Sets a property on an object.
+         * @param property_name The name of the property to set
+         * @param value The value to set the property to
+         */
+        set_property(property_name: string, value: Value | any): void;
         /**
          * Remove a specified datum from the object's data associations,
          * without invoking the association's destroy handler.
@@ -4944,11 +5053,31 @@ export namespace GObject {
          * @param pspec
          */
         vfunc_set_property(property_id: number, value: Value | any, pspec: ParamSpec): void;
+        /**
+         * Disconnects a handler from an instance so it will not be called during any future or currently ongoing emissions of the signal it has been connected to.
+         * @param id Handler ID of the handler to be disconnected
+         */
         disconnect(id: number): void;
+        /**
+         * Sets multiple properties of an object at once. The properties argument should be a dictionary mapping property names to values.
+         * @param properties Object containing the properties to set
+         */
         set(properties: { [key: string]: any }): void;
-        block_signal_handler(id: number): any;
-        unblock_signal_handler(id: number): any;
-        stop_emission_by_name(detailedName: string): any;
+        /**
+         * Blocks a handler of an instance so it will not be called during any signal emissions
+         * @param id Handler ID of the handler to be blocked
+         */
+        block_signal_handler(id: number): void;
+        /**
+         * Unblocks a handler so it will be called again during any signal emissions
+         * @param id Handler ID of the handler to be unblocked
+         */
+        unblock_signal_handler(id: number): void;
+        /**
+         * Stops a signal's emission by the given signal name. This will prevent the default handler and any subsequent signal handlers from being invoked.
+         * @param detailedName Name of the signal to stop emission of
+         */
+        stop_emission_by_name(detailedName: string): void;
     }
 
     /**
@@ -5681,24 +5810,38 @@ export namespace GObject {
 
         static adjust_private_offset(g_class: any | null, private_size_or_offset: number): void;
         /**
-         * This function is essentially the same as g_type_class_ref(),
-         * except that the classes reference count isn't incremented.
+         * Retrieves the type class of the given `type`.
+         *
+         * This function will create the class on demand if it does not exist
+         * already.
+         *
+         * If you don't want to create the class, use g_type_class_peek() instead.
+         * @param type type ID of a classed type
+         */
+        static get(type: GType): TypeClass;
+        /**
+         * Retrieves the class for a give type.
+         *
+         * This function is essentially the same as g_type_class_get(),
+         * except that the class may have not been instantiated yet.
+         *
          * As a consequence, this function may return %NULL if the class
          * of the type passed in does not currently exist (hasn't been
          * referenced before).
          * @param type type ID of a classed type
          */
-        static peek(type: GType): TypeClass;
+        static peek(type: GType): TypeClass | null;
         /**
          * A more efficient version of g_type_class_peek() which works only for
          * static types.
          * @param type type ID of a classed type
          */
-        static peek_static(type: GType): TypeClass;
+        static peek_static(type: GType): TypeClass | null;
         /**
          * Increments the reference count of the class structure belonging to
-         * `type`. This function will demand-create the class if it doesn't
-         * exist already.
+         * `type`.
+         *
+         * This function will demand-create the class if it doesn't exist already.
          * @param type type ID of a classed type
          */
         static ref(type: GType): TypeClass;
@@ -5775,19 +5918,22 @@ export namespace GObject {
         add_private(private_size: number): void;
         get_private(private_type: GType): any | null;
         /**
+         * Retrieves the class structure of the immediate parent type of the
+         * class passed in.
+         *
          * This is a convenience function often needed in class initializers.
-         * It returns the class structure of the immediate parent type of the
-         * class passed in.  Since derived classes hold a reference count on
-         * their parent classes as long as they are instantiated, the returned
-         * class will always exist.
+         *
+         * Since derived classes hold a reference on their parent classes as
+         * long as they are instantiated, the returned class will always exist.
          *
          * This function is essentially equivalent to:
          * g_type_class_peek (g_type_parent (G_TYPE_FROM_CLASS (g_class)))
-         * @returns the parent class     of @g_class
+         * @returns the parent class   of @g_class
          */
         peek_parent(): TypeClass;
         /**
          * Decrements the reference count of the class structure being passed in.
+         *
          * Once the last reference count of a class has been released, classes
          * may be finalized by the type system, so further dereferencing of a
          * class pointer after g_type_class_unref() are invalid.
@@ -5904,7 +6050,7 @@ export namespace GObject {
          * @param instance_class a #GTypeClass structure
          * @param iface_type an interface ID which this class conforms to
          */
-        static peek(instance_class: TypeClass, iface_type: GType): TypeInterface;
+        static peek(instance_class: TypeClass, iface_type: GType): TypeInterface | null;
         /**
          * Returns the prerequisites of an interfaces type.
          * @param interface_type an interface type
@@ -5915,12 +6061,13 @@ export namespace GObject {
 
         /**
          * Returns the corresponding #GTypeInterface structure of the parent type
-         * of the instance type to which `g_iface` belongs. This is useful when
-         * deriving the implementation of an interface from the parent type and
-         * then possibly overriding some methods.
-         * @returns the     corresponding #GTypeInterface structure of the parent type of the     instance type to which @g_iface belongs, or %NULL if the parent     type doesn't conform to the interface
+         * of the instance type to which `g_iface` belongs.
+         *
+         * This is useful when deriving the implementation of an interface from the
+         * parent type and then possibly overriding some methods.
+         * @returns the   corresponding #GTypeInterface structure of the parent type of the   instance type to which @g_iface belongs, or %NULL if the parent   type doesn't conform to the interface
          */
-        peek_parent(): TypeInterface;
+        peek_parent(): TypeInterface | null;
     }
 
     type TypeModuleClass = typeof TypeModule;
@@ -5964,6 +6111,15 @@ export namespace GObject {
     }
 
     /**
+     * - `'i'`: Integers, passed as `collect_values[].v_int`
+     *   - `'l'`: Longs, passed as `collect_values[].v_long`
+     *   - `'d'`: Doubles, passed as `collect_values[].v_double`
+     *   - `'p'`: Pointers, passed as `collect_values[].v_pointer`
+     *
+     *   It should be noted that for variable argument list construction,
+     *   ANSI C promotes every type smaller than an integer to an int, and
+     *   floats to doubles. So for collection of short int or char, `'i'`
+     *   needs to be used, and for collection of floats `'d'`.
      * The #GTypeValueTable provides the functions required by the #GValue
      * implementation, to serve as a container for values of a type.
      */
@@ -6467,7 +6623,7 @@ export namespace GObject {
          */
         copy(): ValueArray;
         /**
-         * Return a pointer to the value at `index_` containd in `value_array`.
+         * Return a pointer to the value at `index_` contained in `value_array`.
          * @param index_ index of the value of interest
          * @returns pointer to a value at @index_ in @value_array
          */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@girs/gobject-2.0",
-  "version": "2.82.4-4.0.0-beta.20",
-  "description": "GJS TypeScript type definitions for GObject-2.0, generated from library version 2.82.4",
+  "version": "2.84.0-4.0.0-beta.23",
+  "description": "GJS TypeScript type definitions for GObject-2.0, generated from library version 2.84.0",
   "type": "module",
   "module": "gobject-2.0.js",
   "main": "gobject-2.0.js",
@@ -31,8 +31,8 @@
     "test": "tsc --project tsconfig.json"
   },
   "dependencies": {
-    "@girs/gjs": "^4.0.0-beta.20",
-    "@girs/glib-2.0": "^2.82.4-4.0.0-beta.20"
+    "@girs/gjs": "^4.0.0-beta.23",
+    "@girs/glib-2.0": "^2.84.0-4.0.0-beta.23"
   },
   "devDependencies": {
     "typescript": "*"