godot-cli 0.37.0 → 0.39.0

package/dist/lib/export-project.js

@@ -0,0 +1,159 @@
+// `exportProject`: `godot --headless --export-release|--export-debug|--export-pack <preset> <output>`. Godot can exit 0
+// without writing anything, so the export templates are checked first and the output file afterwards. Library-safe.
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { spawnSync } from 'child_process';
+import { parseGodotLog } from './godot-log.js';
+import { engineRan, headlessFailure, stoppedRun, notStarted, remainingMs, prepareHeadless, runGodotStep, } from './headless.js';
+/** Log errors that mean the export itself failed (other engine errors, e.g. a plugin's runtime noise, do not). */
+const EXPORT_ERROR_RE = /export|solution file|publish|template|cannot save|failed to (?:save|write|open|copy)/i;
+/** The `[preset.N]` sections of export_presets.cfg. */
+export function readExportPresets(projectPath) {
+    let text;
+    try {
+        text = fs.readFileSync(path.join(projectPath, 'export_presets.cfg'), 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const presets = [];
+    let current;
+    let inOptions = false;
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        const section = /^\[preset\.(\d+)(\.options)?\]$/.exec(line);
+        if (section) {
+            inOptions = section[2] !== undefined;
+            if (!inOptions) {
+                current = { name: '', platform: '', customTemplateDebug: '', customTemplateRelease: '' };
+                presets.push(current);
+            }
+            continue;
+        }
+        if (line.startsWith('[')) {
+            inOptions = false;
+            continue;
+        }
+        const kv = /^([\w/]+)\s*=\s*"(.*)"$/.exec(line);
+        if (!kv || !current)
+            continue;
+        const [, key, value] = kv;
+        if (!inOptions && key === 'name')
+            current.name = value;
+        else if (!inOptions && key === 'platform')
+            current.platform = value;
+        else if (inOptions && key === 'custom_template/debug')
+            current.customTemplateDebug = value;
+        else if (inOptions && key === 'custom_template/release')
+            current.customTemplateRelease = value;
+    }
+    return presets;
+}
+/** Export templates folder name for a `--version` string: `4.5.1.stable.mono.official.f62fdbde1` → `4.5.1.stable.mono`. */
+export function templatesVersionDir(version) {
+    const parts = version.trim().split('.');
+    const status = parts.findIndex((p) => /^(stable|dev\d*|alpha\d*|beta\d*|rc\d*)$/.test(p));
+    if (status < 0)
+        return version.trim();
+    return parts.slice(0, status + 1 + (parts[status + 1] === 'mono' ? 1 : 0)).join('.');
+}
+/** Godot's export templates root for this OS (or the self-contained `editor_data` next to the binary). */
+export function templatesRoot(binary, platform = process.platform) {
+    const binDir = path.dirname(binary);
+    if (fs.existsSync(path.join(binDir, '._sc_')) || fs.existsSync(path.join(binDir, '_sc_'))) {
+        return path.join(binDir, 'editor_data', 'export_templates');
+    }
+    const home = os.homedir();
+    if (platform === 'win32')
+        return path.join(process.env.APPDATA ?? path.join(home, 'AppData', 'Roaming'), 'Godot', 'export_templates');
+    if (platform === 'darwin')
+        return path.join(home, 'Library', 'Application Support', 'Godot', 'export_templates');
+    return path.join(process.env.XDG_DATA_HOME ?? path.join(home, '.local', 'share'), 'godot', 'export_templates');
+}
+/**
+ * The editor's version: `--version` (stdout; a GUI build may print nothing to a pipe), else the official file name
+ * (`Godot_v4.5.1-stable_mono_win64.exe` → `4.5.1.stable.mono`).
+ */
+export function godotVersion(binary, timeoutMs) {
+    const run = spawnSync(binary, ['--version'], { encoding: 'utf-8', timeout: Math.max(1, Math.min(30000, timeoutMs)), windowsHide: true });
+    const line = (run.stdout ?? '').split(/\r?\n/).map((l) => l.trim()).find((l) => /^\d+\.\d+/.test(l));
+    return line ?? versionFromFileName(path.basename(binary));
+}
+export function versionFromFileName(name) {
+    const m = /^godot_v(\d+\.\d+(?:\.\d+)?)-(stable|dev\d*|alpha\d*|beta\d*|rc\d*)(_mono)?/i.exec(name);
+    return m ? `${m[1]}.${m[2]}${m[3] ? '.mono' : ''}` : undefined;
+}
+export async function exportProject(options) {
+    const ctx = prepareHeadless(options);
+    if (ctx.kind === 'failure')
+        return ctx;
+    const mode = options.mode ?? 'release';
+    const output = path.resolve(options.output);
+    const report = { projectPath: ctx.projectPath, preset: options.preset, mode, output, steps: ctx.steps, diagnostics: [] };
+    const fail = (failure) => ({ ...failure, ...report });
+    const presets = readExportPresets(ctx.projectPath);
+    const preset = presets.find((p) => p.name === options.preset);
+    if (!preset) {
+        const known = presets.map((p) => `"${p.name}"`).join(', ');
+        return fail(headlessFailure('not-found', `No export preset named "${options.preset}" in export_presets.cfg${known ? ` (presets: ${known})` : ' (the file is missing or has no presets)'}.`));
+    }
+    // A .pck/.zip pack needs no templates; a preset with its own template file does not use the installed ones.
+    const custom = mode === 'debug' ? preset.customTemplateDebug : preset.customTemplateRelease;
+    if (mode !== 'pack' && custom === '') {
+        const version = options.godotVersion ?? godotVersion(ctx.binary, remainingMs(ctx));
+        if (!version)
+            return fail(headlessFailure('export-failed', `Could not read the Godot version (${ctx.binary} --version).`));
+        const versionDir = templatesVersionDir(version);
+        const dir = path.join(templatesRoot(ctx.binary), versionDir);
+        report.templatesDir = dir;
+        let installed = false;
+        try {
+            installed = fs.readdirSync(dir).length > 0;
+        }
+        catch {
+            installed = false;
+        }
+        if (!installed) {
+            return fail(headlessFailure('not-found', `Export templates for Godot ${versionDir} are not installed (expected in ${dir}). Install them from the editor (Editor > Manage Export Templates) or download the .tpz from godotengine.org.`));
+        }
+    }
+    else if (custom !== '' && mode !== 'pack' && !fs.existsSync(custom)) {
+        return fail(headlessFailure('not-found', `The preset's custom ${mode} template does not exist: ${custom}`));
+    }
+    fs.mkdirSync(path.dirname(output), { recursive: true });
+    const startedAt = Date.now();
+    options.onProgress?.(`Exporting "${options.preset}" (${mode}) to ${output}...`);
+    const run = await runGodotStep(ctx, 'export', [`--export-${mode}`, options.preset, output]);
+    report.diagnostics = parseGodotLog(run.output).filter((d) => d.severity === 'error');
+    const stopped = stoppedRun(run, 'The export');
+    if (stopped)
+        return fail(stopped);
+    if (!engineRan(run))
+        return fail(notStarted('export-failed', run));
+    let stat;
+    try {
+        stat = fs.statSync(output);
+    }
+    catch {
+        stat = undefined;
+    }
+    // Allow for coarse file-system timestamps when deciding the file is this run's.
+    // A macOS export is an .app folder.
+    if (!stat || !(stat.isFile() || stat.isDirectory()) || (stat.isFile() && stat.size === 0) || stat.mtimeMs < startedAt - 2000) {
+        const detail = report.diagnostics[0]?.message;
+        return fail(headlessFailure('export-failed', `The export produced no output file at ${output} (exit ${run.exitCode})${detail ? `: ${detail}` : ''}.`));
+    }
+    if (stat.isFile())
+        report.sizeBytes = stat.size;
+    // Godot writes the executable and the .pck even when a step failed (e.g. the C# publish: no .sln) and exits 0.
+    const exportErrors = report.diagnostics.filter((d) => (d.source === 'gdscript' && d.phase === 'load') || EXPORT_ERROR_RE.test(d.message));
+    if (exportErrors.length > 0) {
+        report.diagnostics = exportErrors;
+        return fail(headlessFailure('export-failed', `The export logged ${exportErrors.length} error(s): ${exportErrors[0].message}`));
+    }
+    if (run.exitCode !== 0)
+        return fail(headlessFailure('export-failed', `Godot exited with code ${run.exitCode} during the export.`));
+    return { kind: 'success', success: true, ...report };
+}
+//# sourceMappingURL=export-project.js.map

package/dist/lib/export-project.js.map

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

package/dist/lib/godot-log.d.ts

@@ -0,0 +1,38 @@
+export type DiagnosticSeverity = 'error' | 'warning';
+/** `gdscript`: GDScript parse/load errors; `csharp`: compiler diagnostics; `engine`: any other engine line. */
+export type DiagnosticSource = 'gdscript' | 'csharp' | 'engine';
+export interface Diagnostic {
+    severity: DiagnosticSeverity;
+    source: DiagnosticSource;
+    message: string;
+    /** `res://…` for Godot lines, the file path MSBuild printed for C#. */
+    file?: string;
+    line?: number;
+    column?: number;
+    /** Compiler code, e.g. `CS1002`. */
+    code?: string;
+    /** `load`: the script did not parse/compile/load; `runtime`: it loaded and then reported an error. */
+    phase?: 'load' | 'runtime';
+}
+/** The first line every Godot run prints: proof the engine started at all. */
+export declare const GODOT_BANNER_RE: RegExp;
+/** Printed by the Godot-MCP addon when its EditorPlugin entered the editor. */
+export declare const ADDON_LOADED_MARKER = "[Godot-MCP] plugin loaded";
+/** Marker prefix of the scripts godot-cli runs inside Godot (`check`). */
+export declare const CLI_MARKER = "[godot-cli] ";
+export declare function stripAnsi(text: string): string;
+/**
+ * Diagnostics in a Godot log: `SCRIPT ERROR:` (GDScript parse/compile, with `res://file:line` from the following
+ * `at:` line; "Warning treated as error" rows become warnings), `ERROR:` / `WARNING:` lines. Engine errors that mean a
+ * script or addon failed to load are `gdscript` errors; other engine errors are `engine` and do not fail a run.
+ */
+export declare function parseGodotLog(text: string): Diagnostic[];
+/**
+ * Diagnostics in `dotnet build` output: `file(line,col): error CS1002: … [proj]` and unlocated
+ * `MSBUILD : error MSB1009: …`. MSBuild repeats each one in its summary; duplicates are dropped.
+ */
+export declare function parseMsbuildOutput(text: string): Diagnostic[];
+/** `file:line: error: message` (C#: `file(line,col): error CS0000: message`). */
+export declare function formatDiagnostic(d: Diagnostic): string;
+/** The lines of `text` that start with the godot-cli marker, without it. */
+export declare function cliMarkerLines(text: string): string[];

package/dist/lib/godot-log.js

@@ -0,0 +1,145 @@
+// Godot / MSBuild log parsing. Godot's headless exit code is not a verdict (a GDScript parse error during --import, or an
+// addon that fails to load, still exits 0), so the headless commands judge a run from its log: error lines, markers
+// the run must print, and the report files it writes. Pure functions, no I/O.
+/** The first line every Godot run prints: proof the engine started at all. */
+export const GODOT_BANNER_RE = /^Godot Engine v\d+\.\d+/m;
+/** Printed by the Godot-MCP addon when its EditorPlugin entered the editor. */
+export const ADDON_LOADED_MARKER = '[Godot-MCP] plugin loaded';
+/** Marker prefix of the scripts godot-cli runs inside Godot (`check`). */
+export const CLI_MARKER = '[godot-cli] ';
+// eslint-disable-next-line no-control-regex
+const ANSI_RE = /\x1B\[[0-9;]*[A-Za-z]/g;
+export function stripAnsi(text) {
+    return text.replace(ANSI_RE, '');
+}
+const HEADER_RE = /^(USER SCRIPT ERROR|USER ERROR|USER WARNING|SCRIPT ERROR|SCRIPT WARNING|ERROR|WARNING): (.*)$/;
+const AT_RE = /^\s+at: .*?\(((?:res|user):\/\/[^():]+|[A-Za-z]:[\\/][^():]+|\/[^():]+):(\d+)\)\s*$/;
+const WARNING_AS_ERROR = '(Warning treated as error.)';
+const FAILED_LOAD_RE = /Failed to load script "([^"]+)"/;
+/** Engine errors that mean a script or an addon did not load (the rest are runtime noise). */
+const LOAD_FAILURE_RE = /Failed to load script|Unable to load addon script|Cannot load (?:C#|GDScript)|Failed to instantiate|Could not find type|Unable to load \.NET|\.NET: Failed/i;
+/**
+ * Diagnostics in a Godot log: `SCRIPT ERROR:` (GDScript parse/compile, with `res://file:line` from the following
+ * `at:` line; "Warning treated as error" rows become warnings), `ERROR:` / `WARNING:` lines. Engine errors that mean a
+ * script or addon failed to load are `gdscript` errors; other engine errors are `engine` and do not fail a run.
+ */
+export function parseGodotLog(text) {
+    const lines = stripAnsi(text).split(/\r?\n/);
+    const diagnostics = [];
+    // Files a SCRIPT ERROR row already reported (with its line): their "Failed to load script" follow-up is dropped.
+    const reportedFiles = new Set();
+    for (let i = 0; i < lines.length; i++) {
+        const header = HEADER_RE.exec(lines[i]);
+        if (!header)
+            continue;
+        const kind = header[1];
+        let message = header[2].trim();
+        let file;
+        let line;
+        const at = i + 1 < lines.length ? AT_RE.exec(lines[i + 1]) : null;
+        if (at) {
+            file = at[1];
+            line = Number(at[2]);
+        }
+        if (kind === 'SCRIPT ERROR' || kind === 'USER SCRIPT ERROR') {
+            const asWarning = message.endsWith(WARNING_AS_ERROR);
+            if (asWarning)
+                message = message.slice(0, -WARNING_AS_ERROR.length).trim();
+            const loadError = /^(Parse|Compile) Error: /.test(message);
+            message = message.replace(/^(Parse|Compile) Error: /, '');
+            if (file && loadError)
+                reportedFiles.add(file);
+            diagnostics.push({
+                severity: asWarning ? 'warning' : 'error',
+                source: 'gdscript',
+                message,
+                ...(file ? { file } : {}),
+                ...(line ? { line } : {}),
+                phase: loadError ? 'load' : 'runtime',
+            });
+            continue;
+        }
+        if (kind.endsWith('WARNING')) {
+            diagnostics.push({ severity: 'warning', source: isScriptFile(file) && file.endsWith('.gd') ? 'gdscript' : 'engine', message, ...(file ? { file } : {}), ...(line ? { line } : {}) });
+            continue;
+        }
+        // ERROR / USER ERROR
+        const failedLoad = FAILED_LOAD_RE.exec(message);
+        if (failedLoad) {
+            // Already reported with its line by the SCRIPT ERROR above it.
+            if (reportedFiles.has(failedLoad[1]))
+                continue;
+            diagnostics.push({ severity: 'error', source: 'gdscript', message, file: failedLoad[1], phase: 'load' });
+            continue;
+        }
+        const loadFailure = LOAD_FAILURE_RE.test(message);
+        const scriptLevel = loadFailure || (file !== undefined && file.endsWith('.gd'));
+        diagnostics.push({
+            severity: 'error',
+            source: scriptLevel ? 'gdscript' : 'engine',
+            message,
+            ...(file ? { file } : {}),
+            ...(line ? { line } : {}),
+            ...(scriptLevel ? { phase: loadFailure ? 'load' : 'runtime' } : {}),
+        });
+    }
+    return diagnostics;
+}
+function isScriptFile(file) {
+    return file !== undefined && /\.(gd|cs)$/i.test(file);
+}
+const MSBUILD_LOCATED_RE = /^\s*(.+?)\((\d+)(?:,(\d+))?(?:,\d+,\d+)?\)\s*:\s*(error|warning)\s+([A-Z]+\d+)\s*:\s*(.*?)(?:\s+\[[^\]]+\])?\s*$/;
+const MSBUILD_UNLOCATED_RE = /^\s*(.+?)\s*:\s*(error|warning)\s+([A-Z]+\d+)\s*:\s*(.*?)(?:\s+\[[^\]]+\])?\s*$/;
+/**
+ * Diagnostics in `dotnet build` output: `file(line,col): error CS1002: … [proj]` and unlocated
+ * `MSBUILD : error MSB1009: …`. MSBuild repeats each one in its summary; duplicates are dropped.
+ */
+export function parseMsbuildOutput(text) {
+    const seen = new Set();
+    const diagnostics = [];
+    for (const raw of stripAnsi(text).split(/\r?\n/)) {
+        let d;
+        const located = MSBUILD_LOCATED_RE.exec(raw);
+        if (located) {
+            d = {
+                severity: located[4],
+                source: 'csharp',
+                message: located[6],
+                file: located[1].trim(),
+                line: Number(located[2]),
+                ...(located[3] ? { column: Number(located[3]) } : {}),
+                code: located[5],
+            };
+        }
+        else {
+            const unlocated = MSBUILD_UNLOCATED_RE.exec(raw);
+            if (unlocated)
+                d = { severity: unlocated[2], source: 'csharp', message: unlocated[4], code: unlocated[3] };
+        }
+        if (!d)
+            continue;
+        const key = `${d.severity}|${d.file ?? ''}|${d.line ?? ''}|${d.column ?? ''}|${d.code}|${d.message}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        diagnostics.push(d);
+    }
+    return diagnostics;
+}
+/** `file:line: error: message` (C#: `file(line,col): error CS0000: message`). */
+export function formatDiagnostic(d) {
+    if (d.source === 'csharp' && d.file) {
+        const loc = d.line !== undefined ? `(${d.line}${d.column !== undefined ? `,${d.column}` : ''})` : '';
+        return `${d.file}${loc}: ${d.severity}${d.code ? ` ${d.code}` : ''}: ${d.message}`;
+    }
+    const loc = d.file ? `${d.file}${d.line !== undefined ? `:${d.line}` : ''}: ` : '';
+    return `${loc}${d.severity}${d.code ? ` ${d.code}` : ''}: ${d.message}`;
+}
+/** The lines of `text` that start with the godot-cli marker, without it. */
+export function cliMarkerLines(text) {
+    return stripAnsi(text)
+        .split(/\r?\n/)
+        .filter((l) => l.startsWith(CLI_MARKER))
+        .map((l) => l.slice(CLI_MARKER.length).trim());
+}
+//# sourceMappingURL=godot-log.js.map

package/dist/lib/godot-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"godot-log.js","sourceRoot":"","sources":["../../src/lib/godot-log.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAC1H,oHAAoH;AACpH,8EAA8E;AAqB9E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAE1D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAEzC,4CAA4C;AAC5C,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,SAAS,GAAG,+FAA+F,CAAC;AAClH,MAAM,KAAK,GAAG,qFAAqF,CAAC;AACpG,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AACvD,MAAM,cAAc,GAAG,iCAAiC,CAAC;AACzD,8FAA8F;AAC9F,MAAM,eAAe,GAAG,6JAA6J,CAAC;AAEtL;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,iHAAiH;IACjH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,IAAwB,CAAC;QAC7B,IAAI,IAAwB,CAAC;QAC7B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACb,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;YACrD,IAAI,SAAS;gBAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3E,MAAM,SAAS,GAAG,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI,IAAI,IAAI,SAAS;gBAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/C,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;gBACzC,MAAM,EAAE,UAAU;gBAClB,OAAO;gBACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;aACtC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,IAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACtL,SAAS;QACX,CAAC;QAED,qBAAqB;QACrB,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,UAAU,EAAE,CAAC;YACf,+DAA+D;YAC/D,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC/C,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzG,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,WAAW,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAChF,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;YAC3C,OAAO;YACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,YAAY,CAAC,IAAwB;IAC5C,OAAO,IAAI,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,kBAAkB,GAAG,kHAAkH,CAAC;AAC9I,MAAM,oBAAoB,GAAG,iFAAiF,CAAC;AAE/G;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,CAAyB,CAAC;QAC9B,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,CAAC,GAAG;gBACF,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAuB;gBAC1C,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBACnB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBACvB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;aACjB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjD,IAAI,SAAS;gBAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAuB,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACnI,CAAC;QACD,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACrG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,CAAa;IAC5C,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrG,OAAO,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACrF,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AAC1E,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,SAAS,CAAC,IAAI,CAAC;SACnB,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/godot-run.d.ts

@@ -0,0 +1,34 @@
+import { spawn } from 'child_process';
+export interface GodotRunOptions {
+    binary: string;
+    args: string[];
+    cwd: string;
+    timeoutMs: number;
+    /** Extra environment (on top of `process.env` and the .NET workaround every editor launch gets). */
+    env?: Record<string, string>;
+    /**
+     * Also pass `--log-file <logFile>`; its content is used when the process printed no Godot banner to stdout
+     * (a GUI-subsystem binary on Windows may print nothing to a pipe).
+     */
+    logFile?: string;
+    /** Kill the tree and report `interrupted` on SIGINT / SIGTERM (CLI use; a library host keeps its own handling). */
+    killOnSignal?: boolean;
+    /** Each output line as it arrives (ANSI stripped). */
+    onLine?: (line: string) => void;
+    /** Tests. */
+    spawnImpl?: typeof spawn;
+    killTreeImpl?: (pid: number) => void | Promise<unknown>;
+}
+export interface GodotRunResult {
+    /** Process exit code; null when killed or it could not start. */
+    exitCode: number | null;
+    timedOut: boolean;
+    /** Combined stdout + stderr (or the log file), ANSI stripped. */
+    output: string;
+    durationMs: number;
+    /** The process could not be started. */
+    spawnError?: string;
+    /** This CLI got SIGINT / SIGTERM while the process ran; its tree was killed. */
+    interrupted?: boolean;
+}
+export declare function runGodot(options: GodotRunOptions): Promise<GodotRunResult>;

package/dist/lib/godot-run.js

@@ -0,0 +1,113 @@
+// One headless Godot process with a hard timeout: output captured, the whole process tree killed on timeout (test
+// runners and imports are known to hang). Library-safe: no console output, no `process.exit`, never throws.
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn } from 'child_process';
+import { killProcessTree } from '@baizor/gamedev-cli-core';
+import { editorLaunchEnv } from '../utils/godot-editor.js';
+import { GODOT_BANNER_RE, stripAnsi } from './godot-log.js';
+export function runGodot(options) {
+    const started = Date.now();
+    // Before the args: anything after a `--` belongs to the script (OS.get_cmdline_user_args()).
+    const args = options.logFile ? ['--log-file', options.logFile, ...options.args] : options.args;
+    if (options.logFile) {
+        try {
+            fs.mkdirSync(path.dirname(options.logFile), { recursive: true });
+            fs.rmSync(options.logFile, { force: true });
+        }
+        catch {
+            // the log file is only a fallback
+        }
+    }
+    return new Promise((resolve) => {
+        let output = '';
+        let pending = '';
+        let settled = false;
+        let timedOut = false;
+        let interrupted = false;
+        let detachSignals = () => undefined;
+        const finish = (exitCode, spawnError) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            detachSignals();
+            if (pending)
+                options.onLine?.(stripAnsi(pending));
+            let text = stripAnsi(output);
+            if (!GODOT_BANNER_RE.test(text) && options.logFile) {
+                try {
+                    const fromFile = stripAnsi(fs.readFileSync(options.logFile, 'utf-8'));
+                    if (fromFile.trim().length > 0)
+                        text = fromFile;
+                }
+                catch {
+                    // no log file either
+                }
+            }
+            resolve({ exitCode, timedOut, output: text, durationMs: Date.now() - started, ...(spawnError ? { spawnError } : {}), ...(interrupted ? { interrupted } : {}) });
+        };
+        let child;
+        try {
+            child = (options.spawnImpl ?? spawn)(options.binary, args, {
+                cwd: options.cwd,
+                env: editorLaunchEnv(options.env),
+                stdio: ['ignore', 'pipe', 'pipe'],
+                windowsHide: true,
+                // POSIX: own process group so a timeout kills the whole tree.
+                detached: process.platform !== 'win32',
+            });
+        }
+        catch (err) {
+            resolve({ exitCode: null, timedOut: false, output: '', durationMs: Date.now() - started, spawnError: err instanceof Error ? err.message : String(err) });
+            return;
+        }
+        const killTree = () => {
+            const killed = child.pid !== undefined ? (options.killTreeImpl ?? killProcessTree)(child.pid) : undefined;
+            // A killed tree closes its pipes; resolve anyway should a grandchild keep them open — counted from when the
+            // kill is done, so the caller never exits while taskkill still runs.
+            void Promise.resolve(killed)
+                .catch(() => undefined)
+                .then(() => setTimeout(() => finish(null), 5000).unref());
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            killTree();
+        }, options.timeoutMs);
+        // Ctrl+C / SIGTERM: the POSIX child runs in its own process group and never sees the signal, and on Windows
+        // Godot's children survive it; kill the tree and let the caller report the interruption.
+        const onSignal = () => {
+            interrupted = true;
+            killTree();
+        };
+        if (options.killOnSignal) {
+            process.once('SIGINT', onSignal);
+            process.once('SIGTERM', onSignal);
+            detachSignals = () => {
+                process.removeListener('SIGINT', onSignal);
+                process.removeListener('SIGTERM', onSignal);
+            };
+        }
+        const onData = (chunk) => {
+            const text = chunk.toString();
+            output += text;
+            if (!options.onLine)
+                return;
+            pending += text;
+            const parts = pending.split(/\r?\n/);
+            pending = parts.pop() ?? '';
+            for (const line of parts)
+                options.onLine(stripAnsi(line));
+        };
+        child.stdout?.on('data', onData);
+        child.stderr?.on('data', onData);
+        child.on('error', (err) => finish(null, err.message));
+        child.on('close', (code) => finish(timedOut || interrupted ? null : code));
+        // A grandchild that inherited the pipes (an MSBuild node, the C# compiler server) can keep them open long after
+        // Godot exited: give the output 2 s to drain, then finish on the exit itself.
+        child.on('exit', (code) => {
+            setTimeout(() => finish(timedOut || interrupted ? null : code), 2000).unref();
+        });
+    });
+}
+//# sourceMappingURL=godot-run.js.map

package/dist/lib/godot-run.js.map

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

package/dist/lib/headless.d.ts

@@ -0,0 +1,82 @@
+import { type Diagnostic } from './godot-log.js';
+import { type GodotRunOptions, type GodotRunResult } from './godot-run.js';
+export type HeadlessFailureReason = 'invalid-options' | 'not-found' | 'project-open' | 'timeout' | 'script-errors' | 'compilation-failed' | 'import-failed' | 'export-failed' | 'tests-failed' | 'test-run-error' | 'interrupted';
+/** One Godot / dotnet process a headless command ran. */
+export interface HeadlessStep {
+    name: string;
+    command: string[];
+    exitCode: number | null;
+    timedOut: boolean;
+    durationMs: number;
+}
+export interface HeadlessBaseOptions {
+    projectPath: string;
+    /** Explicit Godot executable (else GODOT_BIN / PATH / common install locations). */
+    editorPath?: string;
+    /** Total budget for the whole command, in ms. */
+    timeoutMs: number;
+    /** Run even when an editor has the project open. */
+    allowOpenProject?: boolean;
+    onProgress?: (message: string) => void;
+    /** Tests. */
+    deps?: Partial<HeadlessDeps>;
+}
+export interface HeadlessDeps {
+    runGodot: (options: GodotRunOptions) => Promise<GodotRunResult>;
+    findBinary: (editorPath?: string) => string | null;
+    findOpenEditor: (projectPath: string) => {
+        pid: number;
+    } | null;
+}
+export declare const defaultHeadlessDeps: HeadlessDeps;
+export interface HeadlessFailure {
+    kind: 'failure';
+    success: false;
+    reason: HeadlessFailureReason;
+    message: string;
+}
+export declare function headlessFailure(reason: HeadlessFailureReason, message: string): HeadlessFailure;
+/** A headless command's result: its report on success, as much of it as exists on failure. */
+export type HeadlessResult<R> = ({
+    kind: 'success';
+    success: true;
+} & R) | (HeadlessFailure & Partial<R>);
+/** The failure of a run that was stopped (SIGINT/SIGTERM, or the timeout), else undefined. */
+export declare function stoppedRun(run: GodotRunResult, what: string): HeadlessFailure | undefined;
+/** The failure of a run that never printed Godot's banner. */
+export declare function notStarted(reason: HeadlessFailureReason, run: GodotRunResult): HeadlessFailure;
+export interface HeadlessContext {
+    kind: 'context';
+    projectPath: string;
+    binary: string;
+    deps: HeadlessDeps;
+    /** `<project>/.godot/godot-cli`: scratch scripts and logs (ignored by Godot's file system and by VCS). */
+    workDir: string;
+    deadline: number;
+    steps: HeadlessStep[];
+}
+/** The scratch folder of the headless commands inside a project. */
+export declare function cliWorkDir(projectPath: string): string;
+/**
+ * Validate the project, find the binary and refuse when an editor has the project open (an `--import` against an
+ * open project fights the editor over `.godot/`).
+ */
+export declare function prepareHeadless(options: HeadlessBaseOptions): HeadlessContext | HeadlessFailure;
+export declare function remainingMs(ctx: HeadlessContext): number;
+/** Run one headless Godot step in the project within the remaining budget and record it. */
+export declare function runGodotStep(ctx: HeadlessContext, name: string, args: string[], extra?: Pick<GodotRunOptions, 'env' | 'onLine'>): Promise<GodotRunResult>;
+/** Whether the run printed Godot's start banner: without it nothing ran and the log proves nothing. */
+export declare function engineRan(result: GodotRunResult): boolean;
+export interface ImportStepResult {
+    result: GodotRunResult;
+    diagnostics: Diagnostic[];
+    /** Set when the step decides the command's verdict. */
+    failure?: HeadlessFailure;
+}
+/**
+ * `--import`: materialise `.godot/` (imported resources, the global class cache every later step needs). Fails on a
+ * timeout, an engine that never started, script errors or `Error importing` lines; the exit code is not trusted.
+ */
+export declare function runImportStep(ctx: HeadlessContext, onLine?: (line: string) => void): Promise<ImportStepResult>;
+/** Write a GDScript the CLI runs with `-s` into the work dir; returns its `res://` path. */
+export declare function writeCliScript(ctx: HeadlessContext, name: string, source: string): string;