@girs/cinnamondesktop-3.0 3.0.0-4.0.0-beta.21 → 3.0.0-4.0.0-beta.24

package/README.md

@@ -5,7 +5,7 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/cinnamondesktop-3.0)
 
 
-GJS TypeScript type definitions for CinnamonDesktop-3.0, generated from library version 3.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.21.
+GJS TypeScript type definitions for CinnamonDesktop-3.0, generated from library version 3.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.24.
 
 
 ## Install

package/cinnamondesktop-3.0.d.ts

@@ -7,11 +7,13 @@
  * 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 Gtk from '@girs/gtk-3.0';
 import type xlib from '@girs/xlib-2.0';
 import type Gdk from '@girs/gdk-3.0';
-import type cairo from '@girs/cairo-1.0';
+import type cairo from 'cairo';
 import type GObject from '@girs/gobject-2.0';
 import type GLib from '@girs/glib-2.0';
 import type Pango from '@girs/pango-1.0';
@@ -285,14 +287,10 @@ export namespace CinnamonDesktop {
         REFLECT_Y,
     }
     namespace BG {
-        // Signal callback interfaces
-
-        interface Changed {
-            (): void;
-        }
-
-        interface Transitioned {
-            (): void;
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            changed: () => void;
+            transitioned: () => void;
         }
 
         // Constructor properties interface
@@ -303,6 +301,15 @@ export namespace CinnamonDesktop {
     class BG extends GObject.Object {
         static $gtype: GObject.GType<BG>;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: BG.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<BG.ConstructorProps>, ...args: any[]);
@@ -313,15 +320,21 @@ export namespace CinnamonDesktop {
 
         // Signals
 
-        connect(id: string, callback: (...args: any[]) => any): number;
-        connect_after(id: string, callback: (...args: any[]) => any): number;
-        emit(id: string, ...args: any[]): void;
-        connect(signal: 'changed', callback: (_source: this) => void): number;
-        connect_after(signal: 'changed', callback: (_source: this) => void): number;
-        emit(signal: 'changed'): void;
-        connect(signal: 'transitioned', callback: (_source: this) => void): number;
-        connect_after(signal: 'transitioned', callback: (_source: this) => void): number;
-        emit(signal: 'transitioned'): void;
+        connect<K extends keyof BG.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, BG.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof BG.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, BG.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof BG.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<BG.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
 
         // Static methods
 
@@ -418,10 +431,11 @@ export namespace CinnamonDesktop {
     }
 
     namespace BGCrossfade {
-        // Signal callback interfaces
-
-        interface Finished {
-            (window: GObject.Object): void;
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            finished: (arg0: GObject.Object) => void;
+            'notify::height': (pspec: GObject.ParamSpec) => void;
+            'notify::width': (pspec: GObject.ParamSpec) => void;
         }
 
         // Constructor properties interface
@@ -448,6 +462,15 @@ export namespace CinnamonDesktop {
          */
         get width(): number;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: BGCrossfade.SignalSignatures;
+
         // Fields
 
         parent_object: GObject.Object;
@@ -462,12 +485,21 @@ export namespace CinnamonDesktop {
 
         // Signals
 
-        connect(id: string, callback: (...args: any[]) => any): number;
-        connect_after(id: string, callback: (...args: any[]) => any): number;
-        emit(id: string, ...args: any[]): void;
-        connect(signal: 'finished', callback: (_source: this, window: GObject.Object) => void): number;
-        connect_after(signal: 'finished', callback: (_source: this, window: GObject.Object) => void): number;
-        emit(signal: 'finished', window: GObject.Object): void;
+        connect<K extends keyof BGCrossfade.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, BGCrossfade.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof BGCrossfade.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, BGCrossfade.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof BGCrossfade.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<BGCrossfade.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
 
         // Virtual methods
 
@@ -516,6 +548,9 @@ export namespace CinnamonDesktop {
     }
 
     namespace DesktopThumbnailFactory {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {}
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {}
@@ -524,6 +559,15 @@ export namespace CinnamonDesktop {
     class DesktopThumbnailFactory extends GObject.Object {
         static $gtype: GObject.GType<DesktopThumbnailFactory>;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: DesktopThumbnailFactory.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<DesktopThumbnailFactory.ConstructorProps>, ...args: any[]);
@@ -532,6 +576,26 @@ export namespace CinnamonDesktop {
 
         static ['new'](size: DesktopThumbnailSize): DesktopThumbnailFactory;
 
+        // Signals
+
+        connect<K extends keyof DesktopThumbnailFactory.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, DesktopThumbnailFactory.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof DesktopThumbnailFactory.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, DesktopThumbnailFactory.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof DesktopThumbnailFactory.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<DesktopThumbnailFactory.SignalSignatures[K]> extends [any, ...infer Q]
+                ? Q
+                : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Methods
 
         /**
@@ -597,6 +661,9 @@ export namespace CinnamonDesktop {
     }
 
     namespace IdleMonitor {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {}
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps, Gio.Initable.ConstructorProps {}
@@ -605,6 +672,15 @@ export namespace CinnamonDesktop {
     class IdleMonitor extends GObject.Object implements Gio.Initable {
         static $gtype: GObject.GType<IdleMonitor>;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: IdleMonitor.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<IdleMonitor.ConstructorProps>, ...args: any[]);
@@ -613,6 +689,24 @@ export namespace CinnamonDesktop {
 
         static ['new'](): IdleMonitor;
 
+        // Signals
+
+        connect<K extends keyof IdleMonitor.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, IdleMonitor.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof IdleMonitor.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, IdleMonitor.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof IdleMonitor.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<IdleMonitor.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Methods
 
         add_idle_watch(interval_msec: number, callback?: IdleMonitorWatchFunc | null): number;
@@ -646,7 +740,7 @@ export namespace CinnamonDesktop {
          * If the object is not initialized, or initialization returns with an
          * error, then all operations on the object except g_object_ref() and
          * g_object_unref() are considered to be invalid, and have undefined
-         * behaviour. See the [introduction][ginitable] for more details.
+         * behaviour. See the [description][iface`Gio`.Initable#description] for more details.
          *
          * Callers should not assume that a class which implements #GInitable can be
          * initialized multiple times, unless the class explicitly documents itself as
@@ -689,7 +783,7 @@ export namespace CinnamonDesktop {
          * If the object is not initialized, or initialization returns with an
          * error, then all operations on the object except g_object_ref() and
          * g_object_unref() are considered to be invalid, and have undefined
-         * behaviour. See the [introduction][ginitable] for more details.
+         * behaviour. See the [description][iface`Gio`.Initable#description] for more details.
          *
          * Callers should not assume that a class which implements #GInitable can be
          * initialized multiple times, unless the class explicitly documents itself as
@@ -829,7 +923,21 @@ export namespace CinnamonDesktop {
          * @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: GObject.Value | any): any;
         /**
          * This function gets back user data pointers stored via
          * g_object_set_qdata().
@@ -957,7 +1065,12 @@ export namespace CinnamonDesktop {
          * @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: GObject.Value | any): void;
         /**
          * Remove a specified datum from the object's data associations,
          * without invoking the association's destroy handler.
@@ -1107,14 +1220,37 @@ export namespace CinnamonDesktop {
          * @param pspec
          */
         vfunc_set_property(property_id: number, value: GObject.Value | any, pspec: GObject.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;
     }
 
     namespace PnpIds {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {}
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {}
@@ -1123,6 +1259,15 @@ export namespace CinnamonDesktop {
     class PnpIds extends GObject.Object {
         static $gtype: GObject.GType<PnpIds>;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: PnpIds.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<PnpIds.ConstructorProps>, ...args: any[]);
@@ -1131,6 +1276,24 @@ export namespace CinnamonDesktop {
 
         static ['new'](): PnpIds;
 
+        // Signals
+
+        connect<K extends keyof PnpIds.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, PnpIds.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof PnpIds.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, PnpIds.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof PnpIds.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<PnpIds.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Methods
 
         /**
@@ -1142,6 +1305,11 @@ export namespace CinnamonDesktop {
     }
 
     namespace RRConfig {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            'notify::screen': (pspec: GObject.ParamSpec) => void;
+        }
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {
@@ -1156,6 +1324,15 @@ export namespace CinnamonDesktop {
 
         set screen(val: RRScreen);
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: RRConfig.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<RRConfig.ConstructorProps>, ...args: any[]);
@@ -1166,6 +1343,24 @@ export namespace CinnamonDesktop {
 
         static new_stored(screen: RRScreen): RRConfig;
 
+        // Signals
+
+        connect<K extends keyof RRConfig.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RRConfig.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof RRConfig.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RRConfig.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof RRConfig.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<RRConfig.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Static methods
 
         static apply_from_filename_with_time(screen: RRScreen, filename: string, timestamp: number): boolean;
@@ -1194,6 +1389,11 @@ export namespace CinnamonDesktop {
     }
 
     namespace RRLabeler {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            'notify::config': (pspec: GObject.ParamSpec) => void;
+        }
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {
@@ -1208,6 +1408,15 @@ export namespace CinnamonDesktop {
 
         set config(val: RRConfig);
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: RRLabeler.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<RRLabeler.ConstructorProps>, ...args: any[]);
@@ -1216,6 +1425,24 @@ export namespace CinnamonDesktop {
 
         static ['new'](config: RRConfig): RRLabeler;
 
+        // Signals
+
+        connect<K extends keyof RRLabeler.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RRLabeler.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof RRLabeler.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RRLabeler.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof RRLabeler.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<RRLabeler.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Methods
 
         /**
@@ -1234,6 +1461,9 @@ export namespace CinnamonDesktop {
     }
 
     namespace RROutputInfo {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {}
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {}
@@ -1242,12 +1472,39 @@ export namespace CinnamonDesktop {
     class RROutputInfo extends GObject.Object {
         static $gtype: GObject.GType<RROutputInfo>;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: RROutputInfo.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<RROutputInfo.ConstructorProps>, ...args: any[]);
 
         _init(...args: any[]): void;
 
+        // Signals
+
+        connect<K extends keyof RROutputInfo.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RROutputInfo.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof RROutputInfo.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RROutputInfo.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof RROutputInfo.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<RROutputInfo.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Methods
 
         get_aspect_ratio(): number;
@@ -1278,18 +1535,12 @@ export namespace CinnamonDesktop {
     }
 
     namespace RRScreen {
-        // Signal callback interfaces
-
-        interface Changed {
-            (): void;
-        }
-
-        interface OutputConnected {
-            (output?: any | null): void;
-        }
-
-        interface OutputDisconnected {
-            (output?: any | null): void;
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            changed: () => void;
+            'output-connected': (arg0: any | null) => void;
+            'output-disconnected': (arg0: any | null) => void;
+            'notify::gdk-screen': (pspec: GObject.ParamSpec) => void;
         }
 
         // Constructor properties interface
@@ -1308,6 +1559,15 @@ export namespace CinnamonDesktop {
         get gdk_screen(): Gdk.Screen;
         get gdkScreen(): Gdk.Screen;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: RRScreen.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<RRScreen.ConstructorProps>, ...args: any[]);
@@ -1318,18 +1578,21 @@ export namespace CinnamonDesktop {
 
         // Signals
 
-        connect(id: string, callback: (...args: any[]) => any): number;
-        connect_after(id: string, callback: (...args: any[]) => any): number;
-        emit(id: string, ...args: any[]): void;
-        connect(signal: 'changed', callback: (_source: this) => void): number;
-        connect_after(signal: 'changed', callback: (_source: this) => void): number;
-        emit(signal: 'changed'): void;
-        connect(signal: 'output-connected', callback: (_source: this, output: any | null) => void): number;
-        connect_after(signal: 'output-connected', callback: (_source: this, output: any | null) => void): number;
-        emit(signal: 'output-connected', output?: any | null): void;
-        connect(signal: 'output-disconnected', callback: (_source: this, output: any | null) => void): number;
-        connect_after(signal: 'output-disconnected', callback: (_source: this, output: any | null) => void): number;
-        emit(signal: 'output-disconnected', output?: any | null): void;
+        connect<K extends keyof RRScreen.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RRScreen.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof RRScreen.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, RRScreen.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof RRScreen.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<RRScreen.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
 
         // Methods
 
@@ -1406,7 +1669,7 @@ export namespace CinnamonDesktop {
          * If the object is not initialized, or initialization returns with an
          * error, then all operations on the object except g_object_ref() and
          * g_object_unref() are considered to be invalid, and have undefined
-         * behaviour. See the [introduction][ginitable] for more details.
+         * behaviour. See the [description][iface`Gio`.Initable#description] for more details.
          *
          * Callers should not assume that a class which implements #GInitable can be
          * initialized multiple times, unless the class explicitly documents itself as
@@ -1449,7 +1712,7 @@ export namespace CinnamonDesktop {
          * If the object is not initialized, or initialization returns with an
          * error, then all operations on the object except g_object_ref() and
          * g_object_unref() are considered to be invalid, and have undefined
-         * behaviour. See the [introduction][ginitable] for more details.
+         * behaviour. See the [description][iface`Gio`.Initable#description] for more details.
          *
          * Callers should not assume that a class which implements #GInitable can be
          * initialized multiple times, unless the class explicitly documents itself as
@@ -1589,7 +1852,21 @@ export namespace CinnamonDesktop {
          * @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: GObject.Value | any): any;
         /**
          * This function gets back user data pointers stored via
          * g_object_set_qdata().
@@ -1717,7 +1994,12 @@ export namespace CinnamonDesktop {
          * @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: GObject.Value | any): void;
         /**
          * Remove a specified datum from the object's data associations,
          * without invoking the association's destroy handler.
@@ -1867,14 +2149,40 @@ export namespace CinnamonDesktop {
          * @param pspec
          */
         vfunc_set_property(property_id: number, value: GObject.Value | any, pspec: GObject.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;
     }
 
     namespace WallClock {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            'notify::clock': (pspec: GObject.ParamSpec) => void;
+            'notify::format-string': (pspec: GObject.ParamSpec) => void;
+        }
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {
@@ -1908,6 +2216,15 @@ export namespace CinnamonDesktop {
         get formatString(): string;
         set formatString(val: string);
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: WallClock.SignalSignatures;
+
         // Fields
 
         parent_object: GObject.Object;
@@ -1920,6 +2237,24 @@ export namespace CinnamonDesktop {
 
         static ['new'](): WallClock;
 
+        // Signals
+
+        connect<K extends keyof WallClock.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, WallClock.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof WallClock.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, WallClock.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof WallClock.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<WallClock.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Static methods
 
         /**
@@ -1973,6 +2308,9 @@ export namespace CinnamonDesktop {
     }
 
     namespace XkbInfo {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {}
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {}
@@ -1981,6 +2319,15 @@ export namespace CinnamonDesktop {
     class XkbInfo extends GObject.Object {
         static $gtype: GObject.GType<XkbInfo>;
 
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: XkbInfo.SignalSignatures;
+
         // Fields
 
         parent_object: GObject.Object;
@@ -1993,6 +2340,24 @@ export namespace CinnamonDesktop {
 
         static ['new'](): XkbInfo;
 
+        // Signals
+
+        connect<K extends keyof XkbInfo.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, XkbInfo.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof XkbInfo.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, XkbInfo.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof XkbInfo.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<XkbInfo.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Methods
 
         description_for_option(group_id: string, id: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girs/cinnamondesktop-3.0",
-  "version": "3.0.0-4.0.0-beta.21",
+  "version": "3.0.0-4.0.0-beta.24",
   "description": "GJS TypeScript type definitions for CinnamonDesktop-3.0, generated from library version 3.0.0",
   "type": "module",
   "module": "cinnamondesktop-3.0.js",
@@ -31,21 +31,21 @@
     "test": "tsc --project tsconfig.json"
   },
   "dependencies": {
-    "@girs/atk-1.0": "^2.55.2-4.0.0-beta.21",
-    "@girs/cairo-1.0": "^1.0.0-4.0.0-beta.21",
-    "@girs/cdesktopenums-3.0": "^3.0.0-4.0.0-beta.21",
-    "@girs/freetype2-2.0": "^2.0.0-4.0.0-beta.21",
-    "@girs/gdk-3.0": "^3.24.48-4.0.0-beta.21",
-    "@girs/gdkpixbuf-2.0": "^2.0.0-4.0.0-beta.21",
-    "@girs/gio-2.0": "^2.83.3-4.0.0-beta.21",
-    "@girs/gjs": "^4.0.0-beta.21",
-    "@girs/glib-2.0": "^2.83.3-4.0.0-beta.21",
-    "@girs/gmodule-2.0": "^2.0.0-4.0.0-beta.21",
-    "@girs/gobject-2.0": "^2.83.3-4.0.0-beta.21",
-    "@girs/gtk-3.0": "^3.24.48-4.0.0-beta.21",
-    "@girs/harfbuzz-0.0": "^9.0.0-4.0.0-beta.21",
-    "@girs/pango-1.0": "^1.56.0-4.0.0-beta.21",
-    "@girs/xlib-2.0": "^2.0.0-4.0.0-beta.21"
+    "@girs/atk-1.0": "^2.56.2-4.0.0-beta.24",
+    "@girs/cairo-1.0": "^1.0.0-4.0.0-beta.24",
+    "@girs/cdesktopenums-3.0": "^3.0.0-4.0.0-beta.24",
+    "@girs/freetype2-2.0": "^2.0.0-4.0.0-beta.24",
+    "@girs/gdk-3.0": "^3.24.50-4.0.0-beta.24",
+    "@girs/gdkpixbuf-2.0": "^2.0.0-4.0.0-beta.24",
+    "@girs/gio-2.0": "^2.84.2-4.0.0-beta.24",
+    "@girs/gjs": "^4.0.0-beta.24",
+    "@girs/glib-2.0": "^2.84.2-4.0.0-beta.24",
+    "@girs/gmodule-2.0": "^2.0.0-4.0.0-beta.24",
+    "@girs/gobject-2.0": "^2.84.2-4.0.0-beta.24",
+    "@girs/gtk-3.0": "^3.24.50-4.0.0-beta.24",
+    "@girs/harfbuzz-0.0": "^10.4.0-4.0.0-beta.24",
+    "@girs/pango-1.0": "^1.56.4-4.0.0-beta.24",
+    "@girs/xlib-2.0": "^2.0.0-4.0.0-beta.24"
   },
   "devDependencies": {
     "typescript": "*"