typescript-to-gdscript 0.1.0

package/dist/cli/convert.js

@@ -0,0 +1,165 @@
+import { writeFileSync, mkdirSync } from 'fs';
+import { resolve, dirname, relative } from 'path';
+import { convertTsToGd } from "../converter/ts-to-gd/index.js";
+import { createTsProgram } from "../parser/typescript/index.js";
+import { resolveConfig, resolveGodotPath } from "../config/index.js";
+import { ProjectCache } from "../cache/index.js";
+import { isConversionErrorSeverity } from "../converter/common/index.js";
+import { debugLog, resolveFiles, generateAllTypings } from "./helpers.js";
+import { collectProjectDiagnostics, printDiagnostics, summarizeDiagnostics, hasReportableErrors, } from "../checker/index.js";
+export function registerConvertCommand(program) {
+    program
+        .command('convert')
+        .description('Convert TypeScript file(s) to GDScript. If no files given, converts all .ts files in tsDir. ' +
+        'After writing, runs full diagnostic check (TS + converter + Godot) unless --no-check is set.')
+        .argument('[files...]', 'TypeScript files or glob patterns to convert')
+        .option('--ts-dir <dir>', 'TypeScript source directory')
+        .option('--gd-dir <dir>', 'GDScript output directory')
+        .option('--root-dir <dir>', 'Root directory', '.')
+        .option('--tsconfig <path>', 'Path to tsconfig.json')
+        .option('--godot-path <path>', 'Path to Godot executable (enables GDScript validation)')
+        .option('--project-root <dir>', 'Godot project root for validation')
+        .option('--no-cache', 'Disable cache (force full reconversion)')
+        .option('--emit-on-error', 'Emit output files even when conversion errors occur', false)
+        .option('--no-emit', 'Dry-run: convert in memory, check for stale outputs, do not write files')
+        .option('--no-check', 'Skip the post-convert diagnostic check (TS + Godot)')
+        .action(async (files, opts) => {
+        const cfg = resolveConfig({
+            overrides: {
+                rootDir: opts.rootDir,
+                tsDir: opts.tsDir,
+                gdDir: opts.gdDir,
+                tsconfig: opts.tsconfig,
+                godotPath: opts.godotPath,
+            },
+        });
+        const resolvedFiles = resolveFiles(files.length > 0 ? files : undefined, '.ts', cfg.tsDir, cfg.rootDir, cfg.ignore);
+        if (resolvedFiles.length === 0) {
+            console.log('No TypeScript files found to convert.');
+            return;
+        }
+        // commander: --no-emit sets opts.emit = false, --no-check sets opts.check = false
+        const noEmit = opts.emit === false;
+        const noCheck = opts.check === false;
+        const useCache = opts.cache !== false;
+        const cache = useCache ? new ProjectCache(cfg.cacheDir) : null;
+        debugLog(`${noEmit ? 'Checking' : 'Converting'} ${resolvedFiles.length} file(s)...`);
+        // Build the ts.Program once and share it across the write loop and the
+        // post-convert checker — avoids re-parsing every .ts file twice.
+        debugLog(`Building shared ts.Program (${resolvedFiles.length} file(s))`);
+        const sharedProgram = createTsProgram({
+            rootDir: cfg.tsDir,
+            files: resolvedFiles.filter((f) => !f.endsWith('.d.ts')),
+            tsConfigPath: cfg.tsconfig ? resolve(cfg.tsconfig) : undefined,
+        });
+        let hasErrors = false;
+        let skipped = 0;
+        if (!noEmit) {
+            // ── Write mode ───────────────────────────────────��─────
+            for (const filePath of resolvedFiles) {
+                const relPath = relative(cfg.tsDir, filePath);
+                const outputPath = resolve(cfg.gdDir, relPath.replace(/\.ts$/, '.gd'));
+                if (cache?.isTsToGdFresh(filePath, outputPath)) {
+                    debugLog(`Skipped (cache): ${outputPath}`);
+                    skipped++;
+                    continue;
+                }
+                if (cache && cache.hasFreshCachedGd(filePath)) {
+                    const promoted = cache.promoteCachedGd(filePath, outputPath);
+                    if (promoted && cache.isTsToGdFresh(filePath, outputPath)) {
+                        debugLog(`Promoted (cache-folder): ${outputPath}`);
+                        skipped++;
+                        continue;
+                    }
+                }
+                const result = convertTsToGd({
+                    filePath,
+                    rootDir: cfg.tsDir,
+                    tsDir: cfg.tsDir,
+                    gdDir: cfg.gdDir,
+                    projectRoot: cfg.rootDir,
+                    tsConfigPath: cfg.tsconfig ? resolve(cfg.tsconfig) : undefined,
+                    sourceMap: true,
+                    program: sharedProgram,
+                });
+                // When the post-convert checker runs, it will print converter diagnostics
+                // (from cache or fresh re-convert). Only print here when --no-check is set,
+                // so users with --no-check still see errors.
+                if (noCheck) {
+                    for (const diag of result.diagnostics) {
+                        if (diag.severity === 'info')
+                            continue;
+                        console.error(`[CONV:${diag.severity}] ${diag.file}:${diag.line}:${diag.column} - ${diag.message}`);
+                    }
+                }
+                if (result.diagnostics.some((d) => isConversionErrorSeverity(d.severity))) {
+                    hasErrors = true;
+                    if (!opts.emitOnError)
+                        continue;
+                }
+                mkdirSync(dirname(outputPath), { recursive: true });
+                writeFileSync(outputPath, result.code);
+                debugLog(`Written: ${outputPath}`);
+                if (cache && result.sourceMap) {
+                    cache.updateTsToGd(filePath, outputPath, result.sourceMap, result.diagnostics, {
+                        gdContent: result.code,
+                    });
+                }
+            }
+            if (skipped > 0)
+                debugLog(`Skipped ${skipped} unchanged file(s)`);
+            if (cache) {
+                const currentFiles = new Set(resolvedFiles.map((f) => f.replace(/\\/g, '/')));
+                cache.cleanStale(currentFiles);
+                cache.save();
+            }
+            generateAllTypings({ ...cfg, tsFiles: resolvedFiles });
+        }
+        // ── Diagnostic check ────────────────────────────────────
+        if (!noCheck) {
+            debugLog('Starting diagnostic check phase');
+            let godotPath;
+            if (!cfg.disableGodotLint) {
+                try {
+                    godotPath = resolveGodotPath({ godotPath: cfg.godotPath });
+                }
+                catch {
+                    // godotPath unavailable — Godot check skipped
+                }
+            }
+            const projectRoot = opts.projectRoot
+                ? resolve(opts.projectRoot)
+                : cfg.rootDir;
+            debugLog(`Diagnostic check: godotPath=${godotPath ?? '(skipped)'}, tsConfig=${cfg.tsconfig ?? '(none)'}, projectRoot=${projectRoot}`);
+            const checkResult = await collectProjectDiagnostics({
+                tsDir: cfg.tsDir,
+                gdDir: cfg.gdDir,
+                projectRoot,
+                tsFiles: resolvedFiles.filter((f) => !f.endsWith('.d.ts')),
+                tsConfigPath: cfg.tsconfig ? resolve(cfg.tsconfig) : undefined,
+                cache,
+                godotPath,
+                cacheDir: cfg.cacheDir,
+                noEmit,
+                program: sharedProgram,
+                onDebug: debugLog,
+            });
+            printDiagnostics(checkResult.tsDiagnostics, 'TS');
+            printDiagnostics(checkResult.converterDiagnostics, 'CONV');
+            printDiagnostics(checkResult.godotDiagnostics, 'GD');
+            if (hasReportableErrors(checkResult))
+                hasErrors = true;
+            const summary = summarizeDiagnostics(checkResult);
+            if (summary) {
+                console.log('\nCheck complete:');
+                console.log(summary);
+            }
+            else {
+                console.log('\nCheck complete: no issues found.');
+            }
+        }
+        if (hasErrors)
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=convert.js.map

package/dist/cli/convert.js.map

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

package/dist/cli/generate-addon-typings.d.ts

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

package/dist/cli/generate-addon-typings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-addon-typings.d.ts","sourceRoot":"","sources":["../../src/cli/generate-addon-typings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8B1E"}

package/dist/cli/generate-addon-typings.js

@@ -0,0 +1,31 @@
+import { resolve } from 'path';
+import { generateAddonTypings } from "../typings/scenes.js";
+import { resolveConfig } from "../config/index.js";
+import { ProjectCache } from "../cache/index.js";
+import { debugLog } from "./helpers.js";
+export function registerGenerateAddonTypingsCommand(program) {
+    program
+        .command('generate-addon-typings')
+        .description('Generate TypeScript typings for GDScript addon files in addons/')
+        .option('-o, --output <path>', 'Output directory for generated typings')
+        .option('--root-dir <dir>', 'Root directory', '.')
+        .action((opts) => {
+        const cfg = resolveConfig({
+            overrides: {
+                rootDir: opts.rootDir,
+            },
+        });
+        const outputDir = opts.output ? resolve(opts.output) : cfg.typingsDir;
+        const cache = new ProjectCache(cfg.cacheDir);
+        const writtenFiles = generateAddonTypings({
+            rootDir: cfg.rootDir,
+            outputDir,
+            ignore: cfg.ignore,
+            cache,
+            onDebug: debugLog,
+            tsConfigPath: cfg.tsconfig ? resolve(cfg.tsconfig) : undefined,
+        });
+        debugLog(`Generated ${writtenFiles.length} addon typings files in ${outputDir}`);
+    });
+}
+//# sourceMappingURL=generate-addon-typings.js.map

package/dist/cli/generate-addon-typings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-addon-typings.js","sourceRoot":"","sources":["../../src/cli/generate-addon-typings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,UAAU,mCAAmC,CAAC,OAAgB;IAClE,OAAO;SACJ,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CACV,iEAAiE,CAClE;SACA,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;SACvE,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,CAAC;SACjD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,GAAG,GAAG,aAAa,CAAC;YACxB,SAAS,EAAE;gBACT,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;SACF,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;QACtE,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7C,MAAM,YAAY,GAAG,oBAAoB,CAAC;YACxC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS;YACT,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK;YACL,OAAO,EAAE,QAAQ;YACjB,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SAC/D,CAAC,CAAC;QACH,QAAQ,CACN,aAAa,YAAY,CAAC,MAAM,2BAA2B,SAAS,EAAE,CACvE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/generate-gdscript-global-typings.d.ts

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

package/dist/cli/generate-gdscript-global-typings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-gdscript-global-typings.d.ts","sourceRoot":"","sources":["../../src/cli/generate-gdscript-global-typings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkFzC,wBAAgB,4CAA4C,CAC1D,OAAO,EAAE,OAAO,GACf,IAAI,CAmHN"}

package/dist/cli/generate-gdscript-global-typings.js

@@ -0,0 +1,172 @@
+import { existsSync, mkdirSync, cpSync, copyFileSync, statSync } from 'fs';
+import { resolve, join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { generateGodotDocsTypings } from "../typings/godot-docs.js";
+import { parseGodotVersion } from "../typings/godot-registry.js";
+import { writeTypingsIndexDts } from "./helpers.js";
+/**
+ * Print an error and exit non-zero. Typed `never` so TypeScript narrows
+ * subsequent code as if the call were a `throw` — eliminates the need
+ * for `as` casts after validation guards.
+ */
+function fail(message) {
+    console.error(message);
+    process.exit(1);
+}
+/**
+ * Detects Godot version from `version.py` near any of the given docs
+ * dirs. For each dir, candidates are tried in this order:
+ *
+ *   1. `<dir>/../../version.py` — covers the canonical
+ *      `vendor/godot/doc/classes/` layout (two levels up).
+ *   2. `<dir>/../version.py` — fallback for callers that already
+ *      pass a one-level-deep dir (e.g. `vendor/godot/some_subdir/`).
+ *
+ * If multiple dirs resolve to different versions, prints a warning
+ * and returns the first hit so we don't silently pick a value the
+ * caller may not expect.
+ */
+function detectGodotVersion(docsDirs) {
+    const hits = [];
+    for (const docsDir of docsDirs) {
+        const candidates = [
+            join(docsDir, '..', '..', 'version.py'),
+            join(docsDir, '..', 'version.py'),
+        ];
+        for (const candidate of candidates) {
+            if (existsSync(candidate)) {
+                const ver = parseGodotVersion(candidate);
+                hits.push({ docsDir, versionFile: candidate, short: ver.short });
+                break;
+            }
+        }
+    }
+    if (hits.length === 0)
+        return null;
+    const distinct = [...new Set(hits.map((h) => h.short))];
+    if (distinct.length > 1) {
+        console.warn(`[WARN] --docs-dir entries resolve to conflicting Godot versions (${distinct.join(', ')}). Using "${hits[0].short}" from ${hits[0].versionFile}. Make sure all docs dirs come from the same Godot tree.`);
+    }
+    return hits[0].short;
+}
+/**
+ * Resolve the bundled `typings-overrides/` directory at the package root.
+ * From `src/cli/<this>.ts` and the built `dist/cli/<this>.js`, `'..', '..'`
+ * both resolve to `<package_root>/typings-overrides`, so the same path works
+ * for source mode (`tsx`), local builds, and installed-as-dependency layouts.
+ */
+function getDefaultOverrideDir() {
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    return resolve(thisDir, '..', '..', 'typings-overrides');
+}
+/**
+ * Resolve this package's bundled user-facing `typings/` directory —
+ * the folder that ships `globals/`, `index.d.ts`, and (when published)
+ * a pre-built `classes/`. From `src/cli/<this>.ts` and the built
+ * `dist/cli/<this>.js`, both `'..', '..', 'typings'` resolve to
+ * `<package_root>/typings`, so the same path works for source mode
+ * (`tsx`), local builds, and installed-as-dependency layouts.
+ */
+function getPackageTypingsDir() {
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    return resolve(thisDir, '..', '..', 'typings');
+}
+export function registerGenerateGdscriptGlobalTypingsCommand(program) {
+    program
+        .command('generate-gdscript-global-typings')
+        .description('Generate TypeScript typings and class registry from Godot docs')
+        .option('--docs-dir <dirs...>', 'Godot XML class documentation directories. Accepts one or more paths — Godot ships docs across `doc/classes/` and `modules/<module>/doc_classes/` (notably `modules/gdscript/doc_classes/` for `@GDScript.xml`). Pass every dir whose XMLs you want included; later dirs override earlier ones for same-named classes.')
+        .option('--output-dir <dir>', 'Root typings output directory', 'typings')
+        .option('--override-dir <dir>', 'User override directory for .d.ts files and non-nullable.json (combined with bundled defaults unless --no-default-overrides is set)')
+        .option('--no-default-overrides', 'Disable the bundled default overrides')
+        .action((opts) => {
+        // Variadic options collect into an array; commander gives us
+        // either an array (when present), `undefined` (omitted), or
+        // `true` (flag passed without a value — invalid here).
+        const rawDocsDirs = opts.docsDir;
+        if (!Array.isArray(rawDocsDirs) ||
+            rawDocsDirs.length === 0 ||
+            !rawDocsDirs.every((d) => typeof d === 'string')) {
+            fail('--docs-dir is required (one or more directories)');
+        }
+        const docsDirs = rawDocsDirs.map((d) => resolve(d));
+        // Validate each path early. Variadic options consume positional
+        // values until the next flag, so a stray non-dir argument (e.g.
+        // `--docs-dir doc1 doc2 typings` where `typings` was meant for
+        // `--output-dir`) would otherwise fail deep inside `readdirSync`
+        // with an opaque ENOENT. Surfacing it here points at the exact
+        // bad path AND nudges the user toward the "place --docs-dir
+        // last" convention.
+        for (const d of docsDirs) {
+            if (!existsSync(d)) {
+                fail(`--docs-dir path does not exist: ${d}\n` +
+                    `(hint: place --docs-dir LAST on the command line — variadic options ` +
+                    `consume every following positional value until the next flag)`);
+            }
+            if (!statSync(d).isDirectory()) {
+                fail(`--docs-dir path is not a directory: ${d}`);
+            }
+        }
+        const typingsRoot = resolve(opts.outputDir);
+        mkdirSync(typingsRoot, { recursive: true });
+        const version = detectGodotVersion(docsDirs);
+        if (!version) {
+            fail('Could not detect Godot version from vendor/godot/version.py near any of the given --docs-dir paths');
+        }
+        // Resolve override directories. Order: defaults first, user last (later dirs win).
+        const overrideDirs = [];
+        if (opts.defaultOverrides !== false) {
+            const defaultDir = getDefaultOverrideDir();
+            if (existsSync(defaultDir))
+                overrideDirs.push(defaultDir);
+        }
+        if (opts.overrideDir) {
+            const userDir = resolve(opts.overrideDir);
+            if (existsSync(userDir))
+                overrideDirs.push(userDir);
+        }
+        const registryPath = join(typingsRoot, 'godot-class-registry.json');
+        generateGodotDocsTypings({
+            classDocsDir: docsDirs,
+            outputDir: typingsRoot,
+            overrideDirs,
+            registryOutputPath: registryPath,
+            version,
+        });
+        // Static globals (`globals/`, `index.d.ts`) ship with this
+        // package and are NOT regenerated from Godot docs. When the
+        // user is generating into their own consumer project, copy the
+        // bundled copies over so `tsc` can resolve `int`, `float`,
+        // `gd.signal`, the `noLib` global stubs, etc. Skip the copy
+        // when the destination IS this package's own bundled folder
+        // (e.g. `yarn generate:godot-typings` in the source tree) —
+        // the static files are already there and re-copying them onto
+        // themselves would be a no-op at best.
+        const pkgTypingsDir = getPackageTypingsDir();
+        const isSelfRefresh = resolve(typingsRoot) === resolve(pkgTypingsDir);
+        if (!isSelfRefresh) {
+            const srcGlobals = join(pkgTypingsDir, 'globals');
+            const srcIndex = join(pkgTypingsDir, 'index.d.ts');
+            if (existsSync(srcGlobals)) {
+                cpSync(srcGlobals, join(typingsRoot, 'globals'), { recursive: true });
+            }
+            if (existsSync(srcIndex)) {
+                copyFileSync(srcIndex, join(typingsRoot, 'index.d.ts'));
+            }
+            else {
+                // Fallback for unusual layouts where the bundled
+                // `index.d.ts` is missing — synthesise one with the same
+                // references so the generated tree is still usable.
+                writeTypingsIndexDts(typingsRoot);
+            }
+        }
+        else {
+            // Self-refresh: regenerate index.d.ts in place so the file
+            // stays in sync with the helper's reference list even when
+            // `globals/` was edited by hand.
+            writeTypingsIndexDts(typingsRoot);
+        }
+        console.log(`Generated typings for Godot ${version} in ${typingsRoot}`);
+    });
+}
+//# sourceMappingURL=generate-gdscript-global-typings.js.map

package/dist/cli/generate-gdscript-global-typings.js.map

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

package/dist/cli/generate-typings.d.ts

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

package/dist/cli/generate-typings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-typings.d.ts","sourceRoot":"","sources":["../../src/cli/generate-typings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0DrE"}

package/dist/cli/generate-typings.js

@@ -0,0 +1,48 @@
+import { resolve } from 'path';
+import { generateTypings } from "../typings/scenes.js";
+import { resolveConfig } from "../config/index.js";
+import { ProjectCache } from "../cache/index.js";
+import { debugLog, resolveFiles } from "./helpers.js";
+export function registerGenerateTypingsCommand(program) {
+    program
+        .command('generate-typings')
+        .description('Generate globals.d.ts with class declarations, scene overloads, GodotResources, and autoloads. If no files given, scans tsDir.')
+        .argument('[files...]', 'TypeScript source files or glob patterns')
+        .option('-o, --output <path>', 'Output .d.ts file path')
+        .option('--typings-dir <path>', 'Directory for all generated typings (relative to rootDir)')
+        .option('--root-dir <dir>', 'Root directory', '.')
+        .option('--tsconfig <path>', 'Path to tsconfig.json')
+        .action((files, opts) => {
+        const cfg = resolveConfig({
+            overrides: {
+                rootDir: opts.rootDir,
+                typingsDir: opts.typingsDir,
+                tsconfig: opts.tsconfig,
+            },
+        });
+        const resolvedFiles = resolveFiles(files.length > 0 ? files : undefined, '.ts', cfg.tsDir, cfg.rootDir, cfg.ignore);
+        if (resolvedFiles.length === 0) {
+            console.log('No TypeScript files found.');
+            return;
+        }
+        const outputDir = opts.output ? resolve(opts.output) : cfg.typingsDir;
+        const cache = new ProjectCache(cfg.cacheDir);
+        const writtenFiles = generateTypings({
+            rootDir: cfg.rootDir,
+            tsDir: cfg.tsDir,
+            gdDir: cfg.gdDir,
+            files: resolvedFiles,
+            outputDir,
+            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,
+        });
+        debugLog(`Generated ${writtenFiles.length} typings files in ${outputDir}`);
+    });
+}
+//# sourceMappingURL=generate-typings.js.map

package/dist/cli/generate-typings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-typings.js","sourceRoot":"","sources":["../../src/cli/generate-typings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,UAAU,8BAA8B,CAAC,OAAgB;IAC7D,OAAO;SACJ,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CACV,gIAAgI,CACjI;SACA,QAAQ,CAAC,YAAY,EAAE,0CAA0C,CAAC;SAClE,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;SACvD,MAAM,CACL,sBAAsB,EACtB,2DAA2D,CAC5D;SACA,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,GAAG,CAAC;SACjD,MAAM,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;SACpD,MAAM,CAAC,CAAC,KAAe,EAAE,IAAI,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,aAAa,CAAC;YACxB,SAAS,EAAE;gBACT,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB;SACF,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,YAAY,CAChC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EACpC,KAAK,EACL,GAAG,CAAC,KAAK,EACT,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,MAAM,CACX,CAAC;QAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;QACtE,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7C,MAAM,YAAY,GAAG,eAAe,CAAC;YACnC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,aAAa;YACpB,SAAS;YACT,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;YAC9D,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,KAAK;YACL,OAAO,EAAE,QAAQ;YACjB,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,wBAAwB,EAAE,GAAG,CAAC,gBAAgB,CAAC,wBAAwB;SACxE,CAAC,CAAC;QACH,QAAQ,CACN,aAAa,YAAY,CAAC,MAAM,qBAAqB,SAAS,EAAE,CACjE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/helpers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Shared CLI helpers used by multiple commands.
+ */
+export declare function setDebugEnabled(enabled: boolean): void;
+export declare function isDebugEnabled(): boolean;
+/** Print a message only when --debug is enabled. CLI-scoped (see {@link _debugEnabled}). */
+export declare function debugLog(message: string): void;
+/** Recursively find all .ts files (excluding .d.ts, node_modules, hidden dirs, and ignored patterns) */
+export declare function findTsFiles(dir: string, rootDir: string, ignore: string[]): string[];
+/** Recursively find all .gd files (excluding node_modules, hidden dirs, and ignored patterns) */
+export declare function findGdFiles(dir: string, rootDir: string, ignore: string[]): string[];
+/** Recursively find all .gd files inside the addons/ directory */
+export declare function findAddonGdFiles(rootDir: string, ignore: string[]): string[];
+/**
+ * Resolve file arguments: if patterns are provided, expand them via glob;
+ * otherwise return all files of the given extension in the source directory.
+ */
+export declare function resolveFiles(patterns: string[] | undefined, ext: '.ts' | '.gd', sourceDir: string, rootDir: string, ignore: string[]): string[];
+/** Generate class typings (globals.d.ts) and scene typings (scene-typings.d.ts) */
+export declare function generateAllTypings(cfg: {
+    rootDir: string;
+    tsDir: string;
+    gdDir: string;
+    typingsDir: string;
+    scenesDir: string;
+    ignore: string[];
+    projectFile: string;
+    tsconfig?: string;
+    tsFiles?: string[];
+    cacheDir?: string;
+    godotTypingsDir?: string;
+    /** See `ConverterOptions.generateGlobalClassTypes`. */
+    converterOptions?: {
+        generateGlobalClassTypes?: boolean;
+    };
+}): void;
+/** 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 declare function writeTypingsIndexDts(typingsDir: string): void;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/cli/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI9C;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,EAAE,CAsBV;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,EAAE,CAsBV;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI5E;AAyBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAC9B,GAAG,EAAE,KAAK,GAAG,KAAK,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,EAAE,CAoBV;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE;QAAE,wBAAwB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D,GAAG,IAAI,CAmCP;AAED,oEAAoE;AAEpE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAG7D"}