typescript-to-gdscript 0.1.0

package/dist/godot-validate/error-parser.js

@@ -0,0 +1,170 @@
+/**
+ * Godot error output parser and false-positive filtering.
+ */
+import { existsSync } from 'fs';
+import { resolve, join, relative, isAbsolute } from 'path';
+import { parseAutoloads } from "../typings/scenes.js";
+// ─── Autoload Error Filtering ────────────────────────────────
+/**
+ * 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 function getAutoloadNames(projectRoot) {
+    const projectFile = join(projectRoot, 'project.godot');
+    if (!existsSync(projectFile))
+        return new Set();
+    const autoloads = parseAutoloads(projectFile);
+    return new Set(autoloads.map((a) => a.name));
+}
+/**
+ * Returns true if the error is a false positive caused by Godot not loading
+ * autoloads in --check-only mode.
+ */
+export function isAutoloadFalsePositive(error, autoloadNames) {
+    if (autoloadNames.size === 0)
+        return false;
+    // Format 1: "Identifier not found: GameManager"
+    // Format 2: "Identifier "Globals" not declared in the current scope."
+    const match1 = error.message.match(/^Identifier not found: (\w+)/);
+    if (match1 && autoloadNames.has(match1[1]))
+        return true;
+    const match2 = error.message.match(/^Identifier "(\w+)" not declared/);
+    if (match2 && autoloadNames.has(match2[1]))
+        return true;
+    return false;
+}
+/**
+ * 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 function isDuplicateClassFalsePositive(error, projectRoot, cacheDir) {
+    if (!/^Class ".*" hides a global script class/.test(error.message))
+        return false;
+    return isUnderScratchDir(error.file, projectRoot, cacheDir);
+}
+/**
+ * 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 function isUnderScratchDir(filePath, projectRoot, cacheDir) {
+    // Outside-project check. On Windows, `relative()` returns an
+    // absolute path when the two paths are on different drives.
+    const relProj = relative(projectRoot, filePath);
+    if (relProj.startsWith('..') || isAbsolute(relProj))
+        return true;
+    // Inside the configured cache dir (if any).
+    if (cacheDir) {
+        const relCache = relative(cacheDir, filePath);
+        if (relCache === '')
+            return true;
+        if (!relCache.startsWith('..') && !isAbsolute(relCache))
+            return true;
+    }
+    return false;
+}
+// ─── Error Parsing ───────────────────────────────────────────
+/**
+ * Resolves a `res://` path to an absolute path relative to the project root.
+ */
+export function resolveResPath(resPath, projectRoot) {
+    // res://scripts/player.gd -> scripts/player.gd
+    const rel = resPath.replace(/^res:\/\//, '');
+    return resolve(projectRoot, rel);
+}
+/**
+ * Parses Godot CLI stderr output into structured error objects.
+ * Handles multiple known Godot error output formats.
+ */
+export function parseGodotErrors(stderr, projectRoot) {
+    const errors = [];
+    const lines = stderr.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Format 1: "res://path.gd:15 - Parse Error: message"
+        // Format 1b: "res://path.gd:15:3 - Parse Error: message"
+        const resMatch = line.match(/^\s*res:\/\/(.+?):(\d+)(?::(\d+))?\s*-\s*((?:Parse|Compile|Script)\s+Error):\s*(.+)$/);
+        if (resMatch) {
+            errors.push({
+                file: resolveResPath('res://' + resMatch[1], projectRoot),
+                line: parseInt(resMatch[2], 10),
+                column: resMatch[3] ? parseInt(resMatch[3], 10) : 0,
+                errorType: resMatch[4],
+                message: resMatch[5].trim(),
+            });
+            continue;
+        }
+        // Format 2: "SCRIPT ERROR: Parse Error: message"
+        // followed by "   at: res://path.gd:15" or "   at: GDScript::reload (res://path.gd:15)"
+        const scriptErrorMatch = line.match(/^\s*SCRIPT ERROR:\s*((?:Parse|Compile|Script)\s+Error):\s*(.+)$/);
+        if (scriptErrorMatch) {
+            const nextLine = lines[i + 1];
+            if (nextLine) {
+                // Match "at: res://file.gd:15" and "at: GDScript::reload (res://file.gd:15)"
+                const atMatch = nextLine.match(/^\s*at:\s*(?:\S+\s+\()?res:\/\/(.+?):(\d+)(?::(\d+))?\)?/);
+                if (atMatch) {
+                    errors.push({
+                        file: resolveResPath('res://' + atMatch[1], projectRoot),
+                        line: parseInt(atMatch[2], 10),
+                        column: atMatch[3] ? parseInt(atMatch[3], 10) : 0,
+                        errorType: scriptErrorMatch[1],
+                        message: scriptErrorMatch[2].trim(),
+                    });
+                    i++; // Skip the "at:" line
+                    continue;
+                }
+                // Match absolute path: "at: GDScript::reload (C:\path\file.gd:15)" or "at: C:\path\file.gd:15"
+                const atAbsMatch = nextLine.match(/^\s*at:\s*(?:\S+\s+\()?(.+\.gd):(\d+)(?::(\d+))?\)?/);
+                if (atAbsMatch) {
+                    errors.push({
+                        file: resolve(atAbsMatch[1]),
+                        line: parseInt(atAbsMatch[2], 10),
+                        column: atAbsMatch[3] ? parseInt(atAbsMatch[3], 10) : 0,
+                        errorType: scriptErrorMatch[1],
+                        message: scriptErrorMatch[2].trim(),
+                    });
+                    i++; // Skip the "at:" line
+                    continue;
+                }
+            }
+        }
+        // Skip generic "ERROR: Failed to load script" lines (not actionable, follows SCRIPT ERROR)
+        if (/^\s*ERROR:\s*Failed to load script/.test(line)) {
+            // Also skip the following "at:" line
+            if (lines[i + 1] && /^\s*at:/.test(lines[i + 1]))
+                i++;
+            continue;
+        }
+        // Format 3: Absolute/relative path "path/file.gd:15 - Parse Error: message"
+        const absMatch = line.match(/^\s*(.+\.gd):(\d+)(?::(\d+))?\s*-\s*((?:Parse|Compile|Script)\s+Error):\s*(.+)$/);
+        if (absMatch) {
+            errors.push({
+                file: resolve(projectRoot, absMatch[1]),
+                line: parseInt(absMatch[2], 10),
+                column: absMatch[3] ? parseInt(absMatch[3], 10) : 0,
+                errorType: absMatch[4],
+                message: absMatch[5].trim(),
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=error-parser.js.map

package/dist/godot-validate/error-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-parser.js","sourceRoot":"","sources":["../../src/godot-validate/error-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiBtD,gEAAgE;AAEhE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9C,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAoB,EACpB,aAA0B;IAE1B,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,gDAAgD;IAChD,sEAAsE;IACtE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACnE,IAAI,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACvE,IAAI,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAoB,EACpB,WAAmB,EACnB,QAAiB;IAEjB,IAAI,CAAC,yCAAyC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,WAAmB,EACnB,QAAiB;IAEjB,6DAA6D;IAC7D,4DAA4D;IAC5D,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,4CAA4C;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,IAAI,QAAQ,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gEAAgE;AAEhE;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,WAAmB;IACjE,+CAA+C;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,WAAmB;IAEnB,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAEvB,sDAAsD;QACtD,yDAAyD;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,sFAAsF,CACvF,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,cAAc,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAE,EAAE,WAAW,CAAC;gBAC1D,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;gBAChC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpD,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAE;gBACvB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE;aAC7B,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,iDAAiD;QACjD,wFAAwF;QACxF,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CACjC,iEAAiE,CAClE,CAAC;QACF,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,QAAQ,EAAE,CAAC;gBACb,6EAA6E;gBAC7E,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAC5B,0DAA0D,CAC3D,CAAC;gBACF,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,cAAc,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAE,EAAE,WAAW,CAAC;wBACzD,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;wBAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;wBAClD,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAE;wBAC/B,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE;qBACrC,CAAC,CAAC;oBACH,CAAC,EAAE,CAAC,CAAC,sBAAsB;oBAC3B,SAAS;gBACX,CAAC;gBACD,+FAA+F;gBAC/F,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAC/B,qDAAqD,CACtD,CAAC;gBACF,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;wBAC7B,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;wBAClC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;wBACxD,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAE;wBAC/B,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE;qBACrC,CAAC,CAAC;oBACH,CAAC,EAAE,CAAC,CAAC,sBAAsB;oBAC3B,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAED,2FAA2F;QAC3F,IAAI,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,qCAAqC;YACrC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;gBAAE,CAAC,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QAED,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,iFAAiF,CAClF,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC;gBACxC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;gBAChC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpD,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAE;gBACvB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/godot-validate/index.d.ts

@@ -0,0 +1,76 @@
+import type { TransformDiagnostic } from '../converter/common/index.ts';
+export { parseGodotErrors, getAutoloadNames, isAutoloadFalsePositive, isDuplicateClassFalsePositive, isUnderScratchDir, } from './error-parser.ts';
+export type { GodotRawError } from './error-parser.ts';
+export { remapError, remapErrorSync } from './source-map-remap.ts';
+export interface GodotValidateOptions {
+    /**
+     * .gd files to validate. Pass a bare `string` to validate without
+     * source-map remapping, or the object form to supply the `.gd.map`
+     * JSON + original `.ts` path so diagnostics come back anchored at
+     * the TypeScript positions.
+     */
+    gdFiles: Array<string | {
+        path: string;
+        sourceMapJson?: string;
+        tsFilePath?: string;
+    }>;
+    /** Godot project root (must contain project.godot) */
+    projectRoot: string;
+    /** Path to Godot executable */
+    godotPath: string;
+    /**
+     * Optional abort signal. When aborted, the in-flight Godot process
+     * is killed and the function returns immediately with whatever
+     * diagnostics had been collected so far (typically none). The
+     * remaining files in the batch, output parsing, and source-map
+     * remapping are all skipped — useful for callers that supersede
+     * their own requests (e.g. the ts-plugin firing a fresh validation
+     * on every keystroke).
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional `ProjectCache` directory. Any diagnostic pointing at a
+     * file inside here is treated as a throwaway mirror (the cache's
+     * `gd-output/<…>.gd`) and Godot's `Class "X" hides a global script
+     * class.` error for such files is suppressed — the real file is
+     * what's already registered in the project. Callers that already
+     * have a `ResolvedConfig` should pass `cfg.cacheDir`; otherwise
+     * leave unset.
+     */
+    cacheDir?: string;
+}
+export interface GodotValidateResult {
+    /** All diagnostics, remapped to TS positions where source maps exist */
+    diagnostics: TransformDiagnostic[];
+    /** Whether Godot executable was found and ran */
+    godotAvailable: boolean;
+}
+/**
+ * Validates GDScript files using the Godot CLI and remaps errors
+ * back to TypeScript positions via source maps.
+ */
+export declare function validateGdFiles(options: GodotValidateOptions): Promise<GodotValidateResult>;
+export interface GodotValidateProjectOptions {
+    projectRoot: string;
+    godotPath: string;
+    /** Only report errors for .gd files whose resolved path starts with this dir. */
+    gdDir: string;
+    /**
+     * Source map table for remapping .gd errors back to .ts positions.
+     * Key: normalized absolute .gd file path.
+     * Value: { sourceMapJson, tsFilePath } — both optional.
+     */
+    sourceMapTable: Map<string, {
+        sourceMapJson?: string;
+        tsFilePath?: string;
+    }>;
+    cacheDir?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Run `godot --headless --check-only --path PROJECT` (no --script) to validate
+ * the entire project at once. Errors are filtered to files under `gdDir` and
+ * remapped to TypeScript positions via the provided source-map table.
+ */
+export declare function validateGdProject(options: GodotValidateProjectOptions): Promise<GodotValidateResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/godot-validate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/godot-validate/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAYxE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMnE,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,OAAO,EAAE,KAAK,CACZ,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CACvE,CAAC;IACF,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;CACzB;AAID;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA0K9B;AAID,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CA2H9B"}

package/dist/godot-validate/index.js

@@ -0,0 +1,267 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { existsSync } from 'fs';
+import { resolve, relative, normalize } from 'path';
+import { parseGodotErrors, getAutoloadNames, isAutoloadFalsePositive, isDuplicateClassFalsePositive, isUnderScratchDir, } from "./error-parser.js";
+import { remapError, remapErrorSync } from "./source-map-remap.js";
+// Re-export everything that external consumers need
+export { parseGodotErrors, getAutoloadNames, isAutoloadFalsePositive, isDuplicateClassFalsePositive, isUnderScratchDir, } from "./error-parser.js";
+export { remapError, remapErrorSync } from "./source-map-remap.js";
+const execFileAsync = promisify(execFile);
+// ─── Main Validation ─────────────────────────────────────────
+/**
+ * Validates GDScript files using the Godot CLI and remaps errors
+ * back to TypeScript positions via source maps.
+ */
+export async function validateGdFiles(options) {
+    const { signal } = options;
+    // If the caller aborted before we even started, bail immediately —
+    // no point probing Godot.
+    if (signal?.aborted) {
+        return { diagnostics: [], godotAvailable: true };
+    }
+    // Check Godot availability. The headless args are mandatory: on Windows,
+    // a bare `godot --version` pops the "couldn't detect mode" GUI dialog
+    // because Godot briefly initializes its display server before reading
+    // the `--version` argument.
+    try {
+        await execFileAsync(options.godotPath, ['--headless', '--version'], {
+            timeout: 10000,
+            signal,
+        });
+    }
+    catch {
+        // Abort during the --version probe: treat like a no-op, caller's
+        // signal.aborted check will gate downstream work.
+        if (signal?.aborted) {
+            return { diagnostics: [], godotAvailable: true };
+        }
+        return {
+            diagnostics: [
+                {
+                    message: `Godot executable not found at "${options.godotPath}". ` +
+                        'Set --godot-path, godotPath in tstogd.json, or GODOT_PATH env variable.',
+                    severity: 'warning',
+                    file: '',
+                    line: 0,
+                    column: 0,
+                },
+            ],
+            godotAvailable: false,
+        };
+    }
+    // Collect autoload names to filter false-positive errors (Godot bug #80319)
+    const autoloadNames = getAutoloadNames(options.projectRoot);
+    // `cacheDir` (if supplied) marks the `ProjectCache` gd-output mirror
+    // — diagnostics from files under there are treated as scratch, not
+    // real project files. Callers that don't have a resolved config
+    // simply pass nothing and the outside-project heuristic handles it.
+    const { cacheDir } = options;
+    const allDiagnostics = [];
+    for (const gdFileEntry of options.gdFiles) {
+        // Stop between iterations as well — don't keep validating the
+        // remaining batch once the caller has moved on.
+        if (signal?.aborted)
+            return { diagnostics: [], godotAvailable: true };
+        const gdFile = typeof gdFileEntry === 'string' ? gdFileEntry : gdFileEntry.path;
+        const sourceMapJson = typeof gdFileEntry === 'string' ? undefined : gdFileEntry.sourceMapJson;
+        const tsFilePath = typeof gdFileEntry === 'string' ? undefined : gdFileEntry.tsFilePath;
+        const resolvedFile = resolve(gdFile);
+        if (!existsSync(resolvedFile)) {
+            allDiagnostics.push({
+                message: `GDScript file not found: ${resolvedFile}`,
+                severity: 'error',
+                file: resolvedFile,
+                line: 0,
+                column: 0,
+            });
+            continue;
+        }
+        // Convert to res:// path for Godot CLI
+        const relToProject = relative(options.projectRoot, resolvedFile).replace(/\\/g, '/');
+        const resPath = `res://${relToProject}`;
+        try {
+            await execFileAsync(options.godotPath, [
+                '--headless',
+                '--check-only',
+                '--path',
+                options.projectRoot,
+                '--script',
+                resPath,
+            ], {
+                timeout: 30000,
+                cwd: options.projectRoot,
+                signal,
+            });
+            // Exit code 0 = no errors
+        }
+        catch (err) {
+            // The exec was aborted (caller superseded this request) — drop
+            // everything we might have started and return immediately. No
+            // output parsing, no source-map remapping, no further files.
+            if (signal?.aborted) {
+                return { diagnostics: [], godotAvailable: true };
+            }
+            const stderr = err.stderr ?? '';
+            const stdout = err.stdout ?? '';
+            const output = stderr + '\n' + stdout;
+            let rawErrors = parseGodotErrors(output, options.projectRoot);
+            // Filter false-positive errors
+            rawErrors = rawErrors.filter((e) => !isAutoloadFalsePositive(e, autoloadNames) &&
+                !isDuplicateClassFalsePositive(e, options.projectRoot, cacheDir));
+            if (rawErrors.length === 0 && output.trim()) {
+                // Unparsed error output -- report first meaningful line
+                // But first check if it's a known false positive
+                let isFalsePositive = false;
+                if (autoloadNames.size > 0) {
+                    for (const autoloadName of autoloadNames) {
+                        if (output.includes('Identifier not found: ' + autoloadName) ||
+                            output.includes('Identifier "' + autoloadName + '" not declared')) {
+                            isFalsePositive = true;
+                            break;
+                        }
+                    }
+                }
+                const isTmpFile = isUnderScratchDir(resolvedFile, options.projectRoot, cacheDir);
+                if (!isFalsePositive &&
+                    isTmpFile &&
+                    /Class ".*" hides a global script class/.test(output)) {
+                    isFalsePositive = true;
+                }
+                if (!isFalsePositive) {
+                    const firstLine = output
+                        .trim()
+                        .split('\n')
+                        .find((l) => l.trim().length > 0);
+                    if (firstLine) {
+                        allDiagnostics.push({
+                            message: `[Godot] ${firstLine.trim()}`,
+                            severity: 'error',
+                            file: resolvedFile,
+                            line: 0,
+                            column: 0,
+                        });
+                    }
+                }
+            }
+            for (const rawError of rawErrors) {
+                const diag = await remapError(rawError, sourceMapJson, tsFilePath);
+                allDiagnostics.push(diag);
+            }
+        }
+    }
+    return { diagnostics: allDiagnostics, godotAvailable: true };
+}
+/**
+ * Run `godot --headless --check-only --path PROJECT` (no --script) to validate
+ * the entire project at once. Errors are filtered to files under `gdDir` and
+ * remapped to TypeScript positions via the provided source-map table.
+ */
+export async function validateGdProject(options) {
+    const { signal } = options;
+    if (signal?.aborted)
+        return { diagnostics: [], godotAvailable: true };
+    // Skip if projectRoot is not a valid Godot project — surface a warning so
+    // misconfigured setups don't think their lint is silently passing.
+    if (!existsSync(resolve(options.projectRoot, 'project.godot'))) {
+        return {
+            diagnostics: [
+                {
+                    message: `Godot project root has no project.godot ("${options.projectRoot}"). ` +
+                        'Pass --project-root pointing at the directory that contains project.godot ' +
+                        'to enable Godot validation.',
+                    severity: 'warning',
+                    file: '',
+                    line: 0,
+                    column: 0,
+                },
+            ],
+            godotAvailable: true,
+        };
+    }
+    try {
+        // See note above on the headless args — needed to suppress the GUI
+        // mode-detection dialog on Windows.
+        await execFileAsync(options.godotPath, ['--headless', '--version'], {
+            timeout: 10000,
+            signal,
+        });
+    }
+    catch {
+        if (signal?.aborted)
+            return { diagnostics: [], godotAvailable: true };
+        return {
+            diagnostics: [
+                {
+                    message: `Godot executable not found at "${options.godotPath}". ` +
+                        'Set --godot-path, godotPath in tstogd.json, or GODOT_PATH env variable.',
+                    severity: 'warning',
+                    file: '',
+                    line: 0,
+                    column: 0,
+                },
+            ],
+            godotAvailable: false,
+        };
+    }
+    if (signal?.aborted)
+        return { diagnostics: [], godotAvailable: true };
+    const autoloadNames = getAutoloadNames(options.projectRoot);
+    const { cacheDir } = options;
+    const resolvedGdDir = normalize(resolve(options.gdDir));
+    // `--check-only` without `--script` enters the SceneTree main loop with
+    // no script to call quit(), so on Windows it hangs forever. `--quit-after 1`
+    // forces Godot to quit after one main-loop tick — all scripts have already
+    // been parsed by then, so syntax errors still surface in the output.
+    //
+    // IMPORTANT: with `--quit-after 1`, Godot exits with code 0 even when
+    // there are script errors (the quit succeeded, that's all `--quit-after`
+    // tracks). So we MUST always parse stdout+stderr — never short-circuit
+    // on a successful exit.
+    let output;
+    try {
+        const result = await execFileAsync(options.godotPath, [
+            '--headless',
+            '--check-only',
+            '--path',
+            options.projectRoot,
+            '--quit-after',
+            '1',
+        ], {
+            timeout: 60000,
+            cwd: options.projectRoot,
+            signal,
+            windowsHide: true,
+            maxBuffer: 50 * 1024 * 1024,
+        });
+        output = (result.stderr ?? '') + '\n' + (result.stdout ?? '');
+    }
+    catch (err) {
+        if (signal?.aborted)
+            return { diagnostics: [], godotAvailable: true };
+        const stderr = err.stderr ?? '';
+        const stdout = err.stdout ?? '';
+        output = stderr + '\n' + stdout;
+    }
+    // Exit code 0 with no parseable errors → all good.
+    if (!output.trim())
+        return { diagnostics: [], godotAvailable: true };
+    let rawErrors = parseGodotErrors(output, options.projectRoot);
+    rawErrors = rawErrors.filter((e) => !isAutoloadFalsePositive(e, autoloadNames) &&
+        !isDuplicateClassFalsePositive(e, options.projectRoot, cacheDir));
+    // Filter to errors under gdDir only
+    rawErrors = rawErrors.filter((e) => {
+        if (!e.file)
+            return false;
+        return normalize(resolve(e.file)).startsWith(resolvedGdDir);
+    });
+    const allDiagnostics = [];
+    for (const rawError of rawErrors) {
+        const resolvedGd = normalize(resolve(rawError.file));
+        const entry = options.sourceMapTable.get(resolvedGd);
+        const diag = await remapError(rawError, entry?.sourceMapJson, entry?.tsFilePath);
+        allDiagnostics.push(diag);
+    }
+    return { diagnostics: allDiagnostics, godotAvailable: true };
+}
+//# sourceMappingURL=index.js.map

package/dist/godot-validate/index.js.map

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

package/dist/godot-validate/source-map-remap.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Source map remapping for Godot validation errors.
+ * Maps GDScript error positions back to TypeScript source positions.
+ */
+import type { TransformDiagnostic } from '../converter/common/index.ts';
+import type { GodotRawError } from './error-parser.ts';
+/**
+ * Remaps a Godot error from GDScript positions to TypeScript positions.
+ *
+ * Source-map input priority:
+ *   1. `sourceMapJson` parameter (inline — preferred: caller already has
+ *      the JSON in memory, e.g. straight from a converter run or a
+ *      `ProjectCache` entry — no disk read needed).
+ *   2. `<error.file>.map` sidecar on disk (fallback for callers that
+ *      only point at the `.gd`).
+ *
+ * When `tsFilePath` is provided, it overrides the resolved source path
+ * from the source map — useful when the map's `sources` entry is
+ * relative to a throwaway location (e.g. a cache/scratch dir) but we
+ * already know the real `.ts` we're validating.
+ *
+ * Falls back to GD positions if no source map is available.
+ */
+export declare function remapError(error: GodotRawError, sourceMapJson?: string, tsFilePath?: string): Promise<TransformDiagnostic>;
+export declare const VLQ_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+export declare function decodeVlq(encoded: string): number[];
+interface LineMapping {
+    generatedLine: number;
+    generatedColumn: number;
+    originalLine: number;
+    originalColumn: number;
+    sourceIndex: number;
+}
+/**
+ * Parses source map JSON mappings into a flat array of line mappings.
+ * Lightweight sync alternative to SourceMapConsumer.
+ */
+export declare function parseSourceMapMappings(rawMap: string): {
+    mappings: LineMapping[];
+    sources: string[];
+};
+/**
+ * Synchronously remaps a Godot error using a pre-loaded source map JSON string.
+ * Falls back to GD position if remapping fails.
+ */
+export declare function remapErrorSync(error: GodotRawError, sourceMapJson?: string, tsFilePath?: string): TransformDiagnostic;
+export {};
+//# sourceMappingURL=source-map-remap.d.ts.map

package/dist/godot-validate/source-map-remap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-map-remap.d.ts","sourceRoot":"","sources":["../../src/godot-validate/source-map-remap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA2E9B;AAID,eAAO,MAAM,SAAS,qEAC8C,CAAC;AAErE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBnD;AAED,UAAU,WAAW;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG;IACtD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAqCA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,mBAAmB,CAmCrB"}