@nola-lang/typescript-plugin 0.1.4 → 0.1.5

package/dist/runtime-stub-host.d.ts

@@ -0,0 +1,39 @@
+import type ts from "typescript";
+/**
+ * The virtual file the stub is served under — the same path `nola check`
+ * (tshost) uses for its bare-project fallback, so both tools name the one
+ * surface the same way.
+ */
+export declare const RUNTIME_STUB_FILE = "/__nola_stubs__/runtime.d.ts";
+/**
+ * Serves the compiler's ambient stub as `@nola-lang/runtime` whenever that
+ * specifier does NOT resolve from the importing file — the installed package
+ * wins every time it exists.
+ *
+ * Why: lowered code imports the runtime in its appendix. In a project where
+ * the package is not installed yet (the window between `npm create nola` and
+ * `npm install`, or a bare `.tsi` opened on its own) that import fails, and
+ * because the appendix is unmapped the TS2307 never reaches the editor —
+ * only its derivative does: `__nola` is `any`, so the wrapper's
+ * `(__frame) => …` loses its contextual type and the user sees "Parameter
+ * '__frame' implicitly has an 'any' type" on the infer function header.
+ * `nola check` answers the same situation with RUNTIME_AMBIENT_STUB (tshost's
+ * bare-project fallback); the editor hosts do the same here, so a .tsi is
+ * fully typed before the install and the editor agrees with `nola check`.
+ *
+ * The stub is resolved as an external-library file (no diagnostics of its
+ * own, like anything under node_modules) and served through the same four
+ * host seams companions use: resolveModuleNameLiterals (ONE batch call to the
+ * prior resolver — the full literal array, never per literal; see
+ * companion-host.ts for why tsserver's resolution cache needs that),
+ * fileExists / readFile / getScriptSnapshot / getScriptVersion.
+ *
+ * Note the stale window: Volar's language server caches a failed lookup until
+ * a watched-file event for that very path, and VS Code never reports
+ * `node_modules` changes (files.watcherExclude) — so after `npm install` the
+ * stub keeps serving until the window reloads. That is benign by design: the
+ * stub and the real `__nola` surface are held in lockstep
+ * (emit-surface.test.ts), so types do not change, only F12 targets do.
+ */
+export declare function decorateHostWithRuntimeStub(typescript: typeof ts, host: ts.LanguageServiceHost): void;
+//# sourceMappingURL=runtime-stub-host.d.ts.map

package/dist/runtime-stub-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-stub-host.d.ts","sourceRoot":"","sources":["../src/runtime-stub-host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAQhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,GAAG,IAAI,CA4CrG"}

package/dist/runtime-stub-host.js

@@ -0,0 +1,81 @@
+import { RUNTIME_AMBIENT_STUB } from "@nola-lang/compiler";
+/**
+ * The virtual file the stub is served under — the same path `nola check`
+ * (tshost) uses for its bare-project fallback, so both tools name the one
+ * surface the same way.
+ */
+export const RUNTIME_STUB_FILE = "/__nola_stubs__/runtime.d.ts";
+const RUNTIME_SPECIFIER = "@nola-lang/runtime";
+function norm(p) {
+    return p.replace(/\\/g, "/");
+}
+/**
+ * Serves the compiler's ambient stub as `@nola-lang/runtime` whenever that
+ * specifier does NOT resolve from the importing file — the installed package
+ * wins every time it exists.
+ *
+ * Why: lowered code imports the runtime in its appendix. In a project where
+ * the package is not installed yet (the window between `npm create nola` and
+ * `npm install`, or a bare `.tsi` opened on its own) that import fails, and
+ * because the appendix is unmapped the TS2307 never reaches the editor —
+ * only its derivative does: `__nola` is `any`, so the wrapper's
+ * `(__frame) => …` loses its contextual type and the user sees "Parameter
+ * '__frame' implicitly has an 'any' type" on the infer function header.
+ * `nola check` answers the same situation with RUNTIME_AMBIENT_STUB (tshost's
+ * bare-project fallback); the editor hosts do the same here, so a .tsi is
+ * fully typed before the install and the editor agrees with `nola check`.
+ *
+ * The stub is resolved as an external-library file (no diagnostics of its
+ * own, like anything under node_modules) and served through the same four
+ * host seams companions use: resolveModuleNameLiterals (ONE batch call to the
+ * prior resolver — the full literal array, never per literal; see
+ * companion-host.ts for why tsserver's resolution cache needs that),
+ * fileExists / readFile / getScriptSnapshot / getScriptVersion.
+ *
+ * Note the stale window: Volar's language server caches a failed lookup until
+ * a watched-file event for that very path, and VS Code never reports
+ * `node_modules` changes (files.watcherExclude) — so after `npm install` the
+ * stub keeps serving until the window reloads. That is benign by design: the
+ * stub and the real `__nola` surface are held in lockstep
+ * (emit-surface.test.ts), so types do not change, only F12 targets do.
+ */
+export function decorateHostWithRuntimeStub(typescript, host) {
+    const isStub = (f) => norm(f) === RUNTIME_STUB_FILE;
+    let snapshot;
+    const stubSnapshot = () => {
+        snapshot ??= typescript.ScriptSnapshot.fromString(RUNTIME_AMBIENT_STUB);
+        return snapshot;
+    };
+    const priorResolve = host.resolveModuleNameLiterals?.bind(host);
+    host.resolveModuleNameLiterals = (literals, containingFile, redirected, opts, file, reused) => {
+        const base = priorResolve
+            ? priorResolve(literals, containingFile, redirected, opts, file, reused)
+            : literals.map((literal) => typescript.resolveModuleName(literal.text, containingFile, opts, {
+                fileExists: (f) => host.fileExists?.(f) ?? typescript.sys.fileExists(f),
+                readFile: (f) => host.readFile?.(f) ?? typescript.sys.readFile(f),
+                directoryExists: host.directoryExists?.bind(host),
+                realpath: host.realpath?.bind(host),
+            }));
+        return literals.map((literal, i) => {
+            const result = base[i];
+            if (literal.text !== RUNTIME_SPECIFIER || result.resolvedModule)
+                return result;
+            return {
+                resolvedModule: {
+                    resolvedFileName: RUNTIME_STUB_FILE,
+                    extension: typescript.Extension.Dts,
+                    isExternalLibraryImport: true,
+                },
+            };
+        });
+    };
+    const priorFileExists = host.fileExists?.bind(host);
+    host.fileExists = (f) => isStub(f) || (priorFileExists?.(f) ?? false);
+    const priorReadFile = host.readFile?.bind(host);
+    host.readFile = (f, encoding) => (isStub(f) ? RUNTIME_AMBIENT_STUB : priorReadFile?.(f, encoding));
+    const priorGetSnapshot = host.getScriptSnapshot.bind(host);
+    host.getScriptSnapshot = (f) => (isStub(f) ? stubSnapshot() : priorGetSnapshot(f));
+    const priorGetVersion = host.getScriptVersion.bind(host);
+    host.getScriptVersion = (f) => (isStub(f) ? "nola-runtime-stub" : priorGetVersion(f));
+}
+//# sourceMappingURL=runtime-stub-host.js.map

package/dist/runtime-stub-host.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nola-lang/typescript-plugin",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "tsserver plugin serving .tsi to TypeScript editors (internal editor layer)",
   "keywords": [
     "nola"
@@ -36,9 +36,9 @@
     "bundle": "node scripts/bundle.mjs"
   },
   "dependencies": {
-    "@nola-lang/compiler": "0.1.4",
-    "@nola-lang/language-core": "0.1.4",
-    "@nola-lang/node-loader": "0.1.4",
+    "@nola-lang/compiler": "0.1.5",
+    "@nola-lang/language-core": "0.1.5",
+    "@nola-lang/node-loader": "0.1.5",
     "@volar/typescript": "2.4.28"
   },
   "devDependencies": {