@ttsc/unplugin 0.30.2 → 0.30.3

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,11 @@ 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);
             },
             // 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 +111,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 +136,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 +190,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() {
@@ -258,58 +241,35 @@ const unpluginFactory = (rawOptions = {}) => {
                 return 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);
                         }
-                        // 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

@@ -425,10 +425,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

package/lib/core/transform.d.mts

@@ -425,10 +425,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

package/lib/core/transform.d.ts

@@ -425,10 +425,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

package/lib/core/transform.js

@@ -65,14 +65,13 @@ class TtscUnstableGenerationError extends TtscTerminalGenerationError {
 /**
  * A compile this pass already attempted, whose envelope failed outright.
  *
- * The envelope cannot say whether the host reported diagnostics about the
- * project or failed to run at all: an ordinary type error arrives as an
- * `"exception"` carrying the compiler's own diagnostic text, exactly as a
- * crashed host would. Sniffing that message to tell the two apart would be a
- * guess, so the adapter uses the one boundary it genuinely owns. Inside a pass
- * the answer is already settled, so every later module replays it instead of
- * repeating a whole-project transform to reach the same verdict, which is what
- * made a single broken save cost one compile per delivered module
+ * Native project diagnostics carry a structured failure envelope; setup and
+ * host failures can still arrive as opaque exceptions. Both settle the current
+ * attempt, so the adapter uses the delivery boundary it owns rather than
+ * guessing retryability from a diagnostic message. Inside a pass the answer is
+ * already settled, so every later module replays it instead of repeating a
+ * whole-project transform to reach the same verdict, which is what made a
+ * single broken save cost one compile per delivered module
  * (samchon/ttsc#1303).
  *
  * The scope is exactly the pass. A host whose `buildStart` repeats drops the
@@ -1051,11 +1050,11 @@ function collectDeclaredIdentities(state, projectRoot, listed) {
  * invalidated, and the error stays on screen (samchon/ttsc#1312).
  *
  * A failure envelope can retain exact external input spellings from its graph
- * and host metadata. A pre-transform typecheck failure may have no graph yet;
- * its structured diagnostics, or the host's standard diagnostic lines when it
- * could return only an exception, still name the external files that need a
- * repair. The cost is paid only on a failure, and only until the next compile
- * succeeds and narrows the set back to the derived inputs.
+ * and host metadata, including missing resolution candidates on native
+ * typecheck failures. For hosts that return no graph, structured diagnostics or
+ * standard diagnostic lines provide only the paths they actually name. The cost
+ * is paid only on a failure, and only until the next compile succeeds and
+ * narrows the set back to the derived inputs.
  */
 function notifyFailedGenerationInputs(hooks, cached) {
     const addWatchFile = hooks?.addWatchFile;
@@ -1100,7 +1099,7 @@ function notifyFailedGenerationInputs(hooks, cached) {
         }
     }
     if (addWatchFiles !== undefined) {
-        addWatchFiles(inputs);
+        addWatchFiles(inputs, true);
         return;
     }
     for (const input of inputs) {
@@ -3408,7 +3407,9 @@ membership) {
     });
     broker.pendingRegistrations += 1;
     broker.child.ref();
-    broker.child.channel?.ref();
+    // Bun's IPC channel omits Node's Control.ref/unref methods. The child itself
+    // still owns the outstanding acknowledgement on that runtime.
+    broker.child.channel?.ref?.();
     const id = broker.nextId++;
     let resolveReady;
     const ready = new Promise((resolve) => {
@@ -3479,7 +3480,7 @@ membership) {
         // exit mid-build.
         if (broker.pendingRegistrations === 0 && broker.pendingDrains === 0) {
             broker.child.unref();
-            broker.child.channel?.unref();
+            broker.child.channel?.unref?.();
         }
     }
 }
@@ -3595,7 +3596,7 @@ function startWindowsProjectMutationDrain(broker) {
             broker.pendingDrains -= 1;
             if (broker.pendingDrains === 0 && broker.pendingRegistrations === 0) {
                 broker.child.unref();
-                broker.child.channel?.unref();
+                broker.child.channel?.unref?.();
             }
             resolve();
         };
@@ -3606,7 +3607,7 @@ function startWindowsProjectMutationDrain(broker) {
         // process exits mid-build with nothing to report.
         broker.pendingDrains += 1;
         broker.child.ref();
-        broker.child.channel?.ref();
+        broker.child.channel?.ref?.();
         const timer = setTimeout(release, WINDOWS_MUTATION_DRAIN_FALLBACK_MS);
         broker.drains.set(id, release);
         if (broker.child.send?.({ id, op: "drain" }) !== true) {
@@ -5699,13 +5700,12 @@ function formatUnknownError(error) {
 /**
  * Remove terminal colour and cursor sequences from text the adapter surfaces.
  *
- * An ordinary type error reaches the adapter as an `"exception"` envelope whose
- * `error` is the host's own rendered output, colour and all, and the envelope
- * carries no structured diagnostics to format instead. What the adapter hands
- * back is not going to a terminal: it becomes the `Error` a bundler reports, so
- * it lands in a Vite overlay, a webpack error report or a CI annotation, where
- * the escapes render as literal noise around the file and line the reader needs
- * (samchon/ttsc#1312).
+ * An opaque host exception can contain the host's own rendered output, colour
+ * and all, with no structured diagnostics to format instead. What the adapter
+ * hands back is not going to a terminal: it becomes the `Error` a bundler
+ * reports, so it lands in a Vite overlay, a webpack error report or a CI
+ * annotation, where the escapes render as literal noise around the file and
+ * line the reader needs (samchon/ttsc#1312).
  *
  * The colour originates in the host's rendering rather than in anything this
  * adapter configures, so this is the adapter-side repair, applied to every