rolldown-plugin-dts 0.21.0 → 0.21.1

package/README.md

@@ -190,13 +190,13 @@ To use this option, ensure that `@typescript/native-preview` is installed as a d
 
 `tsconfigRaw` and `compilerOptions` options will be ignored when this option is enabled.
 
-## Advanced Chunks Support
+## Code Splitting Support
 
-When using Rolldown's advanced chunking features such as `manualChunks` or `advancedChunks`, you should pay special attention to handling `.d.ts` files. The chunk names for `.d.ts` files must end with `.d`.
+When using Rolldown's code splitting features `codeSplitting`, you should pay special attention to handling `.d.ts` files. The chunk names for `.d.ts` files must end with `.d`.
 
 ```ts
 export default {
-  advancedChunks: {
+  codeSplitting: {
     groups: [
       // handle .d.ts files
       { test: /foo.*\.d\.[cm]?ts$/, name: 'shared.d' },

package/dist/index.d.mts

@@ -5,168 +5,168 @@ import { Plugin } from "rolldown";
 //#region src/options.d.ts
 interface GeneralOptions {
   /**
-  * The directory in which the plugin will search for the `tsconfig.json` file.
-  */
+  	* 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.
-  */
+  	* 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.
-  */
+  	* 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'
-  */
+  	* 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
-  */
+  	* 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
-  */
+  	* Override the `compilerOptions` specified in `tsconfig.json`.
+  	*
+  	* @see https://www.typescriptlang.org/tsconfig/#compilerOptions
+  	*/
   compilerOptions?: TsConfigJson.CompilerOptions;
   /**
-  * If `true`, the plugin will generate declaration maps (`.d.ts.map`) for `.d.ts` files.
-  */
+  	* If `true`, the plugin will generate declaration maps (`.d.ts.map`) for `.d.ts` files.
+  	*/
   sourcemap?: boolean;
   /**
-  * Specifies a resolver to resolve type definitions, especially for `node_modules`.
-  *
-  * - `'oxc'`: Uses Oxc's module resolution, which is faster and more efficient.
-  * - `'tsc'`: Uses TypeScript's native module resolution, which may be more compatible with complex setups, but slower.
-  *
-  * @default 'oxc'
-  */
+  	* Specifies a resolver to resolve type definitions, especially for `node_modules`.
+  	*
+  	* - `'oxc'`: Uses Oxc's module resolution, which is faster and more efficient.
+  	* - `'tsc'`: Uses TypeScript's native module resolution, which may be more compatible with complex setups, but slower.
+  	*
+  	* @default 'oxc'
+  	*/
   resolver?: "oxc" | "tsc";
   /**
-  * Determines how the default export is emitted.
-  *
-  * If set to `true`, and you are only exporting a single item using `export default ...`,
-  * the output will use `export = ...` instead of the standard ES module syntax.
-  * This is useful for compatibility with CommonJS.
-  */
+  	* Determines how the default export is emitted.
+  	*
+  	* If set to `true`, and you are only exporting a single item using `export default ...`,
+  	* the output will use `export = ...` instead of the standard ES module syntax.
+  	* This is useful for compatibility with CommonJS.
+  	*/
   cjsDefault?: boolean;
   /**
-  * Indicates whether the generated `.d.ts` files have side effects.
-  * - If set to `true`, Rolldown will treat the `.d.ts` files as having side effects during tree-shaking.
-  * - If set to `false`, Rolldown may consider the `.d.ts` files as side-effect-free, potentially removing them if they are not imported.
-  *
-  * @default false
-  */
+  	* Indicates whether the generated `.d.ts` files have side effects.
+  	* - If set to `true`, Rolldown will treat the `.d.ts` files as having side effects during tree-shaking.
+  	* - If set to `false`, Rolldown may consider the `.d.ts` files as side-effect-free, potentially removing them if they are not imported.
+  	*
+  	* @default false
+  	*/
   sideEffects?: boolean;
 }
 interface TscOptions {
   /**
-  * Build mode for the TypeScript compiler:
-  *
-  * - If `true`, 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 `false`, the plugin will use [`tsc`](https://www.typescriptlang.org/docs/handbook/compiler-options.html) to emit `.d.ts` files without building referenced projects.
-  *
-  * @default false
-  */
+  	* Build mode for the TypeScript compiler:
+  	*
+  	* - If `true`, 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 `false`, the plugin will use [`tsc`](https://www.typescriptlang.org/docs/handbook/compiler-options.html) to emit `.d.ts` files without building referenced projects.
+  	*
+  	* @default false
+  	*/
   build?: boolean;
   /**
-  * 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.oxc} is
-  * `false`.
-  */
+  	* 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.oxc} is
+  	* `false`.
+  	*/
   incremental?: boolean;
   /**
-  * If `true`, the plugin will generate `.d.ts` files using `vue-tsc`.
-  */
+  	* If `true`, the plugin will generate `.d.ts` files using `vue-tsc`.
+  	*/
   vue?: boolean;
   /**
-  * If `true`, the plugin will generate `.d.ts` files using `@ts-macro/tsc`.
-  */
+  	* If `true`, the plugin will generate `.d.ts` files using `@ts-macro/tsc`.
+  	*/
   tsMacro?: boolean;
   /**
-  * If `true`, the plugin will launch a separate process for `tsc` or `vue-tsc`.
-  * This enables processing multiple projects in parallel.
-  */
+  	* 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.
-  */
+  	* 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;
   /**
-  * If `true`, the plugin will create a new isolated context for each build,
-  * ensuring that previously generated `.d.ts` code and caches are not reused.
-  *
-  * By default, the plugin may reuse internal caches or incremental build artifacts
-  * to speed up repeated builds. Enabling this option forces a clean context,
-  * guaranteeing that all type definitions are generated from scratch.
-  *
-  * @default false
-  */
+  	* If `true`, the plugin will create a new isolated context for each build,
+  	* ensuring that previously generated `.d.ts` code and caches are not reused.
+  	*
+  	* By default, the plugin may reuse internal caches or incremental build artifacts
+  	* to speed up repeated builds. Enabling this option forces a clean context,
+  	* guaranteeing that all type definitions are generated from scratch.
+  	*
+  	* @default false
+  	*/
   newContext?: boolean;
   /**
-  * If `true`, the plugin will emit `.d.ts` files for `.js` files as well.
-  * This is useful when you want to generate type definitions for JavaScript files with JSDoc comments.
-  *
-  * Enabled by default when `allowJs` in compilerOptions is `true`.
-  * This option is only used when {@link Options.oxc} is
-  * `false`.
-  */
+  	* If `true`, the plugin will emit `.d.ts` files for `.js` files as well.
+  	* This is useful when you want to generate type definitions for JavaScript files with JSDoc comments.
+  	*
+  	* Enabled by default when `allowJs` in compilerOptions is `true`.
+  	* This option is only used when {@link Options.oxc} is
+  	* `false`.
+  	*/
   emitJs?: boolean;
 }
 interface Options extends GeneralOptions, TscOptions {
   /**
-  * 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`.
-  */
+  	* 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`.
+  	*/
   oxc?: boolean | Omit<IsolatedDeclarationsOptions, "sourcemap">;
   /**
-  * **[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.
-  * `tsconfigRaw` and `isolatedDeclarations` options will be ignored when this option is enabled.
-  */
+  	* **[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.
+  	* `tsconfigRaw` and `isolatedDeclarations` options will be ignored when this option is enabled.
+  	*/
   tsgo?: boolean;
 }
 type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;

package/dist/index.mjs

@@ -22,11 +22,11 @@ const {
   readFile,
   rm
 } = globalThis.process.getBuiltinModule("node:fs/promises");
+const path = globalThis.process.getBuiltinModule("node:path");
+import { ResolverFactory, isolatedDeclarationSync } from "rolldown/experimental";
 const {
   tmpdir
 } = globalThis.process.getBuiltinModule("node:os");
-const path = globalThis.process.getBuiltinModule("node:path");
-import { ResolverFactory, isolatedDeclarationSync } from "rolldown/experimental";
 const process = globalThis.process;
 import { getTsconfig, parseTsconfig } from "get-tsconfig";
 import { createResolver } from "dts-resolver";
@@ -99,10 +99,15 @@ function createFakeJsPlugin({ sourcemap, cjsDefault, sideEffects }) {
 			handler: transform
 		},
 		renderChunk,
-		generateBundle: sourcemap ? void 0 : (options, bundle) => {
+		generateBundle(options, bundle) {
 			for (const chunk of Object.values(bundle)) {
 				if (!RE_DTS_MAP.test(chunk.fileName)) continue;
-				delete bundle[chunk.fileName];
+				if (sourcemap) {
+					if (chunk.type === "chunk" || typeof chunk.source !== "string") continue;
+					const map = JSON.parse(chunk.source);
+					map.sourcesContent = void 0;
+					chunk.source = JSON.stringify(map);
+				} else delete bundle[chunk.fileName];
 			}
 		}
 	};
@@ -223,6 +228,9 @@ function createFakeJsPlugin({ sourcemap, cjsDefault, sideEffects }) {
 			const [symbolIdNode, depsFn] = node.declarations[0].init.elements;
 			const symbolId = symbolIdNode.value;
 			const original = getSymbol(symbolId);
+			walkAST(original.decl, { enter(node$1) {
+				delete node$1.loc;
+			} });
 			for (const [i, decl] of node.declarations.entries()) {
 				const transformedBinding = {
 					...decl.id,
@@ -597,14 +605,42 @@ function inheritNodeComments(oldNode, newNode) {
 }
 
 //#endregion
-//#region src/generate.ts
-const debug$2 = createDebug("rolldown-plugin-dts:generate");
-const WORKER_URL = "./tsc-worker.mjs";
+//#region src/tsgo.ts
+const debug$3 = createDebug("rolldown-plugin-dts:tsgo");
 const spawnAsync = (...args) => new Promise((resolve, reject) => {
 	const child = spawn(...args);
 	child.on("close", () => resolve());
 	child.on("error", (error) => reject(error));
 });
+async function runTsgo(rootDir, tsconfig, sourcemap) {
+	debug$3("[tsgo] rootDir", rootDir);
+	const tsgoPkg = import.meta.resolve("@typescript/native-preview/package.json");
+	const { default: getExePath } = await import(new URL("lib/getExePath.js", tsgoPkg).href);
+	const tsgo = getExePath();
+	const tsgoDist = await mkdtemp(path.join(tmpdir(), "rolldown-plugin-dts-"));
+	debug$3("[tsgo] tsgoDist", tsgoDist);
+	const args = [
+		"--noEmit",
+		"false",
+		"--declaration",
+		"--emitDeclarationOnly",
+		...tsconfig ? ["-p", tsconfig] : [],
+		"--outDir",
+		tsgoDist,
+		"--rootDir",
+		rootDir,
+		"--noCheck",
+		...sourcemap ? ["--declarationMap"] : []
+	];
+	debug$3("[tsgo] args %o", args);
+	await spawnAsync(tsgo, args, { stdio: "inherit" });
+	return tsgoDist;
+}
+
+//#endregion
+//#region src/generate.ts
+const debug$2 = createDebug("rolldown-plugin-dts:generate");
+const WORKER_URL = "./tsc-worker.mjs";
 function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd, oxc, emitDtsOnly, vue, tsMacro, parallel, eager, tsgo, newContext, emitJs, sourcemap }) {
 	const dtsMap = /* @__PURE__ */ new Map();
 	/**
@@ -626,7 +662,7 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 	return {
 		name: "rolldown-plugin-dts:generate",
 		async buildStart(options) {
-			if (tsgo) tsgoDist = await runTsgo(rootDir, tsconfig);
+			if (tsgo) tsgoDist = await runTsgo(rootDir, tsconfig, sourcemap);
 			else if (!oxc) if (parallel) {
 				childProcess = fork(new URL(WORKER_URL, import.meta.url), { stdio: "inherit" });
 				rpc = (await import("birpc")).createBirpc({}, {
@@ -716,11 +752,19 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 				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(rootDir), filename_to_dts(id)));
-					if (existsSync(dtsPath)) dtsCode = await readFile(dtsPath, "utf8");
-					else {
+					if (!existsSync(dtsPath)) {
 						debug$2("[tsgo]", dtsPath, "is missing");
 						throw new Error(`tsgo did not generate dts file for ${id}, please check your tsconfig.`);
 					}
+					dtsCode = await readFile(dtsPath, "utf8");
+					const mapPath = `${dtsPath}.map`;
+					if (existsSync(mapPath)) {
+						const mapRaw = await readFile(mapPath, "utf8");
+						map = {
+							...JSON.parse(mapRaw),
+							sources: [id]
+						};
+					}
 				} else if (oxc && !RE_VUE.test(id)) {
 					const result = isolatedDeclarationSync(id, code, oxc);
 					if (result.errors.length) {
@@ -797,27 +841,6 @@ export { __json_default_export as default }`;
 		}
 	};
 }
-async function runTsgo(rootDir, tsconfig) {
-	const tsgoPkg = import.meta.resolve("@typescript/native-preview/package.json");
-	const { default: getExePath } = await import(new URL("lib/getExePath.js", tsgoPkg).href);
-	const tsgo = getExePath();
-	const tsgoDist = await mkdtemp(path.join(tmpdir(), "rolldown-plugin-dts-"));
-	debug$2("[tsgo] tsgoDist", tsgoDist);
-	debug$2("[tsgo] rootDir", rootDir);
-	await spawnAsync(tsgo, [
-		"--noEmit",
-		"false",
-		"--declaration",
-		"--emitDeclarationOnly",
-		...tsconfig ? ["-p", tsconfig] : [],
-		"--outDir",
-		tsgoDist,
-		"--rootDir",
-		rootDir,
-		"--noCheck"
-	], { stdio: "inherit" });
-	return tsgoDist;
-}
 function collectJsonExportMap(code) {
 	const exportMap = /* @__PURE__ */ new Map();
 	const { program } = parse(code, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rolldown-plugin-dts",
   "type": "module",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "description": "A Rolldown plugin to generate and bundle dts files.",
   "author": "Kevin Deng <sxzz@sxzz.moe>",
   "license": "MIT",
@@ -30,8 +30,6 @@
     "./tsc-worker": "./dist/tsc-worker.mjs",
     "./package.json": "./package.json"
   },
-  "main": "./dist/index.mjs",
-  "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "files": [
     "dist"
@@ -64,9 +62,9 @@
     }
   },
   "dependencies": {
-    "@babel/generator": "^7.28.5",
-    "@babel/parser": "^7.28.5",
-    "@babel/types": "^7.28.5",
+    "@babel/generator": "^7.28.6",
+    "@babel/parser": "^7.28.6",
+    "@babel/types": "^7.28.6",
     "ast-kit": "^2.2.0",
     "birpc": "^4.0.0",
     "dts-resolver": "^2.1.3",
@@ -74,32 +72,32 @@
     "obug": "^2.1.1"
   },
   "devDependencies": {
-    "@sxzz/eslint-config": "^7.4.4",
+    "@sxzz/eslint-config": "^7.4.5",
     "@sxzz/prettier-config": "^2.2.6",
     "@sxzz/test-utils": "^0.5.15",
     "@types/babel__generator": "^7.27.0",
-    "@types/node": "^25.0.3",
-    "@typescript/native-preview": "7.0.0-dev.20251228.1",
+    "@types/node": "^25.0.8",
+    "@typescript/native-preview": "7.0.0-dev.20260114.1",
     "@volar/typescript": "^2.4.27",
-    "@vue/language-core": "^3.2.1",
+    "@vue/language-core": "^3.2.2",
     "arktype": "^2.1.29",
-    "bumpp": "^10.3.2",
-    "diff": "^8.0.2",
+    "bumpp": "^10.4.0",
+    "diff": "^8.0.3",
     "eslint": "^9.39.2",
     "prettier": "^3.7.4",
-    "rolldown": "^1.0.0-beta.57",
+    "rolldown": "^1.0.0-beta.60",
     "rolldown-plugin-dts-snapshot": "^0.3.2",
     "rolldown-plugin-require-cjs": "^0.3.3",
     "rollup-plugin-dts": "^6.3.0",
     "tinyglobby": "^0.2.15",
-    "tsdown": "^0.18.3",
+    "tsdown": "^0.20.0-beta.2",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.16",
+    "vitest": "^4.0.17",
     "vue": "^3.5.26",
-    "vue-tsc": "^3.2.1"
+    "vue-tsc": "^3.2.2"
   },
   "resolutions": {
-    "rolldown": "^1.0.0-beta.57"
+    "rolldown": "^1.0.0-beta.60"
   },
   "prettier": "@sxzz/prettier-config",
   "scripts": {