@ttsc/unplugin 0.28.1 → 0.28.2

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.2",
   "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.2"
   },
   "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.2"
   },
   "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"
   }
 }