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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Evgen Mykhailenko
+
+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

@@ -0,0 +1,7 @@
+Part of [Nola](https://github.com/nola-lang/nola), a TypeScript superset (`.tsi`) where `infer` functions and `ask` extractors turn prompts into typed values.
+
+**Internal package** — you probably want [`nola-lang`](https://www.npmjs.com/package/nola-lang) (the dev tool) or [`@nola-lang/runtime`](https://www.npmjs.com/package/@nola-lang/runtime) (the app dependency).
+
+This package is the tsserver plugin that serves `.tsi` files and their companions to TypeScript editors. The Nola VS Code extension loads it automatically.
+
+Versioned in lockstep with the whole toolchain; internal APIs may change in any release.

package/dist/companion-host.d.ts

@@ -0,0 +1,17 @@
+import type ts from "typescript";
+export interface CompanionRegistration {
+    sourceFile: string;
+    sourceRoot?: string;
+}
+/** Registry lookup for the ServerHost decoration; exact match first, then case-insensitive. */
+export declare function companionRegistration(fileName: string): CompanionRegistration | undefined;
+/**
+ * Companions in the editor: host-level synthetic scripts (never VirtualCode —
+ * nobody edits them, no mappings map back). Derived from the CURRENT host
+ * snapshot of the source file and versioned by that file's script version, so
+ * unsaved edits propagate and TypeScript owns invalidation (spec §6b).
+ */
+export declare function decorateHostWithCompanions(typescript: typeof ts, host: ts.LanguageServiceHost, options?: {
+    sourceRoot?: string;
+}): void;
+//# sourceMappingURL=companion-host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companion-host.d.ts","sourceRoot":"","sources":["../src/companion-host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAWjC,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAeD,+FAA+F;AAC/F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAGzF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,OAAO,EAAE,EACrB,IAAI,EAAE,EAAE,CAAC,mBAAmB,EAC5B,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,IAAI,CA+FN"}

package/dist/companion-host.js

@@ -0,0 +1,121 @@
+import { dirname, resolve as resolvePath } from "node:path";
+import { companionSourceCandidates, compileCompanion, isCompanionSpecifier } from "@nola-lang/compiler";
+function norm(p) {
+    return p.replace(/\\/g, "/");
+}
+// Process-wide registry of every companion any host decoration has resolved,
+// keyed by normalized companion fileName (plus a lowercase index for Windows
+// case-insensitive probes). The ServerHost decoration reads it so tsserver's
+// ScriptInfo/watch layer can treat companions as real files — see
+// decorateServerHostForCompanions.
+const sharedCompanions = new Map();
+const sharedCompanionsLower = new Map();
+function registerCompanion(companionFileName, registration) {
+    sharedCompanions.set(companionFileName, registration);
+    sharedCompanionsLower.set(companionFileName.toLowerCase(), registration);
+}
+/** Registry lookup for the ServerHost decoration; exact match first, then case-insensitive. */
+export function companionRegistration(fileName) {
+    const key = norm(fileName);
+    return sharedCompanions.get(key) ?? sharedCompanionsLower.get(key.toLowerCase());
+}
+/**
+ * Companions in the editor: host-level synthetic scripts (never VirtualCode —
+ * nobody edits them, no mappings map back). Derived from the CURRENT host
+ * snapshot of the source file and versioned by that file's script version, so
+ * unsaved edits propagate and TypeScript owns invalidation (spec §6b).
+ */
+export function decorateHostWithCompanions(typescript, host, options = {}) {
+    /** synthetic companion fileName -> its on-disk/source fileName */
+    const companionSources = new Map();
+    const cache = new Map();
+    const sourceFor = (companionFileName) => companionSources.get(norm(companionFileName));
+    const computeSnapshot = (companionFileName) => {
+        const source = sourceFor(companionFileName);
+        if (!source)
+            return undefined;
+        const version = host.getScriptVersion(source);
+        const cached = cache.get(companionFileName);
+        if (cached && cached.sourceVersion === version)
+            return cached.snapshot;
+        const sourceSnap = host.getScriptSnapshot(source);
+        if (!sourceSnap)
+            return undefined;
+        const text = sourceSnap.getText(0, sourceSnap.getLength());
+        const companion = compileCompanion(text, source, { sourceRoot: options.sourceRoot });
+        const snapshot = typescript.ScriptSnapshot.fromString(companion.code);
+        cache.set(companionFileName, { sourceVersion: version, snapshot });
+        return snapshot;
+    };
+    const tryResolveCompanion = (specifier, containingFile) => {
+        if (!isCompanionSpecifier(specifier) || !specifier.startsWith("."))
+            return undefined;
+        const importerDir = dirname(containingFile);
+        for (const candidate of companionSourceCandidates(specifier)) {
+            const p = resolvePath(importerDir, candidate);
+            if (host.fileExists?.(p) ?? typescript.sys.fileExists(p)) {
+                const companionFileName = norm(`${resolvePath(importerDir, specifier).slice(0, -".js".length)}.ts`);
+                companionSources.set(companionFileName, norm(p));
+                registerCompanion(companionFileName, { sourceFile: norm(p), sourceRoot: options.sourceRoot });
+                return companionFileName;
+            }
+        }
+        return undefined;
+    };
+    const priorResolve = host.resolveModuleNameLiterals?.bind(host);
+    host.resolveModuleNameLiterals = (literals, containingFile, redirected, opts, file, reused) => {
+        // ONE base call with the full literal array: tsserver's resolution cache
+        // keeps per-call bookkeeping (reusedNames correspond to the literals it
+        // did NOT receive) — per-literal delegation corrupts it and crashes the
+        // server in stopWatchFailedLookupLocationOfResolution. Companion entries
+        // then replace their slots in the result.
+        const base = priorResolve
+            ? priorResolve(literals, containingFile, redirected, opts, file, reused)
+            : literals.map((literal) => ({
+                resolvedModule: typescript.resolveModuleName(literal.text, containingFile, opts, {
+                    fileExists: (f) => host.fileExists?.(f) ?? typescript.sys.fileExists(f),
+                    readFile: (f) => host.readFile?.(f) ?? typescript.sys.readFile(f),
+                }).resolvedModule,
+            }));
+        return literals.map((literal, i) => {
+            const companion = tryResolveCompanion(literal.text, containingFile);
+            if (companion) {
+                return {
+                    resolvedModule: {
+                        resolvedFileName: companion,
+                        extension: typescript.Extension.Ts,
+                        isExternalLibraryImport: false,
+                    },
+                };
+            }
+            return base[i];
+        });
+    };
+    const priorFileExists = host.fileExists?.bind(host);
+    host.fileExists = (f) => (sourceFor(f) ? computeSnapshot(norm(f)) !== undefined : (priorFileExists?.(f) ?? false));
+    const priorGetSnapshot = host.getScriptSnapshot.bind(host);
+    host.getScriptSnapshot = (f) => {
+        if (!sourceFor(f))
+            return priorGetSnapshot(f);
+        // Under tsserver the prior chain is Project.getScriptSnapshot, whose side
+        // effect mints and attaches the companion's ScriptInfo (it exists to
+        // tsserver's file layer via decorateServerHostForCompanions). Without a
+        // ScriptInfo, tsserver asserts on the companion in several places
+        // (document-registry cache, project telemetry). The returned snapshot is
+        // still ours — derived from the LIVE source snapshot, so unsaved edits
+        // propagate; the ScriptInfo's disk-derived text is never user-visible.
+        priorGetSnapshot(f);
+        return computeSnapshot(norm(f));
+    };
+    const priorGetVersion = host.getScriptVersion.bind(host);
+    host.getScriptVersion = (f) => {
+        const source = sourceFor(f);
+        return source ? `companion-of:${priorGetVersion(source)}` : priorGetVersion(f);
+    };
+    const priorReadFile = host.readFile?.bind(host);
+    host.readFile = (f) => {
+        const snapshot = sourceFor(f) ? computeSnapshot(norm(f)) : undefined;
+        return snapshot ? snapshot.getText(0, snapshot.getLength()) : priorReadFile?.(f);
+    };
+}
+//# sourceMappingURL=companion-host.js.map

package/dist/companion-host.js.map

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

package/dist/document-cache-guard.d.ts

@@ -0,0 +1,17 @@
+/**
+ * tsserver's DocumentRegistry uses the ProjectService as an external source
+ * file cache and ASSERTS that every cached path has a ScriptInfo
+ * (`Debug.checkDefined` in ProjectService.setDocument). Synthetic companion
+ * modules are host-level scripts with no on-disk file: tsserver's
+ * watch/ScriptInfo lifecycle drops their info shortly after creation, and
+ * from then on EVERY program rebuild (any edit) dies in that assert —
+ * diagnostics freeze until the file is closed and reopened. The cache is
+ * genuinely optional (getDocument is already null-safe), so skip the write
+ * when no ScriptInfo exists instead of crashing.
+ *
+ * setDocument/getScriptInfoForPath are @internal API — the guard no-ops
+ * gracefully if a future TypeScript renames them. One ProjectService serves
+ * every project, so the patch applies once per instance.
+ */
+export declare function guardProjectServiceDocumentCache(projectService: unknown): void;
+//# sourceMappingURL=document-cache-guard.d.ts.map

package/dist/document-cache-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-cache-guard.d.ts","sourceRoot":"","sources":["../src/document-cache-guard.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAAC,cAAc,EAAE,OAAO,GAAG,IAAI,CAS9E"}

package/dist/document-cache-guard.js

@@ -0,0 +1,29 @@
+const PATCHED = Symbol.for("nola.documentCacheGuard");
+/**
+ * tsserver's DocumentRegistry uses the ProjectService as an external source
+ * file cache and ASSERTS that every cached path has a ScriptInfo
+ * (`Debug.checkDefined` in ProjectService.setDocument). Synthetic companion
+ * modules are host-level scripts with no on-disk file: tsserver's
+ * watch/ScriptInfo lifecycle drops their info shortly after creation, and
+ * from then on EVERY program rebuild (any edit) dies in that assert —
+ * diagnostics freeze until the file is closed and reopened. The cache is
+ * genuinely optional (getDocument is already null-safe), so skip the write
+ * when no ScriptInfo exists instead of crashing.
+ *
+ * setDocument/getScriptInfoForPath are @internal API — the guard no-ops
+ * gracefully if a future TypeScript renames them. One ProjectService serves
+ * every project, so the patch applies once per instance.
+ */
+export function guardProjectServiceDocumentCache(projectService) {
+    const ps = projectService;
+    if (ps[PATCHED] || typeof ps.setDocument !== "function" || typeof ps.getScriptInfoForPath !== "function")
+        return;
+    ps[PATCHED] = true;
+    const prior = ps.setDocument.bind(ps);
+    ps.setDocument = (key, path, sourceFile) => {
+        if (!ps.getScriptInfoForPath?.(path))
+            return;
+        prior(key, path, sourceFile);
+    };
+}
+//# sourceMappingURL=document-cache-guard.js.map

package/dist/document-cache-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-cache-guard.js","sourceRoot":"","sources":["../src/document-cache-guard.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAQtD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gCAAgC,CAAC,cAAuB;IACtE,MAAM,EAAE,GAAG,cAAyC,CAAC;IACrD,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,UAAU,IAAI,OAAO,EAAE,CAAC,oBAAoB,KAAK,UAAU;QAAE,OAAO;IACjH,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACnB,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,EAAE,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QACzC,IAAI,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC;YAAE,OAAO;QAC7C,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { decorateHostWithCompanions } from "./companion-host.js";
+export { createNolaTsPlugin } from "./plugin.js";
+export { decorateHostHideShadowedDeclarations } from "./shadowed-declarations.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oCAAoC,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { decorateHostWithCompanions } from "./companion-host.js";
+export { createNolaTsPlugin } from "./plugin.js";
+export { decorateHostHideShadowedDeclarations } from "./shadowed-declarations.js";
+//# 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,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oCAAoC,EAAE,MAAM,4BAA4B,CAAC"}