@backtickjs/tsc 0.2.2 → 0.2.4

package/README.md

@@ -36,6 +36,17 @@ backtick-tsc --emitDeclarationOnly
 
 A script's declaration carries its real type, where plain `tsc` would write `Client<unknown>`, and its parameter names read as you wrote them.
 
+To check files in-process, `createProgram` is `ts.createProgram` as `backtick-tsc` creates one. It takes the options form, with a host:
+
+```ts
+import { createProgram } from "@backtickjs/tsc";
+import ts from "typescript";
+
+const host = ts.createCompilerHost(options);
+const program = createProgram({ rootNames: ["App.tsx"], options, host });
+const diagnostics = ts.getPreEmitDiagnostics(program);
+```
+
 ## Notes
 
 - It writes declarations only. Run it with `--noEmit` or `--emitDeclarationOnly`; any other emit is refused with an error, because the JavaScript it would write is the code the type checker reads, not code that runs. To build JavaScript, use a loader ([`@backtickjs/node-plugin`](https://github.com/backtickjs/backtick/tree/main/packages/node-plugin), [`@backtickjs/bun-plugin`](https://github.com/backtickjs/backtick/tree/main/packages/bun-plugin)) or `tspc` with [`@backtickjs/tspatch-plugin`](https://github.com/backtickjs/backtick/tree/main/packages/tspatch-plugin).

package/dist/index.d.ts

@@ -1 +1,3 @@
+import ts from "typescript";
 export declare function run(tscPath?: string): any;
+export declare const createProgram: typeof ts.createProgram;

package/dist/index.js

@@ -2,16 +2,17 @@ import { createRequire } from "node:module";
 import { unmangle } from "@backtickjs/compiler";
 import { getBacktickLanguagePlugin } from "@backtickjs/language-plugin";
 import { getBacktickDiagnostics, unmangleDiagnostic, } from "@backtickjs/language-service";
+import { proxyCreateProgram } from "@volar/typescript/lib/node/proxyCreateProgram.js";
 import { fillSourceFileText } from "@volar/typescript/lib/node/transform.js";
 import { runTsc } from "@volar/typescript/lib/quickstart/runTsc.js";
+// The standalone TypeScript API, not the `ts` `runTsc` hands its callback: that
+// one is its internal tsc.js CLI bundle, whose namespace members are lazy
+// `eval`-based getters that throw when read outside their module scope
+// (Backtick's `parseFile` reads `ts.ScriptTarget`).
+import ts from "typescript";
 const require = createRequire(import.meta.url);
+patchDecorateProgram();
 export function run(tscPath = require.resolve("typescript/lib/tsc.js")) {
-    // Use the standalone TypeScript API, not the `ts` handed to the callback: that
-    // one is `runTsc`'s internal tsc.js CLI bundle, whose namespace members are
-    // lazy `eval`-based getters that throw when read outside their module scope
-    // (Backtick's `parseFile` reads `ts.ScriptTarget`).
-    const ts = require("typescript");
-    patchDecorateProgram(ts);
     return runTsc(tscPath, 
     // No extra file extensions: Backtick virtualizes standard .ts/.tsx/.js/.jsx
     // in place, matching the TS server plugins (which also pass []).
@@ -19,6 +20,10 @@ export function run(tscPath = require.resolve("typescript/lib/tsc.js")) {
         languagePlugins: [getBacktickLanguagePlugin(ts, (fileName) => fileName)],
     }));
 }
+// `ts.createProgram` as `backtick-tsc` creates one, to check files in-process.
+export const createProgram = proxyCreateProgram(ts, ts.createProgram, () => ({
+    languagePlugins: [getBacktickLanguagePlugin(ts, (fileName) => fileName)],
+}));
 // What this tool is for beyond checking: a package that exports a client script
 // gets a declaration carrying the script's real type. Plain `tsc` types
 // `cs`...`` by the tag's own signature, `Client<unknown>`, because the
@@ -30,7 +35,7 @@ export function run(tscPath = require.resolve("typescript/lib/tsc.js")) {
 // the emitter prints them, on identifiers alone, so nothing inside a string
 // literal is touched. Not at the file system: `sys.writeFile` writes through
 // `openSync`, and the CLI bundle's `sys` is not this module's anyway.
-function unmangleDeclarations(ts, program) {
+function unmangleDeclarations(program) {
     const emit = program.emit.bind(program);
     program.emit = (targetSourceFile, writeFile, cancellationToken, emitOnlyDtsFiles, customTransformers) => emit(targetSourceFile, writeFile, cancellationToken, emitOnlyDtsFiles, {
         ...customTransformers,
@@ -72,16 +77,16 @@ function refuseJavaScriptEmit(options) {
 }
 // Surfaces Backtick's own compiler diagnostics through `tsc` by wrapping the
 // program's `getSemanticDiagnostics`. This has to patch Volar's `decorateProgram`
-// module in place: `runTsc` proxies TypeScript internally and calls the module's
-// export by property access at program-creation time, so reassigning it here is
-// picked up.
-function patchDecorateProgram(ts) {
+// module in place: Volar's program proxy calls the module's export by property
+// access at program-creation time, so reassigning it here is picked up. Once,
+// when this module loads, for `run` and `createProgram` alike.
+function patchDecorateProgram() {
     const decorateProgramModule = require("@volar/typescript/lib/node/decorateProgram.js");
     const volarDecorateProgram = decorateProgramModule.decorateProgram;
     decorateProgramModule.decorateProgram = (language, program) => {
         volarDecorateProgram(language, program);
         refuseJavaScriptEmit(program.getCompilerOptions());
-        unmangleDeclarations(ts, program);
+        unmangleDeclarations(program);
         const getSemanticDiagnostics = program.getSemanticDiagnostics.bind(program);
         program.getSemanticDiagnostics = (sourceFile, cancellationToken) => {
             const files = sourceFile ? [sourceFile] : program.getSourceFiles();

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtickjs/tsc",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "backtick-tsc: tsc that type-checks Backtick client scripts and every splice crossing into them",
   "keywords": [
     "backtick",
@@ -24,6 +24,13 @@
   "license": "MIT",
   "author": "Jean-François Bisson <jf@backtickjs.com>",
   "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./bin/backtick-tsc.js": "./bin/backtick-tsc.js"
+  },
   "bin": {
     "backtick-tsc": "./bin/backtick-tsc.js"
   },
@@ -37,9 +44,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@backtickjs/compiler": "^0.2.2",
-    "@backtickjs/language-service": "^0.2.2",
-    "@backtickjs/language-plugin": "^0.2.2",
+    "@backtickjs/compiler": "^0.2.4",
+    "@backtickjs/language-service": "^0.2.4",
+    "@backtickjs/language-plugin": "^0.2.4",
     "@volar/typescript": "^2.4.28"
   },
   "peerDependencies": {

package/src/index.ts

@@ -5,21 +5,20 @@ import {
   getBacktickDiagnostics,
   unmangleDiagnostic,
 } from "@backtickjs/language-service";
+import { proxyCreateProgram } from "@volar/typescript/lib/node/proxyCreateProgram.js";
 import { fillSourceFileText } from "@volar/typescript/lib/node/transform.js";
 import { runTsc } from "@volar/typescript/lib/quickstart/runTsc.js";
-import type ts from "typescript";
+// The standalone TypeScript API, not the `ts` `runTsc` hands its callback: that
+// one is its internal tsc.js CLI bundle, whose namespace members are lazy
+// `eval`-based getters that throw when read outside their module scope
+// (Backtick's `parseFile` reads `ts.ScriptTarget`).
+import ts from "typescript";
 
 const require = createRequire(import.meta.url);
 
-export function run(tscPath = require.resolve("typescript/lib/tsc.js")) {
-  // Use the standalone TypeScript API, not the `ts` handed to the callback: that
-  // one is `runTsc`'s internal tsc.js CLI bundle, whose namespace members are
-  // lazy `eval`-based getters that throw when read outside their module scope
-  // (Backtick's `parseFile` reads `ts.ScriptTarget`).
-  const ts = require("typescript") as typeof import("typescript");
-
-  patchDecorateProgram(ts);
+patchDecorateProgram();
 
+export function run(tscPath = require.resolve("typescript/lib/tsc.js")) {
   return runTsc(
     tscPath,
     // No extra file extensions: Backtick virtualizes standard .ts/.tsx/.js/.jsx
@@ -31,6 +30,11 @@ export function run(tscPath = require.resolve("typescript/lib/tsc.js")) {
   );
 }
 
+// `ts.createProgram` as `backtick-tsc` creates one, to check files in-process.
+export const createProgram = proxyCreateProgram(ts, ts.createProgram, () => ({
+  languagePlugins: [getBacktickLanguagePlugin(ts, (fileName) => fileName)],
+}));
+
 // What this tool is for beyond checking: a package that exports a client script
 // gets a declaration carrying the script's real type. Plain `tsc` types
 // `cs`...`` by the tag's own signature, `Client<unknown>`, because the
@@ -42,10 +46,7 @@ export function run(tscPath = require.resolve("typescript/lib/tsc.js")) {
 // the emitter prints them, on identifiers alone, so nothing inside a string
 // literal is touched. Not at the file system: `sys.writeFile` writes through
 // `openSync`, and the CLI bundle's `sys` is not this module's anyway.
-function unmangleDeclarations(
-  ts: typeof import("typescript"),
-  program: ts.Program,
-): void {
+function unmangleDeclarations(program: ts.Program): void {
   const emit = program.emit.bind(program);
   program.emit = (
     targetSourceFile,
@@ -101,10 +102,10 @@ function refuseJavaScriptEmit(options: {
 
 // Surfaces Backtick's own compiler diagnostics through `tsc` by wrapping the
 // program's `getSemanticDiagnostics`. This has to patch Volar's `decorateProgram`
-// module in place: `runTsc` proxies TypeScript internally and calls the module's
-// export by property access at program-creation time, so reassigning it here is
-// picked up.
-function patchDecorateProgram(ts: typeof import("typescript")) {
+// module in place: Volar's program proxy calls the module's export by property
+// access at program-creation time, so reassigning it here is picked up. Once,
+// when this module loads, for `run` and `createProgram` alike.
+function patchDecorateProgram() {
   const decorateProgramModule =
     require("@volar/typescript/lib/node/decorateProgram.js") as typeof import("@volar/typescript/lib/node/decorateProgram.js");
   const volarDecorateProgram = decorateProgramModule.decorateProgram;
@@ -112,7 +113,7 @@ function patchDecorateProgram(ts: typeof import("typescript")) {
   decorateProgramModule.decorateProgram = (language, program) => {
     volarDecorateProgram(language, program);
     refuseJavaScriptEmit(program.getCompilerOptions());
-    unmangleDeclarations(ts, program);
+    unmangleDeclarations(program);
 
     const getSemanticDiagnostics = program.getSemanticDiagnostics.bind(program);
     program.getSemanticDiagnostics = (sourceFile, cancellationToken) => {