ttsc 0.18.4 → 0.19.0

package/src/plugin/internal/loadProjectPlugins.ts

@@ -48,7 +48,12 @@ type PackageManifest = {
  * @param options.cwd - Working directory for resolving relative paths.
  * @param options.entries - Explicit plugin entries; `false` disables all
  *   plugins (skips both tsconfig entries and package auto-discovery).
+ * @param options.env - Effective environment for source-plugin builds and the
+ *   `ttsx` descriptor child (`{ ...process.env, ...context.env }`). Defaults to
+ *   `process.env` for CLI callers, so ambient behavior is unchanged.
  * @param options.file - Path to the tsconfig/jsconfig file.
+ * @param options.pluginConfigDir - Caller-declared anchor for plugin
+ *   config-file discovery (see `ITtscPluginFactoryContext.pluginConfigDir`).
  * @param options.projectRoot - Override the project root directory.
  * @param options.tsconfig - Alias for `file`.
  */
@@ -57,13 +62,16 @@ export function loadProjectPlugins(options: {
   cacheDir?: string;
   cwd?: string;
   entries?: readonly ITtscProjectPluginConfig[] | false;
+  env?: NodeJS.ProcessEnv;
   file?: string;
+  pluginConfigDir?: string;
   projectRoot?: string;
   tsconfig?: string;
 }): {
   nativePlugins: ITtscLoadedNativePlugin[];
   project: ITtscParsedProjectConfig;
 } {
+  const effectiveEnv = options.env ?? process.env;
   const project = readProjectConfig({
     cwd: options.cwd,
     file: options.file,
@@ -83,9 +91,13 @@ export function loadProjectPlugins(options: {
     };
   }
 
+  const cwd = path.resolve(options.cwd ?? process.cwd());
   const context = {
     binary: options.binary,
-    cwd: path.resolve(options.cwd ?? process.cwd()),
+    cwd,
+    ...(options.pluginConfigDir === undefined || options.pluginConfigDir === ""
+      ? {}
+      : { pluginConfigDir: path.resolve(cwd, options.pluginConfigDir) }),
     projectRoot: project.root,
     tsconfig: project.path,
   };
@@ -96,6 +108,7 @@ export function loadProjectPlugins(options: {
         entry.config,
         { ...context, plugin: entry.config },
         entry.baseDir,
+        effectiveEnv,
       ),
     ),
   );
@@ -156,6 +169,7 @@ export function loadProjectPlugins(options: {
         baseDir: context.projectRoot,
         cacheDir: options.cacheDir,
         contributors: mergeContributors(record.contributors, hostContributors),
+        env: effectiveEnv,
         pluginName: record.label,
         source: record.source,
         ttscVersion,
@@ -169,6 +183,7 @@ export function loadProjectPlugins(options: {
           baseDir: context.projectRoot,
           cacheDir: options.cacheDir,
           contributors: linkedContributors,
+          env: effectiveEnv,
           label: "linked plugin host",
           pluginName: "linked-plugin-host",
           source: path.join(ttscPackageRoot(), "cmd", "utility-host"),
@@ -190,6 +205,7 @@ export function loadProjectPlugins(options: {
               baseDir: context.projectRoot,
               cacheDir: options.cacheDir,
               contributors: record.contributors,
+              env: effectiveEnv,
               pluginName: record.label,
               source: record.source,
               ttscVersion,
@@ -572,6 +588,7 @@ function loadPluginEntry(
   entry: ITtscProjectPluginConfig,
   base: Omit<ITtscPluginFactoryContext, "dirname" | "filename">,
   baseDir: string,
+  effectiveEnv: NodeJS.ProcessEnv,
 ): ITtscPlugin {
   return withPluginLoaderEnv(() => {
     const specifier = entry.transform;
@@ -592,7 +609,7 @@ function loadPluginEntry(
       dirname: path.dirname(request),
       filename: request,
     };
-    const mod = requirePluginEntry(request, context) as {
+    const mod = requirePluginEntry(request, context, effectiveEnv) as {
       createTtscPlugin?: TtscPluginFactory;
       default?: ITtscPlugin | TtscPluginFactory;
     } & Partial<Record<"plugin", ITtscPlugin | TtscPluginFactory>>;
@@ -639,6 +656,7 @@ function loadPluginEntry(
 function requirePluginEntry(
   request: string,
   context: ITtscPluginFactoryContext,
+  effectiveEnv: NodeJS.ProcessEnv,
 ): unknown {
   try {
     return require(request);
@@ -646,7 +664,7 @@ function requirePluginEntry(
     if (!TS_SOURCE_PATTERN.test(request)) {
       throw error;
     }
-    const descriptor = loadDescriptorViaTtsx(request, context);
+    const descriptor = loadDescriptorViaTtsx(request, context, effectiveEnv);
     if (descriptor === undefined) {
       throw error;
     }
@@ -666,9 +684,16 @@ const TS_SOURCE_PATTERN = /\.(?:[cm]?ts|tsx)$/i;
 function loadDescriptorViaTtsx(
   request: string,
   context: ITtscPluginFactoryContext,
+  effectiveEnv: NodeJS.ProcessEnv,
 ): unknown {
-  const node = process.env.TTSC_NODE_BINARY ?? process.execPath;
-  const ttsx = process.env.TTSC_TTSX_BINARY;
+  // Binary discovery prefers the instance environment, then the ambient
+  // process.env (where `withPluginLoaderEnv` injects ttsc's own node/ttsx paths
+  // just before this runs), then the running interpreter.
+  const node =
+    effectiveEnv.TTSC_NODE_BINARY ??
+    process.env.TTSC_NODE_BINARY ??
+    process.execPath;
+  const ttsx = effectiveEnv.TTSC_TTSX_BINARY ?? process.env.TTSC_TTSX_BINARY;
   if (ttsx === undefined || ttsx.length === 0) {
     return undefined;
   }
@@ -708,7 +733,12 @@ function loadDescriptorViaTtsx(
       cwd: context.projectRoot,
       encoding: "utf8",
       env: {
-        ...process.env,
+        ...effectiveEnv,
+        // Carry ttsc's own node/ttsx locators explicitly so the child (which
+        // may recurse into further descriptor loads) finds them even when the
+        // instance-env snapshot predates `withPluginLoaderEnv`.
+        TTSC_NODE_BINARY: node,
+        TTSC_TTSX_BINARY: ttsx,
         TTSC_PLUGIN_CONTEXT: JSON.stringify({
           binary: context.binary,
           cwd: context.cwd,

package/src/structures/ITtscCompilerContext.ts

@@ -46,6 +46,21 @@ export interface ITtscCompilerContext {
    */
   projectRoot?: string;
 
+  /**
+   * Directory that anchors plugin config-file discovery and relative
+   * `configFile` resolution.
+   *
+   * Leave this unset so plugins anchor at the directory of the resolved
+   * {@link ITtscCompilerContext.tsconfig} as usual. Embedders that compile
+   * through a generated tsconfig outside the project (the bundler adapters'
+   * alias overlay, for example) set it to the real project directory; ttsc
+   * forwards the value to every plugin process as `TTSC_PLUGIN_CONFIG_DIR`, so
+   * `banner.config.*` / `strip.config.*` / `lint.config.*` discovery walks the
+   * project instead of the generated tsconfig's temp-dir ancestry. Relative
+   * paths are resolved from {@link ITtscCompilerContext.cwd}.
+   */
+  pluginConfigDir?: string;
+
   /**
    * Explicit TypeScript-Go executable for controlled embedding.
    *
@@ -74,8 +89,8 @@ export interface ITtscCompilerContext {
    *
    * Relative paths are resolved from {@link ITtscCompilerContext.cwd}. When
    * omitted, ttsc uses its normal cache location: `TTSC_CACHE_DIR` when
-   * present, otherwise the user-level ttsc cache shared by projects on the same
-   * machine.
+   * present, otherwise the project-local cache at the workspace root's
+   * `node_modules/.cache/ttsc`. ttsc keeps no machine-global cache.
    *
    * The same cache stores source-plugin binaries and the lazily built native
    * compiler host used for in-memory API compilation.

package/src/structures/ITtscPluginCapabilities.ts

@@ -37,6 +37,15 @@ export interface ITtscPluginCapabilities {
    */
   lsp?: boolean;
 
+  /**
+   * Whether the sidecar accepts ttsc's `--project-context-json` identity
+   * protocol. The payload keeps lexical selection paths, physical Program
+   * paths, and explicit overrides as separate fields.
+   *
+   * @default false
+   */
+  projectContextArgs?: boolean;
+
   /**
    * Whether the sidecar accepts `--singleThreaded` and `--checkers` on its
    * command line. The lint sidecar parses both flags via `parseSubcommandFlags`

package/src/structures/ITtscPluginFactoryContext.ts

@@ -66,6 +66,21 @@ export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
    */
   plugin: T;
 
+  /**
+   * Caller-declared anchor for plugin config-file discovery and relative
+   * `configFile` resolution.
+   *
+   * Absent for ordinary invocations, where a factory anchors config discovery
+   * at the {@link ITtscPluginFactoryContext.tsconfig} directory. Present when
+   * the embedder compiles through a generated tsconfig outside the project (the
+   * bundler adapters' alias overlay): it names the real project directory, and
+   * a factory that discovers its own config file should anchor there instead of
+   * the generated tsconfig's temp-dir ancestry. Mirrors the
+   * `TTSC_PLUGIN_CONFIG_DIR` environment variable ttsc sets for native plugin
+   * processes.
+   */
+  pluginConfigDir?: string;
+
   /**
    * Project root used as the native plugin working directory and package
    * discovery base.

package/src/structures/internal/ITtscParsedProjectConfig.ts

@@ -1,4 +1,5 @@
 import type { ITtscProjectPluginConfig } from "../ITtscProjectPluginConfig";
+import type { ITtscProjectIdentity } from "./ITtscProjectIdentity";
 
 /** Resolved project config subset used inside the ttsc host. */
 export interface ITtscParsedProjectConfig {
@@ -9,6 +10,8 @@ export interface ITtscParsedProjectConfig {
     /** Project plugin entries after inheritance resolution. */
     plugins: ITtscProjectPluginConfig[];
   } & Record<string, unknown>;
+  /** Lexical and physical identities retained for native plugin contexts. */
+  identity: Omit<ITtscProjectIdentity, "pluginConfigOrigin">;
   /** Absolute path to the resolved tsconfig/jsconfig. */
   path: string;
   /** Directory that declared each inherited plugin entry. */

package/src/structures/internal/ITtscProjectIdentity.ts

@@ -0,0 +1,17 @@
+/** Separate lexical and physical identities for one selected project. */
+export interface ITtscProjectIdentity {
+  /** Caller working directory before filesystem canonicalization. */
+  invocationCwd: string;
+  /** Caller-selected config spelling before filesystem canonicalization. */
+  logicalConfigPath: string;
+  /** Directory containing the caller-selected config spelling. */
+  logicalProjectRoot: string;
+  /** Realpath-resolved config used to load the TypeScript Program. */
+  physicalConfigPath: string;
+  /** Realpath-resolved root supplied to the TypeScript Program host. */
+  physicalProjectRoot: string;
+  /** Caller-declared project-root override, when present. */
+  explicitProjectRoot?: string;
+  /** Caller-declared plugin-config discovery origin, when present. */
+  pluginConfigOrigin?: string;
+}

package/src/structures/internal/TtscCommonOptions.ts

@@ -16,6 +16,14 @@ export interface TtscCommonOptions {
   cwd?: string;
   /** Project root override for generated tsconfig wrappers. */
   projectRoot?: string;
+  /**
+   * Directory that anchors plugin config-file discovery and relative
+   * `configFile` resolution (forwarded to plugin processes as
+   * `TTSC_PLUGIN_CONFIG_DIR`). Set by build integrations that compile through a
+   * generated tsconfig outside the project; when omitted, plugins anchor at the
+   * tsconfig's own directory.
+   */
+  pluginConfigDir?: string;
   /** Environment variables merged over `process.env` for child processes. */
   env?: NodeJS.ProcessEnv;
   /** Explicit root directory for compiled source-plugin cache artifacts. */

package/tools/shim_audit/baseline.json

@@ -1,5 +1,5 @@
 {
-  "note": "Accepted TIER-2 (reachable funcs) and TIER-3 (escaping types) shim gaps. The gate fails on any gap NOT listed here; expose a symbol and remove its line, or run -write-baseline to accept new ones deliberately. TIER-1 enum gaps are never listed — they are zero-tolerance (run -fix).",
+  "note": "Accepted TIER-2 (reachable funcs) and TIER-3 (escaping types) shim gaps. The gate fails on any gap NOT listed here; expose a symbol and remove its line, or run -write-baseline to accept new ones deliberately. TIER-1 enum and PRODUCER gaps are zero-tolerance; producer_exemptions must name genuine roots or ownership boundaries with non-empty rationales.",
   "accepted": [
     "ESCAPE|checker|ConditionalType",
     "ESCAPE|checker|ConstrainedType",
@@ -18,7 +18,6 @@
     "ESCAPE|checker|NodeBuilder",
     "ESCAPE|checker|NodeBuilderContext",
     "ESCAPE|checker|ObjectType",
-    "ESCAPE|checker|Program",
     "ESCAPE|checker|ReverseMappedType",
     "ESCAPE|checker|SignatureFlags",
     "ESCAPE|checker|StringMappingType",
@@ -27,7 +26,6 @@
     "ESCAPE|checker|SymbolFormatFlags",
     "ESCAPE|checker|SymbolTrackerImpl",
     "ESCAPE|checker|TemplateLiteralType",
-    "ESCAPE|checker|Tracer",
     "ESCAPE|checker|TupleType",
     "ESCAPE|checker|TypeFormatFlags",
     "ESCAPE|checker|TypeId",
@@ -93,7 +91,6 @@
     "FUNC|ast|GetAssignmentTarget",
     "FUNC|ast|GetBinaryOperatorPrecedence",
     "FUNC|ast|GetClassLikeDeclarationOfSymbol",
-    "FUNC|ast|GetCombinedModifierFlags",
     "FUNC|ast|GetContainingClass",
     "FUNC|ast|GetContainingFunction",
     "FUNC|ast|GetDeclarationContainer",
@@ -237,7 +234,6 @@
     "FUNC|ast|IsComputedPropertyName",
     "FUNC|ast|IsConditionalExpression",
     "FUNC|ast|IsConditionalTypeNode",
-    "FUNC|ast|IsConstAssertion",
     "FUNC|ast|IsConstTypeReference",
     "FUNC|ast|IsConstructSignatureDeclaration",
     "FUNC|ast|IsConstructorDeclaration",
@@ -498,7 +494,6 @@
     "FUNC|ast|IsParseTreeNode",
     "FUNC|ast|IsPartOfExclusivelyTypeOnlyImportOrExportDeclaration",
     "FUNC|ast|IsPartOfParameterDeclaration",
-    "FUNC|ast|IsPartOfTypeNode",
     "FUNC|ast|IsPartOfTypeOnlyImportOrExportDeclaration",
     "FUNC|ast|IsPartOfTypeQuery",
     "FUNC|ast|IsPartiallyEmittedExpression",
@@ -701,5 +696,19 @@
     "FUNC|transformers|IsOriginalNodeSingleLine",
     "FUNC|transformers|MoveRangePastDecorators",
     "FUNC|transformers|MoveRangePastModifiers"
-  ]
+  ],
+  "producer_exemptions": {
+    "ast.FileReference": "File references are caller-owned value records and are also available from parser-produced SourceFile directive fields.",
+    "checker.Tracer": "NewChecker accepts nil when tracing is disabled; a non-nil tracer is an optional host-owned facility.",
+    "checker.VerbosityContext": "Checker formatting methods accept nil for default output; non-nil verbosity state is optional caller-owned formatting context.",
+    "core.BuildOptions": "Build options are caller-owned configuration data that can be allocated through the exported type alias.",
+    "core.ParsedOptions": "SetParsedOptions is an upstream mutation hook on ParsedCommandLine; shim consumers obtain populated commands from the exported parse operations instead.",
+    "core.WatchOptions": "Watch options are caller-owned configuration data that can be allocated through the exported type alias.",
+    "lsp.ServerOptions": "Server options are caller-owned configuration data that can be allocated through the exported type alias.",
+    "lsp/lsproto.FileSystemWatcher": "WatchFiles receives protocol payloads owned by the LSP host; plugin callers do not construct the internal transport type.",
+    "lsp/lsproto.PublishDiagnosticsParams": "PublishDiagnostics receives protocol payloads owned by the LSP host; plugin callers do not construct the internal transport type.",
+    "scanner.SkipTriviaOptions": "Trivia options are caller-owned configuration data that can be allocated through the exported type alias.",
+    "sourcemap.Generator": "Printer.Write is an upstream emit hook whose generator is compiler-owned; plugin emit uses the exported compiler and printer entry points.",
+    "tsoptions.ExtendedConfigCacheEntry": "ParseExtendedConfig accepts a nil optional cache and produces the first entry without requiring a prior cache result."
+  }
 }