@ttsc/unplugin 0.34.0 → 0.34.2

package/lib/core/options/ResolvedTtscUnpluginOptions.d.cts

@@ -39,6 +39,8 @@ export interface ResolvedTtscUnpluginOptions {
     precompile?: readonly string[];
     /** Compiler-options overlay applied on top of the discovered tsconfig. */
     compilerOptions: TtscUnpluginCompilerOptionsJson;
+    /** Explicit invocation permission; omission retains inherited arguments. */
+    runExternalCode?: boolean;
     /**
      * Resolved plugin list; mirrors the semantics of
      * `TtscUnpluginOptions.plugins`.

package/lib/core/options/ResolvedTtscUnpluginOptions.d.mts

@@ -39,6 +39,8 @@ export interface ResolvedTtscUnpluginOptions {
     precompile?: readonly string[];
     /** Compiler-options overlay applied on top of the discovered tsconfig. */
     compilerOptions: TtscUnpluginCompilerOptionsJson;
+    /** Explicit invocation permission; omission retains inherited arguments. */
+    runExternalCode?: boolean;
     /**
      * Resolved plugin list; mirrors the semantics of
      * `TtscUnpluginOptions.plugins`.

package/lib/core/options/ResolvedTtscUnpluginOptions.d.ts

@@ -39,6 +39,8 @@ export interface ResolvedTtscUnpluginOptions {
     precompile?: readonly string[];
     /** Compiler-options overlay applied on top of the discovered tsconfig. */
     compilerOptions: TtscUnpluginCompilerOptionsJson;
+    /** Explicit invocation permission; omission retains inherited arguments. */
+    runExternalCode?: boolean;
     /**
      * Resolved plugin list; mirrors the semantics of
      * `TtscUnpluginOptions.plugins`.

package/lib/core/options/TtscUnpluginOptions.d.cts

@@ -63,6 +63,14 @@ export interface TtscUnpluginOptions {
      * the explicit plugin override.
      */
     compilerOptions?: TtscUnpluginCompilerOptionsJson;
+    /**
+     * Allow the selected TypeScript 7.1 compiler to execute content mappers.
+     *
+     * This invocation's explicit value overrides inherited `TTSC_TSGO_ARGS`
+     * permission without changing `process.env`. Omission retains inherited
+     * arguments. TypeScript 7.0 rejects this option's compiler flag.
+     */
+    runExternalCode?: boolean;
     /**
      * `ttsc` plugin entries.
      *

package/lib/core/options/TtscUnpluginOptions.d.mts

@@ -63,6 +63,14 @@ export interface TtscUnpluginOptions {
      * the explicit plugin override.
      */
     compilerOptions?: TtscUnpluginCompilerOptionsJson;
+    /**
+     * Allow the selected TypeScript 7.1 compiler to execute content mappers.
+     *
+     * This invocation's explicit value overrides inherited `TTSC_TSGO_ARGS`
+     * permission without changing `process.env`. Omission retains inherited
+     * arguments. TypeScript 7.0 rejects this option's compiler flag.
+     */
+    runExternalCode?: boolean;
     /**
      * `ttsc` plugin entries.
      *

package/lib/core/options/TtscUnpluginOptions.d.ts

@@ -63,6 +63,14 @@ export interface TtscUnpluginOptions {
      * the explicit plugin override.
      */
     compilerOptions?: TtscUnpluginCompilerOptionsJson;
+    /**
+     * Allow the selected TypeScript 7.1 compiler to execute content mappers.
+     *
+     * This invocation's explicit value overrides inherited `TTSC_TSGO_ARGS`
+     * permission without changing `process.env`. Omission retains inherited
+     * arguments. TypeScript 7.0 rejects this option's compiler flag.
+     */
+    runExternalCode?: boolean;
     /**
      * `ttsc` plugin entries.
      *

package/lib/core/options/resolveOptions.d.cts

@@ -3,9 +3,10 @@ import type { TtscUnpluginOptions } from "./TtscUnpluginOptions.cjs";
 /**
  * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
  *
- * Merges provided values with defaults. The `plugins` field uses an explicit
- * `"plugins" in options` presence check rather than a falsy guard so that
- * `plugins: false` (disable all plugins) is preserved as-is.
+ * Merges provided values with defaults, preserving an explicit false mapper
+ * permission. The `plugins` field uses an explicit `"plugins" in options`
+ * presence check rather than a falsy guard so that `plugins: false` (disable
+ * all plugins) is preserved as-is.
  *
  * @evidence contracts/common.md#principled-implementation
  *   Nullish defaults normalize the overlay and project; a presence check

package/lib/core/options/resolveOptions.d.mts

@@ -3,9 +3,10 @@ import type { TtscUnpluginOptions } from "./TtscUnpluginOptions.mjs";
 /**
  * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
  *
- * Merges provided values with defaults. The `plugins` field uses an explicit
- * `"plugins" in options` presence check rather than a falsy guard so that
- * `plugins: false` (disable all plugins) is preserved as-is.
+ * Merges provided values with defaults, preserving an explicit false mapper
+ * permission. The `plugins` field uses an explicit `"plugins" in options`
+ * presence check rather than a falsy guard so that `plugins: false` (disable
+ * all plugins) is preserved as-is.
  *
  * @evidence contracts/common.md#principled-implementation
  *   Nullish defaults normalize the overlay and project; a presence check

package/lib/core/options/resolveOptions.d.ts

@@ -3,9 +3,10 @@ import type { TtscUnpluginOptions } from "./TtscUnpluginOptions";
 /**
  * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
  *
- * Merges provided values with defaults. The `plugins` field uses an explicit
- * `"plugins" in options` presence check rather than a falsy guard so that
- * `plugins: false` (disable all plugins) is preserved as-is.
+ * Merges provided values with defaults, preserving an explicit false mapper
+ * permission. The `plugins` field uses an explicit `"plugins" in options`
+ * presence check rather than a falsy guard so that `plugins: false` (disable
+ * all plugins) is preserved as-is.
  *
  * @evidence contracts/common.md#principled-implementation
  *   Nullish defaults normalize the overlay and project; a presence check

package/lib/core/options/resolveOptions.js

@@ -8,9 +8,10 @@ const defaultOptions = {
 /**
  * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
  *
- * Merges provided values with defaults. The `plugins` field uses an explicit
- * `"plugins" in options` presence check rather than a falsy guard so that
- * `plugins: false` (disable all plugins) is preserved as-is.
+ * Merges provided values with defaults, preserving an explicit false mapper
+ * permission. The `plugins` field uses an explicit `"plugins" in options`
+ * presence check rather than a falsy guard so that `plugins: false` (disable
+ * all plugins) is preserved as-is.
  *
  * @evidence contracts/common.md#principled-implementation
  *   Nullish defaults normalize the overlay and project; a presence check
@@ -42,6 +43,7 @@ function resolveOptions(options = {}) {
     return {
         precompile: options.precompile === undefined ? undefined : [...options.precompile],
         compilerOptions: { ...(options.compilerOptions ?? {}) },
+        runExternalCode: options.runExternalCode,
         plugins: "plugins" in options ? options.plugins : defaultOptions.plugins,
         project: options.project ?? defaultOptions.project,
         projectRoot: options.projectRoot ?? defaultOptions.projectRoot,

package/lib/core/options/resolveOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveOptions.js","sources":["../../../src/core/options/resolveOptions.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;AAClB,IAAA,WAAW,EAAE,SAAS;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCG;AACG,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;AACL,QAAA,UAAU,EACR,OAAO,CAAC,UAAU,KAAK,SAAS,GAAG,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QACxE,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;AACvD,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;AAClD,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;KAC/D;AACH;;;;"}
+{"version":3,"file":"resolveOptions.js","sources":["../../../src/core/options/resolveOptions.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;AAClB,IAAA,WAAW,EAAE,SAAS;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCG;AACG,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;AACL,QAAA,UAAU,EACR,OAAO,CAAC,UAAU,KAAK,SAAS,GAAG,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QACxE,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;QACvD,eAAe,EAAE,OAAO,CAAC,eAAe;AACxC,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;AAClD,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;KAC/D;AACH;;;;"}

package/lib/core/options/resolveOptions.mjs

@@ -6,9 +6,10 @@ const defaultOptions = {
 /**
  * Normalise raw user-supplied options into {@link ResolvedTtscUnpluginOptions}.
  *
- * Merges provided values with defaults. The `plugins` field uses an explicit
- * `"plugins" in options` presence check rather than a falsy guard so that
- * `plugins: false` (disable all plugins) is preserved as-is.
+ * Merges provided values with defaults, preserving an explicit false mapper
+ * permission. The `plugins` field uses an explicit `"plugins" in options`
+ * presence check rather than a falsy guard so that `plugins: false` (disable
+ * all plugins) is preserved as-is.
  *
  * @evidence contracts/common.md#principled-implementation
  *   Nullish defaults normalize the overlay and project; a presence check
@@ -40,6 +41,7 @@ function resolveOptions(options = {}) {
     return {
         precompile: options.precompile === undefined ? undefined : [...options.precompile],
         compilerOptions: { ...(options.compilerOptions ?? {}) },
+        runExternalCode: options.runExternalCode,
         plugins: "plugins" in options ? options.plugins : defaultOptions.plugins,
         project: options.project ?? defaultOptions.project,
         projectRoot: options.projectRoot ?? defaultOptions.projectRoot,

package/lib/core/options/resolveOptions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolveOptions.mjs","sources":["../../../src/core/options/resolveOptions.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;AAClB,IAAA,WAAW,EAAE,SAAS;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCG;AACG,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;AACL,QAAA,UAAU,EACR,OAAO,CAAC,UAAU,KAAK,SAAS,GAAG,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QACxE,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;AACvD,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;AAClD,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;KAC/D;AACH;;;;"}
+{"version":3,"file":"resolveOptions.mjs","sources":["../../../src/core/options/resolveOptions.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAgC;AAClD,IACA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;AAClB,IAAA,WAAW,EAAE,SAAS;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCG;AACG,SAAU,cAAc,CAC5B,OAAA,GAA+B,EAAE,EAAA;IAEjC,OAAO;AACL,QAAA,UAAU,EACR,OAAO,CAAC,UAAU,KAAK,SAAS,GAAG,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QACxE,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE;QACvD,eAAe,EAAE,OAAO,CAAC,eAAe;AACxC,QAAA,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO;AACxE,QAAA,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;AAClD,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;KAC/D;AACH;;;;"}

package/lib/core/rollup/rollupDeliveryOptions.d.cts

@@ -4,11 +4,11 @@ import type { ResolvedTtscUnpluginOptions } from "../options/ResolvedTtscUnplugi
  * the module carries into Rollup's cache (`TtscRollupDelivery`).
  *
  * The identity records alias mappings, compiler overlay, plugin payloads and
- * configured project and source-root selection. Tsconfig input state is
- * represented separately by the delivery's project record. A configured project
- * resolves under the same native cwd rule as explicit selection; it is not
- * canonicalized to a physical alias or made process-independent across
- * different cwd spellings.
+ * configured project/source-root selection and effective compiler argument
+ * transport. Tsconfig input state is represented separately by the delivery's
+ * project record. A configured project resolves under the same native cwd rule
+ * as explicit selection; it is not canonicalized to a physical alias or made
+ * process-independent across different cwd spellings.
  *
  * Compiler options, plugin payloads and alias mappings preserve their actual
  * JSON order. Their consumers can observe declaration order; the host cannot
@@ -33,4 +33,4 @@ import type { ResolvedTtscUnpluginOptions } from "../options/ResolvedTtscUnplugi
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources
  *   Acquires no handle, timer or retained state of its own.
  */
-export declare function rollupDeliveryOptions(options: ResolvedTtscUnpluginOptions, aliasPaths: Record<string, string[]>): string;
+export declare function rollupDeliveryOptions(options: ResolvedTtscUnpluginOptions, aliasPaths: Record<string, string[]>, compilerEnvironment?: NodeJS.ProcessEnv): string;

package/lib/core/rollup/rollupDeliveryOptions.d.mts

@@ -4,11 +4,11 @@ import type { ResolvedTtscUnpluginOptions } from "../options/ResolvedTtscUnplugi
  * the module carries into Rollup's cache (`TtscRollupDelivery`).
  *
  * The identity records alias mappings, compiler overlay, plugin payloads and
- * configured project and source-root selection. Tsconfig input state is
- * represented separately by the delivery's project record. A configured project
- * resolves under the same native cwd rule as explicit selection; it is not
- * canonicalized to a physical alias or made process-independent across
- * different cwd spellings.
+ * configured project/source-root selection and effective compiler argument
+ * transport. Tsconfig input state is represented separately by the delivery's
+ * project record. A configured project resolves under the same native cwd rule
+ * as explicit selection; it is not canonicalized to a physical alias or made
+ * process-independent across different cwd spellings.
  *
  * Compiler options, plugin payloads and alias mappings preserve their actual
  * JSON order. Their consumers can observe declaration order; the host cannot
@@ -33,4 +33,4 @@ import type { ResolvedTtscUnpluginOptions } from "../options/ResolvedTtscUnplugi
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources
  *   Acquires no handle, timer or retained state of its own.
  */
-export declare function rollupDeliveryOptions(options: ResolvedTtscUnpluginOptions, aliasPaths: Record<string, string[]>): string;
+export declare function rollupDeliveryOptions(options: ResolvedTtscUnpluginOptions, aliasPaths: Record<string, string[]>, compilerEnvironment?: NodeJS.ProcessEnv): string;

package/lib/core/rollup/rollupDeliveryOptions.d.ts

@@ -4,11 +4,11 @@ import type { ResolvedTtscUnpluginOptions } from "../options/ResolvedTtscUnplugi
  * the module carries into Rollup's cache (`TtscRollupDelivery`).
  *
  * The identity records alias mappings, compiler overlay, plugin payloads and
- * configured project and source-root selection. Tsconfig input state is
- * represented separately by the delivery's project record. A configured project
- * resolves under the same native cwd rule as explicit selection; it is not
- * canonicalized to a physical alias or made process-independent across
- * different cwd spellings.
+ * configured project/source-root selection and effective compiler argument
+ * transport. Tsconfig input state is represented separately by the delivery's
+ * project record. A configured project resolves under the same native cwd rule
+ * as explicit selection; it is not canonicalized to a physical alias or made
+ * process-independent across different cwd spellings.
  *
  * Compiler options, plugin payloads and alias mappings preserve their actual
  * JSON order. Their consumers can observe declaration order; the host cannot
@@ -33,4 +33,4 @@ import type { ResolvedTtscUnpluginOptions } from "../options/ResolvedTtscUnplugi
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources
  *   Acquires no handle, timer or retained state of its own.
  */
-export declare function rollupDeliveryOptions(options: ResolvedTtscUnpluginOptions, aliasPaths: Record<string, string[]>): string;
+export declare function rollupDeliveryOptions(options: ResolvedTtscUnpluginOptions, aliasPaths: Record<string, string[]>, compilerEnvironment?: NodeJS.ProcessEnv): string;

package/lib/core/rollup/rollupDeliveryOptions.js

@@ -1,6 +1,8 @@
 'use strict';
 
 var path = require('node:path');
+var compilerEnvironmentIdentity = require('../transform/tsconfig/compilerEnvironmentIdentity.js');
+var resolveCompilerEnvironment = require('../transform/tsconfig/resolveCompilerEnvironment.js');
 var hashText = require('../transform/utils/hashText.js');
 var stableStringify = require('../transform/utils/stableStringify.js');
 
@@ -9,11 +11,11 @@ var stableStringify = require('../transform/utils/stableStringify.js');
  * the module carries into Rollup's cache (`TtscRollupDelivery`).
  *
  * The identity records alias mappings, compiler overlay, plugin payloads and
- * configured project and source-root selection. Tsconfig input state is
- * represented separately by the delivery's project record. A configured project
- * resolves under the same native cwd rule as explicit selection; it is not
- * canonicalized to a physical alias or made process-independent across
- * different cwd spellings.
+ * configured project/source-root selection and effective compiler argument
+ * transport. Tsconfig input state is represented separately by the delivery's
+ * project record. A configured project resolves under the same native cwd rule
+ * as explicit selection; it is not canonicalized to a physical alias or made
+ * process-independent across different cwd spellings.
  *
  * Compiler options, plugin payloads and alias mappings preserve their actual
  * JSON order. Their consumers can observe declaration order; the host cannot
@@ -38,10 +40,11 @@ var stableStringify = require('../transform/utils/stableStringify.js');
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources
  *   Acquires no handle, timer or retained state of its own.
  */
-function rollupDeliveryOptions(options, aliasPaths) {
+function rollupDeliveryOptions(options, aliasPaths, compilerEnvironment = resolveCompilerEnvironment.resolveCompilerEnvironment(options.runExternalCode)) {
     return hashText.hashText(stableStringify.stableStringify({
         aliasPaths: JSON.stringify(aliasPaths),
         compilerOptions: JSON.stringify(options.compilerOptions),
+        compilerEnvironment: compilerEnvironmentIdentity.compilerEnvironmentIdentity(compilerEnvironment),
         plugins: JSON.stringify(options.plugins),
         project: options.project === undefined ? null : path.resolve(options.project),
         projectRoot: options.projectRoot === undefined

package/lib/core/rollup/rollupDeliveryOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"rollupDeliveryOptions.js","sources":["../../../src/core/rollup/rollupDeliveryOptions.ts"],"sourcesContent":[null],"names":["hashText","stableStringify"],"mappings":";;;;;;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCG;AACG,SAAU,qBAAqB,CACnC,OAAoC,EACpC,UAAoC,EAAA;IAEpC,OAAOA,iBAAQ,CACbC,+BAAe,CAAC;AACd,QAAA,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;QACtC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC;QACxD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;QACxC,OAAO,EACL,OAAO,CAAC,OAAO,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;AACtE,QAAA,WAAW,EACT,OAAO,CAAC,WAAW,KAAK;AACtB,cAAE;cACA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;AACxC,KAAA,CAAC,CACH;AACH;;;;"}
+{"version":3,"file":"rollupDeliveryOptions.js","sources":["../../../src/core/rollup/rollupDeliveryOptions.ts"],"sourcesContent":[null],"names":["resolveCompilerEnvironment","hashText","stableStringify","compilerEnvironmentIdentity"],"mappings":";;;;;;;;AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCG;AACG,SAAU,qBAAqB,CACnC,OAAoC,EACpC,UAAoC,EACpC,mBAAmB,GAAGA,qDAA0B,CAAC,OAAO,CAAC,eAAe,CAAC,EAAA;IAEzE,OAAOC,iBAAQ,CACbC,+BAAe,CAAC;AACd,QAAA,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;QACtC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC;AACxD,QAAA,mBAAmB,EAAEC,uDAA2B,CAAC,mBAAmB,CAAC;QACrE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;QACxC,OAAO,EACL,OAAO,CAAC,OAAO,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;AACtE,QAAA,WAAW,EACT,OAAO,CAAC,WAAW,KAAK;AACtB,cAAE;cACA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;AACxC,KAAA,CAAC,CACH;AACH;;;;"}

package/lib/core/rollup/rollupDeliveryOptions.mjs

@@ -1,4 +1,6 @@
 import path from 'node:path';
+import { compilerEnvironmentIdentity } from '../transform/tsconfig/compilerEnvironmentIdentity.mjs';
+import { resolveCompilerEnvironment } from '../transform/tsconfig/resolveCompilerEnvironment.mjs';
 import { hashText } from '../transform/utils/hashText.mjs';
 import { stableStringify } from '../transform/utils/stableStringify.mjs';
 
@@ -7,11 +9,11 @@ import { stableStringify } from '../transform/utils/stableStringify.mjs';
  * the module carries into Rollup's cache (`TtscRollupDelivery`).
  *
  * The identity records alias mappings, compiler overlay, plugin payloads and
- * configured project and source-root selection. Tsconfig input state is
- * represented separately by the delivery's project record. A configured project
- * resolves under the same native cwd rule as explicit selection; it is not
- * canonicalized to a physical alias or made process-independent across
- * different cwd spellings.
+ * configured project/source-root selection and effective compiler argument
+ * transport. Tsconfig input state is represented separately by the delivery's
+ * project record. A configured project resolves under the same native cwd rule
+ * as explicit selection; it is not canonicalized to a physical alias or made
+ * process-independent across different cwd spellings.
  *
  * Compiler options, plugin payloads and alias mappings preserve their actual
  * JSON order. Their consumers can observe declaration order; the host cannot
@@ -36,10 +38,11 @@ import { stableStringify } from '../transform/utils/stableStringify.mjs';
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources
  *   Acquires no handle, timer or retained state of its own.
  */
-function rollupDeliveryOptions(options, aliasPaths) {
+function rollupDeliveryOptions(options, aliasPaths, compilerEnvironment = resolveCompilerEnvironment(options.runExternalCode)) {
     return hashText(stableStringify({
         aliasPaths: JSON.stringify(aliasPaths),
         compilerOptions: JSON.stringify(options.compilerOptions),
+        compilerEnvironment: compilerEnvironmentIdentity(compilerEnvironment),
         plugins: JSON.stringify(options.plugins),
         project: options.project === undefined ? null : path.resolve(options.project),
         projectRoot: options.projectRoot === undefined

package/lib/core/rollup/rollupDeliveryOptions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rollupDeliveryOptions.mjs","sources":["../../../src/core/rollup/rollupDeliveryOptions.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCG;AACG,SAAU,qBAAqB,CACnC,OAAoC,EACpC,UAAoC,EAAA;IAEpC,OAAO,QAAQ,CACb,eAAe,CAAC;AACd,QAAA,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;QACtC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC;QACxD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;QACxC,OAAO,EACL,OAAO,CAAC,OAAO,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;AACtE,QAAA,WAAW,EACT,OAAO,CAAC,WAAW,KAAK;AACtB,cAAE;cACA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;AACxC,KAAA,CAAC,CACH;AACH;;;;"}
+{"version":3,"file":"rollupDeliveryOptions.mjs","sources":["../../../src/core/rollup/rollupDeliveryOptions.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCG;AACG,SAAU,qBAAqB,CACnC,OAAoC,EACpC,UAAoC,EACpC,mBAAmB,GAAG,0BAA0B,CAAC,OAAO,CAAC,eAAe,CAAC,EAAA;IAEzE,OAAO,QAAQ,CACb,eAAe,CAAC;AACd,QAAA,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;QACtC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC;AACxD,QAAA,mBAAmB,EAAE,2BAA2B,CAAC,mBAAmB,CAAC;QACrE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;QACxC,OAAO,EACL,OAAO,CAAC,OAAO,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;AACtE,QAAA,WAAW,EACT,OAAO,CAAC,WAAW,KAAK;AACtB,cAAE;cACA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;AACxC,KAAA,CAAC,CACH;AACH;;;;"}

package/lib/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.d.cts

@@ -0,0 +1,10 @@
+import type { TtscCompilerMembershipHint } from "../generation/TtscCompilerMembershipHint.cjs";
+import type { TtscTransformCache } from "./TtscTransformCache.cjs";
+/**
+ * Qualified native root hint per invocation key, retained across generation
+ * disposal. Its config-policy basis must match before priming a new walk;
+ * neither the match nor report proves current filesystem state. Entries live
+ * until the cache is collected; distinct invocation keys and their path bytes
+ * have no independent cap.
+ */
+export declare const TRANSFORM_CACHE_MEMBERSHIP_POLICIES: WeakMap<TtscTransformCache, Map<string, TtscCompilerMembershipHint>>;

package/lib/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.d.mts

@@ -0,0 +1,10 @@
+import type { TtscCompilerMembershipHint } from "../generation/TtscCompilerMembershipHint.mjs";
+import type { TtscTransformCache } from "./TtscTransformCache.mjs";
+/**
+ * Qualified native root hint per invocation key, retained across generation
+ * disposal. Its config-policy basis must match before priming a new walk;
+ * neither the match nor report proves current filesystem state. Entries live
+ * until the cache is collected; distinct invocation keys and their path bytes
+ * have no independent cap.
+ */
+export declare const TRANSFORM_CACHE_MEMBERSHIP_POLICIES: WeakMap<TtscTransformCache, Map<string, TtscCompilerMembershipHint>>;

package/lib/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.d.ts

@@ -0,0 +1,10 @@
+import type { TtscCompilerMembershipHint } from "../generation/TtscCompilerMembershipHint";
+import type { TtscTransformCache } from "./TtscTransformCache";
+/**
+ * Qualified native root hint per invocation key, retained across generation
+ * disposal. Its config-policy basis must match before priming a new walk;
+ * neither the match nor report proves current filesystem state. Entries live
+ * until the cache is collected; distinct invocation keys and their path bytes
+ * have no independent cap.
+ */
+export declare const TRANSFORM_CACHE_MEMBERSHIP_POLICIES: WeakMap<TtscTransformCache, Map<string, TtscCompilerMembershipHint>>;

package/lib/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.js

@@ -0,0 +1,13 @@
+'use strict';
+
+/**
+ * Qualified native root hint per invocation key, retained across generation
+ * disposal. Its config-policy basis must match before priming a new walk;
+ * neither the match nor report proves current filesystem state. Entries live
+ * until the cache is collected; distinct invocation keys and their path bytes
+ * have no independent cap.
+ */
+const TRANSFORM_CACHE_MEMBERSHIP_POLICIES = new WeakMap();
+
+exports.TRANSFORM_CACHE_MEMBERSHIP_POLICIES = TRANSFORM_CACHE_MEMBERSHIP_POLICIES;
+//# sourceMappingURL=TRANSFORM_CACHE_MEMBERSHIP_POLICIES.js.map

package/lib/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TRANSFORM_CACHE_MEMBERSHIP_POLICIES.js","sources":["../../../../src/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;;AAMG;AACI,MAAM,mCAAmC,GAAG,IAAI,OAAO;;;;"}

package/lib/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.mjs

@@ -0,0 +1,11 @@
+/**
+ * Qualified native root hint per invocation key, retained across generation
+ * disposal. Its config-policy basis must match before priming a new walk;
+ * neither the match nor report proves current filesystem state. Entries live
+ * until the cache is collected; distinct invocation keys and their path bytes
+ * have no independent cap.
+ */
+const TRANSFORM_CACHE_MEMBERSHIP_POLICIES = new WeakMap();
+
+export { TRANSFORM_CACHE_MEMBERSHIP_POLICIES };
+//# sourceMappingURL=TRANSFORM_CACHE_MEMBERSHIP_POLICIES.mjs.map

package/lib/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TRANSFORM_CACHE_MEMBERSHIP_POLICIES.mjs","sources":["../../../../src/core/transform/cache/TRANSFORM_CACHE_MEMBERSHIP_POLICIES.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;;;;AAMG;AACI,MAAM,mCAAmC,GAAG,IAAI,OAAO;;;;"}

package/lib/core/transform/cache/TtscCachedProjectTransform.d.cts

@@ -1,7 +1,9 @@
 import type { ITtscCompilerTransformation } from "ttsc";
 import type { ITtscProjectMembershipPolicy } from "../../tsconfig/ITtscProjectMembershipPolicy.cjs";
+import type { TtscCompilerMembershipHint } from "../generation/TtscCompilerMembershipHint.cjs";
 import type { TtscProjectDirectorySnapshot } from "../project/TtscProjectDirectorySnapshot.cjs";
 import type { TtscProjectMutationTracker } from "../tracker/TtscProjectMutationTracker.cjs";
+import type { TtscCompilerArgumentsWitness } from "../tsconfig/TtscCompilerArgumentsWitness.cjs";
 import type { TtscHostInputValidation } from "../validation/TtscHostInputValidation.cjs";
 /**
  * A single entry in the project transform cache.
@@ -40,6 +42,10 @@ import type { TtscHostInputValidation } from "../validation/TtscHostInputValidat
  *   retained state at runtime.
  */
 export interface TtscCachedProjectTransform {
+    /** Native settings learned under this capture's validated config-policy basis. */
+    compilerMembership?: TtscCompilerMembershipHint;
+    /** Actual captured invocation, retained for persisted host-cache proofs. */
+    compilerArguments?: TtscCompilerArgumentsWitness;
     /** Predicate-preserving compiler proofs for external candidate spellings. */
     externalInputObservations?: Record<string, ITtscCompilerTransformation.IInputObservation>;
     /**

package/lib/core/transform/cache/TtscCachedProjectTransform.d.mts

@@ -1,7 +1,9 @@
 import type { ITtscCompilerTransformation } from "ttsc";
 import type { ITtscProjectMembershipPolicy } from "../../tsconfig/ITtscProjectMembershipPolicy.mjs";
+import type { TtscCompilerMembershipHint } from "../generation/TtscCompilerMembershipHint.mjs";
 import type { TtscProjectDirectorySnapshot } from "../project/TtscProjectDirectorySnapshot.mjs";
 import type { TtscProjectMutationTracker } from "../tracker/TtscProjectMutationTracker.mjs";
+import type { TtscCompilerArgumentsWitness } from "../tsconfig/TtscCompilerArgumentsWitness.mjs";
 import type { TtscHostInputValidation } from "../validation/TtscHostInputValidation.mjs";
 /**
  * A single entry in the project transform cache.
@@ -40,6 +42,10 @@ import type { TtscHostInputValidation } from "../validation/TtscHostInputValidat
  *   retained state at runtime.
  */
 export interface TtscCachedProjectTransform {
+    /** Native settings learned under this capture's validated config-policy basis. */
+    compilerMembership?: TtscCompilerMembershipHint;
+    /** Actual captured invocation, retained for persisted host-cache proofs. */
+    compilerArguments?: TtscCompilerArgumentsWitness;
     /** Predicate-preserving compiler proofs for external candidate spellings. */
     externalInputObservations?: Record<string, ITtscCompilerTransformation.IInputObservation>;
     /**

package/lib/core/transform/cache/TtscCachedProjectTransform.d.ts

@@ -1,7 +1,9 @@
 import type { ITtscCompilerTransformation } from "ttsc";
 import type { ITtscProjectMembershipPolicy } from "../../tsconfig/ITtscProjectMembershipPolicy";
+import type { TtscCompilerMembershipHint } from "../generation/TtscCompilerMembershipHint";
 import type { TtscProjectDirectorySnapshot } from "../project/TtscProjectDirectorySnapshot";
 import type { TtscProjectMutationTracker } from "../tracker/TtscProjectMutationTracker";
+import type { TtscCompilerArgumentsWitness } from "../tsconfig/TtscCompilerArgumentsWitness";
 import type { TtscHostInputValidation } from "../validation/TtscHostInputValidation";
 /**
  * A single entry in the project transform cache.
@@ -40,6 +42,10 @@ import type { TtscHostInputValidation } from "../validation/TtscHostInputValidat
  *   retained state at runtime.
  */
 export interface TtscCachedProjectTransform {
+    /** Native settings learned under this capture's validated config-policy basis. */
+    compilerMembership?: TtscCompilerMembershipHint;
+    /** Actual captured invocation, retained for persisted host-cache proofs. */
+    compilerArguments?: TtscCompilerArgumentsWitness;
     /** Predicate-preserving compiler proofs for external candidate spellings. */
     externalInputObservations?: Record<string, ITtscCompilerTransformation.IInputObservation>;
     /**

package/lib/core/transform/cache/createTransformCacheKey.d.cts

@@ -4,13 +4,14 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
  *
  * The declared compile configuration is represented by: the selected tsconfig's
  * filesystem identity, common source-root identity, compiler overlay, plugin
- * list, and translated aliases. Two adapter configurations that have different
- * supported JSON representations therefore receive different keys; native
- * spellings resolving to one config identity may share a key. A key does not
- * encode current filesystem content or prove freshness. Compiler overlays,
- * plugin payloads and alias mappings retain their JSON declaration order: tied
- * compiler path patterns and arbitrary plugin payloads can observe it. Only the
- * host-owned outer manifest is serialized with sorted keys.
+ * list, effective compiler argument transport, and translated aliases. Two
+ * adapter configurations that have different supported JSON representations
+ * therefore receive different keys; native spellings resolving to one config
+ * identity may share a key. A key does not encode current filesystem content or
+ * prove freshness. Compiler overlays, plugin payloads and alias mappings retain
+ * their JSON declaration order: tied compiler path patterns and arbitrary
+ * plugin payloads can observe it. Only the host-owned outer manifest is
+ * serialized with sorted keys.
  *
  * @evidence contracts/common.md#principled-implementation Native config and source-root identities plus actual JSON representations of compiler overlays, plugin payloads and alias mappings distinguish requested compiles, retaining declaration order that path-pattern ties or plugins can observe.
  * @evidence contracts/common.md#clear-and-simple-design Existing path identity and stable JSON encoding define the key; filesystem state remains the generation validator's responsibility.
@@ -19,7 +20,7 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Returns a string and retains nothing.
  * @evidence contracts/performance.md#efficient-algorithms
  *   Three payload serializations preserve supported JSON order; the outer
- *   five-field manifest sorts only its fixed keys and serializes their text
+ *   fixed-field manifest sorts only its own keys and serializes their text
  *   again, with escaping/output space proportional to the payload text.
  *   One path-identity transaction for config and root observes uncached native
  *   aliases, ancestors and directory case policy; that work is not constant
@@ -37,6 +38,8 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
 export declare function createTransformCacheKey(props: {
     aliasPaths: Record<string, string[]>;
     compilerOptions: Record<string, unknown>;
+    /** Effective compiler argument snapshot selected before cache lookup. */
+    compilerEnvironment?: NodeJS.ProcessEnv;
     plugins?: ResolvedTtscUnpluginOptions["plugins"];
     /** Common source root; omission defaults to the config directory. */
     projectRoot?: string;

package/lib/core/transform/cache/createTransformCacheKey.d.mts

@@ -4,13 +4,14 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
  *
  * The declared compile configuration is represented by: the selected tsconfig's
  * filesystem identity, common source-root identity, compiler overlay, plugin
- * list, and translated aliases. Two adapter configurations that have different
- * supported JSON representations therefore receive different keys; native
- * spellings resolving to one config identity may share a key. A key does not
- * encode current filesystem content or prove freshness. Compiler overlays,
- * plugin payloads and alias mappings retain their JSON declaration order: tied
- * compiler path patterns and arbitrary plugin payloads can observe it. Only the
- * host-owned outer manifest is serialized with sorted keys.
+ * list, effective compiler argument transport, and translated aliases. Two
+ * adapter configurations that have different supported JSON representations
+ * therefore receive different keys; native spellings resolving to one config
+ * identity may share a key. A key does not encode current filesystem content or
+ * prove freshness. Compiler overlays, plugin payloads and alias mappings retain
+ * their JSON declaration order: tied compiler path patterns and arbitrary
+ * plugin payloads can observe it. Only the host-owned outer manifest is
+ * serialized with sorted keys.
  *
  * @evidence contracts/common.md#principled-implementation Native config and source-root identities plus actual JSON representations of compiler overlays, plugin payloads and alias mappings distinguish requested compiles, retaining declaration order that path-pattern ties or plugins can observe.
  * @evidence contracts/common.md#clear-and-simple-design Existing path identity and stable JSON encoding define the key; filesystem state remains the generation validator's responsibility.
@@ -19,7 +20,7 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Returns a string and retains nothing.
  * @evidence contracts/performance.md#efficient-algorithms
  *   Three payload serializations preserve supported JSON order; the outer
- *   five-field manifest sorts only its fixed keys and serializes their text
+ *   fixed-field manifest sorts only its own keys and serializes their text
  *   again, with escaping/output space proportional to the payload text.
  *   One path-identity transaction for config and root observes uncached native
  *   aliases, ancestors and directory case policy; that work is not constant
@@ -37,6 +38,8 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
 export declare function createTransformCacheKey(props: {
     aliasPaths: Record<string, string[]>;
     compilerOptions: Record<string, unknown>;
+    /** Effective compiler argument snapshot selected before cache lookup. */
+    compilerEnvironment?: NodeJS.ProcessEnv;
     plugins?: ResolvedTtscUnpluginOptions["plugins"];
     /** Common source root; omission defaults to the config directory. */
     projectRoot?: string;

package/lib/core/transform/cache/createTransformCacheKey.d.ts

@@ -4,13 +4,14 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
  *
  * The declared compile configuration is represented by: the selected tsconfig's
  * filesystem identity, common source-root identity, compiler overlay, plugin
- * list, and translated aliases. Two adapter configurations that have different
- * supported JSON representations therefore receive different keys; native
- * spellings resolving to one config identity may share a key. A key does not
- * encode current filesystem content or prove freshness. Compiler overlays,
- * plugin payloads and alias mappings retain their JSON declaration order: tied
- * compiler path patterns and arbitrary plugin payloads can observe it. Only the
- * host-owned outer manifest is serialized with sorted keys.
+ * list, effective compiler argument transport, and translated aliases. Two
+ * adapter configurations that have different supported JSON representations
+ * therefore receive different keys; native spellings resolving to one config
+ * identity may share a key. A key does not encode current filesystem content or
+ * prove freshness. Compiler overlays, plugin payloads and alias mappings retain
+ * their JSON declaration order: tied compiler path patterns and arbitrary
+ * plugin payloads can observe it. Only the host-owned outer manifest is
+ * serialized with sorted keys.
  *
  * @evidence contracts/common.md#principled-implementation Native config and source-root identities plus actual JSON representations of compiler overlays, plugin payloads and alias mappings distinguish requested compiles, retaining declaration order that path-pattern ties or plugins can observe.
  * @evidence contracts/common.md#clear-and-simple-design Existing path identity and stable JSON encoding define the key; filesystem state remains the generation validator's responsibility.
@@ -19,7 +20,7 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Returns a string and retains nothing.
  * @evidence contracts/performance.md#efficient-algorithms
  *   Three payload serializations preserve supported JSON order; the outer
- *   five-field manifest sorts only its fixed keys and serializes their text
+ *   fixed-field manifest sorts only its own keys and serializes their text
  *   again, with escaping/output space proportional to the payload text.
  *   One path-identity transaction for config and root observes uncached native
  *   aliases, ancestors and directory case policy; that work is not constant
@@ -37,6 +38,8 @@ import type { ResolvedTtscUnpluginOptions } from "../../options/ResolvedTtscUnpl
 export declare function createTransformCacheKey(props: {
     aliasPaths: Record<string, string[]>;
     compilerOptions: Record<string, unknown>;
+    /** Effective compiler argument snapshot selected before cache lookup. */
+    compilerEnvironment?: NodeJS.ProcessEnv;
     plugins?: ResolvedTtscUnpluginOptions["plugins"];
     /** Common source root; omission defaults to the config directory. */
     projectRoot?: string;