@ttsc/unplugin 0.30.2 → 0.30.4

package/lib/core/index.mjs

@@ -1,11 +1,10 @@
-import fs from 'node:fs';
-import path from 'node:path';
 import { createUnplugin } from 'unplugin';
+import { createEsbuildOptions } from './esbuild.mjs';
 import { resolveOptions } from './options.mjs';
 import { typescriptTransformSourcePattern } from './sourceExtensions.mjs';
 import { createTtscTransformCache, stripQuery, transformTtsc, beginTtscTransformBuild, resetTtscTransformCache, isDeclarationFile } from './transform.mjs';
 export { captureWatchInputBaseline, captureWatchInputFileBaseline, collectExternalInputHashes, collectProjectInputHashSnapshot, collectProjectInputHashes, isProjectWalkPath, isWatchInputKeyBaseline, watchInputEvidenceMatchesBaseline } from './transform.mjs';
-import { createViteServeMissingInputWatch } from './viteServe.mjs';
+import { createViteServeInputWatch } from './viteServe.mjs';
 export { mergeMembershipPolicyOverlay, readProjectMembershipPolicy, readTsconfigSourceSnapshot } from './tsconfigPaths.mjs';
 export { discoverNearestProjectTsconfig, findNearestProjectTsconfig, findProjectTsconfigs } from './projectDiscovery.mjs';
 
@@ -41,10 +40,13 @@ const virtualModulePattern = /\0/;
  * server configured without a watcher takes the pass lifecycle with them,
  * having declared it will observe no edit at all.
  */
-const unpluginFactory = (rawOptions = {}) => {
+const unpluginFactory = (rawOptions = {}, meta) => {
     const options = resolveOptions(rawOptions);
+    if (meta.framework === "esbuild") {
+        return createEsbuildOptions(options, isTransformTarget);
+    }
     const transformCache = createTtscTransformCache();
-    const missingInputs = createViteServeMissingInputWatch();
+    const serveInputs = createViteServeInputWatch();
     let aliases;
     let viteCommand;
     let viteWatching = true;
@@ -59,13 +61,6 @@ const unpluginFactory = (rawOptions = {}) => {
     // old containers cannot dispose a replacement's freshly initialized cache.
     let viteBuildOwners = new WeakSet();
     let viteBuildLifecycles = 0;
-    // esbuild schedules one-shot onDispose callbacks after it settles the build
-    // Promise. Acquire ownership only at onStart: plugin setup runs before build
-    // option validation, and a validation failure has no onDispose callback with
-    // which to release a setup-time owner. Once a build has actually started, the
-    // count keeps an older delayed callback from disposing its active generation.
-    const esbuildOwners = new WeakSet();
-    let esbuildLifecycles = 0;
     return {
         name,
         enforce: "pre",
@@ -95,14 +90,15 @@ const unpluginFactory = (rawOptions = {}) => {
                 viteBuildWatching =
                     config.build?.watch != null;
             },
-            // Vite serve funnels every transform-context `addWatchFile()` into the
-            // module's added-import graph (`_addedImports`), which import-analysis
-            // resolves like real imports. Capture the dev server so the transform
-            // hook can route watch inputs that do not exist yet — superseding
-            // resolution candidates above all — around that graph and still
-            // invalidate their importers when the path is created.
+            // Compiler dependencies belong to the filesystem watch graph. Vite's
+            // transform-context addWatchFile also inserts runtime imports, so none
+            // of those dependencies may use that channel during serve (#1368).
             configureServer(server) {
-                missingInputs.attach(server);
+                serveInputs.attach(server);
+            },
+            watchChange(id, change) {
+                if (change.event === "delete")
+                    serveInputs.forget(stripQuery(id));
             },
             // Vite calls buildEnd when the dev server closes, and Rollup calls it at
             // the end of every build phase; drop every poller and, once the last
@@ -119,15 +115,15 @@ const unpluginFactory = (rawOptions = {}) => {
             // fixing one of the two sites alone left this host recompiling the whole
             // project per edit (samchon/ttsc#1301). The watching build hands its
             // teardown to `closeWatcher` below instead.
-            buildEnd() {
+            async buildEnd() {
                 if (viteBuildOwners.delete(this)) {
                     viteBuildLifecycles -= 1;
                 }
                 if (viteBuildLifecycles === 0) {
-                    missingInputs.dispose();
                     if (viteCommand === "serve" || !viteBuildWatching) {
                         resetTtscTransformCache(transformCache);
                     }
+                    await serveInputs.dispose();
                 }
             },
             // The watching build's real teardown, and the only hook in a
@@ -144,11 +140,11 @@ const unpluginFactory = (rawOptions = {}) => {
             // `buildEnd` would then decrement a counter that is already zero and
             // strand it below zero, after which the disposal above could never fire
             // again for this plugin instance.
-            closeWatcher() {
+            async closeWatcher() {
                 viteBuildOwners = new WeakSet();
                 viteBuildLifecycles = 0;
-                missingInputs.dispose();
                 resetTtscTransformCache(transformCache);
+                await serveInputs.dispose();
             },
         },
         // Rollup and Rolldown carry none of the Vite block's hooks, so before this
@@ -198,23 +194,14 @@ const unpluginFactory = (rawOptions = {}) => {
                 resetTtscTransformCache(transformCache);
             });
         },
-        esbuild: {
-            setup(build) {
-                build.onStart(() => {
-                    if (!esbuildOwners.has(build)) {
-                        esbuildOwners.add(build);
-                        esbuildLifecycles += 1;
-                    }
-                });
-                build.onDispose(() => {
-                    if (!esbuildOwners.delete(build)) {
-                        return;
-                    }
-                    esbuildLifecycles -= 1;
-                    if (esbuildLifecycles === 0) {
-                        resetTtscTransformCache(transformCache);
-                    }
-                });
+        farm: {
+            // Farm calls buildStart only for the initial compilation. Every update
+            // opens a new pass so a failed verdict can recover, while an unchanged
+            // successful generation remains reusable across its module deliveries.
+            updateModules: {
+                executor() {
+                    beginTtscTransformBuild(transformCache);
+                },
             },
         },
         buildStart() {
@@ -257,59 +244,43 @@ const unpluginFactory = (rawOptions = {}) => {
             if (!isTransformTarget(file)) {
                 return undefined;
             }
+            // The project-root observer is already live when a Vite serve transform
+            // begins. Its sequence token lets registration prove only inputs that
+            // could have changed during compilation, instead of synchronously
+            // re-reading every input in a large compiler graph.
+            const serveStartedAt = viteCommand === "serve" && viteWatching
+                ? serveInputs.begin()
+                : undefined;
             return transformTtsc(file, source, options, aliases, transformCache, {
-                // Register the derived watch inputs (plugin-reported `dependencies`
-                // unioned with the host-owned reference graph) so type-only inputs
-                // invalidate this module in watch mode and persistent caches;
-                // bundlers erase type-only imports from their own module graph and
-                // would otherwise serve stale generated code. Under Vite serve a
-                // resolver input that is not proven to be a file must not enter
-                // `addWatchFile`: import-analysis resolves added imports and 500s on
-                // missing paths and directories, so those are watched against their
-                // compiler predicates instead and invalidate this module when the
-                // observation changes.
-                addWatchFile: (watched, evidence) => {
-                    if (viteCommand === "serve" && missingInputs.serving()) {
-                        const observation = evidence?.state?.codec === "predicates"
-                            ? evidence.state.observation
-                            : undefined;
-                        const unsafePredicate = observation !== undefined &&
-                            observation.fileExists !== true &&
-                            observation.stat !== "file" &&
-                            observation.readFile?.ok !== true
-                            ? observation
-                            : undefined;
-                        if (unsafePredicate !== undefined) {
-                            missingInputs.watch(watched, path.resolve(file), unsafePredicate);
-                            return;
+                // A watcherless server has no invalidation channel and needs no
+                // watch-input derivation. Every other host keeps its native contract.
+                addWatchFiles: viteCommand === "serve" && !viteWatching
+                    ? undefined
+                    : (inputs, failed) => {
+                        if (viteCommand === "serve") {
+                            serveInputs.replace(file, inputs, failed, serveStartedAt);
                         }
-                        // Trust the generation's recorded existence when it supplied one:
-                        // every cache hit revalidates it, and probing each input again
-                        // costs one `existsSync` per input per delivered module.
-                        const unavailable = evidence?.unavailable ??
-                            (evidence === undefined
-                                ? !fs.existsSync(watched)
-                                    ? "missing"
-                                    : undefined
-                                : evidence.missing
-                                    ? "missing"
-                                    : undefined);
-                        if (unavailable !== undefined) {
-                            missingInputs.watch(watched, path.resolve(file), unavailable === "not-file" ? "file" : "exists");
-                            return;
+                        else {
+                            const native = this.getNativeBuildContext?.();
+                            for (const input of inputs) {
+                                if (native?.framework === "rspack" &&
+                                    native.loaderContext !== undefined) {
+                                    // Compilation-level dependencies schedule a pass but do
+                                    // not invalidate Rspack's cached transformed modules.
+                                    if (input.evidence?.missing === true)
+                                        native.loaderContext.addMissingDependency(input.file);
+                                    else
+                                        native.loaderContext.addDependency(input.file);
+                                }
+                                else if (native?.framework === "farm") {
+                                    native.context.addWatchFile(file, input.file);
+                                }
+                                else {
+                                    this.addWatchFile(input.file);
+                                }
+                            }
                         }
-                    }
-                    // A dev server configured without a watcher can never deliver a
-                    // change event, so a registration here buys nothing, and it is not
-                    // free: Vite's import analysis resolves every registered path like a
-                    // real import of the transformed module, once per module. The
-                    // adapter's own missing-input poll above stays active either way,
-                    // because it never depended on Vite's watcher.
-                    if (viteCommand === "serve" && !viteWatching) {
-                        return;
-                    }
-                    this.addWatchFile(watched);
-                },
+                    },
                 // A module the plugin declared volatile depends on non-file inputs,
                 // which no file-dependency snapshot can represent; mark it
                 // uncacheable where the bundler exposes that control.

package/lib/core/index.mjs.map

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

package/lib/core/transform.d.cts

@@ -56,6 +56,8 @@ interface TtscProjectMutationTracker {
      * whole, which cannot answer for one name.
      */
     covered?: ReadonlySet<string>;
+    /** Whether this is the repository-owned backend with content-event coverage. */
+    contentAuthoritative?: boolean;
     /**
      * Wait until every event this tracker's watcher has already dispatched has
      * been applied to it.
@@ -69,6 +71,8 @@ interface TtscProjectMutationTracker {
     drain?: () => Promise<void>;
     failed: boolean;
     membershipChanged: boolean;
+    /** Compare event and input paths through this tracker's filesystem identity. */
+    overlaps?: (input: string, changed: string) => boolean;
     settle?: Promise<void>;
 }
 /**
@@ -303,7 +307,7 @@ export interface TtscTransformFilesystemOperations {
      * native abort Node's Windows fs-event backend can raise when a watched
      * temporary tree is deleted.
      */
-    watch?(directory: string, listener: (eventType: string, filename: string | null) => void, onError: () => void): {
+    watch?(directory: string, listener: (eventType: string, filename: string | null) => void, onError: () => void, recursive?: boolean): {
         close: () => void;
     };
 }
@@ -425,10 +429,12 @@ export interface TtscTransformHooks {
     addWatchFile?: (file: string, evidence?: TtscWatchInputEvidence) => void;
     /**
      * Batched form of {@link addWatchFile}. When supplied, the transform calls it
-     * once per delivered module and does not call `addWatchFile` for that
-     * module.
+     * once per delivered module and does not call `addWatchFile` for that module.
+     * `failed` marks a recovery batch: a failed compiler can omit inputs from its
+     * previous successful result, so replacing hosts should retain those
+     * spellings until the next successful delivery.
      */
-    addWatchFiles?: (inputs: readonly TtscWatchInput[]) => void;
+    addWatchFiles?: (inputs: readonly TtscWatchInput[], failed?: boolean) => void;
     /**
      * Invoked when the plugin declared the transformed file volatile (the
      * envelope's `volatile` list): its output depends on non-file inputs that no
@@ -467,10 +473,14 @@ interface TtscHostInputValidation {
     readonly entries: Map<string, {
         path: string;
         /**
-         * Whether the recorded state of this input came from reading its bytes.
-         * An input that existed but could not be read records a missing state, so
-         * no signature may stand in for it: its metadata holds still while the
-         * bytes behind it appear.
+         * Whether the recorded state of this input has been matched to readable
+         * bytes. Capture sets it immediately for compiler-proven inputs; a
+         * current module supplied from an editor buffer can earn it later after
+         * its disk bytes match the recorded source.
+         *
+         * An input that still cannot be read records a missing state, so no
+         * signature may stand in for it: its metadata holds still while the bytes
+         * behind it appear.
          */
         readable: boolean;
         realpath: string | null;

package/lib/core/transform.d.mts

@@ -56,6 +56,8 @@ interface TtscProjectMutationTracker {
      * whole, which cannot answer for one name.
      */
     covered?: ReadonlySet<string>;
+    /** Whether this is the repository-owned backend with content-event coverage. */
+    contentAuthoritative?: boolean;
     /**
      * Wait until every event this tracker's watcher has already dispatched has
      * been applied to it.
@@ -69,6 +71,8 @@ interface TtscProjectMutationTracker {
     drain?: () => Promise<void>;
     failed: boolean;
     membershipChanged: boolean;
+    /** Compare event and input paths through this tracker's filesystem identity. */
+    overlaps?: (input: string, changed: string) => boolean;
     settle?: Promise<void>;
 }
 /**
@@ -303,7 +307,7 @@ export interface TtscTransformFilesystemOperations {
      * native abort Node's Windows fs-event backend can raise when a watched
      * temporary tree is deleted.
      */
-    watch?(directory: string, listener: (eventType: string, filename: string | null) => void, onError: () => void): {
+    watch?(directory: string, listener: (eventType: string, filename: string | null) => void, onError: () => void, recursive?: boolean): {
         close: () => void;
     };
 }
@@ -425,10 +429,12 @@ export interface TtscTransformHooks {
     addWatchFile?: (file: string, evidence?: TtscWatchInputEvidence) => void;
     /**
      * Batched form of {@link addWatchFile}. When supplied, the transform calls it
-     * once per delivered module and does not call `addWatchFile` for that
-     * module.
+     * once per delivered module and does not call `addWatchFile` for that module.
+     * `failed` marks a recovery batch: a failed compiler can omit inputs from its
+     * previous successful result, so replacing hosts should retain those
+     * spellings until the next successful delivery.
      */
-    addWatchFiles?: (inputs: readonly TtscWatchInput[]) => void;
+    addWatchFiles?: (inputs: readonly TtscWatchInput[], failed?: boolean) => void;
     /**
      * Invoked when the plugin declared the transformed file volatile (the
      * envelope's `volatile` list): its output depends on non-file inputs that no
@@ -467,10 +473,14 @@ interface TtscHostInputValidation {
     readonly entries: Map<string, {
         path: string;
         /**
-         * Whether the recorded state of this input came from reading its bytes.
-         * An input that existed but could not be read records a missing state, so
-         * no signature may stand in for it: its metadata holds still while the
-         * bytes behind it appear.
+         * Whether the recorded state of this input has been matched to readable
+         * bytes. Capture sets it immediately for compiler-proven inputs; a
+         * current module supplied from an editor buffer can earn it later after
+         * its disk bytes match the recorded source.
+         *
+         * An input that still cannot be read records a missing state, so no
+         * signature may stand in for it: its metadata holds still while the bytes
+         * behind it appear.
          */
         readable: boolean;
         realpath: string | null;

package/lib/core/transform.d.ts

@@ -56,6 +56,8 @@ interface TtscProjectMutationTracker {
      * whole, which cannot answer for one name.
      */
     covered?: ReadonlySet<string>;
+    /** Whether this is the repository-owned backend with content-event coverage. */
+    contentAuthoritative?: boolean;
     /**
      * Wait until every event this tracker's watcher has already dispatched has
      * been applied to it.
@@ -69,6 +71,8 @@ interface TtscProjectMutationTracker {
     drain?: () => Promise<void>;
     failed: boolean;
     membershipChanged: boolean;
+    /** Compare event and input paths through this tracker's filesystem identity. */
+    overlaps?: (input: string, changed: string) => boolean;
     settle?: Promise<void>;
 }
 /**
@@ -303,7 +307,7 @@ export interface TtscTransformFilesystemOperations {
      * native abort Node's Windows fs-event backend can raise when a watched
      * temporary tree is deleted.
      */
-    watch?(directory: string, listener: (eventType: string, filename: string | null) => void, onError: () => void): {
+    watch?(directory: string, listener: (eventType: string, filename: string | null) => void, onError: () => void, recursive?: boolean): {
         close: () => void;
     };
 }
@@ -425,10 +429,12 @@ export interface TtscTransformHooks {
     addWatchFile?: (file: string, evidence?: TtscWatchInputEvidence) => void;
     /**
      * Batched form of {@link addWatchFile}. When supplied, the transform calls it
-     * once per delivered module and does not call `addWatchFile` for that
-     * module.
+     * once per delivered module and does not call `addWatchFile` for that module.
+     * `failed` marks a recovery batch: a failed compiler can omit inputs from its
+     * previous successful result, so replacing hosts should retain those
+     * spellings until the next successful delivery.
      */
-    addWatchFiles?: (inputs: readonly TtscWatchInput[]) => void;
+    addWatchFiles?: (inputs: readonly TtscWatchInput[], failed?: boolean) => void;
     /**
      * Invoked when the plugin declared the transformed file volatile (the
      * envelope's `volatile` list): its output depends on non-file inputs that no
@@ -467,10 +473,14 @@ interface TtscHostInputValidation {
     readonly entries: Map<string, {
         path: string;
         /**
-         * Whether the recorded state of this input came from reading its bytes.
-         * An input that existed but could not be read records a missing state, so
-         * no signature may stand in for it: its metadata holds still while the
-         * bytes behind it appear.
+         * Whether the recorded state of this input has been matched to readable
+         * bytes. Capture sets it immediately for compiler-proven inputs; a
+         * current module supplied from an editor buffer can earn it later after
+         * its disk bytes match the recorded source.
+         *
+         * An input that still cannot be read records a missing state, so no
+         * signature may stand in for it: its metadata holds still while the bytes
+         * behind it appear.
          */
         readable: boolean;
         realpath: string | null;