typescript-to-gdscript 0.1.0

package/dist/checker/index.d.ts

@@ -0,0 +1,61 @@
+import type ts from 'typescript';
+import type { TransformDiagnostic } from '../converter/common/index.ts';
+import type { ProjectCache } from '../cache/index.ts';
+export interface CheckOptions {
+    tsDir: string;
+    gdDir: string;
+    projectRoot: string;
+    tsFiles: string[];
+    tsConfigPath?: string;
+    cache: ProjectCache | null;
+    godotPath?: string;
+    cacheDir?: string;
+    /** When true: compare in-memory converter output to disk .gd; don't write. */
+    noEmit?: boolean;
+    signal?: AbortSignal;
+    /**
+     * Existing `ts.Program` to reuse (e.g. from a recent conversion batch).
+     * Avoids re-parsing all `.ts` files. When omitted, a fresh program is built.
+     */
+    program?: ts.Program;
+    /** Optional debug callback for phase-by-phase logging. */
+    onDebug?: (message: string) => void;
+}
+export interface CheckResult {
+    tsDiagnostics: TransformDiagnostic[];
+    converterDiagnostics: TransformDiagnostic[];
+    godotDiagnostics: TransformDiagnostic[];
+    /** Resolved .gd paths whose on-disk content differs from what converter would emit. */
+    staleFiles: string[];
+}
+export declare function collectProjectDiagnostics(opts: CheckOptions): Promise<CheckResult>;
+export type DiagnosticSource = 'TS' | 'CONV' | 'GD';
+export interface DiagnosticCounts {
+    errors: number;
+    typeErrors: number;
+    warnings: number;
+}
+/**
+ * Multi-line summary grouped by diagnostic source. Returns `null` when
+ * everything is clean (caller decides what to print in that case).
+ *
+ * Example output:
+ *   TS:   2 error(s), 1 warning(s)
+ *   CONV: 1 error(s), 2 type-error(s)
+ *   GD:   2 error(s)
+ */
+export declare function summarizeDiagnostics(result: CheckResult): string | null;
+/**
+ * True when the result contains any reportable error (hard or type-error).
+ * Used by callers to decide exit codes.
+ */
+export declare function hasReportableErrors(result: CheckResult): boolean;
+/**
+ * Print diagnostics for a single source. Format:
+ *   ━━━━━━━━━━ <SOURCE> ━━━━━━━━━━     ← group separator (only when non-empty)
+ *   [SOURCE:severity] file:line:col      ← header line
+ *       message                          ← indented message
+ *                                        ← empty line between errors
+ */
+export declare function printDiagnostics(diagnostics: TransformDiagnostic[], source: DiagnosticSource): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checker/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAKjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC;IACrB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;IACxC,uFAAuF;IACvF,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAmJtB;AAID,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAUpD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAoBvE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAWhE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,mBAAmB,EAAE,EAClC,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAaN"}

package/dist/checker/index.js

@@ -0,0 +1,229 @@
+import { resolve, relative, normalize } from 'path';
+import { readFileSync, existsSync } from 'fs';
+import { createTsProgram } from "../parser/typescript/index.js";
+import { convertTsToGd } from "../converter/ts-to-gd/index.js";
+import { collectTsDiagnostics } from "./ts-diagnostics.js";
+import { runGodotProjectCheck } from "./godot-project.js";
+export async function collectProjectDiagnostics(opts) {
+    const { tsDir, gdDir, projectRoot, tsFiles, cache, noEmit = false, onDebug, } = opts;
+    const debug = (msg) => onDebug?.(`[checker] ${msg}`);
+    debug(`Starting (${tsFiles.length} file(s), noEmit=${noEmit})`);
+    // Reuse the caller's program when provided (e.g. watcher's cachedProgram
+    // built during the conversion batch); otherwise build a fresh one.
+    let program;
+    if (opts.program) {
+        debug('Reusing caller-provided ts.Program');
+        program = opts.program;
+    }
+    else {
+        debug('Building fresh ts.Program');
+        program = createTsProgram({
+            rootDir: tsDir,
+            files: tsFiles,
+            tsConfigPath: opts.tsConfigPath,
+        });
+    }
+    const converterDiagnostics = [];
+    const staleFiles = [];
+    const sourceMapTable = new Map();
+    let cacheHits = 0;
+    let conversions = 0;
+    for (const tsFile of tsFiles) {
+        if (tsFile.endsWith('.d.ts'))
+            continue;
+        const relPath = relative(tsDir, tsFile);
+        const gdPath = resolve(gdDir, relPath.replace(/\.ts$/, '.gd'));
+        const resolvedGd = normalize(resolve(gdPath));
+        // In normal (emit) mode: if cache is fresh, use cached source map + diagnostics
+        if (!noEmit && cache?.isTsToGdFresh(tsFile, gdPath)) {
+            const sourceMapJson = cache.getSourceMap(tsFile);
+            sourceMapTable.set(resolvedGd, { sourceMapJson, tsFilePath: tsFile });
+            const cached = cache.getDiagnostics(tsFile);
+            if (cached)
+                converterDiagnostics.push(...cached);
+            cacheHits++;
+            continue;
+        }
+        conversions++;
+        const result = convertTsToGd({
+            filePath: tsFile,
+            rootDir: tsDir,
+            tsDir,
+            gdDir,
+            projectRoot,
+            tsConfigPath: opts.tsConfigPath,
+            sourceMap: true,
+            program,
+        });
+        converterDiagnostics.push(...result.diagnostics);
+        if (noEmit) {
+            let sourceMapForThisFile = result.sourceMap;
+            if (existsSync(gdPath)) {
+                const diskContent = readFileSync(gdPath, 'utf-8');
+                // Normalize line endings — Git's autocrlf may have rewritten existing
+                // .gd files to CRLF while the converter always emits LF.
+                const normalize = (s) => s.replace(/\r\n/g, '\n');
+                if (normalize(diskContent) !== normalize(result.code)) {
+                    staleFiles.push(resolvedGd);
+                    sourceMapForThisFile = undefined;
+                    converterDiagnostics.push({
+                        message: `Output is stale — run 'tstogd convert' to update`,
+                        severity: 'warning',
+                        file: tsFile,
+                        line: 1,
+                        column: 1,
+                    });
+                }
+            }
+            else {
+                staleFiles.push(resolvedGd);
+                sourceMapForThisFile = undefined;
+                converterDiagnostics.push({
+                    message: `Output missing — run 'tstogd convert' to generate`,
+                    severity: 'warning',
+                    file: tsFile,
+                    line: 1,
+                    column: 1,
+                });
+            }
+            sourceMapTable.set(resolvedGd, {
+                sourceMapJson: sourceMapForThisFile,
+                tsFilePath: tsFile,
+            });
+        }
+        else {
+            sourceMapTable.set(resolvedGd, {
+                sourceMapJson: result.sourceMap,
+                tsFilePath: tsFile,
+            });
+        }
+    }
+    debug(`Conversion phase done — ${cacheHits} cache hit(s), ${conversions} fresh convert(s), ` +
+        `${converterDiagnostics.length} converter diagnostic(s), ${staleFiles.length} stale file(s)`);
+    let godotDiagnostics = [];
+    if (opts.godotPath) {
+        debug(`Running Godot full-project check (projectRoot=${projectRoot})`);
+        godotDiagnostics = await runGodotProjectCheck({
+            projectRoot,
+            godotPath: opts.godotPath,
+            gdDir,
+            cacheDir: opts.cacheDir,
+            sourceMapTable,
+            signal: opts.signal,
+        });
+        debug(`Godot phase done — ${godotDiagnostics.length} diagnostic(s)`);
+    }
+    else {
+        debug('Godot phase skipped (no godotPath)');
+    }
+    // TS diagnostics require a tsconfig to know about Godot types (int, float, Node, etc.).
+    // Without it, results would be full of false-positive "Cannot find name" errors.
+    let tsDiagnostics;
+    if (opts.tsConfigPath) {
+        debug('Collecting TS diagnostics');
+        tsDiagnostics = collectTsDiagnostics(program, tsDir);
+        debug(`TS phase done — ${tsDiagnostics.length} diagnostic(s)`);
+    }
+    else {
+        tsDiagnostics = [];
+        console.error('[checker] No --tsconfig provided; TS diagnostics skipped ' +
+            '(would produce false positives for Godot types). Pass --tsconfig to enable.');
+    }
+    return { tsDiagnostics, converterDiagnostics, godotDiagnostics, staleFiles };
+}
+/** Indent each line of `message` with `prefix`, preserving line breaks. */
+function indentMessage(message, prefix) {
+    return message
+        .split('\n')
+        .map((line) => prefix + line)
+        .join('\n');
+}
+function countByseverity(diagnostics) {
+    let errors = 0;
+    let typeErrors = 0;
+    let warnings = 0;
+    for (const d of diagnostics) {
+        if (d.severity === 'error')
+            errors++;
+        else if (d.severity === 'type-error')
+            typeErrors++;
+        else if (d.severity === 'warning')
+            warnings++;
+    }
+    return { errors, typeErrors, warnings };
+}
+function formatCounts(c) {
+    const parts = [];
+    if (c.errors > 0)
+        parts.push(`${c.errors} error(s)`);
+    if (c.typeErrors > 0)
+        parts.push(`${c.typeErrors} type-error(s)`);
+    if (c.warnings > 0)
+        parts.push(`${c.warnings} warning(s)`);
+    return parts.join(', ');
+}
+/**
+ * Multi-line summary grouped by diagnostic source. Returns `null` when
+ * everything is clean (caller decides what to print in that case).
+ *
+ * Example output:
+ *   TS:   2 error(s), 1 warning(s)
+ *   CONV: 1 error(s), 2 type-error(s)
+ *   GD:   2 error(s)
+ */
+export function summarizeDiagnostics(result) {
+    const ts = countByseverity(result.tsDiagnostics);
+    const conv = countByseverity(result.converterDiagnostics);
+    const gd = countByseverity(result.godotDiagnostics);
+    const groups = [
+        { label: 'TS  ', counts: ts },
+        { label: 'CONV', counts: conv },
+        { label: 'GD  ', counts: gd },
+    ];
+    const visible = groups.filter((g) => g.counts.errors > 0 || g.counts.typeErrors > 0 || g.counts.warnings > 0);
+    if (visible.length === 0)
+        return null;
+    return visible
+        .map((g) => `  ${g.label}: ${formatCounts(g.counts)}`)
+        .join('\n');
+}
+/**
+ * True when the result contains any reportable error (hard or type-error).
+ * Used by callers to decide exit codes.
+ */
+export function hasReportableErrors(result) {
+    for (const d of result.tsDiagnostics) {
+        if (d.severity === 'error')
+            return true;
+    }
+    for (const d of result.converterDiagnostics) {
+        if (d.severity === 'error' || d.severity === 'type-error')
+            return true;
+    }
+    for (const d of result.godotDiagnostics) {
+        if (d.severity === 'error')
+            return true;
+    }
+    return false;
+}
+/**
+ * Print diagnostics for a single source. Format:
+ *   ━━━━━━━━━━ <SOURCE> ━━━━━━━━━━     ← group separator (only when non-empty)
+ *   [SOURCE:severity] file:line:col      ← header line
+ *       message                          ← indented message
+ *                                        ← empty line between errors
+ */
+export function printDiagnostics(diagnostics, source) {
+    const visible = diagnostics.filter((d) => d.severity !== 'info');
+    if (visible.length === 0)
+        return;
+    console.error('');
+    console.error(`━━━━━━━━━━ ${source} ━━━━━━━━━━`);
+    console.error('');
+    for (const d of visible) {
+        console.error(`[${source}:${d.severity}] ${d.file}:${d.line}:${d.column}`);
+        console.error(indentMessage(d.message, '    '));
+        console.error('');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/checker/index.js.map

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

package/dist/checker/ts-diagnostics.d.ts

@@ -0,0 +1,11 @@
+import ts from 'typescript';
+import type { TransformDiagnostic } from '../converter/common/index.ts';
+/**
+ * Collect TypeScript semantic + syntactic diagnostics from `program`,
+ * limited to source files under `tsDir`. Filters out:
+ * - `.d.ts` declaration files
+ * - files outside `tsDir`
+ * - noise codes 2434, 2435, 2449 (namespace+class merge pattern)
+ */
+export declare function collectTsDiagnostics(program: ts.Program, tsDir: string): TransformDiagnostic[];
+//# sourceMappingURL=ts-diagnostics.d.ts.map

package/dist/checker/ts-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-diagnostics.d.ts","sourceRoot":"","sources":["../../src/checker/ts-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AA+BxE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,KAAK,EAAE,MAAM,GACZ,mBAAmB,EAAE,CAoCvB"}

package/dist/checker/ts-diagnostics.js

@@ -0,0 +1,67 @@
+import ts from 'typescript';
+import { normalize, resolve } from 'path';
+/** TS diagnostic codes that are correct-but-noisy for the namespace+class merge pattern. */
+const NOISE_CODES = new Set([2434, 2435, 2449]);
+function flattenDiagnosticMessage(msg) {
+    if (typeof msg === 'string')
+        return msg;
+    const parts = [msg.messageText];
+    if (msg.next) {
+        for (const chain of msg.next) {
+            parts.push(flattenDiagnosticMessage(chain));
+        }
+    }
+    return parts.join(' ');
+}
+function tsSeverity(category) {
+    switch (category) {
+        case ts.DiagnosticCategory.Error:
+            return 'error';
+        case ts.DiagnosticCategory.Warning:
+            return 'warning';
+        default:
+            return 'info';
+    }
+}
+/**
+ * Collect TypeScript semantic + syntactic diagnostics from `program`,
+ * limited to source files under `tsDir`. Filters out:
+ * - `.d.ts` declaration files
+ * - files outside `tsDir`
+ * - noise codes 2434, 2435, 2449 (namespace+class merge pattern)
+ */
+export function collectTsDiagnostics(program, tsDir) {
+    const normalizedTsDir = normalize(resolve(tsDir));
+    const result = [];
+    for (const sf of program.getSourceFiles()) {
+        const filePath = normalize(resolve(sf.fileName));
+        if (filePath.endsWith('.d.ts'))
+            continue;
+        if (!filePath.startsWith(normalizedTsDir))
+            continue;
+        const diags = [
+            ...program.getSyntacticDiagnostics(sf),
+            ...program.getSemanticDiagnostics(sf),
+        ];
+        for (const d of diags) {
+            if (NOISE_CODES.has(d.code))
+                continue;
+            let line = 0;
+            let column = 0;
+            if (d.file && d.start !== undefined) {
+                const lc = d.file.getLineAndCharacterOfPosition(d.start);
+                line = lc.line + 1;
+                column = lc.character + 1;
+            }
+            result.push({
+                message: `TS${d.code}: ${flattenDiagnosticMessage(d.messageText)}`,
+                severity: tsSeverity(d.category),
+                file: filePath,
+                line,
+                column,
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=ts-diagnostics.js.map

package/dist/checker/ts-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-diagnostics.js","sourceRoot":"","sources":["../../src/checker/ts-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG1C,4FAA4F;AAC5F,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEhD,SAAS,wBAAwB,CAC/B,GAAuC;IAEvC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAChC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,UAAU,CACjB,QAA+B;IAE/B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,EAAE,CAAC,kBAAkB,CAAC,KAAK;YAC9B,OAAO,OAAO,CAAC;QACjB,KAAK,EAAE,CAAC,kBAAkB,CAAC,OAAO;YAChC,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAmB,EACnB,KAAa;IAEb,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACzC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC;YAAE,SAAS;QAEpD,MAAM,KAAK,GAA6B;YACtC,GAAG,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;YACtC,GAAG,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC;SACtC,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEtC,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACzD,IAAI,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;gBACnB,MAAM,GAAG,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;YAC5B,CAAC;YAED,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE;gBAClE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAChC,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/clear-cache.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerClearCacheCommand(program: Command): void;
+//# sourceMappingURL=clear-cache.d.ts.map

package/dist/cli/clear-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-cache.d.ts","sourceRoot":"","sources":["../../src/cli/clear-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4ChE"}

package/dist/cli/clear-cache.js

@@ -0,0 +1,42 @@
+import { rmSync, existsSync, readdirSync } from 'fs';
+import { resolveConfig } from "../config/index.js";
+export function registerClearCacheCommand(program) {
+    program
+        .command('clear-cache')
+        .description('Clear the conversion cache')
+        .action(() => {
+        const cfg = resolveConfig();
+        const { cacheDir } = cfg;
+        if (!existsSync(cacheDir)) {
+            console.log(`Cache directory does not exist: ${cacheDir}`);
+            return;
+        }
+        try {
+            rmSync(cacheDir, { recursive: true, force: true });
+        }
+        catch (err) {
+            console.error(`Failed to delete cache directory: ${cacheDir}\n` +
+                `${err instanceof Error ? err.message : String(err)}\n` +
+                `If an IDE is running, close it first or restart its TypeScript service after clearing.`);
+            process.exit(1);
+        }
+        if (existsSync(cacheDir)) {
+            let remaining = [];
+            try {
+                remaining = readdirSync(cacheDir);
+            }
+            catch {
+                /* ignore */
+            }
+            console.error(`Cache directory still exists after deletion: ${cacheDir}` +
+                (remaining.length > 0
+                    ? `\nRemaining files: ${remaining.join(', ')}`
+                    : '') +
+                `\nThis usually means another process (IDE, watcher) is holding files open.` +
+                `\nRestart your IDE's TypeScript service and try again.`);
+            process.exit(1);
+        }
+        console.log(`Cache cleared: ${cacheDir}`);
+    });
+}
+//# sourceMappingURL=clear-cache.js.map

package/dist/cli/clear-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-cache.js","sourceRoot":"","sources":["../../src/cli/clear-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;QAEzB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,qCAAqC,QAAQ,IAAI;gBAC/C,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI;gBACvD,wFAAwF,CAC3F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,SAAS,GAAa,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,OAAO,CAAC,KAAK,CACX,gDAAgD,QAAQ,EAAE;gBACxD,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;oBACnB,CAAC,CAAC,sBAAsB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC9C,CAAC,CAAC,EAAE,CAAC;gBACP,4EAA4E;gBAC5E,wDAAwD,CAC3D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/convert-gd.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerConvertGdCommand(program: Command): void;
+//# sourceMappingURL=convert-gd.d.ts.map

package/dist/cli/convert-gd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-gd.d.ts","sourceRoot":"","sources":["../../src/cli/convert-gd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8L/D"}

package/dist/cli/convert-gd.js

@@ -0,0 +1,148 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { resolve, dirname, relative } from 'path';
+import { convertGdToTs } from "../converter/gd-to-ts/index.js";
+import { injectMissingImportsForProject } from "../converter/gd-to-ts/inject-imports.js";
+import { runTsHelpers } from "../converter/gd-to-ts/ts-helpers.js";
+import { collectAllSignalHandlers, findSceneFiles } from "../typings/scenes.js";
+import { resolveConfig, resolveRegistry } from "../config/index.js";
+import { debugLog, resolveFiles, generateAllTypings } from "./helpers.js";
+export function registerConvertGdCommand(program) {
+    program
+        .command('initial-convert-gd-to-ts')
+        .description('One-shot bulk conversion of GDScript files to TypeScript (intended for the initial migration). Existing `.ts` files are NOT overwritten unless `--force` is passed. If no files given, converts all .gd files in gdDir.')
+        .argument('[files...]', 'GDScript files or glob patterns to convert')
+        .option('-o, --output-dir <dir>', 'Output directory (alias for --ts-dir)')
+        .option('--ts-dir <dir>', 'TypeScript output directory')
+        .option('--gd-dir <dir>', 'GDScript source directory')
+        .option('--root-dir <dir>', 'Root directory', '.')
+        .option('--registry <path>', 'Path to godot-class-registry.json (overrides tstogd.json and bundled)')
+        .option('--unsafe-use-any', 'Use `any` instead of `unknown` as the fallback for unresolvable types (e.g. gd.getset without a GDScript type or typeof-able value). Less strict but more error-prone.', false)
+        .option('--emit-on-error', 'Emit output files even when conversion errors occur', false)
+        .option('-f, --force', 'Overwrite existing TypeScript output files. Without this flag the command skips any `.gd` whose mirrored `.ts` already exists and exits non-zero so the migration cannot accidentally clobber hand-edited TS sources.', false)
+        .action((files, opts) => {
+        const cfg = resolveConfig({
+            overrides: {
+                rootDir: opts.rootDir,
+                tsDir: opts.tsDir,
+                gdDir: opts.gdDir,
+            },
+        });
+        const resolvedFiles = resolveFiles(files.length > 0 ? files : undefined, '.gd', cfg.gdDir, cfg.rootDir, cfg.ignore);
+        if (resolvedFiles.length === 0) {
+            console.log('No GDScript files found to convert.');
+            return;
+        }
+        debugLog(`Converting ${resolvedFiles.length} file(s)...`);
+        const registry = resolveRegistry({ registryPath: opts.registry });
+        const tsOutputFiles = [];
+        const collectedErrors = [];
+        // Find .tscn scene files for signal handler resolution
+        const sceneFiles = findSceneFiles(cfg.scenesDir, cfg.rootDir, cfg.ignore);
+        // Pre-collect all signal handlers once (instead of re-parsing scenes per file)
+        const allSignalHandlers = sceneFiles.length > 0
+            ? collectAllSignalHandlers(sceneFiles, registry)
+            : undefined;
+        // Build project sources for user-defined class inheritance resolution
+        const projectSources = resolvedFiles.map((f) => ({
+            source: readFileSync(f, 'utf-8'),
+            filePath: f,
+        }));
+        // Tracks every successfully-written file so the import-injection
+        // post-pass below knows which `.ts` to rewrite and which `.gd`
+        // each one corresponds to (for self-import skipping).
+        const convertedFiles = [];
+        let hasErrors = false;
+        // Tracks `.ts` outputs we skipped because they already exist on
+        // disk and the user did NOT pass `--force`. Reported as errors at
+        // the end of the run so the initial-migration command can never
+        // silently clobber hand-edited TypeScript.
+        const skippedExistingFiles = [];
+        for (const { source, filePath } of projectSources) {
+            const scriptResPath = `res://${relative(cfg.rootDir, filePath).replace(/\\/g, '/')}`;
+            const signalHandlers = allSignalHandlers?.get(scriptResPath);
+            const result = convertGdToTs({
+                source,
+                filePath,
+                registry,
+                projectSources,
+                signalHandlers,
+                unsafeUseAny: !!opts.unsafeUseAny,
+            });
+            // Collect diagnostics for summary at end
+            for (const diag of result.diagnostics) {
+                const prefix = diag.severity === 'error'
+                    ? 'ERROR'
+                    : diag.severity === 'warning'
+                        ? 'WARN'
+                        : 'INFO';
+                collectedErrors.push(`[${prefix}] ${diag.file}:${diag.line}:${diag.column} - ${diag.message}`);
+            }
+            if (result.diagnostics.some((d) => d.severity === 'error')) {
+                hasErrors = true;
+                if (!opts.emitOnError)
+                    continue;
+            }
+            const relPath = relative(cfg.gdDir, filePath);
+            const outputPath = resolve(cfg.tsDir, relPath.replace(/\.gd$/, '.ts'));
+            // Don't overwrite hand-edited TS unless the user opts in via
+            // `--force`. Defer reporting until after the loop so the user
+            // sees a single clean summary instead of one error per file.
+            if (!opts.force && existsSync(outputPath)) {
+                skippedExistingFiles.push({ tsPath: outputPath, gdPath: filePath });
+                continue;
+            }
+            mkdirSync(dirname(outputPath), { recursive: true });
+            writeFileSync(outputPath, result.code);
+            console.log(`Writing ${relative(process.cwd(), outputPath)}`);
+            tsOutputFiles.push(outputPath);
+            convertedFiles.push({ tsPath: outputPath, gdPath: filePath });
+        }
+        // Inject `import { Foo } from "./foo.js"` lines for every
+        // unresolved user-class identifier in the freshly-written `.ts`
+        // files. Runs BEFORE typings + TS helpers so the helpers see a
+        // fully-imported file. No-op when the project opts into the
+        // legacy `generateGlobalClassTypes: true` layout.
+        injectMissingImportsForProject(convertedFiles, projectSources, registry, {
+            generateGlobalClassTypes: cfg.converterOptions.generateGlobalClassTypes,
+            tsConfigPath: cfg.tsconfig ? resolve(cfg.tsconfig) : undefined,
+        });
+        // Generate class typings + scene typings + addon typings from the converted TS files
+        generateAllTypings({
+            ...cfg,
+            tsFiles: tsOutputFiles,
+        });
+        // Run TS-based post-processing helpers.
+        if (tsOutputFiles.length > 0) {
+            const helperResult = runTsHelpers({
+                files: tsOutputFiles,
+                rootDir: cfg.rootDir,
+                tsConfigPath: cfg.tsconfig,
+                registry,
+                unsafeUseAny: !!opts.unsafeUseAny,
+            });
+            if (helperResult.fixedFiles.length > 0) {
+                debugLog(`TS helpers: patched ${helperResult.fixedFiles.length} file(s)`);
+            }
+        }
+        // Print collected errors at the end
+        if (collectedErrors.length > 0) {
+            console.error('');
+            for (const msg of collectedErrors) {
+                console.error(msg);
+            }
+        }
+        // Surface skipped-existing files as a single block at the end so
+        // the user can see the full list and the `--force` hint together.
+        if (skippedExistingFiles.length > 0) {
+            console.error('');
+            console.error(`[ERROR] Refusing to overwrite ${skippedExistingFiles.length} existing TypeScript file(s):`);
+            for (const { tsPath, gdPath } of skippedExistingFiles) {
+                console.error(`  ${relative(process.cwd(), tsPath)}  (from ${relative(process.cwd(), gdPath)})`);
+            }
+            console.error('Pass --force to overwrite existing files (this will clobber any hand-edited TypeScript).');
+        }
+        if (hasErrors || skippedExistingFiles.length > 0)
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=convert-gd.js.map

package/dist/cli/convert-gd.js.map

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

package/dist/cli/convert.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerConvertCommand(program: Command): void;
+//# sourceMappingURL=convert.d.ts.map

package/dist/cli/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/cli/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiN7D"}