@girs/bamf-3 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/bamf-3)
 
 
-GJS TypeScript type definitions for Bamf-3, 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 Bamf-3, 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/bamf-3.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 GObject from '@girs/gobject-2.0';
 import type GLib from '@girs/glib-2.0';
@@ -82,18 +84,17 @@ export namespace Bamf {
         (self: Tab, preview_data: string): void;
     }
     namespace Application {
-        // Signal callback interfaces
-
-        interface DesktopFileUpdated {
-            (object: string): void;
-        }
-
-        interface WindowAdded {
-            (object: Window): void;
-        }
-
-        interface WindowRemoved {
-            (object: Window): void;
+        // Signal signatures
+        interface SignalSignatures extends View.SignalSignatures {
+            'desktop-file-updated': (arg0: string) => void;
+            'window-added': (arg0: Window) => void;
+            'window-removed': (arg0: Window) => void;
+            'notify::active': (pspec: GObject.ParamSpec) => void;
+            'notify::path': (pspec: GObject.ParamSpec) => void;
+            'notify::running': (pspec: GObject.ParamSpec) => void;
+            'notify::starting': (pspec: GObject.ParamSpec) => void;
+            'notify::urgent': (pspec: GObject.ParamSpec) => void;
+            'notify::user-visible': (pspec: GObject.ParamSpec) => void;
         }
 
         // Constructor properties interface
@@ -104,6 +105,15 @@ export namespace Bamf {
     class Application extends View {
         static $gtype: GObject.GType<Application>;
 
+        /**
+         * 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: Application.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<Application.ConstructorProps>, ...args: any[]);
@@ -112,18 +122,21 @@ export namespace Bamf {
 
         // 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: 'desktop-file-updated', callback: (_source: this, object: string) => void): number;
-        connect_after(signal: 'desktop-file-updated', callback: (_source: this, object: string) => void): number;
-        emit(signal: 'desktop-file-updated', object: string): void;
-        connect(signal: 'window-added', callback: (_source: this, object: Window) => void): number;
-        connect_after(signal: 'window-added', callback: (_source: this, object: Window) => void): number;
-        emit(signal: 'window-added', object: Window): void;
-        connect(signal: 'window-removed', callback: (_source: this, object: Window) => void): number;
-        connect_after(signal: 'window-removed', callback: (_source: this, object: Window) => void): number;
-        emit(signal: 'window-removed', object: Window): void;
+        connect<K extends keyof Application.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Application.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof Application.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Application.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof Application.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<Application.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
 
         // Methods
 
@@ -165,6 +178,9 @@ export namespace Bamf {
     }
 
     namespace Control {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {}
+
         // Constructor properties interface
 
         interface ConstructorProps extends GObject.Object.ConstructorProps {}
@@ -173,12 +189,39 @@ export namespace Bamf {
     class Control extends GObject.Object {
         static $gtype: GObject.GType<Control>;
 
+        /**
+         * 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: Control.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<Control.ConstructorProps>, ...args: any[]);
 
         _init(...args: any[]): void;
 
+        // Signals
+
+        connect<K extends keyof Control.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Control.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof Control.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Control.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof Control.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<Control.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Static methods
 
         static get_default(): Control;
@@ -192,26 +235,13 @@ export namespace Bamf {
     }
 
     namespace Matcher {
-        // Signal callback interfaces
-
-        interface ActiveApplicationChanged {
-            (object: Application, p0: Application): void;
-        }
-
-        interface ActiveWindowChanged {
-            (object: Window, p0: Window): void;
-        }
-
-        interface StackingOrderChanged {
-            (): void;
-        }
-
-        interface ViewClosed {
-            (object: View): void;
-        }
-
-        interface ViewOpened {
-            (object: View): void;
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            'active-application-changed': (arg0: Application, arg1: Application) => void;
+            'active-window-changed': (arg0: Window, arg1: Window) => void;
+            'stacking-order-changed': () => void;
+            'view-closed': (arg0: View) => void;
+            'view-opened': (arg0: View) => void;
         }
 
         // Constructor properties interface
@@ -222,6 +252,15 @@ export namespace Bamf {
     class Matcher extends GObject.Object {
         static $gtype: GObject.GType<Matcher>;
 
+        /**
+         * 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: Matcher.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<Matcher.ConstructorProps>, ...args: any[]);
@@ -230,33 +269,21 @@ export namespace Bamf {
 
         // 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: 'active-application-changed',
-            callback: (_source: this, object: Application, p0: Application) => void,
+        connect<K extends keyof Matcher.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Matcher.SignalSignatures[K]>,
         ): number;
-        connect_after(
-            signal: 'active-application-changed',
-            callback: (_source: this, object: Application, p0: Application) => void,
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof Matcher.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Matcher.SignalSignatures[K]>,
         ): number;
-        emit(signal: 'active-application-changed', object: Application, p0: Application): void;
-        connect(signal: 'active-window-changed', callback: (_source: this, object: Window, p0: Window) => void): number;
-        connect_after(
-            signal: 'active-window-changed',
-            callback: (_source: this, object: Window, p0: Window) => void,
-        ): number;
-        emit(signal: 'active-window-changed', object: Window, p0: Window): void;
-        connect(signal: 'stacking-order-changed', callback: (_source: this) => void): number;
-        connect_after(signal: 'stacking-order-changed', callback: (_source: this) => void): number;
-        emit(signal: 'stacking-order-changed'): void;
-        connect(signal: 'view-closed', callback: (_source: this, object: View) => void): number;
-        connect_after(signal: 'view-closed', callback: (_source: this, object: View) => void): number;
-        emit(signal: 'view-closed', object: View): void;
-        connect(signal: 'view-opened', callback: (_source: this, object: View) => void): number;
-        connect_after(signal: 'view-opened', callback: (_source: this, object: View) => void): number;
-        emit(signal: 'view-opened', object: View): void;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof Matcher.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<Matcher.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
 
         // Static methods
 
@@ -343,6 +370,20 @@ export namespace Bamf {
     }
 
     namespace Tab {
+        // Signal signatures
+        interface SignalSignatures extends View.SignalSignatures {
+            'notify::desktop-id': (pspec: GObject.ParamSpec) => void;
+            'notify::is-foreground-tab': (pspec: GObject.ParamSpec) => void;
+            'notify::location': (pspec: GObject.ParamSpec) => void;
+            'notify::xid': (pspec: GObject.ParamSpec) => void;
+            'notify::active': (pspec: GObject.ParamSpec) => void;
+            'notify::path': (pspec: GObject.ParamSpec) => void;
+            'notify::running': (pspec: GObject.ParamSpec) => void;
+            'notify::starting': (pspec: GObject.ParamSpec) => void;
+            'notify::urgent': (pspec: GObject.ParamSpec) => void;
+            'notify::user-visible': (pspec: GObject.ParamSpec) => void;
+        }
+
         // Constructor properties interface
 
         interface ConstructorProps extends View.ConstructorProps {
@@ -367,12 +408,39 @@ export namespace Bamf {
         get location(): string;
         get xid(): 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: Tab.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<Tab.ConstructorProps>, ...args: any[]);
 
         _init(...args: any[]): void;
 
+        // Signals
+
+        connect<K extends keyof Tab.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Tab.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof Tab.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Tab.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof Tab.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<Tab.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
+
         // Virtual methods
 
         /**
@@ -414,50 +482,25 @@ export namespace Bamf {
     }
 
     namespace View {
-        // Signal callback interfaces
-
-        interface ActiveChanged {
-            (object: boolean): void;
-        }
-
-        interface ChildAdded {
-            (object: View): void;
-        }
-
-        interface ChildMoved {
-            (object: View): void;
-        }
-
-        interface ChildRemoved {
-            (object: View): void;
-        }
-
-        interface Closed {
-            (): void;
-        }
-
-        interface IconChanged {
-            (object: string): void;
-        }
-
-        interface NameChanged {
-            (object: string, p0: string): void;
-        }
-
-        interface RunningChanged {
-            (object: boolean): void;
-        }
-
-        interface StartingChanged {
-            (object: boolean): void;
-        }
-
-        interface UrgentChanged {
-            (object: boolean): void;
-        }
-
-        interface UserVisibleChanged {
-            (object: boolean): void;
+        // Signal signatures
+        interface SignalSignatures extends GObject.InitiallyUnowned.SignalSignatures {
+            'active-changed': (arg0: boolean) => void;
+            'child-added': (arg0: View) => void;
+            'child-moved': (arg0: View) => void;
+            'child-removed': (arg0: View) => void;
+            closed: () => void;
+            'icon-changed': (arg0: string) => void;
+            'name-changed': (arg0: string, arg1: string) => void;
+            'running-changed': (arg0: boolean) => void;
+            'starting-changed': (arg0: boolean) => void;
+            'urgent-changed': (arg0: boolean) => void;
+            'user-visible-changed': (arg0: boolean) => void;
+            'notify::active': (pspec: GObject.ParamSpec) => void;
+            'notify::path': (pspec: GObject.ParamSpec) => void;
+            'notify::running': (pspec: GObject.ParamSpec) => void;
+            'notify::starting': (pspec: GObject.ParamSpec) => void;
+            'notify::urgent': (pspec: GObject.ParamSpec) => void;
+            'notify::user-visible': (pspec: GObject.ParamSpec) => void;
         }
 
         // Constructor properties interface
@@ -486,6 +529,15 @@ export namespace Bamf {
         get user_visible(): boolean;
         get userVisible(): boolean;
 
+        /**
+         * 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: View.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<View.ConstructorProps>, ...args: any[]);
@@ -494,42 +546,21 @@ export namespace Bamf {
 
         // 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: 'active-changed', callback: (_source: this, object: boolean) => void): number;
-        connect_after(signal: 'active-changed', callback: (_source: this, object: boolean) => void): number;
-        emit(signal: 'active-changed', object: boolean): void;
-        connect(signal: 'child-added', callback: (_source: this, object: View) => void): number;
-        connect_after(signal: 'child-added', callback: (_source: this, object: View) => void): number;
-        emit(signal: 'child-added', object: View): void;
-        connect(signal: 'child-moved', callback: (_source: this, object: View) => void): number;
-        connect_after(signal: 'child-moved', callback: (_source: this, object: View) => void): number;
-        emit(signal: 'child-moved', object: View): void;
-        connect(signal: 'child-removed', callback: (_source: this, object: View) => void): number;
-        connect_after(signal: 'child-removed', callback: (_source: this, object: View) => void): number;
-        emit(signal: 'child-removed', object: View): void;
-        connect(signal: 'closed', callback: (_source: this) => void): number;
-        connect_after(signal: 'closed', callback: (_source: this) => void): number;
-        emit(signal: 'closed'): void;
-        connect(signal: 'icon-changed', callback: (_source: this, object: string) => void): number;
-        connect_after(signal: 'icon-changed', callback: (_source: this, object: string) => void): number;
-        emit(signal: 'icon-changed', object: string): void;
-        connect(signal: 'name-changed', callback: (_source: this, object: string, p0: string) => void): number;
-        connect_after(signal: 'name-changed', callback: (_source: this, object: string, p0: string) => void): number;
-        emit(signal: 'name-changed', object: string, p0: string): void;
-        connect(signal: 'running-changed', callback: (_source: this, object: boolean) => void): number;
-        connect_after(signal: 'running-changed', callback: (_source: this, object: boolean) => void): number;
-        emit(signal: 'running-changed', object: boolean): void;
-        connect(signal: 'starting-changed', callback: (_source: this, object: boolean) => void): number;
-        connect_after(signal: 'starting-changed', callback: (_source: this, object: boolean) => void): number;
-        emit(signal: 'starting-changed', object: boolean): void;
-        connect(signal: 'urgent-changed', callback: (_source: this, object: boolean) => void): number;
-        connect_after(signal: 'urgent-changed', callback: (_source: this, object: boolean) => void): number;
-        emit(signal: 'urgent-changed', object: boolean): void;
-        connect(signal: 'user-visible-changed', callback: (_source: this, object: boolean) => void): number;
-        connect_after(signal: 'user-visible-changed', callback: (_source: this, object: boolean) => void): number;
-        emit(signal: 'user-visible-changed', object: boolean): void;
+        connect<K extends keyof View.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, View.SignalSignatures[K]>,
+        ): number;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof View.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, View.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof View.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<View.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
 
         // Virtual methods
 
@@ -636,14 +667,16 @@ export namespace Bamf {
     }
 
     namespace Window {
-        // Signal callback interfaces
-
-        interface MaximizedChanged {
-            (object: number, p0: number): void;
-        }
-
-        interface MonitorChanged {
-            (object: number, p0: number): void;
+        // Signal signatures
+        interface SignalSignatures extends View.SignalSignatures {
+            'maximized-changed': (arg0: number, arg1: number) => void;
+            'monitor-changed': (arg0: number, arg1: number) => void;
+            'notify::active': (pspec: GObject.ParamSpec) => void;
+            'notify::path': (pspec: GObject.ParamSpec) => void;
+            'notify::running': (pspec: GObject.ParamSpec) => void;
+            'notify::starting': (pspec: GObject.ParamSpec) => void;
+            'notify::urgent': (pspec: GObject.ParamSpec) => void;
+            'notify::user-visible': (pspec: GObject.ParamSpec) => void;
         }
 
         // Constructor properties interface
@@ -654,6 +687,15 @@ export namespace Bamf {
     class Window extends View {
         static $gtype: GObject.GType<Window>;
 
+        /**
+         * 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: Window.SignalSignatures;
+
         // Constructors
 
         constructor(properties?: Partial<Window.ConstructorProps>, ...args: any[]);
@@ -662,28 +704,31 @@ export namespace Bamf {
 
         // 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: 'maximized-changed', callback: (_source: this, object: number, p0: number) => void): number;
-        connect_after(
-            signal: 'maximized-changed',
-            callback: (_source: this, object: number, p0: number) => void,
+        connect<K extends keyof Window.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Window.SignalSignatures[K]>,
         ): number;
-        emit(signal: 'maximized-changed', object: number, p0: number): void;
-        connect(signal: 'monitor-changed', callback: (_source: this, object: number, p0: number) => void): number;
-        connect_after(signal: 'monitor-changed', callback: (_source: this, object: number, p0: number) => void): number;
-        emit(signal: 'monitor-changed', object: number, p0: number): void;
+        connect(signal: string, callback: (...args: any[]) => any): number;
+        connect_after<K extends keyof Window.SignalSignatures>(
+            signal: K,
+            callback: GObject.SignalCallback<this, Window.SignalSignatures[K]>,
+        ): number;
+        connect_after(signal: string, callback: (...args: any[]) => any): number;
+        emit<K extends keyof Window.SignalSignatures>(
+            signal: K,
+            ...args: GObject.GjsParameters<Window.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never
+        ): void;
+        emit(signal: string, ...args: any[]): void;
 
         // Virtual methods
 
         vfunc_get_monitor(): number;
         vfunc_get_pid(): number;
-        vfunc_get_transient(): Window | null;
+        vfunc_get_transient(): Window;
         vfunc_get_utf8_prop(prop: string): string;
         vfunc_get_window_type(): WindowType;
         vfunc_get_xid(): number;
-        vfunc_last_active(): never;
+        vfunc_last_active(): number;
         vfunc_maximized(): WindowMaximizationType;
         vfunc_maximized_changed(old_value: number, new_value: number): void;
         vfunc_monitor_changed(old_value: number, new_value: number): void;
@@ -692,15 +737,23 @@ export namespace Bamf {
 
         get_monitor(): number;
         get_pid(): number;
-        get_transient(): Window | null;
+        get_transient(): Window;
         get_utf8_prop(prop: string): string;
         get_window_type(): WindowType;
         get_xid(): number;
-        last_active(): never;
+        last_active(): number;
         maximized(): WindowMaximizationType;
     }
 
     type ApplicationClass = typeof Application;
+    abstract class ApplicationPrivate {
+        static $gtype: GObject.GType<ApplicationPrivate>;
+
+        // Constructors
+
+        _init(...args: any[]): void;
+    }
+
     type ControlClass = typeof Control;
     abstract class ControlPrivate {
         static $gtype: GObject.GType<ControlPrivate>;
@@ -720,8 +773,32 @@ export namespace Bamf {
     }
 
     type TabClass = typeof Tab;
+    abstract class TabPrivate {
+        static $gtype: GObject.GType<TabPrivate>;
+
+        // Constructors
+
+        _init(...args: any[]): void;
+    }
+
     type ViewClass = typeof View;
+    abstract class ViewPrivate {
+        static $gtype: GObject.GType<ViewPrivate>;
+
+        // Constructors
+
+        _init(...args: any[]): void;
+    }
+
     type WindowClass = typeof Window;
+    abstract class WindowPrivate {
+        static $gtype: GObject.GType<WindowPrivate>;
+
+        // Constructors
+
+        _init(...args: any[]): void;
+    }
+
     /**
      * Name of the imported GIR library
      * `see` https://gitlab.gnome.org/GNOME/gjs/-/blob/master/gi/ns.cpp#L188

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@girs/bamf-3",
-  "version": "3.0.0-4.0.0-beta.21",
+  "version": "3.0.0-4.0.0-beta.24",
   "description": "GJS TypeScript type definitions for Bamf-3, generated from library version 3.0.0",
   "type": "module",
   "module": "bamf-3.js",
@@ -31,9 +31,9 @@
     "test": "tsc --project tsconfig.json"
   },
   "dependencies": {
-    "@girs/gjs": "^4.0.0-beta.21",
-    "@girs/glib-2.0": "^2.83.3-4.0.0-beta.21",
-    "@girs/gobject-2.0": "^2.83.3-4.0.0-beta.21"
+    "@girs/gjs": "^4.0.0-beta.24",
+    "@girs/glib-2.0": "^2.84.2-4.0.0-beta.24",
+    "@girs/gobject-2.0": "^2.84.2-4.0.0-beta.24"
   },
   "devDependencies": {
     "typescript": "*"