tsdown 0.21.10 → 0.22.0-beta.2

package/dist/{build-CgGnBlCD.mjs → build-CLGhOCqV.mjs}

@@ -1,20 +1,20 @@
 import { createRequire as __cjs_createRequire } from "node:module";
 const __cjs_require = __cjs_createRequire(import.meta.url);
-import { a as getPackageType, c as isGlobEntry, d as cleanOutDir, i as loadConfigFile, l as toObjectEntry, n as mergeUserOptions, o as writeExports, r as resolveUserConfig, s as buildExe, t as mergeConfig, u as cleanChunks } from "./options-8hmVMssn.mjs";
+import { a as getPackageType, c as isGlobEntry, d as cleanOutDir, i as loadConfigFile, l as toObjectEntry, n as mergeUserOptions, o as writeExports, r as resolveUserConfig, s as buildExe, t as mergeConfig, u as cleanChunks } from "./options-DUthngzZ.mjs";
 import { r as fsRemove } from "./fs-Dd6Htx2P.mjs";
 import { a as pkgExists, l as slash, n as importWithError, o as promiseWithResolvers, t as debounce } from "./general-D3muxt2f.mjs";
 import { a as globalLogger, t as LogLevels } from "./logger-uV8l1UFa.mjs";
 import { i as getShimsInject, n as DepsPlugin } from "./format-CajNSstg.mjs";
-import { a as ReportPlugin, i as ShebangPlugin, n as endsWithConfig, o as NodeProtocolPlugin, r as addOutDirToChunks, s as copy, t as WatchPlugin } from "./watch-D6EGzM6P.mjs";
-import { t as version } from "./package-GYPjxY9U.mjs";
+import { a as ReportPlugin, i as ShebangPlugin, n as endsWithConfig, o as NodeProtocolPlugin, r as addOutDirToChunks, s as copy, t as WatchPlugin } from "./watch-B659_4oi.mjs";
+import { t as version } from "./package-CeuhhDjU.mjs";
 import { mkdtemp, readFile, readdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import process from "node:process";
 import { bold, dim, green } from "ansis";
 import { createDebug } from "obug";
+import { RE_CSS, RE_DTS, RE_JS, filename_js_to_dts } from "rolldown-plugin-dts/internal";
 import { glob } from "tinyglobby";
 import readline from "node:readline";
-import { RE_CSS, RE_DTS, RE_JS, filename_js_to_dts } from "rolldown-plugin-dts/internal";
 import { tmpdir } from "node:os";
 const satisfies = __cjs_require("semver/functions/satisfies.js");
 import { exec, x } from "tinyexec";
@@ -38,7 +38,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region src/config/workspace.ts
-const debug$4 = createDebug("tsdown:config:workspace");
+const debug$5 = createDebug("tsdown:config:workspace");
 const DEFAULT_EXCLUDE_WORKSPACE = [
 	"**/node_modules/**",
 	"**/dist/**",
@@ -72,7 +72,7 @@ async function resolveWorkspace(config, inlineConfig, rootDeps) {
 	if (packages.length === 0) throw new Error("No workspace packages found, please check your config");
 	return {
 		configs: (await Promise.all(packages.map(async (cwd) => {
-			debug$4("loading workspace config %s", cwd);
+			debug$5("loading workspace config %s", cwd);
 			const { configs, deps: workspaceDeps } = await loadConfigFile({
 				...inlineConfig,
 				config: workspaceConfig,
@@ -86,20 +86,20 @@ async function resolveWorkspace(config, inlineConfig, rootDeps) {
 }
 //#endregion
 //#region src/config/index.ts
-const debug$3 = createDebug("tsdown:config");
+const debug$4 = createDebug("tsdown:config");
 async function resolveConfig(inlineConfig) {
-	debug$3("inline config %O", inlineConfig);
+	debug$4("inline config %O", inlineConfig);
 	if (inlineConfig.cwd) inlineConfig.cwd = path.resolve(inlineConfig.cwd);
 	const { configs: rootConfigs, deps: rootDeps } = await loadConfigFile(inlineConfig);
 	const globalDeps = new Set(rootDeps);
 	const configs = (await Promise.all(rootConfigs.map(async (rootConfig) => {
 		const { configs: workspaceConfigs, deps: workspaceDeps } = await resolveWorkspace(rootConfig, inlineConfig, rootDeps);
-		debug$3("workspace configs %O", workspaceConfigs);
+		debug$4("workspace configs %O", workspaceConfigs);
 		const configs = (await Promise.all(workspaceConfigs.filter((config) => !config.workspace || config.entry).map((config) => resolveUserConfig(config, inlineConfig, workspaceDeps)))).flat().filter((config) => !!config);
 		workspaceDeps.forEach((dep) => globalDeps.add(dep));
 		return configs;
 	}))).flat();
-	debug$3("resolved configs %O", configs);
+	debug$4("resolved configs %O", configs);
 	if (configs.length === 0) throw new Error("No valid configuration found.");
 	return {
 		configs,
@@ -176,7 +176,7 @@ function executeOnSuccess(config) {
 }
 //#endregion
 //#region src/features/pkg/attw.ts
-const debug$2 = createDebug("tsdown:attw");
+const debug$3 = createDebug("tsdown:attw");
 const label$1 = dim`[attw]`;
 const problemFlags = {
 	NoResolution: "no-resolution",
@@ -213,7 +213,7 @@ async function attw(options, tarball) {
 	const invalidRules = ignoreRules.filter((rule) => !Object.values(problemFlags).includes(rule));
 	if (invalidRules.length) options.logger.warn(`attw config option 'ignoreRules' contains invalid value '${invalidRules.join(", ")}'.`);
 	const t = performance.now();
-	debug$2("Running attw check");
+	debug$3("Running attw check");
 	const attwCore = options.attw.module || await importWithError("@arethetypeswrong/core");
 	const pkg = attwCore.createPackageFromTarballData(tarball);
 	const checkResult = await attwCore.checkPackage(pkg, attwOptions);
@@ -256,7 +256,7 @@ function formatProblem(packageName, problem) {
 }
 //#endregion
 //#region src/features/pkg/publint.ts
-const debug$1 = createDebug("tsdown:publint");
+const debug$2 = createDebug("tsdown:publint");
 const label = dim`[publint]`;
 async function publint(options, tarball) {
 	if (!options.publint) return;
@@ -265,20 +265,20 @@ async function publint(options, tarball) {
 		return;
 	}
 	const t = performance.now();
-	debug$1("Running publint");
+	debug$2("Running publint");
 	const { publint } = options.publint.module?.[0] || await importWithError("publint");
 	const { formatMessage } = options.publint.module?.[1] || await importWithError("publint/utils");
-	const { messages } = await publint({
+	const { messages, pkg } = await publint({
 		...options.publint,
 		pack: { tarball: tarball.buffer }
 	});
-	debug$1("Found %d issues", messages.length);
+	debug$2("Found %d issues", messages.length);
 	if (!messages.length) {
 		options.logger.success(options.nameLabel, label, "No issues found", dim`(${Math.round(performance.now() - t)}ms)`);
 		return;
 	}
 	for (const message of messages) {
-		const formattedMessage = formatMessage(message, options.pkg);
+		const formattedMessage = formatMessage(message, pkg);
 		const logType = {
 			error: "error",
 			warning: "warn",
@@ -289,6 +289,7 @@ async function publint(options, tarball) {
 }
 //#endregion
 //#region src/features/pkg/index.ts
+const debug$1 = createDebug("tsdown:pkg");
 function initBundleByPkg(configs) {
 	const map = {};
 	for (const config of configs) {
@@ -347,10 +348,14 @@ async function packTarball(packageJsonPath) {
 	const { detect } = await import("./detect-DN3DXXYt.mjs");
 	try {
 		const detected = await detect({ cwd: pkgDir });
+		debug$1("Detected package manager: %o", detected);
 		if (detected?.name === "deno") throw new Error(`Cannot pack tarball for Deno projects at ${pkgDir}`);
-		return readFile(await pack(pkgDir, detected, destination, true));
+		const tarballPath = await pack(pkgDir, detected, destination, true);
+		debug$1("Packed tarball at %s", tarballPath);
+		return readFile(tarballPath);
 	} finally {
-		await fsRemove(destination);
+		if (debug$1.enabled) debug$1("Preserving pack directory for debugging: %s", destination);
+		else await fsRemove(destination);
 	}
 }
 function dedupeConfigs(configs, key) {
@@ -578,8 +583,7 @@ async function resolveOutputOptions(inputOptions, config, format, cjsDts) {
 	}, config.outputOptions, [format, { cjsDts }]);
 }
 async function getDebugRolldownDir() {
-	if (!debug.enabled) return;
-	return await mkdtemp(path.join(tmpdir(), "tsdown-config-"));
+	if (debug.enabled) return await mkdtemp(path.join(tmpdir(), "tsdown-config-"));
 }
 async function debugBuildOptions(dir, name, format, buildOptions) {
 	const outFile = path.join(dir, `rolldown.config.${format}.js`);

package/dist/{config-CuK0i1Bc.d.mts → config-BWeUm0f3.d.mts}

@@ -1,4 +1,4 @@
-import { d as UserConfig, f as UserConfigExport, i as InlineConfig, o as ResolvedConfig, p as UserConfigFn } from "./types-BZNNnDKc.mjs";
+import { d as UserConfig, f as UserConfigExport, i as InlineConfig, o as ResolvedConfig, p as UserConfigFn } from "./types-CQaSBA5U.mjs";
 
 //#region src/config/options.d.ts
 /**

package/dist/config.d.mts

@@ -1,3 +1,3 @@
-import { d as UserConfig, f as UserConfigExport, p as UserConfigFn } from "./types-BZNNnDKc.mjs";
-import { n as mergeConfig, t as defineConfig } from "./config-CuK0i1Bc.mjs";
+import { d as UserConfig, f as UserConfigExport, p as UserConfigFn } from "./types-CQaSBA5U.mjs";
+import { n as mergeConfig, t as defineConfig } from "./config-BWeUm0f3.mjs";
 export { UserConfig, UserConfigExport, UserConfigFn, defineConfig, mergeConfig };

package/dist/config.mjs

@@ -1,4 +1,4 @@
-import { t as mergeConfig } from "./options-8hmVMssn.mjs";
+import { t as mergeConfig } from "./options-DUthngzZ.mjs";
 //#region src/config.ts
 function defineConfig(options) {
 	return options;

package/dist/{index-DraNj4FA.d.mts → index-CTZ4qxd_.d.mts}

@@ -27,7 +27,9 @@ interface Logger {
 }
 declare const globalLogger: Logger;
 //#endregion
-//#region node_modules/.pnpm/pkg-types@2.3.0/node_modules/pkg-types/dist/index.d.mts
+//#region node_modules/.pnpm/pkg-types@2.3.1/node_modules/pkg-types/dist/index.d.mts
+//#endregion
+//#region src/packagejson/types.d.ts
 interface PackageJson {
   /**
    * The name is what your thing is called.
@@ -321,7 +323,8 @@ type PackageJsonFunding = string | {
 };
 type PackageJsonExportKey = "." | "import" | "require" | "types" | "node" | "browser" | "default" | (string & {});
 type PackageJsonExportsObject = { [P in PackageJsonExportKey]?: string | PackageJsonExportsObject | Array<string | PackageJsonExportsObject> };
-type PackageJsonExports = string | PackageJsonExportsObject | Array<string | PackageJsonExportsObject>;
+type PackageJsonExports = string | PackageJsonExportsObject | Array<string | PackageJsonExportsObject>; //#endregion
+//#region src/packagejson/utils.d.ts
 /**
  * Defines a PackageJson structure.
  * @param pkg - The `package.json` content as an object. See {@link PackageJson}.

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { a as Arrayable, i as globalLogger, r as Logger } from "./index-DraNj4FA.mjs";
-import { A as PackageType, B as ResolvedDepsConfig, C as ChunkAddon, D as OutExtensionFactory, E as OutExtensionContext, F as SeaConfig, G as CopyOptionsFn, H as TsdownBundle, I as DevtoolsOptions, L as DepsConfig, M as RolldownContext, N as TsdownHooks, O as OutExtensionObject, P as ExeOptions, S as AttwOptions, T as ChunkAddonObject, U as CopyEntry, V as RolldownChunk, W as CopyOptions, a as NormalizedFormat, b as PublintOptions, c as TreeshakingOptions, d as UserConfig, f as UserConfigExport, g as ReportOptions, h as Workspace, i as InlineConfig, j as BuildContext, k as PackageJsonWithPath, l as TsdownInputOption, m as WithEnabled, n as DtsOptions, o as ResolvedConfig, p as UserConfigFn, r as Format, s as Sourcemap, t as CIOption, u as UnusedOptions, v as TsdownPlugin, w as ChunkAddonFunction, x as ExportsOptions, y as TsdownPluginOption, z as NoExternalFn } from "./types-BZNNnDKc.mjs";
-import { n as mergeConfig, r as resolveUserConfig, t as defineConfig } from "./config-CuK0i1Bc.mjs";
+import { a as Arrayable, i as globalLogger, r as Logger } from "./index-CTZ4qxd_.mjs";
+import { A as PackageType, B as ResolvedDepsConfig, C as ChunkAddon, D as OutExtensionFactory, E as OutExtensionContext, F as SeaConfig, G as CopyOptionsFn, H as TsdownBundle, I as DevtoolsOptions, L as DepsConfig, M as RolldownContext, N as TsdownHooks, O as OutExtensionObject, P as ExeOptions, S as AttwOptions, T as ChunkAddonObject, U as CopyEntry, V as RolldownChunk, W as CopyOptions, a as NormalizedFormat, b as PublintOptions, c as TreeshakingOptions, d as UserConfig, f as UserConfigExport, g as ReportOptions, h as Workspace, i as InlineConfig, j as BuildContext, k as PackageJsonWithPath, l as TsdownInputOption, m as WithEnabled, n as DtsOptions, o as ResolvedConfig, p as UserConfigFn, r as Format, s as Sourcemap, t as CIOption, u as UnusedOptions, v as TsdownPlugin, w as ChunkAddonFunction, x as ExportsOptions, y as TsdownPluginOption, z as NoExternalFn } from "./types-CQaSBA5U.mjs";
+import { n as mergeConfig, r as resolveUserConfig, t as defineConfig } from "./config-BWeUm0f3.mjs";
 import * as Rolldown from "rolldown";
 
 //#region src/build.d.ts

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { n as buildWithConfigs, t as build } from "./build-CgGnBlCD.mjs";
-import { r as resolveUserConfig, t as mergeConfig } from "./options-8hmVMssn.mjs";
+import { n as buildWithConfigs, t as build } from "./build-CLGhOCqV.mjs";
+import { r as resolveUserConfig, t as mergeConfig } from "./options-DUthngzZ.mjs";
 import { a as globalLogger } from "./logger-uV8l1UFa.mjs";
 import { defineConfig } from "./config.mjs";
 import { t as enableDebug } from "./debug-CLlnG64L.mjs";

package/dist/internal.d.mts

@@ -1,4 +1,4 @@
-import { c as Overwrite, r as Logger, s as MarkPartial } from "./index-DraNj4FA.mjs";
+import { c as Overwrite, r as Logger, s as MarkPartial } from "./index-CTZ4qxd_.mjs";
 
 //#region src/features/target.d.ts
 declare function expandBaselineTarget(targets: string[]): string[];

package/dist/{options-8hmVMssn.mjs → options-DUthngzZ.mjs}

@@ -11,9 +11,9 @@ import process, { env } from "node:process";
 import { blue, bold, dim, red, underline } from "ansis";
 import { createDefu } from "defu";
 import { createDebug } from "obug";
+import { RE_CSS, RE_DTS, RE_NODE_MODULES, readTsconfig } from "rolldown-plugin-dts/internal";
 import { glob, isDynamicPattern } from "tinyglobby";
 const picomatch = __cjs_require("picomatch");
-import { RE_CSS, RE_DTS, RE_NODE_MODULES } from "rolldown-plugin-dts/internal";
 import { tmpdir } from "node:os";
 const satisfies = __cjs_require("semver/functions/satisfies.js");
 import { x } from "tinyexec";
@@ -399,25 +399,19 @@ function exportCss(exports, chunks, css, pkgRoot) {
 		return;
 	}
 }
-function hasExportsTypes(pkg) {
-	const exports = pkg?.exports;
-	if (!exports) return false;
-	if (typeof exports === "object" && exports !== null && !Array.isArray(exports)) {
-		if ("types" in exports) return true;
-		if ("." in exports) {
-			const mainExport = exports["."];
-			if (typeof mainExport === "object" && mainExport !== null && "types" in mainExport) return true;
-		}
-	}
-	return false;
+function hasExportsTypes(value) {
+	if (value == null || typeof value !== "object") return false;
+	if (Array.isArray(value)) return value.some(hasExportsTypes);
+	if ("types" in value) return true;
+	return Object.values(value).some(hasExportsTypes);
 }
 const RE_SHEBANG = /^#!.*/;
 function generateBin(bin, devExports, pkg, chunks, pkgRoot, logger, cwd) {
-	if (!bin) return;
-	if (bin === true || typeof bin === "string") {
+	if (bin === false) return;
+	if (bin === true || bin === void 0 || typeof bin === "string") {
 		if (!pkg.name) throw new Error("Package name is required when using string form for `bin`");
 		const binName = pkg.name[0] === "@" ? pkg.name.split("/", 2)[1] : pkg.name;
-		if (bin === true) {
+		if (bin === true || bin === void 0) {
 			let detected;
 			const seen = /* @__PURE__ */ new Set();
 			for (const format of ["es", "cjs"]) {
@@ -428,12 +422,16 @@ function generateBin(bin, devExports, pkg, chunks, pkgRoot, logger, cwd) {
 					if (!RE_SHEBANG.test(chunk.code)) continue;
 					if (seen.has(chunk.facadeModuleId)) continue;
 					seen.add(chunk.facadeModuleId);
-					if (detected) throw new Error("Multiple entry chunks with shebangs found. Use `exports.bin: { name: \"./src/file.ts\" }` to specify which one to use.");
+					if (detected) {
+						if (bin === true) throw new Error("Multiple entry chunks with shebangs found. Use `exports.bin: { command: \"./src/file.ts\" }` to specify which one to use.");
+						logger.warn("Multiple entry chunks with shebangs found. Use `exports.bin: true` or `exports.bin: { command: \"./src/file.ts\" }` to configure explicitly.");
+						return;
+					}
 					detected = devExports ? `./${slash(path.relative(pkgRoot, chunk.facadeModuleId))}` : join(pkgRoot, chunk.outDir, slash(chunk.fileName));
 				}
 			}
 			if (detected == null) {
-				logger.warn("`exports.bin` is true but no entry chunks with shebangs were found");
+				if (bin === true) logger.warn("`exports.bin` is true but no entry chunks with shebangs were found");
 				return;
 			}
 			return { [binName]: detected };
@@ -654,8 +652,7 @@ const isBun = !!process.versions.bun;
 const nativeTS = process.features.typescript || process.versions.deno;
 const autoLoader = isBun || nativeTS && isSupported ? "native" : "unrun";
 function resolveConfigLoader(configLoader = "auto") {
-	if (configLoader === "auto") return autoLoader;
-	else return configLoader === "native" ? "native" : "unrun";
+	return configLoader === "auto" ? autoLoader : configLoader;
 }
 function createParser(loader) {
 	return async (filepath) => {
@@ -666,7 +663,12 @@ function createParser(loader) {
 			const parsed = JSON.parse(contents);
 			return [isPkgJson ? parsed?.tsdown : parsed, new Set([filepath])];
 		}
-		return (loader === "native" ? nativeImport : unrunImport)(filepath);
+		switch (loader) {
+			case "native": return nativeImport(filepath);
+			case "tsx": return tsxImport(filepath);
+			case "unrun": return unrunImport(filepath);
+			default: throw new Error(`Unknown config loader: ${loader}`);
+		}
 	};
 }
 async function nativeImport(id) {
@@ -678,14 +680,19 @@ async function nativeImport(id) {
 		init({ skipNodeModules: true });
 	} else if (!isBun) url.searchParams.set("no-cache", crypto.randomUUID());
 	const mod = await depsStore.run(deps, () => import(url.href, { with: importAttributes }).catch((error) => {
-		if (error?.message?.includes?.("Cannot find module")) throw new Error(`Failed to load the config file. Try setting the --config-loader CLI flag to \`unrun\`.\n\n${error.message}`, { cause: error });
-		if (typeof error?.stack === "string" && error.stack.includes("node:internal/modules/esm/translators")) throw new Error(`Failed to load the config file due to a known Node.js bug. Try setting the --config-loader CLI flag to \`unrun\` or upgrading Node.js to v24.11.1 or later.\n\n${error.message}`, { cause: error });
+		if (error?.message?.includes?.("Cannot find module")) throw new Error(`Failed to load the config file. Try setting the --config-loader CLI flag to \`tsx\` or \`unrun\`.\n\n${error.message}`, { cause: error });
+		if (typeof error?.stack === "string" && error.stack.includes("node:internal/modules/esm/translators")) throw new Error(`Failed to load the config file due to a known Node.js bug. Try setting the --config-loader CLI flag to \`tsx\` or \`unrun\`, or upgrading Node.js to v24.11.1 or later.\n\n${error.message}`, { cause: error });
 		throw error;
 	}));
-	return [mod.default || mod, deps];
+	return [mod?.default || mod, deps];
+}
+async function tsxImport(id) {
+	const { tsImport } = await importWithError("tsx/esm/api");
+	const module = await tsImport(pathToFileURL(id).href, import.meta.url);
+	return [module?.default || module, new Set([id])];
 }
 async function unrunImport(id) {
-	const { unrun } = await import("unrun");
+	const { unrun } = await importWithError("unrun");
 	const { module, dependencies } = await unrun({ path: pathToFileURL(id).href });
 	return [module, new Set(dependencies)];
 }
@@ -738,7 +745,12 @@ async function resolveUserConfig(userConfig, inlineConfig, configDeps) {
 	unused = resolveFeatureOption(unused, {});
 	report = resolveFeatureOption(report, {});
 	exe = resolveFeatureOption(exe, {});
-	if (dts == null) dts = exe ? false : !!(pkg?.types || pkg?.typings || hasExportsTypes(pkg));
+	if (dts == null) if (exe) dts = false;
+	else if (pkg?.types || pkg?.typings || hasExportsTypes(pkg?.exports)) dts = true;
+	else if (tsconfig) {
+		const { config } = readTsconfig(tsconfig);
+		dts = !!config.compilerOptions?.declaration;
+	} else dts = false;
 	dts = resolveFeatureOption(dts, {});
 	if (!pkg) {
 		if (exports) throw new Error("`package.json` not found, cannot write exports");

package/dist/{package-GYPjxY9U.mjs → package-CeuhhDjU.mjs}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.21.10";
+var version = "0.22.0-beta.2";
 //#endregion
 export { version as t };

package/dist/plugins.d.mts

@@ -1,5 +1,5 @@
-import { r as Logger } from "./index-DraNj4FA.mjs";
-import { H as TsdownBundle, R as DepsPlugin, _ as ReportPlugin } from "./types-BZNNnDKc.mjs";
+import { r as Logger } from "./index-CTZ4qxd_.mjs";
+import { H as TsdownBundle, R as DepsPlugin, _ as ReportPlugin } from "./types-CQaSBA5U.mjs";
 import { Plugin } from "rolldown";
 
 //#region src/features/node-protocol.d.ts

package/dist/plugins.mjs

@@ -1,3 +1,3 @@
 import { n as DepsPlugin } from "./format-CajNSstg.mjs";
-import { a as ReportPlugin, i as ShebangPlugin, o as NodeProtocolPlugin, t as WatchPlugin } from "./watch-D6EGzM6P.mjs";
+import { a as ReportPlugin, i as ShebangPlugin, o as NodeProtocolPlugin, t as WatchPlugin } from "./watch-B659_4oi.mjs";
 export { DepsPlugin, NodeProtocolPlugin, ReportPlugin, ShebangPlugin, WatchPlugin };

package/dist/run.mjs

@@ -1,15 +1,12 @@
 #!/usr/bin/env node
-import { createRequire as __cjs_createRequire } from "node:module";
-const __cjs_require = __cjs_createRequire(import.meta.url);
 import { a as globalLogger } from "./logger-uV8l1UFa.mjs";
-import { t as version } from "./package-GYPjxY9U.mjs";
+import { t as version } from "./package-CeuhhDjU.mjs";
 import { t as enableDebug } from "./debug-CLlnG64L.mjs";
 import module from "node:module";
 import process from "node:process";
-import { blue, hex, yellow } from "ansis";
+import { blue, hex } from "ansis";
 import { x } from "tinyexec";
 import { VERSION } from "rolldown";
-const lt = __cjs_require("semver/functions/lt.js");
 import { cac } from "cac";
 //#region src/cli.ts
 const cli = cac("tsdown");
@@ -17,10 +14,10 @@ cli.help().version(version);
 cli.command("[...files]", "Bundle files", {
 	ignoreOptionDefaultValue: true,
 	allowUnknownOptions: true
-}).option("-c, --config <filename>", "Use a custom config file").option("--config-loader <loader>", "Config loader to use: auto, native, unrun", { default: "auto" }).option("--no-config", "Disable config file").option("-f, --format <format>", "Bundle format: esm, cjs, iife, umd", { default: "esm" }).option("--clean", "Clean output directory, --no-clean to disable").option("--deps.never-bundle <module>", "Mark dependencies as external").option("--minify", "Minify output").option("--devtools", "Enable devtools integration").option("--debug [feat]", "Show debug logs").option("--target <target>", "Bundle target, e.g \"es2015\", \"esnext\"").option("-l, --logLevel <level>", "Set log level: info, warn, error, silent").option("--fail-on-warn", "Fail on warnings", { default: true }).option("--no-write", "Disable writing files to disk, incompatible with watch mode").option("-d, --out-dir <dir>", "Output directory", { default: "dist" }).option("--treeshake", "Tree-shake bundle", { default: true }).option("--sourcemap", "Generate source map", { default: false }).option("--shims", "Enable cjs and esm shims ", { default: false }).option("--platform <platform>", "Target platform", { default: "node" }).option("--dts", "Generate dts files").option("--publint", "Enable publint", { default: false }).option("--attw", "Enable Are the types wrong integration", { default: false }).option("--unused", "Enable unused dependencies check", { default: false }).option("-w, --watch [path]", "Watch mode").option("--ignore-watch <path>", "Ignore custom paths in watch mode").option("--from-vite [vitest]", "Reuse config from Vite or Vitest").option("--report", "Size report", { default: true }).option("--env.* <value>", "Define compile-time env variables").option("--env-file <file>", "Load environment variables from a file, when used together with --env, variables in --env take precedence").option("--env-prefix <prefix>", "Prefix for env variables to inject into the bundle", { default: "TSDOWN_" }).option("--on-success <command>", "Command to run on success").option("--copy <dir>", "Copy files to output dir").option("--public-dir <dir>", "Alias for --copy, deprecated").option("--tsconfig <tsconfig>", "Set tsconfig path").option("--unbundle", "Unbundle mode").option("--root <dir>", "Root directory of input files").option("--exe", "Bundle as executable").option("-W, --workspace [dir]", "Enable workspace mode").option("-F, --filter <pattern>", "Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name").option("--exports", "Generate export-related metadata for package.json (experimental)").action(async (input, flags) => {
+}).option("-c, --config <filename>", "Use a custom config file").option("--config-loader <loader>", "Config loader to use: auto, native, tsx, unrun", { default: "auto" }).option("--no-config", "Disable config file").option("-f, --format <format>", "Bundle format: esm, cjs, iife, umd", { default: "esm" }).option("--clean", "Clean output directory, --no-clean to disable").option("--deps.never-bundle <module>", "Mark dependencies as external").option("--minify", "Minify output").option("--devtools", "Enable devtools integration").option("--debug [feat]", "Show debug logs").option("--target <target>", "Bundle target, e.g \"es2015\", \"esnext\"").option("-l, --logLevel <level>", "Set log level: info, warn, error, silent").option("--fail-on-warn", "Fail on warnings", { default: true }).option("--no-write", "Disable writing files to disk, incompatible with watch mode").option("-d, --out-dir <dir>", "Output directory", { default: "dist" }).option("--treeshake", "Tree-shake bundle", { default: true }).option("--sourcemap", "Generate source map", { default: false }).option("--shims", "Enable cjs and esm shims ", { default: false }).option("--platform <platform>", "Target platform", { default: "node" }).option("--dts", "Generate dts files").option("--publint", "Enable publint", { default: false }).option("--attw", "Enable Are the types wrong integration", { default: false }).option("--unused", "Enable unused dependencies check", { default: false }).option("-w, --watch [path]", "Watch mode").option("--ignore-watch <path>", "Ignore custom paths in watch mode").option("--from-vite [vitest]", "Reuse config from Vite or Vitest").option("--report", "Size report", { default: true }).option("--env.* <value>", "Define compile-time env variables").option("--env-file <file>", "Load environment variables from a file, when used together with --env, variables in --env take precedence").option("--env-prefix <prefix>", "Prefix for env variables to inject into the bundle", { default: "TSDOWN_" }).option("--on-success <command>", "Command to run on success").option("--copy <dir>", "Copy files to output dir").option("--public-dir <dir>", "Alias for --copy, deprecated").option("--tsconfig <tsconfig>", "Set tsconfig path").option("--unbundle", "Unbundle mode").option("--root <dir>", "Root directory of input files").option("--exe", "Bundle as executable").option("-W, --workspace [dir]", "Enable workspace mode").option("-F, --filter <pattern>", "Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name").option("--exports", "Generate export-related metadata for package.json (experimental)").action(async (input, flags) => {
 	globalLogger.level = flags.logLevel || "info";
 	globalLogger.info(`${blue`tsdown v${version}`} powered by ${hex("#ff7e17")`rolldown v${VERSION}`}`);
-	const { build } = await import("./build-CgGnBlCD.mjs").then((n) => n.r);
+	const { build } = await import("./build-CLGhOCqV.mjs").then((n) => n.r);
 	if (input.length > 0) flags.entry = input;
 	await build(flags);
 });
@@ -54,7 +51,6 @@ async function runCLI() {
 }
 //#endregion
 //#region src/run.ts
-if (!process.versions.bun && lt(process.version, "22.18.0")) console.warn(yellow`[tsdown] Node.js ${process.version} is deprecated. Support will be removed in the next minor release. Please upgrade to Node.js v22.18.0 or later.`);
 try {
 	module.enableCompileCache?.();
 } catch {}

package/dist/{types-BZNNnDKc.d.mts → types-CQaSBA5U.d.mts}

@@ -1,8 +1,7 @@
-import { a as Arrayable, c as Overwrite, n as LogLevel, o as Awaitable, r as Logger, s as MarkPartial, t as PackageJson } from "./index-DraNj4FA.mjs";
+import { a as Arrayable, c as Overwrite, n as LogLevel, o as Awaitable, r as Logger, s as MarkPartial, t as PackageJson } from "./index-CTZ4qxd_.mjs";
 import { BuildOptions, ChecksOptions, ExternalOption, InputOptions, InternalModuleFormat, MinifyOptions, ModuleFormat, ModuleTypes, OutputAsset, OutputChunk, OutputOptions, Plugin, RolldownPlugin, TreeshakingOptions } from "rolldown";
 import { Hookable } from "hookable";
 import { Buffer } from "node:buffer";
-import * as _$_tsdown_css0 from "@tsdown/css";
 import { StartOptions } from "@vitejs/devtools/cli-commands";
 import { ExeExtensionOptions } from "@tsdown/exe";
 import * as _$_arethetypeswrong_core0 from "@arethetypeswrong/core";
@@ -10,6 +9,7 @@ import { CheckPackageOptions } from "@arethetypeswrong/core";
 import * as _$publint from "publint";
 import { Options } from "publint";
 import * as _$publint_utils0 from "publint/utils";
+import { CssOptions } from "@tsdown/css";
 import { Options as Options$1 } from "rolldown-plugin-dts";
 import { Options as UnusedOptions } from "unplugin-unused";
 
@@ -59,7 +59,8 @@ type NoExternalFn = (id: string, importer: string | undefined) => boolean | null
 interface DepsConfig {
   /**
   * Mark dependencies as external (not bundled).
-  * Accepts strings, regular expressions, or Rolldown's `ExternalOption`.
+  * Accepts strings, regular expressions, or Rolldown's
+  * {@linkcode ExternalOption}.
   */
   neverBundle?: ExternalOption;
   /**
@@ -77,13 +78,13 @@ interface DepsConfig {
   */
   onlyBundle?: Arrayable<string | RegExp> | false;
   /**
-  * @deprecated Use {@link onlyBundle} instead.
+  * @deprecated Use {@linkcode onlyBundle} instead.
   */
   onlyAllowBundle?: Arrayable<string | RegExp> | false;
   /**
   * Skip bundling all `node_modules` dependencies.
   *
-  * **Note:** This option cannot be used together with `alwaysBundle`.
+  * **Note:** This option cannot be used together with {@linkcode alwaysBundle}.
   *
   * @default false
   */
@@ -143,18 +144,31 @@ interface ExeOptions extends ExeExtensionOptions {
 */
 interface SeaConfig {
   main?: string;
-  /** Optional, if not specified, uses the current Node.js binary */
+  /**
+  * Optional, if not specified, uses the current Node.js binary
+  */
   executable?: string;
   output?: string;
+  /**
+  * @default tsdownConfig.format === 'es' ? 'module' : 'commonjs'
+  */
   mainFormat?: "commonjs" | "module";
-  /** @default true */
+  /**
+  * @default true
+  */
   disableExperimentalSEAWarning?: boolean;
-  /** @default false */
+  /**
+  * @default false
+  */
   useSnapshot?: boolean;
-  /** @default false */
+  /**
+  * @default false
+  */
   useCodeCache?: boolean;
   execArgv?: string[];
-  /** @default "env" */
+  /**
+  * @default 'env'
+  */
   execArgvExtension?: "none" | "env" | "cli";
   assets?: Record<string, string>;
 }
@@ -201,7 +215,9 @@ type PackageType = "module" | "commonjs" | undefined;
 interface OutExtensionContext {
   options: InputOptions;
   format: NormalizedFormat;
-  /** "type" field in project's package.json */
+  /**
+  * `"type"` field in project's `package.json`.
+  */
   pkgType?: PackageType;
 }
 interface OutExtensionObject {
@@ -266,6 +282,10 @@ interface AttwOptions extends CheckPackageOptions {
   * ```ts
   * ignoreRules: ['no-resolution', 'false-cjs']
   * ```
+  *
+  * @default []
+  *
+  * @uniqueItems
   */
   ignoreRules?: ("no-resolution" | "untyped-resolution" | "false-cjs" | "false-esm" | "cjs-resolves-to-esm" | "fallback-condition" | "cjs-only-exports-default" | "named-exports" | "false-export-default" | "missing-export-equals" | "unexpected-module-syntax" | "internal-resolution-error" | (string & {}))[];
 }
@@ -274,17 +294,42 @@ interface AttwOptions extends CheckPackageOptions {
 interface ExportsOptions {
   /**
   * Generate exports that link to source code during development.
-  * - string: add as a custom condition.
-  * - true: all conditions point to source files, and add dist exports to `publishConfig`.
+  * - `string`: add as a custom condition.
+  * - `true`: all conditions point to source files, and add `dist` exports to `publishConfig`.
   */
   devExports?: boolean | string;
   /**
-  * Exports for package.json file.
+  * Generate `exports` for `package.json` file.
+  *
+  * @example
+  * ```json
+  * {
+  *   "exports": {
+  *      ".": {
+  *         "types": "./dist/index.d.mts",
+  *         "import": "./dist/index.mjs"
+  *      },
+  *     "./package.json": "./package.json"
+  *   }
+  * }
+  * ```
+  *
   * @default true
   */
   packageJson?: boolean;
   /**
-  * Exports for all files.
+  * Generate `exports` for all files.
+  *
+  * @example
+  * ```json
+  * {
+  *   "exports": {
+  *    "./*": "./*"
+  *   }
+  * }
+  * ```
+  *
+  * @default false
   */
   all?: boolean;
   /**
@@ -294,7 +339,9 @@ interface ExportsOptions {
   * **Note:** Do not include file extensions, and paths should be relative to the dist directory.
   *
   * @example
+  * ```ts
   * exclude: ['cli', '**\/*.test', /internal/]
+  * ```
   */
   exclude?: (RegExp | string)[];
   /**
@@ -311,10 +358,12 @@ interface ExportsOptions {
   * Use this to add additional exports in the exported package, such as workers or assets.
   *
   * @example
+  * ```ts
   * customExports(exports) {
   *   exports['./worker.js'] = './dist/worker.js';
   *   return exports;
   * }
+  * ```
   *
   * @example
   * ```jsonc
@@ -334,7 +383,7 @@ interface ExportsOptions {
     isPublish: boolean;
   }) => Awaitable<Record<string, any>>);
   /**
-  * Generate `inlinedDependencies` field in package.json.
+  * Generate `inlinedDependencies` field in `package.json`.
   * Lists dependencies that are physically inlined into the bundle with their exact versions.
   *
   * @default true
@@ -354,19 +403,62 @@ interface ExportsOptions {
   */
   extensions?: boolean;
   /**
-  * Auto-generate the `bin` field in package.json.
+  * Generate the `bin` field in `package.json` for CLI executables.
   *
-  * - `true`: Auto-detect entry chunks with shebangs. Uses package name (without scope) as bin name.
-  *   Errors if multiple shebang entries are found.
-  * - `string`: Source file path to use as the bin entry. Bin name defaults to package name (without scope).
-  * - `Record<string, string>`: Map of bin command names to source file paths.
+  * Behavior depends on the value:
+  *
+  * - *Unset* (default): Soft auto-detect. Scans entry chunks for shebangs
+  *   (e.g. `#!/usr/bin/env node`). If exactly one is found, it is used as
+  *   the bin entry. If multiple are found, a warning is shown and no `bin`
+  *   field is written. If none are found, nothing happens silently.
+  * - `true`: Strict auto-detect. Same as the default, but throws if
+  *   multiple shebang entries are found, and warns if none are found.
+  *   Use this when your package is known to ship a CLI and you want to
+  *   fail fast on misconfiguration.
+  * - `false`: Disable bin generation entirely, even if shebangs are
+  *   present.
+  * - `string`: Use the given source file path (relative to `cwd`) as the
+  *   CLI entry. The command name is derived from the package name without
+  *   its scope. Warns if the source file does not contain a shebang.
+  * - `Record<string, string>`: Explicitly map command names to source file
+  *   paths (relative to `cwd`). Warns for each source file that does not
+  *   contain a shebang.
+  *
+  * When {@link ExportsOptions.devExports} is enabled, the `bin` field in
+  * `package.json` points to source files during local development, while
+  * `publishConfig.bin` points to built output paths for publishing.
   *
   * @example
-  * bin: true
+  * <caption>Auto-detect a CLI entry from a shebang</caption>
+  *
+  * ```ts
+  * {
+  *   bin: true
+  * }
+  * ```
+  *
   * @example
-  * bin: './src/cli.ts'
+  * <caption>Single CLI command with an explicit source entry</caption>
+  *
+  * ```ts
+  * {
+  *   bin: './src/cli.ts'
+  * }
+  * ```
+  *
   * @example
-  * bin: { tool: './src/cli-tool.ts' }
+  * <caption>Multiple named CLI commands</caption>
+  *
+  * ```ts
+  * {
+  *   bin: {
+  *     tool: './src/cli.ts',
+  *     serve: './src/cli-extra.ts',
+  *   },
+  * }
+  * ```
+  *
+  * @see {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | npm documentation for the `bin` field}
   */
   bin?: boolean | string | Record<string, string>;
 }
@@ -378,8 +470,8 @@ interface PublintOptions extends Omit<Options, "pack" | "pkgDir"> {
 //#endregion
 //#region src/features/plugin.d.ts
 /**
-* A tsdown-aware plugin. Extends Rolldown's `Plugin` with tsdown-specific
-* lifecycle hooks.
+* A tsdown-aware plugin. Extends Rolldown's {@linkcode Plugin} with
+* tsdown-specific lifecycle hooks.
 *
 * Plugins that only use Rolldown's own lifecycle continue to work unchanged;
 * tsdown detects these optional methods via runtime duck-typing.
@@ -389,18 +481,19 @@ interface TsdownPlugin<A = any> extends Plugin<A> {
   * Modify tsdown's user config before it is resolved. Analogous to Vite's
   * [`config`](https://vite.dev/guide/api-plugin.html#config) hook.
   *
-  * The hook may mutate `config` in place, or return a partial {@link UserConfig}
-  * that will be deep-merged into the current config. Array fields are
-  * replaced (not concatenated) during merging — to append plugins, mutate
-  * `config.plugins` in place.
+  * The hook may mutate {@linkcode config} in place, or return a partial
+  * {@linkcode UserConfig} that will be deep-merged into the current config.
+  * Array fields are replaced (not concatenated) during merging — to append
+  * plugins, mutate {@linkcode UserConfig.plugins | config.plugins} in place.
   *
-  * The second argument is the original {@link InlineConfig} passed to
-  * `build()` (typically the CLI flags), useful for distinguishing values
-  * that came from the command line vs. the config file.
+  * The second argument is the original {@linkcode InlineConfig} passed to
+  * {@linkcode build | build()} (typically the CLI flags), useful for
+  * distinguishing values that came from the command line vs. the config file.
   *
-  * Plugins injected via `fromVite` do not receive this hook, because they
-  * are loaded after the tsdownConfig phase. Likewise, new plugins added by
-  * another plugin's `tsdownConfig` do not themselves receive this hook
+  * Plugins injected via {@linkcode UserConfig.fromVite | fromVite} do not
+  * receive this hook, because they are loaded after the
+  * {@linkcode tsdownConfig} phase. Likewise, new plugins added by another
+  * plugin's {@linkcode tsdownConfig} do not themselves receive this hook
   * (plugins are snapshotted before dispatch).
   */
   tsdownConfig?: (config: UserConfig, inlineConfig: InlineConfig) => Awaitable<UserConfig | void | null>;
@@ -409,18 +502,20 @@ interface TsdownPlugin<A = any> extends Plugin<A> {
   * Vite's [`configResolved`](https://vite.dev/guide/api-plugin.html#configresolved)
   * hook.
   *
-  * This hook fires once per produced {@link ResolvedConfig} — i.e. once
-  * per output format when `format` is an array. Typical usage is to stash
-  * the resolved config for later use in Rolldown hooks. Mutations made to
-  * `resolvedConfig` here are not supported.
+  * This hook fires once per produced {@linkcode ResolvedConfig} — i.e. once
+  * per output format when {@linkcode UserConfig.format | format} is an array.
+  * Typical usage is to stash the resolved config for later use in
+  * Rolldown hooks. Mutations made to {@linkcode resolvedConfig} here are
+  * not supported.
   */
   tsdownConfigResolved?: (resolvedConfig: ResolvedConfig) => Awaitable<void>;
 }
 /**
 * A tsdown plugin slot — accepts tsdown plugins, any Rolldown plugin form,
-* `null`/`undefined`/`false`, promises, and nested arrays. Mirrors Rolldown's
-* {@link RolldownPluginOption} but with {@link TsdownPlugin} as the atom so
-* that tsdown-specific hooks are type-checked.
+* `null`/`undefined`/`false`, {@linkcode Promise | promises}, and
+* nested arrays. Mirrors Rolldown's {@linkcode RolldownPluginOption} but with
+* {@linkcode TsdownPlugin} as the atom so that tsdown-specific hooks are
+* type-checked.
 */
 type TsdownPluginOption<A = any> = Awaitable<TsdownPlugin<A> | RolldownPlugin<A> | {
   name: string;
@@ -444,7 +539,7 @@ interface ReportOptions {
   brotli?: boolean;
   /**
   * Skip reporting compressed size for files larger than this size.
-  * @default 1_000_000 // 1MB
+  * @default 1_000_000 // 1 MB
   */
   maxCompressSize?: number;
 }
@@ -495,10 +590,12 @@ interface Workspace {
   * - `auto`: Automatically detect `package.json` files in the workspace.
   * @default 'auto'
   */
-  include?: Arrayable<string> | "auto";
+  include?: "auto" | (string & {}) | string[];
   /**
   * Exclude directories from workspace.
   * Defaults to all `node_modules`, `dist`, `test`, `tests`, `temp`, and `tmp` directories.
+  *
+  * @default ['**\/node_modules/**', '**\/dist/**', '**\/test?(s)/**', '**\/t?(e)mp/**']
   */
   exclude?: Arrayable<string>;
   /**
@@ -508,7 +605,10 @@ interface Workspace {
 }
 type CIOption = "ci-only" | "local-only";
 type WithEnabled<T> = boolean | undefined | CIOption | (T & {
-  /** @default true */enabled?: boolean | CIOption;
+  /**
+  * @default true
+  */
+  enabled?: boolean | CIOption;
 });
 /**
 * Options for tsdown.
@@ -524,6 +624,8 @@ interface UserConfig {
   *   "hooks/*": ["./src/hooks/*.ts", "!./src/hooks/index.ts"],
   * }
   * ```
+  *
+  * @default { index: 'src/index.ts'}
   */
   entry?: TsdownInputOption;
   /**
@@ -531,23 +633,26 @@ interface UserConfig {
   */
   deps?: DepsConfig;
   /**
-  * @deprecated Use `deps.neverBundle` instead.
+  * @deprecated Use {@linkcode DepsConfig.neverBundle | deps.neverBundle} instead.
   */
   external?: ExternalOption;
   /**
-  * @deprecated Use `deps.alwaysBundle` instead.
+  * @deprecated Use {@linkcode DepsConfig.alwaysBundle | deps.alwaysBundle} instead.
   */
   noExternal?: Arrayable<string | RegExp> | NoExternalFn;
   /**
-  * @deprecated Use `deps.onlyBundle` instead.
+  * @deprecated Use {@linkcode DepsConfig.onlyBundle | deps.onlyBundle} instead.
   */
   inlineOnly?: Arrayable<string | RegExp> | false;
   /**
-  * @deprecated Use `deps.skipNodeModulesBundle` instead.
+  * @deprecated Use {@linkcode DepsConfig.skipNodeModulesBundle | deps.skipNodeModulesBundle} instead.
   * @default false
   */
   skipNodeModulesBundle?: boolean;
   alias?: Record<string, string>;
+  /**
+  * @default true
+  */
   tsconfig?: string | boolean;
   /**
   * Specifies the target runtime platform for the build.
@@ -600,6 +705,8 @@ interface UserConfig {
   *   "NODE_ENV": "production"
   * }
   * ```
+  *
+  * @default {}
   */
   env?: Record<string, any>;
   /**
@@ -614,7 +721,9 @@ interface UserConfig {
   */
   envPrefix?: string | string[];
   define?: Record<string, string>;
-  /** @default false */
+  /**
+  * @default false
+  */
   shims?: boolean;
   /**
   * Configure tree shaking options.
@@ -628,36 +737,70 @@ interface UserConfig {
   * Lets you import or require files like images or fonts.
   * @example
   * ```json
-  * { '.jpg': 'asset', '.png': 'base64' }
+  * { ".jpg": "asset", ".png": "base64" }
   * ```
   */
   loader?: ModuleTypes;
   /**
-  * If enabled, strips the `node:` protocol prefix from import source.
+  * Remove the `node:` prefix from built-in Node.js module imports.
+  * When enabled, rewrites import sources like `node:fs` to `fs`.
   *
   * @default false
-  * @deprecated Use `nodeProtocol: 'strip'` instead.
+  * @deprecated Use {@linkcode nodeProtocol | nodeProtocol: 'strip'} instead.
   *
   * @example
-  * // With removeNodeProtocol enabled:
-  * import('node:fs'); // becomes import('fs')
+  * <caption>`removeNodeProtocol: true` — remove the `node:` prefix</caption>
+  *
+  * ```ts
+  * // Input
+  * import 'node:fs'
+  *
+  * // Output
+  * import 'fs'
+  * ```
   */
   removeNodeProtocol?: boolean;
   /**
-  * - If `true`, add `node:` prefix to built-in modules.
-  * - If `'strip'`, strips the `node:` protocol prefix from import source.
-  * - If `false`, does not modify the import source.
+  * Control whether built-in Node.js module imports use the `node:` protocol.
+  *
+  * - `true`: Add the `node:` prefix to built-in module imports.
+  * - `'strip'`: Remove the `node:` prefix from built-in module imports.
+  * - `false`: Do not transform built-in module imports.
   *
   * @default false
   *
   * @example
-  * // With nodeProtocol enabled:
-  * import('fs'); // becomes import('node:fs')
-  * // With nodeProtocol set to 'strip':
-  * import('node:fs'); // becomes import('fs')
-  * // With nodeProtocol set to false:
-  * import('node:fs'); // remains import('node:fs')
+  * <caption>`nodeProtocol: true` — add the `node:` prefix</caption>
   *
+  * ```ts
+  * // Input
+  * import 'fs'
+  *
+  * // Output
+  * import 'node:fs'
+  * ```
+  *
+  * @example
+  * <caption>`nodeProtocol: 'strip'` — remove the `node:` prefix</caption>
+  *
+  * ```ts
+  * // Input
+  * import 'node:fs'
+  *
+  * // Output
+  * import 'fs'
+  * ```
+  *
+  * @example
+  * <caption>`nodeProtocol: false` — do not transform imports</caption>
+  *
+  * ```ts
+  * // Input
+  * import 'node:fs'
+  *
+  * // Output
+  * import 'node:fs'
+  * ```
   */
   nodeProtocol?: "strip" | boolean;
   /**
@@ -687,11 +830,13 @@ interface UserConfig {
   * - `iife`: IIFE
   * - `umd`: UMD
   *
-  * Defaults to ESM.
+  * @default 'esm'
   */
   format?: Format | Format[] | Partial<Record<Format, Partial<ResolvedConfig>>>;
   globalName?: string;
-  /** @default 'dist' */
+  /**
+  * @default 'dist'
+  */
   outDir?: string;
   /**
   * Whether to write the files to disk.
@@ -703,7 +848,7 @@ interface UserConfig {
   * Whether to generate source map files.
   *
   * Note that this option will always be `true` if you have
-  * [`declarationMap`](https://www.typescriptlang.org/tsconfig/#declarationMap)
+  * {@link https://www.typescriptlang.org/tsconfig/#declarationMap | `declarationMap`}
   * option enabled in your `tsconfig.json`.
   *
   * @default false
@@ -723,8 +868,8 @@ interface UserConfig {
   footer?: ChunkAddon;
   banner?: ChunkAddon;
   /**
-  * Determines whether unbundle mode is enabled.
-  * When set to true, the output files will mirror the input file structure.
+  * Determines whether `unbundle` is enabled.
+  * When set to `true`, the output files will mirror the input file structure.
   * @default false
   */
   unbundle?: boolean;
@@ -738,7 +883,7 @@ interface UserConfig {
   */
   root?: string;
   /**
-  * @deprecated Use `unbundle` instead.
+  * @deprecated Use {@linkcode unbundle} instead.
   * @default true
   */
   bundle?: boolean;
@@ -747,12 +892,15 @@ interface UserConfig {
   * The extension will always be `.cjs` or `.mjs`.
   * Otherwise, it will depend on the package type.
   *
-  * Defaults to `true` if `platform` is set to `node`, `false` otherwise.
+  * Defaults to `true` if {@linkcode platform} is set to `node`,
+  * `false` otherwise.
+  *
+  * @default platform === 'node'
   */
   fixedExtension?: boolean;
   /**
   * Custom extensions for output files.
-  * `fixedExtension` will be overridden by this option.
+  * {@linkcode fixedExtension} will be overridden by this option.
   */
   outExtensions?: OutExtensionFactory;
   /**
@@ -772,8 +920,10 @@ interface UserConfig {
   }) => Awaitable<OutputOptions | void | null>);
   /**
   * The working directory of the config file.
-  * - Defaults to `process.cwd()` for root config.
-  * - Defaults to the package directory for workspace config.
+  * - Defaults to {@linkcode process.cwd | process.cwd()} for root config.
+  * - Defaults to the package directory for {@linkcode workspace} config.
+  *
+  * @default process.cwd()
   */
   cwd?: string;
   /**
@@ -812,7 +962,7 @@ interface UserConfig {
   /**
   * **[experimental]** Enable devtools.
   *
-  *DevTools is still under development, and this is for early testers only.
+  * DevTools is still under development, and this is for early testers only.
   *
   * This may slow down the build process significantly.
   *
@@ -827,7 +977,7 @@ interface UserConfig {
   * Enables generation of TypeScript declaration files (`.d.ts`).
   *
   * By default, this option is auto-detected based on your project's `package.json`:
-  * - If {@link exe} is enabled, declaration file generation is disabled by default.
+  * - If {@linkcode exe} is enabled, declaration file generation is disabled by default.
   * - If the `types` field is present, or if the main `exports` contains a `types` entry, declaration file generation is enabled by default.
   * - Otherwise, declaration file generation is disabled by default.
   */
@@ -839,7 +989,7 @@ interface UserConfig {
   */
   unused?: WithEnabled<UnusedOptions>;
   /**
-  * Run publint after bundling.
+  * Run `publint` after bundling.
   * Requires `publint` to be installed.
   * @default false
   */
@@ -868,19 +1018,22 @@ interface UserConfig {
   *
   * This will set the `main`, `module`, `types`, `exports` fields in `package.json`
   * to point to the generated files.
+  *
+  * @default false
   */
   exports?: WithEnabled<ExportsOptions>;
   /**
   * **[experimental]** CSS options.
   * Requires `@tsdown/css` to be installed.
   */
-  css?: _$_tsdown_css0.CssOptions;
+  css?: CssOptions;
   /**
-  * @deprecated Use `css.inject` instead.
+  * @deprecated Use {@linkcode CssOptions.inject | css.inject} instead.
   */
   injectStyle?: boolean;
   /**
-  * @deprecated Alias for `copy`, will be removed in the future.
+  * @alias copy
+  * @deprecated Alias for {@linkcode copy}, will be removed in the future.
   */
   publicDir?: CopyOptions | CopyOptionsFn;
   /**
@@ -903,6 +1056,8 @@ interface UserConfig {
   *
   * This will bundle the output into a single executable file using Node.js SEA.
   * Note that this is only supported on Node.js 25.7.0 and later, and is not supported in Bun or Deno.
+  *
+  * @default false
   */
   exe?: WithEnabled<ExeOptions>;
   /**
@@ -920,7 +1075,7 @@ interface InlineConfig extends UserConfig {
   * Config loader to use. It can only be set via CLI or API.
   * @default 'auto'
   */
-  configLoader?: "auto" | "native" | "unrun";
+  configLoader?: "auto" | "native" | "tsx" | "unrun";
   /**
   * Filter configs by cwd or name.
   */
@@ -932,7 +1087,13 @@ type UserConfigFn = (inlineConfig: InlineConfig, context: {
 }) => Awaitable<Arrayable<UserConfig>>;
 type UserConfigExport = Awaitable<Arrayable<UserConfig> | UserConfigFn>;
 type ResolvedConfig = Overwrite<MarkPartial<Omit<UserConfig, "workspace" | "fromVite" | "publicDir" | "bundle" | "injectStyle" | "removeNodeProtocol" | "external" | "noExternal" | "inlineOnly" | "skipNodeModulesBundle" | "logLevel" | "failOnWarn" | "customLogger" | "envFile" | "envPrefix">, "globalName" | "inputOptions" | "outputOptions" | "minify" | "define" | "alias" | "onSuccess" | "outExtensions" | "hooks" | "copy" | "loader" | "name" | "banner" | "footer" | "checks" | "css">, {
-  /** Resolved entry map (after glob expansion) */entry: Record<string, string>; /** Original entry config before glob resolution (for watch mode re-globbing) */
+  /**
+  * Resolved entry map (after glob expansion)
+  */
+  entry: Record<string, string>;
+  /**
+  * Original entry config before glob resolution (for watch mode re-globbing)
+  */
   rawEntry?: TsdownInputOption;
   nameLabel: string | undefined;
   format: NormalizedFormat;
@@ -942,7 +1103,10 @@ type ResolvedConfig = Overwrite<MarkPartial<Omit<UserConfig, "workspace" | "from
   nodeProtocol: "strip" | boolean;
   logger: Logger;
   ignoreWatch: Array<string | RegExp>;
-  deps: ResolvedDepsConfig; /** Resolved root directory of input files */
+  deps: ResolvedDepsConfig;
+  /**
+  * Resolved root directory of input files
+  */
   root: string;
   configDeps: Set<string>;
   dts: false | DtsOptions;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tsdown",
   "type": "module",
-  "version": "0.21.10",
+  "version": "0.22.0-beta.2",
   "description": "The Elegant Bundler for Libraries",
   "author": "Kevin Deng <sxzz@sxzz.moe>",
   "license": "MIT",
@@ -44,16 +44,18 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=22.18.0"
   },
   "peerDependencies": {
     "@arethetypeswrong/core": "^0.18.1",
     "@vitejs/devtools": "*",
-    "publint": "^0.3.0",
+    "publint": "^0.3.8",
+    "tsx": "*",
     "typescript": "^5.0.0 || ^6.0.0",
     "unplugin-unused": "^0.5.0",
-    "@tsdown/css": "0.21.10",
-    "@tsdown/exe": "0.21.10"
+    "unrun": "*",
+    "@tsdown/css": "0.22.0-beta.2",
+    "@tsdown/exe": "0.22.0-beta.2"
   },
   "peerDependenciesMeta": {
     "@arethetypeswrong/core": {
@@ -71,11 +73,17 @@
     "publint": {
       "optional": true
     },
+    "tsx": {
+      "optional": true
+    },
     "typescript": {
       "optional": true
     },
     "unplugin-unused": {
       "optional": true
+    },
+    "unrun": {
+      "optional": true
     }
   },
   "dependencies": {
@@ -87,60 +95,61 @@
     "import-without-cache": "^0.3.3",
     "obug": "^2.1.1",
     "picomatch": "^4.0.4",
-    "rolldown": "1.0.0-rc.17",
-    "rolldown-plugin-dts": "^0.23.2",
+    "rolldown": "1.0.0-rc.18",
+    "rolldown-plugin-dts": "^0.24.0-beta.1",
     "semver": "^7.7.4",
-    "tinyexec": "^1.1.1",
+    "tinyexec": "^1.1.2",
     "tinyglobby": "^0.2.16",
     "tree-kill": "^1.2.2",
-    "unconfig-core": "^7.5.0",
-    "unrun": "^0.2.37"
+    "unconfig-core": "^7.5.0"
   },
   "inlinedDependencies": {
     "is-in-ci": "2.0.0",
     "package-manager-detector": "1.6.0",
-    "pkg-types": "2.3.0"
+    "pkg-types": "2.3.1"
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.2",
-    "@sxzz/eslint-config": "^7.8.4",
+    "@sxzz/eslint-config": "^8.0.0",
     "@sxzz/prettier-config": "^2.3.1",
-    "@sxzz/test-utils": "^0.5.16",
+    "@sxzz/test-utils": "^0.5.18",
     "@types/node": "^25.6.0",
     "@types/picomatch": "^4.0.3",
     "@types/semver": "^7.7.1",
-    "@typescript/native-preview": "7.0.0-dev.20260422.1",
+    "@typescript/native-preview": "7.0.0-dev.20260429.1",
     "@unocss/eslint-plugin": "^66.6.8",
     "@vitejs/devtools": "^0.1.15",
     "@vitest/coverage-v8": "^4.1.5",
     "@vitest/ui": "^4.1.5",
     "@vueuse/core": "^14.2.1",
-    "baseline-browser-mapping": "^2.10.20",
+    "baseline-browser-mapping": "^2.10.24",
     "bumpp": "^11.0.1",
     "dedent": "^1.7.2",
     "eslint": "^10.2.1",
     "is-in-ci": "^2.0.0",
     "memfs": "^4.57.2",
     "package-manager-detector": "^1.6.0",
-    "pkg-types": "^2.3.0",
-    "postcss": "^8.5.10",
+    "pkg-types": "^2.3.1",
+    "postcss": "^8.5.12",
     "postcss-import": "^16.1.1",
     "prettier": "^3.8.3",
     "publint": "^0.3.18",
     "rolldown-plugin-require-cjs": "^0.4.0",
     "sass": "^1.99.0",
     "tsnapi": "^0.3.2",
+    "tsx": "^4.21.0",
     "typescript": "~6.0.3",
     "unocss": "^66.6.8",
     "unplugin-ast": "^0.16.0",
     "unplugin-raw": "^0.7.0",
     "unplugin-unused": "^0.5.7",
-    "unplugin-vue": "^7.1.1",
-    "vite": "^8.0.9",
+    "unplugin-vue": "^7.2.0",
+    "unrun": "^0.2.37",
+    "vite": "^8.0.10",
     "vitest": "^4.1.5",
     "vue": "^3.5.33",
-    "@tsdown/css": "0.21.10",
-    "@tsdown/exe": "0.21.10"
+    "@tsdown/css": "0.22.0-beta.2",
+    "@tsdown/exe": "0.22.0-beta.2"
   },
   "prettier": "@sxzz/prettier-config",
   "scripts": {

package/dist/{watch-D6EGzM6P.mjs → watch-B659_4oi.mjs}

@@ -7,8 +7,8 @@ import { chmod } from "node:fs/promises";
 import path from "node:path";
 import { bold, dim, green, underline } from "ansis";
 import { createDebug } from "obug";
-import { glob, isDynamicPattern } from "tinyglobby";
 import { RE_DTS } from "rolldown-plugin-dts/internal";
+import { glob, isDynamicPattern } from "tinyglobby";
 import { promisify } from "node:util";
 import { Buffer } from "node:buffer";
 import { brotliCompress, gzip } from "node:zlib";