@girs/gobject-2.0 2.84.2-4.0.0-beta.25 → 2.84.4-4.0.0-beta.26

package/README.md

@@ -5,8 +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.84.2 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.25.
-
+GJS TypeScript type definitions for GObject-2.0, generated from library version 2.84.4 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.0.0-beta.26.
 
 ## Install
 

package/gobject-2.0.d.ts

@@ -47,6 +47,79 @@ export namespace GObject {
         Requires?: Object[];
     }
 
+    export type Property<K extends ParamSpec> = K extends ParamSpec<infer T> ? T : any;
+
+    // Advanced type inference for GObject class registration
+    // String conversion utilities for property names
+    type SnakeToUnderscoreCase<S extends string> = S extends `${infer T}-${infer U}`
+        ? `${T}_${SnakeToUnderscoreCase<U>}`
+        : S extends `${infer T}`
+          ? `${T}`
+          : never;
+
+    type SnakeToCamelCase<S extends string> = S extends `${infer T}-${infer U}`
+        ? `${Lowercase<T>}${SnakeToPascalCase<U>}`
+        : S extends `${infer T}`
+          ? `${Lowercase<T>}`
+          : SnakeToPascalCase<S>;
+
+    type SnakeToPascalCase<S extends string> = string extends S
+        ? string
+        : S extends `${infer T}-${infer U}`
+          ? `${Capitalize<Lowercase<T>>}${SnakeToPascalCase<U>}`
+          : S extends `${infer T}`
+            ? `${Capitalize<Lowercase<T>>}`
+            : never;
+
+    type SnakeToCamel<T> = { [P in keyof T as P extends string ? SnakeToCamelCase<P> : P]: T[P] };
+    type SnakeToUnderscore<T> = { [P in keyof T as P extends string ? SnakeToUnderscoreCase<P> : P]: T[P] };
+
+    // Advanced utility types for class registration
+    type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends (x: infer R) => any ? R : never;
+
+    type IFaces<Interfaces extends { $gtype: GType<any> }[]> = {
+        [key in keyof Interfaces]: Interfaces[key] extends { $gtype: GType<infer I> } ? I : never;
+    };
+
+    export type Properties<Prototype extends {}, Properties extends { [key: string]: ParamSpec }> = Omit<
+        {
+            [key in keyof Properties | keyof Prototype]: key extends keyof Prototype
+                ? never
+                : key extends keyof Properties
+                  ? Property<Properties[key]>
+                  : never;
+        },
+        keyof Prototype
+    >;
+
+    export type RegisteredPrototype<
+        P extends {},
+        Props extends { [key: string]: ParamSpec },
+        Interfaces extends any[],
+    > = Properties<P, SnakeToCamel<Props> & SnakeToUnderscore<Props>> & UnionToIntersection<Interfaces[number]> & P;
+
+    type Ctor = new (...a: any[]) => object;
+    type Init = { _init(...args: any[]): void };
+
+    export type RegisteredClass<
+        T extends Ctor,
+        Props extends { [key: string]: ParamSpec },
+        Interfaces extends { $gtype: GType<any> }[],
+    > = T extends { prototype: infer P extends {} }
+        ? {
+              $gtype: GType<RegisteredClass<T, Props, IFaces<Interfaces>>>;
+              new (
+                  ...args: P extends Init ? Parameters<P['_init']> : [void]
+              ): RegisteredPrototype<P, Props, IFaces<Interfaces>>;
+              prototype: RegisteredPrototype<P, Props, IFaces<Interfaces>>;
+          }
+        : never;
+
+    export type SignalDefinitionType = {
+        param_types?: readonly GType[];
+        [key: string]: any;
+    };
+
     // Correctly types interface checks.
     export function type_is_a<T extends Object>(obj: Object, is_a_type: { $gtype: GType<T> }): obj is T;
 
@@ -105,6 +178,7 @@ export namespace GObject {
     export let TYPE_UINT: GType<number>;
     export let TYPE_INT64: GType<number>;
     export let TYPE_UINT64: GType<number>;
+    export let TYPE_FLOAT: GType<number>;
 
     // fake enum for signal accumulators, keep in sync with gi/object.c
     export enum AccumulatorType {
@@ -231,8 +305,6 @@ export namespace GObject {
     export function signal_handlers_disconnect_by_func(instance: Object, func: (...args: any[]) => any): number;
     export function signal_handlers_disconnect_by_data(): void;
 
-    export type Property<K extends ParamSpec> = K extends ParamSpec<infer T> ? T : any;
-
     // Helper types for type-safe signal handling
     export interface SignalSignatures {
         /** Fallback for dynamic signals and type compatibility */
@@ -251,6 +323,9 @@ export namespace GObject {
 
     type ObjectConstructor = { new (...args: any[]): Object };
 
+    // Standard registerClass overloads
+    export function registerClass<T extends ObjectConstructor>(cls: T): T;
+
     export function registerClass<
         T extends ObjectConstructor,
         Props extends { [key: string]: ParamSpec },
@@ -263,7 +338,36 @@ export namespace GObject {
         },
     >(options: MetaInfo<Props, Interfaces, Sigs>, cls: T): T;
 
-    export function registerClass<T extends ObjectConstructor>(cls: T): T;
+    // Enhanced registerClass overloads with advanced type inference
+
+    export function registerClass<P extends {}, T extends new (...args: any[]) => P>(
+        klass: T,
+    ): RegisteredClass<T, {}, []>;
+
+    export function registerClass<
+        T extends Ctor,
+        Props extends { [key: string]: ParamSpec },
+        Interfaces extends { $gtype: GType }[],
+        Sigs extends {
+            [key: string]: {
+                param_types?: readonly GType[];
+                [key: string]: any;
+            };
+        },
+    >(
+        options: {
+            GTypeName?: string;
+            GTypeFlags?: TypeFlags;
+            Properties?: Props;
+            Signals?: Sigs;
+            Implements?: Interfaces;
+            CssName?: string;
+            Template?: string;
+            Children?: string[];
+            InternalChildren?: string[];
+        },
+        klass: T,
+    ): RegisteredClass<T, Props, Interfaces>;
 
     /**
      * GObject-2.0
@@ -4044,12 +4148,12 @@ export namespace GObject {
         /**
          * Creates a new GParamSpecChar instance specifying a G_TYPE_CHAR property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static ['char'](
             name: string,
@@ -4058,17 +4162,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecUChar instance specifying a G_TYPE_UCHAR property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static uchar(
             name: string,
@@ -4077,17 +4181,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecInt instance specifying a G_TYPE_INT property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static int(
             name: string,
@@ -4096,17 +4200,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecUInt instance specifying a G_TYPE_UINT property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static uint(
             name: string,
@@ -4115,17 +4219,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecLong instance specifying a G_TYPE_LONG property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static long(
             name: string,
@@ -4134,17 +4238,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecULong instance specifying a G_TYPE_ULONG property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static ulong(
             name: string,
@@ -4153,17 +4257,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecInt64 instance specifying a G_TYPE_INT64 property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static int64(
             name: string,
@@ -4172,17 +4276,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecUInt64 instance specifying a G_TYPE_UINT64 property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static uint64(
             name: string,
@@ -4191,17 +4295,17 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecFloat instance specifying a G_TYPE_FLOAT property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static float(
             name: string,
@@ -4210,31 +4314,31 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecBoolean instance specifying a G_TYPE_BOOLEAN property. In many cases, it may be more appropriate to use an enum with g_param_spec_enum(), both to improve code clarity by using explicitly named values, and to allow for more values to be added in future without breaking API.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static ['boolean'](
             name: string,
             nick: string | null,
             blurb: string | null,
             flags: ParamFlags | number,
-            defaultValue: boolean,
+            defaultValue?: boolean,
         ): ParamSpec<boolean>;
         /**
          * Creates a new GParamSpecEnum instance specifying a G_TYPE_ENUM property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 enumType
-         * @param defaultValue The default value for this property
+         * @param enumType The GType for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static ['enum']<T>(
             name: string,
@@ -4242,17 +4346,17 @@ export namespace GObject {
             blurb: string | null,
             flags: ParamFlags | number,
             enumType: GType<T> | { $gtype: GType<T> },
-            defaultValue: any,
+            defaultValue?: any,
         ): ParamSpec<T>;
         /**
          * Creates a new GParamSpecDouble instance specifying a G_TYPE_DOUBLE property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 minimum The minimum value for this property
          * @param maximum The maximum value for this property
-         * @param defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional)
          */
         static double(
             name: string,
@@ -4261,30 +4365,30 @@ export namespace GObject {
             flags: ParamFlags | number,
             minimum: number,
             maximum: number,
-            defaultValue: number,
+            defaultValue?: number,
         ): ParamSpec<number>;
         /**
          * Creates a new GParamSpecString instance specifying a G_TYPE_STRING property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 defaultValue The default value for this property
+         * @param defaultValue The default value for this property (optional, defaults to null if not provided)
          */
         static string(
             name: string,
             nick: string | null,
             blurb: string | null,
             flags: ParamFlags | number,
-            defaultValue: string,
+            defaultValue?: string | null,
         ): ParamSpec<string>;
         /**
          * Creates a new GParamSpecBoxed instance specifying a G_TYPE_BOXED derived property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 boxedType
+         * @param boxedType The GType for this property
          */
         static boxed<T>(
             name: string,
@@ -4299,22 +4403,22 @@ export namespace GObject {
          * @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
+         * @param objectType The GType of the object (optional)
          */
         static object<T>(
             name: string,
             nick: string | null,
             blurb: string | null,
             flags: ParamFlags | number,
-            objectType: GType<T> | { $gtype: GType<T> },
+            objectType?: GType<T> | { $gtype: GType<T> },
         ): ParamSpec<T>;
         /**
          * Creates a new GParamSpecParam instance specifying a G_TYPE_PARAM property.
          * @param name The name of the property
-         * @param nick A human readable name for the property
-         * @param blurb A longer description 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 paramType
+         * @param paramType The GType for this property
          */
         static param(
             name: string,
@@ -4458,6 +4562,7 @@ export namespace GObject {
          * @param oclass The object class or type that contains the property to override
          */
         override(name: string, oclass: Object | Function | GType): void;
+        __type__(arg: never): A;
     }
 
     namespace SignalGroup {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@girs/gobject-2.0",
-  "version": "2.84.2-4.0.0-beta.25",
-  "description": "GJS TypeScript type definitions for GObject-2.0, generated from library version 2.84.2",
+  "version": "2.84.4-4.0.0-beta.26",
+  "description": "GJS TypeScript type definitions for GObject-2.0, generated from library version 2.84.4",
   "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.25",
-    "@girs/glib-2.0": "^2.84.2-4.0.0-beta.25"
+    "@girs/gjs": "^4.0.0-beta.26",
+    "@girs/glib-2.0": "^2.84.4-4.0.0-beta.26"
   },
   "devDependencies": {
     "typescript": "*"