@backtickjs/language-service 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jean-François Bisson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @backtickjs/language-service
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Backtick](https://backtickjs.com)'s diagnostics and completions, layered on top of TypeScript's language service.
+
+## Internal
+
+You don't install this package directly. It is used by [`@backtickjs/typescript-plugin`](https://github.com/backtickjs/backtick/tree/main/packages/typescript-plugin), which the VS Code extension bundles, and by [`@backtickjs/tsc`](https://github.com/backtickjs/backtick/tree/main/packages/tsc) (`backtick-tsc`).
+
+## What it does
+
+`decorateLanguageService` wraps a TypeScript language service. It adds Backtick's own compiler diagnostics, collected by [`@backtickjs/language-plugin`](https://github.com/backtickjs/backtick/tree/main/packages/language-plugin), to TypeScript's semantic diagnostics. It also cleans up what TypeScript reports about script code: the virtual code prefixes script identifiers with `__cs_`, and diagnostics, quick info and completions are rewritten to show the names as you wrote them. `backtick-tsc` uses `getBacktickDiagnostics` and `unmangleDiagnostic` to report the same diagnostics from the command line.
+
+## Related
+
+- [`@backtickjs/language-plugin`](https://github.com/backtickjs/backtick/tree/main/packages/language-plugin)
+- [Backtick for VS Code](https://marketplace.visualstudio.com/items?itemName=backtickjs.backtick-vscode)
+- [Documentation](https://backtickjs.com/docs)
+
+## License
+
+MIT

package/dist/decorateLanguageService.d.ts

@@ -0,0 +1,3 @@
+import type { Language } from "@volar/language-core";
+import type ts from "typescript";
+export declare function decorateLanguageService(inner: ts.LanguageService, language: Language<string>): ts.LanguageService;

package/dist/decorateLanguageService.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decorateLanguageService = decorateLanguageService;
+const compiler_1 = require("@backtickjs/compiler");
+const getBacktickDiagnostics_js_1 = require("./getBacktickDiagnostics.js");
+const unmangleCompletions_js_1 = require("./unmangleCompletions.js");
+const unmangleDiagnostics_js_1 = require("./unmangleDiagnostics.js");
+const unmangleQuickInfo_js_1 = require("./unmangleQuickInfo.js");
+function decorateLanguageService(inner, language) {
+    const overrides = {
+        getSemanticDiagnostics: (fileName) => [
+            ...inner.getSemanticDiagnostics(fileName).map(unmangleDiagnostics_js_1.unmangleDiagnostic),
+            ...(0, getBacktickDiagnostics_js_1.getBacktickDiagnostics)(language, inner.getProgram()?.getSourceFile(fileName), fileName),
+        ],
+        getSyntacticDiagnostics: (fileName) => inner.getSyntacticDiagnostics(fileName).map(unmangleDiagnostics_js_1.unmangleDiagnostic),
+        getSuggestionDiagnostics: (fileName) => inner.getSuggestionDiagnostics(fileName).map(unmangleDiagnostics_js_1.unmangleDiagnostic),
+        getQuickInfoAtPosition: (fileName, position) => {
+            const quickInfo = inner.getQuickInfoAtPosition(fileName, position);
+            return quickInfo && (0, unmangleQuickInfo_js_1.unmangleQuickInfo)(quickInfo);
+        },
+        getCompletionsAtPosition: (fileName, position, options, settings) => {
+            const completions = inner.getCompletionsAtPosition(fileName, position, options, settings);
+            return completions && (0, unmangleCompletions_js_1.unmangleCompletionInfo)(completions);
+        },
+        getCompletionEntryDetails: (fileName, position, name, ...rest) => {
+            // The editor echoes back the unmangled `name` we returned above, but the
+            // virtual code is keyed by the mangled name; look that up first, falling
+            // back to the name as given for genuine (never-mangled) host symbols.
+            const details = inner.getCompletionEntryDetails(fileName, position, (0, compiler_1.mangle)(name), ...rest) ?? inner.getCompletionEntryDetails(fileName, position, name, ...rest);
+            return details && (0, unmangleCompletions_js_1.unmangleCompletionEntryDetails)(details);
+        },
+    };
+    return new Proxy(inner, {
+        get(target, property, receiver) {
+            return Object.hasOwn(overrides, property)
+                ? overrides[property]
+                : Reflect.get(target, property, receiver);
+        },
+    });
+}
+//# sourceMappingURL=decorateLanguageService.js.map

package/dist/decorateLanguageService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorateLanguageService.js","sourceRoot":"","sources":["../src/decorateLanguageService.ts"],"names":[],"mappings":";;AAWA,0DAyDC;AApED,mDAA8C;AAG9C,2EAAqE;AACrE,qEAGkC;AAClC,qEAA8D;AAC9D,iEAA2D;AAE3D,SAAgB,uBAAuB,CACrC,KAAyB,EACzB,QAA0B;IAE1B,MAAM,SAAS,GAAgC;QAC7C,sBAAsB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpC,GAAG,KAAK,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,2CAAkB,CAAC;YACjE,GAAG,IAAA,kDAAsB,EACvB,QAAQ,EACR,KAAK,CAAC,UAAU,EAAE,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC3C,QAAQ,CACT;SACF;QAED,uBAAuB,EAAE,CAAC,QAAQ,EAAE,EAAE,CACpC,KAAK,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,2CAAkB,CAAC;QAEjE,wBAAwB,EAAE,CAAC,QAAQ,EAAE,EAAE,CACrC,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,2CAAkB,CAAC;QAElE,sBAAsB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE;YAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACnE,OAAO,SAAS,IAAI,IAAA,wCAAiB,EAAC,SAAS,CAAC,CAAC;QACnD,CAAC;QAED,wBAAwB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;YAClE,MAAM,WAAW,GAAG,KAAK,CAAC,wBAAwB,CAChD,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,CACT,CAAC;YACF,OAAO,WAAW,IAAI,IAAA,+CAAsB,EAAC,WAAW,CAAC,CAAC;QAC5D,CAAC;QAED,yBAAyB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE;YAC/D,yEAAyE;YACzE,yEAAyE;YACzE,sEAAsE;YACtE,MAAM,OAAO,GACX,KAAK,CAAC,yBAAyB,CAC7B,QAAQ,EACR,QAAQ,EACR,IAAA,iBAAM,EAAC,IAAI,CAAC,EACZ,GAAG,IAAI,CACR,IAAI,KAAK,CAAC,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;YAC1E,OAAO,OAAO,IAAI,IAAA,uDAA8B,EAAC,OAAO,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE;QACtB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;gBACvC,CAAC,CAAC,SAAS,CAAC,QAAoC,CAAC;gBACjD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/getBacktickDiagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { Language } from "@volar/language-core";
+import type ts from "typescript";
+export declare function getBacktickDiagnostics(language: Language<string> | undefined, file: ts.SourceFile | undefined, fileName: string): ts.Diagnostic[];

package/dist/getBacktickDiagnostics.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBacktickDiagnostics = getBacktickDiagnostics;
+const language_plugin_1 = require("@backtickjs/language-plugin");
+// Surfaces Backtick's own compiler diagnostics (e.g. unsupported syntax inside
+// a `cs` client script) — the errors Backtick itself produces, which TypeScript
+// knows nothing about. TypeScript's diagnostics already flow through the
+// compiled embedded code; these are additive.
+//
+// The diagnostics are stored on the root virtual code in source coordinates,
+// and `file`'s text mirrors the source 1:1, so the offsets map straight through
+// with no translation. Works against any consumer that can supply the
+// `Language` and the file's `SourceFile` — a language service (editor) or a
+// program (command-line `tsc`).
+function getBacktickDiagnostics(language, file, fileName) {
+    const root = language?.scripts.get(fileName)?.generated?.root;
+    if (!(root instanceof language_plugin_1.BacktickVirtualCode)) {
+        return [];
+    }
+    return root.diagnostics.map((diagnostic) => ({
+        file,
+        start: diagnostic.range.start,
+        length: diagnostic.range.end - diagnostic.range.start,
+        messageText: diagnostic.message,
+        category: diagnostic.category,
+        code: diagnostic.code,
+        source: "backtick",
+    }));
+}
+//# sourceMappingURL=getBacktickDiagnostics.js.map

package/dist/getBacktickDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBacktickDiagnostics.js","sourceRoot":"","sources":["../src/getBacktickDiagnostics.ts"],"names":[],"mappings":";;AAcA,wDAmBC;AAjCD,iEAAkE;AAIlE,+EAA+E;AAC/E,gFAAgF;AAChF,yEAAyE;AACzE,8CAA8C;AAC9C,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,sEAAsE;AACtE,4EAA4E;AAC5E,gCAAgC;AAChC,SAAgB,sBAAsB,CACpC,QAAsC,EACtC,IAA+B,EAC/B,QAAgB;IAEhB,MAAM,IAAI,GAAG,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC;IAC9D,IAAI,CAAC,CAAC,IAAI,YAAY,qCAAmB,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI;QACJ,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK;QAC7B,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK;QACrD,WAAW,EAAE,UAAU,CAAC,OAAO;QAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { decorateLanguageService } from "./decorateLanguageService.js";
+export { getBacktickDiagnostics } from "./getBacktickDiagnostics.js";
+export { unmangleDiagnostic } from "./unmangleDiagnostics.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unmangleDiagnostic = exports.getBacktickDiagnostics = exports.decorateLanguageService = void 0;
+var decorateLanguageService_js_1 = require("./decorateLanguageService.js");
+Object.defineProperty(exports, "decorateLanguageService", { enumerable: true, get: function () { return decorateLanguageService_js_1.decorateLanguageService; } });
+var getBacktickDiagnostics_js_1 = require("./getBacktickDiagnostics.js");
+Object.defineProperty(exports, "getBacktickDiagnostics", { enumerable: true, get: function () { return getBacktickDiagnostics_js_1.getBacktickDiagnostics; } });
+var unmangleDiagnostics_js_1 = require("./unmangleDiagnostics.js");
+Object.defineProperty(exports, "unmangleDiagnostic", { enumerable: true, get: function () { return unmangleDiagnostics_js_1.unmangleDiagnostic; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAChC,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAC/B,mEAA8D;AAArD,4HAAA,kBAAkB,OAAA"}

package/dist/unmangleCompletions.d.ts

@@ -0,0 +1,3 @@
+import type ts from "typescript";
+export declare function unmangleCompletionInfo<T extends ts.CompletionInfo>(completions: T): T;
+export declare function unmangleCompletionEntryDetails(details: ts.CompletionEntryDetails): ts.CompletionEntryDetails;

package/dist/unmangleCompletions.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unmangleCompletionInfo = unmangleCompletionInfo;
+exports.unmangleCompletionEntryDetails = unmangleCompletionEntryDetails;
+const compiler_1 = require("@backtickjs/compiler");
+const unmangleDisplayPart_1 = require("./unmangleDisplayPart");
+function unmangleCompletionInfo(completions) {
+    return {
+        ...completions,
+        entries: completions.entries.map((entry) => ({
+            ...entry,
+            name: (0, compiler_1.unmangle)(entry.name),
+            insertText: entry.insertText && (0, compiler_1.unmangle)(entry.insertText),
+        })),
+    };
+}
+function unmangleCompletionEntryDetails(details) {
+    return {
+        ...details,
+        name: (0, compiler_1.unmangle)(details.name),
+        displayParts: details.displayParts.map(unmangleDisplayPart_1.unmangleDisplayPart),
+        documentation: details.documentation?.map(unmangleDisplayPart_1.unmangleDisplayPart),
+    };
+}
+//# sourceMappingURL=unmangleCompletions.js.map

package/dist/unmangleCompletions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmangleCompletions.js","sourceRoot":"","sources":["../src/unmangleCompletions.ts"],"names":[],"mappings":";;AAIA,wDAWC;AAED,wEASC;AA1BD,mDAAgD;AAEhD,+DAA4D;AAE5D,SAAgB,sBAAsB,CACpC,WAAc;IAEd,OAAO;QACL,GAAG,WAAW;QACd,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3C,GAAG,KAAK;YACR,IAAI,EAAE,IAAA,mBAAQ,EAAC,KAAK,CAAC,IAAI,CAAC;YAC1B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAA,mBAAQ,EAAC,KAAK,CAAC,UAAU,CAAC;SAC3D,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAgB,8BAA8B,CAC5C,OAAkC;IAElC,OAAO;QACL,GAAG,OAAO;QACV,IAAI,EAAE,IAAA,mBAAQ,EAAC,OAAO,CAAC,IAAI,CAAC;QAC5B,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,yCAAmB,CAAC;QAC3D,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,yCAAmB,CAAC;KAC/D,CAAC;AACJ,CAAC"}

package/dist/unmangleDiagnostics.d.ts

@@ -0,0 +1,2 @@
+import type ts from "typescript";
+export declare function unmangleDiagnostic<T extends ts.Diagnostic>(diagnostic: T): T;

package/dist/unmangleDiagnostics.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unmangleDiagnostic = unmangleDiagnostic;
+const compiler_1 = require("@backtickjs/compiler");
+function unmangleDiagnostic(diagnostic) {
+    return {
+        ...diagnostic,
+        messageText: unmangleMessageText(diagnostic.messageText),
+        relatedInformation: diagnostic.relatedInformation?.map((info) => ({
+            ...info,
+            messageText: unmangleMessageText(info.messageText),
+        })),
+    };
+}
+function unmangleMessageText(messageText) {
+    if (typeof messageText === "string") {
+        return (0, compiler_1.unmangle)(messageText);
+    }
+    return {
+        ...messageText,
+        messageText: (0, compiler_1.unmangle)(messageText.messageText),
+        next: messageText.next?.map((chain) => unmangleMessageText(chain)),
+    };
+}
+//# sourceMappingURL=unmangleDiagnostics.js.map

package/dist/unmangleDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmangleDiagnostics.js","sourceRoot":"","sources":["../src/unmangleDiagnostics.ts"],"names":[],"mappings":";;AAGA,gDASC;AAZD,mDAAgD;AAGhD,SAAgB,kBAAkB,CAA0B,UAAa;IACvE,OAAO;QACL,GAAG,UAAU;QACb,WAAW,EAAE,mBAAmB,CAAC,UAAU,CAAC,WAAW,CAAC;QACxD,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChE,GAAG,IAAI;YACP,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC;SACnD,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAA+C;IAE/C,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,IAAA,mBAAQ,EAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO;QACL,GAAG,WAAW;QACd,WAAW,EAAE,IAAA,mBAAQ,EAAC,WAAW,CAAC,WAAW,CAAC;QAC9C,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,CACzB,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAA8B,CACnE;KACF,CAAC;AACJ,CAAC"}

package/dist/unmangleDisplayPart.d.ts

@@ -0,0 +1,2 @@
+import type ts from "typescript";
+export declare function unmangleDisplayPart(part: ts.SymbolDisplayPart): ts.SymbolDisplayPart;

package/dist/unmangleDisplayPart.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unmangleDisplayPart = unmangleDisplayPart;
+const compiler_1 = require("@backtickjs/compiler");
+function unmangleDisplayPart(part) {
+    return { ...part, text: (0, compiler_1.unmangle)(part.text) };
+}
+//# sourceMappingURL=unmangleDisplayPart.js.map

package/dist/unmangleDisplayPart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmangleDisplayPart.js","sourceRoot":"","sources":["../src/unmangleDisplayPart.ts"],"names":[],"mappings":";;AAGA,kDAIC;AAPD,mDAAgD;AAGhD,SAAgB,mBAAmB,CACjC,IAA0B;IAE1B,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAA,mBAAQ,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/unmangleQuickInfo.d.ts

@@ -0,0 +1,2 @@
+import type ts from "typescript";
+export declare function unmangleQuickInfo(quickInfo: ts.QuickInfo): ts.QuickInfo;

package/dist/unmangleQuickInfo.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unmangleQuickInfo = unmangleQuickInfo;
+const unmangleDisplayPart_1 = require("./unmangleDisplayPart");
+function unmangleQuickInfo(quickInfo) {
+    return {
+        ...quickInfo,
+        displayParts: quickInfo.displayParts?.map(unmangleDisplayPart_1.unmangleDisplayPart),
+        documentation: quickInfo.documentation?.map(unmangleDisplayPart_1.unmangleDisplayPart),
+    };
+}
+//# sourceMappingURL=unmangleQuickInfo.js.map

package/dist/unmangleQuickInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unmangleQuickInfo.js","sourceRoot":"","sources":["../src/unmangleQuickInfo.ts"],"names":[],"mappings":";;AAGA,8CAMC;AARD,+DAA4D;AAE5D,SAAgB,iBAAiB,CAAC,SAAuB;IACvD,OAAO;QACL,GAAG,SAAS;QACZ,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,yCAAmB,CAAC;QAC9D,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,yCAAmB,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@backtickjs/language-service",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Internal: Backtick's diagnostics and completions, layered on TypeScript's language service",
+  "keywords": [
+    "backtick",
+    "react-native",
+    "server-driven-ui",
+    "server-components",
+    "typescript",
+    "language-service",
+    "language-tools"
+  ],
+  "homepage": "https://backtickjs.com",
+  "bugs": {
+    "url": "https://github.com/backtickjs/backtick/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/backtickjs/backtick.git",
+    "directory": "packages/language-service"
+  },
+  "license": "MIT",
+  "author": "Jean-François Bisson <jf@backtickjs.com>",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/._cache",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@volar/language-core": "^2.4.28",
+    "@backtickjs/compiler": "0.1.0",
+    "@backtickjs/language-plugin": "0.1.0"
+  },
+  "devDependencies": {
+    "prettier": "^3.6.2",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "format": "prettier --write --ignore-unknown .",
+    "format:check": "prettier --check --ignore-unknown .",
+    "clean": "rm -rf node_modules dist .turbo"
+  }
 }

package/src/decorateLanguageService.ts

@@ -0,0 +1,69 @@
+import { mangle } from "@backtickjs/compiler";
+import type { Language } from "@volar/language-core";
+import type ts from "typescript";
+import { getBacktickDiagnostics } from "./getBacktickDiagnostics.js";
+import {
+  unmangleCompletionEntryDetails,
+  unmangleCompletionInfo,
+} from "./unmangleCompletions.js";
+import { unmangleDiagnostic } from "./unmangleDiagnostics.js";
+import { unmangleQuickInfo } from "./unmangleQuickInfo.js";
+
+export function decorateLanguageService(
+  inner: ts.LanguageService,
+  language: Language<string>,
+): ts.LanguageService {
+  const overrides: Partial<ts.LanguageService> = {
+    getSemanticDiagnostics: (fileName) => [
+      ...inner.getSemanticDiagnostics(fileName).map(unmangleDiagnostic),
+      ...getBacktickDiagnostics(
+        language,
+        inner.getProgram()?.getSourceFile(fileName),
+        fileName,
+      ),
+    ],
+
+    getSyntacticDiagnostics: (fileName) =>
+      inner.getSyntacticDiagnostics(fileName).map(unmangleDiagnostic),
+
+    getSuggestionDiagnostics: (fileName) =>
+      inner.getSuggestionDiagnostics(fileName).map(unmangleDiagnostic),
+
+    getQuickInfoAtPosition: (fileName, position) => {
+      const quickInfo = inner.getQuickInfoAtPosition(fileName, position);
+      return quickInfo && unmangleQuickInfo(quickInfo);
+    },
+
+    getCompletionsAtPosition: (fileName, position, options, settings) => {
+      const completions = inner.getCompletionsAtPosition(
+        fileName,
+        position,
+        options,
+        settings,
+      );
+      return completions && unmangleCompletionInfo(completions);
+    },
+
+    getCompletionEntryDetails: (fileName, position, name, ...rest) => {
+      // The editor echoes back the unmangled `name` we returned above, but the
+      // virtual code is keyed by the mangled name; look that up first, falling
+      // back to the name as given for genuine (never-mangled) host symbols.
+      const details =
+        inner.getCompletionEntryDetails(
+          fileName,
+          position,
+          mangle(name),
+          ...rest,
+        ) ?? inner.getCompletionEntryDetails(fileName, position, name, ...rest);
+      return details && unmangleCompletionEntryDetails(details);
+    },
+  };
+
+  return new Proxy(inner, {
+    get(target, property, receiver) {
+      return Object.hasOwn(overrides, property)
+        ? overrides[property as keyof ts.LanguageService]
+        : Reflect.get(target, property, receiver);
+    },
+  });
+}

package/src/getBacktickDiagnostics.ts

@@ -0,0 +1,34 @@
+import { BacktickVirtualCode } from "@backtickjs/language-plugin";
+import type { Language } from "@volar/language-core";
+import type ts from "typescript";
+
+// Surfaces Backtick's own compiler diagnostics (e.g. unsupported syntax inside
+// a `cs` client script) — the errors Backtick itself produces, which TypeScript
+// knows nothing about. TypeScript's diagnostics already flow through the
+// compiled embedded code; these are additive.
+//
+// The diagnostics are stored on the root virtual code in source coordinates,
+// and `file`'s text mirrors the source 1:1, so the offsets map straight through
+// with no translation. Works against any consumer that can supply the
+// `Language` and the file's `SourceFile` — a language service (editor) or a
+// program (command-line `tsc`).
+export function getBacktickDiagnostics(
+  language: Language<string> | undefined,
+  file: ts.SourceFile | undefined,
+  fileName: string,
+): ts.Diagnostic[] {
+  const root = language?.scripts.get(fileName)?.generated?.root;
+  if (!(root instanceof BacktickVirtualCode)) {
+    return [];
+  }
+
+  return root.diagnostics.map((diagnostic) => ({
+    file,
+    start: diagnostic.range.start,
+    length: diagnostic.range.end - diagnostic.range.start,
+    messageText: diagnostic.message,
+    category: diagnostic.category,
+    code: diagnostic.code,
+    source: "backtick",
+  }));
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { decorateLanguageService } from "./decorateLanguageService.js";
+export { getBacktickDiagnostics } from "./getBacktickDiagnostics.js";
+export { unmangleDiagnostic } from "./unmangleDiagnostics.js";

package/src/unmangleCompletions.ts

@@ -0,0 +1,27 @@
+import { unmangle } from "@backtickjs/compiler";
+import type ts from "typescript";
+import { unmangleDisplayPart } from "./unmangleDisplayPart";
+
+export function unmangleCompletionInfo<T extends ts.CompletionInfo>(
+  completions: T,
+): T {
+  return {
+    ...completions,
+    entries: completions.entries.map((entry) => ({
+      ...entry,
+      name: unmangle(entry.name),
+      insertText: entry.insertText && unmangle(entry.insertText),
+    })),
+  };
+}
+
+export function unmangleCompletionEntryDetails(
+  details: ts.CompletionEntryDetails,
+): ts.CompletionEntryDetails {
+  return {
+    ...details,
+    name: unmangle(details.name),
+    displayParts: details.displayParts.map(unmangleDisplayPart),
+    documentation: details.documentation?.map(unmangleDisplayPart),
+  };
+}

package/src/unmangleDiagnostics.ts

@@ -0,0 +1,28 @@
+import { unmangle } from "@backtickjs/compiler";
+import type ts from "typescript";
+
+export function unmangleDiagnostic<T extends ts.Diagnostic>(diagnostic: T): T {
+  return {
+    ...diagnostic,
+    messageText: unmangleMessageText(diagnostic.messageText),
+    relatedInformation: diagnostic.relatedInformation?.map((info) => ({
+      ...info,
+      messageText: unmangleMessageText(info.messageText),
+    })),
+  };
+}
+
+function unmangleMessageText(
+  messageText: string | ts.DiagnosticMessageChain,
+): string | ts.DiagnosticMessageChain {
+  if (typeof messageText === "string") {
+    return unmangle(messageText);
+  }
+  return {
+    ...messageText,
+    messageText: unmangle(messageText.messageText),
+    next: messageText.next?.map(
+      (chain) => unmangleMessageText(chain) as ts.DiagnosticMessageChain,
+    ),
+  };
+}

package/src/unmangleDisplayPart.ts

@@ -0,0 +1,8 @@
+import { unmangle } from "@backtickjs/compiler";
+import type ts from "typescript";
+
+export function unmangleDisplayPart(
+  part: ts.SymbolDisplayPart,
+): ts.SymbolDisplayPart {
+  return { ...part, text: unmangle(part.text) };
+}

package/src/unmangleQuickInfo.ts

@@ -0,0 +1,10 @@
+import type ts from "typescript";
+import { unmangleDisplayPart } from "./unmangleDisplayPart";
+
+export function unmangleQuickInfo(quickInfo: ts.QuickInfo): ts.QuickInfo {
+  return {
+    ...quickInfo,
+    displayParts: quickInfo.displayParts?.map(unmangleDisplayPart),
+    documentation: quickInfo.documentation?.map(unmangleDisplayPart),
+  };
+}