rolldown-plugin-dts-snapshot 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright © 2025-PRESENT Kevin Deng (https://github.com/sxzz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# rolldown-plugin-dts-snapshot
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Unit Test][unit-test-src]][unit-test-href]
+
+DTS snapshot plugin for Rolldown
+
+## Install
+
+```bash
+npm i rolldown-plugin-dts-snapshot
+```
+
+## Sponsors
+
+<p align="center">
+  <a href="https://cdn.jsdelivr.net/gh/sxzz/sponsors/sponsors.svg">
+    <img src='https://cdn.jsdelivr.net/gh/sxzz/sponsors/sponsors.svg'/>
+  </a>
+</p>
+
+## License
+
+[MIT](./LICENSE) License © 2025-PRESENT [Kevin Deng](https://github.com/sxzz)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/rolldown-plugin-dts-snapshot.svg
+[npm-version-href]: https://npmjs.com/package/rolldown-plugin-dts-snapshot
+[npm-downloads-src]: https://img.shields.io/npm/dm/rolldown-plugin-dts-snapshot
+[npm-downloads-href]: https://www.npmcharts.com/compare/rolldown-plugin-dts-snapshot?interval=30
+[unit-test-src]: https://github.com/sxzz/rolldown-plugin-dts-snapshot/actions/workflows/unit-test.yml/badge.svg
+[unit-test-href]: https://github.com/sxzz/rolldown-plugin-dts-snapshot/actions/workflows/unit-test.yml

package/dist/api.d.mts

@@ -0,0 +1,4 @@
+//#region src/api.d.ts
+declare function snapshot(code: string, fileName?: string): Record<string, string>;
+//#endregion
+export { snapshot };

package/dist/api.mjs

@@ -0,0 +1,65 @@
+import dprint from "dprint-node";
+import { walk } from "estree-walker";
+import MagicString from "magic-string";
+import { parseSync } from "rolldown/experimental";
+
+//#region src/api.ts
+const multilineCommentsRE = /\/\*.*?\*\//gs;
+const singlelineCommentsRE = /\/\/.*$/gm;
+function snapshot(code, fileName = "dummy.d.ts") {
+	code = code.replaceAll(multilineCommentsRE, "").replaceAll(singlelineCommentsRE, "");
+	const s = new MagicString(code);
+	const slice = (node) => s.slice(node.start, node.end);
+	const { program } = parseSync(fileName, code);
+	walk(program, { enter(node, parent, key) {
+		if (key === "params" && node.type === "Identifier") {
+			const end = node.typeAnnotation?.start ?? node.end;
+			s.overwrite(node.start, end, "_");
+		}
+	} });
+	const result = Object.create(null);
+	for (const stmt of program.body) {
+		let decl;
+		if ((stmt.type === "ExportNamedDeclaration" || stmt.type === "ExportDefaultDeclaration") && stmt.declaration) decl = stmt.declaration;
+		else decl = stmt;
+		const register = (symbol, node) => {
+			let code$1;
+			if (node.type === "VariableDeclarator") {
+				const typeAnnotation = node.id.typeAnnotation?.typeAnnotation;
+				if (typeAnnotation) code$1 = s.slice(typeAnnotation.start, node.end);
+				else if (node.init) code$1 = slice(node.init);
+			}
+			code$1 ||= slice(node);
+			result[symbol] = format(code$1);
+		};
+		if (decl.type === "VariableDeclaration") for (const node of decl.declarations) register(nodeToString(node.id), node);
+		else if ("id" in decl && decl.id) register(nodeToString(decl.id), decl);
+		else if (decl.type === "ExportDefaultDeclaration" && "id" in decl.declaration && decl.declaration.id) register("default", decl.declaration);
+	}
+	for (const stmt of program.body) if (stmt.type === "ExportNamedDeclaration" && stmt.declaration === null && stmt.specifiers.length) for (const specifier of stmt.specifiers) {
+		const exported = nodeToString(specifier.exported);
+		const local = nodeToString(specifier.local);
+		if (local !== exported) result[exported] = result[local];
+	}
+	return result;
+	function nodeToString(node) {
+		return node.type === "Identifier" ? node.name : node.type === "Literal" ? node.value : slice(node);
+	}
+}
+function format(code) {
+	return dprint.format("dummy.d.ts", code, {
+		lineWidth: 1e8,
+		indentWidth: 1,
+		semiColons: "asi",
+		preferSingleLine: true,
+		"arrowFunction.useParentheses": "force",
+		quoteStyle: "alwaysSingle",
+		singleBodyPosition: "sameLine",
+		bracePosition: "sameLine",
+		operatorPosition: "sameLine",
+		preferHanging: true
+	}).trim().replaceAll("\n\n", "\n");
+}
+
+//#endregion
+export { snapshot };

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+import { FilterPattern } from "unplugin-utils";
+import { Plugin } from "rolldown";
+
+//#region src/index.d.ts
+interface Options {
+  /**
+  * @default /\.d\.[cm]?ts$/
+  */
+  include?: FilterPattern;
+  exclude?: FilterPattern;
+  /**
+  * @default true
+  */
+  excludeNonExport?: boolean;
+  /**
+  * @default '[cwd]/dts.snapshot.json'
+  */
+  saveTo?: string;
+}
+declare function DtsSnapshot(options?: Options): Plugin;
+//#endregion
+export { DtsSnapshot, Options };

package/dist/index.mjs

@@ -0,0 +1,33 @@
+import { snapshot } from "./api.mjs";
+import { writeFile } from "node:fs/promises";
+import { createFilter } from "unplugin-utils";
+
+//#region src/index.ts
+const RE_DTS = /\.d\.[cm]?ts$/;
+function DtsSnapshot(options = {}) {
+	const { include = RE_DTS, exclude, excludeNonExport = true, saveTo = "dts.snapshot.json" } = options;
+	const filter = createFilter(include, exclude);
+	return {
+		name: "rolldown-plugin-dts-snapshot",
+		generateBundle: {
+			order: "post",
+			async handler(_, bundle) {
+				const result = Object.create(null);
+				for (const chunk of Object.values(bundle)) {
+					if (chunk.type === "asset" || !filter(chunk.fileName)) continue;
+					const map = result[chunk.fileName] = snapshot(chunk.code, chunk.fileName);
+					if (chunk.isEntry) {
+						if (excludeNonExport) {
+							for (const key of Object.keys(map)) if (key !== "#exports" && !chunk.exports.includes(key)) delete map[key];
+						}
+						map["#exports"] = chunk.exports;
+					}
+				}
+				await writeFile(saveTo, `${JSON.stringify(result, null, 2)}\n`);
+			}
+		}
+	};
+}
+
+//#endregion
+export { DtsSnapshot };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "rolldown-plugin-dts-snapshot",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "DTS snapshot plugin for Rolldown",
+  "author": "Kevin Deng <sxzz@sxzz.moe>",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/sxzz",
+  "homepage": "https://github.com/sxzz/rolldown-plugin-dts-snapshot#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sxzz/rolldown-plugin-dts-snapshot.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sxzz/rolldown-plugin-dts-snapshot/issues"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./api": "./dist/api.mjs",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "peerDependencies": {
+    "rolldown": "^1.0.0-beta.56"
+  },
+  "dependencies": {
+    "dprint-node": "^1.0.8",
+    "estree-walker": "^3.0.3",
+    "magic-string": "^0.30.21",
+    "unplugin-utils": "^0.3.1"
+  },
+  "devDependencies": {
+    "@oxc-project/types": "^0.105.0",
+    "@sxzz/eslint-config": "^7.4.3",
+    "@sxzz/prettier-config": "^2.2.6",
+    "@types/node": "^25.0.3",
+    "@typescript/native-preview": "7.0.0-dev.20251221.1",
+    "bumpp": "^10.3.2",
+    "eslint": "^9.39.2",
+    "prettier": "^3.7.4",
+    "rolldown": "^1.0.0-beta.56",
+    "tsdown": "^0.18.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "prettier": "@sxzz/prettier-config",
+  "scripts": {
+    "lint": "eslint --cache .",
+    "lint:fix": "pnpm run lint --fix",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "typecheck": "tsgo --noEmit",
+    "format": "prettier --cache --write .",
+    "release": "bumpp"
+  }
+}