typescript-to-gdscript 0.1.0

package/dist/converter/gd-to-ts/helpers/unsafe-helpers.js

@@ -0,0 +1,336 @@
+/**
+ * Unsafe helper fixes for GD-to-TS post-processing.
+ * - collectUnsafeAnyFieldFixes: adds `any` type annotations to untyped fields/params
+ * - collectUnsafeNonNullFixes: adds `!` non-null assertions for "possibly null" errors
+ * - collectExtendsTypeFixes: copies parent method param types to overrides
+ */
+import ts from 'typescript';
+import { findNodeAt } from "./explicit-convert.js";
+import { findEnclosingClass } from "./ready-field-types.js";
+// ─── Extends Type Helper ─────────────────────────────────────
+/**
+ * TS error code for implicit-any parameters.
+ * - TS7006: Parameter 'X' implicitly has an 'any' type.
+ */
+export const TS_IMPLICIT_ANY_PARAM_CODE = 7006;
+/**
+ * Walk up from a node to find the enclosing MethodDeclaration.
+ */
+export function findEnclosingMethod(node) {
+    let current = node;
+    while (current) {
+        if (ts.isMethodDeclaration(current))
+            return current;
+        current = current.parent;
+    }
+    return undefined;
+}
+/**
+ * Look up the parent-class signature for a method by name, walking the
+ * inheritance chain via the TS checker. Returns the first call signature found.
+ */
+export function findParentMethodSignature(cls, methodName, checker) {
+    // Use the class's own declared type and walk its base types via the checker.
+    // This correctly resolves `Node2D -> CanvasItem -> Node` for overridden methods.
+    const classType = checker.getTypeAtLocation(cls);
+    const baseTypes = classType.getBaseTypes() ?? [];
+    for (const baseType of baseTypes) {
+        const symbol = baseType.getProperty(methodName);
+        if (!symbol)
+            continue;
+        const decl = symbol.valueDeclaration ?? symbol.getDeclarations()?.[0];
+        if (!decl)
+            continue;
+        const methodType = checker.getTypeOfSymbolAtLocation(symbol, decl);
+        const signatures = methodType.getCallSignatures();
+        if (signatures.length > 0)
+            return signatures[0];
+    }
+    return undefined;
+}
+/**
+ * Collect TS7006 errors on parameters of methods that override inherited
+ * methods, and produce type-annotation insertion fixes using the parent's
+ * parameter types.
+ */
+export function collectExtendsTypeFixes(program, filePaths) {
+    const fixesByFile = new Map();
+    const checker = program.getTypeChecker();
+    for (const sourceFile of program.getSourceFiles()) {
+        const fileName = sourceFile.fileName;
+        if (!filePaths.has(fileName))
+            continue;
+        const diagnostics = program.getSemanticDiagnostics(sourceFile);
+        // Cache parent signatures per (class,method) to avoid repeated lookups
+        const sigCache = new Map();
+        for (const diag of diagnostics) {
+            if (diag.code !== TS_IMPLICIT_ANY_PARAM_CODE)
+                continue;
+            if (diag.start === undefined || diag.length === undefined)
+                continue;
+            const node = findNodeAt(sourceFile, diag.start, diag.length);
+            if (!node)
+                continue;
+            // Walk up to the Parameter
+            let paramDecl;
+            let current = node;
+            while (current) {
+                if (ts.isParameter(current)) {
+                    paramDecl = current;
+                    break;
+                }
+                current = current.parent;
+            }
+            if (!paramDecl || paramDecl.type)
+                continue; // already typed
+            const method = findEnclosingMethod(paramDecl);
+            if (!method || !ts.isIdentifier(method.name))
+                continue;
+            const cls = findEnclosingClass(method);
+            if (!cls)
+                continue;
+            const methodName = method.name.text;
+            const cacheKey = `${cls.pos}:${methodName}`;
+            let parentSig = sigCache.get(cacheKey);
+            if (!sigCache.has(cacheKey)) {
+                parentSig = findParentMethodSignature(cls, methodName, checker);
+                sigCache.set(cacheKey, parentSig);
+            }
+            if (!parentSig)
+                continue;
+            // Find matching parameter by index (name-based matching is unreliable
+            // because overrides often rename parameters).
+            const paramIndex = method.parameters.indexOf(paramDecl);
+            const parentParams = parentSig.getParameters();
+            const parentParam = parentParams[paramIndex];
+            if (!parentParam)
+                continue;
+            const parentParamDecl = parentParam.valueDeclaration;
+            if (!parentParamDecl || !ts.isParameter(parentParamDecl))
+                continue;
+            // Prefer the SYNTACTIC type text from the parent's .d.ts declaration so
+            // that type aliases like `float`/`int` are preserved (the checker would
+            // resolve them to `number`).
+            let typeText;
+            if (parentParamDecl.type) {
+                typeText = parentParamDecl.type.getText(parentParamDecl.getSourceFile());
+            }
+            else {
+                const parentType = checker.getTypeOfSymbolAtLocation(parentParam, parentParamDecl);
+                typeText = checker.typeToString(parentType, method, ts.TypeFormatFlags.NoTruncation |
+                    ts.TypeFormatFlags.UseFullyQualifiedType);
+            }
+            if (!typeText || typeText === 'any' || typeText === 'error')
+                continue;
+            const insertAt = paramDecl.name.getEnd();
+            const replacement = `: ${typeText}`;
+            let fixes = fixesByFile.get(fileName);
+            if (!fixes) {
+                fixes = [];
+                fixesByFile.set(fileName, fixes);
+            }
+            fixes.push({ start: insertAt, end: insertAt, replacement });
+        }
+    }
+    return fixesByFile;
+}
+// ─── Unsafe Any Fallback Helper ──────────────────────────────
+/**
+ * (unsafe) Add `any` type annotations to any class properties and function
+ * parameters that still have no explicit type after other helpers have run.
+ * Only activated via `--unsafe-use-any`. Intended as a final cleanup pass so
+ * the converted TS code compiles even when earlier helpers couldn't infer a
+ * concrete type.
+ *
+ * - Class property without a type -> insert `!: any` after the name (or `: any`
+ *   after an existing `!`/`?` token). Ignores properties that already have
+ *   a type annotation.
+ * - Function/method/arrow/constructor parameter without a type -> insert
+ *   `: any` after the parameter name (or after its `?` token if optional).
+ *   Rest parameters get `: any[]`.
+ */
+export function collectUnsafeAnyFieldFixes(program, filePaths) {
+    const fixesByFile = new Map();
+    for (const sourceFile of program.getSourceFiles()) {
+        const fileName = sourceFile.fileName;
+        if (!filePaths.has(fileName))
+            continue;
+        const diagnostics = program.getSemanticDiagnostics(sourceFile);
+        const fixedPositions = new Set();
+        const fixes = [];
+        const pushFix = (start, replacement) => {
+            if (fixedPositions.has(start))
+                return;
+            fixedPositions.add(start);
+            fixes.push({ start, end: start, replacement });
+        };
+        for (const diag of diagnostics) {
+            // TS7006: Parameter 'X' implicitly has an 'any' type.
+            // TS7008: Member 'X' implicitly has an 'any' type.
+            // TS7034: Variable 'X' implicitly has type 'any[]' in some locations.
+            if (diag.code !== 7006 && diag.code !== 7008 && diag.code !== 7034)
+                continue;
+            if (diag.start === undefined || diag.length === undefined)
+                continue;
+            const node = findNodeAt(sourceFile, diag.start, diag.length);
+            if (!node)
+                continue;
+            // Walk up to PropertyDeclaration, ParameterDeclaration, or VariableDeclaration
+            let current = node;
+            let propDecl;
+            let paramDecl;
+            let varDecl;
+            while (current) {
+                if (ts.isPropertyDeclaration(current)) {
+                    propDecl = current;
+                    break;
+                }
+                if (ts.isParameter(current)) {
+                    paramDecl = current;
+                    break;
+                }
+                if (ts.isVariableDeclaration(current)) {
+                    varDecl = current;
+                    break;
+                }
+                current = current.parent;
+            }
+            if (propDecl) {
+                if (propDecl.type)
+                    continue; // already typed
+                // Insert after `!`/`?` if present, otherwise after the name. Add
+                // `!` ourselves if neither is present so TS2564 doesn't fire later.
+                if (propDecl.exclamationToken) {
+                    pushFix(propDecl.exclamationToken.getEnd(), ': any');
+                }
+                else if (propDecl.questionToken) {
+                    pushFix(propDecl.questionToken.getEnd(), ': any');
+                }
+                else {
+                    pushFix(propDecl.name.getEnd(), '!: any');
+                }
+                continue;
+            }
+            if (paramDecl) {
+                if (paramDecl.type)
+                    continue;
+                // Rest parameter -> `: any[]`
+                const typeText = paramDecl.dotDotDotToken ? ': any[]' : ': any';
+                // Insert after `?` if optional, otherwise after the name
+                if (paramDecl.questionToken) {
+                    pushFix(paramDecl.questionToken.getEnd(), typeText);
+                }
+                else {
+                    pushFix(paramDecl.name.getEnd(), typeText);
+                }
+                continue;
+            }
+            if (varDecl) {
+                if (varDecl.type)
+                    continue; // already typed
+                // TS7034: variable implicitly has `any[]` -- add `: any[]` after the name
+                pushFix(varDecl.name.getEnd(), ': any[]');
+                continue;
+            }
+        }
+        if (fixes.length > 0) {
+            fixesByFile.set(fileName, fixes);
+        }
+    }
+    return fixesByFile;
+}
+// ─── Unsafe Non-Null Assertion Helper ───────────────────────
+/**
+ * TS error codes for "possibly null/undefined" that can be suppressed with `!`.
+ * - TS2531: Object is possibly 'null'.
+ * - TS18047: 'X' is possibly 'null'.
+ * - TS18048: 'X' is possibly 'null' or 'undefined'.
+ * - TS18046: 'X' is of type 'unknown'.
+ */
+export const TS_POSSIBLY_NULL_CODES = new Set([2531, 18047, 18048, 18046]);
+/**
+ * Check if a TS2322 diagnostic is caused by null in a union type.
+ * Looks for "Type 'null' is not assignable to type" in the message chain.
+ */
+export function isNullAssignmentError(messageText) {
+    if (typeof messageText === 'string') {
+        return /type 'null' is not assignable to type/i.test(messageText);
+    }
+    if (/type 'null' is not assignable to type/i.test(messageText.messageText))
+        return true;
+    if (messageText.next) {
+        for (const sub of messageText.next) {
+            if (isNullAssignmentError(sub))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Collect "possibly null" errors and produce `!` (non-null assertion) fixes.
+ * Also handles TS2322 where the error is caused by `T | null` assigned to `T`
+ * (adds `!` after the RHS expression).
+ * Only runs when `--unsafe-use-any` is set (Phase 2).
+ */
+export function collectUnsafeNonNullFixes(program, filePaths) {
+    const fixesByFile = new Map();
+    for (const sourceFile of program.getSourceFiles()) {
+        const fileName = sourceFile.fileName;
+        if (!filePaths.has(fileName))
+            continue;
+        const diagnostics = program.getSemanticDiagnostics(sourceFile);
+        const fixedPositions = new Set();
+        const fixes = [];
+        const sourceText = sourceFile.getFullText();
+        const pushNonNull = (pos) => {
+            if (fixedPositions.has(pos))
+                return;
+            if (sourceText[pos] === '!')
+                return; // already has `!`
+            fixedPositions.add(pos);
+            fixes.push({ start: pos, end: pos, replacement: '!' });
+        };
+        for (const diag of diagnostics) {
+            if (diag.start === undefined || diag.length === undefined)
+                continue;
+            // Direct "possibly null" errors -- insert `!` right after the expression
+            if (TS_POSSIBLY_NULL_CODES.has(diag.code)) {
+                pushNonNull(diag.start + diag.length);
+                continue;
+            }
+            // TS2322: "Type 'X | null' is not assignable to type 'X'"
+            // TS2345: "Argument of type 'X | null' is not assignable to parameter of type 'X'"
+            // where the root cause is null -- insert `!` after the expression
+            if ((diag.code === 2322 || diag.code === 2345) &&
+                isNullAssignmentError(diag.messageText)) {
+                let node = findNodeAt(sourceFile, diag.start, diag.length);
+                if (!node)
+                    continue;
+                // Redirect from LHS/keyword to the actual value expression
+                const parent = node.parent;
+                if (ts.isIdentifier(node) &&
+                    (ts.isVariableDeclaration(parent) ||
+                        ts.isPropertyDeclaration(parent)) &&
+                    parent.name === node &&
+                    parent.initializer) {
+                    node = parent.initializer;
+                }
+                else if (ts.isBinaryExpression(parent) &&
+                    parent.operatorToken.kind === ts.SyntaxKind.EqualsToken &&
+                    parent.left === node) {
+                    node = parent.right;
+                }
+                else if (ts.isReturnStatement(parent) && parent.expression) {
+                    node = parent.expression;
+                }
+                pushNonNull(node.getEnd());
+                continue;
+            }
+        }
+        if (fixes.length > 0) {
+            fixesByFile.set(fileName, fixes);
+        }
+    }
+    return fixesByFile;
+}
+//# sourceMappingURL=unsafe-helpers.js.map

package/dist/converter/gd-to-ts/helpers/unsafe-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsafe-helpers.js","sourceRoot":"","sources":["../../../../src/converter/gd-to-ts/helpers/unsafe-helpers.ts"],"names":[],"mappings":"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"}

package/dist/converter/gd-to-ts/imports.d.ts

@@ -0,0 +1,47 @@
+/**
+ * GD\u2192TS auto-import emission.
+ *
+ * When `generateGlobalClassTypes` is `false`, user classes are
+ * module-scoped on the TS side \u2014 they're only visible to consumers
+ * that explicitly `import` them. The GD\u2192TS converter therefore needs
+ * to insert `import { Foo } from './foo.js'` lines at the top of each
+ * generated `.ts` for every cross-file user class the file references.
+ *
+ * Detection is a deliberately simple word-boundary scan over the
+ * already-emitted TS:
+ *
+ *   - For each entry in `ctx.userClasses`:
+ *     - skip the file's own class
+ *     - skip entries with no known source `filePath`
+ *     - skip entries declared in the same file as the current source
+ *     - run `\b<name>\b` against the emitted code; if it matches, emit
+ *       an import for it
+ *
+ * False positives (a class name that only appears inside a string
+ * literal or a comment) just produce an extra unused import \u2014
+ * harmless unless the consumer enables a strict no-unused-imports
+ * lint rule. A more precise AST-based scan would buy little in
+ * practice; the simple form keeps this module self-contained.
+ *
+ * The post-pass is a no-op when `generateGlobalClassTypes` is `true`
+ * (legacy / addon-required layout) so existing callers \u2014 including
+ * `generateAddonTypings` \u2014 don't need any changes.
+ */
+import type { GdToTsContext } from './context.ts';
+export interface PrependImportsOptions {
+    /**
+     * When `true` (the default), no imports are emitted \u2014 the legacy
+     * `declare global` layout makes every user class globally visible.
+     * Pass `false` to opt into the module-scoped layout that requires
+     * cross-file imports.
+     */
+    generateGlobalClassTypes: boolean;
+}
+/**
+ * Inspect the emitted TS, prepend `import { Foo } from './foo.js'`
+ * lines for every cross-file user class it references, and return the
+ * combined source. Returns the input unchanged when imports are not
+ * needed (flag is `true`, no references found, etc.).
+ */
+export declare function prependImports(emittedTs: string, ctx: GdToTsContext, options: PrependImportsOptions): string;
+//# sourceMappingURL=imports.d.ts.map

package/dist/converter/gd-to-ts/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../src/converter/gd-to-ts/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,qBAAqB,GAC7B,MAAM,CAoCR"}

package/dist/converter/gd-to-ts/imports.js

@@ -0,0 +1,98 @@
+/**
+ * GD\u2192TS auto-import emission.
+ *
+ * When `generateGlobalClassTypes` is `false`, user classes are
+ * module-scoped on the TS side \u2014 they're only visible to consumers
+ * that explicitly `import` them. The GD\u2192TS converter therefore needs
+ * to insert `import { Foo } from './foo.js'` lines at the top of each
+ * generated `.ts` for every cross-file user class the file references.
+ *
+ * Detection is a deliberately simple word-boundary scan over the
+ * already-emitted TS:
+ *
+ *   - For each entry in `ctx.userClasses`:
+ *     - skip the file's own class
+ *     - skip entries with no known source `filePath`
+ *     - skip entries declared in the same file as the current source
+ *     - run `\b<name>\b` against the emitted code; if it matches, emit
+ *       an import for it
+ *
+ * False positives (a class name that only appears inside a string
+ * literal or a comment) just produce an extra unused import \u2014
+ * harmless unless the consumer enables a strict no-unused-imports
+ * lint rule. A more precise AST-based scan would buy little in
+ * practice; the simple form keeps this module self-contained.
+ *
+ * The post-pass is a no-op when `generateGlobalClassTypes` is `true`
+ * (legacy / addon-required layout) so existing callers \u2014 including
+ * `generateAddonTypings` \u2014 don't need any changes.
+ */
+import { dirname, relative, resolve } from 'path';
+/**
+ * Inspect the emitted TS, prepend `import { Foo } from './foo.js'`
+ * lines for every cross-file user class it references, and return the
+ * combined source. Returns the input unchanged when imports are not
+ * needed (flag is `true`, no references found, etc.).
+ */
+export function prependImports(emittedTs, ctx, options) {
+    if (options.generateGlobalClassTypes)
+        return emittedTs;
+    const currentFile = ctx.filePath;
+    const currentClass = ctx.className;
+    // Collect targets: `(localName, importSpecifier)` for every cross-file
+    // user class actually referenced in the emitted TS.
+    const imports = [];
+    for (const [name, info] of ctx.userClasses) {
+        if (name === currentClass)
+            continue; // self-class
+        if (!info.filePath)
+            continue; // unknown source path
+        if (sameFile(info.filePath, currentFile))
+            continue; // declared in this file
+        // Word-boundary scan. Skips inside-identifier matches (e.g. `Player`
+        // matching `MyPlayerThing` is excluded by `\b`), but does match
+        // inside strings/comments \u2014 see module docstring for the trade-off.
+        const re = new RegExp(`\\b${escapeForRegex(name)}\\b`);
+        if (!re.test(emittedTs))
+            continue;
+        imports.push({
+            name,
+            specifier: importSpecifierFor(currentFile, info.filePath),
+        });
+    }
+    if (imports.length === 0)
+        return emittedTs;
+    // Stable, alphabetical order \u2014 makes diffs predictable when a file
+    // gains/loses imports between runs.
+    imports.sort((a, b) => a.name.localeCompare(b.name));
+    const importLines = imports.map((i) => `import { ${i.name} } from "${i.specifier}";`);
+    return importLines.join('\n') + '\n\n' + emittedTs;
+}
+// \u2500\u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+function sameFile(a, b) {
+    // Normalize both ways so we don't get tripped up by mixed
+    // separators (Windows \\ vs POSIX /). `resolve` collapses
+    // `..` segments and the slash-replace flattens drive-letter case.
+    return resolve(a).replace(/\\/g, '/') === resolve(b).replace(/\\/g, '/');
+}
+/**
+ * Build the import specifier for a `import { X } from "..."` line that
+ * references `targetGd`'s mirrored `.ts` file from `currentGd`'s
+ * mirrored `.ts` file.
+ *
+ * Both files live in the GD tree; the TS tree is a 1:1 mirror. So the
+ * specifier reduces to `relative(dirname(currentGd), targetGd)` with
+ * `.gd` swapped to `.js` (NodeNext convention) and a leading `./`
+ * forced when the result is a sibling file (`relative()` returns
+ * `foo.js` rather than `./foo.js`).
+ */
+function importSpecifierFor(currentGd, targetGd) {
+    let rel = relative(dirname(currentGd), targetGd).replace(/\\/g, '/');
+    if (!rel.startsWith('.') && !rel.startsWith('/'))
+        rel = './' + rel;
+    return rel.replace(/\.gd$/, '.js');
+}
+function escapeForRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=imports.js.map

package/dist/converter/gd-to-ts/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../../src/converter/gd-to-ts/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAalD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,GAAkB,EAClB,OAA8B;IAE9B,IAAI,OAAO,CAAC,wBAAwB;QAAE,OAAO,SAAS,CAAC;IAEvD,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;IACjC,MAAM,YAAY,GAAG,GAAG,CAAC,SAAS,CAAC;IAEnC,uEAAuE;IACvE,oDAAoD;IACpD,MAAM,OAAO,GAA+C,EAAE,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,IAAI,KAAK,YAAY;YAAE,SAAS,CAAY,aAAa;QAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,SAAS,CAAmB,sBAAsB;QACtE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;YAAE,SAAS,CAAC,wBAAwB;QAE5E,qEAAqE;QACrE,gEAAgE;QAChE,yEAAyE;QACzE,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,SAAS;QAElC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,SAAS,EAAE,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,wEAAwE;IACxE,oCAAoC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,SAAS,IAAI,CACrD,CAAC;IACF,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;AACrD,CAAC;AAED,8TAA8T;AAE9T,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,0DAA0D;IAC1D,0DAA0D;IAC1D,kEAAkE;IAClE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IAC7D,IAAI,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;IACnE,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/converter/gd-to-ts/index.d.ts

@@ -0,0 +1,59 @@
+import type { TransformResult } from '../common/index.ts';
+import type { GodotClassRegistry } from '../../typings/godot-registry.ts';
+import { type UserClassInfo } from './context.ts';
+export type { GdToTsContext } from './context.ts';
+export type { UserClassInfo } from './context.ts';
+export interface GdToTsOptions {
+    /** GDScript source code */
+    source: string;
+    /** File path (for diagnostics) */
+    filePath: string;
+    /** Whether this is an addon file */
+    isAddon?: boolean;
+    /** Godot class registry for inherited member resolution (required) */
+    registry: GodotClassRegistry;
+    /** Additional GD source files in the project (for resolving user-defined class inheritance) */
+    projectSources?: Array<{
+        source: string;
+        filePath: string;
+    }>;
+    /**
+     * Signal handler type info resolved from .tscn scene connections.
+     * Maps method name → array of typed parameters (Godot type names).
+     * When a GDScript function matches a handler name and has untyped params,
+     * the signal's parameter types are used instead.
+     */
+    signalHandlers?: Map<string, {
+        params: Array<{
+            name: string;
+            gdType: string;
+        }>;
+    }>;
+    /**
+     * Use `any` instead of `unknown` as the fallback for unresolvable types
+     * (e.g. `gd.getset` without a GDScript type annotation and without a
+     * typeof-able value expression). Less strict but more error-prone.
+     */
+    unsafeUseAny?: boolean;
+    /**
+     * @deprecated The single-file `convertGdToTs` no longer auto-emits
+     * imports — that's done by {@link import('./inject-imports.ts').injectMissingImports}
+     * at the batch level (driven by the `initial-convert-gd-to-ts` CLI command). The field is kept on
+     * the options shape for API back-compat but is currently ignored.
+     * The `injectMissingImports` post-pass takes its own
+     * `generateGlobalClassTypes` flag.
+     */
+    generateGlobalClassTypes?: boolean;
+}
+/**
+ * Extracts class info (class_name, extends, own members) from a GD source without full conversion.
+ *
+ * `filePath` is optional but recommended — it's stored on the resulting
+ * {@link UserClassInfo} and consumed by the GD→TS converter when it
+ * needs to emit cross-file `import { Foo } from './foo.js'` lines (the
+ * module-scoped layout used when `generateGlobalClassTypes` is `false`).
+ */
+export declare function parseGdClassInfo(source: string, registry?: GodotClassRegistry, filePath?: string): UserClassInfo | null;
+export declare function convertGdToTs(options: GdToTsOptions): TransformResult;
+export { resolveAllInheritedMembers, resolveInheritedMemberTypes, } from './context.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/converter/gd-to-ts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/converter/gd-to-ts/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AAKtB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAkElD,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+FAA+F;IAC/F,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,GAAG,CAClB,MAAM,EACN;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CACpD,CAAC;IACF;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI,CAgEtB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CA0DrE;AAGD,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,cAAc,CAAC"}