typescript-to-gdscript 0.1.0

package/dist/ts-plugin/lint.js

@@ -0,0 +1,424 @@
+/**
+ * Lint overlay for the typescript-to-gdscript language-service plugin.
+ *
+ * Surfaces converter + Godot diagnostics as regular `ts.Diagnostic`s so
+ * the IDE shows TS→GD problems inline, exactly like TypeScript's own
+ * errors. Two tiers, in preference order:
+ *
+ *   1. **Live convert** (`liveDiagnosticsFor`) — runs `convertTsToGd`
+ *      in-process against tsserver's own `ts.Program`. Handles the
+ *      dirty buffer (unsaved changes), produces converter diagnostics
+ *      synchronously, and kicks off async Godot validation. Results
+ *      are memoized per (file, SourceFile.version) in an LRU.
+ *
+ *   2. **Cached fallback** (`cachedDiagnosticsFor`) — reads diagnostics
+ *      the CLI/watcher already stored in the `ProjectCache`. Used when
+ *      live convert can't run (e.g. convert threw) OR produced nothing
+ *      but the on-disk cache has a fresh entry.
+ *
+ * Godot validation runs async on every successful live convert. When
+ * Godot returns we merge its diagnostics into the live memo and call
+ * `info.project.refreshDiagnostics()` so tsserver re-queries the file
+ * without waiting for another edit.
+ */
+import { resolve, relative } from 'path';
+import { ProjectCache, hashContent, } from "../cache/index.js";
+import { resolveGodotPath } from "../config/index.js";
+import { convertTsToGd } from "../converter/ts-to-gd/index.js";
+import { validateGdFiles } from "../godot-validate/index.js";
+import { LRU } from "./lru.js";
+/** Diagnostic codes the plugin owns — users can filter them via source === 'tstogd'. */
+const DIAG_CODE_BASE = 90000;
+export function createLintOverlay(deps) {
+    const { ts, info, ls, cfg, cache, log, trace } = deps;
+    /**
+     * Per-file memo of converter + Godot diagnostics, keyed by fileName.
+     * Each entry is small (a few hundred bytes) so the cap is generous
+     * — it exists purely to keep the Map from growing for the life of
+     * the tsserver process.
+     */
+    const liveCache = new LRU(100);
+    /**
+     * In-flight Godot validations, one per file. Aborting a previous
+     * run before starting a new one kills its child process and lets
+     * `validateGdFiles` return early instead of parsing stale output.
+     *
+     * Entries self-clean on settle — we only delete when the stored
+     * controller is still our own, so a superseding request doesn't
+     * race-clear the newer controller that just replaced ours. At
+     * steady state the size is bounded by the number of files
+     * concurrently being validated — normally 1, at most a handful.
+     */
+    const pendingGodot = new Map();
+    /**
+     * Last-known Godot diagnostics per file, stored as `CachedDiagnostic[]`
+     * (SourceFile-independent) so they can be re-anchored against any
+     * future version's `SourceFile`. Crucial for on-the-fly validation
+     * in WebStorm: WebStorm only repaints squiggles from a "primary"
+     * `getErr` round (one it initiated), not from async follow-ups
+     * triggered by `refreshDiagnostics()`. By seeding every new
+     * `LiveEntry.godot` from this cache, the very first `getErr` for
+     * a new version already carries Godot diagnostics — so WebStorm
+     * paints them on its own primary-round response, no async-refresh
+     * dependency needed.
+     *
+     * The diag positions are stale until fresh Godot catches up (at most
+     * one line or two off during active typing), but the presence of
+     * the squiggle is what matters UX-wise. Fresh Godot overwrites both
+     * `liveCache[file].godot` and this map on every completion.
+     *
+     * `LRU(100)` caps the map size. Evicted entries just mean those
+     * files start without a seed on the next edit — no data loss for
+     * on-disk state.
+     */
+    const lastGodotByFile = new LRU(100);
+    /**
+     * Accept a file for plugin overlays iff it's a plain `.ts` (not
+     * `.d.ts`) AND it lives under `cfg.tsDir`. Pure O(1) check — no
+     * I/O, no memos. Files outside `tsDir` are foreign; the plugin
+     * ignores them.
+     */
+    function isInScope(fileName) {
+        if (!fileName.endsWith('.ts') || fileName.endsWith('.d.ts')) {
+            trace(`skip ${fileName}: not a plain .ts file`);
+            return false;
+        }
+        // `rel` starts with `..` iff `fileName` is outside `cfg.tsDir`.
+        const rel = relative(cfg.tsDir, fileName);
+        if (rel.startsWith('..')) {
+            trace(`skip ${fileName}: outside tsDir (${cfg.tsDir})`);
+            return false;
+        }
+        return true;
+    }
+    function severityToCategory(sev) {
+        switch (sev) {
+            case 'error':
+            case 'type-error':
+                return ts.DiagnosticCategory.Error;
+            case 'warning':
+                return ts.DiagnosticCategory.Warning;
+            default:
+                return ts.DiagnosticCategory.Suggestion;
+        }
+    }
+    /**
+     * Convert cached converter diagnostics into ts.Diagnostic objects
+     * anchored at the right positions in the current source file.
+     * Skips any diagnostic whose file doesn't match `fileName` — keeps
+     * cross-file diagnostics from being mis-attributed to the wrong
+     * SourceFile (which would make positions nonsensical).
+     */
+    function cachedToTsDiagnostics(fileName, cached) {
+        const program = ls.getProgram();
+        if (!program)
+            return [];
+        const sf = program.getSourceFile(fileName);
+        if (!sf)
+            return [];
+        const out = [];
+        for (const d of cached) {
+            if (resolve(d.file) !== resolve(fileName))
+                continue;
+            if (d.severity === 'info')
+                continue;
+            // CachedDiagnostic line/column are 1-based from the converter.
+            const line = Math.max(0, d.line - 1);
+            const col = Math.max(0, d.column - 1);
+            let start;
+            try {
+                start = ts.getPositionOfLineAndCharacter(sf, line, col);
+            }
+            catch {
+                // Out-of-range position — anchor at line start as a fallback.
+                try {
+                    start = ts.getPositionOfLineAndCharacter(sf, Math.min(line, sf.getLineStarts().length - 1), 0);
+                }
+                catch {
+                    start = 0;
+                }
+            }
+            // Make the squiggle span the remainder of the line so it's
+            // visible even when column info is imprecise.
+            const lineStarts = sf.getLineStarts();
+            const nextLineStart = line + 1 < lineStarts.length ? lineStarts[line + 1] : sf.getEnd();
+            const length = Math.max(1, nextLineStart - start - 1);
+            out.push({
+                file: sf,
+                start,
+                length,
+                category: severityToCategory(d.severity),
+                code: DIAG_CODE_BASE + (d.severity === 'type-error' ? 1 : 0),
+                messageText: d.message,
+                source: 'tstogd',
+            });
+        }
+        return out;
+    }
+    function toCachedDiagnostics(diags) {
+        return diags.map((d) => ({
+            message: d.message,
+            severity: d.severity,
+            file: d.file,
+            line: d.line,
+            column: d.column,
+        }));
+    }
+    // ── Tier 1: cached fallback ───────────────────────────────
+    function cachedDiagnosticsFor(fileName) {
+        if (!isInScope(fileName))
+            return [];
+        const relPath = relative(cfg.tsDir, fileName);
+        const gdPath = resolve(cfg.gdDir, relPath.replace(/\.ts$/, '.gd'));
+        // Accept the entry if either:
+        //   (a) disk is fresh (real .gd matches entry), or
+        //   (b) cache-folder has a fresh copy (plugin/CLI just ran but
+        //       hasn't promoted yet) — in which case the diagnostics in
+        //       the entry still correspond to the current source.
+        const freshOnDisk = cache.isTsToGdFresh(fileName, gdPath);
+        const freshInCache = cache.hasFreshCachedGd(fileName);
+        if (!freshOnDisk && !freshInCache)
+            return [];
+        const diags = cache.getDiagnostics(fileName);
+        if (!diags)
+            return [];
+        return cachedToTsDiagnostics(fileName, diags);
+    }
+    function liveDiagnosticsFor(fileName) {
+        trace(`getSemanticDiagnostics fileName=${fileName}`);
+        if (!isInScope(fileName))
+            return [];
+        const program = ls.getProgram();
+        if (!program) {
+            trace(`skip ${fileName}: no program`);
+            return [];
+        }
+        const sf = program.getSourceFile(fileName);
+        if (!sf) {
+            trace(`skip ${fileName}: source file not in program`);
+            return [];
+        }
+        // tsserver sets `.version` on every SourceFile it tracks, but it's
+        // not in the public type. Fall back to a content hash when absent
+        // (e.g. SourceFiles from a raw createProgram, which `tsc --noEmit`
+        // uses in tests).
+        const version = 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        sf.version ?? hashContent(sf.getFullText());
+        // LRU.get() already bumps the entry to most-recently-used on hit.
+        const memo = liveCache.get(fileName);
+        if (memo && memo.version === version) {
+            trace(`memo hit ${fileName} version=${version} converter=${memo.converter.length} godot=${memo.godot.length} → returning ${memo.converter.length + memo.godot.length} ts.Diagnostic(s)`);
+            return [...memo.converter, ...memo.godot];
+        }
+        if (memo) {
+            trace(`memo MISS ${fileName} had version=${memo.version} current=${version}`);
+        }
+        else {
+            trace(`memo MISS ${fileName} (no entry) current=${version}`);
+        }
+        // Convert in-process using tsserver's warm program. The converter
+        // sees the file exactly as the user wrote it — no snapshot
+        // transformation — and the GDScript output is produced directly
+        // from that AST. `this.X` references (for lifts that land as
+        // script-class members via the user's explicit
+        // `export namespace Foo { ... }` paired with `export class Foo`)
+        // resolve via TypeScript's native namespace + class merging, which
+        // the program already has evaluated.
+        let result;
+        try {
+            result = convertTsToGd({
+                filePath: fileName,
+                rootDir: cfg.tsDir,
+                tsDir: cfg.tsDir,
+                gdDir: cfg.gdDir,
+                projectRoot: cfg.rootDir,
+                sourceMap: true,
+                program,
+            });
+        }
+        catch (err) {
+            log(`convertTsToGd failed for ${fileName}: ${err instanceof Error ? err.message : String(err)}`);
+            return [];
+        }
+        trace(`converter produced ${result.diagnostics.length} diag(s) for ${fileName}`);
+        const converterDiags = cachedToTsDiagnostics(fileName, toCachedDiagnostics(result.diagnostics));
+        trace(`mapped to ${converterDiags.length} ts.Diagnostic(s) (after current-file filter + severity=info drop)`);
+        // Seed the new entry's Godot diagnostics with the last-known set
+        // (possibly from a prior version). Positions are re-anchored against
+        // the CURRENT SourceFile via `cachedToTsDiagnostics`, so no stale
+        // `ts.SourceFile` references leak across versions. During active
+        // typing this keeps the squiggle visible in WebStorm (which only
+        // repaints on primary `getErr` rounds, not on async refresh
+        // follow-ups) — fresh Godot overwrites with precise positions when
+        // it finishes for this version.
+        const priorGodot = lastGodotByFile.get(fileName);
+        const entry = {
+            version,
+            converter: converterDiags,
+            godot: priorGodot ? cachedToTsDiagnostics(fileName, priorGodot) : [],
+        };
+        liveCache.set(fileName, entry);
+        // Persist to the ProjectCache so CLI/watcher can promote the bytes
+        // we just produced without re-converting. Key by bufferHash (not
+        // disk hash) — when user saves, disk == buffer → CLI matches.
+        //
+        // `saveAsync()` returns immediately; the actual cache.json write
+        // runs off the tsserver event loop. The in-memory update
+        // (`updateTsToGd`) has already made the entry visible to this
+        // instance; the disk flush exists purely so other processes (CLI
+        // watcher) can see it.
+        //
+        // Godot validation is chained STRICTLY after the save settles so
+        // it always runs against a fully-persisted on-disk cache state.
+        // `.finally()` ensures a failed save doesn't swallow the Godot
+        // kick-off — the mirror .gd was written synchronously inside
+        // `updateTsToGd`, so Godot has what it needs either way.
+        try {
+            // The plugin no longer wraps the host's getScriptSnapshot, so
+            // the SourceFile text IS the user's source — direct
+            // `sf.getFullText()` match the on-disk hash.
+            const bufferText = sf.getFullText();
+            const relPath = relative(cfg.tsDir, fileName);
+            const gdPath = resolve(cfg.gdDir, relPath.replace(/\.ts$/, '.gd'));
+            cache.updateTsToGd(fileName, gdPath, result.sourceMap ?? '{}', result.diagnostics, { tsContent: bufferText, gdContent: result.code });
+            cache
+                .saveAsync()
+                .catch((err) => {
+                log(`cache saveAsync failed for ${fileName}: ${err instanceof Error ? err.message : String(err)}`);
+            })
+                .finally(() => {
+                maybeStartGodotValidation(fileName, version, result);
+            });
+        }
+        catch (err) {
+            log(`cache persist failed for ${fileName}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return [...entry.converter, ...entry.godot];
+    }
+    function maybeStartGodotValidation(fileName, version, convertResult) {
+        if (cfg.disableGodotLint) {
+            trace(`godot: skip ${fileName} — disableGodotLint is true`);
+            return;
+        }
+        // Skip Godot when the converter itself failed — invalid GD would
+        // just spew parse errors that duplicate what the converter said.
+        if (convertResult.diagnostics.some((d) => d.severity === 'error')) {
+            trace(`godot: skip ${fileName} — converter reported an 'error' severity`);
+            return;
+        }
+        if (!convertResult.code) {
+            trace(`godot: skip ${fileName} — converter produced no output`);
+            return;
+        }
+        const projectRoot = cfg.rootDir;
+        let godotPath;
+        try {
+            godotPath = resolveGodotPath({ godotPath: cfg.godotPath });
+        }
+        catch (err) {
+            trace(`godot: skip ${fileName} — resolveGodotPath threw: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        trace(`godot: start ${fileName} godot=${godotPath} projectRoot=${projectRoot}`);
+        // Abort any prior Godot run for this file — its result would
+        // apply to a stale version.
+        pendingGodot.get(fileName)?.abort();
+        // Reuse the `.gd` bytes the caller just persisted to the
+        // ProjectCache mirror (`<cacheDir>/gd-output/<hash>-<name>.gd`) —
+        // no separate scratch file needed. The mirror is typically under
+        // `os.tmpdir()`, so Godot sees it as outside-project and the
+        // "Class X hides a global script class" false positive is
+        // automatically suppressed by `isDuplicateClassFalsePositive`.
+        const cachedGdPath = cache.getCachedGdPath(fileName);
+        if (!cachedGdPath) {
+            trace(`godot: skip ${fileName} — cache mirror path unavailable`);
+            return;
+        }
+        const ctrl = new AbortController();
+        pendingGodot.set(fileName, ctrl);
+        validateGdFiles({
+            // Pass the source map inline (we just produced it in-process).
+            // With `tsFilePath` set, remapError anchors diagnostics at the
+            // real TS file regardless of where the cache mirror lives.
+            gdFiles: [
+                {
+                    path: cachedGdPath,
+                    sourceMapJson: convertResult.sourceMap,
+                    tsFilePath: fileName,
+                },
+            ],
+            projectRoot,
+            godotPath,
+            // Tell the validator where our cache mirror lives so it can
+            // suppress the "Class X hides a global script class" false
+            // positive Godot emits when it sees both the real .gd and
+            // our throwaway mirror.
+            cacheDir: cfg.cacheDir,
+            // Hand the abort controller's signal to the validator so a
+            // superseded request kills its child Godot process and returns
+            // immediately — no wasted parsing/remapping, no Godot backlog.
+            signal: ctrl.signal,
+        }).then((validate) => {
+            // Settle: drop our pendingGodot entry so the Map doesn't
+            // accumulate one slot per file touched over the session.
+            // Only delete if we're still the owner — a superseding
+            // request may have replaced us with a newer controller.
+            if (pendingGodot.get(fileName) === ctrl)
+                pendingGodot.delete(fileName);
+            trace(`godot: result ${fileName} available=${validate.godotAvailable} diagnostics=${validate.diagnostics.length} ` +
+                `aborted=${ctrl.signal.aborted} liveVersion=${liveCache.get(fileName)?.version} requestVersion=${version}`);
+            if (ctrl.signal.aborted)
+                return;
+            // Superseded by a newer version while Godot was running.
+            const current = liveCache.get(fileName);
+            if (!current || current.version !== version)
+                return;
+            // We pass `tsFilePath` into validateGdFiles, so diagnostics
+            // already point at the real TS file — no normalization needed.
+            const normalizedDiags = toCachedDiagnostics(validate.diagnostics);
+            current.godot = cachedToTsDiagnostics(fileName, normalizedDiags);
+            // Also stash the raw `CachedDiagnostic[]` form so the next
+            // version's memo-miss path can seed its `LiveEntry.godot`
+            // from this (re-anchored against the new SourceFile). See
+            // `lastGodotByFile` docs for why this sidesteps WebStorm's
+            // "async refresh ignored" behavior.
+            lastGodotByFile.set(fileName, normalizedDiags);
+            trace(`godot: stored ${current.godot.length} ts.Diagnostic(s) for ${fileName}; nudging tsserver`);
+            // Nudge tsserver to re-query this file so the freshly-arrived
+            // Godot diagnostics show up without waiting for another edit.
+            // `refreshDiagnostics()` isn't in the public LS type — cast.
+            // VS Code honors this; WebStorm's tsserver client does not —
+            // there, users see Godot errors on their next natural `geterr`
+            // (save / focus change / idle timeout).
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const refresh = info.project.refreshDiagnostics;
+                if (typeof refresh === 'function') {
+                    refresh.call(info.project);
+                    trace(`godot: refreshDiagnostics() invoked`);
+                }
+                else {
+                    trace(`godot: refreshDiagnostics NOT available on info.project`);
+                }
+            }
+            catch (err) {
+                trace(`godot: refreshDiagnostics threw: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }, (err) => {
+            // Same settle cleanup as the success path.
+            if (pendingGodot.get(fileName) === ctrl)
+                pendingGodot.delete(fileName);
+            log(`Godot validation failed for ${fileName}: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}`);
+        });
+    }
+    return {
+        getSemanticDiagnostics(fileName) {
+            const live = liveDiagnosticsFor(fileName);
+            if (live.length > 0)
+                return live;
+            return cachedDiagnosticsFor(fileName);
+        },
+    };
+}
+//# sourceMappingURL=lint.js.map

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

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

package/dist/ts-plugin/lru.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Minimal LRU (least-recently-used) cache keyed by string.
+ *
+ * Backed by a plain `Map` — JS Maps iterate in insertion order, so:
+ *   - `get()` bumps the key to "newest" (delete + re-set).
+ *   - `set()` on an existing key does the same; on a new key past
+ *     `max`, the iterator's first key (= oldest) is evicted.
+ *
+ * The optional `onEvict(key, value)` hook fires exactly once per
+ * displaced entry — intended for releasing resources held by the
+ * evicted value (file watchers, subprocesses, …). Not called on
+ * explicit `delete()` or re-`set()` of the same key.
+ *
+ * Deliberately tiny and dependency-free. Used by the ts-plugin to
+ * bound per-session Maps that would otherwise grow for the life of
+ * the tsserver process.
+ */
+export declare class LRU<V> {
+    readonly max: number;
+    private readonly onEvict?;
+    private readonly map;
+    constructor(max: number, onEvict?: (key: string, value: V) => void);
+    get size(): number;
+    has(key: string): boolean;
+    /** Get a value and bump it to most-recently-used. Returns `undefined` if absent. */
+    get(key: string): V | undefined;
+    /**
+     * Store a value and mark it most-recently-used. Evicts the oldest
+     * key when adding a new one would exceed `max` — the eviction hook
+     * (if any) is called with the evicted entry.
+     */
+    set(key: string, value: V): void;
+    /** Remove an entry. Does NOT fire `onEvict` — explicit deletes are caller-managed. */
+    delete(key: string): boolean;
+    /** Empty the cache. Fires `onEvict` for every remaining entry. */
+    clear(): void;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<V>;
+}
+//# sourceMappingURL=lru.d.ts.map

package/dist/ts-plugin/lru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.d.ts","sourceRoot":"","sources":["../../src/ts-plugin/lru.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,GAAG,CAAC,CAAC;IAChB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;gBAEhC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI;IAMlE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,oFAAoF;IACpF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAU/B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAchC,sFAAsF;IACtF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,kEAAkE;IAClE,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;CAG9B"}

package/dist/ts-plugin/lru.js

@@ -0,0 +1,82 @@
+/**
+ * Minimal LRU (least-recently-used) cache keyed by string.
+ *
+ * Backed by a plain `Map` — JS Maps iterate in insertion order, so:
+ *   - `get()` bumps the key to "newest" (delete + re-set).
+ *   - `set()` on an existing key does the same; on a new key past
+ *     `max`, the iterator's first key (= oldest) is evicted.
+ *
+ * The optional `onEvict(key, value)` hook fires exactly once per
+ * displaced entry — intended for releasing resources held by the
+ * evicted value (file watchers, subprocesses, …). Not called on
+ * explicit `delete()` or re-`set()` of the same key.
+ *
+ * Deliberately tiny and dependency-free. Used by the ts-plugin to
+ * bound per-session Maps that would otherwise grow for the life of
+ * the tsserver process.
+ */
+export class LRU {
+    max;
+    onEvict;
+    map = new Map();
+    constructor(max, onEvict) {
+        if (max <= 0)
+            throw new Error(`LRU max must be > 0, got ${max}`);
+        this.max = max;
+        this.onEvict = onEvict;
+    }
+    get size() {
+        return this.map.size;
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    /** Get a value and bump it to most-recently-used. Returns `undefined` if absent. */
+    get(key) {
+        if (!this.map.has(key))
+            return undefined;
+        // `has` guarded the access — value is whatever was stored,
+        // including legitimately-undefined or null. Safe to assert.
+        const v = this.map.get(key);
+        this.map.delete(key);
+        this.map.set(key, v);
+        return v;
+    }
+    /**
+     * Store a value and mark it most-recently-used. Evicts the oldest
+     * key when adding a new one would exceed `max` — the eviction hook
+     * (if any) is called with the evicted entry.
+     */
+    set(key, value) {
+        this.map.delete(key); // no-op if absent
+        this.map.set(key, value);
+        if (this.map.size > this.max) {
+            const iter = this.map.keys().next();
+            if (!iter.done) {
+                const oldestKey = iter.value;
+                const oldestValue = this.map.get(oldestKey);
+                this.map.delete(oldestKey);
+                this.onEvict?.(oldestKey, oldestValue);
+            }
+        }
+    }
+    /** Remove an entry. Does NOT fire `onEvict` — explicit deletes are caller-managed. */
+    delete(key) {
+        return this.map.delete(key);
+    }
+    /** Empty the cache. Fires `onEvict` for every remaining entry. */
+    clear() {
+        if (this.onEvict) {
+            for (const [k, v] of this.map)
+                this.onEvict(k, v);
+        }
+        this.map.clear();
+    }
+    keys() {
+        return this.map.keys();
+    }
+    values() {
+        return this.map.values();
+    }
+}
+//# sourceMappingURL=lru.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lru.js","sourceRoot":"","sources":["../../src/ts-plugin/lru.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,GAAG;IACL,GAAG,CAAS;IACJ,OAAO,CAAmC;IAC1C,GAAG,GAAG,IAAI,GAAG,EAAa,CAAC;IAE5C,YAAY,GAAW,EAAE,OAAyC;QAChE,IAAI,GAAG,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,oFAAoF;IACpF,GAAG,CAAC,GAAW;QACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,2DAA2D;QAC3D,4DAA4D;QAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;gBAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAM,CAAC;gBACjD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC3B,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,kEAAkE;IAClE,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG;gBAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/ts-plugin/navigation.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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 type tsModule from 'typescript';
+type TS = typeof tsModule;
+type LS = tsModule.LanguageService;
+export interface NavigationOverlayDeps {
+    ts: TS;
+    ls: LS;
+    log: (msg: string) => void;
+}
+export interface NavigationOverlay {
+    getDefinitionAndBoundSpan: NonNullable<LS['getDefinitionAndBoundSpan']>;
+    getDefinitionAtPosition: NonNullable<LS['getDefinitionAtPosition']>;
+    getTypeDefinitionAtPosition: NonNullable<LS['getTypeDefinitionAtPosition']>;
+    getImplementationAtPosition: NonNullable<LS['getImplementationAtPosition']>;
+    findReferences: NonNullable<LS['findReferences']>;
+    getReferencesAtPosition: NonNullable<LS['getReferencesAtPosition']>;
+}
+export declare function createNavigationOverlay(deps: NavigationOverlayDeps): NavigationOverlay;
+export {};
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/ts-plugin/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAQvC,KAAK,EAAE,GAAG,OAAO,QAAQ,CAAC;AAC1B,KAAK,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;AAEnC,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,EAAE,CAAC;IACP,EAAE,EAAE,EAAE,CAAC;IACP,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,yBAAyB,EAAE,WAAW,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACxE,uBAAuB,EAAE,WAAW,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACpE,2BAA2B,EAAE,WAAW,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAC5E,2BAA2B,EAAE,WAAW,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAC5E,cAAc,EAAE,WAAW,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAClD,uBAAuB,EAAE,WAAW,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAC;CACrE;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,iBAAiB,CA4anB"}