typescript-to-gdscript 0.1.1 → 0.1.2

package/dist/watcher/check.js

@@ -0,0 +1,209 @@
+/**
+ * Debounced full-project diagnostic check + error-driven self-heal for
+ * watch mode. Extracted from the Watcher class (file-size rule); the
+ * watcher delegates here via a small deps interface.
+ *
+ * Concurrency: checks now WRITE files (the heal pass), so overlapping
+ * runs are forbidden — `run()` is guarded by an in-flight flag, and a
+ * run requested while one is active is re-scheduled (debounced) after
+ * the active one finishes.
+ */
+import ts from 'typescript';
+import { createTsProgram } from "../parser/typescript/index.js";
+import { collectProjectDiagnostics, printDiagnostics, summarizeDiagnostics, } from "../checker/index.js";
+import { diagnosticSignatures, computeSuspects, healFiles, normPath, } from "./heal.js";
+export class CheckRunner {
+    deps;
+    /**
+     * Per-file diagnostic signature from the previous completed check.
+     * `null` = no baseline yet (first check after startup) — then every
+     * file with diagnostics counts as changed, intentionally healing
+     * stale-error files left over from previous sessions.
+     */
+    prevDiagSignatures = null;
+    /**
+     * Normalized paths of files converted since the last check. Their
+     * diagnostic signature legitimately changed (they were edited), so
+     * they're excluded from heal suspects.
+     */
+    batchConverted = new Set();
+    /**
+     * Files whose diagnostics moved in the post-heal recheck without
+     * having been healed themselves (e.g. a heal-write changed what Godot
+     * reports about a third file). They couldn't be acted on in that
+     * cycle (single heal iteration per check), so they're carried over as
+     * pre-seeded suspects for the next one.
+     */
+    pendingHealSuspects = new Set();
+    running = false;
+    rerunRequested = false;
+    disposed = false;
+    current = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Record a file converted by the watcher's batch path. */
+    noteConverted(filePath) {
+        this.batchConverted.add(normPath(filePath));
+    }
+    /**
+     * Run one check cycle. Never overlaps: a call while a cycle is active
+     * requests a re-schedule instead (the heal pass writes files — two
+     * interleaved chains could tear writes and stomp baselines).
+     */
+    run() {
+        if (this.disposed)
+            return;
+        if (this.running) {
+            this.rerunRequested = true;
+            return;
+        }
+        this.running = true;
+        this.current = this.runOnce()
+            .catch((err) => {
+            console.error(`[check] Failed: ${err.message}`);
+        })
+            .finally(() => {
+            this.running = false;
+            this.current = null;
+            if (this.rerunRequested && !this.disposed) {
+                this.rerunRequested = false;
+                this.deps.requestRecheck();
+            }
+        });
+    }
+    /** Block new runs and wait for the in-flight one (if any) to settle. */
+    async dispose() {
+        this.disposed = true;
+        this.rerunRequested = false;
+        if (this.current)
+            await this.current;
+    }
+    async runOnce() {
+        const tsFiles = [...this.deps.getTsFiles()].filter((f) => !f.endsWith('.d.ts'));
+        if (tsFiles.length === 0) {
+            this.deps.debugLog('Diagnostic check skipped — no .ts files');
+            return;
+        }
+        const checkStart = Date.now();
+        this.deps.debugLog(`Diagnostic check starting (${tsFiles.length} file(s), program=${this.deps.getProgram() ? 'reused' : 'fresh'})`);
+        const firstResult = await this.collect(tsFiles);
+        const { result, rewrote } = await this.healAndRecheck(firstResult, tsFiles);
+        this.deps.debugLog(`Diagnostic check finished in ${Date.now() - checkStart}ms`);
+        const summary = summarizeDiagnostics(result);
+        // Only clear the console when there's something to show — preserves the
+        // recent per-file conversion logs when the project is clean.
+        if (summary) {
+            process.stdout.write('\x1Bc');
+            if (rewrote.length > 0) {
+                console.log(`[heal] Reconverted ${rewrote.length} stale file(s):`);
+                for (const f of rewrote)
+                    console.log(`  ${f}`);
+                console.log('');
+            }
+            printDiagnostics(result.tsDiagnostics, 'TS');
+            printDiagnostics(result.converterDiagnostics, 'CONV');
+            printDiagnostics(result.godotDiagnostics, 'GD');
+            console.log('[check] complete:');
+            console.log(summary);
+        }
+        else {
+            if (rewrote.length > 0) {
+                console.log(`[heal] Reconverted ${rewrote.length} stale file(s).`);
+            }
+            console.log('[check] No issues found.');
+        }
+    }
+    /** One full-project diagnostics pass (reuses the watcher's program). */
+    collect(tsFiles) {
+        return collectProjectDiagnostics({
+            tsDir: this.deps.tsDir,
+            gdDir: this.deps.gdDir,
+            projectRoot: this.deps.projectRoot,
+            tsFiles,
+            tsConfigPath: this.deps.tsConfigPath,
+            cache: this.deps.cache,
+            godotPath: this.deps.godotPath,
+            cacheDir: this.deps.cacheDir,
+            noEmit: false,
+            program: this.deps.getProgram() ?? undefined,
+            onDebug: this.deps.debug ? (msg) => this.deps.debugLog(msg) : undefined,
+        });
+    }
+    /**
+     * Error-driven self-heal. Files whose diagnostic signature changed
+     * without having been converted in the current batch are presumed
+     * stale (a type they depend on changed in another file): reconvert
+     * them in memory and rewrite the ones whose bytes differ. When bytes
+     * changed, rerun the diagnostic check ONCE; suspects that surface
+     * only in that second pass are carried over to the next cycle (a
+     * recheck is requested), keeping the one-heal-per-cycle bound while
+     * still converging.
+     */
+    async healAndRecheck(result, tsFiles) {
+        const curr = diagnosticSignatures(result);
+        const projectTsFiles = new Set(tsFiles.map(normPath));
+        // Snapshot + reset synchronously: files converted while this check
+        // is awaiting belong to the NEXT cycle's exclusion set.
+        const batch = this.batchConverted;
+        this.batchConverted = new Set();
+        const carried = [...this.pendingHealSuspects].filter((f) => projectTsFiles.has(f) && !batch.has(f));
+        this.pendingHealSuspects = new Set();
+        const suspects = [
+            ...new Set([
+                ...computeSuspects(this.prevDiagSignatures, curr, {
+                    batchConverted: batch,
+                    projectTsFiles,
+                }),
+                ...carried,
+            ]),
+        ];
+        let final = result;
+        const rewroteAll = [];
+        if (suspects.length > 0) {
+            this.deps.debugLog(`Heal: ${suspects.length} suspect file(s) with changed diagnostics`);
+            const program = this.deps.getProgram() ??
+                createTsProgram({
+                    rootDir: this.deps.tsDir,
+                    files: tsFiles,
+                    tsConfigPath: this.deps.tsConfigPath,
+                });
+            this.deps.setProgram(program);
+            const { rewrote } = healFiles({
+                files: suspects,
+                program,
+                cache: this.deps.cache,
+                tsDir: this.deps.tsDir,
+                gdDir: this.deps.gdDir,
+                projectRoot: this.deps.projectRoot,
+                tsConfigPath: this.deps.tsConfigPath,
+                emitOnError: this.deps.emitOnError,
+                onLog: (file, msg) => this.deps.log(file, msg, 'info'),
+            });
+            rewroteAll.push(...rewrote);
+            if (rewrote.length > 0) {
+                this.deps.cache.save();
+                this.deps.debugLog(`Heal rewrote ${rewrote.length} file(s) — re-running diagnostic check once`);
+                final = await this.collect(tsFiles);
+                // Heal-writes can move diagnostics of files we did NOT heal
+                // (e.g. Godot's view of a third file changes when a healed .gd
+                // changes a type annotation). All suspects are fresh now, so
+                // only OTHER files qualify — carry them into the next cycle.
+                const second = diagnosticSignatures(final);
+                const next = computeSuspects(curr, second, {
+                    batchConverted: new Set(suspects),
+                    projectTsFiles,
+                });
+                if (next.length > 0) {
+                    for (const f of next)
+                        this.pendingHealSuspects.add(f);
+                    this.deps.debugLog(`Heal: ${next.length} file(s) affected by heal-writes — recheck scheduled`);
+                    this.deps.requestRecheck();
+                }
+            }
+        }
+        this.prevDiagSignatures = diagnosticSignatures(final);
+        return { result: final, rewrote: rewroteAll };
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/watcher/check.js.map

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

package/dist/watcher/heal.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Error-driven self-healing for watch mode.
+ *
+ * The watcher reconverts only files whose own content changed, so a type
+ * change in `b.ts` can leave `a.gd` stale. By design every *dangerous*
+ * stale output surfaces as a fresh diagnostic each check cycle (TS
+ * diagnostics are recomputed from the live program; Godot validates the
+ * actual on-disk `.gd`). This module turns those diagnostics into the
+ * "affected set": files whose diagnostic signature changed — without
+ * having been reconverted in the current batch — are reconverted in
+ * memory and rewritten when their output bytes differ.
+ *
+ * Positions are deliberately excluded from signatures: editing `b.ts`
+ * shifts line numbers in ITS diagnostics, not in other files'. A file
+ * whose only delta is diagnostic positions was edited itself (and thus
+ * sits in the converted batch, which is excluded anyway).
+ */
+import type ts from 'typescript';
+import type { CheckResult } from '../checker/index.ts';
+import type { ProjectCache } from '../cache/index.ts';
+/** Normalize a path for map keys (forward slashes). */
+export declare function normPath(p: string): string;
+/**
+ * Per-file signature of a check result's diagnostics. Key: normalized
+ * file path. Value: hash over the SORTED set of `severity|message`
+ * entries — positions excluded, duplicates collapse.
+ */
+export declare function diagnosticSignatures(result: CheckResult): Map<string, string>;
+/**
+ * Files whose diagnostic signature changed between two check runs
+ * (appeared, disappeared, or differs), excluding files converted in the
+ * current batch (already fresh) and anything that isn't a watched
+ * project `.ts` file.
+ *
+ * `prev === null` means "no baseline yet" (first check after startup):
+ * every file with diagnostics counts as changed — intentionally heals
+ * stale-error files left over from previous sessions.
+ */
+export declare function computeSuspects(prev: Map<string, string> | null, curr: Map<string, string>, options: {
+    /** Normalized paths converted in the current batch. */
+    batchConverted: Set<string>;
+    /** Normalized paths of all watched project .ts files. */
+    projectTsFiles: Set<string>;
+}): string[];
+export interface HealOptions {
+    files: string[];
+    program: ts.Program;
+    cache: ProjectCache;
+    tsDir: string;
+    gdDir: string;
+    projectRoot: string;
+    tsConfigPath?: string;
+    emitOnError?: boolean;
+    onLog?: (file: string, message: string) => void;
+}
+/**
+ * Reconvert `files` in memory and rewrite the ones whose generated
+ * bytes differ from disk (cache entries refreshed alongside). Returns
+ * the list of `.gd` paths actually rewritten — non-empty means the
+ * caller should rerun the diagnostic check ONCE so Godot validates the
+ * healed bytes and converter diagnostics come from the fresh entries.
+ */
+export declare function healFiles(options: HealOptions): {
+    rewrote: string[];
+};
+//# sourceMappingURL=heal.d.ts.map

package/dist/watcher/heal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal.d.ts","sourceRoot":"","sources":["../../src/watcher/heal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAwB7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,EAChC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACzB,OAAO,EAAE;IACP,uDAAuD;IACvD,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,yDAAyD;IACzD,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B,GACA,MAAM,EAAE,CAYV;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgErE"}

package/dist/watcher/heal.js

@@ -0,0 +1,132 @@
+/**
+ * Error-driven self-healing for watch mode.
+ *
+ * The watcher reconverts only files whose own content changed, so a type
+ * change in `b.ts` can leave `a.gd` stale. By design every *dangerous*
+ * stale output surfaces as a fresh diagnostic each check cycle (TS
+ * diagnostics are recomputed from the live program; Godot validates the
+ * actual on-disk `.gd`). This module turns those diagnostics into the
+ * "affected set": files whose diagnostic signature changed — without
+ * having been reconverted in the current batch — are reconverted in
+ * memory and rewritten when their output bytes differ.
+ *
+ * Positions are deliberately excluded from signatures: editing `b.ts`
+ * shifts line numbers in ITS diagnostics, not in other files'. A file
+ * whose only delta is diagnostic positions was edited itself (and thus
+ * sits in the converted batch, which is excluded anyway).
+ */
+import { createHash } from 'crypto';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname, relative, resolve } from 'path';
+import { convertTsToGd } from "../converter/ts-to-gd/index.js";
+import { isConversionErrorSeverity } from "../converter/common/index.js";
+/** Normalize a path for map keys (forward slashes). */
+export function normPath(p) {
+    return p.replace(/\\/g, '/');
+}
+/**
+ * Per-file signature of a check result's diagnostics. Key: normalized
+ * file path. Value: hash over the SORTED set of `severity|message`
+ * entries — positions excluded, duplicates collapse.
+ */
+export function diagnosticSignatures(result) {
+    const byFile = new Map();
+    const collect = (diags, source) => {
+        for (const d of diags) {
+            if (d.severity === 'info')
+                continue;
+            const key = normPath(d.file);
+            const list = byFile.get(key) ?? [];
+            list.push(`${source}|${d.severity}|${d.message}`);
+            byFile.set(key, list);
+        }
+    };
+    collect(result.tsDiagnostics, 'TS');
+    collect(result.converterDiagnostics, 'CONV');
+    collect(result.godotDiagnostics, 'GD');
+    const signatures = new Map();
+    for (const [file, entries] of byFile) {
+        const sorted = [...new Set(entries)].sort().join('\n');
+        signatures.set(file, createHash('md5').update(sorted).digest('hex').slice(0, 16));
+    }
+    return signatures;
+}
+/**
+ * Files whose diagnostic signature changed between two check runs
+ * (appeared, disappeared, or differs), excluding files converted in the
+ * current batch (already fresh) and anything that isn't a watched
+ * project `.ts` file.
+ *
+ * `prev === null` means "no baseline yet" (first check after startup):
+ * every file with diagnostics counts as changed — intentionally heals
+ * stale-error files left over from previous sessions.
+ */
+export function computeSuspects(prev, curr, options) {
+    const prevMap = prev ?? new Map();
+    const candidates = new Set([...prevMap.keys(), ...curr.keys()]);
+    const suspects = [];
+    for (const file of candidates) {
+        if (prevMap.get(file) === curr.get(file))
+            continue;
+        if (options.batchConverted.has(file))
+            continue;
+        if (!file.endsWith('.ts') || file.endsWith('.d.ts'))
+            continue;
+        if (!options.projectTsFiles.has(file))
+            continue;
+        suspects.push(file);
+    }
+    return suspects;
+}
+/**
+ * Reconvert `files` in memory and rewrite the ones whose generated
+ * bytes differ from disk (cache entries refreshed alongside). Returns
+ * the list of `.gd` paths actually rewritten — non-empty means the
+ * caller should rerun the diagnostic check ONCE so Godot validates the
+ * healed bytes and converter diagnostics come from the fresh entries.
+ */
+export function healFiles(options) {
+    const rewrote = [];
+    for (const filePath of options.files) {
+        const relPath = relative(options.tsDir, filePath);
+        const outputPath = resolve(options.gdDir, relPath.replace(/\.ts$/, '.gd'));
+        const result = convertTsToGd({
+            filePath,
+            rootDir: options.tsDir,
+            tsDir: options.tsDir,
+            gdDir: options.gdDir,
+            projectRoot: options.projectRoot,
+            tsConfigPath: options.tsConfigPath,
+            sourceMap: true,
+            program: options.program,
+        });
+        // Mirror convertSingleFile: hard conversion errors block the write.
+        if (result.diagnostics.some((d) => isConversionErrorSeverity(d.severity)) &&
+            !options.emitOnError) {
+            options.onLog?.(filePath, 'Heal skipped — conversion errors block the write');
+            continue;
+        }
+        const normalize = (s) => s.replace(/\r\n/g, '\n');
+        const onDisk = existsSync(outputPath)
+            ? readFileSync(outputPath, 'utf-8')
+            : null;
+        if (onDisk !== null && normalize(onDisk) === normalize(result.code)) {
+            // Output already current — refresh diagnostics/source map only.
+            // Hash the bytes actually on disk: a CRLF .gd would never look
+            // fresh against the hash of the LF `result.code`.
+            if (result.sourceMap) {
+                options.cache.updateTsToGd(filePath, outputPath, result.sourceMap, result.diagnostics, { gdContent: onDisk });
+            }
+            continue;
+        }
+        mkdirSync(dirname(outputPath), { recursive: true });
+        writeFileSync(outputPath, result.code);
+        if (result.sourceMap) {
+            options.cache.updateTsToGd(filePath, outputPath, result.sourceMap, result.diagnostics, { gdContent: result.code });
+        }
+        rewrote.push(outputPath);
+        options.onLog?.(outputPath, 'Healed (stale output)');
+    }
+    return { rewrote };
+}
+//# sourceMappingURL=heal.js.map

package/dist/watcher/heal.js.map

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

package/dist/watcher/index.d.ts

@@ -52,6 +52,7 @@ export declare class Watcher {
     private pendingNonTsFiles;
     private debounceTimer;
     private checkDebounceTimer;
+    private checkRunner;
     private initialConverted;
     private initialSkipped;
     private initialErrors;

package/dist/watcher/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAyBD,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,eAAe,CAAS;IAGhC,OAAO,CAAC,aAAa,CAA2B;IAGhD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,aAAa,CAA8C;IAGnE,OAAO,CAAC,kBAAkB,CAA8C;IAGxE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,cAAc;IAgBnC,KAAK,IAAI,IAAI;IA2DP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,QAAQ;IAsDhB,OAAO,CAAC,iBAAiB;IAwFzB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,oBAAoB;IAmD5B,OAAO,CAAC,GAAG;CAgBZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAyBD,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,eAAe,CAAS;IAGhC,OAAO,CAAC,aAAa,CAA2B;IAGhD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,aAAa,CAA8C;IAGnE,OAAO,CAAC,kBAAkB,CAA8C;IAGxE,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,cAAc;IAoCnC,KAAK,IAAI,IAAI;IA2DP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,iBAAiB;IAyGzB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,oBAAoB;IAmD5B,OAAO,CAAC,GAAG;CAgBZ"}

package/dist/watcher/index.js

@@ -10,9 +10,9 @@ import { generateTypings, generateAddonTypings, generateFileTypings, } from "../
 import { shouldIgnore } from "../config/index.js";
 import { ProjectCache } from "../cache/index.js";
 import { isConversionErrorSeverity } from "../converter/common/index.js";
-import { writeFileSync, mkdirSync } from 'fs';
+import { writeFileSync, mkdirSync, readFileSync, existsSync } from 'fs';
 import { dirname } from 'path';
-import { collectProjectDiagnostics, printDiagnostics, summarizeDiagnostics, } from "../checker/index.js";
+import { CheckRunner } from "./check.js";
 /** File extensions that trigger typings regeneration (scenes, resources, assets). */
 const RESOURCE_EXTENSIONS = new Set([
     '.tscn',
@@ -49,6 +49,8 @@ export class Watcher {
     debounceTimer = null;
     // ── Debounced full-project check ──────────────────────────
     checkDebounceTimer = null;
+    // ── Check + error-driven self-heal (see check.ts / heal.ts) ──
+    checkRunner;
     // ── Initial scan counters ─────────────────────────────────
     initialConverted = 0;
     initialSkipped = 0;
@@ -65,6 +67,25 @@ export class Watcher {
         // parallel ts-plugin (inside tsserver). Without it, both sides hold
         // independent in-memory snapshots and their views of the cache drift.
         this.cache = new ProjectCache(this.cacheDir, { watch: true });
+        this.checkRunner = new CheckRunner({
+            tsDir: this.tsDir,
+            gdDir: this.gdDir,
+            projectRoot: options.projectRoot ?? options.rootDir,
+            cacheDir: this.cacheDir,
+            tsConfigPath: options.tsConfigPath,
+            godotPath: options.godotPath,
+            emitOnError: options.emitOnError,
+            debug: options.debug,
+            cache: this.cache,
+            getTsFiles: () => this.tsFiles,
+            getProgram: () => this.cachedProgram,
+            setProgram: (p) => {
+                this.cachedProgram = p;
+            },
+            requestRecheck: () => this.scheduleCheck(),
+            log: (file, message, severity) => this.log(file, message, severity),
+            debugLog: (message) => this.debugLog(message),
+        });
     }
     start() {
         // Chokidar v4 does not support glob patterns — watch directories and filter via ignored.
@@ -122,6 +143,9 @@ export class Watcher {
             clearTimeout(this.debounceTimer);
         if (this.checkDebounceTimer)
             clearTimeout(this.checkDebounceTimer);
+        // Wait for an in-flight check (which may be heal-writing files)
+        // before tearing anything down.
+        await this.checkRunner.dispose();
         await this.fsWatcher?.close();
         this.cache.save();
         await this.cache.close();
@@ -237,52 +261,12 @@ export class Watcher {
     }
     runCheck() {
         this.checkDebounceTimer = null;
-        const tsFiles = [...this.tsFiles].filter((f) => !f.endsWith('.d.ts'));
-        if (tsFiles.length === 0) {
-            this.debugLog('Diagnostic check skipped — no .ts files');
-            return;
-        }
-        const projectRoot = this.options.projectRoot ?? this.options.rootDir;
-        const checkStart = Date.now();
-        this.debugLog(`Diagnostic check starting (${tsFiles.length} file(s), program=${this.cachedProgram ? 'reused' : 'fresh'})`);
-        collectProjectDiagnostics({
-            tsDir: this.tsDir,
-            gdDir: this.gdDir,
-            projectRoot,
-            tsFiles,
-            tsConfigPath: this.options.tsConfigPath,
-            cache: this.cache,
-            godotPath: this.options.godotPath,
-            cacheDir: this.cacheDir,
-            noEmit: false,
-            // Reuse the program from the just-finished convertBatch — avoids
-            // re-parsing all .ts files. Falls back to a fresh program when null
-            // (e.g. when the only event was a removal that invalidated it).
-            program: this.cachedProgram ?? undefined,
-            onDebug: this.options.debug ? (msg) => this.debugLog(msg) : undefined,
-        })
-            .then((result) => {
-            this.debugLog(`Diagnostic check finished in ${Date.now() - checkStart}ms`);
-            const summary = summarizeDiagnostics(result);
-            // Only clear the console when there's something to show — preserves the
-            // recent per-file conversion logs when the project is clean.
-            if (summary) {
-                process.stdout.write('\x1Bc');
-                printDiagnostics(result.tsDiagnostics, 'TS');
-                printDiagnostics(result.converterDiagnostics, 'CONV');
-                printDiagnostics(result.godotDiagnostics, 'GD');
-                console.log('[check] complete:');
-                console.log(summary);
-            }
-            else {
-                console.log('[check] No issues found.');
-            }
-        })
-            .catch((err) => {
-            this.log('', `[check] Failed: ${err.message}`, 'warning');
-        });
+        this.checkRunner.run();
     }
     convertSingleFile(filePath, outputPath, program) {
+        // This file's diagnostics may legitimately change this cycle (it was
+        // edited) — exclude it from the heal pass's suspect detection.
+        this.checkRunner.noteConverted(filePath);
         const result = convertTsToGd({
             filePath,
             rootDir: this.tsDir,
@@ -303,14 +287,25 @@ export class Watcher {
             if (!this.options.emitOnError)
                 return;
         }
-        // Write output
-        mkdirSync(dirname(outputPath), { recursive: true });
-        writeFileSync(outputPath, result.code);
+        // Write output — only when the bytes actually changed, so Godot
+        // doesn't reimport identical files and file watchers don't churn.
+        const normalizeEol = (s) => s.replace(/\r\n/g, '\n');
+        const diskContent = existsSync(outputPath)
+            ? readFileSync(outputPath, 'utf-8')
+            : null;
+        const outputUnchanged = diskContent !== null &&
+            normalizeEol(diskContent) === normalizeEol(result.code);
+        if (!outputUnchanged) {
+            mkdirSync(dirname(outputPath), { recursive: true });
+            writeFileSync(outputPath, result.code);
+        }
         // Update cache. `gdContent` populates `<cacheDir>/gd-output/` so a
         // later run (or the plugin) can reuse the exact bytes via promote.
+        // When the write was skipped, hash the bytes actually on disk — a
+        // CRLF .gd would never look fresh against the LF `result.code` hash.
         if (result.sourceMap) {
             this.cache.updateTsToGd(filePath, outputPath, result.sourceMap, result.diagnostics, {
-                gdContent: result.code,
+                gdContent: outputUnchanged ? diskContent : result.code,
             });
         }
         this.cache.save();
@@ -318,8 +313,9 @@ export class Watcher {
             this.initialConverted++;
         }
         this.log(filePath, `Converted -> ${relative(this.options.rootDir, outputPath) || outputPath}`, 'info');
-        // Validate with Godot if configured
-        if (this.options.godotPath) {
+        // Validate with Godot if configured (identical bytes → identical
+        // validation result, so skip when nothing was written)
+        if (this.options.godotPath && !outputUnchanged) {
             const projectRoot = this.options.projectRoot ?? this.options.rootDir;
             validateGdFiles({
                 gdFiles: [outputPath],