typescript-to-gdscript 0.1.0

package/dist/godot-validate/source-map-remap.js

@@ -0,0 +1,195 @@
+/**
+ * Source map remapping for Godot validation errors.
+ * Maps GDScript error positions back to TypeScript source positions.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { SourceMapReader } from "../sourcemap/index.js";
+// ─── Async Remap (uses SourceMapReader) ──────────────────────
+/**
+ * Remaps a Godot error from GDScript positions to TypeScript positions.
+ *
+ * Source-map input priority:
+ *   1. `sourceMapJson` parameter (inline — preferred: caller already has
+ *      the JSON in memory, e.g. straight from a converter run or a
+ *      `ProjectCache` entry — no disk read needed).
+ *   2. `<error.file>.map` sidecar on disk (fallback for callers that
+ *      only point at the `.gd`).
+ *
+ * When `tsFilePath` is provided, it overrides the resolved source path
+ * from the source map — useful when the map's `sources` entry is
+ * relative to a throwaway location (e.g. a cache/scratch dir) but we
+ * already know the real `.ts` we're validating.
+ *
+ * Falls back to GD positions if no source map is available.
+ */
+export async function remapError(error, sourceMapJson, tsFilePath) {
+    let rawMap = sourceMapJson;
+    let mapPath;
+    if (!rawMap) {
+        mapPath = error.file + '.map';
+        if (existsSync(mapPath)) {
+            try {
+                rawMap = readFileSync(mapPath, 'utf-8');
+            }
+            catch {
+                rawMap = undefined;
+            }
+        }
+    }
+    if (rawMap) {
+        try {
+            const reader = await SourceMapReader.fromJSON(rawMap);
+            let original = reader.originalPositionFor(error.line, error.column);
+            // If column 0 has no mapping (e.g. indentation), find the first mapping on this line
+            if (!original.source || original.line == null) {
+                const allMappings = reader.allMappings();
+                const lineMapping = allMappings.find((m) => m.generatedLine === error.line);
+                if (lineMapping &&
+                    lineMapping.originalLine != null &&
+                    lineMapping.source != null) {
+                    original = {
+                        source: lineMapping.source,
+                        line: lineMapping.originalLine,
+                        column: lineMapping.originalColumn,
+                    };
+                }
+            }
+            reader.destroy();
+            if (original.source && original.line != null) {
+                // When `tsFilePath` is supplied, trust the caller over the
+                // sourcemap's `source` entry. Otherwise resolve `source`
+                // relative to wherever the sourcemap lives on disk (fallback
+                // path) — or, for inline maps with no disk anchor, leave it
+                // as-is (caller is responsible for providing `tsFilePath`).
+                let file;
+                if (tsFilePath) {
+                    file = tsFilePath;
+                }
+                else if (mapPath) {
+                    file = resolve(dirname(mapPath), original.source);
+                }
+                else {
+                    file = original.source;
+                }
+                return {
+                    message: `[Godot ${error.errorType}] ${error.message}`,
+                    severity: 'error',
+                    file,
+                    line: original.line,
+                    column: original.column ?? 0,
+                };
+            }
+        }
+        catch {
+            // Source map read failed, fall through to GD position
+        }
+    }
+    return {
+        message: `[Godot ${error.errorType}] ${error.message}`,
+        severity: 'error',
+        file: tsFilePath ?? error.file,
+        line: error.line,
+        column: error.column,
+    };
+}
+// ─── VLQ Decoding for Sync Source Map Remapping ───────────────
+export const VLQ_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+export function decodeVlq(encoded) {
+    const result = [];
+    let shift = 0;
+    let value = 0;
+    for (let i = 0; i < encoded.length; i++) {
+        let digit = VLQ_CHARS.indexOf(encoded[i]);
+        if (digit === -1)
+            continue;
+        const cont = digit & 32;
+        digit &= 31;
+        value += digit << shift;
+        if (cont) {
+            shift += 5;
+        }
+        else {
+            const negate = value & 1;
+            value >>= 1;
+            result.push(negate ? -value : value);
+            shift = 0;
+            value = 0;
+        }
+    }
+    return result;
+}
+/**
+ * Parses source map JSON mappings into a flat array of line mappings.
+ * Lightweight sync alternative to SourceMapConsumer.
+ */
+export function parseSourceMapMappings(rawMap) {
+    const map = JSON.parse(rawMap);
+    const sources = map.sources ?? [];
+    const segments = (map.mappings ?? '').split(';');
+    const mappings = [];
+    let genCol = 0;
+    let srcIdx = 0;
+    let origLine = 0;
+    let origCol = 0;
+    for (let lineIdx = 0; lineIdx < segments.length; lineIdx++) {
+        genCol = 0; // Reset column for each generated line
+        const seg = segments[lineIdx];
+        if (!seg)
+            continue;
+        const parts = seg.split(',');
+        for (const part of parts) {
+            const decoded = decodeVlq(part);
+            if (decoded.length < 4)
+                continue;
+            genCol += decoded[0];
+            srcIdx += decoded[1];
+            origLine += decoded[2];
+            origCol += decoded[3];
+            mappings.push({
+                generatedLine: lineIdx + 1, // 1-based
+                generatedColumn: genCol,
+                originalLine: origLine + 1, // 1-based
+                originalColumn: origCol,
+                sourceIndex: srcIdx,
+            });
+        }
+    }
+    return { mappings, sources };
+}
+/**
+ * Synchronously remaps a Godot error using a pre-loaded source map JSON string.
+ * Falls back to GD position if remapping fails.
+ */
+export function remapErrorSync(error, sourceMapJson, tsFilePath) {
+    if (sourceMapJson) {
+        try {
+            const { mappings } = parseSourceMapMappings(sourceMapJson);
+            // Find the first mapping on the error line
+            const lineMapping = mappings.find((m) => m.generatedLine === error.line);
+            // Try exact match first
+            const exactMapping = mappings.find((m) => m.generatedLine === error.line && m.generatedColumn <= error.column);
+            const bestMapping = exactMapping ?? lineMapping;
+            if (bestMapping) {
+                return {
+                    message: `[Godot ${error.errorType}] ${error.message}`,
+                    severity: 'error',
+                    file: tsFilePath ?? error.file,
+                    line: bestMapping.originalLine,
+                    column: bestMapping.originalColumn,
+                };
+            }
+        }
+        catch {
+            // Fall through to GD position
+        }
+    }
+    return {
+        message: `[Godot ${error.errorType}] ${error.message}`,
+        severity: 'error',
+        file: tsFilePath ?? error.file,
+        line: error.line,
+        column: error.column,
+    };
+}
+//# sourceMappingURL=source-map-remap.js.map

package/dist/godot-validate/source-map-remap.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { convertTsToGd, type ConvertOptions, } from './converter/ts-to-gd/index.ts';
+export { convertGdToTs, type GdToTsOptions, } from './converter/gd-to-ts/index.ts';
+export { GDScriptParser } from './parser/gdscript/index.ts';
+export { createTsProgram } from './parser/typescript/index.ts';
+export { SourceMapper } from './sourcemap/index.ts';
+export { generateTypings } from './typings/scenes.ts';
+export { generateGodotDocsTypings } from './typings/godot-docs.ts';
+export { GodotClassRegistry, generateGodotRegistry, parseGodotVersion, } from './typings/godot-registry.ts';
+export { ProjectCache, type CachedDiagnostic } from './cache/index.ts';
+export { Watcher, type WatcherOptions } from './watcher/index.ts';
+export { resolveRegistry, resolveConfig, loadConfig, type TsToGdConfig, type ResolvedConfig, type ResolveRegistryOptions, } from './config/index.ts';
+export type { TransformResult, TransformDiagnostic, TransformContext, } from './converter/common/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,cAAc,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,aAAa,EACb,KAAK,aAAa,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,aAAa,EACb,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { convertTsToGd, } from "./converter/ts-to-gd/index.js";
+export { convertGdToTs, } from "./converter/gd-to-ts/index.js";
+export { GDScriptParser } from "./parser/gdscript/index.js";
+export { createTsProgram } from "./parser/typescript/index.js";
+export { SourceMapper } from "./sourcemap/index.js";
+export { generateTypings } from "./typings/scenes.js";
+export { generateGodotDocsTypings } from "./typings/godot-docs.js";
+export { GodotClassRegistry, generateGodotRegistry, parseGodotVersion, } from "./typings/godot-registry.js";
+export { ProjectCache } from "./cache/index.js";
+export { Watcher } from "./watcher/index.js";
+export { resolveRegistry, resolveConfig, loadConfig, } from "./config/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAEd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,aAAa,GAEd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAyB,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAuB,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,aAAa,EACb,UAAU,GAIX,MAAM,mBAAmB,CAAC"}

package/dist/parser/gdscript/generate-types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates TypeScript type definitions from tree-sitter-gdscript's node-types.json.
+ * Run: yarn generate:ast-types
+ * Output: src/parser/gdscript/types.ts
+ */
+export {};
+//# sourceMappingURL=generate-types.d.ts.map

package/dist/parser/gdscript/generate-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-types.d.ts","sourceRoot":"","sources":["../../../src/parser/gdscript/generate-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/parser/gdscript/generate-types.js

@@ -0,0 +1,134 @@
+/**
+ * Generates TypeScript type definitions from tree-sitter-gdscript's node-types.json.
+ * Run: yarn generate:ast-types
+ * Output: src/parser/gdscript/types.ts
+ */
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+function toPascalCase(str) {
+    return str
+        .split(/[_\s-]+/)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+function toNodeTypeName(type) {
+    // Supertypes start with _ — differentiate to avoid collisions (e.g. _parameters vs parameters)
+    if (type.startsWith('_')) {
+        return `GD${toPascalCase(type.slice(1))}Union`;
+    }
+    return `GD${toPascalCase(type)}Node`;
+}
+function generateFieldType(field) {
+    const types = field.types
+        .filter(t => t.named)
+        .map(t => toNodeTypeName(t.type));
+    if (types.length === 0)
+        return 'GDNode';
+    const union = types.length === 1 ? types[0] : `(${types.join(' | ')})`;
+    if (field.multiple) {
+        return `${union}[]`;
+    }
+    return field.required ? union : `${union} | null`;
+}
+function generate() {
+    const nodeTypesPath = require.resolve('tree-sitter-gdscript/src/node-types.json');
+    const nodeTypes = JSON.parse(readFileSync(nodeTypesPath, 'utf-8'));
+    const lines = [];
+    lines.push('// AUTO-GENERATED — do not edit. Run `yarn generate:ast-types` to regenerate.');
+    lines.push('// Generated from tree-sitter-gdscript node-types.json');
+    lines.push('');
+    lines.push('import type Parser from \'tree-sitter\';');
+    lines.push('');
+    // Base interface
+    lines.push('/** Base interface for all GDScript AST nodes */');
+    lines.push('export interface GDNodeBase {');
+    lines.push('  type: string;');
+    lines.push('  text: string;');
+    lines.push('  isNamed: boolean;');
+    lines.push('  startPosition: Parser.Point;');
+    lines.push('  endPosition: Parser.Point;');
+    lines.push('  startIndex: number;');
+    lines.push('  endIndex: number;');
+    lines.push('  parent: GDNode | null;');
+    lines.push('  children: GDNode[];');
+    lines.push('  namedChildren: GDNode[];');
+    lines.push('  childCount: number;');
+    lines.push('  namedChildCount: number;');
+    lines.push('  firstChild: GDNode | null;');
+    lines.push('  lastChild: GDNode | null;');
+    lines.push('  firstNamedChild: GDNode | null;');
+    lines.push('  lastNamedChild: GDNode | null;');
+    lines.push('  nextSibling: GDNode | null;');
+    lines.push('  previousSibling: GDNode | null;');
+    lines.push('  nextNamedSibling: GDNode | null;');
+    lines.push('  previousNamedSibling: GDNode | null;');
+    lines.push('  childForFieldName(fieldName: string): GDNode | null;');
+    lines.push('  childrenForFieldName(fieldName: string): GDNode[];');
+    lines.push('  descendantsOfType(type: string | string[]): GDNode[];');
+    lines.push('  closest(type: string | string[]): GDNode | null;');
+    lines.push('  toString(): string;');
+    lines.push('}');
+    lines.push('');
+    // Separate named types and supertypes
+    const namedTypes = nodeTypes.filter(t => t.named && !t.subtypes);
+    const supertypes = nodeTypes.filter(t => t.named && t.subtypes);
+    // Generate interfaces for each named node type
+    for (const entry of namedTypes) {
+        const typeName = toNodeTypeName(entry.type);
+        lines.push(`export interface ${typeName} extends GDNodeBase {`);
+        lines.push(`  type: "${entry.type}";`);
+        // Generate childForFieldName overloads for nodes with fields
+        if (entry.fields && Object.keys(entry.fields).length > 0) {
+            for (const [fieldName, field] of Object.entries(entry.fields)) {
+                const fieldType = generateFieldType(field);
+                lines.push(`  childForFieldName(name: '${fieldName}'): ${fieldType};`);
+            }
+            lines.push('  childForFieldName(name: string): GDNode | null;');
+        }
+        lines.push('}');
+        lines.push('');
+    }
+    // Generate supertype unions
+    for (const entry of supertypes) {
+        const typeName = toNodeTypeName(entry.type);
+        const subtypeNames = entry.subtypes
+            .filter(s => s.named)
+            .map(s => toNodeTypeName(s.type));
+        if (subtypeNames.length > 0) {
+            lines.push(`export type ${typeName} = ${subtypeNames.join(' | ')};`);
+            lines.push('');
+        }
+    }
+    // Generate the main GDNode union type
+    const allNodeTypes = namedTypes.map(t => toNodeTypeName(t.type));
+    lines.push('/** Union of all GDScript AST node types */');
+    lines.push(`export type GDNode = ${allNodeTypes.join(' | ')};`);
+    lines.push('');
+    // Generate a type map for type narrowing
+    lines.push('/** Map from node type string to its TypeScript interface */');
+    lines.push('export interface GDNodeTypeMap {');
+    for (const entry of namedTypes) {
+        lines.push(`  '${entry.type}': ${toNodeTypeName(entry.type)};`);
+    }
+    lines.push('}');
+    lines.push('');
+    // Generate type guard helper
+    lines.push('/** Type guard for narrowing GDNode to a specific type */');
+    lines.push('export function isGDNodeType<T extends keyof GDNodeTypeMap>(');
+    lines.push('  node: GDNodeBase,');
+    lines.push('  type: T');
+    lines.push('): node is GDNodeTypeMap[T] {');
+    lines.push('  return node.type === type;');
+    lines.push('}');
+    lines.push('');
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const outPath = resolve(__dirname, 'types.ts');
+    writeFileSync(outPath, lines.join('\n'));
+    console.log(`Generated ${allNodeTypes.length} node types to ${outPath}`);
+}
+generate();
+//# sourceMappingURL=generate-types.js.map

package/dist/parser/gdscript/generate-types.js.map

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

package/dist/parser/gdscript/index.d.ts

@@ -0,0 +1,9 @@
+import TreeSitter from 'tree-sitter';
+import type { SyntaxNode } from './types.ts';
+export declare class GDScriptParser {
+    private parser;
+    constructor();
+    parse(source: string): SyntaxNode;
+    parseFile(source: string, previousTree?: TreeSitter.Tree): TreeSitter.Tree;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/gdscript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parser/gdscript/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAa;;IAO3B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAKjC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI;CAG3E"}

package/dist/parser/gdscript/index.js

@@ -0,0 +1,17 @@
+import TreeSitter from 'tree-sitter';
+import GDScript from 'tree-sitter-gdscript';
+export class GDScriptParser {
+    parser;
+    constructor() {
+        this.parser = new TreeSitter();
+        this.parser.setLanguage(GDScript);
+    }
+    parse(source) {
+        const tree = this.parser.parse(source);
+        return tree.rootNode;
+    }
+    parseFile(source, previousTree) {
+        return this.parser.parse(source, previousTree);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/parser/gdscript/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/gdscript/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAE5C,MAAM,OAAO,cAAc;IACjB,MAAM,CAAa;IAE3B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAe,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,MAAc;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,QAAiC,CAAC;IAChD,CAAC;IAED,SAAS,CAAC,MAAc,EAAE,YAA8B;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;CACF"}