ttsc 0.27.0 → 0.28.0

package/lib/plugin/internal/capabilityResolutionCache.js.map

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

package/lib/plugin/resolveCapabilityPlugins.d.ts

@@ -0,0 +1,55 @@
+/**
+ * One plugin that declared the requested capability.
+ *
+ * `manifest` is the `--plugins-json` payload its sidecar needs to find its own
+ * configured entry. Without it the sidecar loads an empty rule configuration
+ * and answers as though the project declared nothing — an empty answer that
+ * looks exactly like a project which genuinely publishes none.
+ */
+export interface ITtscCapabilityPlugin {
+    binary: string;
+    manifest: string;
+    /**
+     * The `--project-context-json` payload, or `undefined` when the plugin's
+     * descriptor does not declare it wants one.
+     *
+     * A sidecar is handed a project root, not asked to derive one. Without this a
+     * rule that resolves its own inputs — the documents an evidence claim reads,
+     * a Prisma schema, an OpenAPI file — has no base to resolve them against, and
+     * answers with an empty set rather than an error, because "this project
+     * declares nothing" is a legitimate answer it cannot distinguish from "I was
+     * not told where the project is".
+     */
+    projectContext?: string;
+}
+/**
+ * The built sidecars of a project's configured plugins that declare one
+ * capability.
+ *
+ * This is the seam a consumer outside the compiler needs to ask a plugin a
+ * question the plugin declared it can answer. `ttscserver` already does this
+ * for `capabilities.lsp`, but it does it from inside the launcher; a separate
+ * tool — `@ttsc/graph`, an editor integration, a script — had no way to reach
+ * the same answer without reimplementing plugin discovery, descriptor
+ * evaluation, and the Go source build cache.
+ *
+ * It is contributor-agnostic by construction: the caller names a capability,
+ * not a package. A project that configures no plugin, or none declaring that
+ * capability, gets an empty array — which is an answer, not a failure, and is
+ * the common case.
+ *
+ * Building a plugin is not free the first time. The Go source build is cached
+ * by content, so a warm project pays a lookup; a cold one pays the build the
+ * next `ttsc` invocation would have paid anyway.
+ *
+ * @param options.capability - Capability flag the plugin descriptor must
+ *   declare.
+ * @param options.cwd - Project root. Defaults to the current directory.
+ * @param options.tsconfig - Project tsconfig path, relative to `cwd`.
+ * @returns One entry per declaring plugin, in configured plugin order.
+ */
+export declare function resolveCapabilityPlugins(options: {
+    capability: string;
+    cwd?: string;
+    tsconfig?: string;
+}): ITtscCapabilityPlugin[];

package/lib/plugin/resolveCapabilityPlugins.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCapabilityPlugins = resolveCapabilityPlugins;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const createNativeProjectContextArgs_1 = require("../compiler/internal/project/createNativeProjectContextArgs");
+const resolveBinary_1 = require("../compiler/internal/resolveBinary");
+const capabilityResolutionCache_1 = require("./internal/capabilityResolutionCache");
+const loadProjectPlugins_1 = require("./internal/loadProjectPlugins");
+/**
+ * The built sidecars of a project's configured plugins that declare one
+ * capability.
+ *
+ * This is the seam a consumer outside the compiler needs to ask a plugin a
+ * question the plugin declared it can answer. `ttscserver` already does this
+ * for `capabilities.lsp`, but it does it from inside the launcher; a separate
+ * tool — `@ttsc/graph`, an editor integration, a script — had no way to reach
+ * the same answer without reimplementing plugin discovery, descriptor
+ * evaluation, and the Go source build cache.
+ *
+ * It is contributor-agnostic by construction: the caller names a capability,
+ * not a package. A project that configures no plugin, or none declaring that
+ * capability, gets an empty array — which is an answer, not a failure, and is
+ * the common case.
+ *
+ * Building a plugin is not free the first time. The Go source build is cached
+ * by content, so a warm project pays a lookup; a cold one pays the build the
+ * next `ttsc` invocation would have paid anyway.
+ *
+ * @param options.capability - Capability flag the plugin descriptor must
+ *   declare.
+ * @param options.cwd - Project root. Defaults to the current directory.
+ * @param options.tsconfig - Project tsconfig path, relative to `cwd`.
+ * @returns One entry per declaring plugin, in configured plugin order.
+ */
+function resolveCapabilityPlugins(options) {
+    const cwd = node_path_1.default.resolve(options.cwd ?? process.cwd());
+    const tsconfig = options.tsconfig ?? "tsconfig.json";
+    const cached = (0, capabilityResolutionCache_1.readCapabilityResolution)({ cwd, tsconfig, version });
+    if (cached !== null)
+        return select(cached, options.capability);
+    const binary = (0, resolveBinary_1.resolveBinary)();
+    if (binary === null || binary === undefined)
+        return [];
+    try {
+        const loaded = (0, loadProjectPlugins_1.loadProjectPlugins)({
+            binary,
+            cwd: options.cwd,
+            tsconfig: options.tsconfig,
+        });
+        // The manifest carries every configured plugin, not only the declaring one.
+        // A sidecar reads its OWN entry out of it — that entry is where its config
+        // file lives — and a manifest narrowed to the caller's capability would hand
+        // it a project it does not recognize, which is an empty answer rather than an
+        // error. This is the same string `runBuild` passes for a check-stage plugin.
+        const manifest = JSON.stringify(loaded.nativePlugins.map((plugin) => ({
+            config: plugin.config,
+            name: plugin.name,
+            stage: plugin.stage,
+        })));
+        const wantsContext = loaded.nativePlugins.some((plugin) => plugin.capabilities
+            ?.projectContextArgs === true);
+        const answer = {
+            hostInputs: loaded.hostInputs,
+            manifest,
+            plugins: loaded.nativePlugins.map((plugin) => ({
+                binary: plugin.binary,
+                capabilities: Object.fromEntries(Object.entries(plugin.capabilities ?? {}).map(([name, declared]) => [name, declared === true])),
+                source: plugin.source,
+            })),
+            projectContext: wantsContext
+                ? (0, createNativeProjectContextArgs_1.createNativeProjectContextJson)(loaded.project)
+                : null,
+        };
+        (0, capabilityResolutionCache_1.writeCapabilityResolution)({ cwd, tsconfig, version }, answer);
+        return select(answer, options.capability);
+    }
+    catch {
+        // A project whose plugin configuration does not load is a project the user
+        // already sees an error for, from the command that compiles it. Failing here
+        // would turn "your lint config has a typo" into "the graph is broken", and
+        // the caller's own degraded answer is the honest one.
+        return [];
+    }
+}
+/** The declaring plugins, from a resolution however it was obtained. */
+function select(resolution, capability) {
+    return resolution.plugins
+        .filter((plugin) => plugin.binary !== "" && plugin.capabilities[capability] === true)
+        .map((plugin) => ({
+        binary: plugin.binary,
+        manifest: resolution.manifest,
+        ...(plugin.capabilities.projectContextArgs === true &&
+            resolution.projectContext !== null
+            ? { projectContext: resolution.projectContext }
+            : {}),
+    }));
+}
+/**
+ * This build, as the resolution cache's key material.
+ *
+ * A ttsc upgrade can change what discovery finds — a new descriptor field, a
+ * different resolution order — so an entry written by another build is not this
+ * build's answer.
+ */
+const version = (() => {
+    try {
+        const manifest = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.resolve(__dirname, "..", "..", "package.json"), "utf8"));
+        return typeof manifest.version === "string" ? manifest.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+})();
+//# sourceMappingURL=resolveCapabilityPlugins.js.map

package/lib/plugin/resolveCapabilityPlugins.js.map

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

package/lib/structures/ITtscCompilerTransformation.d.ts

@@ -118,6 +118,13 @@ export declare namespace ITtscCompilerTransformation {
          * declares completeness should stamp {@link graph} too; without it a listed
          * file retains no universal input at all.
          *
+         * Ttsc's own hosts stamp it for what they can prove: their source-to-source
+         * output is a syntactic re-print, so the built-in native host and the
+         * linked-plugin host list a file once every linked plugin able to
+         * contribute to it has declared its own contribution complete — which,
+         * where no plugin is active at all, is every file. An executable sidecar
+         * prints its own envelope and decides for itself.
+         *
          * Optional, and never required for correctness: an envelope without this
          * field keeps the sound host-owned bound. A file that is both listed here
          * and in {@link volatile} keeps the union, since the two claims contradict

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ttsc",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "General-purpose TypeScript-Go compiler, runtime, plugin host, and LSP host.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -43,13 +43,13 @@
     "typescript": "^7.0.2"
   },
   "optionalDependencies": {
-    "@ttsc/linux-x64": "0.27.0",
-    "@ttsc/linux-arm64": "0.27.0",
-    "@ttsc/darwin-arm64": "0.27.0",
-    "@ttsc/darwin-x64": "0.27.0",
-    "@ttsc/linux-arm": "0.27.0",
-    "@ttsc/win32-arm64": "0.27.0",
-    "@ttsc/win32-x64": "0.27.0"
+    "@ttsc/linux-arm": "0.28.0",
+    "@ttsc/darwin-x64": "0.28.0",
+    "@ttsc/linux-x64": "0.28.0",
+    "@ttsc/win32-x64": "0.28.0",
+    "@ttsc/win32-arm64": "0.28.0",
+    "@ttsc/darwin-arm64": "0.28.0",
+    "@ttsc/linux-arm64": "0.28.0"
   },
   "sideEffects": [
     "./lib/register.js",

package/shim/ast/parent.go

@@ -6,9 +6,17 @@ import innerast "github.com/microsoft/typescript-go/internal/ast"
 // its containing node.
 //
 // A transform that splices freshly built (synthetic) nodes onto a SourceFile
-// must call this before emit: passes that walk parents — e.g. the emit
-// resolver's reference marking (MarkLinkedReferencesRecursively) — dereference
-// Parent and would hit nil on a synthetic node otherwise.
+// must call this before emit, because the passes that then walk the spliced tree
+// dereference Parent and would hit nil on a synthetic node. The printer is the
+// example that holds up: getContainingNodeArray reads node.Parent unguarded for
+// a parameter, template span, decorator, and heritage clause.
+//
+// Two earlier examples were dropped rather than the rule. The emit resolver's
+// reference marking no longer walks the spliced tree at all in ttsc's plugin
+// emit lane, which builds the builtin chain from the parse tree (see
+// driver.EmitWithPluginTransformers). The module transform's own Parent reads
+// carry upstream //nolint:customlint notes saying they deliberately inspect
+// parse-tree parents.
 func SetParentInChildren(node *Node) {
   innerast.SetParentInChildren(node)
 }
@@ -20,6 +28,11 @@ func SetParentInChildren(node *Node) {
 // kept verbatim while sibling statements were rewritten) makes tsgo's
 // runtime-syntax/printer mis-resolve the declaration and drop it from emit.
 // Only freshly built (synthetic) nodes need a parent wired, and those start nil.
+//
+// This is the form ttsc's plugin emit lane calls. How much it currently carries
+// is unproven: stubbing the call out leaves the whole driver suite green, which
+// measures the suite's coverage of parent-dependent emit rather than the hazard.
+// Keep it for the reason above, not on the strength of a failing test.
 func SetParentInChildrenUnset(node *Node) {
   node.ForEachChild(func(child *Node) bool {
     if child.Parent == nil {

package/shim/checker/enums_gen.go

@@ -77,6 +77,17 @@ const (
   ObjectFlagsSingleSignatureType                        = innerchecker.ObjectFlagsSingleSignatureType
   ObjectFlagsTuple                                      = innerchecker.ObjectFlagsTuple
   ObjectFlagsUnresolvedMembers                          = innerchecker.ObjectFlagsUnresolvedMembers
+  SignatureFlagsCallChainFlags                          = innerchecker.SignatureFlagsCallChainFlags
+  SignatureFlagsConstruct                               = innerchecker.SignatureFlagsConstruct
+  SignatureFlagsHasLiteralTypes                         = innerchecker.SignatureFlagsHasLiteralTypes
+  SignatureFlagsHasRestParameter                        = innerchecker.SignatureFlagsHasRestParameter
+  SignatureFlagsIsInnerCallChain                        = innerchecker.SignatureFlagsIsInnerCallChain
+  SignatureFlagsIsNonInferrable                         = innerchecker.SignatureFlagsIsNonInferrable
+  SignatureFlagsIsOuterCallChain                        = innerchecker.SignatureFlagsIsOuterCallChain
+  SignatureFlagsIsSignatureCandidateForOverloadFailure  = innerchecker.SignatureFlagsIsSignatureCandidateForOverloadFailure
+  SignatureFlagsIsUntypedSignatureInJSFile              = innerchecker.SignatureFlagsIsUntypedSignatureInJSFile
+  SignatureFlagsNone                                    = innerchecker.SignatureFlagsNone
+  SignatureFlagsPropagatingFlags                        = innerchecker.SignatureFlagsPropagatingFlags
   SignatureKindConstruct                                = innerchecker.SignatureKindConstruct
   TypeFlagsAnyOrUnknown                                 = innerchecker.TypeFlagsAnyOrUnknown
   TypeFlagsBigInt                                       = innerchecker.TypeFlagsBigInt

package/shim/checker/shim.go

@@ -20,6 +20,7 @@ import (
 type Checker = innerchecker.Checker
 type IndexInfo = innerchecker.IndexInfo
 type Signature = innerchecker.Signature
+type SignatureFlags = innerchecker.SignatureFlags
 type SignatureKind = innerchecker.SignatureKind
 type Type = innerchecker.Type
 type TypeMapper = innerchecker.TypeMapper
@@ -216,6 +217,8 @@ func Checker_isSymbolAccessibleAsValue(recv *innerchecker.Checker, symbol *inner
 }
 
 const (
+  SignatureFlagsAbstract = innerchecker.SignatureFlagsAbstract
+
   SignatureKindCall = innerchecker.SignatureKindCall
 
   TypeMapperKindUnknown = innerchecker.TypeMapperKindUnknown

package/shim/compiler/emithook.go

@@ -18,5 +18,15 @@ import (
 // (type-erase, import-elision, runtime-syntax, module-transform, ...) for one
 // source file, linked from the internal package via go:linkname.
 //
+// `sourceFile` is the marking target, not the file that gets transformed.
+// Upstream reads it for two per-file constants (in-JS-file, JSX language
+// variant) and then hands it to emitResolver.MarkLinkedReferencesRecursively,
+// whose marks the import-elision transformer later reads back through
+// EmitContext.ParseNode. A caller that runs a plugin pass first must therefore
+// pass the PARSE tree here and the transformed tree to TransformSourceFile;
+// upstream's own emitter passes one file to both only because it has nothing in
+// between. Re-check this when the pin moves: a new use of the parameter inside
+// getScriptTransformers could make the two roles diverge further.
+//
 //go:linkname GetScriptTransformers github.com/microsoft/typescript-go/internal/compiler.getScriptTransformers
 func GetScriptTransformers(emitContext *innerprinter.EmitContext, host innerprinter.EmitHost, sourceFile *innerast.SourceFile) []*innertransformers.Transformer

package/src/compiler/internal/project/createNativeProjectContextArgs.ts

@@ -7,9 +7,24 @@ export function createNativeProjectContextArgs(
 ): string[] {
   return [
     "--project-context-json=" +
-      JSON.stringify({
-        ...project.identity,
-        ...(pluginConfigOrigin === undefined ? {} : { pluginConfigOrigin }),
-      }),
+      createNativeProjectContextJson(project, pluginConfigOrigin),
   ];
 }
+
+/**
+ * The identity payload itself, for a caller that spawns a sidecar without going
+ * through the compiler's own argument list.
+ *
+ * Split from the flag so there is still exactly one place that decides what a
+ * sidecar is told about the project. A second caller assembling the same JSON,
+ * or slicing it back out of the flag, is how the two drift.
+ */
+export function createNativeProjectContextJson(
+  project: ITtscParsedProjectConfig,
+  pluginConfigOrigin?: string,
+): string {
+  return JSON.stringify({
+    ...project.identity,
+    ...(pluginConfigOrigin === undefined ? {} : { pluginConfigOrigin }),
+  });
+}

package/src/index.ts

@@ -7,6 +7,7 @@
  * package surface remains small and stable.
  */
 
+export * from "./plugin/resolveCapabilityPlugins";
 export * from "./TtscCompiler";
 export * from "./TtscService";
 export * from "./structures/index";

package/src/launcher/internal/runtimeHooks.ts

@@ -274,8 +274,16 @@ export interface RuntimeHookOptions {
  * `require()` made from inside a CommonJS module that was itself reached
  * through an ESM `import` (the interop translator loads it on the raw CJS
  * path). The ESM graph goes through `registerHooks`; the CommonJS `require`
- * graph goes through `Module._extensions` — the canonical loader extension
- * point `ts-node`/`tsx` use for the same reason.
+ * graph goes through `Module._extensions` and `Module._resolveFilename` — the
+ * canonical loader extension points `ts-node`/`tsx` use for the same reason.
+ *
+ * Both halves of that second graph are required, and they answer different
+ * questions. `_extensions` decides how a file that was _found_ is compiled, and
+ * Node reuses its keys when it probes an extensionless request, so
+ * `require("./x")` reaches `x.ts` for free. Nothing there resolves a request
+ * that already carries an extension: `require("./x.js")` backed only by `x.ts`
+ * is a resolution failure before any compiler is consulted, which is why the
+ * rescue is installed on `_resolveFilename` as well (samchon/ttsc#1280).
  */
 export function installRuntimeHooks(options: RuntimeHookOptions = {}): void {
   if (options.prepareEntry !== undefined) {
@@ -295,6 +303,7 @@ export function installRuntimeHooks(options: RuntimeHookOptions = {}): void {
   }
   registerHooks({ load, resolve });
   installCommonJsHook();
+  installCommonJsResolveHook();
 }
 
 /**
@@ -339,6 +348,106 @@ function installCommonJsHook(): void {
   }
 }
 
+/**
+ * Map a JavaScript spelling back to its TypeScript source on the CommonJS
+ * resolution path, so `require("./x.js")` finds `x.ts` when nothing emitted
+ * `x.js`.
+ *
+ * TypeScript asks authors to write the emitted `.js` extension in a relative
+ * specifier, so this spelling is the documented one rather than a mistake, and
+ * the ESM `resolve` hook has always rescued it. The CommonJS graph could not,
+ * and on Node 22 that graph is reached by every `require()` inside a CommonJS
+ * module the ESM loader evaluated — `module.registerHooks` sees the `import()`
+ * of that module and nothing within it. Node 24 routes the same `require`
+ * through the hooks, which is why the gap was only ever visible on the oldest
+ * runtime ttsx supports (`engines.node` is `>=22.15.0`).
+ *
+ * The wrapper only ever answers a request Node's own resolver already refused,
+ * so a resolution that succeeds is never perturbed, and a request no candidate
+ * satisfies rethrows Node's original error with its `MODULE_NOT_FOUND` code and
+ * `requireStack` intact. `require.resolve` shares this entry point and is
+ * rescued with it, except in its `{ paths }` form, which resolves against the
+ * caller's list rather than the parent this reads.
+ */
+function installCommonJsResolveHook(): void {
+  const internals = Module as unknown as {
+    _resolveFilename(
+      request: string,
+      parent: { filename?: string | null } | null | undefined,
+      isMain: boolean,
+      options?: unknown,
+    ): string;
+  };
+  const original = internals._resolveFilename;
+  internals._resolveFilename = function resolveFilename(
+    this: unknown,
+    request: string,
+    parent: { filename?: string | null } | null | undefined,
+    isMain: boolean,
+    options?: unknown,
+  ): string {
+    try {
+      return original.call(this, request, parent, isMain, options);
+    } catch (error) {
+      const rescued = rescueCommonJsRequest(request, parent, options);
+      if (rescued === null) {
+        throw error;
+      }
+      return rescued;
+    }
+  };
+}
+
+/**
+ * The TypeScript source a refused CommonJS request names, or `null`.
+ *
+ * Only a relative or absolute request can be rescued: a bare specifier is a
+ * package lookup, whose own resolver already probed every extension the
+ * installed `_extensions` keys declare.
+ *
+ * Two shapes decline before that. `_resolveFilename` is an internal entry point
+ * anything may call, so a non-string request reaches here as readily as a
+ * specifier does, and reading it would replace Node's own argument error with a
+ * `TypeError` from this file. And `require.resolve(request, { paths })`
+ * resolves against the caller's list, which this rescue does not consult, so
+ * answering it from the parent's directory would be a different question's
+ * answer.
+ */
+function rescueCommonJsRequest(
+  request: string,
+  parent: { filename?: string | null } | null | undefined,
+  options?: unknown,
+): string | null {
+  if (typeof request !== "string") {
+    return null;
+  }
+  if (
+    typeof options === "object" &&
+    options !== null &&
+    Array.isArray((options as { paths?: unknown }).paths)
+  ) {
+    return null;
+  }
+  let base: string;
+  if (path.isAbsolute(request)) {
+    base = request;
+  } else if (isRelativeSpecifier(request)) {
+    const from = parent?.filename;
+    if (typeof from !== "string") {
+      return null;
+    }
+    base = path.resolve(path.dirname(from), request);
+  } else {
+    return null;
+  }
+  for (const candidate of typescriptSourcesForJavaScriptSpecifier(base)) {
+    if (isFile(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+
 /**
  * The module format of the entry source file, derived from the entry project's
  * compiler options (via the runtime manifest) the same way the served files are