typescript-to-gdscript 0.1.0

package/dist/eslint/rules/convert.js

@@ -0,0 +1,286 @@
+import { writeFileSync, mkdirSync, rmSync, existsSync, statSync } from 'fs';
+import { resolve, relative, dirname, join } from 'path';
+import { tmpdir } from 'os';
+import { convertTsToGd } from "../../converter/ts-to-gd/index.js";
+import { createTsProgram } from "../../parser/typescript/index.js";
+import { validateGdFilesSync } from "../../godot-validate/index.js";
+import { resolveConfig, resolveGodotPath } from "../../config/index.js";
+import { ProjectCache } from "../../cache/index.js";
+import { isConversionErrorSeverity, isReportableErrorSeverity, } from "../../converter/common/index.js";
+const programCache = new Map();
+function getOrCreateProgram(tsConfigPath, rootDir) {
+    const key = resolve(tsConfigPath);
+    const currentMtime = statSync(key).mtimeMs;
+    const cached = programCache.get(key);
+    if (cached && cached.tsConfigMtimeMs !== currentMtime) {
+        // tsconfig itself changed (include/exclude/compilerOptions edit) — drop
+        // the cache. File-level changes are handled below via `oldProgram` reuse.
+        programCache.delete(key);
+    }
+    const prev = programCache.get(key);
+    const program = createTsProgram({
+        rootDir,
+        files: [],
+        tsConfigPath: key,
+        oldProgram: prev?.program,
+    });
+    programCache.set(key, { program, tsConfigMtimeMs: currentMtime });
+    return program;
+}
+const convertRule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Convert TypeScript to GDScript and report transformation errors and Godot validation errors',
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    rootDir: { type: 'string' },
+                    tsDir: { type: 'string' },
+                    tsconfig: { type: 'string' },
+                    projectRoot: { type: 'string' },
+                },
+                additionalProperties: false,
+            },
+        ],
+        fixable: 'code',
+        messages: {
+            convertError: '{{message}}',
+            convertWarning: '{{message}}',
+            godotError: '{{message}}',
+        },
+    },
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    create(context) {
+        const options = context.options[0] ?? {};
+        const filename = context.filename ?? context.getFilename();
+        // Skip .d.ts files
+        if (filename.endsWith('.d.ts'))
+            return {};
+        return {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            Program(_node) {
+                const cfg = resolveConfig({
+                    configDir: options.rootDir
+                        ? resolve(options.rootDir)
+                        : dirname(filename),
+                    overrides: {
+                        rootDir: options.rootDir,
+                        tsDir: options.tsDir,
+                        tsconfig: options.tsconfig,
+                    },
+                });
+                // Cache check: if TS→GD conversion is fresh, report cached diagnostics
+                const cache = new ProjectCache(cfg.cacheDir);
+                const relPath = relative(cfg.tsDir, filename);
+                const gdPath = resolve(cfg.gdDir, relPath.replace(/\.ts$/, '.gd'));
+                if (cache.isTsToGdFresh(filename, gdPath)) {
+                    // Report cached converter diagnostics
+                    const cachedDiags = cache.getDiagnostics(filename);
+                    // Only real conversion errors block Godot validation;
+                    // type-errors still produced valid .gd and should be validated.
+                    const hasConversionError = cachedDiags
+                        ? reportDiagnostics(context, cachedDiags)
+                        : false;
+                    // Re-run Godot validation (only if no converter errors)
+                    if (!hasConversionError && !cfg.disableGodotLint && existsSync(gdPath)) {
+                        const projectRoot = options.projectRoot
+                            ? resolve(options.projectRoot)
+                            : cfg.rootDir;
+                        const godotPath = resolveGodotPath({ godotPath: cfg.godotPath });
+                        const sourceMapJson = cache.getSourceMap(filename);
+                        runGodotValidation(context, {
+                            gdCode: '',
+                            sourceMapJson,
+                            tsFilePath: filename,
+                            tsDirOrRootDir: cfg.tsDir,
+                            projectRoot,
+                            godotPath,
+                            cachedGdPath: gdPath,
+                        });
+                    }
+                    return;
+                }
+                // Step 1: Convert TS to GD.
+                // Reuse a module-level ts.Program when a tsconfig is available so
+                // long-lived ESLint processes (IDE / LSP) don't re-parse every .d.ts
+                // on each lint. Falls back to the per-call Program when no tsconfig
+                // is set (rare: only standalone TS files).
+                const resolvedTsConfig = cfg.tsconfig ? resolve(cfg.tsconfig) : undefined;
+                const program = resolvedTsConfig
+                    ? getOrCreateProgram(resolvedTsConfig, cfg.tsDir)
+                    : undefined;
+                const result = convertTsToGd({
+                    filePath: filename,
+                    rootDir: cfg.tsDir,
+                    tsConfigPath: resolvedTsConfig,
+                    sourceMap: true, // Always generate source map for Godot error remapping
+                    program,
+                });
+                // Step 2: Report converter diagnostics
+                // Only real conversion errors block Godot validation;
+                // type-errors still produced valid .gd and should be validated.
+                const hasConversionError = reportDiagnostics(context, result.diagnostics);
+                // Step 3: If no converter errors and Godot lint not disabled, run Godot validation
+                if (!hasConversionError && !cfg.disableGodotLint) {
+                    const projectRoot = options.projectRoot
+                        ? resolve(options.projectRoot)
+                        : cfg.rootDir;
+                    const godotPath = resolveGodotPath({ godotPath: cfg.godotPath });
+                    runGodotValidation(context, {
+                        gdCode: result.code,
+                        sourceMapJson: result.sourceMap,
+                        tsFilePath: filename,
+                        tsDirOrRootDir: cfg.tsDir,
+                        projectRoot,
+                        godotPath,
+                    });
+                }
+            },
+        };
+    },
+};
+/**
+ * Report converter diagnostics to ESLint.
+ *
+ * Returns `true` only when there was a real **conversion error** (i.e. the
+ * converter could not produce valid GDScript). Type-errors are reported to
+ * ESLint as errors too (so `--max-warnings 0` / exit code behaviour is
+ * preserved), but they do NOT block Godot validation — the emitted `.gd` is
+ * syntactically valid and Godot can still lint it.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function reportDiagnostics(context, diagnostics) {
+    let hasConversionError = false;
+    for (const diag of diagnostics) {
+        if (diag.severity === 'info')
+            continue;
+        const messageId = isReportableErrorSeverity(diag.severity)
+            ? 'convertError'
+            : 'convertWarning';
+        if (isConversionErrorSeverity(diag.severity))
+            hasConversionError = true;
+        // Only report diagnostics from the current file
+        const diagFile = resolve(diag.file);
+        const contextFile = resolve(context.filename ?? context.getFilename());
+        if (diagFile !== contextFile)
+            continue;
+        const loc = diag.line > 0
+            ? {
+                start: { line: diag.line, column: diag.column },
+                end: { line: diag.line, column: diag.column + 1000 },
+            }
+            : undefined;
+        // For logical value errors, provide an auto-fix that wraps in bool()
+        const isLogicalValueError = diag.message.includes('non-boolean value');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let fix;
+        if (isLogicalValueError && loc) {
+            // Find the BinaryExpression (||/&&) at the diagnostic line
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const sourceCode = context.sourceCode ?? context.getSourceCode();
+            const nodeAtLoc = sourceCode.getNodeByRangeIndex?.(sourceCode.getIndexFromLoc(loc.start));
+            // Walk up to find the LogicalExpression, then continue to the outermost
+            // logical in the chain (so `a && b || c` wraps the whole thing, not just `a && b`)
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            let logicalNode = nodeAtLoc;
+            while (logicalNode && logicalNode.type !== 'LogicalExpression') {
+                logicalNode = logicalNode.parent;
+            }
+            // Walk up through parent LogicalExpressions to find the outermost one
+            while (logicalNode?.parent?.type === 'LogicalExpression') {
+                logicalNode = logicalNode.parent;
+            }
+            // Skip if already wrapped in bool()
+            const alreadyWrapped = logicalNode?.parent?.type === 'CallExpression' &&
+                logicalNode.parent.callee?.type === 'Identifier' &&
+                logicalNode.parent.callee.name === 'bool';
+            if (logicalNode && !alreadyWrapped) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                fix = (fixer) => [
+                    fixer.insertTextBefore(logicalNode, 'bool('),
+                    fixer.insertTextAfter(logicalNode, ')'),
+                ];
+            }
+        }
+        context.report({
+            messageId,
+            data: { message: diag.message },
+            ...(loc ? { loc } : { node: context.sourceCode.ast }),
+            ...(fix ? { fix } : {}),
+        });
+    }
+    return hasConversionError;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function runGodotValidation(context, params) {
+    // If we have a cached GD file in the project, validate it directly
+    if (params.cachedGdPath) {
+        const validateResult = validateGdFilesSync({
+            gdFiles: [
+                {
+                    path: params.cachedGdPath,
+                    sourceMapJson: params.sourceMapJson,
+                    tsFilePath: params.tsFilePath,
+                },
+            ],
+            projectRoot: params.projectRoot,
+            godotPath: params.godotPath,
+        });
+        reportGodotDiagnostics(context, validateResult.diagnostics);
+        return;
+    }
+    // Create temp GD file for Godot validation
+    const relPath = relative(params.tsDirOrRootDir, params.tsFilePath);
+    const gdRelPath = relPath.replace(/\.ts$/, '.gd');
+    const gdAbsPath = resolve(tmpdir(), 'tstogd', gdRelPath);
+    const gdDir = dirname(gdAbsPath);
+    try {
+        mkdirSync(gdDir, { recursive: true });
+        writeFileSync(gdAbsPath, params.gdCode);
+        const validateResult = validateGdFilesSync({
+            gdFiles: [
+                {
+                    path: gdAbsPath,
+                    sourceMapJson: params.sourceMapJson,
+                    tsFilePath: params.tsFilePath,
+                },
+            ],
+            projectRoot: params.projectRoot,
+            godotPath: params.godotPath,
+        });
+        reportGodotDiagnostics(context, validateResult.diagnostics);
+    }
+    finally {
+        try {
+            if (existsSync(gdAbsPath))
+                rmSync(gdAbsPath);
+            const mapPath = gdAbsPath + '.map';
+            if (existsSync(mapPath))
+                rmSync(mapPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function reportGodotDiagnostics(context, diagnostics) {
+    for (const diag of diagnostics) {
+        const loc = diag.line > 0
+            ? {
+                start: { line: diag.line, column: diag.column },
+                end: { line: diag.line, column: diag.column + 1000 },
+            }
+            : undefined;
+        context.report({
+            messageId: 'godotError',
+            data: { message: diag.message },
+            ...(loc ? { loc } : { node: context.sourceCode.ast }),
+        });
+    }
+}
+export default convertRule;
+//# sourceMappingURL=convert.js.map

package/dist/eslint/rules/convert.js.map

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

package/dist/eslint/rules/no-in-variant.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ESLint rule: disallow `x in y` where `y` is a GDScript variant primitive
+ * (Vector2, Color, Transform2D, Quaternion, etc.) — the `in` operator is not
+ * valid on these types in GDScript. Container variants (`Array`, `Dictionary`,
+ * `String`, `Packed*Array`, etc.) are explicitly allowed.
+ */
+type RuleModule = any;
+declare const noInVariantRule: RuleModule;
+export default noInVariantRule;
+//# sourceMappingURL=no-in-variant.d.ts.map

package/dist/eslint/rules/no-in-variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-in-variant.d.ts","sourceRoot":"","sources":["../../../src/eslint/rules/no-in-variant.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,KAAK,UAAU,GAAG,GAAG,CAAC;AA6FtB,QAAA,MAAM,eAAe,EAAE,UAoCtB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/eslint/rules/no-in-variant.js

@@ -0,0 +1,126 @@
+/**
+ * ESLint rule: disallow `x in y` where `y` is a GDScript variant primitive
+ * (Vector2, Color, Transform2D, Quaternion, etc.) — the `in` operator is not
+ * valid on these types in GDScript. Container variants (`Array`, `Dictionary`,
+ * `String`, `Packed*Array`, etc.) are explicitly allowed.
+ */
+/**
+ * GDScript variant types that do NOT support the `in` operator.
+ * Container variants like `Array`, `Dictionary`, `String`, `Packed*Array`
+ * and `Range` ARE valid with `in` and are intentionally not in this set.
+ */
+const NON_ITERABLE_VARIANT_TYPES = new Set([
+    'Vector2',
+    'Vector2i',
+    'Vector3',
+    'Vector3i',
+    'Vector4',
+    'Vector4i',
+    'Color',
+    'Rect2',
+    'Rect2i',
+    'Transform2D',
+    'Transform3D',
+    'Basis',
+    'Quaternion',
+    'AABB',
+    'Plane',
+    'Projection',
+    'RID',
+    'Callable',
+    'Signal',
+    'StringName',
+    'NodePath',
+]);
+/**
+ * Attempt to determine whether an AST node's resolved type is a non-iterable
+ * variant primitive. Uses the TS parser services if available (requires
+ * `parserOptions.project` / `projectService` in the ESLint config), otherwise
+ * falls back to syntactic detection on common expression shapes.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function isNonIterableVariant(node, context) {
+    // 1. Syntactic detection — catches literal/static-access patterns without type info.
+    //    `x in Vector2(1, 2)`, `x in new Vector2()`, `x in Vector2.DOWN`
+    const syntacticName = getSyntacticTypeName(node);
+    if (syntacticName && NON_ITERABLE_VARIANT_TYPES.has(syntacticName)) {
+        return true;
+    }
+    // 2. Type-aware detection via @typescript-eslint/parser's parserServices.
+    //    Requires `parserOptions.project: true` in the ESLint config.
+    const services = context.sourceCode?.parserServices ?? context.parserServices;
+    if (!services?.program || !services?.esTreeNodeToTSNodeMap)
+        return false;
+    const tsNode = services.esTreeNodeToTSNodeMap.get(node);
+    if (!tsNode)
+        return false;
+    const checker = services.program.getTypeChecker();
+    const type = checker.getTypeAtLocation(tsNode);
+    const typeText = checker.typeToString(type);
+    // Strip generic parameters and union-with-null markers
+    const bare = typeText
+        .replace(/\s*\|\s*null$/, '')
+        .replace(/\s*\|\s*undefined$/, '')
+        .replace(/<.*>$/, '')
+        .trim();
+    return NON_ITERABLE_VARIANT_TYPES.has(bare);
+}
+/**
+ * Extract a type name from common syntactic expression shapes.
+ * Returns null if the expression doesn't directly reference a known type.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getSyntacticTypeName(node) {
+    if (!node)
+        return null;
+    // `Vector2(1, 2)` — call expression with an Identifier callee
+    if (node.type === 'CallExpression' && node.callee?.type === 'Identifier') {
+        return node.callee.name;
+    }
+    // `new Vector2()` — NewExpression with an Identifier callee
+    if (node.type === 'NewExpression' && node.callee?.type === 'Identifier') {
+        return node.callee.name;
+    }
+    // `Vector2.DOWN` — MemberExpression whose object is an Identifier
+    if (node.type === 'MemberExpression' &&
+        node.object?.type === 'Identifier') {
+        return node.object.name;
+    }
+    return null;
+}
+const noInVariantRule = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow `x in y` when `y` is a GDScript variant primitive ' +
+                '(Vector2, Color, Transform2D, etc.) — the `in` operator is not ' +
+                'supported on these types in GDScript.',
+        },
+        schema: [],
+        messages: {
+            noInVariant: "The `in` operator cannot be used with GDScript variant primitive '{{typeName}}'. " +
+                'Only container types (Array, Dictionary, String, Packed*Array, Range) ' +
+                'support `in` in GDScript.',
+        },
+    },
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    create(context) {
+        return {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            BinaryExpression(node) {
+                if (node.operator !== 'in')
+                    return;
+                if (!isNonIterableVariant(node.right, context))
+                    return;
+                const typeName = getSyntacticTypeName(node.right) ?? 'variant primitive';
+                context.report({
+                    node,
+                    messageId: 'noInVariant',
+                    data: { typeName },
+                });
+            },
+        };
+    },
+};
+export default noInVariantRule;
+//# sourceMappingURL=no-in-variant.js.map

package/dist/eslint/rules/no-in-variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-in-variant.js","sourceRoot":"","sources":["../../../src/eslint/rules/no-in-variant.ts"],"names":[],"mappings":"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"}

package/dist/godot-validate/error-parser.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Godot error output parser and false-positive filtering.
+ */
+export interface GodotRawError {
+    /** Absolute file path */
+    file: string;
+    /** 1-based line number */
+    line: number;
+    /** 0-based column number (often 0 when Godot doesn't report it) */
+    column: number;
+    /** Error type: "Parse Error", "Compile Error", etc. */
+    errorType: string;
+    /** Error message */
+    message: string;
+}
+/**
+ * Collects autoload singleton names from project.godot.
+ * Used to filter false-positive "Identifier not found" errors caused by
+ * Godot bug https://github.com/godotengine/godot/issues/80319
+ * (--check-only --script doesn't load autoloads).
+ */
+export declare function getAutoloadNames(projectRoot: string): Set<string>;
+/**
+ * Returns true if the error is a false positive caused by Godot not loading
+ * autoloads in --check-only mode.
+ */
+export declare function isAutoloadFalsePositive(error: GodotRawError, autoloadNames: Set<string>): boolean;
+/**
+ * Returns true if the error is a false positive caused by validating a
+ * tmp copy of a GD file while the original still exists in the project.
+ * Godot reports: 'Class "Foo" hides a global script class.'
+ *
+ * Suppresses when the file is EITHER:
+ *   - outside `projectRoot` (a temp copy on a different path, e.g. a
+ *     CLI scratch dir under `os.tmpdir()`), OR
+ *   - inside `cacheDir` (the `<cacheDir>/gd-output/…` mirror). The
+ *     cache dir may live under the project tree when the user
+ *     configures it there, so the outside-project check alone doesn't
+ *     catch it.
+ *
+ * `cacheDir` is resolved upfront by the caller from the project's
+ * `tstogd.json` — we don't walk the filesystem per-error.
+ *
+ * Any remaining match is a real conflict between two first-class files
+ * inside the project and must surface to the user.
+ */
+export declare function isDuplicateClassFalsePositive(error: GodotRawError, projectRoot: string, cacheDir?: string): boolean;
+/**
+ * True when `filePath` lives outside `projectRoot` (a temp dir) OR
+ * inside `cacheDir` (the ProjectCache's gd-output mirror). Shared by
+ * the parsed-error filter and the unparsed-output fallback so both
+ * paths agree on what counts as a throwaway mirror.
+ */
+export declare function isUnderScratchDir(filePath: string, projectRoot: string, cacheDir?: string): boolean;
+/**
+ * Resolves a `res://` path to an absolute path relative to the project root.
+ */
+export declare function resolveResPath(resPath: string, projectRoot: string): string;
+/**
+ * Parses Godot CLI stderr output into structured error objects.
+ * Handles multiple known Godot error output formats.
+ */
+export declare function parseGodotErrors(stderr: string, projectRoot: string): GodotRawError[];
+//# sourceMappingURL=error-parser.d.ts.map

package/dist/godot-validate/error-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-parser.d.ts","sourceRoot":"","sources":["../../src/godot-validate/error-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAKjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,OAAO,CAST;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAIT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAYT;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,aAAa,EAAE,CAuFjB"}