typescript-to-gdscript 0.1.0

package/dist/typings/godot-registry.d.ts

@@ -0,0 +1,123 @@
+export { gdDocToPlain, parseClassXml, parseAllClassXmls } from './xml-parser.ts';
+export type { GodotClassXml, GodotMethodXml, GodotParamXml, GodotPropertyXml, GodotSignalXml, GodotConstantXml, GodotAnnotationXml, GodotOperatorXml, } from './xml-parser.ts';
+export { generateRegistryData, parseGodotVersion } from './registry-generator.ts';
+export type { GodotVersion } from './registry-generator.ts';
+export interface GodotSignalParamInfo {
+    name: string;
+    /** Godot type name (e.g. "RID", "Area2D", "int") */
+    type: string;
+}
+export interface GodotSignalInfo {
+    name: string;
+    parameters: GodotSignalParamInfo[];
+}
+export interface GodotClassInfo {
+    name: string;
+    inherits: string | null;
+    description?: string;
+    methods: string[];
+    properties: string[];
+    signals: GodotSignalInfo[];
+    constants: string[];
+    enums: GodotEnumInfo[];
+    /**
+     * List of variant types that can be converted to this class via `gd.as(value, ClassName)`.
+     * Computed from single-parameter "from" constructors.
+     * Example: Vector2 has variantConverts = ["Vector2", "Vector2i"]
+     */
+    variantConverts?: string[];
+}
+export interface GodotEnumInfo {
+    name: string;
+    values: Array<{
+        name: string;
+        value: string;
+    }>;
+}
+export interface GodotRegistryData {
+    version: string;
+    classes: Record<string, GodotClassInfo>;
+    globalFunctions: string[];
+    globalConstants: string[];
+    globalEnums: GodotEnumInfo[];
+    /** Constructors like Vector2, Color etc */
+    constructors: string[];
+    /** Global singleton instances from @GlobalScope (e.g. Engine, Input, ProjectSettings) */
+    singletons: Array<{
+        name: string;
+        type: string;
+    }>;
+    /** GDScript annotations that take no parameters (bare decorators in TS) */
+    bareAnnotations: string[];
+    /** Classes that have operator overloads (need gd.ops.* wrappers in TS) */
+    operatorTypes: string[];
+}
+export declare class GodotClassRegistry {
+    private data;
+    private allMembersCache;
+    private globalFunctionsSet;
+    private constructorsSet;
+    private singletonsSet;
+    private bareAnnotationsSet;
+    private operatorTypesSet;
+    private globalEnumNamesSet;
+    constructor(data: GodotRegistryData);
+    static fromJsonFile(jsonPath: string): GodotClassRegistry;
+    static fromJson(json: string): GodotClassRegistry;
+    /**
+     * Get all member names (own + inherited) for a class.
+     * Includes methods, properties, signals, and constants.
+     */
+    getAllMembers(className: string): Set<string>;
+    /** Check if a function name is a global/builtin function */
+    isGlobalFunction(name: string): boolean;
+    /** Check if a name is a constructor type (Vector2, Color, etc) */
+    isConstructor(name: string): boolean;
+    /**
+     * Check if a source type can be converted to a target type via `gd.as(value, Target)`.
+     * Returns true when the target class has the source type in its `variantConverts` list.
+     */
+    canVariantConvert(source: string, target: string): boolean;
+    /** Get the list of types that can be converted to a given target class. */
+    getVariantConverts(target: string): string[];
+    /** Check if a name is a global singleton instance (Engine, Input, ProjectSettings, etc.) */
+    isSingleton(name: string): boolean;
+    /** Check if a name should not get `this.` prefix (global function, constructor, or singleton) */
+    isGlobal(name: string): boolean;
+    /** Check if an annotation takes no parameters (bare decorator in TS, no `()` needed) */
+    isBareAnnotation(name: string): boolean;
+    /** Check if a class has operator overloads (needs gd.ops.* wrappers) */
+    hasOperators(name: string): boolean;
+    /** Check if a name is a Godot global enum type (e.g. Key, MouseButton). */
+    isGlobalEnum(name: string): boolean;
+    /** Get the inheritance chain for a class (including itself) */
+    getInheritanceChain(className: string): string[];
+    /** Check if className extends (directly or indirectly) parentName */
+    isSubclassOf(className: string, parentName: string): boolean;
+    /** Check if a class exists in the registry */
+    hasClass(className: string): boolean;
+    /** Get class info */
+    getClass(className: string): GodotClassInfo | undefined;
+    /**
+     * Get signal parameters for a signal on a class (walks inheritance chain).
+     * Returns null if the signal is not found on the class or any ancestor.
+     */
+    getSignalParams(className: string, signalName: string): GodotSignalParamInfo[] | null;
+    /** Get registry data (for serialization) */
+    getData(): GodotRegistryData;
+}
+export interface GenerateRegistryOptions {
+    /**
+     * Path(s) to Godot docs XML class reference directories. Accepts a
+     * single dir (legacy) or an array; later dirs override earlier ones
+     * for same-named classes. See {@link parseAllClassXmls} for details.
+     */
+    classDocsDir: string | string[];
+    outputPath: string;
+    version?: string;
+}
+/**
+ * Generates the Godot class registry JSON from XML class docs.
+ */
+export declare function generateGodotRegistry(options: GenerateRegistryOptions): GodotClassRegistry;
+//# sourceMappingURL=godot-registry.d.ts.map

package/dist/typings/godot-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"godot-registry.d.ts","sourceRoot":"","sources":["../../src/typings/godot-registry.ts"],"names":[],"mappings":"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"}

package/dist/typings/godot-registry.js

@@ -0,0 +1,157 @@
+import { readFileSync, writeFileSync } from 'fs';
+import { parseAllClassXmls } from "./xml-parser.js";
+import { generateRegistryData } from "./registry-generator.js";
+// Re-export everything that external consumers need from the sub-modules
+export { gdDocToPlain, parseClassXml, parseAllClassXmls } from "./xml-parser.js";
+export { generateRegistryData, parseGodotVersion } from "./registry-generator.js";
+// ─── Registry Class (runtime) ─────────────────────────────────
+export class GodotClassRegistry {
+    data;
+    allMembersCache = new Map();
+    globalFunctionsSet;
+    constructorsSet;
+    singletonsSet;
+    bareAnnotationsSet;
+    operatorTypesSet;
+    globalEnumNamesSet;
+    constructor(data) {
+        this.data = data;
+        this.globalFunctionsSet = new Set(data.globalFunctions);
+        this.constructorsSet = new Set(data.constructors);
+        this.singletonsSet = new Set((data.singletons ?? []).map((s) => s.name));
+        this.bareAnnotationsSet = new Set(data.bareAnnotations ?? []);
+        this.operatorTypesSet = new Set(data.operatorTypes ?? []);
+        this.globalEnumNamesSet = new Set((data.globalEnums ?? []).map((e) => e.name));
+    }
+    static fromJsonFile(jsonPath) {
+        const data = JSON.parse(readFileSync(jsonPath, 'utf-8'));
+        return new GodotClassRegistry(data);
+    }
+    static fromJson(json) {
+        return new GodotClassRegistry(JSON.parse(json));
+    }
+    /**
+     * Get all member names (own + inherited) for a class.
+     * Includes methods, properties, signals, and constants.
+     */
+    getAllMembers(className) {
+        const cached = this.allMembersCache.get(className);
+        if (cached)
+            return cached;
+        const members = new Set();
+        const chain = this.getInheritanceChain(className);
+        for (const cn of chain) {
+            const cls = this.data.classes[cn];
+            if (!cls)
+                continue;
+            for (const m of cls.methods)
+                members.add(m);
+            for (const p of cls.properties)
+                members.add(p);
+            for (const s of cls.signals)
+                members.add(s.name);
+            for (const c of cls.constants)
+                members.add(c);
+        }
+        this.allMembersCache.set(className, members);
+        return members;
+    }
+    /** Check if a function name is a global/builtin function */
+    isGlobalFunction(name) {
+        return this.globalFunctionsSet.has(name);
+    }
+    /** Check if a name is a constructor type (Vector2, Color, etc) */
+    isConstructor(name) {
+        return this.constructorsSet.has(name);
+    }
+    /**
+     * Check if a source type can be converted to a target type via `gd.as(value, Target)`.
+     * Returns true when the target class has the source type in its `variantConverts` list.
+     */
+    canVariantConvert(source, target) {
+        const targetCls = this.data.classes[target];
+        if (!targetCls?.variantConverts)
+            return false;
+        return targetCls.variantConverts.includes(source);
+    }
+    /** Get the list of types that can be converted to a given target class. */
+    getVariantConverts(target) {
+        return this.data.classes[target]?.variantConverts ?? [];
+    }
+    /** Check if a name is a global singleton instance (Engine, Input, ProjectSettings, etc.) */
+    isSingleton(name) {
+        return this.singletonsSet.has(name);
+    }
+    /** Check if a name should not get `this.` prefix (global function, constructor, or singleton) */
+    isGlobal(name) {
+        return this.globalFunctionsSet.has(name) || this.constructorsSet.has(name) || this.singletonsSet.has(name);
+    }
+    /** Check if an annotation takes no parameters (bare decorator in TS, no `()` needed) */
+    isBareAnnotation(name) {
+        return this.bareAnnotationsSet.has(name);
+    }
+    /** Check if a class has operator overloads (needs gd.ops.* wrappers) */
+    hasOperators(name) {
+        return this.operatorTypesSet.has(name);
+    }
+    /** Check if a name is a Godot global enum type (e.g. Key, MouseButton). */
+    isGlobalEnum(name) {
+        return this.globalEnumNamesSet.has(name);
+    }
+    /** Get the inheritance chain for a class (including itself) */
+    getInheritanceChain(className) {
+        const chain = [];
+        let current = className;
+        const visited = new Set();
+        while (current && !visited.has(current)) {
+            visited.add(current);
+            chain.push(current);
+            const cls = this.data.classes[current];
+            current = cls?.inherits ?? null;
+        }
+        return chain;
+    }
+    /** Check if className extends (directly or indirectly) parentName */
+    isSubclassOf(className, parentName) {
+        return this.getInheritanceChain(className).includes(parentName);
+    }
+    /** Check if a class exists in the registry */
+    hasClass(className) {
+        return className in this.data.classes;
+    }
+    /** Get class info */
+    getClass(className) {
+        return this.data.classes[className];
+    }
+    /**
+     * Get signal parameters for a signal on a class (walks inheritance chain).
+     * Returns null if the signal is not found on the class or any ancestor.
+     */
+    getSignalParams(className, signalName) {
+        const chain = this.getInheritanceChain(className);
+        for (const cn of chain) {
+            const cls = this.data.classes[cn];
+            if (!cls)
+                continue;
+            const sig = cls.signals.find((s) => s.name === signalName);
+            if (sig)
+                return sig.parameters;
+        }
+        return null;
+    }
+    /** Get registry data (for serialization) */
+    getData() {
+        return this.data;
+    }
+}
+/**
+ * Generates the Godot class registry JSON from XML class docs.
+ */
+export function generateGodotRegistry(options) {
+    const classes = parseAllClassXmls(options.classDocsDir);
+    const data = generateRegistryData(classes);
+    data.version = options.version ?? '';
+    writeFileSync(options.outputPath, JSON.stringify(data, null, 2));
+    return new GodotClassRegistry(data);
+}
+//# sourceMappingURL=godot-registry.js.map

package/dist/typings/godot-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"godot-registry.js","sourceRoot":"","sources":["../../src/typings/godot-registry.ts"],"names":[],"mappings":"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"}

package/dist/typings/index.d.ts

@@ -0,0 +1,4 @@
+export { generateTypings, parseAutoloads, resolveSignalHandlers, collectAllSignalHandlers, type GenerateTypingsOptions, type SignalHandlerInfo, type ScriptClassInfo, type AutoloadEntry, } from './scenes.ts';
+export { generateGodotDocsTypings, type GodotDocsTypingsOptions, } from './godot-docs.ts';
+export { GodotClassRegistry, generateGodotRegistry, parseAllClassXmls, generateRegistryData, type GodotRegistryData, type GodotClassInfo, type GodotEnumInfo, type GodotSignalInfo, type GodotSignalParamInfo, type GenerateRegistryOptions, parseGodotVersion, type GodotVersion, type GodotClassXml, type GodotMethodXml, type GodotPropertyXml, type GodotSignalXml, type GodotParamXml, } from './godot-registry.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/typings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/typings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/typings/index.js

@@ -0,0 +1,4 @@
+export { generateTypings, parseAutoloads, resolveSignalHandlers, collectAllSignalHandlers, } from "./scenes.js";
+export { generateGodotDocsTypings, } from "./godot-docs.js";
+export { GodotClassRegistry, generateGodotRegistry, parseAllClassXmls, generateRegistryData, parseGodotVersion, } from "./godot-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/typings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GAKzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,GAEzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EAOpB,iBAAiB,GAOlB,MAAM,qBAAqB,CAAC"}

package/dist/typings/override-system.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Parsed override: a class/interface declaration with individual members.
+ */
+export interface ParsedOverride {
+    /** The full declaration header, e.g. "interface Array<T>" or "declare class Node extends GodotObject" */
+    header: string | undefined;
+    /** Member name → full source text (one or more lines). Order preserved. */
+    members: Map<string, string>;
+    /** Extra lines (index signatures, comments) that don't have a named member */
+    extras: string[];
+}
+/**
+ * Loads all override .d.ts files from multiple directories and merges them.
+ * Later directories override earlier ones (user overrides win over defaults).
+ * Returns a map: TS declaration name → ParsedOverride.
+ */
+export declare function loadOverrides(overrideDirs: string[]): Map<string, ParsedOverride>;
+/**
+ * Loads global function overrides from `_globals.d.ts` across multiple directories.
+ * Later directories override earlier ones.
+ * Returns a map: function name → full declaration text (JSDoc + all overloads).
+ */
+export declare function loadGlobalOverrides(overrideDirs: string[]): Map<string, string>;
+/**
+ * Applies global function overrides to generated `_globals.d.ts` content.
+ * For each overridden function, replaces the generated declaration (and its JSDoc)
+ * with the override text.
+ */
+export declare function applyGlobalOverrides(content: string, globalOverrides: Map<string, string>): string;
+/**
+ * Applies override to a generated declaration string.
+ * Replaces the header and merges members: overridden members replace generated ones,
+ * new members from the override are appended.
+ */
+export declare function applyOverride(generated: string, override: ParsedOverride): string;
+//# sourceMappingURL=override-system.d.ts.map

package/dist/typings/override-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-system.d.ts","sourceRoot":"","sources":["../../src/typings/override-system.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yGAAyG;IACzG,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAQjF;AAgHD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ/E;AAwED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CA8CR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAuHjF"}