@ttsc/unplugin 0.28.1 → 0.28.3

package/lib/core/viteServe.d.mts

@@ -0,0 +1,81 @@
+/** One module node inside a Vite module graph; opaque to this module. */
+type ViteModuleNodeLike = object;
+/**
+ * The module-graph surface this module touches, shared by Vite's mixed module
+ * graph and the per-environment graphs of the environment API.
+ */
+interface ViteModuleGraphLike {
+    fileToModulesMap?: Map<string, Set<ViteModuleNodeLike>>;
+    getModulesByFile?(file: string): Set<ViteModuleNodeLike> | undefined;
+    invalidateModule?(node: ViteModuleNodeLike): void;
+}
+/** A channel that can deliver a full-reload event to connected clients. */
+interface ViteHotChannelLike {
+    send?(payload: {
+        path?: string;
+        type: "full-reload";
+    }): void;
+}
+/** One dev-server environment (client, ssr, or a custom one). */
+interface ViteEnvironmentLike {
+    hot?: ViteHotChannelLike;
+    moduleGraph?: ViteModuleGraphLike;
+}
+/**
+ * Minimal structural view of the Vite dev server. Declared locally instead of
+ * importing `vite` so the published type declarations never require Vite to be
+ * installed, and so one shape spans the mixed module graph (Vite 5), the
+ * environment API (Vite 6+), and whichever of `ws`/`hot` a major still
+ * carries.
+ */
+export interface ViteDevServerLike {
+    environments?: Record<string, ViteEnvironmentLike>;
+    hot?: ViteHotChannelLike;
+    moduleGraph?: ViteModuleGraphLike;
+    ws?: ViteHotChannelLike;
+}
+/**
+ * Filesystem watch for derived watch inputs that do not exist while a Vite dev
+ * server is running.
+ *
+ * Vite serve treats every transform-context `addWatchFile()` registration as an
+ * added import: `TransformPluginContext.addWatchFile` stores the path in
+ * `_addedImports`, and `vite:import-analysis` resolves each entry like a real
+ * import of the transformed module. A missing path — a superseding resolution
+ * candidate or a plugin-reported dependency that is not generated yet — then
+ * fails that resolve and turns the importer's first request into a 500, even
+ * though the transform itself succeeded.
+ *
+ * This registry is the serve-only replacement for those registrations. Each
+ * missing path is stat-polled; when it is created, every importer that
+ * registered it is invalidated in the server's module graphs and one
+ * full-reload is sent, so the next request retransforms the importer against
+ * the new resolution winner. The project transform cache re-validates through
+ * its external-input hashes (a recorded `missing` marker differs from a content
+ * hash), so the retransform recompiles instead of replaying.
+ */
+export interface ViteServeMissingInputWatch {
+    /** Adopt the dev server whose module graphs creation events invalidate. */
+    attach(server: ViteDevServerLike): void;
+    /** Stop every poll; safe to call repeatedly. */
+    dispose(): void;
+    /**
+     * Report whether a dev server has ever been attached. This is not a liveness
+     * predicate — the reference intentionally survives the server's close (see
+     * {@link dispose}) — so route decisions must also gate on the resolved
+     * config's `command`, as the adapter does.
+     */
+    serving(): boolean;
+    /**
+     * Register one missing watch input derived for `importer`.
+     *
+     * `identity` is the filesystem identity the transform generation already
+     * resolved for `input`. Resolving it here instead costs a `realpath` and a
+     * case-sensitivity directory listing per input per delivery, because a
+     * per-call identity context memoizes nothing (samchon/ttsc#1246).
+     */
+    watch(input: string, importer: string, identity?: string): void;
+}
+/** Create an empty missing-input watch for one plugin instance. */
+export declare function createViteServeMissingInputWatch(): ViteServeMissingInputWatch;
+export {};

package/lib/esbuild.d.cts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.cjs";
+declare const esbuild: typeof unplugin.esbuild;
+export default esbuild;

package/lib/esbuild.d.mts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.mjs";
+declare const esbuild: typeof unplugin.esbuild;
+export default esbuild;

package/lib/farm.d.cts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.cjs";
+declare const farm: typeof unplugin.farm;
+export default farm;

package/lib/farm.d.mts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.mjs";
+declare const farm: typeof unplugin.farm;
+export default farm;

package/lib/index.d.cts

@@ -0,0 +1,12 @@
+/**
+ * @ttsc/unplugin: bundler-agnostic ttsc plugin adapter.
+ *
+ * Re-exports the unified `unplugin` instance that carries named bundler
+ * adapters (`.vite`, `.rollup`, `.rolldown`, `.webpack`, `.rspack`, `.esbuild`,
+ * `.farm`) as well as the raw factory for custom integrations. Per-bundler
+ * entry points (`@ttsc/unplugin/vite`, `/webpack`, …) each re-export the
+ * matching adapter directly to keep bundler-specific builds lean.
+ */
+import unplugin from "./core/index.cjs";
+export type { TtscUnpluginOptions } from "./core/options.cjs";
+export default unplugin;

package/lib/index.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @ttsc/unplugin: bundler-agnostic ttsc plugin adapter.
+ *
+ * Re-exports the unified `unplugin` instance that carries named bundler
+ * adapters (`.vite`, `.rollup`, `.rolldown`, `.webpack`, `.rspack`, `.esbuild`,
+ * `.farm`) as well as the raw factory for custom integrations. Per-bundler
+ * entry points (`@ttsc/unplugin/vite`, `/webpack`, …) each re-export the
+ * matching adapter directly to keep bundler-specific builds lean.
+ */
+import unplugin from "./core/index.mjs";
+export type { TtscUnpluginOptions } from "./core/options.mjs";
+export default unplugin;

package/lib/next.d.cts

@@ -0,0 +1,37 @@
+import type { TtscUnpluginOptions } from "./core/options.cjs";
+/**
+ * Minimal structural type for a Next.js configuration object.
+ *
+ * Only the `webpack` field is used by this adapter; all other Next.js options
+ * are forwarded as-is through the spread operator.
+ */
+export type NextLikeConfig = Record<string, unknown> & {
+    /**
+     * Optional existing webpack customisation hook. When the caller has already
+     * defined one, `next()` will chain through to it after injecting the ttsc
+     * webpack plugin.
+     */
+    webpack?: (config: WebpackLikeConfig, options: unknown) => WebpackLikeConfig;
+};
+/**
+ * Minimal structural type for a webpack configuration object as seen by the
+ * Next.js `webpack` hook callback.
+ */
+export type WebpackLikeConfig = Record<string, unknown> & {
+    /** The webpack plugin array; initialised to `[]` by this adapter if absent. */
+    plugins?: unknown[];
+};
+/**
+ * Wrap a Next.js config object so that the ttsc webpack plugin is injected into
+ * every webpack build Next.js performs.
+ *
+ * The adapter uses `unshift` to ensure the ttsc plugin runs before any other
+ * plugins in the array (unplugin `enforce: "pre"` semantics). An existing
+ * `nextConfig.webpack` hook is preserved and called after the plugin is
+ * injected.
+ *
+ * @param nextConfig - The caller's existing Next.js config (spread into the
+ *   returned object unchanged, except for `webpack`).
+ * @param options - Ttsc plugin options forwarded to the webpack adapter.
+ */
+export default function next(nextConfig?: NextLikeConfig, options?: TtscUnpluginOptions): NextLikeConfig;

package/lib/next.d.mts

@@ -0,0 +1,37 @@
+import type { TtscUnpluginOptions } from "./core/options.mjs";
+/**
+ * Minimal structural type for a Next.js configuration object.
+ *
+ * Only the `webpack` field is used by this adapter; all other Next.js options
+ * are forwarded as-is through the spread operator.
+ */
+export type NextLikeConfig = Record<string, unknown> & {
+    /**
+     * Optional existing webpack customisation hook. When the caller has already
+     * defined one, `next()` will chain through to it after injecting the ttsc
+     * webpack plugin.
+     */
+    webpack?: (config: WebpackLikeConfig, options: unknown) => WebpackLikeConfig;
+};
+/**
+ * Minimal structural type for a webpack configuration object as seen by the
+ * Next.js `webpack` hook callback.
+ */
+export type WebpackLikeConfig = Record<string, unknown> & {
+    /** The webpack plugin array; initialised to `[]` by this adapter if absent. */
+    plugins?: unknown[];
+};
+/**
+ * Wrap a Next.js config object so that the ttsc webpack plugin is injected into
+ * every webpack build Next.js performs.
+ *
+ * The adapter uses `unshift` to ensure the ttsc plugin runs before any other
+ * plugins in the array (unplugin `enforce: "pre"` semantics). An existing
+ * `nextConfig.webpack` hook is preserved and called after the plugin is
+ * injected.
+ *
+ * @param nextConfig - The caller's existing Next.js config (spread into the
+ *   returned object unchanged, except for `webpack`).
+ * @param options - Ttsc plugin options forwarded to the webpack adapter.
+ */
+export default function next(nextConfig?: NextLikeConfig, options?: TtscUnpluginOptions): NextLikeConfig;

package/lib/rolldown.d.cts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.cjs";
+declare const rolldown: typeof unplugin.rolldown;
+export default rolldown;

package/lib/rolldown.d.mts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.mjs";
+declare const rolldown: typeof unplugin.rolldown;
+export default rolldown;

package/lib/rollup.d.cts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.cjs";
+declare const rollup: typeof unplugin.rollup;
+export default rollup;

package/lib/rollup.d.mts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.mjs";
+declare const rollup: typeof unplugin.rollup;
+export default rollup;

package/lib/rspack.d.cts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.cjs";
+declare const rspack: typeof unplugin.rspack;
+export default rspack;

package/lib/rspack.d.mts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.mjs";
+declare const rspack: typeof unplugin.rspack;
+export default rspack;

package/lib/turbopack.d.cts

@@ -0,0 +1,58 @@
+import type { TtscUnpluginOptions } from "./core/options.cjs";
+/**
+ * Subset of the webpack loader context Turbopack provides to loaders wired
+ * through `turbopack.rules`. Turbopack has no JS plugin API, but it runs
+ * webpack-compatible loaders: source string in, source string out, with
+ * `async()` for asynchronous completion and `getOptions()` for the rule's
+ * `options` object.
+ */
+export interface TtscTurbopackLoaderContext {
+    /** Marks the loader asynchronous and returns the completion callback. */
+    async(): (error?: unknown, content?: string) => void;
+    /** Absolute path of the module being loaded. */
+    resourcePath: string;
+    /** The rule's `options` object, when one was configured. */
+    getOptions?(): TtscUnpluginOptions | undefined;
+    /**
+     * Register an additional file the transformed module depends on. Part of the
+     * webpack loader context contract Turbopack implements; a registered file
+     * enters Turbopack's `fileDependencies` set so editing it re-runs this loader
+     * for the owning module. Optional so a minimal stub context (or a Turbopack
+     * build that predates the method) still loads.
+     */
+    addDependency?(file: string): void;
+    /**
+     * Toggle result cacheability. Part of the webpack loader context contract;
+     * called with `false` when the ttsc plugin declared the module volatile
+     * (output depends on non-file inputs), so the bundler never replays a cached
+     * result for it. Optional so a minimal stub context still loads.
+     */
+    cacheable?(flag: boolean): void;
+}
+/**
+ * Standalone webpack-loader entrypoint for Turbopack.
+ *
+ * Turbopack cannot load unplugin-based plugins (no JS plugin API), but its
+ * `turbopack.rules` accept webpack loaders, and a ttsc transform is exactly
+ * loader-shaped: pure TypeScript source in, transformed source out. Wire it per
+ * extension:
+ *
+ * ```js
+ * // next.config.mjs
+ * const nextConfig = {
+ *   turbopack: {
+ *     rules: {
+ *       "*.ts": { loaders: ["@ttsc/unplugin/turbopack"] },
+ *       "*.tsx": { loaders: ["@ttsc/unplugin/turbopack"] },
+ *     },
+ *   },
+ * };
+ * ```
+ *
+ * Pass {@link TtscUnpluginOptions} through the rule's `options` object. The
+ * loader returns the source unchanged for declaration files, `node_modules`
+ * paths, and transforms that produce no change, mirroring the unplugin
+ * adapters' `transformInclude` filter, since a broad rule glob routes
+ * everything matching the extension through the loader.
+ */
+export default function turbopack(this: TtscTurbopackLoaderContext, source: string): void;

package/lib/turbopack.d.mts

@@ -0,0 +1,58 @@
+import type { TtscUnpluginOptions } from "./core/options.mjs";
+/**
+ * Subset of the webpack loader context Turbopack provides to loaders wired
+ * through `turbopack.rules`. Turbopack has no JS plugin API, but it runs
+ * webpack-compatible loaders: source string in, source string out, with
+ * `async()` for asynchronous completion and `getOptions()` for the rule's
+ * `options` object.
+ */
+export interface TtscTurbopackLoaderContext {
+    /** Marks the loader asynchronous and returns the completion callback. */
+    async(): (error?: unknown, content?: string) => void;
+    /** Absolute path of the module being loaded. */
+    resourcePath: string;
+    /** The rule's `options` object, when one was configured. */
+    getOptions?(): TtscUnpluginOptions | undefined;
+    /**
+     * Register an additional file the transformed module depends on. Part of the
+     * webpack loader context contract Turbopack implements; a registered file
+     * enters Turbopack's `fileDependencies` set so editing it re-runs this loader
+     * for the owning module. Optional so a minimal stub context (or a Turbopack
+     * build that predates the method) still loads.
+     */
+    addDependency?(file: string): void;
+    /**
+     * Toggle result cacheability. Part of the webpack loader context contract;
+     * called with `false` when the ttsc plugin declared the module volatile
+     * (output depends on non-file inputs), so the bundler never replays a cached
+     * result for it. Optional so a minimal stub context still loads.
+     */
+    cacheable?(flag: boolean): void;
+}
+/**
+ * Standalone webpack-loader entrypoint for Turbopack.
+ *
+ * Turbopack cannot load unplugin-based plugins (no JS plugin API), but its
+ * `turbopack.rules` accept webpack loaders, and a ttsc transform is exactly
+ * loader-shaped: pure TypeScript source in, transformed source out. Wire it per
+ * extension:
+ *
+ * ```js
+ * // next.config.mjs
+ * const nextConfig = {
+ *   turbopack: {
+ *     rules: {
+ *       "*.ts": { loaders: ["@ttsc/unplugin/turbopack"] },
+ *       "*.tsx": { loaders: ["@ttsc/unplugin/turbopack"] },
+ *     },
+ *   },
+ * };
+ * ```
+ *
+ * Pass {@link TtscUnpluginOptions} through the rule's `options` object. The
+ * loader returns the source unchanged for declaration files, `node_modules`
+ * paths, and transforms that produce no change, mirroring the unplugin
+ * adapters' `transformInclude` filter, since a broad rule glob routes
+ * everything matching the extension through the loader.
+ */
+export default function turbopack(this: TtscTurbopackLoaderContext, source: string): void;

package/lib/vite.d.cts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.cjs";
+declare const vite: typeof unplugin.vite;
+export default vite;

package/lib/vite.d.mts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.mjs";
+declare const vite: typeof unplugin.vite;
+export default vite;

package/lib/webpack.d.cts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.cjs";
+declare const webpack: typeof unplugin.webpack;
+export default webpack;

package/lib/webpack.d.mts

@@ -0,0 +1,3 @@
+import unplugin from "./core/index.mjs";
+declare const webpack: typeof unplugin.webpack;
+export default webpack;

package/package.json

@@ -1,74 +1,178 @@
 {
   "name": "@ttsc/unplugin",
-  "version": "0.28.1",
+  "version": "0.28.3",
   "description": "Bundler adapters for ttsc plugins.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
   "types": "lib/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib/*"
+      ],
+      "package.json": [
+        "package.json"
+      ],
+      "*": [
+        "lib/*"
+      ]
+    }
+  },
   "exports": {
     ".": {
+      "import": {
+        "types": "./lib/index.d.mts",
+        "default": "./lib/index.mjs"
+      },
+      "require": {
+        "types": "./lib/index.d.cts",
+        "default": "./lib/index.js"
+      },
       "types": "./lib/index.d.ts",
-      "import": "./lib/index.mjs",
       "default": "./lib/index.js"
     },
     "./api": {
+      "import": {
+        "types": "./lib/api.d.mts",
+        "default": "./lib/api.mjs"
+      },
+      "require": {
+        "types": "./lib/api.d.cts",
+        "default": "./lib/api.js"
+      },
       "types": "./lib/api.d.ts",
-      "import": "./lib/api.mjs",
       "default": "./lib/api.js"
     },
     "./bun": {
+      "import": {
+        "types": "./lib/bun.d.mts",
+        "default": "./lib/bun.mjs"
+      },
+      "require": {
+        "types": "./lib/bun.d.cts",
+        "default": "./lib/bun.js"
+      },
       "types": "./lib/bun.d.ts",
-      "import": "./lib/bun.mjs",
       "default": "./lib/bun.js"
     },
     "./bun-register": {
+      "import": {
+        "types": "./lib/bun-register.d.mts",
+        "default": "./lib/bun-register.mjs"
+      },
+      "require": {
+        "types": "./lib/bun-register.d.cts",
+        "default": "./lib/bun-register.js"
+      },
       "types": "./lib/bun-register.d.ts",
-      "import": "./lib/bun-register.mjs",
       "default": "./lib/bun-register.js"
     },
     "./esbuild": {
+      "import": {
+        "types": "./lib/esbuild.d.mts",
+        "default": "./lib/esbuild.mjs"
+      },
+      "require": {
+        "types": "./lib/esbuild.d.cts",
+        "default": "./lib/esbuild.js"
+      },
       "types": "./lib/esbuild.d.ts",
-      "import": "./lib/esbuild.mjs",
       "default": "./lib/esbuild.js"
     },
     "./farm": {
+      "import": {
+        "types": "./lib/farm.d.mts",
+        "default": "./lib/farm.mjs"
+      },
+      "require": {
+        "types": "./lib/farm.d.cts",
+        "default": "./lib/farm.js"
+      },
       "types": "./lib/farm.d.ts",
-      "import": "./lib/farm.mjs",
       "default": "./lib/farm.js"
     },
     "./next": {
+      "import": {
+        "types": "./lib/next.d.mts",
+        "default": "./lib/next.mjs"
+      },
+      "require": {
+        "types": "./lib/next.d.cts",
+        "default": "./lib/next.js"
+      },
       "types": "./lib/next.d.ts",
-      "import": "./lib/next.mjs",
       "default": "./lib/next.js"
     },
     "./rolldown": {
+      "import": {
+        "types": "./lib/rolldown.d.mts",
+        "default": "./lib/rolldown.mjs"
+      },
+      "require": {
+        "types": "./lib/rolldown.d.cts",
+        "default": "./lib/rolldown.js"
+      },
       "types": "./lib/rolldown.d.ts",
-      "import": "./lib/rolldown.mjs",
       "default": "./lib/rolldown.js"
     },
     "./rollup": {
+      "import": {
+        "types": "./lib/rollup.d.mts",
+        "default": "./lib/rollup.mjs"
+      },
+      "require": {
+        "types": "./lib/rollup.d.cts",
+        "default": "./lib/rollup.js"
+      },
       "types": "./lib/rollup.d.ts",
-      "import": "./lib/rollup.mjs",
       "default": "./lib/rollup.js"
     },
     "./rspack": {
+      "import": {
+        "types": "./lib/rspack.d.mts",
+        "default": "./lib/rspack.mjs"
+      },
+      "require": {
+        "types": "./lib/rspack.d.cts",
+        "default": "./lib/rspack.js"
+      },
       "types": "./lib/rspack.d.ts",
-      "import": "./lib/rspack.mjs",
       "default": "./lib/rspack.js"
     },
     "./turbopack": {
+      "import": {
+        "types": "./lib/turbopack.d.mts",
+        "default": "./lib/turbopack.mjs"
+      },
+      "require": {
+        "types": "./lib/turbopack.d.cts",
+        "default": "./lib/turbopack.js"
+      },
       "types": "./lib/turbopack.d.ts",
-      "import": "./lib/turbopack.mjs",
       "default": "./lib/turbopack.js"
     },
     "./vite": {
+      "import": {
+        "types": "./lib/vite.d.mts",
+        "default": "./lib/vite.mjs"
+      },
+      "require": {
+        "types": "./lib/vite.d.cts",
+        "default": "./lib/vite.js"
+      },
       "types": "./lib/vite.d.ts",
-      "import": "./lib/vite.mjs",
       "default": "./lib/vite.js"
     },
     "./webpack": {
+      "import": {
+        "types": "./lib/webpack.d.mts",
+        "default": "./lib/webpack.mjs"
+      },
+      "require": {
+        "types": "./lib/webpack.d.cts",
+        "default": "./lib/webpack.js"
+      },
       "types": "./lib/webpack.d.ts",
-      "import": "./lib/webpack.mjs",
       "default": "./lib/webpack.js"
     },
     "./package.json": "./package.json"
@@ -95,7 +199,7 @@
     "unplugin": "^2.3.11"
   },
   "peerDependencies": {
-    "ttsc": "^0.28.1"
+    "ttsc": "^0.28.3"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.2",
@@ -105,10 +209,11 @@
     "rimraf": "^6.1.2",
     "rollup": "^4.60.3",
     "tinyglobby": "^0.2.16",
+    "ts-legacy": "npm:typescript@~6.0.3",
     "tslib": "^2.8.1",
     "typescript": "^7.0.2",
     "vite": "^7.3.5",
-    "ttsc": "0.28.1"
+    "ttsc": "0.28.3"
   },
   "repository": {
     "type": "git",
@@ -122,6 +227,6 @@
   "homepage": "https://ttsc.dev",
   "sideEffects": false,
   "scripts": {
-    "build": "rimraf lib && tsc --emitDeclarationOnly && rollup -c"
+    "build": "rimraf lib && tsc --emitDeclarationOnly && node scripts/emit-dual-declarations.mjs && rollup -c"
   }
 }

package/src/core/index.ts

@@ -55,6 +55,12 @@ const unpluginFactory: UnpluginFactory<
   let aliases: unknown;
   let viteCommand: string | undefined;
   let viteWatching = true;
+  // A restart can start the replacement plugin container before closing the
+  // old one, and Vite calls buildEnd even for a container that never started.
+  // Track the stable per-container PluginContext identity so that unstarted
+  // old containers cannot dispose a replacement's freshly initialized cache.
+  const viteBuildOwners = new WeakSet<object>();
+  let viteBuildLifecycles = 0;
 
   return {
     name,
@@ -89,13 +95,24 @@ const unpluginFactory: UnpluginFactory<
         missingInputs.attach(server);
       },
       // Vite calls buildEnd when the dev server (or build) closes; drop every
-      // poller so a stopped server leaks no watch state.
+      // poller and, once the last overlapping container has closed, every
+      // generation-owned filesystem tracker as well.
       buildEnd() {
         missingInputs.dispose();
+        if (viteBuildOwners.delete(this)) {
+          viteBuildLifecycles -= 1;
+        }
+        if (viteBuildLifecycles === 0) {
+          resetTtscTransformCache(transformCache);
+        }
       },
     },
 
     buildStart() {
+      if (viteCommand !== undefined && !viteBuildOwners.has(this as object)) {
+        viteBuildOwners.add(this as object);
+        viteBuildLifecycles += 1;
+      }
       // Persistent validation exists for a session that spans edits it can
       // observe, and a dev server told to open no watcher is not one:
       // `server.watch: null` leaves Vite with no change channel at all, so no