@ts-for-gir/lib 4.0.0-beta.37 → 4.0.0-beta.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-for-gir/lib",
-  "version": "4.0.0-beta.37",
+  "version": "4.0.0-beta.38",
   "description": "Typescript .d.ts generator from GIR for gjs",
   "main": "src/index.ts",
   "module": "src/index.ts",
@@ -48,9 +48,9 @@
     "typescript": "^5.9.2"
   },
   "dependencies": {
-    "@gi.ts/parser": "^4.0.0-beta.37",
-    "@ts-for-gir/reporter": "^4.0.0-beta.37",
-    "@ts-for-gir/templates": "^4.0.0-beta.37",
+    "@gi.ts/parser": "^4.0.0-beta.38",
+    "@ts-for-gir/reporter": "^4.0.0-beta.38",
+    "@ts-for-gir/templates": "^4.0.0-beta.38",
     "colorette": "^2.0.20",
     "ejs": "^3.1.10",
     "glob": "^11.0.3",

package/src/types/answer-version.ts

@@ -1,4 +1,4 @@
 export interface AnswerVersion {
-    selected: string[]
-    unselected: string[]
+	selected: string[];
+	unselected: string[];
 }

package/src/types/any-introspected-type.ts

@@ -1,3 +1,5 @@
 import type { IntrospectedBase } from "../gir/introspected-base.ts";
+import type { IntrospectedNamespace } from "../gir/namespace.ts";
 
-export type AnyIntrospectedType = IntrospectedBase<any>;
+// Recursive type representing any IntrospectedBase with a valid parent constraint
+export type AnyIntrospectedType = IntrospectedBase<IntrospectedNamespace | AnyIntrospectedType | null>;

package/src/types/class-function-types.ts

@@ -1,49 +1,57 @@
-import type { TypeExpression, Generic } from "../gir.ts";
+import type { IntrospectedEnum } from "../gir/enum.ts";
+import type { IntrospectedBaseClass, IntrospectedClassFunction } from "../gir/introspected-classes.ts";
 import type { IntrospectedFunctionParameter } from "../gir/parameter.ts";
+import type { Generic, TypeExpression } from "../gir.ts";
 import type { GirVisitor } from "../visitor.ts";
 
 export interface ClassFunctionCopyOptions<Parent> {
-  parent?: Parent;
-  name?: string;
-  interfaceParent?: any; // Using any to avoid circular deps
-  parameters?: IntrospectedFunctionParameter[];
-  outputParameters?: IntrospectedFunctionParameter[];
-  returnType?: TypeExpression;
+	parent?: Parent;
+	name?: string;
+	interfaceParent?: IntrospectedBaseClass | IntrospectedEnum; // avoid circular deps by importing types only
+	parameters?: IntrospectedFunctionParameter[];
+	outputParameters?: IntrospectedFunctionParameter[];
+	returnType?: TypeExpression;
 }
 
 export interface ClassFunctionOptions<Parent> {
-  name: string;
-  parameters?: IntrospectedFunctionParameter[];
-  output_parameters?: IntrospectedFunctionParameter[];
-  return_type?: TypeExpression;
-  parent: Parent;
-  originalParent?: Parent | null;
-  doc?: string | null;
+	name: string;
+	parameters?: IntrospectedFunctionParameter[];
+	output_parameters?: IntrospectedFunctionParameter[];
+	return_type?: TypeExpression;
+	parent: Parent;
+	originalParent?: Parent | null;
+	doc?: string | null;
 }
 
 // Type discriminators for function types
 export const FunctionTypeKind = {
-  CLASS_FUNCTION: 'CLASS_FUNCTION',
-  VIRTUAL_CLASS_FUNCTION: 'VIRTUAL_CLASS_FUNCTION',
-  STATIC_CLASS_FUNCTION: 'STATIC_CLASS_FUNCTION',
-  CONSTRUCTOR: 'CONSTRUCTOR'
+	CLASS_FUNCTION: "CLASS_FUNCTION",
+	VIRTUAL_CLASS_FUNCTION: "VIRTUAL_CLASS_FUNCTION",
+	STATIC_CLASS_FUNCTION: "STATIC_CLASS_FUNCTION",
+	CONSTRUCTOR: "CONSTRUCTOR",
 } as const;
 
-export type FunctionTypeKind = typeof FunctionTypeKind[keyof typeof FunctionTypeKind];
+export type FunctionTypeKind = (typeof FunctionTypeKind)[keyof typeof FunctionTypeKind];
 
 // Base interface for all class functions to enable type checking
 export interface ClassFunctionLike {
-  readonly __functionTypeKind: FunctionTypeKind;
-  readonly parameters: IntrospectedFunctionParameter[];
-  readonly output_parameters: IntrospectedFunctionParameter[];
-  readonly generics: Generic[];
-  returnTypeDoc?: string | null;
-  interfaceParent?: any;
-  
-  anyify(): any;
-  shouldAnyify(): boolean;
-  return(): TypeExpression;
-  getCallbackParameters(): any;
-  copy(options?: any): any;
-  accept(visitor: GirVisitor): any;
-} 
+	readonly __functionTypeKind: FunctionTypeKind;
+	readonly parameters: IntrospectedFunctionParameter[];
+	readonly output_parameters: IntrospectedFunctionParameter[];
+	readonly generics: Generic[];
+	returnTypeDoc?: string | null;
+	interfaceParent?: IntrospectedBaseClass | IntrospectedEnum | null;
+
+	anyify(): IntrospectedClassFunction;
+	shouldAnyify(): boolean;
+	return(): TypeExpression;
+	getCallbackParameters(): {
+		name: string;
+		parent: IntrospectedBaseClass | IntrospectedEnum;
+		output_parameters: IntrospectedFunctionParameter[];
+		parameters: IntrospectedFunctionParameter[];
+		return_type: TypeExpression;
+	};
+	copy(options?: ClassFunctionCopyOptions<IntrospectedBaseClass | IntrospectedEnum>): IntrospectedClassFunction;
+	accept(visitor: GirVisitor): IntrospectedClassFunction;
+}

package/src/types/class-parent.ts

@@ -1,14 +1,14 @@
-import type { GirClassElement, GirUnionElement, GirInterfaceElement, GirRecordElement, TypeGirClass } from './index.ts'
+import type { GirClassElement, GirInterfaceElement, GirRecordElement, GirUnionElement, TypeGirClass } from "./index.ts";
 
 export interface ClassParent {
-    parentName: string
-    qualifiedParentName: string
-    /** qualified if its module != qualifiedName's module */
-    localParentName: string
-    type: 'parent' | 'prerequisite' | 'implements'
-    /** Parent class / interface */
-    cls?: GirClassElement | GirUnionElement | GirInterfaceElement | GirRecordElement
-    girTypeName: TypeGirClass
-    /** True if the parent dependency exists */
-    dependencyExists: boolean
+	parentName: string;
+	qualifiedParentName: string;
+	/** qualified if its module != qualifiedName's module */
+	localParentName: string;
+	type: "parent" | "prerequisite" | "implements";
+	/** Parent class / interface */
+	cls?: GirClassElement | GirUnionElement | GirInterfaceElement | GirRecordElement;
+	girTypeName: TypeGirClass;
+	/** True if the parent dependency exists */
+	dependencyExists: boolean;
 }

package/src/types/class.ts

@@ -1,45 +1,43 @@
+import type { IntrospectedConstructor } from "../gir/constructor.ts";
 import type {
-    TypeIdentifier,
-} from "../gir.ts";
-import type {
-    IntrospectedClassFunction,
+	IntrospectedBaseClass,
+	IntrospectedClass,
+	IntrospectedClassCallback,
+	IntrospectedClassFunction,
+	IntrospectedInterface,
 } from "../gir/introspected-classes.ts";
-import type { IntrospectedConstructor } from "../gir/constructor.ts";
-import type { IntrospectedClassCallback } from "../gir/introspected-classes.ts";
-import type { IntrospectedProperty, IntrospectedField } from "../gir/property.ts";
-import type { IntrospectedBaseClass } from "../gir/introspected-classes.ts";
-import type { IntrospectedInterface } from "../gir/introspected-classes.ts";
-import type { IntrospectedClass } from "../gir/introspected-classes.ts";
+import type { IntrospectedField, IntrospectedProperty } from "../gir/property.ts";
 import type { IntrospectedRecord } from "../gir/record.ts";
+import type { TypeIdentifier } from "../gir.ts";
 
 export interface ClassDefinition {
-  superType: TypeIdentifier;
-  interfaces: TypeIdentifier[];
-  mainConstructor: IntrospectedConstructor;
-  constructors: IntrospectedConstructor[];
-  members: IntrospectedClassFunction[];
-  props: IntrospectedProperty[];
-  fields: IntrospectedField[];
-  callbacks: IntrospectedClassCallback[];
+	superType: TypeIdentifier;
+	interfaces: TypeIdentifier[];
+	mainConstructor: IntrospectedConstructor;
+	constructors: IntrospectedConstructor[];
+	members: IntrospectedClassFunction[];
+	props: IntrospectedProperty[];
+	fields: IntrospectedField[];
+	callbacks: IntrospectedClassCallback[];
 }
 
 export interface ResolutionNode {
-  identifier: TypeIdentifier;
-  node: IntrospectedBaseClass;
+	identifier: TypeIdentifier;
+	node: IntrospectedBaseClass;
 }
 
 export interface InterfaceResolution extends ResolutionNode, Iterable<InterfaceResolution | ClassResolution> {
-  extends(): InterfaceResolution | ClassResolution | undefined;
-  node: IntrospectedInterface;
+	extends(): InterfaceResolution | ClassResolution | undefined;
+	node: IntrospectedInterface;
 }
 
 export interface ClassResolution extends ResolutionNode, Iterable<ClassResolution> {
-  extends(): ClassResolution | undefined;
-  implements(): InterfaceResolution[];
-  node: IntrospectedClass;
+	extends(): ClassResolution | undefined;
+	implements(): InterfaceResolution[];
+	node: IntrospectedClass;
 }
 
 export interface RecordResolution extends ResolutionNode, Iterable<RecordResolution> {
-  extends(): RecordResolution | undefined;
-  node: IntrospectedRecord;
-}
+	extends(): RecordResolution | undefined;
+	node: IntrospectedRecord;
+}

package/src/types/config-flags.ts

@@ -1,5 +1,5 @@
-import type { UserConfig } from './user-config.ts'
+import type { UserConfig } from "./user-config.ts";
 
 export interface ConfigFlags extends UserConfig {
-    configName: string
+	configName: string;
 }

package/src/types/construct-name.ts

@@ -1,13 +1,13 @@
 export type ConstructName =
-    | 'functionName'
-    | 'enumMember'
-    | 'signalName'
-    | 'fieldName'
-    | 'constantName'
-    | 'constructorPropertyName'
-    | 'propertyName'
-    | 'parameterName'
-    | 'enumName'
-    | 'importNamespaceName'
-    | 'signalInterfaceName'
-    | 'importName'
+	| "functionName"
+	| "enumMember"
+	| "signalName"
+	| "fieldName"
+	| "constantName"
+	| "constructorPropertyName"
+	| "propertyName"
+	| "parameterName"
+	| "enumName"
+	| "importNamespaceName"
+	| "signalInterfaceName"
+	| "importName";

package/src/types/dependency-map.ts

@@ -1,4 +1,4 @@
-import type { Dependency } from './dependency.ts'
+import type { Dependency } from "./dependency.ts";
 export interface DependencyMap {
-    [packageName: string]: Dependency[]
+	[packageName: string]: Dependency[];
 }

package/src/types/dependency.ts

@@ -1,49 +1,49 @@
-import type { FileInfo } from './index.ts'
-import type { LibraryVersion } from '../library-version.ts'
-import type { GirXML } from '@gi.ts/parser'
+import type { GirXML } from "@gi.ts/parser";
+import type { LibraryVersion } from "../library-version.ts";
+import type { FileInfo } from "./index.ts";
 
 export interface Dependency extends FileInfo {
-    /**
-     * E.g. 'Gtk'
-     */
-    namespace: string
-    /**
-     * E.g. 'Gtk40'
-     * Is used in the generated index.d.ts, for example: `import * as Gtk40 from "./Gtk-4.0.ts";`
-     */
-    importNamespace: string
-    /**
-     * E.g. '4.0'
-     */
-    version: string
-    /**
-     * E.g. '4.14.0'
-     */
-    libraryVersion: LibraryVersion
-    /**
-     * E.g. 'Gtk-4.0'
-     */
-    packageName: string
-    /**
-     * The NPM package name
-     * E.g. 'gtk-4.0'
-     */
-    importName: string
-    /**
-     * Import path for the package
-     * E.g. './Gtk-4.0.ts' or '@girs/Gtk-4.0'
-     */
-    importPath: string
-    /**
-     * Import definition for the package
-     * E.g. `import type Gtk from '@girs/Gtk-3.0'`
-     */
-    importDef: string
-    /**
-     * Complete dependency string for package.json
-     * E.g. `"@girs/gtk-4.0": "workspace:^"`
-     */
-    packageJsonImport: string
+	/**
+	 * E.g. 'Gtk'
+	 */
+	namespace: string;
+	/**
+	 * E.g. 'Gtk40'
+	 * Is used in the generated index.d.ts, for example: `import * as Gtk40 from "./Gtk-4.0.ts";`
+	 */
+	importNamespace: string;
+	/**
+	 * E.g. '4.0'
+	 */
+	version: string;
+	/**
+	 * E.g. '4.14.0'
+	 */
+	libraryVersion: LibraryVersion;
+	/**
+	 * E.g. 'Gtk-4.0'
+	 */
+	packageName: string;
+	/**
+	 * The NPM package name
+	 * E.g. 'gtk-4.0'
+	 */
+	importName: string;
+	/**
+	 * Import path for the package
+	 * E.g. './Gtk-4.0.ts' or '@girs/Gtk-4.0'
+	 */
+	importPath: string;
+	/**
+	 * Import definition for the package
+	 * E.g. `import type Gtk from '@girs/Gtk-3.0'`
+	 */
+	importDef: string;
+	/**
+	 * Complete dependency string for package.json
+	 * E.g. `"@girs/gtk-4.0": "workspace:^"`
+	 */
+	packageJsonImport: string;
 
-    girXML: GirXML | null
+	girXML: GirXML | null;
 }

package/src/types/file-info.ts

@@ -1,14 +1,14 @@
 export interface FileInfo {
-    /**
-     * The path to the gir file or null if the file does not exist
-     */
-    path: string | null
-    /**
-     * The filename of the gir file
-     */
-    filename: string
-    /**
-     * Whether the file exists or not
-     */
-    exists: boolean
+	/**
+	 * The path to the gir file or null if the file does not exist
+	 */
+	path: string | null;
+	/**
+	 * The filename of the gir file
+	 */
+	filename: string;
+	/**
+	 * Whether the file exists or not
+	 */
+	exists: boolean;
 }

package/src/types/format.ts

@@ -1 +1 @@
-export type Format = 'dts' | 'json'
+export type Format = "dts" | "json";

package/src/types/generator-constructor.ts

@@ -1,7 +1,7 @@
+import type { FormatGenerator } from "../generators/generator.ts";
 import type { IntrospectedNamespace } from "../gir/namespace.ts";
 import type { OptionsGeneration } from "./options-generation.ts";
-import type { FormatGenerator } from "../generators/generator.ts";
 
-export type GeneratorConstructor<T> = {     
-  new (namespace: IntrospectedNamespace, options: OptionsGeneration, ...args: any[]): FormatGenerator<T>;
-};
+export type GeneratorConstructor<T> = {
+	new (namespace: IntrospectedNamespace, options: OptionsGeneration, ...args: unknown[]): FormatGenerator<T>;
+};

package/src/types/generics-config.ts

@@ -87,4 +87,4 @@ export interface GlibConfig {
 	version: string;
 	/** The modifier function to apply GLib-specific generics */
 	modifier: (namespace: IntrospectedNamespace) => void;
-} 
+}

package/src/types/gir-any-element.ts

@@ -1,35 +1,35 @@
 import type {
-    GirBitfieldElement,
-    GirCallbackElement,
-    GirClassElement,
-    GirConstantElement,
-    GirEnumElement,
-    GirFunctionElement,
-    GirInterfaceElement,
-    GirRecordElement,
-    GirUnionElement,
-    GirAliasElement,
-    GirMethodElement,
-    GirVirtualMethodElement,
-    GirSignalElement,
-    GirConstructorElement,
-    GirFieldElement,
-    GirPropertyElement,
-} from './index.ts'
+	GirAliasElement,
+	GirBitfieldElement,
+	GirCallbackElement,
+	GirClassElement,
+	GirConstantElement,
+	GirConstructorElement,
+	GirEnumElement,
+	GirFieldElement,
+	GirFunctionElement,
+	GirInterfaceElement,
+	GirMethodElement,
+	GirPropertyElement,
+	GirRecordElement,
+	GirSignalElement,
+	GirUnionElement,
+	GirVirtualMethodElement,
+} from "./index.ts";
 export type GirAnyElement =
-    | GirBitfieldElement
-    | GirCallbackElement
-    | GirClassElement
-    | GirConstantElement
-    | GirEnumElement
-    | GirFunctionElement
-    | GirInterfaceElement
-    | GirRecordElement
-    | GirUnionElement
-    | GirAliasElement
-    | GirMethodElement
-    | GirVirtualMethodElement
-    | GirSignalElement
-    | GirConstructorElement
-    | GirFieldElement
-    | GirPropertyElement
+	| GirBitfieldElement
+	| GirCallbackElement
+	| GirClassElement
+	| GirConstantElement
+	| GirEnumElement
+	| GirFunctionElement
+	| GirInterfaceElement
+	| GirRecordElement
+	| GirUnionElement
+	| GirAliasElement
+	| GirMethodElement
+	| GirVirtualMethodElement
+	| GirSignalElement
+	| GirConstructorElement
+	| GirFieldElement
+	| GirPropertyElement;

package/src/types/gir-module-interface.ts

@@ -7,16 +7,16 @@ import type { Dependency } from "./dependency.ts";
 export interface IGirModule {
 	/** Package name like 'Gtk-4.0' */
 	readonly packageName: string;
-	
+
 	/** Direct dependencies of this module */
 	readonly dependencies: Dependency[];
-	
+
 	/** All transitive dependencies of this module */
 	readonly transitiveDependencies: Dependency[];
-	
+
 	/** Initialize transitive dependencies */
 	initTransitiveDependencies(dependencies: Dependency[]): Promise<void>;
-	
+
 	/** Parse the module contents */
 	parse(): void;
-} 
+}

package/src/types/gir-module-resolved.ts

@@ -29,4 +29,4 @@ export interface GirModulesGrouped {
  */
 export interface GirModulesGroupedMap {
 	[namespace: string]: GirModulesGrouped;
-} 
+}

package/src/types/gir-type-name.ts

@@ -1,20 +1,20 @@
 import type {
-    TypeGirFunction,
-    TypeGirElement,
-    TypeGirEnumerationMember,
-    TypeGirProperty,
-    TypeGirClass,
-    TypeGirAlias,
-    TypeGirVariable,
-} from './index.ts'
+	TypeGirAlias,
+	TypeGirClass,
+	TypeGirElement,
+	TypeGirEnumerationMember,
+	TypeGirFunction,
+	TypeGirProperty,
+	TypeGirVariable,
+} from "./index.ts";
 
 export type GirTypeName =
-    | TypeGirFunction
-    | TypeGirElement
-    | TypeGirEnumerationMember
-    | TypeGirProperty
-    | TypeGirClass
-    | TypeGirAlias
-    | TypeGirVariable
-    | 'callable-param'
-    | 'callable-return'
+	| TypeGirFunction
+	| TypeGirElement
+	| TypeGirEnumerationMember
+	| TypeGirProperty
+	| TypeGirClass
+	| TypeGirAlias
+	| TypeGirVariable
+	| "callable-param"
+	| "callable-return";