typescript-to-gdscript 0.1.0

package/dist/typings/type-mapping.js

@@ -0,0 +1,239 @@
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+/** Construct an empty context (used during early bootstrap before all fields are populated). */
+export function emptyTypeContext() {
+    return {
+        knownClasses: new Set(),
+        valueTypes: new Set(),
+        nonNullableMembers: new Map(),
+        variantParamConverts: new Map(),
+    };
+}
+// ─── Constants ───────────────────────────────────────────────────
+/** TS primitive types — widening between two primitives is excluded (too noisy). */
+export const TS_PRIMITIVE_TYPES = new Set(['int', 'float', 'boolean', 'string', 'void', 'unknown']);
+/** TS type names that are always non-nullable (primitives, void, unknown). */
+export const NON_NULLABLE_TS_TYPES = new Set([
+    'int', 'float', 'boolean', 'string', 'void', 'unknown', 'Dictionary',
+]);
+/** Names that conflict with TS/JS built-in globals and need prefixing */
+export const CLASS_NAME_CONFLICTS = new Map([
+    ['Object', 'GodotObject'],
+]);
+/**
+ * GDScript classes emitted as TS interfaces (replacing standard TS built-in types).
+ * Maps GD class name → TS interface name. These are generated from Godot docs
+ * instead of being hardcoded in globals.d.ts.
+ */
+export const INTERFACE_CLASSES = new Map([
+    ['Dictionary', 'Object'],
+    ['Array', 'Array'],
+    ['String', 'String'],
+    ['Callable', 'Function'],
+]);
+export function sanitizeClassName(name) {
+    return CLASS_NAME_CONFLICTS.get(name) ?? name;
+}
+// ─── Type mapping functions ──────────────────────────────────────
+/**
+ * Maps a Godot type string to a TypeScript type string.
+ */
+export function godotTypeToTs(type, ctx) {
+    // Strip C++ pointer/reference markers (handle "type*", "type **", "const type*")
+    const cleaned = type
+        .replace(/[\s*]*\*+\s*$/, '')
+        .replace(/^const\s+/, '')
+        .trim();
+    // Typed array suffix notation: "Node[]" → Array<Node>
+    if (cleaned.endsWith('[]')) {
+        const inner = cleaned.slice(0, -2);
+        return `Array<${godotTypeToTs(inner, ctx)}>`;
+    }
+    switch (cleaned) {
+        case 'int':
+            return 'int';
+        case 'float':
+            return 'float';
+        case 'bool':
+            return 'boolean';
+        case 'String':
+            return 'string';
+        case 'void':
+            return 'void';
+        case 'Nil':
+            return 'void';
+        case 'Variant':
+            return 'unknown';
+        case 'Array':
+            return 'Array<unknown>';
+        case 'Dictionary':
+            return 'Dictionary';
+        case 'StringName':
+            return 'string';
+        case 'Object':
+            return 'GodotObject';
+        case '':
+            return 'void';
+        // C++ internal types that leak from Godot docs
+        case 'uint8_t':
+            return 'int';
+        case 'int32_t':
+            return 'int';
+        case 'int64_t':
+            return 'int';
+        case 'uint32_t':
+            return 'int';
+        case 'uint64_t':
+            return 'int';
+        case 'AudioFrame':
+            return 'unknown';
+        default:
+            // Typed arrays like Array[Node]
+            if (cleaned.startsWith('Array[')) {
+                const inner = cleaned.slice(6, -1);
+                return `Array<${godotTypeToTs(inner, ctx)}>`;
+            }
+            // Dictionary[K, V]
+            if (cleaned.startsWith('Dictionary[')) {
+                return 'Dictionary';
+            }
+            // Enum references like Node.ProcessMode
+            if (cleaned.includes('.')) {
+                return cleaned.replace('.', '_');
+            }
+            // Apply class name sanitization
+            const sanitized = CLASS_NAME_CONFLICTS.get(cleaned);
+            if (sanitized)
+                return sanitized;
+            // Unknown types not in Godot class list → unknown
+            if (ctx.knownClasses.size > 0 && !ctx.knownClasses.has(cleaned)) {
+                return 'unknown';
+            }
+            return cleaned;
+    }
+}
+/**
+ * Returns true when a Godot type should be made nullable (`T | null`) in
+ * generated declarations.  Reference types (Node, Resource, Material, etc.)
+ * are nullable; value/variant types, primitives, enums and arrays are not.
+ */
+export function isNullableGodotType(gdType, ctx) {
+    const cleaned = gdType
+        .replace(/[\s*]*\*+\s*$/, '')
+        .replace(/^const\s+/, '')
+        .trim();
+    // Empty / void / Nil / Variant
+    if (cleaned === '' || cleaned === 'Nil' || cleaned === 'Variant')
+        return false;
+    // Derived value types (Vector2, Color, Packed*Array, etc.)
+    if (ctx.valueTypes.has(cleaned))
+        return false;
+    // Interface classes (Array, Dictionary, String, Callable)
+    if (INTERFACE_CLASSES.has(cleaned))
+        return false;
+    // Typed arrays / dictionaries — the container is never null
+    if (cleaned.endsWith('[]') || cleaned.startsWith('Array[') || cleaned.startsWith('Dictionary['))
+        return false;
+    // Enum references (Node.ProcessMode → int)
+    if (cleaned.includes('.'))
+        return false;
+    // Check the mapped TS type for primitives (int, float, bool→boolean, String→string, etc.)
+    if (NON_NULLABLE_TS_TYPES.has(godotTypeToTs(cleaned, ctx)))
+        return false;
+    // Everything else is a reference type → nullable
+    return true;
+}
+/**
+ * Widen a Godot type for use as a method parameter by including all types
+ * that can be variant-converted to it.
+ * Returns the TS type string, potentially as a union (e.g. `Vector2 | Vector2i`).
+ */
+export function widenParamType(gdType, ctx) {
+    const tsType = godotTypeToTs(gdType, ctx);
+    const converts = ctx.variantParamConverts.get(gdType);
+    if (!converts || converts.length === 0)
+        return tsType;
+    const targetIsPrimitive = TS_PRIMITIVE_TYPES.has(tsType);
+    const tsConverts = converts
+        .map((t) => godotTypeToTs(t, ctx))
+        .filter((t) => {
+        if (t === tsType)
+            return false; // no duplicate
+        // Skip primitive→primitive widening (e.g. int accepting bool/string)
+        if (targetIsPrimitive && TS_PRIMITIVE_TYPES.has(t))
+            return false;
+        return true;
+    });
+    if (tsConverts.length === 0)
+        return tsType;
+    return `${tsType} | ${tsConverts.join(' | ')}`;
+}
+/**
+ * Derive value types from parsed XML class data.
+ * A class is a value type if it has a constructor with a single parameter of
+ * its own type (e.g. `Vector2(from: Vector2)`).
+ */
+export function deriveValueTypes(classes, ctx) {
+    const result = new Set();
+    for (const [name, cls] of classes) {
+        if (name.startsWith('@'))
+            continue;
+        // Skip types that godotTypeToTs maps to a different name (e.g. StringName→string,
+        // bool→boolean) — they're handled as primitives, not value types.
+        if (godotTypeToTs(name, ctx) !== name)
+            continue;
+        // Skip types handled as TS interfaces (Array, Dictionary, String, Callable)
+        if (INTERFACE_CLASSES.has(name))
+            continue;
+        const hasSelfCtor = cls.constructors.some((c) => c.parameters.length === 1 && c.parameters[0].type === name);
+        if (hasSelfCtor)
+            result.add(name);
+    }
+    return result;
+}
+/**
+ * Derive variant conversion map from parsed XML class data.
+ * For each class with single-parameter "from" constructors, records which types
+ * can be converted to this class.
+ */
+export function deriveVariantParamConverts(classes) {
+    const result = new Map();
+    for (const [name, cls] of classes) {
+        if (name.startsWith('@'))
+            continue;
+        const convertFrom = [];
+        for (const ctor of cls.constructors) {
+            if (ctor.parameters.length !== 1)
+                continue;
+            const param = ctor.parameters[0];
+            if (param.name !== 'from' && !param.name.startsWith('from'))
+                continue;
+            if (param.type === name)
+                continue; // skip self-copy constructor
+            convertFrom.push(param.type);
+        }
+        if (convertFrom.length > 0)
+            result.set(name, convertFrom);
+    }
+    return result;
+}
+/**
+ * Load `non-nullable.json` from each override directory and merge.
+ * Later directories override earlier ones (user > defaults).
+ * Returns a map of ClassName → Set of member names that should be non-nullable.
+ */
+export function loadNonNullableOverrides(overrideDirs) {
+    const result = new Map();
+    for (const dir of overrideDirs) {
+        const filePath = join(dir, 'non-nullable.json');
+        if (!existsSync(filePath))
+            continue;
+        const data = JSON.parse(readFileSync(filePath, 'utf-8'));
+        for (const [cls, members] of Object.entries(data)) {
+            // Later dirs fully replace the class entry (consistent with override merging)
+            result.set(cls, new Set(members));
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=type-mapping.js.map

package/dist/typings/type-mapping.js.map

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

package/dist/typings/xml-parser.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Godot XML class documentation parser.
+ * Parses Godot's XML class reference files into structured data.
+ */
+import type { GodotEnumInfo } from './godot-registry.ts';
+export interface GodotClassXml {
+    name: string;
+    inherits?: string;
+    briefDescription?: string;
+    description?: string;
+    methods: GodotMethodXml[];
+    constructors: GodotMethodXml[];
+    properties: GodotPropertyXml[];
+    signals: GodotSignalXml[];
+    constants: GodotConstantXml[];
+    enums: GodotEnumInfo[];
+    operators: GodotOperatorXml[];
+    annotations: GodotAnnotationXml[];
+}
+export interface GodotMethodXml {
+    name: string;
+    returnType: string;
+    parameters: GodotParamXml[];
+    description?: string;
+    isVirtual: boolean;
+    isStatic: boolean;
+    isConst: boolean;
+    isVararg: boolean;
+}
+export interface GodotParamXml {
+    name: string;
+    type: string;
+    defaultValue?: string;
+}
+export interface GodotPropertyXml {
+    name: string;
+    type: string;
+    description?: string;
+    setter?: string;
+    getter?: string;
+}
+export interface GodotSignalXml {
+    name: string;
+    parameters: GodotParamXml[];
+    description?: string;
+}
+export interface GodotConstantXml {
+    name: string;
+    value: string;
+    description?: string;
+    enumName?: string;
+}
+export interface GodotAnnotationXml {
+    name: string;
+    parameters: GodotParamXml[];
+    description?: string;
+    isVararg: boolean;
+}
+export interface GodotOperatorXml {
+    /** e.g., "+", "-", "*", "/", "==", "!=", "<", "<=", ">", ">=", "unary+", "unary-" */
+    operator: string;
+    returnType: string;
+    /** For binary operators, the right-hand operand type. Absent for unary. */
+    rightType?: string;
+    description?: string;
+}
+/**
+ * Converts Godot BBCode-style markup to plain text for JSDoc.
+ * Strips [code], [b], [i], [url], [param], etc. tags.
+ */
+export declare function gdDocToPlain(text: string): string;
+/**
+ * Parses a Godot XML class documentation file.
+ */
+export declare function parseClassXml(xmlContent: string): GodotClassXml | null;
+/**
+ * Parses all Godot XML class docs from one or more directories.
+ *
+ * Godot's docs are spread across several locations — `doc/classes/` for
+ * core classes plus `modules/<module>/doc_classes/` for per-module
+ * additions (notably `modules/gdscript/doc_classes/@GDScript.xml`).
+ * Pass an array to merge all of them into one class map.
+ *
+ * Merge order: directories are processed in the given order; later
+ * directories overwrite same-named classes from earlier ones. This
+ * mirrors the override-dir convention elsewhere in the codebase
+ * ("later wins") and lets a user point a custom dir at the end of
+ * the list to patch a single class without forking the whole tree.
+ */
+export declare function parseAllClassXmls(classDocsDir: string | string[]): Map<string, GodotClassXml>;
+//# sourceMappingURL=xml-parser.d.ts.map

package/dist/typings/xml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-parser.d.ts","sourceRoot":"","sources":["../../src/typings/xml-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAeD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgCjD;AAID;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA0NtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAiB5B"}

package/dist/typings/xml-parser.js

@@ -0,0 +1,275 @@
+/**
+ * Godot XML class documentation parser.
+ * Parses Godot's XML class reference files into structured data.
+ */
+import { readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+// ─── Helpers ─────────────────────────────────────────────────
+/**
+ * Extracts text content from a `<description>` tag within a body string.
+ * Returns trimmed text or undefined if empty/missing.
+ */
+function extractDescription(body) {
+    const match = /<description>([\s\S]*?)<\/description>/.exec(body);
+    if (!match)
+        return undefined;
+    const text = match[1].trim();
+    return text || undefined;
+}
+/**
+ * Converts Godot BBCode-style markup to plain text for JSDoc.
+ * Strips [code], [b], [i], [url], [param], etc. tags.
+ */
+export function gdDocToPlain(text) {
+    return (text
+        .replace(/\[codeblock\][\s\S]*?\[\/codeblock\]/g, '') // remove code blocks entirely
+        .replace(/\[codeblocks\][\s\S]*?\[\/codeblocks\]/g, '')
+        .replace(/\[code\](.*?)\[\/code\]/g, '`$1`')
+        .replace(/\[param\s+(\w+)\]/g, '`$1`')
+        .replace(/\[b\](.*?)\[\/b\]/g, '**$1**')
+        .replace(/\[i\](.*?)\[\/i\]/g, '*$1*')
+        .replace(/\[url=([^\]]*)\](.*?)\[\/url\]/g, '$2 ($1)')
+        .replace(/\[([A-Z]\w*)\]/g, '{@link $1}') // class refs like [Node]
+        .replace(/\[method\s+([^\]]+)\]/g, '{@link $1}')
+        .replace(/\[member\s+([^\]]+)\]/g, '{@link $1}')
+        .replace(/\[signal\s+([^\]]+)\]/g, '{@link $1}')
+        .replace(/\[constant\s+([^\]]+)\]/g, '{@link $1}')
+        .replace(/\[enum\s+([^\]]+)\]/g, '{@link $1}')
+        .replace(/\[kbd\](.*?)\[\/kbd\]/g, '`$1`')
+        .replace(/\[annotation\s+[^\]]+\]/g, '')
+        .replace(/\[theme_item\s+[^\]]+\]/g, '')
+        .replace(/\[color=[^\]]*\](.*?)\[\/color\]/g, '$1')
+        .replace(/\[font=[^\]]*\](.*?)\[\/font\]/g, '$1')
+        .replace(/\[br\]/g, '\n')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&')
+        // Normalize indentation: replace tabs and collapse multi-spaces
+        .split('\n')
+        .map((l) => l.replace(/\t/g, '').trim())
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim());
+}
+// ─── Main Parsers ────────────────────────────────────────────
+/**
+ * Parses a Godot XML class documentation file.
+ */
+export function parseClassXml(xmlContent) {
+    const nameMatch = /<class name="([^"]+)"/.exec(xmlContent);
+    if (!nameMatch)
+        return null;
+    const name = nameMatch[1];
+    const inheritsMatch = /inherits="([^"]+)"/.exec(xmlContent);
+    const inherits = inheritsMatch?.[1];
+    // Parse class-level descriptions
+    const briefMatch = /<brief_description>([\s\S]*?)<\/brief_description>/.exec(xmlContent);
+    const briefDescription = briefMatch?.[1]?.trim() || undefined;
+    const classDescMatch = xmlContent.match(/<class[^>]*>[\s\S]*?<description>([\s\S]*?)<\/description>/);
+    const classDescription = classDescMatch?.[1]?.trim() || undefined;
+    const methods = [];
+    const properties = [];
+    const signals = [];
+    const constants = [];
+    // Parse methods
+    const methodRegex = /<method name="([^"]+)"([^>]*)>([\s\S]*?)<\/method>/g;
+    let match;
+    while ((match = methodRegex.exec(xmlContent)) !== null) {
+        const methodName = match[1];
+        const attrs = match[2];
+        const body = match[3];
+        const returnMatch = /<return type="([^"]*)"/.exec(body);
+        const returnType = returnMatch?.[1] ?? 'void';
+        const params = [];
+        const paramRegex = /<param index="\d+" name="([^"]+)" type="([^"]+)"(?:\s+default="([^"]*)")?/g;
+        let paramMatch;
+        while ((paramMatch = paramRegex.exec(body)) !== null) {
+            params.push({
+                name: paramMatch[1],
+                type: paramMatch[2],
+                defaultValue: paramMatch[3],
+            });
+        }
+        const qualifiers = attrs.match(/qualifiers="([^"]*)"/)?.[1] ?? '';
+        methods.push({
+            name: methodName,
+            returnType,
+            parameters: params,
+            description: extractDescription(body),
+            isVirtual: qualifiers.includes('virtual'),
+            isStatic: qualifiers.includes('static'),
+            isConst: qualifiers.includes('const'),
+            isVararg: qualifiers.includes('vararg'),
+        });
+    }
+    // Parse properties (members) -- may have inline text or child <description>
+    const propRegex = /<member name="([^"]+)" type="([^"]+)"(?:\s+setter="([^"]*)")?(?:\s+getter="([^"]*)")?[^>]*(?:\/>|>([\s\S]*?)<\/member>)/g;
+    while ((match = propRegex.exec(xmlContent)) !== null) {
+        const propDesc = match[5]?.trim() || undefined;
+        properties.push({
+            name: match[1],
+            type: match[2],
+            description: propDesc,
+            setter: match[3],
+            getter: match[4],
+        });
+    }
+    // Parse signals
+    const signalRegex = /<signal name="([^"]+)"(?:\s*\/|>([\s\S]*?)<\/signal)>/g;
+    while ((match = signalRegex.exec(xmlContent)) !== null) {
+        const sigName = match[1];
+        const body = match[2] ?? '';
+        const params = [];
+        const paramRegex2 = /<param index="\d+" name="([^"]+)" type="([^"]+)"/g;
+        let paramMatch;
+        while ((paramMatch = paramRegex2.exec(body)) !== null) {
+            params.push({ name: paramMatch[1], type: paramMatch[2] });
+        }
+        signals.push({
+            name: sigName,
+            parameters: params,
+            description: extractDescription(body),
+        });
+    }
+    // Parse constants -- may have inline text or child content
+    const constRegex = /<constant name="([^"]+)" value="([^"]*)"(?:\s+enum="([^"]*)")?[^>]*(?:\/>|>([\s\S]*?)<\/constant>)/g;
+    while ((match = constRegex.exec(xmlContent)) !== null) {
+        const constContent = match[4]?.trim() || undefined;
+        constants.push({
+            name: match[1],
+            value: match[2],
+            description: constContent,
+            enumName: match[3],
+        });
+    }
+    // Group constants by enum
+    const enumMap = new Map();
+    for (const c of constants) {
+        if (c.enumName) {
+            let e = enumMap.get(c.enumName);
+            if (!e) {
+                e = { name: c.enumName, values: [] };
+                enumMap.set(c.enumName, e);
+            }
+            e.values.push({ name: c.name, value: c.value });
+        }
+    }
+    // Parse operators
+    const operators = [];
+    const operatorRegex = /<operator name="operator ([^"]+)"[^>]*>([\s\S]*?)<\/operator>/g;
+    while ((match = operatorRegex.exec(xmlContent)) !== null) {
+        var opName = match[1]
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"');
+        const opBody = match[2];
+        const returnMatch = /<return type="([^"]*)"/.exec(opBody);
+        const returnType = returnMatch?.[1] ?? '';
+        const paramMatch = /<param index="0" name="[^"]*" type="([^"]+)"/.exec(opBody);
+        const rightType = paramMatch?.[1];
+        operators.push({
+            operator: opName,
+            returnType,
+            rightType,
+            description: extractDescription(opBody),
+        });
+    }
+    // Parse constructors
+    const constructorMethods = [];
+    const ctorRegex = /<constructor name="([^"]+)"[^>]*>([\s\S]*?)<\/constructor>/g;
+    while ((match = ctorRegex.exec(xmlContent)) !== null) {
+        const ctorBody = match[2];
+        const returnMatch = /<return type="([^"]*)"/.exec(ctorBody);
+        const returnType = returnMatch?.[1] ?? name;
+        const params = [];
+        const paramRegex3 = /<param index="\d+" name="([^"]+)" type="([^"]+)"(?:\s+default="([^"]*)")?/g;
+        let paramMatch;
+        while ((paramMatch = paramRegex3.exec(ctorBody)) !== null) {
+            params.push({
+                name: paramMatch[1],
+                type: paramMatch[2],
+                defaultValue: paramMatch[3],
+            });
+        }
+        constructorMethods.push({
+            name: match[1],
+            returnType,
+            parameters: params,
+            description: extractDescription(ctorBody),
+            isVirtual: false,
+            isStatic: false,
+            isConst: false,
+            isVararg: false,
+        });
+    }
+    // Parse annotations
+    const annotations = [];
+    const annotationRegex = /<annotation name="@([^"]+)"(?:\s+qualifiers="([^"]*)")?[^>]*>([\s\S]*?)<\/annotation>/g;
+    while ((match = annotationRegex.exec(xmlContent)) !== null) {
+        const annName = match[1];
+        const qualifiers = match[2] ?? '';
+        const annBody = match[3];
+        const params = [];
+        const paramRegex4 = /<param index="\d+" name="([^"]+)" type="([^"]+)"(?:\s+default="([^"]*)")?/g;
+        let paramMatch;
+        while ((paramMatch = paramRegex4.exec(annBody)) !== null) {
+            params.push({
+                name: paramMatch[1],
+                type: paramMatch[2],
+                defaultValue: paramMatch[3],
+            });
+        }
+        annotations.push({
+            name: annName,
+            parameters: params,
+            description: extractDescription(annBody),
+            isVararg: qualifiers.includes('vararg'),
+        });
+    }
+    return {
+        name,
+        inherits,
+        briefDescription,
+        description: classDescription,
+        methods,
+        constructors: constructorMethods,
+        properties,
+        signals,
+        constants,
+        enums: [...enumMap.values()],
+        operators,
+        annotations,
+    };
+}
+/**
+ * Parses all Godot XML class docs from one or more directories.
+ *
+ * Godot's docs are spread across several locations — `doc/classes/` for
+ * core classes plus `modules/<module>/doc_classes/` for per-module
+ * additions (notably `modules/gdscript/doc_classes/@GDScript.xml`).
+ * Pass an array to merge all of them into one class map.
+ *
+ * Merge order: directories are processed in the given order; later
+ * directories overwrite same-named classes from earlier ones. This
+ * mirrors the override-dir convention elsewhere in the codebase
+ * ("later wins") and lets a user point a custom dir at the end of
+ * the list to patch a single class without forking the whole tree.
+ */
+export function parseAllClassXmls(classDocsDir) {
+    const dirs = Array.isArray(classDocsDir) ? classDocsDir : [classDocsDir];
+    const classes = new Map();
+    for (const dir of dirs) {
+        const xmlFiles = readdirSync(dir).filter((f) => f.endsWith('.xml'));
+        for (const xmlFile of xmlFiles) {
+            const xmlPath = join(dir, xmlFile);
+            const xmlContent = readFileSync(xmlPath, 'utf-8');
+            const cls = parseClassXml(xmlContent);
+            if (cls) {
+                classes.set(cls.name, cls);
+            }
+        }
+    }
+    return classes;
+}
+//# sourceMappingURL=xml-parser.js.map

package/dist/typings/xml-parser.js.map

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