@nola-lang/typescript-plugin 0.1.0-alpha.0

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+import type ts from "typescript";
+/** tsserver plugin factory; loaded via the CJS bundle in Track 3. */
+export declare function createNolaTsPlugin(): ts.server.PluginModuleFactory;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAMjC,qEAAqE;AACrE,wBAAgB,kBAAkB,IAAI,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAWlE"}

package/dist/plugin.js

@@ -0,0 +1,29 @@
+// Installed-API findings (@volar/typescript@2.4.28), per plan Task 3 Step 1:
+// - quickstart factory: `createLanguageServicePlugin(cb)` at
+//   lib/quickstart/createLanguageServicePlugin (subpath import; package has no
+//   exports map). cb: (ts, info) => { languagePlugins: LanguagePlugin<string>[], setup? }.
+// - LanguagePlugin.typescript augmentation lives in @volar/typescript's index.
+// - Headless building blocks: createLanguage (@volar/language-core),
+//   decorateLanguageServiceHost(ts, language, host) and
+//   createProxyLanguageService(ls) -> { initialize(language), proxy } (@volar/typescript).
+import { createNolaLanguagePlugin } from "@nola-lang/language-core";
+import { findProjectRoot } from "@nola-lang/node-loader";
+import { createLanguageServicePlugin } from "@volar/typescript/lib/quickstart/createLanguageServicePlugin.js";
+import { decorateHostWithCompanions } from "./companion-host.js";
+import { guardProjectServiceDocumentCache } from "./document-cache-guard.js";
+import { decorateServerHostForCompanions } from "./server-host.js";
+import { decorateHostHideShadowedDeclarations } from "./shadowed-declarations.js";
+/** tsserver plugin factory; loaded via the CJS bundle in Track 3. */
+export function createNolaTsPlugin() {
+    return createLanguageServicePlugin((typescript, info) => {
+        const sourceRoot = findProjectRoot(info.project.getCurrentDirectory());
+        guardProjectServiceDocumentCache(info.project.projectService);
+        decorateServerHostForCompanions(info.serverHost);
+        decorateHostHideShadowedDeclarations(typescript, info.languageServiceHost);
+        decorateHostWithCompanions(typescript, info.languageServiceHost, { sourceRoot });
+        return {
+            languagePlugins: [createNolaLanguagePlugin((fileName) => fileName, { sourceRoot })],
+        };
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6DAA6D;AAC7D,+EAA+E;AAC/E,2FAA2F;AAC3F,+EAA+E;AAC/E,qEAAqE;AACrE,wDAAwD;AACxD,2FAA2F;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AAE9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,oCAAoC,EAAE,MAAM,4BAA4B,CAAC;AAElF,qEAAqE;AACrE,MAAM,UAAU,kBAAkB;IAChC,OAAO,2BAA2B,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE;QACtD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;QACvE,gCAAgC,CAAE,IAAI,CAAC,OAAkD,CAAC,cAAc,CAAC,CAAC;QAC1G,+BAA+B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,oCAAoC,CAAC,UAAU,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC3E,0BAA0B,CAAC,UAAU,EAAE,IAAI,CAAC,mBAAmB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,OAAO;YACL,eAAe,EAAE,CAAC,wBAAwB,CAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;SAC5F,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server-host.d.ts

@@ -0,0 +1,25 @@
+import type ts from "typescript";
+/**
+ * Make companions REAL to tsserver's file layer. Companion modules are
+ * program files, and tsserver's ScriptInfo/watch machinery assumes every
+ * program file is backed by disk or an open editor document — a companion
+ * that exists only in language-service-host decorations violates that
+ * invariant, and tsserver enforces it with Debug asserts in several places
+ * (ProjectService.setDocument, Project.getScriptInfos via project telemetry —
+ * the latter crashed VS Code's TS 6.0.3 on project load).
+ *
+ * The decoration answers for registered companion paths at the ServerHost
+ * (ts.sys-equivalent) level:
+ * - fileExists/readFile: the companion exists; its text derives from the
+ *   ON-DISK source module (compileCompanion). The live unsaved-edits variant
+ *   still comes from the language-service host's snapshot decoration — this
+ *   layer only has to be consistent enough for ScriptInfo bookkeeping.
+ * - getModifiedTime: the SOURCE file's mtime (the companion "changes" exactly
+ *   when its source does).
+ * - watchFile: forwards to a watch on the source file, reporting events under
+ *   the companion's name — deleting the source marks the companion deleted.
+ *
+ * One ServerHost serves the whole tsserver process; the patch applies once.
+ */
+export declare function decorateServerHostForCompanions(serverHost: ts.server.ServerHost): void;
+//# sourceMappingURL=server-host.d.ts.map

package/dist/server-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-host.d.ts","sourceRoot":"","sources":["../src/server-host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAKjC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAoCtF"}

package/dist/server-host.js

@@ -0,0 +1,58 @@
+import { compileCompanion } from "@nola-lang/compiler";
+import { companionRegistration } from "./companion-host.js";
+const PATCHED = Symbol.for("nola.companionServerHost");
+/**
+ * Make companions REAL to tsserver's file layer. Companion modules are
+ * program files, and tsserver's ScriptInfo/watch machinery assumes every
+ * program file is backed by disk or an open editor document — a companion
+ * that exists only in language-service-host decorations violates that
+ * invariant, and tsserver enforces it with Debug asserts in several places
+ * (ProjectService.setDocument, Project.getScriptInfos via project telemetry —
+ * the latter crashed VS Code's TS 6.0.3 on project load).
+ *
+ * The decoration answers for registered companion paths at the ServerHost
+ * (ts.sys-equivalent) level:
+ * - fileExists/readFile: the companion exists; its text derives from the
+ *   ON-DISK source module (compileCompanion). The live unsaved-edits variant
+ *   still comes from the language-service host's snapshot decoration — this
+ *   layer only has to be consistent enough for ScriptInfo bookkeeping.
+ * - getModifiedTime: the SOURCE file's mtime (the companion "changes" exactly
+ *   when its source does).
+ * - watchFile: forwards to a watch on the source file, reporting events under
+ *   the companion's name — deleting the source marks the companion deleted.
+ *
+ * One ServerHost serves the whole tsserver process; the patch applies once.
+ */
+export function decorateServerHostForCompanions(serverHost) {
+    const host = serverHost;
+    if (host[PATCHED])
+        return;
+    host[PATCHED] = true;
+    const priorFileExists = host.fileExists.bind(host);
+    host.fileExists = (path) => (companionRegistration(path) ? true : priorFileExists(path));
+    const priorReadFile = host.readFile.bind(host);
+    host.readFile = (path, encoding) => {
+        const registration = companionRegistration(path);
+        if (!registration)
+            return priorReadFile(path, encoding);
+        const source = priorReadFile(registration.sourceFile);
+        if (source === undefined)
+            return undefined;
+        return compileCompanion(source, registration.sourceFile, { sourceRoot: registration.sourceRoot }).code;
+    };
+    const priorGetModifiedTime = host.getModifiedTime?.bind(host);
+    if (priorGetModifiedTime) {
+        host.getModifiedTime = (path) => {
+            const registration = companionRegistration(path);
+            return priorGetModifiedTime(registration ? registration.sourceFile : path);
+        };
+    }
+    const priorWatchFile = host.watchFile.bind(host);
+    host.watchFile = (path, callback, pollingInterval, options) => {
+        const registration = companionRegistration(path);
+        if (!registration)
+            return priorWatchFile(path, callback, pollingInterval, options);
+        return priorWatchFile(registration.sourceFile, (_fileName, eventKind, modifiedTime) => callback(path, eventKind, modifiedTime), pollingInterval, options);
+    };
+}
+//# sourceMappingURL=server-host.js.map

package/dist/server-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-host.js","sourceRoot":"","sources":["../src/server-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,+BAA+B,CAAC,UAAgC;IAC9E,MAAM,IAAI,GAAG,UAAyD,CAAC;IACvE,IAAI,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO;IAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAErB,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzF,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;QACjC,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,YAAY;YAAE,OAAO,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC;IACzG,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,oBAAoB,EAAE,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;YACjD,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE;QAC5D,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,YAAY;YAAE,OAAO,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACnF,OAAO,cAAc,CACnB,YAAY,CAAC,UAAU,EACvB,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,EAC/E,eAAe,EACf,OAAO,CACR,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/shadowed-declarations.d.ts

@@ -0,0 +1,15 @@
+import type ts from "typescript";
+/**
+ * Hide `X.d.tsi.ts` from the editor whenever a sibling `X.tsi` exists.
+ *
+ * With `allowArbitraryExtensions`, TypeScript resolves `./X.tsi` to the
+ * adjacent declaration FIRST — an on-disk build artifact (or a stale leftover
+ * from the old adjacent-declaration emit) would shadow the live virtual .tsi,
+ * sending navigation into the declaration instead of the source. Denying its
+ * existence makes standard resolution fail, so Volar's extra-extension
+ * resolution serves the .tsi in-memory and definitions map back to source.
+ * Declarations without a sibling .tsi (e.g. shipped by a built package whose
+ * sources are gone) stay visible.
+ */
+export declare function decorateHostHideShadowedDeclarations(typescript: typeof ts, host: ts.LanguageServiceHost): void;
+//# sourceMappingURL=shadowed-declarations.d.ts.map

package/dist/shadowed-declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowed-declarations.d.ts","sourceRoot":"","sources":["../src/shadowed-declarations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC;;;;;;;;;;;GAWG;AACH,wBAAgB,oCAAoC,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAc9G"}

package/dist/shadowed-declarations.js

@@ -0,0 +1,24 @@
+const DECL_SUFFIX = ".d.tsi.ts";
+/**
+ * Hide `X.d.tsi.ts` from the editor whenever a sibling `X.tsi` exists.
+ *
+ * With `allowArbitraryExtensions`, TypeScript resolves `./X.tsi` to the
+ * adjacent declaration FIRST — an on-disk build artifact (or a stale leftover
+ * from the old adjacent-declaration emit) would shadow the live virtual .tsi,
+ * sending navigation into the declaration instead of the source. Denying its
+ * existence makes standard resolution fail, so Volar's extra-extension
+ * resolution serves the .tsi in-memory and definitions map back to source.
+ * Declarations without a sibling .tsi (e.g. shipped by a built package whose
+ * sources are gone) stay visible.
+ */
+export function decorateHostHideShadowedDeclarations(typescript, host) {
+    const priorFileExists = host.fileExists?.bind(host);
+    const rawFileExists = (f) => priorFileExists?.(f) ?? typescript.sys.fileExists(f);
+    const shadowed = (f) => f.endsWith(DECL_SUFFIX) && rawFileExists(`${f.slice(0, -DECL_SUFFIX.length)}.tsi`);
+    host.fileExists = (f) => (shadowed(f) ? false : rawFileExists(f));
+    const priorReadFile = host.readFile?.bind(host);
+    host.readFile = (f) => (shadowed(f) ? undefined : priorReadFile?.(f));
+    const priorGetSnapshot = host.getScriptSnapshot.bind(host);
+    host.getScriptSnapshot = (f) => (shadowed(f) ? undefined : priorGetSnapshot(f));
+}
+//# sourceMappingURL=shadowed-declarations.js.map

package/dist/shadowed-declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowed-declarations.js","sourceRoot":"","sources":["../src/shadowed-declarations.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,WAAW,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oCAAoC,CAAC,UAAqB,EAAE,IAA4B;IACtG,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEnG,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAW,EAAE,CACtC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErF,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/tsserver-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tsserver-entry.d.ts.map

package/dist/tsserver-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsserver-entry.d.ts","sourceRoot":"","sources":["../src/tsserver-entry.ts"],"names":[],"mappings":""}

package/dist/tsserver-entry.js

@@ -0,0 +1,5 @@
+// The CJS bundle entry tsserver `require`s (see scripts/bundle.mjs). tsserver
+// plugins must export the factory as module.exports.
+import { createNolaTsPlugin } from "./plugin.js";
+module.exports = createNolaTsPlugin();
+//# sourceMappingURL=tsserver-entry.js.map

package/dist/tsserver-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsserver-entry.js","sourceRoot":"","sources":["../src/tsserver-entry.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qDAAqD;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,CAAC,OAAO,GAAG,kBAAkB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@nola-lang/typescript-plugin",
+  "version": "0.1.0-alpha.0",
+  "description": "tsserver plugin serving .tsi to TypeScript editors (internal editor layer)",
+  "keywords": [
+    "nola"
+  ],
+  "license": "MIT",
+  "author": "Evgen Mykhailenko",
+  "homepage": "https://github.com/nola-lang/nola#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nola-lang/nola.git",
+    "directory": "packages/typescript-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/nola-lang/nola/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/plugin.cjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/plugin.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "bundle": "node scripts/bundle.mjs"
+  },
+  "dependencies": {
+    "@nola-lang/compiler": "0.1.0-alpha.0",
+    "@nola-lang/language-core": "0.1.0-alpha.0",
+    "@nola-lang/node-loader": "0.1.0-alpha.0",
+    "@volar/typescript": "2.4.28"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}