rolldown-plugin-dts 0.3.0 → 0.4.0

package/README.md

@@ -38,6 +38,13 @@ interface Options {
    */
   dtsInput?: boolean
 
+  /**
+   * When `true`, the plugin will only emit `.d.ts` files and remove all other chunks.
+   *
+   * This feature is particularly beneficial when you need to generate `d.ts` files for the CommonJS format as part of a separate build process.
+   */
+  emitDtsOnly?: boolean
+
   isolatedDeclaration?: Omit<IsolatedDeclarationsOptions, 'sourcemap'>
 
   /**
@@ -56,7 +63,7 @@ interface Options {
 }
 ````
 
-## Caveats
+## ⚠️ Caveats
 
 - The plugin uses Oxc's `isolatedDeclarations` to generate `.d.ts` files,
   which means you need to set `isolatedDeclarations: true` in your `tsconfig.json` and ensure there are no errors.

package/dist/index.d.ts

@@ -6,7 +6,7 @@ declare function createFakeJsPlugin({ dtsInput }: Pick<Options, "dtsInput">): Pl
 
 //#endregion
 //#region src/generate.d.ts
-declare function createGeneratePlugin({ isolatedDeclaration, inputAlias, resolve }: Pick<Options, "isolatedDeclaration" | "inputAlias" | "resolve">): Plugin;
+declare function createGeneratePlugin({ isolatedDeclaration, inputAlias, resolve, emitDtsOnly }: Pick<Options, "isolatedDeclaration" | "inputAlias" | "resolve" | "emitDtsOnly">): Plugin;
 
 //#endregion
 //#region src/index.d.ts
@@ -17,6 +17,12 @@ interface Options {
 	* If enabled, the plugin will skip generating a `.d.ts` file for the entry point.
 	*/
 	dtsInput?: boolean;
+	/**
+	* When `true`, the plugin will only emit `.d.ts` files and remove all other chunks.
+	*
+	* This feature is particularly beneficial when you need to generate `d.ts` files for the CommonJS format as part of a separate build process.
+	*/
+	emitDtsOnly?: boolean;
 	isolatedDeclaration?: Omit<IsolatedDeclarationsOptions, "sourcemap">;
 	/**
 	* dts file name alias `{ [filename]: path }`

package/dist/index.js

@@ -1,6 +1,6 @@
 import { MagicStringAST } from "magic-string-ast";
 import { parseAsync } from "oxc-parser";
-import path, { basename } from "node:path";
+import path, { basename, extname } from "node:path";
 import { createResolver } from "dts-resolver";
 import { isolatedDeclaration } from "oxc-transform";
 
@@ -436,9 +436,9 @@ function importNamespace(s, source, imported, getIdentifierIndex) {
 //#endregion
 //#region src/generate.ts
 const meta = { dtsFile: true };
-function createGeneratePlugin({ isolatedDeclaration: isolatedDeclaration$1, inputAlias = {}, resolve = false }) {
+function createGeneratePlugin({ isolatedDeclaration: isolatedDeclaration$1, inputAlias, resolve = false, emitDtsOnly = false }) {
 	const dtsMap = new Map();
-	const inputAliasMap = new Map(Object.entries(inputAlias));
+	const inputAliasMap = new Map(inputAlias && Object.entries(inputAlias));
 	const resolver = createResolver();
 	let inputOption;
 	return {
@@ -446,6 +446,16 @@ function createGeneratePlugin({ isolatedDeclaration: isolatedDeclaration$1, inpu
 		options({ input }) {
 			if (isPlainObject(input)) inputOption = { ...input };
 		},
+		outputOptions(options) {
+			return {
+				...options,
+				entryFileNames(chunk) {
+					const original = (typeof options.entryFileNames === "function" ? options.entryFileNames(chunk) : options.entryFileNames) || "[name].js";
+					if (chunk.name.endsWith(".d")) return original.replace(RE_JS, ".$1ts");
+					return original;
+				}
+			};
+		},
 		transform: {
 			order: "pre",
 			filter: { id: {
@@ -456,17 +466,21 @@ function createGeneratePlugin({ isolatedDeclaration: isolatedDeclaration$1, inpu
 				const { code: dtsCode, errors } = isolatedDeclaration(id, code, isolatedDeclaration$1);
 				if (errors.length) return this.error(errors[0]);
 				const dtsId = filename_ts_to_dts(id);
-				dtsMap.set(dtsId, dtsCode);
+				dtsMap.set(dtsId, {
+					code: dtsCode,
+					src: id
+				});
 				const mod = this.getModuleInfo(id);
 				if (mod?.isEntry) {
-					let fileName = basename(dtsId);
-					if (inputAliasMap.has(fileName)) fileName = inputAliasMap.get(fileName);
-					else if (inputAliasMap.has(dtsId)) fileName = inputAliasMap.get(dtsId);
+					let name = basename(dtsId, extname(dtsId));
+					if (inputAliasMap.has(name)) name = inputAliasMap.get(name);
+					else if (inputAliasMap.has(dtsId)) name = inputAliasMap.get(dtsId);
 					this.emitFile({
 						type: "chunk",
 						id: dtsId,
-						fileName
+						name
 					});
+					if (emitDtsOnly) return "//";
 				}
 			}
 		},
@@ -523,11 +537,14 @@ function createGeneratePlugin({ isolatedDeclaration: isolatedDeclaration$1, inpu
 			} },
 			handler(id) {
 				if (dtsMap.has(id)) return {
-					code: dtsMap.get(id),
+					code: dtsMap.get(id).code,
 					moduleSideEffects: false
 				};
 			}
-		}
+		},
+		generateBundle: emitDtsOnly ? (options, bundle) => {
+			for (const fileName of Object.keys(bundle)) if (!RE_DTS.test(fileName)) delete bundle[fileName];
+		} : void 0
 	};
 }
 function isPlainObject(data) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rolldown-plugin-dts",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "A Rolldown plugin to bundle dts files",
   "type": "module",
   "license": "MIT",