rolldown-plugin-dts 0.18.3 → 0.19.0

package/README.md

@@ -108,14 +108,6 @@ 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.
 
-#### `banner`
-
-Content to be added at the top of each generated `.d.ts` file.
-
-#### `footer`
-
-Content to be added at the bottom of each generated `.d.ts` file.
-
 #### `sideEffects`
 
 Indicates whether the generated `.d.ts` files have side effects.

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { a as RE_JSON, c as RE_VUE, i as RE_JS, n as RE_DTS, o as RE_NODE_MODULES, r as RE_DTS_MAP, s as RE_TS, t as RE_CSS } from "./filename-Dn8CLu7g.mjs";
 import { IsolatedDeclarationsOptions } from "rolldown/experimental";
 import { TsConfigJson } from "get-tsconfig";
-import { AddonFunction, Plugin } from "rolldown";
+import { Plugin } from "rolldown";
 
 //#region src/options.d.ts
 interface GeneralOptions {
@@ -161,14 +161,6 @@ interface TscOptions {
   * `false`.
   */
   emitJs?: boolean;
-  /**
-  * Content to be added at the top of each generated `.d.ts` file.
-  */
-  banner?: string | Promise<string> | AddonFunction;
-  /**
-  * Content to be added at the bottom of each generated `.d.ts` file.
-  */
-  footer?: string | Promise<string> | AddonFunction;
 }
 interface Options extends GeneralOptions, TscOptions {
   /**
@@ -189,8 +181,7 @@ interface Options extends GeneralOptions, TscOptions {
   tsgo?: boolean;
 }
 type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
-type MarkPartial<T, K extends keyof T> = Omit<Required<T>, K> & Partial<Pick<T, K>>;
-type OptionsResolved = Overwrite<MarkPartial<Omit<Options, "compilerOptions">, "banner" | "footer">, {
+type OptionsResolved = Overwrite<Required<Omit<Options, "compilerOptions">>, {
   tsconfig?: string;
   oxc: IsolatedDeclarationsOptions | false;
   tsconfigRaw: TsConfigJson;
@@ -206,8 +197,6 @@ declare function resolveOptions({
   resolve,
   resolver,
   cjsDefault,
-  banner,
-  footer,
   sideEffects,
   build,
   incremental,

package/dist/index.mjs

@@ -2,7 +2,6 @@ const __cjs_require = globalThis.process.getBuiltinModule("module").createRequir
 import { a as RE_JSON, c as RE_VUE, d as filename_to_dts, f as replaceTemplateName, i as RE_JS, l as filename_dts_to, n as RE_DTS, o as RE_NODE_MODULES, p as resolveTemplateFn, r as RE_DTS_MAP, s as RE_TS, t as RE_CSS, u as filename_js_to_dts } from "./filename-Cqnsj8Gp.mjs";
 import { n as globalContext, r as invalidateContextFile, t as createContext } from "./context-EuY-ImLj.mjs";
 import { createDebug } from "obug";
-import MagicString from "magic-string";
 const {
   generate
 } = __cjs_require("@babel/generator");
@@ -32,36 +31,6 @@ const process = globalThis.process;
 import { getTsconfig, parseTsconfig } from "get-tsconfig";
 import { createResolver } from "dts-resolver";
 
-//#region src/banner.ts
-function createBannerPlugin({ banner, footer }) {
-	return {
-		name: "rolldown-plugin-dts:banner",
-		async renderChunk(code, chunk) {
-			if (!RE_DTS.test(chunk.fileName)) return;
-			const s = new MagicString(code);
-			if (banner) {
-				const code$1 = await (typeof banner === "function" ? banner(chunk) : banner);
-				if (code$1) s.prepend(`${code$1}\n`);
-			}
-			if (footer) {
-				const code$1 = await (typeof footer === "function" ? footer(chunk) : footer);
-				if (code$1) s.append(`\n${code$1}`);
-			}
-			return {
-				code: s.toString(),
-				get map() {
-					return s.generateMap({
-						source: chunk.fileName,
-						includeContent: true,
-						hires: "boundary"
-					});
-				}
-			};
-		}
-	};
-}
-
-//#endregion
 //#region src/dts-input.ts
 function createDtsInputPlugin({ sideEffects }) {
 	return {
@@ -628,7 +597,7 @@ function inheritNodeComments(oldNode, newNode) {
 
 //#endregion
 //#region src/generate.ts
-const debug$1 = createDebug("rolldown-plugin-dts:generate");
+const debug$2 = createDebug("rolldown-plugin-dts:generate");
 const WORKER_URL = "./tsc-worker.mjs";
 const spawnAsync = (...args) => new Promise((resolve, reject) => {
 	const child = spawn(...args);
@@ -652,10 +621,11 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 	let tscModule;
 	let tscContext;
 	let tsgoDist;
+	const rootDir = tsconfig ? path.dirname(tsconfig) : cwd;
 	return {
 		name: "rolldown-plugin-dts:generate",
 		async buildStart(options) {
-			if (tsgo) tsgoDist = await runTsgo(cwd, tsconfig);
+			if (tsgo) tsgoDist = await runTsgo(rootDir, tsconfig);
 			else if (!oxc) if (parallel) {
 				childProcess = fork(new URL(WORKER_URL, import.meta.url), { stdio: "inherit" });
 				rpc = (await import("birpc")).createBirpc({}, {
@@ -667,11 +637,11 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 				if (newContext) tscContext = createContext();
 			}
 			if (!Array.isArray(options.input)) for (const [name, id] of Object.entries(options.input)) {
-				debug$1("resolving input alias %s -> %s", name, id);
+				debug$2("resolving input alias %s -> %s", name, id);
 				let resolved = await this.resolve(id);
 				if (!id.startsWith("./")) resolved ||= await this.resolve(`./${id}`);
 				const resolvedId = resolved?.id || id;
-				debug$1("resolved input alias %s -> %s", id, resolvedId);
+				debug$2("resolved input alias %s -> %s", id, resolvedId);
 				inputAliasMap.set(resolvedId, name);
 			}
 		},
@@ -691,7 +661,7 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 		},
 		resolveId(id) {
 			if (dtsMap.has(id)) {
-				debug$1("resolve dts id %s", id);
+				debug$2("resolve dts id %s", id);
 				return { id };
 			}
 		},
@@ -715,7 +685,7 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 						id,
 						isEntry
 					});
-					debug$1("register dts source: %s", id);
+					debug$2("register dts source: %s", id);
 					if (isEntry) {
 						const name = inputAliasMap.get(id);
 						this.emitFile({
@@ -741,13 +711,13 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 				const { code, id } = dtsMap.get(dtsId);
 				let dtsCode;
 				let map;
-				debug$1("generate dts %s from %s", dtsId, id);
+				debug$2("generate dts %s from %s", dtsId, 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(cwd), filename_to_dts(id)));
+					const dtsPath = path.resolve(tsgoDist, path.relative(path.resolve(rootDir), filename_to_dts(id)));
 					if (existsSync(dtsPath)) dtsCode = await readFile(dtsPath, "utf8");
 					else {
-						debug$1("[tsgo]", dtsPath, "is missing");
+						debug$2("[tsgo]", dtsPath, "is missing");
 						throw new Error(`tsgo did not generate dts file for ${id}, please check your tsconfig.`);
 					}
 				} else if (oxc && !RE_VUE.test(id)) {
@@ -756,7 +726,7 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 						const [error] = result.errors;
 						return this.error({
 							message: error.message,
-							frame: error.codeframe
+							frame: error.codeframe || void 0
 						});
 					}
 					dtsCode = result.code;
@@ -814,7 +784,7 @@ export { __json_default_export as default }`;
 		} : void 0,
 		async buildEnd() {
 			childProcess?.kill();
-			if (!debug$1.enabled && tsgoDist) await rm(tsgoDist, {
+			if (!debug$2.enabled && tsgoDist) await rm(tsgoDist, {
 				recursive: true,
 				force: true
 			}).catch(() => {});
@@ -826,12 +796,13 @@ export { __json_default_export as default }`;
 		}
 	};
 }
-async function runTsgo(root, tsconfig) {
+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$1("[tsgo] tsgoDist", tsgoDist);
+	debug$2("[tsgo] tsgoDist", tsgoDist);
+	debug$2("[tsgo] rootDir", rootDir);
 	await spawnAsync(tsgo, [
 		"--noEmit",
 		"false",
@@ -841,7 +812,7 @@ async function runTsgo(root, tsconfig) {
 		"--outDir",
 		tsgoDist,
 		"--rootDir",
-		root,
+		rootDir,
 		"--noCheck"
 	], { stdio: "inherit" });
 	return tsgoDist;
@@ -880,7 +851,7 @@ function collectJsonExports(code) {
 //#endregion
 //#region src/options.ts
 let warnedTsgo = false;
-function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = false, tsconfig, tsconfigRaw: overriddenTsconfigRaw = {}, compilerOptions = {}, sourcemap, resolve = false, resolver = "oxc", cjsDefault = false, banner, footer, sideEffects = false, build = false, incremental = false, vue = false, tsMacro = false, parallel = false, eager = false, newContext = false, emitJs, oxc, tsgo = false }) {
+function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = false, tsconfig, tsconfigRaw: overriddenTsconfigRaw = {}, compilerOptions = {}, sourcemap, resolve = false, resolver = "oxc", cjsDefault = false, sideEffects = false, build = false, incremental = false, vue = false, tsMacro = false, parallel = false, eager = false, newContext = false, emitJs, oxc, tsgo = false }) {
 	let resolvedTsconfig;
 	if (tsconfig === true || tsconfig == null) {
 		const { config, path: path$1 } = getTsconfig(cwd) || {};
@@ -930,8 +901,6 @@ function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = f
 		resolve,
 		resolver,
 		cjsDefault,
-		banner,
-		footer,
 		sideEffects,
 		build,
 		incremental,
@@ -948,6 +917,7 @@ function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = f
 
 //#endregion
 //#region src/resolver.ts
+const debug$1 = createDebug("rolldown-plugin-dts:resolver");
 function isSourceFile(id) {
 	return RE_TS.test(id) || RE_VUE.test(id) || RE_JSON.test(id);
 }
@@ -969,16 +939,31 @@ function createDtsResolvePlugin({ cwd, tsconfig, tsconfigRaw, resolve, resolver,
 					external: true,
 					moduleSideEffects: sideEffects
 				};
-				if (RE_CSS.test(id)) return external;
+				if (RE_CSS.test(id)) {
+					debug$1("Externalizing css import:", id);
+					return external;
+				}
 				const rolldownResolution = await this.resolve(id, importer, options);
+				debug$1("Rolldown resolution for dts import %O from %O: %O", id, importer, rolldownResolution);
 				const dtsResolution = await resolveDtsPath(id, importer, rolldownResolution);
-				if (!dtsResolution) return isFilePath(id) ? null : external;
-				if (RE_NODE_MODULES.test(dtsResolution) && !shouldBundleNodeModule(id) && (!RE_NODE_MODULES.test(importer) || rolldownResolution?.external)) return external;
-				if (RE_DTS.test(dtsResolution)) return {
-					id: dtsResolution,
-					moduleSideEffects
-				};
+				debug$1("Dts resolution for dts import %O from %O: %O", id, importer, dtsResolution);
+				if (!dtsResolution) {
+					debug$1("Unresolvable dts import:", id, "from", importer);
+					return isFilePath(id) ? null : external;
+				}
+				if (RE_NODE_MODULES.test(dtsResolution) && !shouldBundleNodeModule(id) && (!RE_NODE_MODULES.test(importer) || rolldownResolution?.external)) {
+					debug$1("Externalizing node_modules dts import:", id);
+					return external;
+				}
+				if (RE_DTS.test(dtsResolution)) {
+					debug$1("Resolving dts import to declaration file:", id);
+					return {
+						id: dtsResolution,
+						moduleSideEffects
+					};
+				}
 				if (isSourceFile(dtsResolution)) {
+					debug$1("Resolving dts import to source file:", id);
 					await this.load({ id: dtsResolution });
 					return {
 						id: filename_to_dts(dtsResolution),
@@ -998,6 +983,7 @@ function createDtsResolvePlugin({ cwd, tsconfig, tsconfigRaw, resolve, resolver,
 			const { tscResolve } = await import("./resolver-DksQRwY1.mjs");
 			dtsPath = tscResolve(id, importer, cwd, tsconfig, tsconfigRaw);
 		} else dtsPath = baseDtsResolver(id, importer);
+		debug$1("Using %s for dts import: %O -> %O", resolver, id, dtsPath);
 		if (dtsPath) dtsPath = path.normalize(dtsPath);
 		if (!dtsPath || !isSourceFile(dtsPath)) {
 			if (rolldownResolution && isFilePath(rolldownResolution.id) && isSourceFile(rolldownResolution.id) && !rolldownResolution.external) return rolldownResolution.id;
@@ -1021,7 +1007,6 @@ function dts(options = {}) {
 	if (options.dtsInput) plugins.push(createDtsInputPlugin(resolved));
 	else plugins.push(createGeneratePlugin(resolved));
 	plugins.push(createDtsResolvePlugin(resolved), createFakeJsPlugin(resolved));
-	if (options.banner || options.footer) plugins.push(createBannerPlugin(resolved));
 	return plugins;
 }
 

package/dist/{tsc-BW5Mr7EL.mjs → tsc-Cn0kGE1h.mjs}

@@ -341,7 +341,7 @@ function createTsProgram({ entries, id, tsconfig, tsconfigRaw, vue, tsMacro, cwd
 	const fsSystem = createFsSystem(context.files);
 	const baseDir = tsconfig ? path.dirname(tsconfig) : cwd;
 	const parsedConfig = ts.parseJsonConfigFileContent(tsconfigRaw, fsSystem, baseDir);
-	debug$1(`Creating program for root project: ${baseDir}`);
+	debug$1(`creating program for root project: ${baseDir}`);
 	return createTsProgramFromParsedConfig({
 		parsedConfig,
 		fsSystem,
@@ -404,9 +404,12 @@ function tscEmitCompiler(tscOptions) {
 		}
 	}, void 0, true, customTransformers, true);
 	if (emitSkipped && diagnostics.length) return { error: ts.formatDiagnostics(diagnostics, formatHost) };
-	if (!dtsCode && file.isDeclarationFile) {
-		debug$1("nothing was emitted. fallback to sourceFile text.");
-		dtsCode = file.getFullText();
+	if (!dtsCode) {
+		debug$1("nothing was emitted.");
+		if (file.isDeclarationFile) {
+			debug$1("source file is a declaration file.");
+			dtsCode = file.getFullText();
+		} else console.warn("[rolldown-plugin-dts] Warning: Failed to emit declaration file. Please try to enable `eager` option (`dts.eager` for tsdown).");
 	}
 	return {
 		code: dtsCode,

package/dist/tsc-worker.mjs

@@ -1,4 +1,4 @@
-import { t as tscEmit } from "./tsc-BW5Mr7EL.mjs";
+import { t as tscEmit } from "./tsc-Cn0kGE1h.mjs";
 import "./context-EuY-ImLj.mjs";
 const process = globalThis.process;
 import { createBirpc } from "birpc";

package/dist/tsc.mjs

@@ -1,4 +1,4 @@
-import { t as tscEmit } from "./tsc-BW5Mr7EL.mjs";
+import { t as tscEmit } from "./tsc-Cn0kGE1h.mjs";
 import "./context-EuY-ImLj.mjs";
 
 export { tscEmit };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rolldown-plugin-dts",
   "type": "module",
-  "version": "0.18.3",
+  "version": "0.19.0",
   "description": "A Rolldown plugin to generate and bundle dts files.",
   "author": "Kevin Deng <sxzz@sxzz.moe>",
   "license": "MIT",
@@ -45,7 +45,7 @@
   "peerDependencies": {
     "@ts-macro/tsc": "^0.3.6",
     "@typescript/native-preview": ">=7.0.0-dev.20250601.1",
-    "rolldown": "^1.0.0-beta.51",
+    "rolldown": "^1.0.0-beta.55",
     "typescript": "^5.0.0",
     "vue-tsc": "~3.1.0"
   },
@@ -68,35 +68,35 @@
     "@babel/parser": "^7.28.5",
     "@babel/types": "^7.28.5",
     "ast-kit": "^2.2.0",
-    "birpc": "^3.0.0",
+    "birpc": "^4.0.0",
     "dts-resolver": "^2.1.3",
     "get-tsconfig": "^4.13.0",
     "magic-string": "^0.30.21",
     "obug": "^2.1.1"
   },
   "devDependencies": {
-    "@sxzz/eslint-config": "^7.4.1",
+    "@sxzz/eslint-config": "^7.4.3",
     "@sxzz/prettier-config": "^2.2.6",
-    "@sxzz/test-utils": "^0.5.13",
+    "@sxzz/test-utils": "^0.5.15",
     "@types/babel__generator": "^7.27.0",
-    "@types/node": "^24.10.1",
-    "@typescript/native-preview": "7.0.0-dev.20251204.1",
-    "@volar/typescript": "^2.4.26",
-    "@vue/language-core": "^3.1.5",
-    "arktype": "^2.1.28",
+    "@types/node": "^25.0.3",
+    "@typescript/native-preview": "7.0.0-dev.20251217.1",
+    "@volar/typescript": "^2.4.27",
+    "@vue/language-core": "^3.1.8",
+    "arktype": "^2.1.29",
     "bumpp": "^10.3.2",
     "diff": "^8.0.2",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "prettier": "^3.7.4",
-    "rolldown": "^1.0.0-beta.53",
+    "rolldown": "^1.0.0-beta.55",
     "rolldown-plugin-require-cjs": "^0.3.3",
     "rollup-plugin-dts": "^6.3.0",
     "tinyglobby": "^0.2.15",
-    "tsdown": "^0.17.0",
+    "tsdown": "^0.18.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15",
+    "vitest": "^4.0.16",
     "vue": "^3.5.25",
-    "vue-tsc": "^3.1.5"
+    "vue-tsc": "^3.1.8"
   },
   "prettier": "@sxzz/prettier-config",
   "scripts": {