rolldown-plugin-dts 0.16.4 → 0.16.6

package/README.md

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

package/dist/{context-DXNtAHtR.d.ts → context-BafOW9LT.d.ts}

@@ -1,13 +1,13 @@
-import ts from "typescript";
+import Ts from "typescript";
 
 //#region src/tsc/context.d.ts
 interface ParsedProject {
   tsconfigPath: string;
-  parsedConfig: ts.ParsedCommandLine;
+  parsedConfig: Ts.ParsedCommandLine;
 }
 type SourceFileToProjectMap = Map<string, ParsedProject>;
 interface TscContext {
-  programs: ts.Program[];
+  programs: Ts.Program[];
   files: Map<string, string>;
   projects: Map<string, SourceFileToProjectMap>;
 }
@@ -15,4 +15,4 @@ declare function createContext(): TscContext;
 declare function invalidateContextFile(context: TscContext, file: string): void;
 declare const globalContext: TscContext;
 //#endregion
-export { ParsedProject, SourceFileToProjectMap, TscContext, createContext, globalContext, invalidateContextFile };
+export { ParsedProject, SourceFileToProjectMap, type Ts, TscContext, createContext, globalContext, invalidateContextFile };

package/dist/{index-CxJisQQS.d.ts → index-BJoOXlKM.d.ts}

@@ -1,12 +1,11 @@
-import { TscContext } from "./context-DXNtAHtR.js";
+import { Ts, TscContext } from "./context-BafOW9LT.js";
 import { TsConfigJson } from "get-tsconfig";
-import ts from "typescript";
 import { SourceMapInput } from "rolldown";
 
 //#region src/tsc/types.d.ts
 interface TscModule {
-  program: ts.Program;
-  file: ts.SourceFile;
+  program: Ts.Program;
+  file: Ts.SourceFile;
 }
 interface TscOptions {
   tsconfig?: string;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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";
+import { AddonFunction, Plugin } from "rolldown";
 
 //#region src/options.d.ts
 interface GeneralOptions {
@@ -144,6 +144,14 @@ interface TscOptions {
   * `false`.
   */
   emitJs?: boolean;
+  /**
+  * Content to be added at the top of each generated `.d.ts` file.
+  */
+  banner?: string | Promise<string> | AddonFunction;
+  /**
+  * Content to be added at the bottom of each generated `.d.ts` file.
+  */
+  footer?: string | Promise<string> | AddonFunction;
 }
 interface Options extends GeneralOptions, TscOptions {
   /**
@@ -164,8 +172,9 @@ interface Options extends GeneralOptions, TscOptions {
   tsgo?: boolean;
 }
 type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
-type OptionsResolved = Overwrite<Required<Omit<Options, "compilerOptions">>, {
-  tsconfig: string | undefined;
+type MarkPartial<T, K extends keyof T> = Omit<Required<T>, K> & Partial<Pick<T, K>>;
+type OptionsResolved = Overwrite<MarkPartial<Omit<Options, "compilerOptions">, "banner" | "footer">, {
+  tsconfig?: string;
   oxc: IsolatedDeclarationsOptions | false;
   tsconfigRaw: TsConfigJson;
 }>;
@@ -179,6 +188,8 @@ declare function resolveOptions({
   sourcemap,
   resolve,
   cjsDefault,
+  banner,
+  footer,
   build,
   incremental,
   vue,

package/dist/index.js

@@ -1,8 +1,8 @@
 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-Digr9tkU.js";
+import { createRequire } from "node:module";
 import Debug from "debug";
-import _generate from "@babel/generator";
-import { parse } from "@babel/parser";
+import MagicString from "magic-string";
 import * as t from "@babel/types";
 import { isDeclarationType, isTypeOf, resolveString } from "ast-kit";
 import { fork, spawn } from "node:child_process";
@@ -15,6 +15,36 @@ import process from "node:process";
 import { getTsconfig, parseTsconfig } from "get-tsconfig";
 import { createResolver } from "dts-resolver";
 
+//#region src/banner.ts
+function createBannerPlugin({ banner, footer }) {
+	return {
+		name: "rolldown-plugin-dts:banner",
+		async renderChunk(code, chunk) {
+			if (!RE_DTS.test(chunk.fileName)) return;
+			const s = new MagicString(code);
+			if (banner) {
+				const code$1 = await (typeof banner === "function" ? banner(chunk) : banner);
+				if (code$1) s.prepend(`${code$1}\n`);
+			}
+			if (footer) {
+				const code$1 = await (typeof footer === "function" ? footer(chunk) : footer);
+				if (code$1) s.append(`\n${code$1}`);
+			}
+			return {
+				code: s.toString(),
+				get map() {
+					return s.generateMap({
+						source: chunk.fileName,
+						includeContent: true,
+						hires: "boundary"
+					});
+				}
+			};
+		}
+	};
+}
+
+//#endregion
 //#region src/dts-input.ts
 function createDtsInputPlugin() {
 	return {
@@ -237,7 +267,9 @@ function walk(ast, { enter, leave }) {
 
 //#endregion
 //#region src/fake-js.ts
-const generate = _generate.default || _generate;
+const require = createRequire(import.meta.url);
+const { parse } = require("@babel/parser");
+const generate = require("@babel/generator").default;
 function createFakeJsPlugin({ sourcemap, cjsDefault }) {
 	let symbolIdx = 0;
 	const identifierMap = Object.create(null);
@@ -865,7 +897,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, cjsDefault = false, 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, 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) || {};
@@ -914,6 +946,8 @@ function resolveOptions({ cwd = process.cwd(), dtsInput = false, emitDtsOnly = f
 		sourcemap,
 		resolve,
 		cjsDefault,
+		banner,
+		footer,
 		build,
 		incremental,
 		vue,
@@ -940,30 +974,30 @@ function createDtsResolvePlugin({ tsconfig, resolve }) {
 		resolveNodeModules: !!resolve,
 		ResolverFactory
 	});
-	const resolveDtsPath = (id, importer, rolldownResolution) => {
+	function resolveDtsPath(id, importer, rolldownResolution) {
 		let dtsPath = baseDtsResolver(id, importer);
 		if (dtsPath) dtsPath = path.normalize(dtsPath);
 		if (!dtsPath || !isSourceFile(dtsPath)) {
-			if (rolldownResolution && isSourceFile(rolldownResolution.id)) return rolldownResolution.id;
+			if (rolldownResolution && isFilePath(rolldownResolution.id) && isSourceFile(rolldownResolution.id) && !rolldownResolution.external) return rolldownResolution.id;
 			return null;
 		}
 		return dtsPath;
-	};
+	}
 	return {
 		name: "rolldown-plugin-dts:resolver",
 		resolveId: {
 			order: "pre",
 			async handler(id, importer, options) {
+				if (!importer || !RE_DTS.test(importer)) return;
 				const external = {
 					id,
 					external: true,
 					moduleSideEffects: false
 				};
-				if (!importer || !RE_DTS.test(importer)) return;
 				if (RE_CSS.test(id)) return external;
 				const rolldownResolution = await this.resolve(id, importer, options);
 				const dtsResolution = resolveDtsPath(id, importer, rolldownResolution);
-				if (!dtsResolution) return id.startsWith(".") || path.isAbsolute(id) ? null : external;
+				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 (isSourceFile(dtsResolution)) {
@@ -974,6 +1008,9 @@ function createDtsResolvePlugin({ tsconfig, resolve }) {
 		}
 	};
 }
+function isFilePath(id) {
+	return id.startsWith(".") || path.isAbsolute(id);
+}
 
 //#endregion
 //#region src/index.ts
@@ -986,6 +1023,7 @@ function dts(options = {}) {
 	if (options.dtsInput) plugins.push(createDtsInputPlugin());
 	else plugins.push(createGeneratePlugin(resolved));
 	plugins.push(createDtsResolvePlugin(resolved), createFakeJsPlugin(resolved));
+	if (options.banner || options.footer) plugins.push(createBannerPlugin(resolved));
 	return plugins;
 }
 

package/dist/{tsc-DLbQk3B6.js → tsc-CCjlVYkv.js}

@@ -2,9 +2,13 @@ import { globalContext } from "./context-Digr9tkU.js";
 import { createRequire } from "node:module";
 import Debug from "debug";
 import path from "node:path";
-import ts from "typescript";
 import { pathToFileURL } from "node:url";
 
+//#region src/tsc/require-tsc.ts
+const require$1 = createRequire(import.meta.url);
+const ts = require$1("typescript");
+
+//#endregion
 //#region src/tsc/system.ts
 const debug$3 = Debug("rolldown-plugin-dts:tsc-system");
 /**

package/dist/tsc-context.d.ts

@@ -1,2 +1,2 @@
-import { ParsedProject, SourceFileToProjectMap, TscContext, createContext, globalContext, invalidateContextFile } from "./context-DXNtAHtR.js";
+import { ParsedProject, SourceFileToProjectMap, TscContext, createContext, globalContext, invalidateContextFile } from "./context-BafOW9LT.js";
 export { ParsedProject, SourceFileToProjectMap, TscContext, createContext, globalContext, invalidateContextFile };

package/dist/tsc-worker.d.ts

@@ -1,5 +1,5 @@
-import "./context-DXNtAHtR.js";
-import { tscEmit } from "./index-CxJisQQS.js";
+import "./context-BafOW9LT.js";
+import { tscEmit } from "./index-BJoOXlKM.js";
 
 //#region src/tsc/worker.d.ts
 declare const functions: {

package/dist/tsc-worker.js

@@ -1,5 +1,5 @@
 import "./context-Digr9tkU.js";
-import { tscEmit } from "./tsc-DLbQk3B6.js";
+import { tscEmit } from "./tsc-CCjlVYkv.js";
 import process from "node:process";
 import { createBirpc } from "birpc";
 

package/dist/tsc.d.ts

@@ -1,3 +1,3 @@
-import "./context-DXNtAHtR.js";
-import { TscModule, TscOptions, TscResult, tscEmit } from "./index-CxJisQQS.js";
+import "./context-BafOW9LT.js";
+import { TscModule, TscOptions, TscResult, tscEmit } from "./index-BJoOXlKM.js";
 export { TscModule, TscOptions, TscResult, tscEmit };

package/dist/tsc.js

@@ -1,4 +1,4 @@
 import "./context-Digr9tkU.js";
-import { tscEmit } from "./tsc-DLbQk3B6.js";
+import { tscEmit } from "./tsc-CCjlVYkv.js";
 
 export { tscEmit };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rolldown-plugin-dts",
-  "version": "0.16.4",
+  "version": "0.16.6",
   "description": "A Rolldown plugin to generate and bundle dts files.",
   "type": "module",
   "keywords": [
@@ -66,33 +66,35 @@
     "@babel/types": "^7.28.4",
     "ast-kit": "^2.1.2",
     "birpc": "^2.5.0",
-    "debug": "^4.4.1",
+    "debug": "^4.4.3",
     "dts-resolver": "^2.1.2",
-    "get-tsconfig": "^4.10.1"
+    "get-tsconfig": "^4.10.1",
+    "magic-string": "^0.30.19"
   },
   "devDependencies": {
     "@sxzz/eslint-config": "^7.1.4",
     "@sxzz/prettier-config": "^2.2.4",
-    "@sxzz/test-utils": "^0.5.10",
+    "@sxzz/test-utils": "^0.5.11",
     "@types/babel__generator": "^7.27.0",
     "@types/debug": "^4.1.12",
-    "@types/node": "^24.3.1",
-    "@typescript/native-preview": "7.0.0-dev.20250911.1",
+    "@types/node": "^24.5.2",
+    "@typescript/native-preview": "7.0.0-dev.20250918.1",
     "@volar/typescript": "^2.4.23",
-    "@vue/language-core": "^3.0.6",
+    "@vue/language-core": "^3.0.7",
+    "arktype": "^2.1.22",
     "bumpp": "^10.2.3",
     "diff": "^8.0.2",
     "eslint": "^9.35.0",
     "estree-walker": "^3.0.3",
     "prettier": "^3.6.2",
-    "rolldown": "^1.0.0-beta.37",
+    "rolldown": "^1.0.0-beta.38",
     "rollup-plugin-dts": "^6.2.3",
     "tinyglobby": "^0.2.15",
-    "tsdown": "^0.15.0",
+    "tsdown": "^0.15.2",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
     "vue": "^3.5.21",
-    "vue-tsc": "^3.0.6"
+    "vue-tsc": "^3.0.7"
   },
   "engines": {
     "node": ">=20.18.0"