rolldown-plugin-dts 0.17.2 → 0.17.3

package/README.md

@@ -107,6 +107,15 @@ Content to be added at the top of each generated `.d.ts` file.
 
 Content to be added at the bottom of each generated `.d.ts` file.
 
+#### `sideEffects`
+
+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
+
 ### `tsc` Options
 
 > [!NOTE]

package/dist/index.d.ts

@@ -64,6 +64,14 @@ interface GeneralOptions {
   * 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
+  */
+  sideEffects?: boolean;
 }
 interface TscOptions {
   /**
@@ -190,6 +198,7 @@ declare function resolveOptions({
   cjsDefault,
   banner,
   footer,
+  sideEffects,
   build,
   incremental,
   vue,
@@ -205,8 +214,9 @@ declare function resolveOptions({
 //#region src/fake-js.d.ts
 declare function createFakeJsPlugin({
   sourcemap,
-  cjsDefault
-}: Pick<OptionsResolved, "sourcemap" | "cjsDefault">): Plugin;
+  cjsDefault,
+  sideEffects
+}: Pick<OptionsResolved, "sourcemap" | "cjsDefault" | "sideEffects">): Plugin;
 //#endregion
 //#region src/generate.d.ts
 declare function createGeneratePlugin({

package/dist/index.js

@@ -63,10 +63,10 @@ function createBannerPlugin({ banner, footer }) {
 
 //#endregion
 //#region src/dts-input.ts
-function createDtsInputPlugin() {
+function createDtsInputPlugin({ sideEffects }) {
 	return {
 		name: "rolldown-plugin-dts:dts-input",
-		options(options) {
+		options: sideEffects === false ? (options) => {
 			return {
 				treeshake: options.treeshake === false ? false : {
 					...options.treeshake === true ? {} : options.treeshake,
@@ -74,7 +74,7 @@ function createDtsInputPlugin() {
 				},
 				...options
 			};
-		},
+		} : void 0,
 		outputOptions(options) {
 			return {
 				...options,
@@ -284,7 +284,7 @@ function walk(ast, { enter, leave }) {
 
 //#endregion
 //#region src/fake-js.ts
-function createFakeJsPlugin({ sourcemap, cjsDefault }) {
+function createFakeJsPlugin({ sourcemap, cjsDefault, sideEffects }) {
 	let symbolIdx = 0;
 	const identifierMap = Object.create(null);
 	const symbolMap = /* @__PURE__ */ new Map();
@@ -325,7 +325,8 @@ function createFakeJsPlugin({ sourcemap, cjsDefault }) {
 	function transform(code, id) {
 		const file = parse(code, {
 			plugins: [["typescript", { dts: true }]],
-			sourceType: "module"
+			sourceType: "module",
+			errorRecovery: true
 		});
 		const { program, comments } = file;
 		const typeOnlyIds = [];
@@ -404,6 +405,7 @@ function createFakeJsPlugin({ sourcemap, cjsDefault }) {
 				setStmt(runtimeAssignment);
 			} else setDecl(runtimeAssignment);
 		}
+		if (sideEffects) appendStmts.push(t.expressionStatement(t.callExpression(t.identifier("sideEffect"), [])));
 		program.body = [
 			...Array.from(namespaceStmts.values()).map(({ stmt }) => stmt),
 			...program.body,
@@ -964,7 +966,6 @@ export { __json_default_export as default }`;
 				}
 				return {
 					code: dtsCode || "",
-					moduleSideEffects: false,
 					map
 				};
 			}
@@ -1010,11 +1011,14 @@ function collectJsonExportMap(code) {
 	const exportMap = /* @__PURE__ */ new Map();
 	const { program } = parse(code, {
 		sourceType: "module",
-		plugins: [["typescript", { dts: true }]]
+		plugins: [["typescript", { dts: true }]],
+		errorRecovery: true
 	});
 	for (const decl of program.body) if (decl.type === "ExportNamedDeclaration") {
-		if (decl.declaration && decl.declaration.type === "VariableDeclaration") {
-			for (const vdecl of decl.declaration.declarations) if (vdecl.id.type === "Identifier") exportMap.set(vdecl.id.name, vdecl.id.name);
+		if (decl.declaration) {
+			if (decl.declaration.type === "VariableDeclaration") {
+				for (const vdecl of decl.declaration.declarations) if (vdecl.id.type === "Identifier") exportMap.set(vdecl.id.name, vdecl.id.name);
+			} else if (decl.declaration.type === "TSModuleDeclaration" && decl.declaration.id.type === "Identifier") exportMap.set(decl.declaration.id.name, decl.declaration.id.name);
 		} else if (decl.specifiers.length) {
 			for (const spec of decl.specifiers) if (spec.type === "ExportSpecifier" && spec.exported.type === "Identifier") exportMap.set(spec.exported.name, spec.local.type === "Identifier" ? spec.local.name : spec.exported.name);
 		}
@@ -1037,7 +1041,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, cjsDefault = false, banner, footer, 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, cjsDefault = false, banner, footer, 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) || {};
@@ -1088,6 +1092,7 @@ function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = f
 		cjsDefault,
 		banner,
 		footer,
+		sideEffects,
 		build,
 		incremental,
 		vue,
@@ -1106,12 +1111,13 @@ function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = f
 function isSourceFile(id) {
 	return RE_TS.test(id) || RE_VUE.test(id) || RE_JSON.test(id);
 }
-function createDtsResolvePlugin({ tsconfig, resolve }) {
+function createDtsResolvePlugin({ tsconfig, resolve, sideEffects }) {
 	const baseDtsResolver = createResolver({
 		tsconfig,
 		resolveNodeModules: !!resolve,
 		ResolverFactory
 	});
+	const moduleSideEffects = sideEffects ? true : null;
 	return {
 		name: "rolldown-plugin-dts:resolver",
 		resolveId: {
@@ -1121,17 +1127,23 @@ function createDtsResolvePlugin({ tsconfig, resolve }) {
 				const external = {
 					id,
 					external: true,
-					moduleSideEffects: false
+					moduleSideEffects: sideEffects
 				};
 				if (RE_CSS.test(id)) return external;
 				const rolldownResolution = await this.resolve(id, importer, options);
 				const dtsResolution = 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 dtsResolution;
+				if (RE_DTS.test(dtsResolution)) return {
+					id: dtsResolution,
+					moduleSideEffects
+				};
 				if (isSourceFile(dtsResolution)) {
 					await this.load({ id: dtsResolution });
-					return filename_to_dts(dtsResolution);
+					return {
+						id: filename_to_dts(dtsResolution),
+						moduleSideEffects
+					};
 				}
 			}
 		}
@@ -1162,7 +1174,7 @@ function dts(options = {}) {
 	const resolved = resolveOptions(options);
 	debug("resolved dts options %o", resolved);
 	const plugins = [];
-	if (options.dtsInput) plugins.push(createDtsInputPlugin());
+	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));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rolldown-plugin-dts",
-  "version": "0.17.2",
+  "version": "0.17.3",
   "description": "A Rolldown plugin to generate and bundle dts files.",
   "type": "module",
   "keywords": [