typescript-to-gdscript 0.1.0

package/dist/typings/content-generators.js

@@ -0,0 +1,536 @@
+import { existsSync } from 'fs';
+import { join, relative } from 'path';
+import { buildNodeTree, collectDescendantPaths } from "./scene-tree.js";
+import { sceneResPathToAlias, sceneResPathToTreeName, sceneResPathToParentsInterfaceName, scriptResPathToTreesInterfaceName, nodePathToTypeName, } from "./scene-utils.js";
+// ─── Helpers ────────────────────────────────────────────────
+/**
+ * Compute a relative `/// <reference path>` from outputDir to godotTypingsDir/index.d.ts.
+ * Returns undefined if the index.d.ts doesn't exist.
+ */
+export function resolveGodotTypingsRef(outputDir, godotTypingsDir) {
+    const indexPath = join(godotTypingsDir, 'index.d.ts');
+    if (!existsSync(indexPath))
+        return undefined;
+    return relative(outputDir, indexPath).replace(/\\/g, '/');
+}
+// ─── Content Generators ─────────────────────────────────────
+/**
+ * Generate .tscn.d.ts file content for a single scene.
+ */
+export function generateSceneTypingContent(sceneResPath, sceneData, uniqueNameNodes, connections) {
+    const lines = [];
+    lines.push('// AUTO-GENERATED — do not edit manually.\n');
+    const alias = sceneResPathToAlias(sceneResPath);
+    const treeName = sceneResPathToTreeName(sceneResPath);
+    const parentsInterface = sceneResPathToParentsInterfaceName(sceneResPath);
+    const root = buildNodeTree(sceneData);
+    // Collect instanced scenes. Two kinds:
+    // 1. Plain instanced scenes (no extra children) -> GodotSceneTrees lookup
+    // 2. Extended instanced scenes (has extra children added by parent scene) -> local __node_extends type
+    const instancedSceneTreeNames = new Map();
+    // Set of instanced node fullPaths that have extra children (need __node_extends)
+    const extendedInstancedNodes = new Set();
+    function findInstancedScenes(node) {
+        for (const child of node.children) {
+            if (child.isInstanced && child.instanceSceneResPath) {
+                if (child.children.length > 0) {
+                    // Instanced scene with extra children added -> needs local extension type
+                    extendedInstancedNodes.add(child.fullPath);
+                }
+                else if (!instancedSceneTreeNames.has(child.instanceSceneResPath)) {
+                    instancedSceneTreeNames.set(child.instanceSceneResPath, sceneResPathToTreeName(child.instanceSceneResPath));
+                }
+            }
+            if (!child.isInstanced) {
+                findInstancedScenes(child);
+            }
+        }
+    }
+    findInstancedScenes(root);
+    /** Get the type name for a child node, handling instanced/extended cases */
+    function childTypeName(child) {
+        if (child.isInstanced && child.instanceSceneResPath) {
+            if (extendedInstancedNodes.has(child.fullPath)) {
+                return nodePathToTypeName(alias, child.fullPath);
+            }
+            return instancedSceneTreeNames.get(child.instanceSceneResPath) ?? sceneResPathToTreeName(child.instanceSceneResPath);
+        }
+        return nodePathToTypeName(alias, child.fullPath);
+    }
+    // Collect all non-instanced nodes AND nodes under extended instanced scenes
+    const emittableNodes = [];
+    function collectEmittable(node) {
+        for (const child of node.children) {
+            if (child.isInstanced && !extendedInstancedNodes.has(child.fullPath)) {
+                continue; // Plain instanced: skip, handled as GodotSceneTrees lookup
+            }
+            collectEmittable(child);
+            emittableNodes.push(child);
+        }
+    }
+    collectEmittable(root);
+    // Build unique name entries and emit shared type (available from every subtree via intersection)
+    const uniqueEntries = [];
+    {
+        const allRootDescendants = collectDescendantPaths(root, alias, instancedSceneTreeNames, extendedInstancedNodes);
+        for (const uniqueName of uniqueNameNodes) {
+            const match = allRootDescendants.find(p => {
+                const parts = p.relativePath.split('/');
+                return parts[parts.length - 1] === uniqueName;
+            });
+            if (match) {
+                uniqueEntries.push({ name: uniqueName, typeName: match.typeName });
+            }
+        }
+    }
+    const uniqueNodesTypeName = `${alias}_UniqueNodes`;
+    const hasUniqueNodes = uniqueEntries.length > 0;
+    if (hasUniqueNodes) {
+        lines.push(`type ${uniqueNodesTypeName} = {`);
+        for (const { name, typeName: uTypeName } of uniqueEntries) {
+            lines.push(`  "%${name}": ${uTypeName};`);
+        }
+        lines.push(`};\n`);
+    }
+    // Helper to emit __node_unique property on a node type
+    const uniqueProp = hasUniqueNodes ? `  [__node_unique]: ${uniqueNodesTypeName};` : '';
+    for (const node of emittableNodes) {
+        const typeName = nodePathToTypeName(alias, node.fullPath);
+        const parentTypeName = node.parentPath === '.'
+            ? treeName
+            : nodePathToTypeName(alias, node.parentPath);
+        const isExtendedInstanced = extendedInstancedNodes.has(node.fullPath);
+        const childTupleEntries = node.children.map(c => childTypeName(c));
+        const descendantPaths = collectDescendantPaths(node, alias, instancedSceneTreeNames, extendedInstancedNodes);
+        if (isExtendedInstanced) {
+            const baseResPath = node.instanceSceneResPath;
+            lines.push(`type ${typeName} = {`);
+            lines.push(`  [__node_extends]: GodotSceneTrees["${baseResPath}"];`);
+            lines.push(`  [__node_root]: "${node.name}";`);
+            lines.push(`  [__node_type]: _GDTreeGetType<GodotSceneTrees["${baseResPath}"]>;`);
+            lines.push(`  [__node_parent]: ${parentTypeName};`);
+            lines.push(`  [__node_children]: [${childTupleEntries.join(', ')}];`);
+        }
+        else {
+            const nodeTypeExpr = node.scriptResPath
+                ? `_GDGetInterfaceNode<GodotScripts, "${node.scriptResPath}">`
+                : node.type;
+            lines.push(`type ${typeName} = {`);
+            lines.push(`  [__node_type]: ${nodeTypeExpr};`);
+            lines.push(`  [__node_parent]: ${parentTypeName};`);
+            lines.push(`  [__node_children]: [${childTupleEntries.join(', ')}];`);
+        }
+        lines.push(uniqueProp);
+        for (const { relativePath, typeName: childType } of descendantPaths) {
+            lines.push(`  "${relativePath}": ${childType};`);
+        }
+        lines.push(`};\n`);
+    }
+    // Emit plain instanced scene tree type aliases (via GodotSceneTrees lookup)
+    for (const [instanceResPath, localTreeName] of instancedSceneTreeNames) {
+        lines.push(`type ${localTreeName} = GodotSceneTrees["${instanceResPath}"];\n`);
+    }
+    // Emit root _Tree type
+    const rootScriptResPath = sceneData.rootScript?.scriptResPath;
+    const inheritedSceneResPath = sceneData.inheritedSceneResPath;
+    const rootNodeType = rootScriptResPath
+        ? `_GDGetInterfaceNode<GodotScripts, "${rootScriptResPath}">`
+        : inheritedSceneResPath
+            ? `_GDTreeGetType<GodotSceneTrees["${inheritedSceneResPath}"]>`
+            : (sceneData.nodeTypes.get('.') ?? 'Node');
+    const rootChildTupleEntries = root.children.map(c => childTypeName(c));
+    const rootDescendantPaths = collectDescendantPaths(root, alias, instancedSceneTreeNames, extendedInstancedNodes);
+    lines.push(`type ${treeName} = {`);
+    if (inheritedSceneResPath) {
+        lines.push(`  [__node_extends]: GodotSceneTrees["${inheritedSceneResPath}"];`);
+    }
+    lines.push(`  [__node_root]: "${sceneData.rootNodeName}";`);
+    lines.push(`  [__node_type]: ${rootNodeType};`);
+    lines.push(`  [__node_parent]: _GDGetInterfaceParent<${parentsInterface}>;`);
+    lines.push(`  [__node_children]: [${rootChildTupleEntries.join(', ')}];`);
+    lines.push(uniqueProp);
+    for (const { relativePath, typeName } of rootDescendantPaths) {
+        lines.push(`  "${relativePath}": ${typeName};`);
+    }
+    lines.push(`};\n`);
+    // Emit declare global block
+    lines.push(`declare global {`);
+    lines.push(`  interface ${parentsInterface} {}\n`);
+    // __ScriptGd__Trees entry (if root has a script)
+    if (rootScriptResPath) {
+        const treesInterface = scriptResPathToTreesInterfaceName(rootScriptResPath);
+        lines.push(`  interface ${treesInterface} {`);
+        lines.push(`    "${sceneResPath}": ${treeName};`);
+        lines.push(`  }\n`);
+    }
+    // __ScriptGd__Trees entries for non-root scripted nodes: map the script's
+    // Trees interface to the sub-tree type for this node.
+    for (const node of emittableNodes) {
+        if (!node.scriptResPath)
+            continue;
+        const treesInterface = scriptResPathToTreesInterfaceName(node.scriptResPath);
+        const subTypeName = nodePathToTypeName(alias, node.fullPath);
+        lines.push(`  interface ${treesInterface} {`);
+        lines.push(`    "${sceneResPath}": ${subTypeName};`);
+        lines.push(`  }\n`);
+    }
+    // Instanced scene parent entries
+    const instancedParentEntries = [];
+    for (const child of root.children) {
+        if (child.isInstanced && child.instanceSceneResPath) {
+            instancedParentEntries.push({
+                parentsInterface: sceneResPathToParentsInterfaceName(child.instanceSceneResPath),
+                sceneResPath,
+            });
+        }
+    }
+    // TileMap embedded scene parent entries
+    for (const [, { sceneResPaths }] of sceneData.embeddedScenes) {
+        for (const embeddedResPath of sceneResPaths) {
+            instancedParentEntries.push({
+                parentsInterface: sceneResPathToParentsInterfaceName(embeddedResPath),
+                sceneResPath,
+            });
+        }
+    }
+    if (instancedParentEntries.length > 0) {
+        lines.push(`  // Instanced scene parents`);
+        for (const { parentsInterface: pi, sceneResPath: srp } of instancedParentEntries) {
+            lines.push(`  interface ${pi} { "${srp}": ${treeName}; }`);
+        }
+        lines.push('');
+    }
+    // GodotSceneTrees entry
+    lines.push(`  interface GodotSceneTrees {`);
+    lines.push(`    "${sceneResPath}": ${treeName};`);
+    lines.push(`  }`);
+    // GodotScenes entry (node type, not tree type)
+    lines.push(`  interface GodotScenes {`);
+    lines.push(`    "${sceneResPath}": _GDTreeNode<${treeName}>;`);
+    lines.push(`  }`);
+    // GodotResources entry
+    lines.push(`  interface GodotResources {`);
+    lines.push(`    "${sceneResPath}": PackedScene<_GDTreeNode<${treeName}>>;`);
+    lines.push(`  }`);
+    // GodotGroups entries — per-group interfaces + GodotGroups mapping
+    if (sceneData.nodeGroups.size > 0) {
+        const groupEntries = [];
+        for (const [groupName, groupNodes] of sceneData.nodeGroups) {
+            const treeExprs = [];
+            for (const node of groupNodes) {
+                if (node.instanceSceneResPath) {
+                    treeExprs.push(`GodotSceneTrees["${node.instanceSceneResPath}"]`);
+                }
+                else if (node.nodePath === '.') {
+                    treeExprs.push(treeName);
+                }
+                else {
+                    treeExprs.push(nodePathToTypeName(alias, node.nodePath));
+                }
+            }
+            if (treeExprs.length > 0) {
+                const uniqueExprs = [...new Set(treeExprs)];
+                const interfaceName = `__GodotGroup_${groupName.replace(/[^a-zA-Z0-9_]/g, '_')}`;
+                lines.push(`  interface ${interfaceName} {`);
+                lines.push(`    "${sceneResPath}": ${uniqueExprs.join(' | ')}`);
+                lines.push(`  }`);
+                groupEntries.push({ groupName, interfaceName, typeExpr: uniqueExprs.join(' | ') });
+            }
+        }
+        if (groupEntries.length > 0) {
+            lines.push(`  interface GodotGroups {`);
+            for (const { groupName, interfaceName } of groupEntries) {
+                lines.push(`    ${groupName}: ${interfaceName};`);
+            }
+            lines.push(`  }`);
+        }
+    }
+    // Signal connections from [connection] entries
+    if (connections && connections.length > 0) {
+        lines.push(`  interface GodotConnections {`);
+        lines.push(`    "${sceneResPath}": {`);
+        for (const conn of connections) {
+            lines.push(`      "${conn.fromNode}.${conn.signal}": _GDSignalConnection<`);
+            lines.push(`        ${conn.fromType}["${conn.signal}"],`);
+            lines.push(`        GodotScripts["${conn.receiverScript}"]["${conn.method}"]`);
+            lines.push(`      >;`);
+        }
+        lines.push(`    };`);
+        lines.push(`  }`);
+    }
+    lines.push(`}\n`);
+    lines.push(`export {}`);
+    return lines.join('\n');
+}
+/**
+ * Generate .gd.d.ts file content for a single script.
+ */
+export function generateScriptTypingContent(scriptResPath, className, isAnonymous, tsImportPath, tsModulePath, enums, innerClasses, extendsNode = true, 
+/**
+ * When true (default — preserves the legacy behavior used by addons
+ * and by projects that opt into `generateGlobalClassTypes: true`), a
+ * non-anonymous class is emitted into `declare global` so consumers
+ * can use it without an explicit `import`. When false, the class
+ * follows the same module-scoped layout as anonymous classes —
+ * consumers must import it from the original `.ts` source.
+ *
+ * Anonymous classes ignore this flag (they're always module-scoped).
+ */
+generateGlobal = true) {
+    const lines = [];
+    lines.push('// AUTO-GENERATED — do not edit manually.\n');
+    const treesInterface = scriptResPathToTreesInterfaceName(scriptResPath);
+    // The TS file's exported class is now always named per the converter
+    // convention (`_FilenameInUpperCamel` for anonymous, the bare or
+    // `G_`-escaped class_name for named) — no `__CLASS__` sentinel to
+    // special-case anymore.
+    const importName = className;
+    // Import
+    lines.push(`import type { ${importName} as ScriptClass } from "${tsImportPath}";\n`);
+    // `StaticProps` exposes the user's class's static fields as instance
+    // members (so `this.MAX_HEALTH` resolves on a live instance). This
+    // mirrors GDScript's behavior — statics are reachable from `self`
+    // — and applies to EVERY class, regardless of whether it extends
+    // Node. The Node-specific typed `get_node`/`get_parent` overloads
+    // below are conditional on `extendsNode`.
+    lines.push(`type StaticProps = Omit<typeof ScriptClass, 'prototype' | keyof Function>;\n`);
+    if (extendsNode) {
+        // ScriptTree / ScriptPaths only feed the typed Node tree-method
+        // overloads, so they live in the Node-only block.
+        lines.push(`type ScriptTree = _GDGetInterfaceTree<${treesInterface}>;`);
+        lines.push(`type ScriptPaths = _GDGetTreePaths<ScriptTree>;\n`);
+        lines.push(`declare module "${tsModulePath}" {`);
+        lines.push(`  interface ${importName} extends StaticProps {`);
+        lines.push(`    get_node<P extends string & ScriptPaths>(path: P): _GDGetNode<ScriptTree, P>;`);
+        lines.push(`    get_node<P extends '/root' | \`/root/\${string}\`>(path: P): _GDGetRootNode<ScriptTree, P>;`);
+        lines.push(`    get_node(path: string): Node | null;`);
+        lines.push(`    get_node_or_null<P extends string & ScriptPaths>(path: P): _GDGetNodeOrNull<ScriptTree, P>;`);
+        lines.push(`    get_node_or_null<P extends '/root' | \`/root/\${string}\`>(path: P): _GDGetRootNode<ScriptTree, P> | null;`);
+        lines.push(`    get_node_or_null(path: string): Node | null;`);
+        lines.push(`    has_node<P extends string & ScriptPaths>(path: P): boolean;`);
+        lines.push(`    has_node(path: string): boolean;`);
+        lines.push(`    get_child<Idx extends number & _GDChildIndices<ScriptTree>>(idx: Idx): _GDGetChild<ScriptTree, Idx>;`);
+        lines.push(`    get_child(idx: int, include_internal?: boolean): Node;`);
+        lines.push(`    get_parent(): _GDParentType<ScriptTree>;`);
+        lines.push(`    get_parent<N extends Node = Node>(): N;`);
+        lines.push(`  }`);
+        lines.push(`}\n`);
+    }
+    else {
+        // Non-Node base (RefCounted, Resource, etc.): we still need the
+        // `extends StaticProps` augmentation to surface static fields on
+        // instances, just without the Node tree-method overloads.
+        lines.push(`declare module "${tsModulePath}" {`);
+        lines.push(`  interface ${importName} extends StaticProps {}`);
+        lines.push(`}\n`);
+    }
+    // Class declaration. Anonymous classes ALWAYS use the module-scoped
+    // path. Non-anonymous classes use the module-scoped path too unless
+    // `generateGlobal` is on, in which case they go into `declare global`
+    // (legacy / opt-in / addon behavior).
+    const useModuleScope = isAnonymous || !generateGlobal;
+    if (useModuleScope) {
+        // For named classes the GodotScripts/GodotResources entries should
+        // reference the user's actual class (so consumers' code that does
+        // `let p: Player = scene.instantiate()` resolves correctly). For
+        // anonymous classes there's no user-side global to point at, so we
+        // synthesize a local `_Script` handle.
+        const scriptsHandle = `ScriptClass`;
+        // Realization with shadowing typed tree methods
+        /*
+        const scriptsHandle = isAnonymous
+          ? '_Script'
+          : `import("${tsModulePath}").${importName}`;
+        if (isAnonymous) {
+          lines.push(`declare class _Script extends ScriptClass {`);
+          if (extendsNode) {
+            lines.push(`  get_node(path: string): Node | null;`);
+            lines.push(`  get_node_or_null(path: string): Node | null;`);
+            lines.push(`  has_node(path: string): boolean;`);
+            lines.push(`  get_child(idx: int, include_internal?: boolean): Node;`);
+            lines.push(`  get_parent<N extends Node = Node>(): N;`);
+          }
+          lines.push(`}\n`);
+        }
+         */
+        // Namespace for enum types and inner class types — merged with the
+        // user's TS class (whose name is `${importName}`) via module
+        // augmentation.
+        if (enums.length > 0 || innerClasses.length > 0) {
+            lines.push(`declare module "${tsModulePath}" {`);
+            lines.push(`  namespace ${importName} {`);
+            for (const e of enums) {
+                lines.push(`    type ${e.name} = number & { readonly __brand: '${e.name}' };`);
+            }
+            for (const ic of innerClasses) {
+                // File-scope `class X { ... }` lifts into the GD class as an
+                // inner class. In TS the class lives at file scope, so we
+                // alias via the type-only `import` to expose it under the
+                // `Foo.X` namespace name (matches what users wrote pre-Phase-1).
+                lines.push(`    type ${ic.name} = import("${tsModulePath}").${ic.name};`);
+            }
+            lines.push(`  }`);
+            if (enums.length > 0) {
+                lines.push(`  interface ${importName} {`);
+                for (const e of enums) {
+                    const memberTypes = e.members.map(m => `${m.name}: ${importName}.${e.name}`).join('; ');
+                    lines.push(`    ${e.name}: { ${memberTypes} };`);
+                }
+                lines.push(`  }`);
+            }
+            lines.push(`}\n`);
+        }
+        lines.push(`declare global {`);
+        if (extendsNode) {
+            lines.push(`  interface ${treesInterface} {}\n`);
+        }
+        lines.push(`  interface GodotScripts {`);
+        lines.push(`    "${scriptResPath}": ${scriptsHandle};`);
+        lines.push(`  }\n`);
+        lines.push(`  interface GodotResources {`);
+        lines.push(`    "${scriptResPath}": typeof ${scriptsHandle};`);
+        lines.push(`  }`);
+        lines.push(`}`);
+    }
+    else {
+        // Named class in declare global
+        lines.push(`declare global {`);
+        if (extendsNode) {
+            lines.push(`  interface ${treesInterface} {}\n`);
+        }
+        lines.push(`  /** @see import("${tsModulePath}") */`);
+        // lines.push(`  type ${className} = ScriptClass;`)
+        // lines.push(`  const ${className}: typeof ScriptClass;`)
+        // Realization with shadowing typed tree methods
+        lines.push(`  class ${className} extends ScriptClass {`);
+        if (extendsNode) {
+            lines.push(`    get_node(path: string): Node | null;`);
+            lines.push(`    get_node_or_null(path: string): Node | null;`);
+            lines.push(`    has_node(path: string): boolean;`);
+            lines.push(`    get_child(idx: int, include_internal?: boolean): Node;`);
+            lines.push(`    get_parent<N extends Node = Node>(): N;`);
+        }
+        lines.push(`  }`);
+        // Namespace for enum types and inner class types
+        if (enums.length > 0 || innerClasses.length > 0) {
+            lines.push(`  namespace ${className} {`);
+            for (const e of enums) {
+                lines.push(`    const enum ${e.name} {`);
+                for (const m of e.members) {
+                    lines.push(`      ${m.name} = ${m.value},`);
+                }
+                lines.push(`    }`);
+            }
+            for (const ic of innerClasses) {
+                // File-scope `class X { ... }` lifts into the GD class as an
+                // inner class. In TS the class lives at file scope, so we
+                // alias via the type-only `import` to expose it under the
+                // `Foo.X` namespace name (matches what users wrote pre-Phase-1).
+                lines.push(`    type ${ic.name} = import("${tsModulePath}").${ic.name};`);
+            }
+            lines.push(`  }`);
+        }
+        lines.push('');
+        lines.push(`  interface GodotScripts {`);
+        lines.push(`    "${scriptResPath}": ${className};`);
+        lines.push(`  }\n`);
+        lines.push(`  interface GodotResources {`);
+        lines.push(`    "${scriptResPath}": typeof ${className};`);
+        lines.push(`  }`);
+        lines.push(`}`);
+    }
+    lines.push('\nexport {};');
+    return lines.join('\n');
+}
+/**
+ * Generate .d.ts file content for a resource or asset file.
+ */
+export function generateResourceTypingContent(resPath, godotType) {
+    const lines = [];
+    lines.push(`declare global {`);
+    lines.push(`  interface GodotResources {`);
+    lines.push(`    "${resPath}": ${godotType};`);
+    lines.push(`  }`);
+    lines.push(`}\n`);
+    lines.push(`export {}`);
+    return lines.join('\n');
+}
+/**
+ * Generate _index.d.ts file content with empty global interfaces and autoload declarations.
+ */
+export function generateIndexTypingContent(autoloads, outputDir, godotTypingsDir) {
+    const lines = [];
+    lines.push('// AUTO-GENERATED — do not edit manually.');
+    // Reference the Godot engine typings so IDEs eagerly index all classes for autocomplete.
+    if (outputDir && godotTypingsDir) {
+        const ref = resolveGodotTypingsRef(outputDir, godotTypingsDir);
+        if (ref)
+            lines.push(`/// <reference path="${ref}" />`);
+    }
+    lines.push('');
+    // Import autoload scripts (.gd autoloads need imports; .tscn autoloads use GodotSceneTrees)
+    const gdAutoloads = autoloads.filter(a => a.resPath.endsWith('.gd'));
+    const sceneAutoloads = autoloads.filter(a => a.resPath.endsWith('.tscn'));
+    if (autoloads.length > 0)
+        lines.push('');
+    lines.push(`declare global {`);
+    lines.push(`  interface GodotScripts {}`);
+    lines.push(`  interface GodotSceneTrees {}`);
+    lines.push(`  interface GodotScenes {}`);
+    lines.push(`  interface GodotResources {}`);
+    lines.push(`  interface GodotGroups {}`);
+    lines.push(`  interface GodotConnections {}`);
+    lines.push(``);
+    lines.push(`  type GodotScriptName = keyof GodotScripts;`);
+    lines.push(`  type GodotSceneTreeName = keyof GodotSceneTrees;`);
+    lines.push(`  type GodotSceneName = keyof GodotScenes;`);
+    lines.push(`  type GodotResourceName = keyof GodotResources;`);
+    lines.push(`  type GodotGroupName = keyof GodotGroups;`);
+    lines.push(`  type GodotConnectionSceneName = keyof GodotConnections;`);
+    // Autoload singletons
+    if (autoloads.length > 0) {
+        lines.push(`  // Autoload singletons from project.godot`);
+        for (const autoload of gdAutoloads) {
+            lines.push(`  const ${autoload.name}: GodotScripts["${autoload.resPath}"];`);
+        }
+        for (const autoload of sceneAutoloads) {
+            lines.push(`  const ${autoload.name}: _GDTreeNode<GodotSceneTrees["${autoload.resPath}"]>;`);
+        }
+    }
+    lines.push(`}\n`);
+    lines.push(`export {};`);
+    return lines.join('\n');
+}
+/**
+ * Resolve raw scene connections into typed connection info.
+ * Matches each connection's receiver node to its attached script.
+ */
+export function resolveConnections(sceneResPath, sceneData) {
+    const result = [];
+    // Build node path → script res:// path map
+    const nodeScripts = new Map();
+    for (const script of sceneData.scripts) {
+        nodeScripts.set(script.nodePath, script.scriptResPath);
+    }
+    if (sceneData.rootScript) {
+        nodeScripts.set('.', sceneData.rootScript.scriptResPath);
+    }
+    for (const conn of sceneData.connections) {
+        const fromType = sceneData.nodeTypes.get(conn.fromPath);
+        if (!fromType)
+            continue;
+        const receiverScript = nodeScripts.get(conn.toPath);
+        if (!receiverScript)
+            continue;
+        result.push({
+            sceneResPath,
+            signal: conn.signal,
+            fromNode: conn.fromPath,
+            fromType,
+            receiverScript,
+            method: conn.method,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=content-generators.js.map

package/dist/typings/content-generators.js.map

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

package/dist/typings/global-generator.d.ts

@@ -0,0 +1,32 @@
+import type { GodotClassXml } from './godot-registry.ts';
+import { type TypeContext } from './type-mapping.ts';
+/** Classes to skip entirely (handled by gd-helpers.d.ts or TS builtins) */
+export declare const SKIP_CLASSES: Set<string>;
+/**
+ * Generates global scope declarations (top-level functions, constants, enums).
+ */
+export declare function generateGlobalScopeDeclaration(cls: GodotClassXml, ctx: TypeContext): string;
+/**
+ * Generates TypeScript declarations from @GDScript.xml:
+ * constants, methods, and annotation decorators.
+ */
+export declare function generateGDScriptDeclaration(cls: GodotClassXml, ctx: TypeContext): string;
+/**
+ * Generates a Number interface extension with operator overloads from int and float XML docs.
+ * Since int/float are `type number`, their operators need to be on the Number interface.
+ * We merge both int and float operators, deduplicating where they overlap.
+ */
+export declare function generateNumberOperatorOverloads(classes: Map<string, GodotClassXml>, ctx: TypeContext): string | null;
+/**
+ * Computes Dictionary member names that no class in the Object hierarchy defines.
+ * These are safe to override with `never` on GodotObject to block Dictionary API leaking
+ * through the Object interface to all Godot classes.
+ */
+export declare function computeDictOnlyOverrides(classes: Map<string, GodotClassXml>): Set<string>;
+/**
+ * Collects all Dictionary interface member names (methods + properties).
+ * Used to override them with `never` on value type interfaces, preventing
+ * Dictionary methods from leaking through the TS Object interface.
+ */
+export declare function collectAllDictMembers(classes: Map<string, GodotClassXml>): Set<string>;
+//# sourceMappingURL=global-generator.d.ts.map

package/dist/typings/global-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-generator.d.ts","sourceRoot":"","sources":["../../src/typings/global-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWvF,2EAA2E;AAC3E,eAAO,MAAM,YAAY,aAA2C,CAAC;AAIrE;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAuD3F;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAyExF;AAID;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACnC,GAAG,EAAE,WAAW,GACf,MAAM,GAAG,IAAI,CA0Cf;AAID;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAClC,GAAG,CAAC,MAAM,CAAC,CAqCb;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAClC,GAAG,CAAC,MAAM,CAAC,CAOb"}