rolldown-plugin-dts 0.13.6 → 0.13.8

package/README.md

@@ -6,7 +6,7 @@ A Rolldown plugin to generate and bundle dts files.
 
 ## Install
 
-⚠️ Requires `rolldown@1.0.0-beta.9` or later.
+Requires **`rolldown@1.0.0-beta.9`** or later.
 
 ```bash
 npm i rolldown-plugin-dts
@@ -31,90 +31,132 @@ You can find an example in [here](./rolldown.config.ts).
 
 ## Options
 
-```ts
-export interface Options {
-  /**
-   * The directory in which the plugin will search for the `tsconfig.json` file.
-   */
-  cwd?: string
-
-  /**
-   * Set to `true` if your entry files are `.d.ts` files instead of `.ts` files.
-   *
-   * When enabled, the plugin will skip generating a `.d.ts` file for the entry point.
-   */
-  dtsInput?: boolean
-
-  /**
-   * If `true`, the plugin will emit only `.d.ts` files and remove all other output chunks.
-   *
-   * This is especially useful when generating `.d.ts` files for the CommonJS format as part of a separate build step.
-   */
-  emitDtsOnly?: boolean
-
-  /**
-   * The path to the `tsconfig.json` file.
-   *
-   * If set to `false`, the plugin will ignore any `tsconfig.json` file.
-   * You can still specify `compilerOptions` directly in the options.
-   *
-   * @default 'tsconfig.json'
-   */
-  tsconfig?: string | boolean
-
-  /**
-   * Pass a raw `tsconfig.json` object directly to the plugin.
-   *
-   * @see https://www.typescriptlang.org/tsconfig
-   */
-  tsconfigRaw?: Omit<TsConfigJson, 'compilerOptions'>
-
-  /**
-   * Override the `compilerOptions` specified in `tsconfig.json`.
-   *
-   * @see https://www.typescriptlang.org/tsconfig/#compilerOptions
-   */
-  compilerOptions?: TsConfigJson.CompilerOptions
-
-  /**
-   * If `true`, the plugin will generate `.d.ts` files using Oxc,
-   * which is significantly faster than the TypeScript compiler.
-   *
-   * This option is automatically enabled when `isolatedDeclarations` in `compilerOptions` is set to `true`.
-   */
-  isolatedDeclarations?:
-    | boolean
-    | Omit<IsolatedDeclarationsOptions, 'sourcemap'>
-
-  /**
-   * If `true`, the plugin will generate declaration maps (`.d.ts.map`) for `.d.ts` files.
-   */
-  sourcemap?: boolean
-
-  /**
-   * Resolve external types used in `.d.ts` files from `node_modules`.
-   */
-  resolve?: boolean | (string | RegExp)[]
-
-  /**
-   * If `true`, the plugin will generate `.d.ts` files using `vue-tsc`.
-   */
-  vue?: boolean
-
-  /**
-   * If `true`, the plugin will launch a separate process for `tsc` or `vue-tsc`.
-   * This enables processing multiple projects in parallel.
-   */
-  parallel?: boolean
-
-  /**
-   * If `true`, the plugin will prepare all files listed in `tsconfig.json` for `tsc` or `vue-tsc`.
-   *
-   * This is especially useful when you have a single `tsconfig.json` for multiple projects in a monorepo.
-   */
-  eager?: boolean
-}
-```
+Configuration options for the plugin.
+Certainly! Here’s your documentation with simplified section titles (just the option name, no type annotation):
+
+---
+
+### cwd
+
+The directory in which the plugin will search for the `tsconfig.json` file.
+
+---
+
+### dtsInput
+
+Set to `true` if your entry files are `.d.ts` files instead of `.ts` files.
+
+When enabled, the plugin will skip generating a `.d.ts` file for the entry point.
+
+---
+
+### emitDtsOnly
+
+If `true`, the plugin will emit only `.d.ts` files and remove all other output chunks.
+
+This is especially useful when generating `.d.ts` files for the CommonJS format as part of a separate build step.
+
+---
+
+### tsconfig
+
+The path to the `tsconfig.json` file.
+
+- If set to `false`, the plugin will ignore any `tsconfig.json` file.
+- You can still specify `compilerOptions` directly in the options.
+
+**Default:** `'tsconfig.json'`
+
+---
+
+### tsconfigRaw
+
+Pass a raw `tsconfig.json` object directly to the plugin.
+
+See: [TypeScript tsconfig documentation](https://www.typescriptlang.org/tsconfig)
+
+---
+
+### incremental
+
+Controls how project references and incremental builds are handled:
+
+- If your `tsconfig.json` uses [`references`](https://www.typescriptlang.org/tsconfig/#references), the plugin will use [`tsc -b`](https://www.typescriptlang.org/docs/handbook/project-references.html#build-mode-for-typescript) to build the project and all referenced projects before emitting `.d.ts` files.
+- If `incremental` is `true`, all built files (including [`.tsbuildinfo`](https://www.typescriptlang.org/tsconfig/#tsBuildInfoFile)) will be written to disk, similar to running `tsc -b` in your project.
+- If `incremental` is `false`, built files are kept in memory, minimizing disk usage.
+
+Enabling this option can speed up builds by caching previous results, which is helpful for large projects with multiple references.
+
+**Default:** `true` if your `tsconfig` has [`incremental`](https://www.typescriptlang.org/tsconfig/#incremental) or [`tsBuildInfoFile`](https://www.typescriptlang.org/tsconfig/#tsBuildInfoFile) enabled.
+
+> [!NOTE]
+> This option is only used when [`isolatedDeclarations`](#isolateddeclarations) is `false`.
+
+---
+
+### compilerOptions
+
+Override the `compilerOptions` specified in `tsconfig.json`.
+
+See: [TypeScript compilerOptions documentation](https://www.typescriptlang.org/tsconfig/#compilerOptions)
+
+---
+
+### isolatedDeclarations
+
+If `true`, the plugin will generate `.d.ts` files using [Oxc](https://oxc.rs/docs/guide/usage/transformer.html), which is significantly faster than the TypeScript compiler.
+
+This option is automatically enabled when `isolatedDeclarations` in `compilerOptions` is set to `true`.
+
+---
+
+### sourcemap
+
+If `true`, the plugin will generate declaration maps (`.d.ts.map`) for `.d.ts` files.
+
+---
+
+### resolve
+
+Resolve external types used in `.d.ts` files from `node_modules`.
+
+- If `true`, all external types are resolved.
+- If an array, only types matching the provided strings or regular expressions are resolved.
+
+---
+
+### vue
+
+If `true`, the plugin will generate `.d.ts` files using `vue-tsc`.
+
+---
+
+### parallel
+
+If `true`, the plugin will launch a separate process for `tsc` or `vue-tsc`, enabling parallel processing of multiple projects.
+
+---
+
+### eager
+
+If `true`, the plugin will prepare all files listed in `tsconfig.json` for `tsc` or `vue-tsc`.
+
+This is especially useful when you have a single `tsconfig.json` for multiple projects in a monorepo.
+
+---
+
+### tsgo
+
+**[Experimental]** Enables DTS generation using [`tsgo`](https://github.com/microsoft/typescript-go).
+
+- To use this option, ensure that `@typescript/native-preview` is installed as a dependency.
+- Set to `true` to enable `tsgo` for the current project.
+- If a string is provided, it should be the root path of your source files.
+
+> [!WARNING]
+> This option is experimental and not yet recommended for production environments.
+
+---
 
 ## Differences from `rollup-plugin-dts`
 

package/dist/filename-Dpr2dKWZ.js

@@ -0,0 +1,25 @@
+import path from "node:path";
+
+//#region src/filename.ts
+const RE_JS = /\.([cm]?)jsx?$/;
+const RE_TS = /\.([cm]?)tsx?$/;
+const RE_DTS = /\.d\.([cm]?)ts$/;
+const RE_DTS_MAP = /\.d\.([cm]?)ts\.map$/;
+const RE_NODE_MODULES = /[\\/]node_modules[\\/]/;
+const RE_CSS = /\.css$/;
+const RE_VUE = /\.vue$/;
+function filename_js_to_dts(id) {
+	return id.replace(RE_JS, ".d.$1ts");
+}
+function filename_ts_to_dts(id) {
+	return id.replace(RE_VUE, ".vue.ts").replace(RE_TS, ".d.$1ts");
+}
+function filename_dts_to(id, ext) {
+	return id.replace(RE_DTS, `.$1${ext}`);
+}
+function isRelative(id) {
+	return path.isAbsolute(id) || id[0] === ".";
+}
+
+//#endregion
+export { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, filename_dts_to, filename_js_to_dts, filename_ts_to_dts, isRelative };

package/dist/filename-TbnZq0n4.d.ts

@@ -0,0 +1,14 @@
+//#region src/filename.d.ts
+declare const RE_JS: RegExp;
+declare const RE_TS: RegExp;
+declare const RE_DTS: RegExp;
+declare const RE_DTS_MAP: RegExp;
+declare const RE_NODE_MODULES: RegExp;
+declare const RE_CSS: RegExp;
+declare const RE_VUE: RegExp;
+declare function filename_js_to_dts(id: string): string;
+declare function filename_ts_to_dts(id: string): string;
+declare function filename_dts_to(id: string, ext: "js" | "ts"): string;
+declare function isRelative(id: string): boolean;
+//#endregion
+export { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, filename_dts_to, filename_js_to_dts, filename_ts_to_dts, isRelative };

package/dist/filename.d.ts

@@ -0,0 +1,2 @@
+import { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, filename_dts_to, filename_js_to_dts, filename_ts_to_dts, isRelative } from "./filename-TbnZq0n4.js";
+export { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, filename_dts_to, filename_js_to_dts, filename_ts_to_dts, isRelative };

package/dist/filename.js

@@ -0,0 +1,3 @@
+import { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, filename_dts_to, filename_js_to_dts, filename_ts_to_dts, isRelative } from "./filename-Dpr2dKWZ.js";
+
+export { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, filename_dts_to, filename_js_to_dts, filename_ts_to_dts, isRelative };

package/dist/index.d.ts

@@ -1,34 +1,9 @@
-import { TsConfigJson } from "get-tsconfig";
+import { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE } from "./filename-TbnZq0n4.js";
 import { IsolatedDeclarationsOptions } from "rolldown/experimental";
+import { TsConfigJson } from "get-tsconfig";
 import { Plugin } from "rolldown";
 
-//#region src/fake-js.d.ts
-declare function createFakeJsPlugin({
-  dtsInput,
-  sourcemap
-}: Pick<OptionsResolved, "dtsInput" | "sourcemap">): Plugin;
-//#endregion
-//#region src/generate.d.ts
-declare function createGeneratePlugin({
-  tsconfigRaw,
-  tsconfigDir,
-  isolatedDeclarations,
-  emitDtsOnly,
-  vue,
-  parallel,
-  eager
-}: Pick<OptionsResolved, "tsconfigRaw" | "tsconfigDir" | "isolatedDeclarations" | "emitDtsOnly" | "vue" | "parallel" | "eager">): Plugin;
-//#endregion
-//#region src/utils/filename.d.ts
-declare const RE_JS: RegExp;
-declare const RE_TS: RegExp;
-declare const RE_DTS: RegExp;
-declare const RE_DTS_MAP: RegExp;
-declare const RE_NODE_MODULES: RegExp;
-declare const RE_CSS: RegExp;
-declare const RE_VUE: RegExp;
-//#endregion
-//#region src/index.d.ts
+//#region src/options.d.ts
 interface Options {
   /**
   * The directory in which the plugin will search for the `tsconfig.json` file.
@@ -62,6 +37,36 @@ interface Options {
   */
   tsconfigRaw?: Omit<TsConfigJson, "compilerOptions">;
   /**
+  * If your tsconfig.json has
+  * [`references`](https://www.typescriptlang.org/tsconfig/#references) option,
+  * `rolldown-plugin-dts` will use [`tsc
+  * -b`](https://www.typescriptlang.org/docs/handbook/project-references.html#build-mode-for-typescript)
+  * to build the project and all referenced projects before emitting `.d.ts`
+  * files.
+  *
+  * In such case, if this option is `true`, `rolldown-plugin-dts` will write
+  * down all built files into your disk, including
+  * [`.tsbuildinfo`](https://www.typescriptlang.org/tsconfig/#tsBuildInfoFile)
+  * and other built files. This is equivalent to running `tsc -b` in your
+  * project.
+  *
+  * Otherwise, if this option is `false`, `rolldown-plugin-dts` will write
+  * built files only into memory and leave a small footprint in your disk.
+  *
+  * Enabling this option will decrease the build time by caching previous build
+  * results. This is helpful when you have a large project with multiple
+  * referenced projects.
+  *
+  * By default, `incremental` is `true` if your tsconfig has
+  * [`incremental`](https://www.typescriptlang.org/tsconfig/#incremental) or
+  * [`tsBuildInfoFile`](https://www.typescriptlang.org/tsconfig/#tsBuildInfoFile)
+  * enabled.
+  *
+  * This option is only used when {@link Options.isolatedDeclarations} is
+  * `false`.
+  */
+  incremental?: boolean;
+  /**
   * Override the `compilerOptions` specified in `tsconfig.json`.
   *
   * @see https://www.typescriptlang.org/tsconfig/#compilerOptions
@@ -97,18 +102,25 @@ interface Options {
   * This is especially useful when you have a single `tsconfig.json` for multiple projects in a monorepo.
   */
   eager?: boolean;
+  /**
+  * **[Experimental]** Enables DTS generation using `tsgo`.
+  *
+  * To use this option, make sure `@typescript/native-preview` is installed as a dependency.
+  *
+  * **Note:** This option is not yet recommended for production environments.
+  */
+  tsgo?: boolean | string;
 }
 type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
 type OptionsResolved = Overwrite<Required<Omit<Options, "compilerOptions">>, {
   tsconfig: string | undefined;
   isolatedDeclarations: IsolatedDeclarationsOptions | false;
   tsconfigRaw: TsConfigJson;
-  tsconfigDir: string;
 }>;
-declare function dts(options?: Options): Plugin[];
 declare function resolveOptions({
   cwd,
   tsconfig,
+  incremental,
   compilerOptions,
   tsconfigRaw: overriddenTsconfigRaw,
   isolatedDeclarations,
@@ -118,7 +130,31 @@ declare function resolveOptions({
   resolve,
   vue,
   parallel,
-  eager
+  eager,
+  tsgo
 }: Options): OptionsResolved;
 //#endregion
-export { Options, OptionsResolved, RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, createFakeJsPlugin, createGeneratePlugin, dts, resolveOptions };
+//#region src/fake-js.d.ts
+declare function createFakeJsPlugin({
+  dtsInput,
+  sourcemap
+}: Pick<OptionsResolved, "dtsInput" | "sourcemap">): Plugin;
+//#endregion
+//#region src/generate.d.ts
+declare function createGeneratePlugin({
+  tsconfig,
+  tsconfigRaw,
+  incremental,
+  cwd,
+  isolatedDeclarations,
+  emitDtsOnly,
+  vue,
+  parallel,
+  eager,
+  tsgo
+}: Pick<OptionsResolved, "cwd" | "tsconfig" | "tsconfigRaw" | "incremental" | "isolatedDeclarations" | "emitDtsOnly" | "vue" | "parallel" | "eager" | "tsgo">): Plugin;
+//#endregion
+//#region src/index.d.ts
+declare function dts(options?: Options): Plugin[];
+//#endregion
+export { Options, RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, createFakeJsPlugin, createGeneratePlugin, dts, resolveOptions };

package/dist/index.js

@@ -1,14 +1,18 @@
+import { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, filename_dts_to, filename_js_to_dts, filename_ts_to_dts } from "./filename-Dpr2dKWZ.js";
 import path from "node:path";
-import process from "node:process";
 import Debug from "debug";
-import { getTsconfig, parseTsconfig } from "get-tsconfig";
 import _generate from "@babel/generator";
 import { parse } from "@babel/parser";
 import * as t from "@babel/types";
 import { isDeclarationType, isTypeOf } from "ast-kit";
-import { fork } from "node:child_process";
+import { fork, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
 import { createBirpc } from "birpc";
 import { ResolverFactory, isolatedDeclaration } from "rolldown/experimental";
+import process from "node:process";
+import { getTsconfig, parseTsconfig } from "get-tsconfig";
 import { createResolver } from "dts-resolver";
 
 //#region src/dts-input.ts
@@ -223,33 +227,14 @@ function walk(ast, { enter, leave }) {
 	return instance.visit(ast, null);
 }
 
-//#endregion
-//#region src/utils/filename.ts
-const RE_JS = /\.([cm]?)jsx?$/;
-const RE_TS = /\.([cm]?)tsx?$/;
-const RE_DTS = /\.d\.([cm]?)ts$/;
-const RE_DTS_MAP = /\.d\.([cm]?)ts\.map$/;
-const RE_NODE_MODULES = /[\\/]node_modules[\\/]/;
-const RE_CSS = /\.css$/;
-const RE_VUE = /\.vue$/;
-function filename_js_to_dts(id) {
-	return id.replace(RE_JS, ".d.$1ts");
-}
-function filename_ts_to_dts(id) {
-	return id.replace(RE_VUE, ".vue.ts").replace(RE_TS, ".d.$1ts");
-}
-function filename_dts_to(id, ext) {
-	return id.replace(RE_DTS, `.$1${ext}`);
-}
-
 //#endregion
 //#region src/fake-js.ts
 const generate = _generate.default || _generate;
 function createFakeJsPlugin({ dtsInput, sourcemap }) {
 	let symbolIdx = 0;
 	let identifierIdx = 0;
-	const symbolMap = new Map();
-	const commentsMap = new Map();
+	const symbolMap = /* @__PURE__ */ new Map();
+	const commentsMap = /* @__PURE__ */ new Map();
 	return {
 		name: "rolldown-plugin-dts:fake-js",
 		outputOptions(options) {
@@ -288,7 +273,7 @@ function createFakeJsPlugin({ dtsInput, sourcemap }) {
 			commentsMap.set(id, directives);
 		}
 		const appendStmts = [];
-		const namespaceStmts = new Map();
+		const namespaceStmts = /* @__PURE__ */ new Map();
 		for (const [i, stmt] of program.body.entries()) {
 			const setStmt = (node) => program.body[i] = node;
 			if (rewriteImportExport(stmt, setStmt)) continue;
@@ -401,8 +386,8 @@ function createFakeJsPlugin({ dtsInput, sourcemap }) {
 			return inheritNodeComments(node, original.decl);
 		}).filter((node) => !!node);
 		if (program.body.length === 0) return "export { };";
-		const comments = new Set();
-		const commentsValue = new Set();
+		const comments = /* @__PURE__ */ new Set();
+		const commentsValue = /* @__PURE__ */ new Set();
 		for (const id of chunk.moduleIds) {
 			const preserveComments = commentsMap.get(id);
 			if (preserveComments) {
@@ -438,8 +423,8 @@ function createFakeJsPlugin({ dtsInput, sourcemap }) {
 		return symbolMap.get(symbolId);
 	}
 	function collectDependencies(node, namespaceStmts) {
-		const deps = new Set();
-		const seen = new Set();
+		const deps = /* @__PURE__ */ new Set();
+		const seen = /* @__PURE__ */ new Set();
 		walk(node, { leave(node$1) {
 			if (node$1.type === "ExportNamedDeclaration") {
 				for (const specifier of node$1.specifiers) if (specifier.type === "ExportSpecifier") addDependency(specifier.local);
@@ -528,8 +513,8 @@ function patchImportSource(node) {
 	}
 }
 function patchTsNamespace(nodes) {
-	const emptyObjectAssignments = new Map();
-	const removed = new Set();
+	const emptyObjectAssignments = /* @__PURE__ */ new Map();
+	const removed = /* @__PURE__ */ new Set();
 	for (const [i, node] of nodes.entries()) {
 		if (node.type === "VariableDeclaration" && node.declarations.length === 1 && node.declarations[0].id.type === "Identifier" && node.declarations[0].init?.type === "ObjectExpression" && node.declarations[0].init.properties.length === 0) emptyObjectAssignments.set(node.declarations[0].id.name, node);
 		if (node.type !== "ExpressionStatement" || node.expression.type !== "CallExpression" || node.expression.callee.type !== "Identifier" || !node.expression.callee.name.startsWith("__export")) continue;
@@ -626,8 +611,13 @@ function inheritNodeComments(oldNode, newNode) {
 //#region src/generate.ts
 const debug$1 = Debug("rolldown-plugin-dts:generate");
 const WORKER_URL = "./utils/tsc-worker.js";
-function createGeneratePlugin({ tsconfigRaw, tsconfigDir, isolatedDeclarations, emitDtsOnly, vue, parallel, eager }) {
-	const dtsMap = new Map();
+const spawnAsync = (...args) => new Promise((resolve, reject) => {
+	const child = spawn(...args);
+	child.on("close", () => resolve());
+	child.on("error", (error) => reject(error));
+});
+function createGeneratePlugin({ tsconfig, tsconfigRaw, incremental, cwd, isolatedDeclarations, emitDtsOnly, vue, parallel, eager, tsgo }) {
+	const dtsMap = /* @__PURE__ */ new Map();
 	/**
 	* A map of input id to output file name
 	*
@@ -637,11 +627,12 @@ function createGeneratePlugin({ tsconfigRaw, tsconfigDir, isolatedDeclarations,
 	*   ['/absolute/path/to/src/source_file.ts', 'dist/foo/index'],
 	* ])
 	*/
-	const inputAliasMap = new Map();
+	const inputAliasMap = /* @__PURE__ */ new Map();
 	let childProcess;
 	let rpc;
 	let tscEmit;
-	if (parallel) {
+	let tsgoDist;
+	if (!tsgo && parallel) {
 		childProcess = fork(new URL(WORKER_URL, import.meta.url), { stdio: "inherit" });
 		rpc = createBirpc({}, {
 			post: (data) => childProcess.send(data),
@@ -651,7 +642,21 @@ function createGeneratePlugin({ tsconfigRaw, tsconfigDir, isolatedDeclarations,
 	return {
 		name: "rolldown-plugin-dts:generate",
 		async buildStart(options) {
-			if (!parallel && (!isolatedDeclarations || vue)) ({tscEmit} = await import("./tsc-BKvojRml.js"));
+			if (tsgo) {
+				const tsgoPkg = import.meta.resolve("@typescript/native-preview/package.json");
+				const { default: getExePath } = await import(new URL("./lib/getExePath.js", tsgoPkg).href);
+				const tsgo$1 = getExePath();
+				tsgoDist = await mkdtemp(path.join(tmpdir(), "rolldown-plugin-dts-"));
+				await spawnAsync(tsgo$1, [
+					"--noEmit",
+					"false",
+					"--declaration",
+					"--emitDeclarationOnly",
+					...tsconfig ? ["-p", tsconfig] : [],
+					"--outDir",
+					tsgoDist
+				], { stdio: "inherit" });
+			} else if (!parallel && (!isolatedDeclarations || vue)) ({tscEmit} = await import("./tsc-sXJZixaR.js"));
 			if (!Array.isArray(options.input)) for (const [name, id] of Object.entries(options.input)) {
 				debug$1("resolving input alias %s -> %s", name, id);
 				let resolved = await this.resolve(id);
@@ -716,7 +721,12 @@ function createGeneratePlugin({ tsconfigRaw, tsconfigDir, isolatedDeclarations,
 				let dtsCode;
 				let map;
 				debug$1("generate dts %s from %s", dtsId, id);
-				if (isolatedDeclarations && !RE_VUE.test(id)) {
+				if (tsgo) {
+					if (RE_VUE.test(id)) throw new Error("tsgo does not support Vue files.");
+					const dtsPath = path.resolve(tsgoDist, path.relative(path.resolve(typeof tsgo === "string" ? tsgo : "src"), filename_ts_to_dts(id)));
+					if (existsSync(dtsPath)) dtsCode = await readFile(dtsPath, "utf8");
+					else throw new Error(`tsgo did not generate dts file for ${id}, please check your tsconfig.`);
+				} else if (isolatedDeclarations && !RE_VUE.test(id)) {
 					const result = isolatedDeclaration(id, code, isolatedDeclarations);
 					if (result.errors.length) {
 						const [error] = result.errors;
@@ -733,8 +743,10 @@ function createGeneratePlugin({ tsconfigRaw, tsconfigDir, isolatedDeclarations,
 				} else {
 					const entries = eager ? void 0 : Array.from(dtsMap.values()).filter((v) => v.isEntry).map((v) => v.id);
 					const options = {
+						tsconfig,
 						tsconfigRaw,
-						tsconfigDir,
+						incremental,
+						cwd,
 						entries,
 						id,
 						vue
@@ -756,12 +768,71 @@ function createGeneratePlugin({ tsconfigRaw, tsconfigDir, isolatedDeclarations,
 		generateBundle: emitDtsOnly ? (options, bundle) => {
 			for (const fileName of Object.keys(bundle)) if (bundle[fileName].type === "chunk" && !RE_DTS.test(fileName) && !RE_DTS_MAP.test(fileName)) delete bundle[fileName];
 		} : void 0,
-		buildEnd() {
+		async buildEnd() {
 			childProcess?.kill();
+			if (tsgoDist) {
+				await rm(tsgoDist, {
+					recursive: true,
+					force: true
+				}).catch(() => {});
+				tsgoDist = void 0;
+			}
 		}
 	};
 }
 
+//#endregion
+//#region src/options.ts
+let warnedTsgo = false;
+function resolveOptions({ cwd = process.cwd(), tsconfig, incremental = false, compilerOptions = {}, tsconfigRaw: overriddenTsconfigRaw = {}, isolatedDeclarations, sourcemap, dtsInput = false, emitDtsOnly = false, resolve = false, vue = false, parallel = false, eager = false, tsgo = false }) {
+	let resolvedTsconfig;
+	if (tsconfig === true || tsconfig == null) {
+		const { config, path: path$1 } = getTsconfig(cwd) || {};
+		tsconfig = path$1;
+		resolvedTsconfig = config;
+	} else if (typeof tsconfig === "string") {
+		tsconfig = path.resolve(cwd || process.cwd(), tsconfig);
+		resolvedTsconfig = parseTsconfig(tsconfig);
+	} else tsconfig = void 0;
+	compilerOptions = {
+		...resolvedTsconfig?.compilerOptions,
+		...compilerOptions
+	};
+	incremental ||= compilerOptions.incremental || !!compilerOptions.tsBuildInfoFile;
+	sourcemap ??= !!compilerOptions.declarationMap;
+	compilerOptions.declarationMap = sourcemap;
+	const tsconfigRaw = {
+		...resolvedTsconfig,
+		...overriddenTsconfigRaw,
+		compilerOptions
+	};
+	if (isolatedDeclarations == null) isolatedDeclarations = !!compilerOptions?.isolatedDeclarations;
+	if (isolatedDeclarations === true) isolatedDeclarations = {};
+	if (isolatedDeclarations) {
+		isolatedDeclarations.stripInternal ??= !!compilerOptions?.stripInternal;
+		isolatedDeclarations.sourcemap = !!compilerOptions.declarationMap;
+	}
+	if (tsgo && !warnedTsgo) {
+		console.warn("The `tsgo` option is experimental and may change in the future.");
+		warnedTsgo = true;
+	}
+	return {
+		cwd,
+		tsconfig,
+		tsconfigRaw,
+		incremental,
+		isolatedDeclarations,
+		sourcemap,
+		dtsInput,
+		emitDtsOnly,
+		resolve,
+		vue,
+		parallel,
+		eager,
+		tsgo
+	};
+}
+
 //#endregion
 //#region src/resolve.ts
 function createDtsResolvePlugin({ tsconfig, resolve }) {
@@ -822,49 +893,6 @@ function dts(options = {}) {
 	plugins.push(createDtsResolvePlugin(resolved), createFakeJsPlugin(resolved));
 	return plugins;
 }
-function resolveOptions({ cwd = process.cwd(), tsconfig, compilerOptions = {}, tsconfigRaw: overriddenTsconfigRaw = {}, isolatedDeclarations, sourcemap, dtsInput = false, emitDtsOnly = false, resolve = false, vue = false, parallel = false, eager = false }) {
-	let resolvedTsconfig;
-	if (tsconfig === true || tsconfig == null) {
-		const { config, path: path$1 } = getTsconfig(cwd) || {};
-		tsconfig = path$1;
-		resolvedTsconfig = config;
-	} else if (typeof tsconfig === "string") {
-		tsconfig = path.resolve(cwd || process.cwd(), tsconfig);
-		resolvedTsconfig = parseTsconfig(tsconfig);
-	} else tsconfig = void 0;
-	compilerOptions = {
-		...resolvedTsconfig?.compilerOptions,
-		...compilerOptions
-	};
-	sourcemap ??= !!compilerOptions.declarationMap;
-	compilerOptions.declarationMap = sourcemap;
-	const tsconfigRaw = {
-		...resolvedTsconfig,
-		...overriddenTsconfigRaw,
-		compilerOptions
-	};
-	const tsconfigDir = tsconfig ? path.dirname(tsconfig) : cwd;
-	if (isolatedDeclarations == null) isolatedDeclarations = !!compilerOptions?.isolatedDeclarations;
-	if (isolatedDeclarations === true) isolatedDeclarations = {};
-	if (isolatedDeclarations) {
-		isolatedDeclarations.stripInternal ??= !!compilerOptions?.stripInternal;
-		isolatedDeclarations.sourcemap = !!compilerOptions.declarationMap;
-	}
-	return {
-		cwd,
-		tsconfig,
-		tsconfigDir,
-		tsconfigRaw,
-		isolatedDeclarations,
-		sourcemap,
-		dtsInput,
-		emitDtsOnly,
-		resolve,
-		vue,
-		parallel,
-		eager
-	};
-}
 
 //#endregion
 export { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE, createFakeJsPlugin, createGeneratePlugin, dts, resolveOptions };

package/dist/{tsc-yr4fe8f_.js → tsc-BjgfmUbK.js}

@@ -1,7 +1,52 @@
 import { createRequire } from "node:module";
+import path from "node:path";
 import Debug from "debug";
 import ts from "typescript";
 
+//#region src/utils/tsc-system.ts
+const debug$2 = Debug("rolldown-plugin-dts:tsc-system");
+const files = /* @__PURE__ */ new Map();
+const fsSystem = {
+	...ts.sys,
+	write(message) {
+		debug$2(message);
+	},
+	resolvePath(path$1) {
+		if (files.has(path$1)) return path$1;
+		return ts.sys.resolvePath(path$1);
+	},
+	directoryExists(directory) {
+		if (Array.from(files.keys()).some((path$1) => path$1.startsWith(directory))) return true;
+		return ts.sys.directoryExists(directory);
+	},
+	fileExists(fileName) {
+		if (files.has(fileName)) return true;
+		return ts.sys.fileExists(fileName);
+	},
+	readFile(fileName, ...args) {
+		if (files.has(fileName)) return files.get(fileName);
+		return ts.sys.readFile(fileName, ...args);
+	},
+	writeFile(path$1, data, ...args) {
+		files.set(path$1, data);
+		ts.sys.writeFile(path$1, data, ...args);
+	},
+	deleteFile(fileName, ...args) {
+		files.delete(fileName);
+		ts.sys.deleteFile?.(fileName, ...args);
+	}
+};
+const memorySystem = {
+	...fsSystem,
+	writeFile(path$1, data) {
+		files.set(path$1, data);
+	},
+	deleteFile(fileName) {
+		files.delete(fileName);
+	}
+};
+
+//#endregion
 //#region src/utils/vue.ts
 const debug$1 = Debug("rolldown-plugin-dts:vue");
 let createVueProgram;
@@ -74,14 +119,38 @@ function createOrGetTsModule(options) {
 	programs.push(module.program);
 	return module;
 }
-function createTsProgram({ entries, id, tsconfigRaw, tsconfigDir, vue }) {
-	const parsedCmd = ts.parseJsonConfigFileContent(tsconfigRaw, ts.sys, tsconfigDir);
+/**
+* Build the root project and all its dependencies projects.
+* This is designed for a project (e.g. tsconfig.json) that has "references" to
+* other composite projects (e.g., tsconfig.node.json and tsconfig.app.json).
+* If `incremental` is `true`, the build result will be cached in the
+* `.tsbuildinfo` file so that the next time the project is built (without
+* changes) the build will be super fast. If `incremental` is `false`, the
+* `.tsbuildinfo` file will only be written to the memory.
+*/
+function buildSolution(tsconfig, incremental) {
+	debug(`building projects for ${tsconfig} with incremental: ${incremental}`);
+	const system = incremental ? fsSystem : memorySystem;
+	const host = ts.createSolutionBuilderHost(system);
+	const builder = ts.createSolutionBuilder(host, [tsconfig], {
+		force: !incremental,
+		verbose: true
+	});
+	const exitStatus = builder.build();
+	debug(`built solution for ${tsconfig} with exit status ${exitStatus}`);
+}
+function createTsProgram({ entries, id, tsconfig, tsconfigRaw, incremental, vue, cwd }) {
+	const parsedCmd = ts.parseJsonConfigFileContent(tsconfigRaw, fsSystem, tsconfig ? path.dirname(tsconfig) : cwd);
+	if (tsconfig && parsedCmd.projectReferences?.length) buildSolution(tsconfig, incremental);
 	const compilerOptions = {
 		...defaultCompilerOptions,
 		...parsedCmd.options
 	};
-	const rootNames = [...new Set([id, ...entries || parsedCmd.fileNames].map((f) => ts.sys.resolvePath(f)))];
+	const rootNames = [...new Set([id, ...entries || parsedCmd.fileNames].map((f) => fsSystem.resolvePath(f)))];
 	const host = ts.createCompilerHost(compilerOptions, true);
+	host.readFile = fsSystem.readFile;
+	host.fileExists = fsSystem.fileExists;
+	host.directoryExists = fsSystem.directoryExists;
 	const createProgram = vue ? createVueProgramFactory(ts) : ts.createProgram;
 	const program = createProgram({
 		rootNames,
@@ -90,15 +159,26 @@ function createTsProgram({ entries, id, tsconfigRaw, tsconfigDir, vue }) {
 		projectReferences: parsedCmd.projectReferences
 	});
 	const sourceFile = program.getSourceFile(id);
-	if (!sourceFile) throw new Error(`Source file not found: ${id}`);
+	if (!sourceFile) {
+		debug(`source file not found in program: ${id}`);
+		if (!fsSystem.fileExists(id)) {
+			debug(`File ${id} does not exist on disk.`);
+			throw new Error(`Source file not found: ${id}`);
+		} else {
+			debug(`File ${id} exists on disk.`);
+			throw new Error(`Unable to load file ${id} from the program. This seems like a bug of rolldown-plugin-dts. Please report this issue to https://github.com/sxzz/rolldown-plugin-dts/issues`);
+		}
+	}
 	return {
 		program,
 		file: sourceFile
 	};
 }
 function tscEmit(tscOptions) {
+	debug(`running tscEmit ${tscOptions.id}`);
 	const module = createOrGetTsModule(tscOptions);
 	const { program, file } = module;
+	debug(`got source file: ${file.fileName}`);
 	let dtsCode;
 	let map;
 	const { emitSkipped, diagnostics } = program.emit(file, (fileName, code) => {
@@ -111,6 +191,10 @@ function tscEmit(tscOptions) {
 		}
 	}, void 0, true, void 0, true);
 	if (emitSkipped && diagnostics.length) return { error: ts.formatDiagnostics(diagnostics, formatHost) };
+	if (!dtsCode && file.isDeclarationFile) {
+		debug("nothing was emitted. fallback to sourceFile text.");
+		dtsCode = file.getFullText();
+	}
 	return {
 		code: dtsCode,
 		map

package/dist/tsc-sXJZixaR.js

@@ -0,0 +1,3 @@
+import { tscEmit } from "./tsc-BjgfmUbK.js";
+
+export { tscEmit };

package/dist/utils/tsc-worker.d.ts

@@ -1,18 +1,21 @@
 import { TsConfigJson } from "get-tsconfig";
 import ts from "typescript";
+import { SourceMapInput } from "rolldown";
 
 //#region src/utils/tsc.d.ts
 
 interface TscOptions {
+  tsconfig?: string;
   tsconfigRaw: TsConfigJson;
-  tsconfigDir: string;
+  cwd: string;
+  incremental: boolean;
   entries?: string[];
   id: string;
   vue?: boolean;
 }
 interface TscResult {
   code?: string;
-  map?: any;
+  map?: SourceMapInput;
   error?: string;
 }
 declare function tscEmit(tscOptions: TscOptions): TscResult;

package/dist/utils/tsc-worker.js

@@ -1,6 +1,6 @@
-import { tscEmit } from "../tsc-yr4fe8f_.js";
-import process from "node:process";
+import { tscEmit } from "../tsc-BjgfmUbK.js";
 import { createBirpc } from "birpc";
+import process from "node:process";
 
 //#region src/utils/tsc-worker.ts
 const functions = { tscEmit };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rolldown-plugin-dts",
-  "version": "0.13.6",
+  "version": "0.13.8",
   "description": "A Rolldown plugin to bundle dts files",
   "type": "module",
   "license": "MIT",
@@ -22,17 +22,22 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
+    "./filename": "./dist/filename.js",
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
+    "@typescript/native-preview": ">=7.0.0-dev.20250601.1",
     "rolldown": "^1.0.0-beta.9",
     "typescript": "^5.0.0",
     "vue-tsc": "~2.2.0"
   },
   "peerDependenciesMeta": {
+    "@typescript/native-preview": {
+      "optional": true
+    },
     "typescript": {
       "optional": true
     },
@@ -41,42 +46,46 @@
     }
   },
   "dependencies": {
-    "@babel/generator": "^7.27.3",
-    "@babel/parser": "^7.27.3",
+    "@babel/generator": "^7.27.5",
+    "@babel/parser": "^7.27.5",
     "@babel/types": "^7.27.3",
-    "ast-kit": "^2.0.0",
+    "ast-kit": "^2.1.0",
     "birpc": "^2.3.0",
     "debug": "^4.4.1",
-    "dts-resolver": "^2.0.1",
+    "dts-resolver": "^2.1.1",
     "get-tsconfig": "^4.10.1"
   },
   "devDependencies": {
-    "@sxzz/eslint-config": "^7.0.1",
+    "@sxzz/eslint-config": "^7.0.2",
     "@sxzz/prettier-config": "^2.2.1",
     "@sxzz/test-utils": "^0.5.6",
     "@types/babel__generator": "^7.27.0",
     "@types/debug": "^4.1.12",
-    "@types/node": "^22.15.21",
+    "@types/node": "^22.15.29",
+    "@typescript/native-preview": "7.0.0-dev.20250604.1",
     "@volar/typescript": "^2.4.14",
     "@vue/language-core": "^2.2.10",
     "bumpp": "^10.1.1",
     "diff": "^8.0.2",
-    "eslint": "^9.27.0",
+    "eslint": "^9.28.0",
     "estree-walker": "^3.0.3",
     "prettier": "^3.5.3",
-    "rolldown": "1.0.0-beta.9",
+    "rolldown": "1.0.0-beta.11-commit.f051675",
     "rollup-plugin-dts": "^6.2.1",
     "tinyglobby": "^0.2.14",
-    "tsdown": "^0.12.3",
+    "tsdown": "^0.12.6",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.4",
-    "vue": "^3.5.15",
+    "vitest": "^3.2.1",
+    "vue": "^3.5.16",
     "vue-tsc": "^2.2.10"
   },
   "engines": {
     "node": ">=20.18.0"
   },
+  "resolutions": {
+    "rolldown": "1.0.0-beta.11-commit.f051675"
+  },
   "prettier": "@sxzz/prettier-config",
   "scripts": {
     "lint": "eslint --cache .",

package/dist/tsc-BKvojRml.js

@@ -1,3 +0,0 @@
-import { tscEmit } from "./tsc-yr4fe8f_.js";
-
-export { tscEmit };