typescript-to-gdscript 0.1.0

package/dist/converter/ts-to-gd/class-members.js

@@ -0,0 +1,246 @@
+/**
+ * Class member visitors for TS→GD conversion.
+ * Handles signals, enums, properties, accessor pairs, gd.getset(),
+ * inner classes, constructors, methods, and decorators.
+ */
+import ts from 'typescript';
+import { tsTypeNodeToGdType } from "../common/index.js";
+import { visitGdGetsetProperty } from "./gd-getset.js";
+// ── Signals ──────────────────────────────────────────────────
+export function isSignalProperty(node, t) {
+    if (!node.initializer)
+        return false;
+    return t.isGdHelperCall(node.initializer, 'signal');
+}
+export function visitSignalDeclaration(node, t) {
+    const pos = t.getLineAndCol(node);
+    const name = node.name.getText(t.ctx.sourceFile);
+    const params = extractSignalParams(node, t);
+    if (params.length > 0) {
+        // GD permits untyped signal params (`signal foo(arg)`) — omit the `:
+        // Variant` annotation when the TS type doesn't map to anything useful.
+        const paramStr = params
+            .map((p) => (p.type ? `${p.name}: ${p.type}` : p.name))
+            .join(', ');
+        t.emitter.writeLine(`signal ${name}(${paramStr})`, pos.line, pos.col);
+    }
+    else {
+        t.emitter.writeLine(`signal ${name}`, pos.line, pos.col);
+    }
+}
+function extractSignalParams(node, t) {
+    if (!node.initializer || !ts.isCallExpression(node.initializer))
+        return [];
+    const call = node.initializer;
+    if (!call.typeArguments || call.typeArguments.length === 0)
+        return [];
+    const typeArg = call.typeArguments[0];
+    if (!ts.isTupleTypeNode(typeArg))
+        return [];
+    const params = [];
+    for (let i = 0; i < typeArg.elements.length; i++) {
+        const element = typeArg.elements[i];
+        let paramName;
+        let typeNode;
+        if (ts.isNamedTupleMember(element)) {
+            paramName = element.name.text;
+            typeNode = element.type;
+        }
+        else {
+            paramName = `arg${i + 1}`;
+            typeNode = element;
+        }
+        const gdType = tsTypeNodeToGdType(typeNode, t.ctx.checker, t.ctx.sourceFile, t.currentClassName);
+        params.push(gdType ? { name: paramName, type: gdType } : { name: paramName });
+    }
+    return params;
+}
+// ── Enums ────────────────────────────────────────────────────
+export function isEnumProperty(node, t) {
+    if (!node.initializer)
+        return false;
+    return t.isGdHelperCall(node.initializer, 'enum');
+}
+export function visitEnumDeclaration(node, t) {
+    // The legacy `static X = gd.enum(...)` form is no longer supported.
+    // Use a native TS `enum X { ... }` declaration at file scope —
+    // it lifts into the script class as a GDScript `enum` via the
+    // file-scope-decl pipeline (Phase 1).
+    const name = node.name.getText(t.ctx.sourceFile);
+    t.addDiagnostic(node, 'error', `'static ${name} = gd.enum(...)' is no longer supported. ` +
+        `Use a native TS \`enum ${toPascalCase(name)} { ... }\` at file scope ` +
+        `(outside the script class) — it lifts into the GDScript class as an enum.`);
+}
+// ── Properties ───────────────────────────────────────────────
+export function visitPropertyDeclaration(node, t) {
+    const pos = t.getLineAndCol(node);
+    const name = node.name.getText(t.ctx.sourceFile);
+    // Inner class via the legacy `static X = class { ... }` form is no
+    // longer supported. Use a file-scope `class X { ... }` declaration
+    // instead — it lifts into the script class as an inner class via
+    // the file-scope-decl pipeline (Phase 1).
+    if (node.initializer && ts.isClassExpression(node.initializer)) {
+        t.addDiagnostic(node, 'error', `Inline 'static ${name} = class { ... }' is no longer supported. ` +
+            `Move the class to file scope: \`class ${name} { ... }\` outside the script class.`);
+        return;
+    }
+    // gd.getset
+    if (node.initializer && t.isGdHelperCall(node.initializer, 'getset')) {
+        visitGdGetsetProperty(name, node, node.initializer, t);
+        return;
+    }
+    const decorators = getDecorators(node, t);
+    for (const dec of decorators) {
+        t.emitter.writeLine(dec, pos.line, pos.col);
+    }
+    const isStatic = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.StaticKeyword);
+    // `readonly` is a TS-only contract — the compiler enforces no
+    // reassignment, but on the GD side it emits a plain `var` (or
+    // `static var` when paired with `static`). Class-level constants
+    // are declared via a paired `namespace ClassName { export const X = ... }`
+    // block instead — that lifts into `const X = ...` inside the GD class.
+    const gdType = tsTypeNodeToGdType(node.type, t.ctx.checker, t.ctx.sourceFile, t.currentClassName);
+    const staticPrefix = isStatic ? 'static ' : '';
+    let decl = `${staticPrefix}var ${name}`;
+    if (gdType)
+        decl += `: ${gdType}`;
+    if (node.initializer &&
+        !t.isGdHelperCall(node.initializer, 'signal') &&
+        !t.isGdHelperCall(node.initializer, 'enum')) {
+        decl += ` = ${t.emitExpression(node.initializer)}`;
+    }
+    t.emitter.writeLine(decl, pos.line, pos.col);
+    if (node.initializer && t.isBlockLambda(node.initializer)) {
+        t.emitLambdaBody(node.initializer);
+    }
+}
+// ── Accessor Pair (get/set) ──────────────────────────────────
+export function visitAccessorPair(name, getNode, setNode, t) {
+    const pos = t.getLineAndCol(getNode ?? setNode);
+    let gdType = null;
+    if (getNode?.type) {
+        gdType = tsTypeNodeToGdType(getNode.type, t.ctx.checker, t.ctx.sourceFile, t.currentClassName);
+    }
+    else if (setNode &&
+        setNode.parameters.length > 0 &&
+        setNode.parameters[0].type) {
+        gdType = tsTypeNodeToGdType(setNode.parameters[0].type, t.ctx.checker, t.ctx.sourceFile, t.currentClassName);
+    }
+    const typeSuffix = gdType ? `: ${gdType}` : '';
+    t.emitter.writeLine(`var ${name}${typeSuffix}:`, pos.line, pos.col);
+    t.emitter.indent();
+    const savedAccessorName = t.currentAccessorName;
+    t.setCurrentAccessorName(name);
+    if (getNode?.body) {
+        const getPos = t.getLineAndCol(getNode);
+        t.emitter.writeLine('get:', getPos.line, getPos.col);
+        t.emitter.indent();
+        for (const stmt of getNode.body.statements)
+            t.visitStatement(stmt);
+        t.emitter.dedent();
+    }
+    else {
+        t.emitter.writeLine('get:', pos.line, pos.col);
+        t.emitter.indent();
+        t.emitter.writeLine(`return ${name}`, pos.line, pos.col);
+        t.emitter.dedent();
+    }
+    if (setNode?.body) {
+        const setPos = t.getLineAndCol(setNode);
+        const paramName = setNode.parameters[0] && ts.isIdentifier(setNode.parameters[0].name)
+            ? setNode.parameters[0].name.text
+            : 'value';
+        t.emitter.writeLine(`set(${paramName}):`, setPos.line, setPos.col);
+        t.emitter.indent();
+        for (const stmt of setNode.body.statements)
+            t.visitStatement(stmt);
+        t.emitter.dedent();
+    }
+    else {
+        t.emitter.writeLine('set(value):', pos.line, pos.col);
+        t.emitter.indent();
+        t.emitter.writeLine(`${name} = value`, pos.line, pos.col);
+        t.emitter.dedent();
+    }
+    t.setCurrentAccessorName(savedAccessorName);
+    t.emitter.dedent();
+}
+// ── Constructor → _init ──────────────────────────────────────
+export function visitConstructor(node, t) {
+    const pos = t.getLineAndCol(node);
+    const params = t.emitParameters(node.parameters);
+    t.emitter.writeLine(`func _init(${params}):`, pos.line, pos.col);
+    t.emitter.indent();
+    if (node.body) {
+        t.visitBlock(node.body);
+    }
+    else {
+        t.emitter.writeLine('pass', pos.line, pos.col);
+    }
+    t.emitter.dedent();
+}
+// ── Methods ──────────────────────────────────────────────────
+export function visitMethodDeclaration(node, t) {
+    const pos = t.getLineAndCol(node);
+    const name = node.name.getText(t.ctx.sourceFile);
+    const params = t.emitParameters(node.parameters);
+    const returnType = tsTypeNodeToGdType(node.type, t.ctx.checker, t.ctx.sourceFile, t.currentClassName);
+    const returnAnnotation = returnType ? ` -> ${returnType}` : '';
+    const decorators = getDecorators(node, t);
+    for (const dec of decorators)
+        t.emitter.writeLine(dec, pos.line, pos.col);
+    const isAbstract = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.AbstractKeyword);
+    if (isAbstract)
+        t.emitter.writeLine('@abstract', pos.line, pos.col);
+    const isStatic = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.StaticKeyword);
+    const staticPrefix = isStatic ? 'static ' : '';
+    t.emitter.writeLine(`${staticPrefix}func ${name}(${params})${returnAnnotation}:`, pos.line, pos.col);
+    t.emitter.indent();
+    if (node.body) {
+        t.visitBlock(node.body);
+    }
+    else {
+        t.emitter.writeLine('pass', pos.line, pos.col);
+    }
+    t.emitter.dedent();
+}
+// ── Decorators ───────────────────────────────────────────────
+export function getDecorators(node, t) {
+    const result = [];
+    const decorators = ts.getDecorators(node);
+    if (!decorators)
+        return result;
+    // Decorators are bare global function names — e.g. `@onready`, `@tool`,
+    // `@export_range(0, 100)`, `@icon("res://x.svg")`. They're declared in
+    // `typings/classes/_globals.d.ts` as global decorator functions and
+    // emitted verbatim as GDScript annotations. The lone TS-specific quirk
+    // is `@exports` (plural) — `export` is a TS reserved word so the
+    // plural alias is rewritten to GDScript `@export`.
+    for (const dec of decorators) {
+        if (ts.isCallExpression(dec.expression) &&
+            ts.isIdentifier(dec.expression.expression)) {
+            let name = dec.expression.expression.text;
+            if (name === 'exports')
+                name = 'export';
+            const args = dec.expression.arguments
+                .map((a) => t.emitExpression(a))
+                .join(', ');
+            result.push(args ? `@${name}(${args})` : `@${name}`);
+        }
+        else if (ts.isIdentifier(dec.expression)) {
+            let name = dec.expression.text;
+            if (name === 'exports')
+                name = 'export';
+            result.push(`@${name}`);
+        }
+    }
+    return result;
+}
+// ── Helpers ──────────────────────────────────────────────────
+export function toPascalCase(str) {
+    return str
+        .replace(/^[A-Z]+/, (m) => m.charAt(0) + m.slice(1).toLowerCase())
+        .replace(/_([a-zA-Z])/g, (_, c) => c.toUpperCase())
+        .replace(/^[a-z]/, (c) => c.toUpperCase());
+}
+//# sourceMappingURL=class-members.js.map

package/dist/converter/ts-to-gd/class-members.js.map

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

package/dist/converter/ts-to-gd/diagnostics.d.ts

@@ -0,0 +1,27 @@
+import ts from 'typescript';
+import type { GodotClassRegistry } from '../../typings/godot-registry.ts';
+import type { DiagnosticsTypeInfo } from '../common/index.ts';
+export type { DiagnosticsTypeInfo };
+/**
+ * Build the diagnostics type info from a Godot class registry.
+ * If `registry` is undefined (registry unavailable), returns empty sets — callers
+ * fall back to primitive / TS-array checks only.
+ */
+export declare function buildDiagnosticsTypeInfo(registry: GodotClassRegistry | undefined): DiagnosticsTypeInfo;
+/**
+ * Returns true if a GDScript type is a "class type" -- i.e. not a primitive and
+ * not a variant/value type (Vector2, Color, etc.). Only class types need an
+ * explicit type annotation when used as optional null-default parameters.
+ */
+export declare function isGdClassType(gdType: string, diagInfo: DiagnosticsTypeInfo): boolean;
+/**
+ * Returns true if a GDScript type is a variant/value type (Vector2, Color, etc.)
+ * -- i.e. a registry constructor but not a primitive.
+ */
+export declare function isGdVariantType(gdType: string, diagInfo: DiagnosticsTypeInfo): boolean;
+/**
+ * If the type is banned as a right-hand side of `in`, return a human-readable
+ * label for the error message; otherwise return null.
+ */
+export declare function classifyInRhsType(type: ts.Type, checker: ts.TypeChecker, diagInfo: DiagnosticsTypeInfo): string | null;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/converter/ts-to-gd/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/converter/ts-to-gd/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAqBpC;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,mBAAmB,CAgBrB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAIT;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,QAAQ,EAAE,mBAAmB,GAC5B,MAAM,GAAG,IAAI,CAwBf"}

package/dist/converter/ts-to-gd/diagnostics.js

@@ -0,0 +1,95 @@
+import ts from 'typescript';
+/**
+ * Container types that DO support the `in` operator in GDScript. Everything
+ * else in the registry's `constructors` list (all Godot variant/value types)
+ * is considered banned for use with `in`.
+ *
+ * `Dictionary` supports `in` (checks key presence).
+ * `Array` supports `in` (checks value presence).
+ * `Packed*Array` types do NOT support `in`.
+ * `String` supports `in` (substring check) but is mapped to `string` primitive.
+ */
+const GD_IN_ALLOWED_CONTAINER_TYPES = new Set([
+    'Dictionary',
+    'Array',
+    'ReadonlyArray',
+]);
+/** GDScript primitive types that don't need type annotation on `= null` optional params. */
+const GD_PRIMITIVE_TYPES = new Set(['int', 'float', 'bool', 'String', 'void']);
+/**
+ * Build the diagnostics type info from a Godot class registry.
+ * If `registry` is undefined (registry unavailable), returns empty sets — callers
+ * fall back to primitive / TS-array checks only.
+ */
+export function buildDiagnosticsTypeInfo(registry) {
+    const constructors = new Set();
+    const packedArrayTypes = new Set();
+    const bannedInTypes = new Set();
+    if (registry) {
+        for (const name of registry.getData().constructors ?? []) {
+            constructors.add(name);
+            if (GD_IN_ALLOWED_CONTAINER_TYPES.has(name))
+                continue;
+            if (name.startsWith('Packed') && name.endsWith('Array')) {
+                packedArrayTypes.add(name);
+            }
+            else {
+                bannedInTypes.add(name);
+            }
+        }
+    }
+    return { constructors, packedArrayTypes, bannedInTypes };
+}
+/**
+ * Returns true if a GDScript type is a "class type" -- i.e. not a primitive and
+ * not a variant/value type (Vector2, Color, etc.). Only class types need an
+ * explicit type annotation when used as optional null-default parameters.
+ */
+export function isGdClassType(gdType, diagInfo) {
+    if (GD_PRIMITIVE_TYPES.has(gdType))
+        return false;
+    if (diagInfo.constructors.has(gdType))
+        return false;
+    return true;
+}
+/**
+ * Returns true if a GDScript type is a variant/value type (Vector2, Color, etc.)
+ * -- i.e. a registry constructor but not a primitive.
+ */
+export function isGdVariantType(gdType, diagInfo) {
+    if (GD_PRIMITIVE_TYPES.has(gdType))
+        return false;
+    return diagInfo.constructors.has(gdType);
+}
+/**
+ * If the type is banned as a right-hand side of `in`, return a human-readable
+ * label for the error message; otherwise return null.
+ */
+export function classifyInRhsType(type, checker, diagInfo) {
+    // Check symbol name first for allowed/banned types
+    const symbol = type.getSymbol() ?? type.aliasSymbol;
+    const name = symbol?.getName();
+    if (name) {
+        // Array, Dictionary support `in` -- allow them
+        if (GD_IN_ALLOWED_CONTAINER_TYPES.has(name))
+            return null;
+        if (diagInfo.bannedInTypes.has(name)) {
+            return `the value type \`${name}\``;
+        }
+        if (diagInfo.packedArrayTypes.has(name)) {
+            return `the array type \`${name}\``;
+        }
+    }
+    // TS array types (T[], tuples) -- these map to GDScript Array, which supports `in`
+    if (checker.isArrayType?.(type))
+        return null;
+    if (checker.isTupleType?.(type))
+        return null;
+    // Number/boolean primitives: `x in 42` / `x in true` is always wrong too.
+    if (type.flags & ts.TypeFlags.NumberLike)
+        return 'a number';
+    if (type.flags & ts.TypeFlags.BooleanLike)
+        return 'a boolean';
+    return null;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/converter/ts-to-gd/diagnostics.js.map

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

package/dist/converter/ts-to-gd/emitter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * GDScript code emitter with source map support.
+ * Tracks line/column positions as code is emitted.
+ */
+export declare class GDScriptEmitter {
+    private output;
+    private currentLine;
+    private currentColumn;
+    private indentLevel;
+    private indentStr;
+    private sourceMapper;
+    private sourceFile;
+    constructor(sourceFile: string, generatedFile?: string, enableSourceMap?: boolean);
+    indent(): void;
+    dedent(): void;
+    /**
+     * Write text to output, tracking position for source maps.
+     * @param text The text to write
+     * @param originalLine Original source line (1-based), for source map
+     * @param originalColumn Original source column (0-based), for source map
+     */
+    write(text: string, originalLine?: number, originalColumn?: number): void;
+    /** Write text followed by a newline, with mapping at column 0 (line start). */
+    writeLine(text: string, originalLine: number, originalColumn: number): void;
+    /** Write an empty line */
+    writeEmptyLine(): void;
+    /** Get current indentation level */
+    getIndentLevel(): number;
+    /** Get indentation string for a given level */
+    getIndentStr(level?: number): string;
+    /** Write current indentation */
+    writeIndent(): void;
+    /** Get the generated code */
+    getOutput(): string;
+    /** Get the source map JSON string, or undefined if source maps are disabled */
+    getSourceMap(): string | undefined;
+    /** Set source content for source maps */
+    setSourceContent(content: string): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/converter/ts-to-gd/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../../src/converter/ts-to-gd/emitter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,UAAU,CAAS;gBAGzB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,eAAe,UAAQ;IAQzB,MAAM,IAAI,IAAI;IAId,MAAM,IAAI,IAAI;IAId;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBzE,+EAA+E;IAC/E,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAM3E,0BAA0B;IAC1B,cAAc,IAAI,IAAI;IAItB,oCAAoC;IACpC,cAAc,IAAI,MAAM;IAIxB,+CAA+C;IAC/C,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAIpC,gCAAgC;IAChC,WAAW,IAAI,IAAI;IAKnB,6BAA6B;IAC7B,SAAS,IAAI,MAAM;IAInB,+EAA+E;IAC/E,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,yCAAyC;IACzC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAGxC"}

package/dist/converter/ts-to-gd/emitter.js

@@ -0,0 +1,88 @@
+import { SourceMapper } from "../../sourcemap/index.js";
+/**
+ * GDScript code emitter with source map support.
+ * Tracks line/column positions as code is emitted.
+ */
+export class GDScriptEmitter {
+    output = [];
+    currentLine = 1;
+    currentColumn = 0;
+    indentLevel = 0;
+    indentStr = '\t';
+    sourceMapper = null;
+    sourceFile;
+    constructor(sourceFile, generatedFile, enableSourceMap = false) {
+        this.sourceFile = sourceFile;
+        if (enableSourceMap && generatedFile) {
+            this.sourceMapper = new SourceMapper(sourceFile, generatedFile);
+        }
+    }
+    indent() {
+        this.indentLevel++;
+    }
+    dedent() {
+        this.indentLevel = Math.max(0, this.indentLevel - 1);
+    }
+    /**
+     * Write text to output, tracking position for source maps.
+     * @param text The text to write
+     * @param originalLine Original source line (1-based), for source map
+     * @param originalColumn Original source column (0-based), for source map
+     */
+    write(text, originalLine, originalColumn) {
+        if (originalLine !== undefined &&
+            originalColumn !== undefined &&
+            this.sourceMapper) {
+            this.sourceMapper.addMapping({
+                source: this.sourceFile,
+                originalLine,
+                originalColumn,
+                generatedLine: this.currentLine,
+                generatedColumn: this.currentColumn,
+            });
+        }
+        const lines = text.split('\n');
+        this.output.push(text);
+        this.currentLine += lines.length - 1;
+        this.currentColumn =
+            lines.length > 1
+                ? lines.at(-1).length
+                : this.currentColumn + lines.at(0).length;
+    }
+    /** Write text followed by a newline, with mapping at column 0 (line start). */
+    writeLine(text, originalLine, originalColumn) {
+        const indent = this.indentStr.repeat(this.indentLevel);
+        this.write(indent + text, originalLine, originalColumn);
+        this.write('\n');
+    }
+    /** Write an empty line */
+    writeEmptyLine() {
+        this.write('\n');
+    }
+    /** Get current indentation level */
+    getIndentLevel() {
+        return this.indentLevel;
+    }
+    /** Get indentation string for a given level */
+    getIndentStr(level) {
+        return this.indentStr.repeat(level ?? this.indentLevel);
+    }
+    /** Write current indentation */
+    writeIndent() {
+        const indent = this.indentStr.repeat(this.indentLevel);
+        this.write(indent);
+    }
+    /** Get the generated code */
+    getOutput() {
+        return this.output.join('');
+    }
+    /** Get the source map JSON string, or undefined if source maps are disabled */
+    getSourceMap() {
+        return this.sourceMapper?.toString();
+    }
+    /** Set source content for source maps */
+    setSourceContent(content) {
+        this.sourceMapper?.addSourceContent(this.sourceFile, content);
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/converter/ts-to-gd/emitter.js.map

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

package/dist/converter/ts-to-gd/expressions.d.ts

@@ -0,0 +1,46 @@
+import ts from 'typescript';
+import type { TransformerDelegate } from './transformer-types.ts';
+export declare function emitExpression(t: TransformerDelegate, node: ts.Expression): string;
+/**
+ * Pre-pass: forbid EXPLICIT `Promise<T>` / `PromiseLike<T>` type
+ * annotations anywhere except as the return type of an `async`
+ * function / method / arrow.
+ *
+ * Walks the whole source file once so variable annotations,
+ * parameter types, non-async return types, type aliases, generic
+ * constraints, and nested positions (e.g. `Array<Promise<T>>`) are
+ * all caught in a single place — no per-call-site sprinkling.
+ *
+ * Only flags USER-WRITTEN annotations (TypeReferenceNodes with a
+ * forbidden name). Inferred Promise types from `async` functions
+ * aren't touched here — those are handled by
+ * `tsTypeNodeToGdType` stripping `Promise<T>` → `T` on emission,
+ * and by `checkPromiseUsedAsValue` for value-position misuse.
+ *
+ * A symbol-level check (via `checker.getSymbolAtLocation`) runs
+ * only when the name-based gate already matched, so the cost is
+ * bounded by the number of Promise-named references in the file
+ * (typically 0–5). It filters out user-shadowed names like
+ * `class Promise {}` that aren't actually the global Promise.
+ */
+export declare function checkExplicitPromiseTypes(t: TransformerDelegate): void;
+export declare function emitPropertyAccess(t: TransformerDelegate, node: ts.PropertyAccessExpression): string;
+export declare function emitCallExpression(t: TransformerDelegate, node: ts.CallExpression): string;
+export declare function emitBinaryExpression(t: TransformerDelegate, node: ts.BinaryExpression): string;
+export declare function binaryOperator(kind: ts.SyntaxKind): string;
+export declare function unaryOperator(op: ts.PrefixUnaryOperator): string;
+export declare function emitStringLiteral(t: TransformerDelegate, node: ts.StringLiteral): string;
+export declare function escapeGdString(text: string): string;
+export declare function emitTemplateExpression(t: TransformerDelegate, node: ts.TemplateExpression): string;
+export declare function emitLambda(t: TransformerDelegate, node: ts.ArrowFunction | ts.FunctionExpression): string;
+/**
+ * Check if an expression is a block-body lambda (arrow function or function expression with a block body).
+ */
+export declare function isBlockLambda(node: ts.Expression): node is ts.ArrowFunction | ts.FunctionExpression;
+/**
+ * Emit the body of a block lambda. Call this after the line containing the lambda header.
+ */
+export declare function emitLambdaBody(t: TransformerDelegate, node: ts.ArrowFunction | ts.FunctionExpression): void;
+/** Emit a multi-line GDScript dict with proper indentation */
+export declare function emitMultiLineDict(t: TransformerDelegate, entries: string[]): string;
+//# sourceMappingURL=expressions.d.ts.map

package/dist/converter/ts-to-gd/expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../../src/converter/ts-to-gd/expressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAU5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,wBAAgB,cAAc,CAC5B,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,UAAU,GAClB,MAAM,CAkMR;AAkED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAyBtE;AAuDD,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,wBAAwB,GAChC,MAAM,CAmER;AAoED,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,cAAc,GACtB,MAAM,CAuGR;AAoFD,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,gBAAgB,GACxB,MAAM,CAgDR;AAwCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,CA+D1D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,mBAAmB,GAAG,MAAM,CAahE;AAID,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,aAAa,GACrB,MAAM,CAUR;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAID,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,kBAAkB,GAC1B,MAAM,CAUR;AAID,wBAAgB,UAAU,CACxB,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC,kBAAkB,GAC7C,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,EAAE,CAAC,UAAU,GAClB,IAAI,IAAI,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC,kBAAkB,CAKlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC,kBAAkB,GAC7C,IAAI,CAUN;AAID,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,mBAAmB,EACtB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAKR"}