typescript-to-gdscript 0.1.0

package/dist/cli/helpers.js

@@ -0,0 +1,180 @@
+/**
+ * Shared CLI helpers used by multiple commands.
+ */
+import { readdirSync, statSync, existsSync, writeFileSync, globSync } from 'fs';
+import { join, resolve } from 'path';
+import { shouldIgnore } from "../config/index.js";
+import { generateTypings, generateAddonTypings } from "../typings/scenes.js";
+import { ProjectCache } from "../cache/index.js";
+/**
+ * CLI-scoped debug flag. Set once at CLI startup by the `preAction` hook in
+ * `src/cli/index.ts` and read by `debugLog()` and `isDebugEnabled()`.
+ *
+ * This is intentional module state — it is NOT a library-level singleton. The
+ * flag is local to the short-lived CLI process; library code (`generateTypings`,
+ * `Watcher`, etc.) accepts an explicit `onDebug` callback instead of reading
+ * this flag, so test isolation is not affected.
+ */
+let _debugEnabled = false;
+export function setDebugEnabled(enabled) {
+    _debugEnabled = enabled;
+}
+export function isDebugEnabled() {
+    return _debugEnabled;
+}
+/** Print a message only when --debug is enabled. CLI-scoped (see {@link _debugEnabled}). */
+export function debugLog(message) {
+    if (_debugEnabled) {
+        console.log(message);
+    }
+}
+/** Recursively find all .ts files (excluding .d.ts, node_modules, hidden dirs, and ignored patterns) */
+export function findTsFiles(dir, rootDir, ignore) {
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir)) {
+            if (entry.startsWith('.') ||
+                entry === 'node_modules' ||
+                entry === 'addons')
+                continue;
+            const fullPath = join(dir, entry);
+            if (shouldIgnore(fullPath, rootDir, ignore))
+                continue;
+            if (statSync(fullPath).isDirectory()) {
+                results.push(...findTsFiles(fullPath, rootDir, ignore));
+            }
+            else if (entry.endsWith('.ts') && !entry.endsWith('.d.ts')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // skip inaccessible
+    }
+    return results;
+}
+/** Recursively find all .gd files (excluding node_modules, hidden dirs, and ignored patterns) */
+export function findGdFiles(dir, rootDir, ignore) {
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir)) {
+            if (entry.startsWith('.') ||
+                entry === 'node_modules' ||
+                entry === 'addons')
+                continue;
+            const fullPath = join(dir, entry);
+            if (shouldIgnore(fullPath, rootDir, ignore))
+                continue;
+            if (statSync(fullPath).isDirectory()) {
+                results.push(...findGdFiles(fullPath, rootDir, ignore));
+            }
+            else if (entry.endsWith('.gd')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // skip inaccessible
+    }
+    return results;
+}
+/** Recursively find all .gd files inside the addons/ directory */
+export function findAddonGdFiles(rootDir, ignore) {
+    const addonsDir = join(rootDir, 'addons');
+    if (!existsSync(addonsDir))
+        return [];
+    return findGdFilesRecursive(addonsDir, rootDir, ignore);
+}
+function findGdFilesRecursive(dir, rootDir, ignore) {
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir)) {
+            if (entry.startsWith('.') || entry === 'node_modules')
+                continue;
+            const fullPath = join(dir, entry);
+            if (shouldIgnore(fullPath, rootDir, ignore))
+                continue;
+            if (statSync(fullPath).isDirectory()) {
+                results.push(...findGdFilesRecursive(fullPath, rootDir, ignore));
+            }
+            else if (entry.endsWith('.gd')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // skip inaccessible
+    }
+    return results;
+}
+/**
+ * Resolve file arguments: if patterns are provided, expand them via glob;
+ * otherwise return all files of the given extension in the source directory.
+ */
+export function resolveFiles(patterns, ext, sourceDir, rootDir, ignore) {
+    if (patterns && patterns.length > 0) {
+        const files = [];
+        for (const pattern of patterns) {
+            const matches = globSync(pattern, {
+                cwd: process.cwd(),
+            }).map((m) => resolve(m));
+            for (const match of matches) {
+                const m = match.replace(/\\/g, '/');
+                if (ext === '.ts' && m.endsWith('.d.ts'))
+                    continue;
+                if (m.endsWith(ext) && !shouldIgnore(resolve(m), rootDir, ignore)) {
+                    files.push(resolve(m));
+                }
+            }
+        }
+        return files;
+    }
+    return ext === '.ts'
+        ? findTsFiles(sourceDir, rootDir, ignore)
+        : findGdFiles(sourceDir, rootDir, ignore);
+}
+/** Generate class typings (globals.d.ts) and scene typings (scene-typings.d.ts) */
+export function generateAllTypings(cfg) {
+    const tsFiles = cfg.tsFiles ?? findTsFiles(cfg.tsDir, cfg.rootDir, cfg.ignore);
+    if (tsFiles.length === 0)
+        return;
+    const cache = cfg.cacheDir ? new ProjectCache(cfg.cacheDir) : undefined;
+    const writtenFiles = generateTypings({
+        rootDir: cfg.rootDir,
+        tsDir: cfg.tsDir,
+        gdDir: cfg.gdDir,
+        files: tsFiles,
+        outputDir: cfg.typingsDir,
+        scenesDir: cfg.scenesDir,
+        tsConfigPath: cfg.tsconfig ? resolve(cfg.tsconfig) : undefined,
+        ignore: cfg.ignore,
+        projectFile: cfg.projectFile,
+        cache,
+        onDebug: debugLog,
+        godotTypingsDir: cfg.godotTypingsDir,
+        generateGlobalClassTypes: cfg.converterOptions?.generateGlobalClassTypes,
+    });
+    const addonFiles = generateAddonTypings({
+        rootDir: cfg.rootDir,
+        outputDir: cfg.typingsDir,
+        ignore: cfg.ignore,
+        cache,
+        onDebug: debugLog,
+        tsConfigPath: cfg.tsconfig ? resolve(cfg.tsconfig) : undefined,
+    });
+    debugLog(`Generated ${writtenFiles.length + addonFiles.length} typings files in ${cfg.typingsDir}`);
+}
+/** Helper functions for generate-gdscript-global-typings command */
+/**
+ * Write the entry-point `index.d.ts` referencing the static `globals/`
+ * folder and the generated `classes/` folder. Used as a fallback when
+ * the static files cannot be located (e.g. running outside an
+ * installed package layout); the normal path is to copy the canonical
+ * `index.d.ts` from the package's bundled `typings/` so the file
+ * stays in sync with the bundled `globals/` folder.
+ */
+export function writeTypingsIndexDts(typingsDir) {
+    const content = `/// <reference path="globals/globals.d.ts" />\n/// <reference path="globals/gd-helpers.d.ts" />\n/// <reference path="classes/index.d.ts" />\n`;
+    writeFileSync(join(typingsDir, 'index.d.ts'), content);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/cli/helpers.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { setDebugEnabled } from "./helpers.js";
+import { registerConvertCommand } from "./convert.js";
+import { registerInitialConvertGdToTsCommand } from "./initial-convert-gd-to-ts.js";
+import { registerValidateGdCommand } from "./validate-gd.js";
+import { registerWatchCommand } from "./watch.js";
+import { registerGenerateGdscriptGlobalTypingsCommand } from "./generate-gdscript-global-typings.js";
+import { registerGenerateTypingsCommand } from "./generate-typings.js";
+import { registerInitCommand } from "./init.js";
+import { registerGenerateAddonTypingsCommand } from "./generate-addon-typings.js";
+import { registerOpenEditorCommand } from "./open-editor.js";
+import { registerClearCacheCommand } from "./clear-cache.js";
+const program = new Command();
+program
+    .name('tstogd')
+    .description('Convert TypeScript to GDScript and back')
+    .version('0.1.0')
+    .option('--debug', 'Show debug/info messages', false)
+    .hook('preAction', () => {
+    setDebugEnabled(program.opts().debug);
+});
+// Register all commands
+registerConvertCommand(program);
+registerInitialConvertGdToTsCommand(program);
+registerValidateGdCommand(program);
+registerWatchCommand(program);
+registerGenerateTypingsCommand(program);
+registerGenerateAddonTypingsCommand(program);
+registerGenerateGdscriptGlobalTypingsCommand(program);
+registerInitCommand(program);
+registerOpenEditorCommand(program);
+registerClearCacheCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mCAAmC,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,4CAA4C,EAAE,MAAM,uCAAuC,CAAC;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,yCAAyC,CAAC;KACtD,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;KACpD,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;IACtB,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEL,wBAAwB;AACxB,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,mCAAmC,CAAC,OAAO,CAAC,CAAC;AAC7C,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACxC,mCAAmC,CAAC,OAAO,CAAC,CAAC;AAC7C,4CAA4C,CAAC,OAAO,CAAC,CAAC;AACtD,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAEnC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `tstogd init` — Interactive project initialization.
+ * Walks through config creation, tsconfig, npm install, and .gdignore setup.
+ */
+import type { Command } from 'commander';
+export declare function runInit(): Promise<void>;
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmQzC,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsC7C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO1D"}

package/dist/cli/init.js

@@ -0,0 +1,222 @@
+/**
+ * `tstogd init` — Interactive project initialization.
+ * Walks through config creation, tsconfig, npm install, and .gdignore setup.
+ */
+import * as readline from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join, basename } from 'path';
+import { execSync } from 'child_process';
+// ─── Embedded Templates ──────────────────────────────────────
+// The ts-plugin entry in `compilerOptions.plugins` is what gives the
+// IDE live converter + Godot diagnostics (squiggles on save) and
+// bridges go-to-def / find-usages between the generated shadow classes
+// in `*.gd.d.ts` and their real TypeScript sources.
+// `module: esnext` + `moduleResolution: classic` lets users (and the
+// auto-generated typings/imports) write extension-less specifiers like
+// `import { Foo } from "./foo"`. NodeNext's mandatory `.js` extension
+// rule made the generated GD→TS imports awkward (the actual on-disk
+// file is `.ts`, not `.js`), so the project standardizes on classic
+// resolution for the simpler look.
+const TSCONFIG_TEMPLATE = `{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "esnext",
+    "moduleResolution": "classic",
+    "noLib": true,
+    "strict": true,
+    "noEmit": true,
+    "types": [],
+    "plugins": [
+      { "name": "typescript-to-gdscript/ts-plugin" }
+    ]
+  },
+  "include": ["node_modules/typescript-to-gdscript/typings", "{{tsDir}}/**/*.ts", "{{typingsDir}}/**/*.d.ts"]
+}
+`;
+// ─── Prompt Helpers ──────────────────────────────────────────
+async function ask(rl, question, defaultValue) {
+    const suffix = defaultValue !== undefined ? ` (${defaultValue})` : '';
+    const answer = await rl.question(`  ${question}${suffix}: `);
+    return answer.trim() || defaultValue || '';
+}
+async function askYesNo(rl, question, defaultYes = true) {
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    const answer = await rl.question(`  ${question} ${hint}: `);
+    const normalized = answer.trim().toLowerCase();
+    if (normalized === '')
+        return defaultYes;
+    return normalized === 'y' || normalized === 'yes';
+}
+async function stepTstogdJson(rl, cwd) {
+    const configPath = join(cwd, 'tstogd.json');
+    const defaults = {
+        tsDir: 'src',
+        gdDir: 'scripts',
+        typingsDir: 'src/_typings',
+    };
+    if (existsSync(configPath)) {
+        console.log('\n✓ tstogd.json already exists.');
+        console.log('  See README.md for available configuration options.\n');
+        try {
+            const existing = JSON.parse(readFileSync(configPath, 'utf-8'));
+            return {
+                tsDir: existing.tsDir ?? defaults.tsDir,
+                gdDir: existing.gdDir ?? defaults.gdDir,
+                typingsDir: existing.typingsDir ?? defaults.typingsDir,
+            };
+        }
+        catch {
+            return defaults;
+        }
+    }
+    console.log('\n📝 Creating tstogd.json...\n');
+    const tsDir = await ask(rl, 'TypeScript source directory', defaults.tsDir);
+    const gdDir = await ask(rl, 'GDScript output directory', defaults.gdDir);
+    const typingsDir = await ask(rl, 'Typings output directory', defaults.typingsDir);
+    const config = {};
+    config.tsDir = tsDir;
+    if (gdDir !== tsDir)
+        config.gdDir = gdDir;
+    config.typingsDir = typingsDir;
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    console.log('\n  ✓ Created tstogd.json');
+    return { tsDir, gdDir, typingsDir };
+}
+// ─── Step: tsconfig.json ─────────────────────────────────────
+async function stepTsconfig(rl, cwd, config, packagesToInstall) {
+    const tsconfigPath = join(cwd, 'tsconfig.json');
+    if (existsSync(tsconfigPath)) {
+        console.log('\n✓ tsconfig.json already exists.');
+        console.log('  See README.md for recommended TypeScript settings.\n');
+        return;
+    }
+    console.log('');
+    const create = await askYesNo(rl, 'Create tsconfig.json from template?');
+    if (!create)
+        return;
+    const content = TSCONFIG_TEMPLATE.replace('{{tsDir}}', config.tsDir).replace('{{typingsDir}}', config.typingsDir);
+    writeFileSync(tsconfigPath, content);
+    console.log('  ✓ Created tsconfig.json');
+    // Ask to install TypeScript
+    const installTs = await askYesNo(rl, 'Install TypeScript?');
+    if (installTs) {
+        packagesToInstall.push('typescript');
+    }
+}
+// ─── Step: Install Packages ──────────────────────────────────
+async function stepInstallPackages(rl, cwd, packagesToInstall) {
+    if (packagesToInstall.length === 0)
+        return;
+    console.log(`\n📦 Packages to install: ${packagesToInstall.join(', ')}`);
+    // Ensure package.json exists
+    const pkgPath = join(cwd, 'package.json');
+    if (!existsSync(pkgPath)) {
+        const create = await askYesNo(rl, 'No package.json found. Create one?');
+        if (!create) {
+            console.log('  ⚠ Skipping package installation (no package.json).');
+            return;
+        }
+        const name = basename(cwd)
+            .replace(/[^a-z0-9-]/gi, '-')
+            .toLowerCase();
+        writeFileSync(pkgPath, JSON.stringify({ name, private: true, type: 'module' }, null, 2) + '\n');
+        console.log('  ✓ Created package.json');
+    }
+    console.log(`  Installing ${packagesToInstall.join(', ')}...`);
+    try {
+        execSync(`npm install --save-dev ${packagesToInstall.join(' ')}`, {
+            cwd,
+            stdio: 'inherit',
+        });
+        console.log('  ✓ Packages installed');
+    }
+    catch {
+        console.error('  ⚠ npm install failed. Please install packages manually:');
+        console.error(`    npm install --save-dev ${packagesToInstall.join(' ')}`);
+    }
+}
+// ─── Step: .gdignore ─────────────────────────────────────────
+async function stepGdignore(rl, cwd) {
+    const nodeModulesPath = join(cwd, 'node_modules');
+    const gdignorePath = join(nodeModulesPath, '.gdignore');
+    if (!existsSync(nodeModulesPath))
+        return;
+    if (existsSync(gdignorePath)) {
+        console.log('\n✓ node_modules/.gdignore already exists.');
+        return;
+    }
+    console.log('');
+    const create = await askYesNo(rl, 'Create .gdignore in node_modules to exclude from Godot?');
+    if (!create)
+        return;
+    writeFileSync(gdignorePath, '');
+    console.log('  ✓ Created node_modules/.gdignore');
+}
+// ─── Step: .gitignore ────────────────────────────────────────
+async function stepGitignore(rl, cwd) {
+    const gitignorePath = join(cwd, '.gitignore');
+    const hasGitignore = existsSync(gitignorePath);
+    const content = hasGitignore ? readFileSync(gitignorePath, 'utf-8') : '';
+    // Check if node_modules is already ignored
+    const lines = content.split('\n').map((l) => l.trim());
+    const hasNodeModulesIgnore = lines.some((l) => l === 'node_modules' ||
+        l === 'node_modules/' ||
+        l === '/node_modules' ||
+        l === '/node_modules/');
+    if (hasNodeModulesIgnore)
+        return;
+    console.log('');
+    const add = await askYesNo(rl, 'Add node_modules to .gitignore?');
+    if (!add)
+        return;
+    const newContent = hasGitignore
+        ? content.trimEnd() + '\nnode_modules/\n'
+        : 'node_modules/\n';
+    writeFileSync(gitignorePath, newContent);
+    console.log(hasGitignore
+        ? '  ✓ Added node_modules/ to .gitignore'
+        : '  ✓ Created .gitignore with node_modules/');
+}
+// ─── Main ────────────────────────────────────────────────────
+export async function runInit() {
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    const cwd = process.cwd();
+    try {
+        console.log('');
+        console.log('🎮 typescript-to-gdscript — Project Initialization');
+        console.log('═══════════════════════════════════════════════════');
+        const packagesToInstall = [];
+        // Step 1: tstogd.json
+        const config = await stepTstogdJson(rl, cwd);
+        // Step 2: tsconfig.json
+        await stepTsconfig(rl, cwd, config, packagesToInstall);
+        // Step 3: Install packages
+        await stepInstallPackages(rl, cwd, packagesToInstall);
+        // Step 4: .gdignore in node_modules
+        await stepGdignore(rl, cwd);
+        // Step 5: .gitignore
+        await stepGitignore(rl, cwd);
+        // Done
+        console.log('\n✅ Initialization complete!');
+        console.log('');
+        console.log('Next steps:');
+        console.log('  1. Create TypeScript files in your source directory');
+        console.log('  2. Run `tstogd convert` to convert TS → GDScript');
+        console.log('  3. Run `tstogd watch` for auto-conversion on save');
+        console.log('  4. See README.md for full documentation');
+        console.log('');
+    }
+    finally {
+        rl.close();
+    }
+}
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('Initialize a Godot project for typescript-to-gdscript')
+        .action(async () => {
+        await runInit();
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

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

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

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

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

package/dist/cli/initial-convert-gd-to-ts.js

@@ -0,0 +1,149 @@
+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 registerInitialConvertGdToTsCommand(program) {
+    program
+        .command('initial-convert-gd-to-ts')
+        .description('One-shot bulk GD→TS conversion for the initial migration. Refuses to overwrite existing .ts files unless --force is passed.')
+        .argument('[files...]', 'GDScript files or glob patterns to convert')
+        .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 relPath = relative(cfg.gdDir, filePath);
+            const outputPath = resolve(cfg.tsDir, relPath.replace(/\.gd$/, '.ts'));
+            // Skip BEFORE conversion: don't waste work re-parsing, and don't
+            // surface diagnostics for a file we won't touch (those would be
+            // confusing — the user can't act on them without `--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;
+            }
+            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;
+            }
+            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=initial-convert-gd-to-ts.js.map