typescript-to-gdscript 0.1.0

package/dist/ts-plugin/navigation.js

@@ -0,0 +1,427 @@
+/**
+ * Navigation overlay for the typescript-to-gdscript language-service
+ * plugin.
+ *
+ * Bridges the converter's generated *shadow classes* back to their real
+ * sources so IDE navigation (go-to-def, find-usages) treats `Foo` the
+ * global and `Foo` the source-file class as one thing.
+ *
+ * The typings generator emits, per script `.d.ts`:
+ *
+ *     import type { Foo as ScriptClass } from "./Foo.js";
+ *     declare global {
+ *       class Foo extends ScriptClass {
+ *         run: ScriptClass["run"];
+ *         name: ScriptClass["name"];
+ *         static create: typeof ScriptClass["create"];
+ *       }
+ *     }
+ *
+ * Each forwarded member gives WebStorm/VS Code a real indexed symbol to
+ * find-all-refs from — but the symbol is technically on the shadow
+ * class, distinct from the source class member. Without this overlay,
+ * navigating or finding usages from the source member misses the
+ * global callsites, and vice versa.
+ *
+ * Two groups of language-service methods are wrapped:
+ *
+ *   1. `getDefinitionAtPosition` / `getDefinitionAndBoundSpan` /
+ *      `getTypeDefinitionAtPosition` / `getImplementationAtPosition` —
+ *      when the default result lands on a shadow class or a forwarded
+ *      shadow member, follow the chain to the real source declaration.
+ *
+ *   2. `findReferences` / `getReferencesAtPosition` — when the cursor
+ *      is on a class identifier or a class member whose other side
+ *      (shadow or source) exists, run the refs query from both sides
+ *      and merge the results (deduped by position).
+ *
+ * The checker's type view is NOT modified — this is purely navigation.
+ */
+import { findNodeAtOffset, mergeReferenceEntries, mergeReferencedSymbols, } from "./shadow-refs.js";
+import { LRU } from "./lru.js";
+export function createNavigationOverlay(deps) {
+    const { ts, ls, log } = deps;
+    // ─── Shadow-class lookup memo ────────────────────────────
+    //
+    // `findShadowForClass` is called on every find-references invocation
+    // that lands on a real class identifier — a hot path on large codebases.
+    // The underlying scan walks every `.d.ts` SourceFile in the program
+    // searching for a matching shadow declaration (O(N * files)).
+    //
+    // We memoize the result keyed by className (with `null` stored for
+    // "no shadow exists") and invalidate the whole memo whenever the
+    // Program identity changes — tsserver hands us a fresh Program on
+    // every buffer edit, and a new Program can contain new `.d.ts`
+    // files. LRU caps the memo size so renaming many classes in sequence
+    // doesn't let it grow unbounded.
+    const SHADOW_CACHE_MAX = 500;
+    const shadowCache = new LRU(SHADOW_CACHE_MAX);
+    let shadowCacheProgram = null;
+    /** Invalidate the memo when the Program we cached against has been replaced. */
+    function ensureShadowCacheFresh(program) {
+        if (shadowCacheProgram !== program) {
+            shadowCache.clear();
+            shadowCacheProgram = program;
+        }
+    }
+    // ─── Shadow detection ────────────────────────────────────
+    /**
+     * A "shadow class" is the pattern emitted by the generator: a class
+     * declaration inside a `declare global { … }` block that extends
+     * exactly one identifier. Body may be empty OR hold forwarded
+     * indexed-access declarations (`run: _Foo["run"]`).
+     */
+    function isShadowClass(cls) {
+        if (!cls.name)
+            return false;
+        if (!cls.heritageClauses || cls.heritageClauses.length !== 1)
+            return false;
+        const ext = cls.heritageClauses[0];
+        if (ext.token !== ts.SyntaxKind.ExtendsKeyword)
+            return false;
+        if (ext.types.length !== 1)
+            return false;
+        let p = cls.parent;
+        while (p) {
+            if (ts.isModuleDeclaration(p) &&
+                p.name.kind === ts.SyntaxKind.Identifier &&
+                p.name.text === 'global') {
+                return true;
+            }
+            p = p.parent;
+        }
+        return false;
+    }
+    /**
+     * Follow `class X extends _X {…}` to the real `X` source declaration
+     * by asking the language service for the definition of `_X` in the
+     * extends clause, then unwrapping any intermediate import alias.
+     */
+    function resolveShadowToReal(shadow) {
+        const ext = shadow.heritageClauses?.[0];
+        if (!ext)
+            return;
+        const baseExpr = ext.types[0].expression;
+        if (!ts.isIdentifier(baseExpr))
+            return;
+        const sf = shadow.getSourceFile();
+        const defs = ls.getDefinitionAtPosition(sf.fileName, baseExpr.getStart(sf));
+        if (!defs || defs.length === 0)
+            return;
+        for (const d of defs) {
+            if (d.fileName === sf.fileName &&
+                d.textSpan.start >= shadow.getStart(sf) &&
+                d.textSpan.start < shadow.getEnd())
+                continue;
+            const alias = tryFindImportAliasAtDef(d);
+            if (alias) {
+                const source = resolveImportAliasToSource(alias, sf);
+                if (source)
+                    return source;
+            }
+            return d;
+        }
+        return undefined;
+    }
+    function tryFindImportAliasAtDef(def) {
+        const program = ls.getProgram();
+        if (!program)
+            return;
+        const sf = program.getSourceFile(def.fileName);
+        if (!sf)
+            return;
+        const node = findNodeAtOffset(sf, def.textSpan.start);
+        let p = node;
+        while (p && !ts.isImportSpecifier(p))
+            p = p.parent;
+        return p && ts.isImportSpecifier(p) ? p : undefined;
+    }
+    function resolveImportAliasToSource(spec, sf) {
+        const ident = spec.propertyName ?? spec.name;
+        const defs = ls.getDefinitionAtPosition(sf.fileName, ident.getStart(sf));
+        return defs?.[0];
+    }
+    // ─── Redirection (shadow → source) ───────────────────────
+    /**
+     * Rewrite a definition that lands on a shadow class or a shadow
+     * member to point at the corresponding source declaration. Returns
+     * undefined if the definition isn't shadow-related.
+     */
+    function redirectDef(def) {
+        const program = ls.getProgram();
+        if (!program)
+            return;
+        const sf = program.getSourceFile(def.fileName);
+        if (!sf)
+            return;
+        const node = findNodeAtOffset(sf, def.textSpan.start);
+        if (!node)
+            return;
+        let cls = node;
+        while (cls && !ts.isClassDeclaration(cls))
+            cls = cls.parent;
+        if (!cls || !ts.isClassDeclaration(cls) || !isShadowClass(cls))
+            return;
+        const member = findEnclosingMember(node, cls);
+        const real = resolveShadowToReal(cls);
+        if (!real)
+            return;
+        if (!member) {
+            log(`redirect class ${def.fileName}:${def.textSpan.start} → ${real.fileName}:${real.textSpan.start}`);
+            return { ...def, fileName: real.fileName, textSpan: real.textSpan };
+        }
+        const memberName = memberNameText(member);
+        if (!memberName)
+            return;
+        const realMember = findMemberInRealClass(real, memberName, isStaticMember(member));
+        if (!realMember)
+            return;
+        log(`redirect member ${memberName} ${def.fileName}:${def.textSpan.start} → ${realMember.fileName}:${realMember.textSpan.start}`);
+        return {
+            ...def,
+            fileName: realMember.fileName,
+            textSpan: realMember.textSpan,
+        };
+    }
+    function findEnclosingMember(node, cls) {
+        let p = node;
+        while (p && p !== cls) {
+            if (ts.isPropertyDeclaration(p) ||
+                ts.isMethodDeclaration(p) ||
+                ts.isGetAccessorDeclaration(p) ||
+                ts.isSetAccessorDeclaration(p) ||
+                ts.isPropertySignature(p) ||
+                ts.isMethodSignature(p)) {
+                return p;
+            }
+            p = p.parent;
+        }
+        return undefined;
+    }
+    function memberNameText(m) {
+        if (!m.name)
+            return;
+        if (ts.isIdentifier(m.name) || ts.isStringLiteral(m.name)) {
+            return m.name.text;
+        }
+        return undefined;
+    }
+    function isStaticMember(m) {
+        const mods = ts.getModifiers(m) ?? [];
+        return mods.some((mod) => mod.kind === ts.SyntaxKind.StaticKeyword);
+    }
+    /**
+     * Given the definition of a real class (e.g. `class Foo { run() {} }`),
+     * find the position of the member named `memberName` on that class.
+     */
+    function findMemberInRealClass(classDef, memberName, isStatic) {
+        const program = ls.getProgram();
+        if (!program)
+            return;
+        const sf = program.getSourceFile(classDef.fileName);
+        if (!sf)
+            return;
+        const node = findNodeAtOffset(sf, classDef.textSpan.start);
+        let cls = node;
+        while (cls && !ts.isClassDeclaration(cls))
+            cls = cls.parent;
+        if (!cls || !ts.isClassDeclaration(cls))
+            return;
+        for (const m of cls.members) {
+            if (memberNameText(m) !== memberName)
+                continue;
+            if (isStaticMember(m) !== isStatic)
+                continue;
+            if (!m.name)
+                continue;
+            const start = m.name.getStart(sf);
+            return {
+                ...classDef,
+                fileName: sf.fileName,
+                textSpan: { start, length: m.name.getEnd() - start },
+            };
+        }
+        return undefined;
+    }
+    // ─── Reference bridging (real ↔ shadow) ─────────────────
+    /**
+     * If the cursor is on a class identifier OR a class member name
+     * that has a shadow counterpart, return the bridge position so the
+     * caller can run a second refs query from there and merge.
+     */
+    function findBridgePosition(fileName, position) {
+        const program = ls.getProgram();
+        if (!program)
+            return;
+        const sf = program.getSourceFile(fileName);
+        if (!sf)
+            return;
+        const node = findNodeAtOffset(sf, position);
+        if (!node || !ts.isIdentifier(node))
+            return;
+        const parent = node.parent;
+        // A) Cursor on a class-name identifier.
+        if (ts.isClassDeclaration(parent) && parent.name === node) {
+            return bridgeClassName(parent);
+        }
+        // B) Cursor on a member-name identifier inside a class.
+        if (isMemberNameOfClass(node)) {
+            return bridgeMemberName(node);
+        }
+        return undefined;
+    }
+    function bridgeClassName(cls) {
+        if (isShadowClass(cls)) {
+            const real = resolveShadowToReal(cls);
+            return real
+                ? { fileName: real.fileName, position: real.textSpan.start }
+                : undefined;
+        }
+        if (cls.name) {
+            const shadow = findShadowForClass(cls.name.text);
+            if (shadow?.name) {
+                const shadowSf = shadow.getSourceFile();
+                return {
+                    fileName: shadowSf.fileName,
+                    position: shadow.name.getStart(shadowSf),
+                };
+            }
+        }
+        return undefined;
+    }
+    function bridgeMemberName(nameNode) {
+        const member = nameNode.parent;
+        const cls = member.parent;
+        if (!cls || !ts.isClassDeclaration(cls) || !cls.name)
+            return;
+        if (isShadowClass(cls)) {
+            // Shadow member → real member.
+            const real = resolveShadowToReal(cls);
+            if (!real)
+                return;
+            const realMember = findMemberInRealClass(real, nameNode.text, isStaticMember(member));
+            return realMember
+                ? { fileName: realMember.fileName, position: realMember.textSpan.start }
+                : undefined;
+        }
+        // Real member → shadow member (if a shadow exists).
+        const shadow = findShadowForClass(cls.name.text);
+        if (!shadow)
+            return;
+        for (const m of shadow.members) {
+            if (memberNameText(m) !== nameNode.text)
+                continue;
+            if (isStaticMember(m) !== isStaticMember(member))
+                continue;
+            if (!m.name)
+                continue;
+            const shadowSf = shadow.getSourceFile();
+            return {
+                fileName: shadowSf.fileName,
+                position: m.name.getStart(shadowSf),
+            };
+        }
+        return undefined;
+    }
+    function isMemberNameOfClass(id) {
+        const p = id.parent;
+        if (!ts.isPropertyDeclaration(p) &&
+            !ts.isMethodDeclaration(p) &&
+            !ts.isGetAccessorDeclaration(p) &&
+            !ts.isSetAccessorDeclaration(p) &&
+            !ts.isPropertySignature(p) &&
+            !ts.isMethodSignature(p))
+            return false;
+        return p.name === id && p.parent && ts.isClassDeclaration(p.parent);
+    }
+    function findShadowForClass(className) {
+        const program = ls.getProgram();
+        if (!program)
+            return;
+        ensureShadowCacheFresh(program);
+        // `has` distinguishes a cached negative (`null` = known not to
+        // exist) from an absent entry — both map to `undefined` here but
+        // the cached-negative case skips the scan.
+        if (shadowCache.has(className)) {
+            return shadowCache.get(className) ?? undefined;
+        }
+        const result = scanProgramForShadow(program, className);
+        shadowCache.set(className, result ?? null);
+        return result;
+    }
+    /** Walk every `.d.ts` in `program` looking for a matching shadow class. */
+    function scanProgramForShadow(program, className) {
+        for (const sf of program.getSourceFiles()) {
+            if (!sf.fileName.endsWith('.d.ts'))
+                continue;
+            let result;
+            const visit = (n) => {
+                if (result)
+                    return;
+                if (ts.isClassDeclaration(n) &&
+                    n.name?.text === className &&
+                    isShadowClass(n)) {
+                    result = n;
+                    return;
+                }
+                n.forEachChild(visit);
+            };
+            visit(sf);
+            if (result)
+                return result;
+        }
+        return undefined;
+    }
+    // ── Public LS method wrappers ───────────────────────────
+    return {
+        getDefinitionAndBoundSpan(fileName, position) {
+            const result = ls.getDefinitionAndBoundSpan(fileName, position);
+            if (!result || !result.definitions)
+                return result;
+            const definitions = result.definitions.map((d) => redirectDef(d) ?? d);
+            return { ...result, definitions };
+        },
+        getDefinitionAtPosition(fileName, position) {
+            const defs = ls.getDefinitionAtPosition(fileName, position);
+            return defs?.map((d) => redirectDef(d) ?? d);
+        },
+        getTypeDefinitionAtPosition(fileName, position) {
+            const defs = ls.getTypeDefinitionAtPosition(fileName, position);
+            return defs?.map((d) => redirectDef(d) ?? d);
+        },
+        getImplementationAtPosition(fileName, position) {
+            const defs = ls.getImplementationAtPosition(fileName, position);
+            if (!defs)
+                return defs;
+            return defs.map((d) => {
+                const redirected = redirectDef({
+                    ...d,
+                    containerName: '',
+                    containerKind: ts.ScriptElementKind.unknown,
+                    name: '',
+                    kind: ts.ScriptElementKind.unknown,
+                });
+                return redirected
+                    ? { ...d, fileName: redirected.fileName, textSpan: redirected.textSpan }
+                    : d;
+            });
+        },
+        findReferences(fileName, position) {
+            const primary = ls.findReferences(fileName, position) ?? [];
+            const bridge = findBridgePosition(fileName, position);
+            if (!bridge)
+                return primary.length > 0 ? primary : undefined;
+            const extra = ls.findReferences(bridge.fileName, bridge.position) ?? [];
+            return mergeReferencedSymbols([...primary, ...extra]);
+        },
+        getReferencesAtPosition(fileName, position) {
+            const primary = ls.getReferencesAtPosition(fileName, position) ?? [];
+            const bridge = findBridgePosition(fileName, position);
+            if (!bridge)
+                return primary.length > 0 ? primary : undefined;
+            const extra = ls.getReferencesAtPosition(bridge.fileName, bridge.position) ?? [];
+            return mergeReferenceEntries([...primary, ...extra]);
+        },
+    };
+}
+//# sourceMappingURL=navigation.js.map

package/dist/ts-plugin/navigation.js.map

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

package/dist/ts-plugin/shadow-refs.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Low-level helpers shared by the navigation overlay:
+ *   - reference-list merging (dedup by position);
+ *   - AST node lookup by offset.
+ *
+ * Isolated here so `navigation.ts` stays under the 500-line cap and
+ * these pure helpers can be unit-tested independently of the LS
+ * wiring.
+ */
+import type tsModule from 'typescript';
+/**
+ * De-duplicate reference entries by (file, start, length). Used to
+ * merge the primary query's result with the bridge (shadow↔source)
+ * query's result so callsites that happen to be reported by both
+ * don't appear twice.
+ */
+export declare function mergeReferenceEntries(entries: readonly tsModule.ReferenceEntry[]): tsModule.ReferenceEntry[];
+/**
+ * Merge `ReferencedSymbol` groups from primary and bridge queries.
+ * Groups sharing a definition position are coalesced (references
+ * concatenated + deduped); otherwise preserved as distinct entries.
+ */
+export declare function mergeReferencedSymbols(groups: readonly tsModule.ReferencedSymbol[]): tsModule.ReferencedSymbol[];
+/**
+ * Return the deepest AST node in `sf` whose span contains `offset`.
+ * Walks top-down into children as long as they still contain the
+ * offset. Used by navigation overlays to locate the symbol at a
+ * cursor position without touching the TypeChecker.
+ */
+export declare function findNodeAtOffset(sf: tsModule.SourceFile, offset: number): tsModule.Node | undefined;
+//# sourceMappingURL=shadow-refs.d.ts.map

package/dist/ts-plugin/shadow-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-refs.d.ts","sourceRoot":"","sources":["../../src/ts-plugin/shadow-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AASvC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,QAAQ,CAAC,cAAc,EAAE,GAC1C,QAAQ,CAAC,cAAc,EAAE,CAU3B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,QAAQ,CAAC,gBAAgB,EAAE,GAC3C,QAAQ,CAAC,gBAAgB,EAAE,CAkB7B;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,UAAU,EACvB,MAAM,EAAE,MAAM,GACb,QAAQ,CAAC,IAAI,GAAG,SAAS,CAU3B"}

package/dist/ts-plugin/shadow-refs.js

@@ -0,0 +1,76 @@
+/**
+ * Low-level helpers shared by the navigation overlay:
+ *   - reference-list merging (dedup by position);
+ *   - AST node lookup by offset.
+ *
+ * Isolated here so `navigation.ts` stays under the 500-line cap and
+ * these pure helpers can be unit-tested independently of the LS
+ * wiring.
+ */
+// ── Reference merging ──────────────────────────────────────
+/** Position-based dedup key for a `ReferenceEntry`. */
+function mergeRefKey(r) {
+    return `${r.fileName}:${r.textSpan.start}:${r.textSpan.length}`;
+}
+/**
+ * De-duplicate reference entries by (file, start, length). Used to
+ * merge the primary query's result with the bridge (shadow↔source)
+ * query's result so callsites that happen to be reported by both
+ * don't appear twice.
+ */
+export function mergeReferenceEntries(entries) {
+    const seen = new Set();
+    const out = [];
+    for (const e of entries) {
+        const k = mergeRefKey(e);
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        out.push(e);
+    }
+    return out;
+}
+/**
+ * Merge `ReferencedSymbol` groups from primary and bridge queries.
+ * Groups sharing a definition position are coalesced (references
+ * concatenated + deduped); otherwise preserved as distinct entries.
+ */
+export function mergeReferencedSymbols(groups) {
+    const byDef = new Map();
+    for (const g of groups) {
+        const key = `${g.definition.fileName}:${g.definition.textSpan.start}`;
+        const existing = byDef.get(key);
+        if (!existing) {
+            byDef.set(key, {
+                definition: g.definition,
+                references: mergeReferenceEntries(g.references),
+            });
+        }
+        else {
+            existing.references = mergeReferenceEntries([
+                ...existing.references,
+                ...g.references,
+            ]);
+        }
+    }
+    return [...byDef.values()];
+}
+// ── AST walking ────────────────────────────────────────────
+/**
+ * Return the deepest AST node in `sf` whose span contains `offset`.
+ * Walks top-down into children as long as they still contain the
+ * offset. Used by navigation overlays to locate the symbol at a
+ * cursor position without touching the TypeChecker.
+ */
+export function findNodeAtOffset(sf, offset) {
+    let found;
+    const visit = (n) => {
+        if (n.getStart(sf) <= offset && offset < n.getEnd()) {
+            found = n;
+            n.forEachChild(visit);
+        }
+    };
+    visit(sf);
+    return found;
+}
+//# sourceMappingURL=shadow-refs.js.map

package/dist/ts-plugin/shadow-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-refs.js","sourceRoot":"","sources":["../../src/ts-plugin/shadow-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,8DAA8D;AAE9D,uDAAuD;AACvD,SAAS,WAAW,CAAC,CAA0B;IAC7C,OAAO,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA2C;IAE3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA4C;IAE5C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC3D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACb,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,UAAU,EAAE,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC;aAChD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,UAAU,GAAG,qBAAqB,CAAC;gBAC1C,GAAG,QAAQ,CAAC,UAAU;gBACtB,GAAG,CAAC,CAAC,UAAU;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,8DAA8D;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAuB,EACvB,MAAc;IAEd,IAAI,KAAgC,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAQ,EAAE;QACvC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,KAAK,GAAG,CAAC,CAAC;YACV,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/ts-plugin/snapshot-transform.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Plugin snapshot transform — appends a per-script type augmentation
+ * block (typed `get_node` overloads, `StaticProps` mirror,
+ * `GodotScripts` / `GodotResources` entries) to the END of every
+ * in-scope `.ts` so the IDE sees the same augmentation that the
+ * `<name>.gd.d.ts` files provide for non-plugin setups.
+ *
+ * **Position-perfect**: the transform ONLY appends past the user's
+ * source — no in-source modification. Every byte / line / column
+ * position in the user region is byte-identical to the original.
+ *
+ * The transform does NOT auto-lift file-scope `const` / `enum` /
+ * `class` into the script class anymore. Users who want those
+ * accessible as `Foo.X` should wrap them in an explicit
+ * `export namespace Foo { ... }` block paired with their
+ * `export class Foo` — TypeScript's native declaration merging
+ * handles the rest, and the GDScript converter lifts the namespace
+ * members into the class body.
+ *
+ * The augmentation is type-only (`declare global { ... }`,
+ * `interface Foo extends StaticProps`), which the GDScript
+ * converter naturally skips via its generic "ambient declarations
+ * have no GD counterpart" rule.
+ */
+export interface SnapshotTransformResult {
+    /** Transformed source text — the original text plus appended augmentation. */
+    transformed: string;
+    /** Byte length of the ORIGINAL source. */
+    originalLength: number;
+    /**
+     * Byte position in the AUGMENTED text where the user-region ENDS
+     * and the synthetic appended block begins. Equals
+     * `originalLength` because the transform only appends — no in-
+     * source splicing. Diagnostics whose `start >= userRegionEnd`
+     * are synthesis-only and dropped by the plugin's filter.
+     */
+    userRegionEnd: number;
+    /** Number of lines in the original source. */
+    originalLineCount: number;
+}
+/**
+ * Optional inputs the plugin can supply to inject extra trailing-
+ * only augmentation (positions of all bytes in the user region are
+ * preserved — this only changes `transformed.length`).
+ */
+export interface SnapshotTransformOptions {
+    /**
+     * Per-script augmentation text appended to the source. Built by
+     * `generateInlineScriptAugmentation` in the typings module
+     * (typed `get_node` overloads, `interface Foo extends StaticProps`,
+     * `declare global { GodotScripts/GodotResources/__FooGd__Trees }`).
+     */
+    scriptAugmentation?: string;
+}
+/**
+ * Transform a TS source snapshot for the language service. Returns
+ * the original text unchanged when no augmentation is supplied or
+ * the file is empty.
+ */
+export declare function transformSnapshot(source: string, _fileName: string, options?: SnapshotTransformOptions): SnapshotTransformResult;
+//# sourceMappingURL=snapshot-transform.d.ts.map

package/dist/ts-plugin/snapshot-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-transform.d.ts","sourceRoot":"","sources":["../../src/ts-plugin/snapshot-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAoBzB"}