rolldown-plugin-dts 0.15.5 → 0.15.7

package/README.md

@@ -1,6 +1,8 @@
-# rolldown-plugin-dts [![npm](https://img.shields.io/npm/v/rolldown-plugin-dts.svg)](https://npmjs.com/package/rolldown-plugin-dts)
+# rolldown-plugin-dts
 
-[![Unit Test](https://github.com/sxzz/rolldown-plugin-dts/actions/workflows/unit-test.yml/badge.svg)](https://github.com/sxzz/rolldown-plugin-dts/actions/workflows/unit-test.yml)
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Unit Test][unit-test-src]][unit-test-href]
 
 A Rolldown plugin to generate and bundle dts files.
 
@@ -86,6 +88,14 @@ 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.
 
+#### `cjsDefault`
+
+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.
+
 ### `tsc` Options
 
 > [!NOTE]
@@ -167,7 +177,7 @@ This option is automatically enabled when `isolatedDeclarations` in `compilerOpt
 
 To use this option, ensure that `@typescript/native-preview` is installed as a dependency.
 
-`tsconfigRaw` option will be ignored when this option is enabled.
+`tsconfigRaw` and `compilerOptions` options will be ignored when this option is enabled.
 
 ## Differences from `rollup-plugin-dts`
 
@@ -204,3 +214,12 @@ Furthermore, the test suite is authorized by them and distributed under the MIT
 ## License
 
 [MIT](./LICENSE) License © 2025 [三咲智子 Kevin Deng](https://github.com/sxzz)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/rolldown-plugin-dts.svg
+[npm-version-href]: https://npmjs.com/package/rolldown-plugin-dts
+[npm-downloads-src]: https://img.shields.io/npm/dm/rolldown-plugin-dts
+[npm-downloads-href]: https://www.npmcharts.com/compare/rolldown-plugin-dts?interval=30
+[unit-test-src]: https://github.com/sxzz/rolldown-plugin-dts/actions/workflows/unit-test.yml/badge.svg
+[unit-test-href]: https://github.com/sxzz/rolldown-plugin-dts/actions/workflows/unit-test.yml

package/dist/{filename-DUAyqgqS.d.ts → filename-BDKLOOY5.d.ts}

@@ -1,3 +1,5 @@
+import { ChunkFileNamesFunction, PreRenderedChunk } from "rolldown";
+
 //#region src/filename.d.ts
 declare const RE_JS: RegExp;
 declare const RE_TS: RegExp;
@@ -9,5 +11,7 @@ declare const RE_VUE: RegExp;
 declare function filename_js_to_dts(id: string): string;
 declare function filename_to_dts(id: string): string;
 declare function filename_dts_to(id: string, ext: "js" | "ts"): string;
+declare function resolveTemplateFn(fn: string | ChunkFileNamesFunction, chunk: PreRenderedChunk): string;
+declare function replaceTemplateName(template: string, name: string): string;
 //#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_to_dts };
+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_to_dts, replaceTemplateName, resolveTemplateFn };

package/dist/{filename-DtB5setL.js → filename-Dd76wOJT.js}

@@ -15,6 +15,12 @@ function filename_to_dts(id) {
 function filename_dts_to(id, ext) {
 	return id.replace(RE_DTS, `.$1${ext}`);
 }
+function resolveTemplateFn(fn, chunk) {
+	return typeof fn === "function" ? fn(chunk) : fn;
+}
+function replaceTemplateName(template, name) {
+	return template.replaceAll("[name]", name);
+}
 
 //#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_to_dts };
+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_to_dts, replaceTemplateName, resolveTemplateFn };

package/dist/filename.d.ts

@@ -1,2 +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_to_dts } from "./filename-DUAyqgqS.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_to_dts };
+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_to_dts, replaceTemplateName, resolveTemplateFn } from "./filename-BDKLOOY5.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_to_dts, replaceTemplateName, resolveTemplateFn };

package/dist/filename.js

@@ -1,3 +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_to_dts } from "./filename-DtB5setL.js";
+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_to_dts, replaceTemplateName, resolveTemplateFn } from "./filename-Dd76wOJT.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_to_dts };
+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_to_dts, replaceTemplateName, resolveTemplateFn };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE } from "./filename-DUAyqgqS.js";
+import { RE_CSS, RE_DTS, RE_DTS_MAP, RE_JS, RE_NODE_MODULES, RE_TS, RE_VUE } from "./filename-BDKLOOY5.js";
 import { IsolatedDeclarationsOptions } from "rolldown/experimental";
 import { TsConfigJson } from "get-tsconfig";
 import { Plugin } from "rolldown";
@@ -50,6 +50,14 @@ interface GeneralOptions {
   * Resolve external types used in `.d.ts` files from `node_modules`.
   */
   resolve?: boolean | (string | RegExp)[];
+  /**
+  * 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;
 }
 interface TscOptions {
   /**
@@ -160,6 +168,7 @@ declare function resolveOptions({
   compilerOptions,
   sourcemap,
   resolve,
+  cjsDefault,
   build,
   incremental,
   vue,
@@ -174,8 +183,9 @@ declare function resolveOptions({
 //#region src/fake-js.d.ts
 declare function createFakeJsPlugin({
   dtsInput,
-  sourcemap
-}: Pick<OptionsResolved, "dtsInput" | "sourcemap">): Plugin;
+  sourcemap,
+  cjsDefault
+}: Pick<OptionsResolved, "dtsInput" | "sourcemap" | "cjsDefault">): Plugin;
 //#endregion
 //#region src/generate.d.ts
 declare function createGeneratePlugin({

package/dist/index.js

@@ -1,4 +1,4 @@
-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_to_dts } from "./filename-DtB5setL.js";
+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_to_dts, replaceTemplateName, resolveTemplateFn } from "./filename-Dd76wOJT.js";
 import { createContext, globalContext, invalidateContextFile } from "./context-BG0dlajy.js";
 import Debug from "debug";
 import _generate from "@babel/generator";
@@ -32,6 +32,15 @@ function createDtsInputPlugin() {
 			return {
 				...options,
 				entryFileNames(chunk) {
+					const { entryFileNames } = options;
+					if (entryFileNames) {
+						const nameTemplate = resolveTemplateFn(entryFileNames, chunk);
+						const renderedName = replaceTemplateName(nameTemplate, chunk.name);
+						if (RE_DTS.test(renderedName)) return nameTemplate;
+						const renderedNameWithD = replaceTemplateName(nameTemplate, `${chunk.name}.d`);
+						if (RE_DTS.test(renderedNameWithD)) return renderedNameWithD;
+					}
+					if (RE_DTS.test(chunk.name)) return chunk.name;
 					if (chunk.name.endsWith(".d")) return "[name].ts";
 					return "[name].d.ts";
 				}
@@ -230,7 +239,7 @@ function walk(ast, { enter, leave }) {
 //#endregion
 //#region src/fake-js.ts
 const generate = _generate.default || _generate;
-function createFakeJsPlugin({ dtsInput, sourcemap }) {
+function createFakeJsPlugin({ dtsInput, sourcemap, cjsDefault }) {
 	let symbolIdx = 0;
 	const identifierMap = Object.create(null);
 	const symbolMap = /* @__PURE__ */ new Map();
@@ -240,14 +249,20 @@ function createFakeJsPlugin({ dtsInput, sourcemap }) {
 		name: "rolldown-plugin-dts:fake-js",
 		outputOptions(options) {
 			if (options.format === "cjs" || options.format === "commonjs") throw new Error("[rolldown-plugin-dts] Cannot bundle dts files with `cjs` format.");
+			const { chunkFileNames } = options;
 			return {
 				...options,
 				sourcemap: options.sourcemap || sourcemap,
 				entryFileNames: options.entryFileNames ?? (dtsInput ? "[name].ts" : void 0),
 				chunkFileNames(chunk) {
-					const original = (typeof options.chunkFileNames === "function" ? options.chunkFileNames(chunk) : options.chunkFileNames) || "[name]-[hash].js";
-					if (!original.includes(".d") && chunk.name.endsWith(".d")) return filename_js_to_dts(original).replace("[name]", chunk.name.slice(0, -2));
-					return original;
+					const nameTemplate = resolveTemplateFn(chunkFileNames || "[name]-[hash].js", chunk);
+					if (chunk.name.endsWith(".d")) {
+						const renderedNameWithoutD = filename_js_to_dts(replaceTemplateName(nameTemplate, chunk.name.slice(0, -2)));
+						if (RE_DTS.test(renderedNameWithoutD)) return renderedNameWithoutD;
+						const renderedName = filename_js_to_dts(replaceTemplateName(nameTemplate, chunk.name));
+						if (RE_DTS.test(renderedName)) return renderedName;
+					}
+					return nameTemplate;
 				}
 			};
 		},
@@ -371,7 +386,8 @@ function createFakeJsPlugin({ dtsInput, sourcemap }) {
 		program.body = patchTsNamespace(program.body);
 		program.body = program.body.map((node) => {
 			if (isHelperImport(node)) return null;
-			if (patchImportExport(node, typeOnlyIds)) return node;
+			const newNode = patchImportExport(node, typeOnlyIds, cjsDefault);
+			if (newNode) return newNode;
 			if (node.type !== "VariableDeclaration") return node;
 			const [decl] = node.declarations;
 			if (decl.init?.type !== "ArrayExpression" || !decl.init.elements[0]) return null;
@@ -515,7 +531,7 @@ function isReferenceId(node) {
 function isHelperImport(node) {
 	return node.type === "ImportDeclaration" && node.specifiers.length === 1 && node.specifiers.every((spec) => spec.type === "ImportSpecifier" && spec.imported.type === "Identifier" && ["__export", "__reExport"].includes(spec.imported.name));
 }
-function patchImportExport(node, typeOnlyIds) {
+function patchImportExport(node, typeOnlyIds, cjsDefault) {
 	if (isTypeOf(node, [
 		"ImportDeclaration",
 		"ExportAllDeclaration",
@@ -528,7 +544,14 @@ function patchImportExport(node, typeOnlyIds) {
 		}
 		if (node.source?.value && RE_DTS.test(node.source.value)) {
 			node.source.value = filename_dts_to(node.source.value, "js");
-			return true;
+			return node;
+		}
+		if (cjsDefault && node.type === "ExportNamedDeclaration" && !node.source && node.specifiers.length === 1 && node.specifiers[0].type === "ExportSpecifier" && resolveString(node.specifiers[0].exported) === "default") {
+			const defaultExport = node.specifiers[0];
+			return {
+				type: "TSExportAssignment",
+				expression: defaultExport.local
+			};
 		}
 	}
 }
@@ -684,10 +707,10 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 			return {
 				...options,
 				entryFileNames(chunk) {
-					const original = (typeof options.entryFileNames === "function" ? options.entryFileNames(chunk) : options.entryFileNames) || "[name].js";
-					if (!chunk.name.endsWith(".d")) return original;
-					if (RE_DTS.test(original)) return original.replace("[name]", chunk.name.slice(0, -2));
-					return original.replace(RE_JS, ".$1ts");
+					const { entryFileNames } = options;
+					const nameTemplate = (typeof entryFileNames === "function" ? entryFileNames(chunk) : entryFileNames) || "[name].js";
+					if (chunk.name.endsWith(".d") && RE_JS.test(nameTemplate)) return nameTemplate.replace(RE_JS, ".$1ts");
+					return nameTemplate;
 				}
 			};
 		},
@@ -832,7 +855,7 @@ async function runTsgo(root, tsconfig) {
 //#endregion
 //#region src/options.ts
 let warnedTsgo = false;
-function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = false, tsconfig, tsconfigRaw: overriddenTsconfigRaw = {}, compilerOptions = {}, sourcemap, resolve = false, build = false, incremental = false, vue = 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, cjsDefault = false, build = false, incremental = false, vue = 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) || {};
@@ -878,6 +901,7 @@ function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = f
 		tsconfigRaw,
 		sourcemap,
 		resolve,
+		cjsDefault,
 		build,
 		incremental,
 		vue,
@@ -914,7 +938,12 @@ function createDtsResolvePlugin({ tsconfig, resolve }) {
 				let dtsResolution = resolver(id, importer);
 				dtsResolution &&= path.normalize(dtsResolution);
 				if (!dtsResolution || !RE_TS.test(dtsResolution) && !RE_VUE.test(dtsResolution)) {
-					if (!rolldownResolution || !RE_TS.test(rolldownResolution.id) && !RE_VUE.test(rolldownResolution.id)) return external;
+					const unresolved = !rolldownResolution || !RE_TS.test(rolldownResolution.id) && !RE_VUE.test(rolldownResolution.id);
+					if (unresolved) {
+						const isRelativeOrAbsolute = id.startsWith(".") || path.isAbsolute(id);
+						if (isRelativeOrAbsolute) return this.error(`Cannot resolve import '${id}' from '${importer}'`);
+						return external;
+					}
 					dtsResolution = rolldownResolution.id;
 				}
 				if (RE_NODE_MODULES.test(dtsResolution)) {

package/dist/{tsc-BJW5IMTs.js → tsc-BLPzoCMq.js}

@@ -264,7 +264,12 @@ function tscEmit(tscOptions) {
 			dtsCode = code;
 		}
 	}, void 0, true, { afterDeclarations: [stripPrivateFields] }, true);
-	if (emitSkipped && diagnostics.length) return { error: ts.formatDiagnostics(diagnostics, formatHost) };
+	const emitErrors = diagnostics.filter((d) => d.category === ts.DiagnosticCategory.Error);
+	if (emitErrors.length > 0) return { error: ts.formatDiagnostics(emitErrors, formatHost) };
+	if (emitSkipped) {
+		const errors = ts.getPreEmitDiagnostics(program).filter((d) => d.category === ts.DiagnosticCategory.Error);
+		if (errors.length > 0) return { error: ts.formatDiagnostics(errors, formatHost) };
+	}
 	if (!dtsCode && file.isDeclarationFile) {
 		debug("nothing was emitted. fallback to sourceFile text.");
 		dtsCode = file.getFullText();

package/dist/tsc-worker.js

@@ -1,5 +1,5 @@
 import "./context-BG0dlajy.js";
-import { tscEmit } from "./tsc-BJW5IMTs.js";
+import { tscEmit } from "./tsc-BLPzoCMq.js";
 import process from "node:process";
 import { createBirpc } from "birpc";
 
@@ -10,4 +10,5 @@ createBirpc(functions, {
 	on: (fn) => process.on("message", fn)
 });
 
-//#endregion
+//#endregion
+export {  };

package/dist/tsc.js

@@ -1,4 +1,4 @@
 import "./context-BG0dlajy.js";
-import { tscEmit } from "./tsc-BJW5IMTs.js";
+import { tscEmit } from "./tsc-BLPzoCMq.js";
 
 export { tscEmit };

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "rolldown-plugin-dts",
-  "version": "0.15.5",
-  "description": "A Rolldown plugin to bundle dts files",
+  "version": "0.15.7",
+  "description": "A Rolldown plugin to generate and bundle dts files.",
   "type": "module",
+  "keywords": [
+    "rolldown",
+    "plugin",
+    "dts",
+    "typescript",
+    "vue",
+    "jsdoc"
+  ],
   "license": "MIT",
   "homepage": "https://github.com/sxzz/rolldown-plugin-dts#readme",
   "bugs": {
@@ -49,38 +57,38 @@
     }
   },
   "dependencies": {
-    "@babel/generator": "^7.28.0",
-    "@babel/parser": "^7.28.0",
+    "@babel/generator": "^7.28.3",
+    "@babel/parser": "^7.28.3",
     "@babel/types": "^7.28.2",
-    "ast-kit": "^2.1.1",
+    "ast-kit": "^2.1.2",
     "birpc": "^2.5.0",
     "debug": "^4.4.1",
     "dts-resolver": "^2.1.1",
     "get-tsconfig": "^4.10.1"
   },
   "devDependencies": {
-    "@sxzz/eslint-config": "^7.1.2",
-    "@sxzz/prettier-config": "^2.2.3",
-    "@sxzz/test-utils": "^0.5.9",
+    "@sxzz/eslint-config": "^7.1.4",
+    "@sxzz/prettier-config": "^2.2.4",
+    "@sxzz/test-utils": "^0.5.10",
     "@types/babel__generator": "^7.27.0",
     "@types/debug": "^4.1.12",
-    "@types/node": "^24.2.0",
-    "@typescript/native-preview": "7.0.0-dev.20250806.1",
-    "@volar/typescript": "^2.4.22",
-    "@vue/language-core": "^3.0.5",
-    "bumpp": "^10.2.2",
+    "@types/node": "^24.3.0",
+    "@typescript/native-preview": "7.0.0-dev.20250820.1",
+    "@volar/typescript": "^2.4.23",
+    "@vue/language-core": "^3.0.6",
+    "bumpp": "^10.2.3",
     "diff": "^8.0.2",
-    "eslint": "^9.32.0",
+    "eslint": "^9.33.0",
     "estree-walker": "^3.0.3",
     "prettier": "^3.6.2",
-    "rolldown": "^1.0.0-beta.31",
-    "rollup-plugin-dts": "^6.2.1",
+    "rolldown": "^1.0.0-beta.33",
+    "rollup-plugin-dts": "^6.2.3",
     "tinyglobby": "^0.2.14",
-    "tsdown": "^0.13.3",
+    "tsdown": "^0.14.1",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
     "vue": "^3.5.18",
-    "vue-tsc": "^3.0.5"
+    "vue-tsc": "^3.0.6"
   },
   "engines": {
     "node": ">=20.18.0"
@@ -94,6 +102,6 @@
     "test": "vitest",
     "typecheck": "tsc --noEmit",
     "format": "prettier --cache --write .",
-    "release": "bumpp && pnpm publish"
+    "release": "bumpp && unotp pnpm publish"
   }
 }