@ttsc/unplugin 0.32.0 → 0.32.1

package/lib/core/vite/installViteDependencyScanPlugins.d.mts

@@ -0,0 +1,46 @@
+import type { BuildOptions } from "esbuild";
+import type { TtscTransformResult } from "../transform/TtscTransformResult.mjs";
+/**
+ * Exposes imports introduced by ttsc plugins to Vite's dependency scanner.
+ *
+ * Vite scans files without its normal transform hooks. Its optimizer plugins
+ * are the supported connection: Rolldown transforms the scanner's loaded text,
+ * while esbuild scans transformed modules in a separate namespace and also
+ * imports each original through Vite's loader. That original graph preserves
+ * glob, JSX and user loaders; the transformed graph adds complete relative
+ * import chains without a second parser or artificial exports.
+ *
+ * Vite's esbuild scanner supplies stdin; dependency bundling supplies entry
+ * points. Only the scanner gets the extra original graph, because publishing
+ * that graph would execute untransformed code alongside transformed code.
+ * Bundling applies ordinary transforms after user loaders instead. Supplying
+ * both stdin and entryPoints is not a supported Vite optimizer configuration.
+ *
+ * The caller owns compilation, aliases, validation and cache lifetime. Each
+ * environment keeps its own optimizer settings and existing plugins. Disabled
+ * discovery is left alone, and repeated installation on one settings object
+ * within this call is suppressed.
+ *
+ * @evidence contracts/common.md#principled-implementation Official optimizer hooks and the host's Rolldown capability select the real backend. Esbuild's stdin scan parses transformed namespaces plus actual-loader originals, while entry-point dependency bundles receive ordinary transforms without duplicate runtime source.
+ * @evidence contracts/common.md#clear-and-simple-design One installer selects the host's resolved optimizer backend and delegates compilation to the adapter's existing transform owner.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Uses published setup, input options, namespaces, load, resolve and transform APIs. Synthetic original-import edges belong only to the unpublished dependency scan, and no host method, global, package name or expected dependency is replaced or special-cased.
+ * @evidence contracts/common.md#meaningful-documentation Prose explains the missing transform phase, original-loader ownership, scan versus bundle behavior, caller-owned generation validity and environment-specific option preservation.
+ * @evidence contracts/portability.md#os-neutral-implementation Node reads native paths and derives their resolve directories; Vite's resolver retains workspace, alias and filesystem identity policy. No OS-name or case assumption is introduced.
+ * @evidence contracts/performance.md#efficient-algorithms Esbuild scans at most a transformed and an original graph node per reached TypeScript source, sharing host cycle detection and parsing. Each interception delegates native resolution once. Active equal requests yield to the next resolver while the initiating interception retains the transformed graph edge; compilation and validation retain their own costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work Scanner deliveries use the caller's transform cache and proof rules. Existing optimizer plugin objects remain shared by identity. Each distinct backend settings object receives one Rolldown transform or one prepended esbuild scanner and one appended bundle transform per installation.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Settings retain plugin closures for their Vite configuration lifetime. Active resolution keys are removed in finally; module graph state belongs to the host's scanner context. No child build, module history or separate compiler cache is retained, and the caller releases generations at its existing Vite boundaries.
+ */
+export declare function installViteDependencyScanPlugins(config: {
+    command: string;
+    optimizeDeps: {
+        disabled?: boolean | "build" | "dev";
+        noDiscovery?: boolean;
+        esbuildOptions?: BuildOptions;
+        rolldownOptions?: {
+            plugins?: unknown;
+        };
+    };
+    environments?: Record<string, {
+        optimizeDeps?: typeof config.optimizeDeps;
+    }>;
+}, includes: (file: string) => boolean, transform: (source: string, file: string) => Promise<TtscTransformResult | undefined>, backend: "esbuild" | "rolldown"): void;

package/lib/core/vite/installViteDependencyScanPlugins.d.ts

@@ -0,0 +1,46 @@
+import type { BuildOptions } from "esbuild";
+import type { TtscTransformResult } from "../transform/TtscTransformResult";
+/**
+ * Exposes imports introduced by ttsc plugins to Vite's dependency scanner.
+ *
+ * Vite scans files without its normal transform hooks. Its optimizer plugins
+ * are the supported connection: Rolldown transforms the scanner's loaded text,
+ * while esbuild scans transformed modules in a separate namespace and also
+ * imports each original through Vite's loader. That original graph preserves
+ * glob, JSX and user loaders; the transformed graph adds complete relative
+ * import chains without a second parser or artificial exports.
+ *
+ * Vite's esbuild scanner supplies stdin; dependency bundling supplies entry
+ * points. Only the scanner gets the extra original graph, because publishing
+ * that graph would execute untransformed code alongside transformed code.
+ * Bundling applies ordinary transforms after user loaders instead. Supplying
+ * both stdin and entryPoints is not a supported Vite optimizer configuration.
+ *
+ * The caller owns compilation, aliases, validation and cache lifetime. Each
+ * environment keeps its own optimizer settings and existing plugins. Disabled
+ * discovery is left alone, and repeated installation on one settings object
+ * within this call is suppressed.
+ *
+ * @evidence contracts/common.md#principled-implementation Official optimizer hooks and the host's Rolldown capability select the real backend. Esbuild's stdin scan parses transformed namespaces plus actual-loader originals, while entry-point dependency bundles receive ordinary transforms without duplicate runtime source.
+ * @evidence contracts/common.md#clear-and-simple-design One installer selects the host's resolved optimizer backend and delegates compilation to the adapter's existing transform owner.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Uses published setup, input options, namespaces, load, resolve and transform APIs. Synthetic original-import edges belong only to the unpublished dependency scan, and no host method, global, package name or expected dependency is replaced or special-cased.
+ * @evidence contracts/common.md#meaningful-documentation Prose explains the missing transform phase, original-loader ownership, scan versus bundle behavior, caller-owned generation validity and environment-specific option preservation.
+ * @evidence contracts/portability.md#os-neutral-implementation Node reads native paths and derives their resolve directories; Vite's resolver retains workspace, alias and filesystem identity policy. No OS-name or case assumption is introduced.
+ * @evidence contracts/performance.md#efficient-algorithms Esbuild scans at most a transformed and an original graph node per reached TypeScript source, sharing host cycle detection and parsing. Each interception delegates native resolution once. Active equal requests yield to the next resolver while the initiating interception retains the transformed graph edge; compilation and validation retain their own costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work Scanner deliveries use the caller's transform cache and proof rules. Existing optimizer plugin objects remain shared by identity. Each distinct backend settings object receives one Rolldown transform or one prepended esbuild scanner and one appended bundle transform per installation.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Settings retain plugin closures for their Vite configuration lifetime. Active resolution keys are removed in finally; module graph state belongs to the host's scanner context. No child build, module history or separate compiler cache is retained, and the caller releases generations at its existing Vite boundaries.
+ */
+export declare function installViteDependencyScanPlugins(config: {
+    command: string;
+    optimizeDeps: {
+        disabled?: boolean | "build" | "dev";
+        noDiscovery?: boolean;
+        esbuildOptions?: BuildOptions;
+        rolldownOptions?: {
+            plugins?: unknown;
+        };
+    };
+    environments?: Record<string, {
+        optimizeDeps?: typeof config.optimizeDeps;
+    }>;
+}, includes: (file: string) => boolean, transform: (source: string, file: string) => Promise<TtscTransformResult | undefined>, backend: "esbuild" | "rolldown"): void;

package/lib/core/vite/installViteDependencyScanPlugins.js

@@ -0,0 +1,186 @@
+'use strict';
+
+var fs = require('node:fs');
+var path = require('node:path');
+var typescriptTransformSourcePattern = require('../source/typescriptTransformSourcePattern.js');
+var inlineSourceMap = require('../transform/utils/inlineSourceMap.js');
+var isHostWrapperQuery = require('../transform/utils/isHostWrapperQuery.js');
+var stripQuery = require('../transform/utils/stripQuery.js');
+
+/**
+ * Exposes imports introduced by ttsc plugins to Vite's dependency scanner.
+ *
+ * Vite scans files without its normal transform hooks. Its optimizer plugins
+ * are the supported connection: Rolldown transforms the scanner's loaded text,
+ * while esbuild scans transformed modules in a separate namespace and also
+ * imports each original through Vite's loader. That original graph preserves
+ * glob, JSX and user loaders; the transformed graph adds complete relative
+ * import chains without a second parser or artificial exports.
+ *
+ * Vite's esbuild scanner supplies stdin; dependency bundling supplies entry
+ * points. Only the scanner gets the extra original graph, because publishing
+ * that graph would execute untransformed code alongside transformed code.
+ * Bundling applies ordinary transforms after user loaders instead. Supplying
+ * both stdin and entryPoints is not a supported Vite optimizer configuration.
+ *
+ * The caller owns compilation, aliases, validation and cache lifetime. Each
+ * environment keeps its own optimizer settings and existing plugins. Disabled
+ * discovery is left alone, and repeated installation on one settings object
+ * within this call is suppressed.
+ *
+ * @evidence contracts/common.md#principled-implementation Official optimizer hooks and the host's Rolldown capability select the real backend. Esbuild's stdin scan parses transformed namespaces plus actual-loader originals, while entry-point dependency bundles receive ordinary transforms without duplicate runtime source.
+ * @evidence contracts/common.md#clear-and-simple-design One installer selects the host's resolved optimizer backend and delegates compilation to the adapter's existing transform owner.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Uses published setup, input options, namespaces, load, resolve and transform APIs. Synthetic original-import edges belong only to the unpublished dependency scan, and no host method, global, package name or expected dependency is replaced or special-cased.
+ * @evidence contracts/common.md#meaningful-documentation Prose explains the missing transform phase, original-loader ownership, scan versus bundle behavior, caller-owned generation validity and environment-specific option preservation.
+ * @evidence contracts/portability.md#os-neutral-implementation Node reads native paths and derives their resolve directories; Vite's resolver retains workspace, alias and filesystem identity policy. No OS-name or case assumption is introduced.
+ * @evidence contracts/performance.md#efficient-algorithms Esbuild scans at most a transformed and an original graph node per reached TypeScript source, sharing host cycle detection and parsing. Each interception delegates native resolution once. Active equal requests yield to the next resolver while the initiating interception retains the transformed graph edge; compilation and validation retain their own costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work Scanner deliveries use the caller's transform cache and proof rules. Existing optimizer plugin objects remain shared by identity. Each distinct backend settings object receives one Rolldown transform or one prepended esbuild scanner and one appended bundle transform per installation.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Settings retain plugin closures for their Vite configuration lifetime. Active resolution keys are removed in finally; module graph state belongs to the host's scanner context. No child build, module history or separate compiler cache is retained, and the caller releases generations at its existing Vite boundaries.
+ */
+function installViteDependencyScanPlugins(config, includes, transform, backend) {
+    if (config.command !== "serve")
+        return;
+    const installed = new Set();
+    const backends = new Set();
+    for (const options of [
+        config.optimizeDeps,
+        ...Object.values(config.environments ?? {}).map((environment) => environment.optimizeDeps),
+    ]) {
+        if (options === undefined ||
+            installed.has(options) ||
+            options.noDiscovery === true ||
+            options.disabled === true ||
+            options.disabled === "dev")
+            continue;
+        installed.add(options);
+        if (backend === "rolldown") {
+            options.rolldownOptions ??= {};
+            if (backends.has(options.rolldownOptions))
+                continue;
+            backends.add(options.rolldownOptions);
+            const existing = options.rolldownOptions.plugins;
+            options.rolldownOptions.plugins = [
+                ...(existing === undefined ? [] : [existing]),
+                {
+                    name: "ttsc-dependency-scan",
+                    async transform(source, file) {
+                        if (isHostWrapperQuery.isHostWrapperQuery(file) || !includes(stripQuery.stripQuery(file)))
+                            return;
+                        return transform(source, stripQuery.stripQuery(file));
+                    },
+                },
+            ];
+            continue;
+        }
+        options.esbuildOptions ??= {};
+        if (backends.has(options.esbuildOptions))
+            continue;
+        backends.add(options.esbuildOptions);
+        const plugin = {
+            name: "ttsc-dependency-scan",
+            setup(build) {
+                if (build.initialOptions.stdin === undefined)
+                    return;
+                const namespace = "ttsc-dependency-scan";
+                const originalPrefix = "ttsc-dependency-original:";
+                const resolving = new Set();
+                build.onResolve({ filter: /^ttsc-dependency-original:/, namespace }, (imported) => ({
+                    path: imported.path.slice(originalPrefix.length),
+                    namespace: "file",
+                    pluginData: imported.pluginData,
+                }));
+                build.onResolve({ filter: /.*/ }, async (imported) => {
+                    if (imported.namespace !== "file" &&
+                        imported.namespace !== namespace &&
+                        imported.namespace !== "")
+                        return;
+                    const key = JSON.stringify([
+                        imported.namespace === namespace
+                            ? "file"
+                            : imported.namespace || "file",
+                        imported.path,
+                        imported.importer,
+                        imported.resolveDir,
+                        imported.kind,
+                        imported.with,
+                    ]);
+                    // Equal active requests include both self recursion and concurrent
+                    // duplicates. Their raw edges cannot remove the first request's
+                    // transformed node, which still exposes the added dependency closure.
+                    if (resolving.has(key))
+                        return;
+                    resolving.add(key);
+                    let resolved;
+                    try {
+                        resolved = await build.resolve(imported.path, {
+                            importer: imported.importer,
+                            resolveDir: imported.resolveDir,
+                            namespace: "file",
+                            kind: imported.kind,
+                            pluginData: imported.pluginData,
+                            with: imported.with,
+                        });
+                    }
+                    finally {
+                        resolving.delete(key);
+                    }
+                    if (resolved.errors.length !== 0 ||
+                        resolved.external ||
+                        resolved.namespace !== "file" ||
+                        !includes(resolved.path) ||
+                        isHostWrapperQuery.isHostWrapperQuery(resolved.suffix))
+                        return resolved;
+                    const loader = build.initialOptions.loader?.[path.extname(resolved.path)];
+                    if (loader !== undefined &&
+                        !["js", "jsx", "ts", "tsx"].includes(loader))
+                        return resolved;
+                    return { ...resolved, namespace, pluginData: resolved };
+                });
+                build.onLoad({ filter: typescriptTransformSourcePattern.typescriptTransformSourcePattern, namespace }, async ({ path: file, pluginData }) => {
+                    const resolved = pluginData;
+                    const source = await fs.promises.readFile(file, "utf8");
+                    const transformed = await transform(source, file);
+                    return {
+                        contents: `${transformed?.code ?? source}\nimport ${JSON.stringify(originalPrefix + file)};\n`,
+                        loader: build.initialOptions.loader?.[path.extname(file)] ??
+                            (file.endsWith(".tsx") ? "tsx" : "ts"),
+                        resolveDir: path.dirname(file),
+                        pluginData: resolved.pluginData,
+                    };
+                });
+            },
+        };
+        const bundle = {
+            name: "ttsc-dependency-transform",
+            setup(build) {
+                if (build.initialOptions.stdin !== undefined)
+                    return;
+                build.onLoad({ filter: typescriptTransformSourcePattern.typescriptTransformSourcePattern, namespace: "file" }, async ({ path: file }) => {
+                    if (!includes(file))
+                        return;
+                    const loader = build.initialOptions.loader?.[path.extname(file)] ??
+                        (file.endsWith(".tsx") ? "tsx" : "ts");
+                    if (!["js", "jsx", "ts", "tsx"].includes(loader))
+                        return;
+                    const source = await fs.promises.readFile(file, "utf8");
+                    const result = await transform(source, file);
+                    if (result === undefined)
+                        return;
+                    return {
+                        contents: inlineSourceMap.inlineSourceMap(result),
+                        loader,
+                        resolveDir: path.dirname(file),
+                    };
+                });
+            },
+        };
+        options.esbuildOptions.plugins = [
+            plugin,
+            ...(options.esbuildOptions.plugins ?? []),
+            bundle,
+        ];
+    }
+}
+
+exports.installViteDependencyScanPlugins = installViteDependencyScanPlugins;
+//# sourceMappingURL=installViteDependencyScanPlugins.js.map

package/lib/core/vite/installViteDependencyScanPlugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installViteDependencyScanPlugins.js","sources":["../../../src/core/vite/installViteDependencyScanPlugins.ts"],"sourcesContent":[null],"names":["isHostWrapperQuery","stripQuery","typescriptTransformSourcePattern","inlineSourceMap"],"mappings":"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"}

package/lib/core/vite/installViteDependencyScanPlugins.mjs

@@ -0,0 +1,184 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { typescriptTransformSourcePattern } from '../source/typescriptTransformSourcePattern.mjs';
+import { inlineSourceMap } from '../transform/utils/inlineSourceMap.mjs';
+import { isHostWrapperQuery } from '../transform/utils/isHostWrapperQuery.mjs';
+import { stripQuery } from '../transform/utils/stripQuery.mjs';
+
+/**
+ * Exposes imports introduced by ttsc plugins to Vite's dependency scanner.
+ *
+ * Vite scans files without its normal transform hooks. Its optimizer plugins
+ * are the supported connection: Rolldown transforms the scanner's loaded text,
+ * while esbuild scans transformed modules in a separate namespace and also
+ * imports each original through Vite's loader. That original graph preserves
+ * glob, JSX and user loaders; the transformed graph adds complete relative
+ * import chains without a second parser or artificial exports.
+ *
+ * Vite's esbuild scanner supplies stdin; dependency bundling supplies entry
+ * points. Only the scanner gets the extra original graph, because publishing
+ * that graph would execute untransformed code alongside transformed code.
+ * Bundling applies ordinary transforms after user loaders instead. Supplying
+ * both stdin and entryPoints is not a supported Vite optimizer configuration.
+ *
+ * The caller owns compilation, aliases, validation and cache lifetime. Each
+ * environment keeps its own optimizer settings and existing plugins. Disabled
+ * discovery is left alone, and repeated installation on one settings object
+ * within this call is suppressed.
+ *
+ * @evidence contracts/common.md#principled-implementation Official optimizer hooks and the host's Rolldown capability select the real backend. Esbuild's stdin scan parses transformed namespaces plus actual-loader originals, while entry-point dependency bundles receive ordinary transforms without duplicate runtime source.
+ * @evidence contracts/common.md#clear-and-simple-design One installer selects the host's resolved optimizer backend and delegates compilation to the adapter's existing transform owner.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Uses published setup, input options, namespaces, load, resolve and transform APIs. Synthetic original-import edges belong only to the unpublished dependency scan, and no host method, global, package name or expected dependency is replaced or special-cased.
+ * @evidence contracts/common.md#meaningful-documentation Prose explains the missing transform phase, original-loader ownership, scan versus bundle behavior, caller-owned generation validity and environment-specific option preservation.
+ * @evidence contracts/portability.md#os-neutral-implementation Node reads native paths and derives their resolve directories; Vite's resolver retains workspace, alias and filesystem identity policy. No OS-name or case assumption is introduced.
+ * @evidence contracts/performance.md#efficient-algorithms Esbuild scans at most a transformed and an original graph node per reached TypeScript source, sharing host cycle detection and parsing. Each interception delegates native resolution once. Active equal requests yield to the next resolver while the initiating interception retains the transformed graph edge; compilation and validation retain their own costs.
+ * @evidence contracts/performance.md#reuse-equivalent-work Scanner deliveries use the caller's transform cache and proof rules. Existing optimizer plugin objects remain shared by identity. Each distinct backend settings object receives one Rolldown transform or one prepended esbuild scanner and one appended bundle transform per installation.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Settings retain plugin closures for their Vite configuration lifetime. Active resolution keys are removed in finally; module graph state belongs to the host's scanner context. No child build, module history or separate compiler cache is retained, and the caller releases generations at its existing Vite boundaries.
+ */
+function installViteDependencyScanPlugins(config, includes, transform, backend) {
+    if (config.command !== "serve")
+        return;
+    const installed = new Set();
+    const backends = new Set();
+    for (const options of [
+        config.optimizeDeps,
+        ...Object.values(config.environments ?? {}).map((environment) => environment.optimizeDeps),
+    ]) {
+        if (options === undefined ||
+            installed.has(options) ||
+            options.noDiscovery === true ||
+            options.disabled === true ||
+            options.disabled === "dev")
+            continue;
+        installed.add(options);
+        if (backend === "rolldown") {
+            options.rolldownOptions ??= {};
+            if (backends.has(options.rolldownOptions))
+                continue;
+            backends.add(options.rolldownOptions);
+            const existing = options.rolldownOptions.plugins;
+            options.rolldownOptions.plugins = [
+                ...(existing === undefined ? [] : [existing]),
+                {
+                    name: "ttsc-dependency-scan",
+                    async transform(source, file) {
+                        if (isHostWrapperQuery(file) || !includes(stripQuery(file)))
+                            return;
+                        return transform(source, stripQuery(file));
+                    },
+                },
+            ];
+            continue;
+        }
+        options.esbuildOptions ??= {};
+        if (backends.has(options.esbuildOptions))
+            continue;
+        backends.add(options.esbuildOptions);
+        const plugin = {
+            name: "ttsc-dependency-scan",
+            setup(build) {
+                if (build.initialOptions.stdin === undefined)
+                    return;
+                const namespace = "ttsc-dependency-scan";
+                const originalPrefix = "ttsc-dependency-original:";
+                const resolving = new Set();
+                build.onResolve({ filter: /^ttsc-dependency-original:/, namespace }, (imported) => ({
+                    path: imported.path.slice(originalPrefix.length),
+                    namespace: "file",
+                    pluginData: imported.pluginData,
+                }));
+                build.onResolve({ filter: /.*/ }, async (imported) => {
+                    if (imported.namespace !== "file" &&
+                        imported.namespace !== namespace &&
+                        imported.namespace !== "")
+                        return;
+                    const key = JSON.stringify([
+                        imported.namespace === namespace
+                            ? "file"
+                            : imported.namespace || "file",
+                        imported.path,
+                        imported.importer,
+                        imported.resolveDir,
+                        imported.kind,
+                        imported.with,
+                    ]);
+                    // Equal active requests include both self recursion and concurrent
+                    // duplicates. Their raw edges cannot remove the first request's
+                    // transformed node, which still exposes the added dependency closure.
+                    if (resolving.has(key))
+                        return;
+                    resolving.add(key);
+                    let resolved;
+                    try {
+                        resolved = await build.resolve(imported.path, {
+                            importer: imported.importer,
+                            resolveDir: imported.resolveDir,
+                            namespace: "file",
+                            kind: imported.kind,
+                            pluginData: imported.pluginData,
+                            with: imported.with,
+                        });
+                    }
+                    finally {
+                        resolving.delete(key);
+                    }
+                    if (resolved.errors.length !== 0 ||
+                        resolved.external ||
+                        resolved.namespace !== "file" ||
+                        !includes(resolved.path) ||
+                        isHostWrapperQuery(resolved.suffix))
+                        return resolved;
+                    const loader = build.initialOptions.loader?.[path.extname(resolved.path)];
+                    if (loader !== undefined &&
+                        !["js", "jsx", "ts", "tsx"].includes(loader))
+                        return resolved;
+                    return { ...resolved, namespace, pluginData: resolved };
+                });
+                build.onLoad({ filter: typescriptTransformSourcePattern, namespace }, async ({ path: file, pluginData }) => {
+                    const resolved = pluginData;
+                    const source = await fs.promises.readFile(file, "utf8");
+                    const transformed = await transform(source, file);
+                    return {
+                        contents: `${transformed?.code ?? source}\nimport ${JSON.stringify(originalPrefix + file)};\n`,
+                        loader: build.initialOptions.loader?.[path.extname(file)] ??
+                            (file.endsWith(".tsx") ? "tsx" : "ts"),
+                        resolveDir: path.dirname(file),
+                        pluginData: resolved.pluginData,
+                    };
+                });
+            },
+        };
+        const bundle = {
+            name: "ttsc-dependency-transform",
+            setup(build) {
+                if (build.initialOptions.stdin !== undefined)
+                    return;
+                build.onLoad({ filter: typescriptTransformSourcePattern, namespace: "file" }, async ({ path: file }) => {
+                    if (!includes(file))
+                        return;
+                    const loader = build.initialOptions.loader?.[path.extname(file)] ??
+                        (file.endsWith(".tsx") ? "tsx" : "ts");
+                    if (!["js", "jsx", "ts", "tsx"].includes(loader))
+                        return;
+                    const source = await fs.promises.readFile(file, "utf8");
+                    const result = await transform(source, file);
+                    if (result === undefined)
+                        return;
+                    return {
+                        contents: inlineSourceMap(result),
+                        loader,
+                        resolveDir: path.dirname(file),
+                    };
+                });
+            },
+        };
+        options.esbuildOptions.plugins = [
+            plugin,
+            ...(options.esbuildOptions.plugins ?? []),
+            bundle,
+        ];
+    }
+}
+
+export { installViteDependencyScanPlugins };
+//# sourceMappingURL=installViteDependencyScanPlugins.mjs.map

package/lib/core/vite/installViteDependencyScanPlugins.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"installViteDependencyScanPlugins.mjs","sources":["../../../src/core/vite/installViteDependencyScanPlugins.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/unplugin",
-  "version": "0.32.0",
+  "version": "0.32.1",
   "description": "Bundler adapters for ttsc plugins.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
@@ -202,10 +202,10 @@
     "fsevents": "^2.3.3"
   },
   "peerDependencies": {
-    "ttsc": "^0.32.0"
+    "ttsc": "^0.32.1"
   },
   "devDependencies": {
-    "@wrtnlabs/evidence": "^0.5.0",
+    "@wrtnlabs/evidence": "^0.5.1",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@types/node": "^25.3.0",
@@ -217,7 +217,8 @@
     "tslib": "^2.8.1",
     "typescript": "^7.0.2",
     "vite": "^7.3.5",
-    "ttsc": "0.32.0"
+    "vite8": "npm:vite@^8.3.4",
+    "ttsc": "0.32.1"
   },
   "repository": {
     "type": "git",

package/src/core/options/ResolvedTtscUnpluginOptions.ts

@@ -37,6 +37,9 @@ import type { TtscUnpluginCompilerOptionsJson } from "./TtscUnpluginCompilerOpti
  *   retained state at runtime.
  */
 export interface ResolvedTtscUnpluginOptions {
+  /** Explicit source entries prepared concurrently before their first import. */
+  precompile?: readonly string[];
+
   /** Compiler-options overlay applied on top of the discovered tsconfig. */
   compilerOptions: TtscUnpluginCompilerOptionsJson;
 

package/src/core/options/TtscUnpluginOptions.ts

@@ -6,7 +6,7 @@ import type { TtscUnpluginCompilerOptionsJson } from "./TtscUnpluginCompilerOpti
  * Options accepted by the `@ttsc/unplugin` bundler adapter.
  *
  * @evidence contracts/common.md#principled-implementation
- *   Optional project selection, a JSON compiler overlay and the distinct
+ *   Explicit startup entries, optional project selection, a JSON compiler overlay and the distinct
  *   undefined/false/array plugin states express the supported caller choices.
  * @evidence contracts/common.md#clear-and-simple-design
  *   Config selection and common source root stay separate from compiler settings and
@@ -18,7 +18,7 @@ import type { TtscUnpluginCompilerOptionsJson } from "./TtscUnpluginCompilerOpti
  *   Member JSDoc explains relative-path resolution and override precedence.
  *   Separate member paragraphs and spacing follow the documentation guidance.
  * @evidence contracts/portability.md#os-neutral-implementation
- *   Project and projectRoot carry native paths: relative spelling is
+ *   Precompile entries, project and projectRoot carry native paths: relative spelling is
  *   resolved against process.cwd at delivery. An omitted project requests
  *   discovery; an omitted root uses the config directory. Compiler settings retain their compiler-owned path semantics;
  *   this type imposes no separator or filesystem case policy.
@@ -33,6 +33,17 @@ import type { TtscUnpluginCompilerOptionsJson } from "./TtscUnpluginCompilerOpti
  *   state at runtime.
  */
 export interface TtscUnpluginOptions {
+  /**
+   * Source entries whose projects start compiling together on the first load.
+   *
+   * Paths resolve from `process.cwd()` and use the same project selection,
+   * compiler options and plugins as delivered modules. Each project retains its
+   * normal input proofs. Listing an entry opts its project into compilation
+   * even if the host never imports it. Omission keeps compilation
+   * demand-driven.
+   */
+  precompile?: readonly string[];
+
   /**
    * Project config used by the bundler adapter.
    *

package/src/core/options/resolveOptions.ts

@@ -18,10 +18,11 @@ const defaultOptions: ResolvedTtscUnpluginOptions = {
  * @evidence contracts/common.md#principled-implementation
  *   Nullish defaults normalize the overlay and project; a presence check
  *   preserves explicit false and undefined plugin overrides. Object spread
- *   detaches top-level compiler keys while nested values retain caller identity.
+ *   detaches top-level compiler keys and the entry array while nested option
+ *   values retain caller identity.
  * @evidence contracts/common.md#clear-and-simple-design
  *   One returned record owns option normalization; transform code receives
- *   the same four choices without a second defaults layer. The optional root
+ *   the same choices without a second defaults layer. The optional root
  *   retains its spelling until delivery resolves it against process.cwd.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts
  *   Empty defaults implement omission semantics, and the false branch implements
@@ -32,7 +33,7 @@ const defaultOptions: ResolvedTtscUnpluginOptions = {
  * @evidenceExclude contracts/portability.md#os-neutral-implementation
  *   Performs no filesystem, path or process operation of its own.
  * @evidence contracts/performance.md#efficient-algorithms
- *   One shallow object spread copies the supplied compiler-option keys in
+ *   Shallow copies detach compiler-option keys and precompile entries in
  *   linear time and space. Nested option values are not traversed; this copy
  *   detaches the returned top-level overlay from later caller assignments.
  * @evidenceExclude contracts/performance.md#reuse-equivalent-work
@@ -44,6 +45,8 @@ export function resolveOptions(
   options: TtscUnpluginOptions = {},
 ): ResolvedTtscUnpluginOptions {
   return {
+    precompile:
+      options.precompile === undefined ? undefined : [...options.precompile],
     compilerOptions: { ...(options.compilerOptions ?? {}) },
     plugins: "plugins" in options ? options.plugins : defaultOptions.plugins,
     project: options.project ?? defaultOptions.project,