typescript-to-gdscript 0.1.0

package/dist/sourcemap/index.d.ts

@@ -0,0 +1,59 @@
+import { type RawSourceMap, type MappingItem } from 'source-map';
+export interface Mapping {
+    /** Original source file */
+    source: string;
+    /** Original line (1-based) */
+    originalLine: number;
+    /** Original column (0-based) */
+    originalColumn: number;
+    /** Generated line (1-based) */
+    generatedLine: number;
+    /** Generated column (0-based) */
+    generatedColumn: number;
+    /** Optional name */
+    name?: string;
+}
+export declare class SourceMapper {
+    private generator;
+    private sourceFile;
+    constructor(sourceFile: string, generatedFile: string);
+    addMapping(mapping: Mapping): void;
+    addSourceContent(source: string, content: string): void;
+    toJSON(): RawSourceMap;
+    toString(): string;
+}
+/**
+ * Position in a source file — line is 1-based, column is 0-based.
+ */
+export interface SourcePosition {
+    line: number;
+    column: number;
+    source?: string | null;
+    name?: string | null;
+}
+/**
+ * Reads a source map and provides lookup methods.
+ * Used for verification and for mapping GDScript LSP errors back to TS.
+ */
+export declare class SourceMapReader {
+    private consumer;
+    private constructor();
+    static fromJSON(rawMap: RawSourceMap | string): Promise<SourceMapReader>;
+    /**
+     * Given a position in the generated (GDScript) file, find the original (TS) position.
+     */
+    originalPositionFor(generatedLine: number, generatedColumn: number): SourcePosition;
+    /**
+     * Given a position in the original (TS) file, find the generated (GDScript) position.
+     */
+    generatedPositionFor(source: string, originalLine: number, originalColumn: number): {
+        line: number | null;
+        column: number | null;
+    };
+    /**
+     * Get all mappings as a flat array.
+     */
+    allMappings(): MappingItem[];
+    destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/sourcemap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sourcemap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,OAAO;IACtB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAOrD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAYlC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIvD,MAAM,IAAI,YAAY;IAItB,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAoB;IAEpC,OAAO;WAIM,QAAQ,CACnB,MAAM,EAAE,YAAY,GAAG,MAAM,GAC5B,OAAO,CAAC,eAAe,CAAC;IAS3B;;OAEG;IACH,mBAAmB,CACjB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,GACtB,cAAc;IAajB;;OAEG;IACH,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAQjD;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAM5B,OAAO,IAAI,IAAI;CAGhB"}

package/dist/sourcemap/index.js

@@ -0,0 +1,85 @@
+import { SourceMapGenerator, SourceMapConsumer, } from 'source-map';
+export class SourceMapper {
+    generator;
+    sourceFile;
+    constructor(sourceFile, generatedFile) {
+        this.sourceFile = sourceFile;
+        this.generator = new SourceMapGenerator({
+            file: generatedFile,
+        });
+    }
+    addMapping(mapping) {
+        this.generator.addMapping({
+            source: mapping.source,
+            original: { line: mapping.originalLine, column: mapping.originalColumn },
+            generated: {
+                line: mapping.generatedLine,
+                column: mapping.generatedColumn,
+            },
+            name: mapping.name,
+        });
+    }
+    addSourceContent(source, content) {
+        this.generator.setSourceContent(source, content);
+    }
+    toJSON() {
+        return this.generator.toJSON();
+    }
+    toString() {
+        return this.generator.toString();
+    }
+}
+/**
+ * Reads a source map and provides lookup methods.
+ * Used for verification and for mapping GDScript LSP errors back to TS.
+ */
+export class SourceMapReader {
+    consumer;
+    constructor(consumer) {
+        this.consumer = consumer;
+    }
+    static async fromJSON(rawMap) {
+        const json = typeof rawMap === 'string'
+            ? JSON.parse(rawMap)
+            : rawMap;
+        const consumer = await new SourceMapConsumer(json);
+        return new SourceMapReader(consumer);
+    }
+    /**
+     * Given a position in the generated (GDScript) file, find the original (TS) position.
+     */
+    originalPositionFor(generatedLine, generatedColumn) {
+        const result = this.consumer.originalPositionFor({
+            line: generatedLine,
+            column: generatedColumn,
+        });
+        return {
+            line: result.line,
+            column: result.column,
+            source: result.source,
+            name: result.name,
+        };
+    }
+    /**
+     * Given a position in the original (TS) file, find the generated (GDScript) position.
+     */
+    generatedPositionFor(source, originalLine, originalColumn) {
+        return this.consumer.generatedPositionFor({
+            source,
+            line: originalLine,
+            column: originalColumn,
+        });
+    }
+    /**
+     * Get all mappings as a flat array.
+     */
+    allMappings() {
+        const mappings = [];
+        this.consumer.eachMapping((m) => mappings.push(m));
+        return mappings;
+    }
+    destroy() {
+        this.consumer.destroy();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/sourcemap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sourcemap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAGlB,MAAM,YAAY,CAAC;AAiBpB,MAAM,OAAO,YAAY;IACf,SAAS,CAAqB;IAC9B,UAAU,CAAS;IAE3B,YAAY,UAAkB,EAAE,aAAqB;QACnD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACtC,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE;YACxE,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO,CAAC,aAAa;gBAC3B,MAAM,EAAE,OAAO,CAAC,eAAe;aAChC;YACD,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,MAAc,EAAE,OAAe;QAC9C,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;CACF;AAYD;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAoB;IAEpC,YAAoB,QAA2B;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CACnB,MAA6B;QAE7B,MAAM,IAAI,GACR,OAAO,MAAM,KAAK,QAAQ;YACxB,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAkB;YACtC,CAAC,CAAC,MAAM,CAAC;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,mBAAmB,CACjB,aAAqB,EACrB,eAAuB;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC/C,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,eAAe;SACxB,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAK;YAClB,MAAM,EAAE,MAAM,CAAC,MAAO;YACtB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,oBAAoB,CAClB,MAAc,EACd,YAAoB,EACpB,cAAsB;QAEtB,OAAO,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YACxC,MAAM;YACN,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW;QACT,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;CACF"}

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

@@ -0,0 +1,47 @@
+/**
+ * typescript-to-gdscript language-service plugin — entry point.
+ *
+ * Two responsibilities:
+ *
+ *   1. **Diagnostic surfacing** (`./lint.ts`) — converter + Godot
+ *      errors shown inline as `ts.Diagnostic`s, exactly like
+ *      TypeScript's own errors. Tier 1 reads the persistent
+ *      `ProjectCache`; tier 2 live-converts in tsserver's own
+ *      `Program` and kicks off async Godot validation.
+ *
+ *   2. **Diagnostic suppression** — TypeScript reports a few codes
+ *      as part of the namespace+class merge pattern the typings
+ *      generator emits in `<name>.gd.d.ts` files (TS2434 / TS2435
+ *      "namespace must precede the class", TS2449 "class used before
+ *      its declaration"). These are noise for the user — the
+ *      generated typings are correct — so we filter them
+ *      unconditionally for in-scope `.ts` files.
+ *
+ * The plugin does NOT modify the user's source view (no snapshot
+ * wrapping). All type augmentation comes from the per-script
+ * `<name>.gd.d.ts` files emitted by `tstogd generate-typings` /
+ * `tstogd watch`. Users who want `Foo.X` access for class-level
+ * consts / enums / inner classes write an explicit
+ * `export namespace Foo { ... }` block alongside their
+ * `export class Foo` — TypeScript's native namespace+class merging
+ * gives them `Foo.X` cross-file and `this.X` on instance.
+ *
+ * NOTE: Navigation overlays (go-to-def / find-refs across the
+ * shadow ↔ source boundary) were removed after testing showed
+ * WebStorm handles symbol navigation entirely through its own
+ * native indexer — tsserver never receives `definition` /
+ * `references` from WebStorm — so the overrides had no effect
+ * there. Users relying on shadow-class navigation should rely on
+ * the typings generator's `@see` JSDoc + TS type aliases instead.
+ */
+import type tsModule from 'typescript';
+type TS = typeof tsModule;
+type LS = tsModule.LanguageService;
+interface PluginInit {
+    typescript: TS;
+}
+declare function init({ typescript: ts }: PluginInit): {
+    create: (info: tsModule.server.PluginCreateInfo) => LS;
+};
+export default init;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts-plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAOvC,KAAK,EAAE,GAAG,OAAO,QAAQ,CAAC;AAC1B,KAAK,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;AAEnC,UAAU,UAAU;IAClB,UAAU,EAAE,EAAE,CAAC;CAChB;AAYD,iBAAS,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,UAAU;mBACpB,QAAQ,CAAC,MAAM,CAAC,gBAAgB,KAAG,EAAE;EAuM5D;AAED,eAAe,IAAI,CAAC"}

package/dist/ts-plugin/index.js

@@ -0,0 +1,227 @@
+/**
+ * typescript-to-gdscript language-service plugin — entry point.
+ *
+ * Two responsibilities:
+ *
+ *   1. **Diagnostic surfacing** (`./lint.ts`) — converter + Godot
+ *      errors shown inline as `ts.Diagnostic`s, exactly like
+ *      TypeScript's own errors. Tier 1 reads the persistent
+ *      `ProjectCache`; tier 2 live-converts in tsserver's own
+ *      `Program` and kicks off async Godot validation.
+ *
+ *   2. **Diagnostic suppression** — TypeScript reports a few codes
+ *      as part of the namespace+class merge pattern the typings
+ *      generator emits in `<name>.gd.d.ts` files (TS2434 / TS2435
+ *      "namespace must precede the class", TS2449 "class used before
+ *      its declaration"). These are noise for the user — the
+ *      generated typings are correct — so we filter them
+ *      unconditionally for in-scope `.ts` files.
+ *
+ * The plugin does NOT modify the user's source view (no snapshot
+ * wrapping). All type augmentation comes from the per-script
+ * `<name>.gd.d.ts` files emitted by `tstogd generate-typings` /
+ * `tstogd watch`. Users who want `Foo.X` access for class-level
+ * consts / enums / inner classes write an explicit
+ * `export namespace Foo { ... }` block alongside their
+ * `export class Foo` — TypeScript's native namespace+class merging
+ * gives them `Foo.X` cross-file and `this.X` on instance.
+ *
+ * NOTE: Navigation overlays (go-to-def / find-refs across the
+ * shadow ↔ source boundary) were removed after testing showed
+ * WebStorm handles symbol navigation entirely through its own
+ * native indexer — tsserver never receives `definition` /
+ * `references` from WebStorm — so the overrides had no effect
+ * there. Users relying on shadow-class navigation should rely on
+ * the typings generator's `@see` JSDoc + TS type aliases instead.
+ */
+import { appendFileSync, mkdirSync } from 'fs';
+import { dirname, relative, resolve } from 'path';
+import { ProjectCache } from "../cache/index.js";
+import { resolveConfig } from "../config/index.js";
+import { createLintOverlay } from "./lint.js";
+/**
+ * Diagnostic codes emitted by the namespace+class merge pattern in
+ * the generated `.gd.d.ts` files that never correspond to real user
+ * mistakes. Always filtered for in-scope files.
+ *   - TS2434 / TS2435 — "namespace must precede the class".
+ *   - TS2449 — "class used before its declaration", when the
+ *               typings module references the script class.
+ */
+const ALWAYS_FILTERED_CODES = new Set([2434, 2435, 2449]);
+function init({ typescript: ts }) {
+    function create(info) {
+        const ls = info.languageService;
+        const logger = info.project.projectService.logger;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const pluginConfig = (info.config ?? {});
+        /**
+         * Enable via `{"name": "typescript-to-gdscript/ts-plugin", "debug": true}`
+         * in `compilerOptions.plugins`. When on, every short-circuit
+         * branch and Godot step of the lint overlay emits a trace line
+         * to tsserver's logger. Restart the TS service after toggling.
+         */
+        const debugEnabled = pluginConfig.debug === true;
+        /**
+         * `"debugLog": "C:/path/to/tstogd-plugin.log"` mirrors plugin
+         * trace lines into a dedicated file (no need to filter through
+         * the noisy tsserver log). Both the configured log path AND
+         * tsserver's own logger receive the lines.
+         */
+        const debugLogPath = typeof pluginConfig.debugLog === 'string' &&
+            pluginConfig.debugLog.length > 0
+            ? pluginConfig.debugLog
+            : undefined;
+        if (debugLogPath) {
+            try {
+                mkdirSync(dirname(debugLogPath), { recursive: true });
+            }
+            catch {
+                /* best-effort — appendFileSync below will surface a real failure */
+            }
+        }
+        const writeDebug = (line) => {
+            if (!debugLogPath)
+                return;
+            try {
+                appendFileSync(debugLogPath, line + '\n', 'utf-8');
+            }
+            catch {
+                /* swallow — losing a debug line shouldn't break the editor */
+            }
+        };
+        const log = (msg) => {
+            const formatted = `[tstogd-plugin] ${msg}`;
+            logger.info(formatted);
+            writeDebug(formatted);
+        };
+        const trace = debugEnabled || debugLogPath
+            ? (msg) => {
+                const formatted = `[tstogd-plugin] TRACE ${msg}`;
+                if (debugEnabled)
+                    logger.info(formatted);
+                writeDebug(formatted);
+            }
+            : (_) => { };
+        log(`plugin loaded (debug=${debugEnabled} debugLog=${debugLogPath ?? 'off'})`);
+        // ── One-time project setup ──────────────────────────────
+        //
+        // tsserver invokes `create()` exactly once per configured project
+        // — i.e. once per tsconfig.json that mentions us in
+        // `compilerOptions.plugins`. Each tsconfig lives under at most
+        // one `tstogd.json`, so we resolve the config ONCE here, open
+        // ONE `ProjectCache` in `watch: true` mode, and reuse both for
+        // every file request.
+        //
+        // If resolution fails (no `tstogd.json` in the tree, or the
+        // cache dir can't be opened), the plugin still proxies the
+        // inner LanguageService unchanged — it just contributes no
+        // diagnostics.
+        const projectDir = info.project.getCurrentDirectory();
+        let cfg = null;
+        let cache = null;
+        try {
+            cfg = resolveConfig({ configDir: projectDir });
+            /**
+             * When set in the plugin's `compilerOptions.plugins` entry,
+             * this overrides `disableGodotLint` from `tstogd.json` for
+             * THIS editor session only. Useful when a developer wants to
+             * silence the async Godot pass in their IDE without changing
+             * the project-wide config the CLI/watcher still honor. Pass
+             * `false` to force-enable Godot even if the project config
+             * disables it.
+             */
+            if (typeof pluginConfig.disableGodotLint === 'boolean') {
+                cfg = { ...cfg, disableGodotLint: pluginConfig.disableGodotLint };
+            }
+            cache = new ProjectCache(cfg.cacheDir, { watch: true });
+            log(`resolved config for ${projectDir}: tsDir=${cfg.tsDir} gdDir=${cfg.gdDir} cacheDir=${cfg.cacheDir}`);
+        }
+        catch (err) {
+            log(`plugin disabled (resolveConfig / ProjectCache failed for ${projectDir}): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        /**
+         * Accept a file for diagnostic filtering iff it's a plain `.ts`
+         * (not `.d.ts`) AND lives under `cfg.tsDir`. Pure O(1). Files
+         * outside scope pass through unchanged.
+         *
+         * When `cfg` is null (config resolution failed), nothing is in
+         * scope — the plugin degrades to a transparent pass-through.
+         */
+        function isInScope(fileName) {
+            if (!cfg)
+                return false;
+            if (!fileName.endsWith('.ts') || fileName.endsWith('.d.ts'))
+                return false;
+            const rel = relative(cfg.tsDir, fileName);
+            if (!rel ||
+                rel.startsWith('..') ||
+                resolve(cfg.tsDir, rel) !== resolve(fileName)) {
+                return false;
+            }
+            return true;
+        }
+        // ── Proxy scaffolding ───────────────────────────────────
+        //
+        // Canonical tsserver-plugin pattern: copy every method from the
+        // inner LS onto a fresh object, wrapping each in a closure that
+        // re-binds `this = ls`. This makes the proxy a drop-in
+        // replacement for `ls` (every method works) while giving us a
+        // clean surface to override the specific ones we care about
+        // below.
+        const proxy = Object.create(null);
+        for (const k of Object.keys(ls)) {
+            const x = ls[k];
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            proxy[k] = (...args) => x.apply(ls, args);
+        }
+        // ── Diagnostic filter ────────────────────────────────────
+        //
+        // Drops `ALWAYS_FILTERED_CODES` for in-scope files. These codes
+        // come from the namespace+class merge pattern the typings
+        // generator emits and are correct-but-noisy; the user can't act
+        // on them.
+        function filterAugmentationDiagnostics(fileName, diags) {
+            if (!isInScope(fileName))
+                return [...diags];
+            const filtered = [];
+            for (const d of diags) {
+                if (ALWAYS_FILTERED_CODES.has(d.code)) {
+                    trace(`filter ${fileName}: dropping TS${d.code} (always-filtered)`);
+                    continue;
+                }
+                filtered.push(d);
+            }
+            return filtered;
+        }
+        proxy.getSyntacticDiagnostics = (fileName) => {
+            const base = ls.getSyntacticDiagnostics(fileName);
+            return filterAugmentationDiagnostics(fileName, base);
+        };
+        proxy.getSuggestionDiagnostics = (fileName) => {
+            const base = ls.getSuggestionDiagnostics(fileName);
+            return filterAugmentationDiagnostics(fileName, base);
+        };
+        // ── Lint overlay (tier 1 + tier 2 diagnostics) ──────────
+        //
+        // Only installed when config resolution succeeded — without
+        // `cfg` and `cache` we can't convert or read cached diagnostics,
+        // so we just let the (filtered) base LS diagnostics through.
+        if (cfg && cache) {
+            const lint = createLintOverlay({ ts, info, ls, cfg, cache, log, trace });
+            proxy.getSemanticDiagnostics = (fileName) => {
+                const base = filterAugmentationDiagnostics(fileName, ls.getSemanticDiagnostics(fileName));
+                const extra = lint.getSemanticDiagnostics(fileName);
+                return extra.length > 0 ? [...base, ...extra] : base;
+            };
+        }
+        else {
+            proxy.getSemanticDiagnostics = (fileName) => {
+                return filterAugmentationDiagnostics(fileName, ls.getSemanticDiagnostics(fileName));
+            };
+        }
+        return proxy;
+    }
+    return { create };
+}
+export default init;
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * 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 type tsModule from 'typescript';
+import { ProjectCache } from '../cache/index.ts';
+import { type ResolvedConfig } from '../config/index.ts';
+type TS = typeof tsModule;
+type LS = tsModule.LanguageService;
+export interface LintOverlayDeps {
+    ts: TS;
+    info: tsModule.server.PluginCreateInfo;
+    ls: LS;
+    cfg: ResolvedConfig;
+    cache: ProjectCache;
+    log: (msg: string) => void;
+    trace: (msg: string) => void;
+}
+export interface LintOverlay {
+    /**
+     * Append tier-1/tier-2 diagnostics to whatever the inner LS produced.
+     * Caller is responsible for invoking `ls.getSemanticDiagnostics()`
+     * first — this helper only contributes the extra entries.
+     */
+    getSemanticDiagnostics(fileName: string): tsModule.Diagnostic[];
+}
+export declare function createLintOverlay(deps: LintOverlayDeps): LintOverlay;
+export {};
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/ts-plugin/lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC,OAAO,EACL,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAM3E,KAAK,EAAE,GAAG,OAAO,QAAQ,CAAC;AAC1B,KAAK,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;AAKnC,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC;IACvC,EAAE,EAAE,EAAE,CAAC;IACP,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;CACjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAucpE"}