rolldown-plugin-dts 0.17.1 → 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,
@@ -628,7 +630,7 @@ function isReferenceId(node) {
 	return !!node && (node.type === "Identifier" || node.type === "MemberExpression");
 }
 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));
+	return node.type === "ImportDeclaration" && node.specifiers.length === 1 && node.specifiers.every((spec) => spec.type === "ImportSpecifier" && spec.imported.type === "Identifier" && ["__export", "__reExport"].includes(spec.local.name));
 }
 /**
 * patch `.d.ts` suffix in import source to `.js`
@@ -943,10 +945,27 @@ function createGeneratePlugin({ tsconfig, tsconfigRaw, build, incremental, cwd,
 					if (result.error) return this.error(result.error);
 					dtsCode = result.code;
 					map = result.map;
+					if (dtsCode && RE_JSON.test(id)) if (dtsCode.includes("declare const _exports")) {
+						if (dtsCode.includes("declare const _exports: {")) {
+							const exports = collectJsonExports(dtsCode);
+							let i = 0;
+							dtsCode += exports.map((e) => {
+								const valid = `_${e.replaceAll(/[^\w$]/g, "_")}${i++}`;
+								const jsonKey = JSON.stringify(e);
+								return `declare let ${valid}: typeof _exports[${jsonKey}]\nexport { ${valid} as ${jsonKey} }`;
+							}).join("\n");
+						}
+					} else {
+						const exportMap = collectJsonExportMap(dtsCode);
+						dtsCode += `
+declare namespace __json_default_export {
+  export { ${Array.from(exportMap.entries()).map(([exported, local]) => exported === local ? exported : `${local} as ${exported}`).join(", ")} }
+}
+export { __json_default_export as default }`;
+					}
 				}
 				return {
 					code: dtsCode || "",
-					moduleSideEffects: false,
 					map
 				};
 			}
@@ -988,11 +1007,41 @@ async function runTsgo(root, tsconfig) {
 	], { stdio: "inherit" });
 	return tsgoDist;
 }
+function collectJsonExportMap(code) {
+	const exportMap = /* @__PURE__ */ new Map();
+	const { program } = parse(code, {
+		sourceType: "module",
+		plugins: [["typescript", { dts: true }]],
+		errorRecovery: true
+	});
+	for (const decl of program.body) if (decl.type === "ExportNamedDeclaration") {
+		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);
+		}
+	}
+	return exportMap;
+}
+/** `declare const _exports` mode */
+function collectJsonExports(code) {
+	const exports = [];
+	const { program } = parse(code, {
+		sourceType: "module",
+		plugins: [["typescript", { dts: true }]]
+	});
+	const members = program.body[0].declarations[0].id.typeAnnotation.typeAnnotation.members;
+	for (const member of members) if (member.key.type === "Identifier") exports.push(member.key.name);
+	else if (member.key.type === "StringLiteral") exports.push(member.key.value);
+	return exports;
+}
 
 //#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) || {};
@@ -1043,6 +1092,7 @@ function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = f
 		cjsDefault,
 		banner,
 		footer,
+		sideEffects,
 		build,
 		incremental,
 		vue,
@@ -1061,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: {
@@ -1076,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
+					};
 				}
 			}
 		}
@@ -1117,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.1",
+  "version": "0.17.3",
   "description": "A Rolldown plugin to generate and bundle dts files.",
   "type": "module",
   "keywords": [
@@ -78,24 +78,24 @@
     "@types/babel__generator": "^7.27.0",
     "@types/debug": "^4.1.12",
     "@types/node": "^24.9.1",
-    "@typescript/native-preview": "7.0.0-dev.20251024.1",
+    "@typescript/native-preview": "7.0.0-dev.20251027.1",
     "@volar/typescript": "^2.4.23",
-    "@vue/language-core": "^3.1.1",
+    "@vue/language-core": "^3.1.2",
     "arktype": "^2.1.23",
     "bumpp": "^10.3.1",
     "diff": "^8.0.2",
     "eslint": "^9.38.0",
     "estree-walker": "^3.0.3",
     "prettier": "^3.6.2",
-    "rolldown": "^1.0.0-beta.44",
+    "rolldown": "^1.0.0-beta.45",
     "rolldown-plugin-require-cjs": "^0.3.1",
     "rollup-plugin-dts": "^6.2.3",
     "tinyglobby": "^0.2.15",
-    "tsdown": "^0.15.9",
+    "tsdown": "^0.15.11",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.3",
+    "vitest": "^4.0.4",
     "vue": "^3.5.22",
-    "vue-tsc": "^3.1.1"
+    "vue-tsc": "^3.1.2"
   },
   "engines": {
     "node": ">=20.18.0"