@ttsc/unplugin 0.28.5 → 0.29.0

package/lib/core/tsconfigPaths.d.cts

@@ -21,6 +21,26 @@
  * diagnostics.
  */
 export declare function readEffectiveTsconfigPaths(tsconfig: string): Record<string, string[]>;
+/** Scalar compiler paths TypeScript substitutes from the final config owner. */
+export declare const CONFIG_DIR_TEMPLATE_SCALAR_OPTIONS: readonly ["baseUrl", "declarationDir", "generateCpuProfile", "generateTrace", "outDir", "outFile", "rootDir", "tsBuildInfoFile"];
+/** List compiler paths TypeScript substitutes from the final config owner. */
+export declare const CONFIG_DIR_TEMPLATE_LIST_OPTIONS: readonly ["rootDirs", "typeRoots"];
+/** One config-chain input captured for generation-state comparison. */
+export interface ITsconfigSourceSnapshotEntry {
+    /** Exact bytes decoded as UTF-8, or `null` when a probed config is absent. */
+    contents: string | null;
+    /** Canonical absolute spelling when the input exists. */
+    path: string;
+}
+/**
+ * Capture the leaf config and its complete `extends` graph in one deterministic
+ * list.
+ *
+ * Transform wrappers derive configuration before the compiler reads it again.
+ * Comparing this snapshot across the compile prevents a wrapper derived from
+ * one config state from being paired with membership and output from another.
+ */
+export declare function readTsconfigSourceSnapshot(tsconfig: string): ITsconfigSourceSnapshotEntry[];
 /**
  * What the resolved configuration says can and cannot enter the program.
  *
@@ -33,6 +53,22 @@ export declare function readEffectiveTsconfigPaths(tsconfig: string): Record<str
  * dropped from the walk entirely (samchon/ttsc#1307).
  */
 export interface ITtscProjectMembershipPolicy {
+    /**
+     * Absolute directory exclusions separated by the configuration entry that
+     * contributed them.
+     *
+     * Optional for compatibility with hosts that constructed this public policy
+     * before exclusion provenance was exposed. Without it, an overlay preserves
+     * every entry in `excludedDirectories` as an explicit exclusion because
+     * silently admitting a directory is the unsafe fallback.
+     */
+    directoryExclusionOrigins?: Readonly<{
+        declarationDir?: string;
+        exclude: readonly string[];
+        outDir?: string;
+        /** Whether output options supply TypeScript's implicit default exclude. */
+        useImplicitOutputExclusions?: boolean;
+    }>;
     /** Absolute directories the resolved configuration keeps out of the program. */
     excludedDirectories: readonly string[];
     /** Lowercased extensions a file needs to be a possible program input. */
@@ -64,8 +100,8 @@ export declare const PERMISSIVE_PROJECT_MEMBERSHIP_POLICY: ITtscProjectMembershi
  * program at all, so a `bundle.a1b2c3.js` emitted beside the sources is not a
  * membership change for a project that admits no JavaScript. `outDir`,
  * `declarationDir`, and the plain entries of `exclude` name the directories the
- * program does not contain, which is where a bundler's own output lives in
- * every project that configures one.
+ * program does not contain. TypeScript supplies the two output directories as
+ * implicit exclusions only when no top-level `exclude` replaces that default.
  *
  * A glob in `exclude` is skipped rather than approximated. Failing to exclude
  * costs a walk; excluding the wrong tree hides real sources, and this function
@@ -82,9 +118,25 @@ export declare function readProjectMembershipPolicy(tsconfig: string): ITtscProj
  * turns it off gets the narrower rule for the same reason.
  */
 export declare function mergeMembershipPolicyOverlay(policy: ITtscProjectMembershipPolicy, compilerOptions: Record<string, unknown>, baseDir: string): ITtscProjectMembershipPolicy;
+/**
+ * Materialize inherited compiler paths whose `${configDir}` owner would move
+ * when a generated wrapper becomes the final config in the chain.
+ *
+ * Only template-bearing options are returned. Ordinary inherited paths are
+ * already made absolute while TypeScript parses their declaring config, while
+ * template paths deliberately survive until the final consumer is known.
+ */
+export declare function readEffectiveTsconfigTemplateCompilerOptions(tsconfig: string): Record<string, unknown>;
+/**
+ * Materialize inherited file specifications whose `${configDir}` owner would
+ * otherwise move to a generated wrapper's scratch directory.
+ */
+export declare function readEffectiveTsconfigTemplateFileSpecs(tsconfig: string): Record<string, unknown>;
 /**
  * Anchor a single `paths` target at `baseDir` unless it is already absolute,
  * normalizing to forward slashes. The `*` wildcard survives `path.resolve` as a
  * literal segment, so patterns like `./src/*` stay patterns.
  */
-export declare function absolutizePathsTarget(baseDir: string, target: string): string;
+export declare function absolutizePathsTarget(baseDir: string, target: string, configDir?: string): string;
+/** Resolve one config path with TypeScript's leading `${configDir}` template. */
+export declare function resolveConfigDirTemplatePath(baseDir: string, target: string, configDir?: string): string;

package/lib/core/tsconfigPaths.d.mts

@@ -21,6 +21,26 @@
  * diagnostics.
  */
 export declare function readEffectiveTsconfigPaths(tsconfig: string): Record<string, string[]>;
+/** Scalar compiler paths TypeScript substitutes from the final config owner. */
+export declare const CONFIG_DIR_TEMPLATE_SCALAR_OPTIONS: readonly ["baseUrl", "declarationDir", "generateCpuProfile", "generateTrace", "outDir", "outFile", "rootDir", "tsBuildInfoFile"];
+/** List compiler paths TypeScript substitutes from the final config owner. */
+export declare const CONFIG_DIR_TEMPLATE_LIST_OPTIONS: readonly ["rootDirs", "typeRoots"];
+/** One config-chain input captured for generation-state comparison. */
+export interface ITsconfigSourceSnapshotEntry {
+    /** Exact bytes decoded as UTF-8, or `null` when a probed config is absent. */
+    contents: string | null;
+    /** Canonical absolute spelling when the input exists. */
+    path: string;
+}
+/**
+ * Capture the leaf config and its complete `extends` graph in one deterministic
+ * list.
+ *
+ * Transform wrappers derive configuration before the compiler reads it again.
+ * Comparing this snapshot across the compile prevents a wrapper derived from
+ * one config state from being paired with membership and output from another.
+ */
+export declare function readTsconfigSourceSnapshot(tsconfig: string): ITsconfigSourceSnapshotEntry[];
 /**
  * What the resolved configuration says can and cannot enter the program.
  *
@@ -33,6 +53,22 @@ export declare function readEffectiveTsconfigPaths(tsconfig: string): Record<str
  * dropped from the walk entirely (samchon/ttsc#1307).
  */
 export interface ITtscProjectMembershipPolicy {
+    /**
+     * Absolute directory exclusions separated by the configuration entry that
+     * contributed them.
+     *
+     * Optional for compatibility with hosts that constructed this public policy
+     * before exclusion provenance was exposed. Without it, an overlay preserves
+     * every entry in `excludedDirectories` as an explicit exclusion because
+     * silently admitting a directory is the unsafe fallback.
+     */
+    directoryExclusionOrigins?: Readonly<{
+        declarationDir?: string;
+        exclude: readonly string[];
+        outDir?: string;
+        /** Whether output options supply TypeScript's implicit default exclude. */
+        useImplicitOutputExclusions?: boolean;
+    }>;
     /** Absolute directories the resolved configuration keeps out of the program. */
     excludedDirectories: readonly string[];
     /** Lowercased extensions a file needs to be a possible program input. */
@@ -64,8 +100,8 @@ export declare const PERMISSIVE_PROJECT_MEMBERSHIP_POLICY: ITtscProjectMembershi
  * program at all, so a `bundle.a1b2c3.js` emitted beside the sources is not a
  * membership change for a project that admits no JavaScript. `outDir`,
  * `declarationDir`, and the plain entries of `exclude` name the directories the
- * program does not contain, which is where a bundler's own output lives in
- * every project that configures one.
+ * program does not contain. TypeScript supplies the two output directories as
+ * implicit exclusions only when no top-level `exclude` replaces that default.
  *
  * A glob in `exclude` is skipped rather than approximated. Failing to exclude
  * costs a walk; excluding the wrong tree hides real sources, and this function
@@ -82,9 +118,25 @@ export declare function readProjectMembershipPolicy(tsconfig: string): ITtscProj
  * turns it off gets the narrower rule for the same reason.
  */
 export declare function mergeMembershipPolicyOverlay(policy: ITtscProjectMembershipPolicy, compilerOptions: Record<string, unknown>, baseDir: string): ITtscProjectMembershipPolicy;
+/**
+ * Materialize inherited compiler paths whose `${configDir}` owner would move
+ * when a generated wrapper becomes the final config in the chain.
+ *
+ * Only template-bearing options are returned. Ordinary inherited paths are
+ * already made absolute while TypeScript parses their declaring config, while
+ * template paths deliberately survive until the final consumer is known.
+ */
+export declare function readEffectiveTsconfigTemplateCompilerOptions(tsconfig: string): Record<string, unknown>;
+/**
+ * Materialize inherited file specifications whose `${configDir}` owner would
+ * otherwise move to a generated wrapper's scratch directory.
+ */
+export declare function readEffectiveTsconfigTemplateFileSpecs(tsconfig: string): Record<string, unknown>;
 /**
  * Anchor a single `paths` target at `baseDir` unless it is already absolute,
  * normalizing to forward slashes. The `*` wildcard survives `path.resolve` as a
  * literal segment, so patterns like `./src/*` stay patterns.
  */
-export declare function absolutizePathsTarget(baseDir: string, target: string): string;
+export declare function absolutizePathsTarget(baseDir: string, target: string, configDir?: string): string;
+/** Resolve one config path with TypeScript's leading `${configDir}` template. */
+export declare function resolveConfigDirTemplatePath(baseDir: string, target: string, configDir?: string): string;

package/lib/core/tsconfigPaths.d.ts

@@ -21,6 +21,26 @@
  * diagnostics.
  */
 export declare function readEffectiveTsconfigPaths(tsconfig: string): Record<string, string[]>;
+/** Scalar compiler paths TypeScript substitutes from the final config owner. */
+export declare const CONFIG_DIR_TEMPLATE_SCALAR_OPTIONS: readonly ["baseUrl", "declarationDir", "generateCpuProfile", "generateTrace", "outDir", "outFile", "rootDir", "tsBuildInfoFile"];
+/** List compiler paths TypeScript substitutes from the final config owner. */
+export declare const CONFIG_DIR_TEMPLATE_LIST_OPTIONS: readonly ["rootDirs", "typeRoots"];
+/** One config-chain input captured for generation-state comparison. */
+export interface ITsconfigSourceSnapshotEntry {
+    /** Exact bytes decoded as UTF-8, or `null` when a probed config is absent. */
+    contents: string | null;
+    /** Canonical absolute spelling when the input exists. */
+    path: string;
+}
+/**
+ * Capture the leaf config and its complete `extends` graph in one deterministic
+ * list.
+ *
+ * Transform wrappers derive configuration before the compiler reads it again.
+ * Comparing this snapshot across the compile prevents a wrapper derived from
+ * one config state from being paired with membership and output from another.
+ */
+export declare function readTsconfigSourceSnapshot(tsconfig: string): ITsconfigSourceSnapshotEntry[];
 /**
  * What the resolved configuration says can and cannot enter the program.
  *
@@ -33,6 +53,22 @@ export declare function readEffectiveTsconfigPaths(tsconfig: string): Record<str
  * dropped from the walk entirely (samchon/ttsc#1307).
  */
 export interface ITtscProjectMembershipPolicy {
+    /**
+     * Absolute directory exclusions separated by the configuration entry that
+     * contributed them.
+     *
+     * Optional for compatibility with hosts that constructed this public policy
+     * before exclusion provenance was exposed. Without it, an overlay preserves
+     * every entry in `excludedDirectories` as an explicit exclusion because
+     * silently admitting a directory is the unsafe fallback.
+     */
+    directoryExclusionOrigins?: Readonly<{
+        declarationDir?: string;
+        exclude: readonly string[];
+        outDir?: string;
+        /** Whether output options supply TypeScript's implicit default exclude. */
+        useImplicitOutputExclusions?: boolean;
+    }>;
     /** Absolute directories the resolved configuration keeps out of the program. */
     excludedDirectories: readonly string[];
     /** Lowercased extensions a file needs to be a possible program input. */
@@ -64,8 +100,8 @@ export declare const PERMISSIVE_PROJECT_MEMBERSHIP_POLICY: ITtscProjectMembershi
  * program at all, so a `bundle.a1b2c3.js` emitted beside the sources is not a
  * membership change for a project that admits no JavaScript. `outDir`,
  * `declarationDir`, and the plain entries of `exclude` name the directories the
- * program does not contain, which is where a bundler's own output lives in
- * every project that configures one.
+ * program does not contain. TypeScript supplies the two output directories as
+ * implicit exclusions only when no top-level `exclude` replaces that default.
  *
  * A glob in `exclude` is skipped rather than approximated. Failing to exclude
  * costs a walk; excluding the wrong tree hides real sources, and this function
@@ -82,9 +118,25 @@ export declare function readProjectMembershipPolicy(tsconfig: string): ITtscProj
  * turns it off gets the narrower rule for the same reason.
  */
 export declare function mergeMembershipPolicyOverlay(policy: ITtscProjectMembershipPolicy, compilerOptions: Record<string, unknown>, baseDir: string): ITtscProjectMembershipPolicy;
+/**
+ * Materialize inherited compiler paths whose `${configDir}` owner would move
+ * when a generated wrapper becomes the final config in the chain.
+ *
+ * Only template-bearing options are returned. Ordinary inherited paths are
+ * already made absolute while TypeScript parses their declaring config, while
+ * template paths deliberately survive until the final consumer is known.
+ */
+export declare function readEffectiveTsconfigTemplateCompilerOptions(tsconfig: string): Record<string, unknown>;
+/**
+ * Materialize inherited file specifications whose `${configDir}` owner would
+ * otherwise move to a generated wrapper's scratch directory.
+ */
+export declare function readEffectiveTsconfigTemplateFileSpecs(tsconfig: string): Record<string, unknown>;
 /**
  * Anchor a single `paths` target at `baseDir` unless it is already absolute,
  * normalizing to forward slashes. The `*` wildcard survives `path.resolve` as a
  * literal segment, so patterns like `./src/*` stay patterns.
  */
-export declare function absolutizePathsTarget(baseDir: string, target: string): string;
+export declare function absolutizePathsTarget(baseDir: string, target: string, configDir?: string): string;
+/** Resolve one config path with TypeScript's leading `${configDir}` template. */
+export declare function resolveConfigDirTemplatePath(baseDir: string, target: string, configDir?: string): string;