tsdown 0.9.0 → 0.9.2

package/LICENSE

@@ -1,6 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2024-present VoidZero Inc. & Contributors
+Copyright (c) 2025-present VoidZero Inc. & Contributors
+Copyright (c) 2024 三咲智子 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

package/README.md

@@ -1,32 +1,24 @@
-<img src="./assets/header-illustration.svg" alt="tsdown" width="100%" /><br>
+<img src="./docs/public/og-image.svg" alt="tsdown" width="100%" /><br>
 
 # tsdown [![npm](https://img.shields.io/npm/v/tsdown.svg)](https://npmjs.com/package/tsdown) [![Unit Test](https://github.com/rolldown/tsdown/actions/workflows/tests.yml/badge.svg)](https://github.com/rolldown/tsdown/actions/workflows/tests.yml) [![JSR](https://jsr.io/badges/@sxzz/tsdown)](https://jsr.io/@sxzz/tsdown)
 
-⚡️ Smooth and fast library bundler powered by Rolldown [Rolldown](https://github.com/rolldown/rolldown).
+✨ The elegant bundler for libraries powered by [Rolldown](https://github.com/rolldown/rolldown).
 
 ## Features
 
-- 🚀 **Blazing fast**: Build and generate `.d.ts` powered by Oxc and Rolldown, incredibly fast!
-- ♻️ **Powerful ecosystem**: Support Rollup / Rolldown / unplugin plugins, and some Vite plugins.
-- 📦 **Out-of-box**: Support reusing configurations from Vite or Vitest.
+- 🚀 **Blazing fast**: Build and generate declaration files powered by Oxc and Rolldown, incredibly fast!
+- ♻️ **Powerful ecosystem**: Support Rollup, Rolldown, unplugin plugins, and some Vite plugins.
+- ️🛠️ **Easy to use**: tsdown preconfigures everything you need to get started, so you can focus on writing code.
 - 🔄 **Seamless migration**: Compatible with tsup's main options and features, ensuring a smooth transition.
 
-## Install
-
-```bash
-npm i tsdown
-```
+## Documentation
 
-## Configuration
+For full documentation, visit [tsdown.dev](https://tsdown.dev).
 
-```ts
-// tsdown.config.ts
-import { defineConfig } from 'tsdown'
+## Install
 
-export default defineConfig({
-  entry: ['./src'],
-  // ...
-})
+```bash
+npm i -D tsdown
 ```
 
 ## Usage
@@ -41,11 +33,11 @@ npx tsdown
 npx tsdown migrate
 ```
 
-Please make sure to commit your changes before migrating.
+Please make sure to commit your changes before migrating. For more details, see the [Migration Guide](https://tsdown.dev/guide/migrate-from-tsup).
 
 ## Credits
 
-This project also partially contains code derived or copied from [tsup](https://github.com/egoist/tsup).
+This project also partially contains code derived or copied from the following projects:
 
 - [tsup](https://github.com/egoist/tsup)
 - [pkgroll](https://github.com/privatenumber/pkgroll)

package/dist/{config-0LDjKwZ7.js → config-yiJy1jd0.js}

@@ -1,5 +1,7 @@
-
 //#region src/config.ts
+/**
+* Defines the configuration for tsdown.
+*/
 function defineConfig(options) {
 	return options;
 }

package/dist/{config.d-CIuApN_q.d.ts → config.d-BrQCtlF9.d.ts}

@@ -1,9 +1,12 @@
-import { UserConfig } from "./options.d-BUmkLb5_.js";
+import { UserConfig } from "./options.d-DxODs1UG.js";
 
 //#region src/config.d.ts
 /**
 * Defines the configuration for tsdown.
 */
+/**
+* Defines the configuration for tsdown.
+*/
 declare function defineConfig(options: UserConfig): UserConfig;
 
 //#endregion

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import "./options.d-BUmkLb5_.js";
-import { defineConfig$1 as defineConfig } from "./config.d-CIuApN_q.js";
+import "./options.d-DxODs1UG.js";
+import { defineConfig$1 as defineConfig } from "./config.d-BrQCtlF9.js";
 
 export { defineConfig };

package/dist/config.js

@@ -1,3 +1,3 @@
-import { defineConfig } from "./config-0LDjKwZ7.js";
+import { defineConfig } from "./config-yiJy1jd0.js";
 
 export { defineConfig };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Options, ResolvedOptions, UserConfig } from "./options.d-BUmkLb5_.js";
-import { defineConfig$1 as defineConfig } from "./config.d-CIuApN_q.js";
+import { Options, ResolvedOptions, UserConfig } from "./options.d-DxODs1UG.js";
+import { defineConfig$1 as defineConfig } from "./config.d-BrQCtlF9.js";
 import Debug from "debug";
 import { ConsolaInstance } from "consola";
 
@@ -7,6 +7,9 @@ import { ConsolaInstance } from "consola";
 /**
 * Logger instance
 */
+/**
+* Logger instance
+*/
 declare const logger: ConsolaInstance;
 
 //#endregion
@@ -14,6 +17,9 @@ declare const logger: ConsolaInstance;
 /**
 * Build with tsdown.
 */
+/**
+* Build with tsdown.
+*/
 declare function build(userOptions?: Options): Promise<void>;
 declare const pkgRoot: string;
 /**
@@ -21,6 +27,11 @@ declare const pkgRoot: string;
 *
 * @param config Resolved options
 */
+/**
+* Build a single configuration, without watch and shortcuts features.
+*
+* @param config Resolved options
+*/
 declare function buildSingle(config: ResolvedOptions): Promise<(() => Promise<void>) | undefined>;
 
 //#endregion

package/dist/index.js

@@ -1,13 +1,13 @@
-import { defineConfig } from "./config-0LDjKwZ7.js";
-import { debug, logger, setSilent } from "./logger-4bmpqibt.js";
-import { ExternalPlugin, debounce, toArray } from "./external-DvQ4QDcG.js";
-import path, { dirname, normalize, sep } from "node:path";
+import { defineConfig } from "./config-yiJy1jd0.js";
+import { ExternalPlugin, ShebangPlugin, debounce, fsExists, fsRemove, lowestCommonAncestor, toArray } from "./plugins-CATHxFm7.js";
+import { debug, logger, setSilent } from "./logger-Dt3D6T-U.js";
+import path from "node:path";
 import process from "node:process";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { build as build$1 } from "rolldown";
 import { transformPlugin } from "rolldown/experimental";
 import { exec } from "tinyexec";
-import { access, readFile, readdir, rm, stat } from "node:fs/promises";
+import { readFile, readdir, stat } from "node:fs/promises";
 import Debug from "debug";
 import { glob } from "tinyglobby";
 import { findUp } from "find-up-simple";
@@ -15,36 +15,6 @@ import readline from "node:readline";
 import { blue, bold, dim, underline } from "ansis";
 import { loadConfig } from "unconfig";
 
-//#region src/utils/fs.ts
-function fsExists(path$1) {
-	return access(path$1).then(() => true, () => false);
-}
-function fsRemove(path$1) {
-	return rm(path$1, {
-		force: true,
-		recursive: true
-	}).catch(() => {});
-}
-function lowestCommonAncestor(...filepaths) {
-	if (filepaths.length === 0) return "";
-	if (filepaths.length === 1) return dirname(filepaths[0]);
-	filepaths = filepaths.map(normalize);
-	const [first, ...rest] = filepaths;
-	let ancestor = first.split(sep);
-	for (const filepath of rest) {
-		const directories = filepath.split(sep, ancestor.length);
-		let index = 0;
-		for (const directory of directories) if (directory === ancestor[index]) index += 1;
-		else {
-			ancestor = ancestor.slice(0, index);
-			break;
-		}
-		ancestor = ancestor.slice(0, index);
-	}
-	return ancestor.length <= 1 && ancestor[0] === "" ? sep + ancestor[0] : ancestor.join(sep);
-}
-
-//#endregion
 //#region src/features/clean.ts
 const debug$2 = Debug("tsdown:clean");
 async function cleanOutDir(cwd, patterns) {
@@ -75,7 +45,6 @@ function getPackageType(pkg) {
 		if (!["module", "commonjs"].includes(pkg.type)) throw new Error(`Invalid package.json type: ${pkg.type}`);
 		return pkg.type;
 	}
-	return "commonjs";
 }
 function normalizeFormat(format) {
 	return toArray(format, "es").map((format$1) => {
@@ -92,7 +61,7 @@ function normalizeFormat(format) {
 
 //#endregion
 //#region src/features/output.ts
-function resolveOutputExtension(packageType, format, fixedExtension) {
+function resolveJsOutputExtension(packageType, format, fixedExtension) {
 	switch (format) {
 		case "es": return !fixedExtension && packageType === "module" ? "js" : "mjs";
 		case "cjs": return fixedExtension || packageType === "module" ? "cjs" : "js";
@@ -112,7 +81,7 @@ function resolveChunkFilename(pkg, inputOptions, format, { outExtensions, fixedE
 		jsExtension = js;
 		dtsExtension = dts;
 	}
-	jsExtension ||= `.${resolveOutputExtension(packageType, format, fixedExtension)}`;
+	jsExtension ||= `.${resolveJsOutputExtension(packageType, format, fixedExtension)}`;
 	return [createChunkFilename("[name]", jsExtension, dtsExtension), createChunkFilename(`[name]-[hash]`, jsExtension, dtsExtension)];
 }
 function createChunkFilename(basename, jsExtension, dtsExtension) {
@@ -244,18 +213,18 @@ async function watchBuild(options, configFile, rebuild, restart) {
 
 //#endregion
 //#region src/features/entry.ts
-async function resolveEntry(entry) {
+async function resolveEntry(entry, cwd) {
 	if (!entry || Object.keys(entry).length === 0) throw new Error(`No input files, try "tsdown <your-file>" instead`);
-	const objectEntry = await toObjectEntry(entry);
+	const objectEntry = await toObjectEntry(entry, cwd);
 	const entries = Object.values(objectEntry);
 	if (entries.length === 0) throw new Error(`Cannot find entry: ${JSON.stringify(entry)}`);
 	logger.info(`entry: ${blue(entries.join(", "))}`);
 	return objectEntry;
 }
-async function toObjectEntry(entry) {
+async function toObjectEntry(entry, cwd) {
 	if (typeof entry === "string") entry = [entry];
 	if (!Array.isArray(entry)) return entry;
-	const resolvedEntry = await glob(entry);
+	const resolvedEntry = await glob(entry, { cwd });
 	const base = lowestCommonAncestor(...resolvedEntry);
 	return Object.fromEntries(resolvedEntry.map((file) => {
 		const relative = path.relative(base, file);
@@ -280,7 +249,7 @@ async function resolveOptions(options) {
 			...options
 		};
 		let { entry, format = ["es"], plugins = [], clean = false, silent = false, treeshake = true, platform = "node", outDir = "dist", sourcemap = false, dts = false, unused = false, watch = false, shims = false, skipNodeModulesBundle = false, publint: publint$1 = false, fromVite, alias, tsconfig } = subOptions;
-		entry = await resolveEntry(entry);
+		entry = await resolveEntry(entry, cwd);
 		if (clean === true) clean = [];
 		if (publint$1 === true) publint$1 = {};
 		if (tsconfig !== false) {
@@ -299,7 +268,7 @@ async function resolveOptions(options) {
 					if (!tsconfig) logger.warn(`No \`${tsconfig}\` found in \`${cwd}\``);
 				}
 			}
-			if (tsconfig) logger.info(`Using tsconfig: ${underline(tsconfig)}`);
+			if (tsconfig) logger.info(`Using tsconfig: ${underline(path.relative(cwd, tsconfig))}`);
 		}
 		if (fromVite) {
 			const viteUserConfig = await loadViteConfig(fromVite === true ? "vite" : fromVite, cwd);
@@ -328,7 +297,8 @@ async function resolveOptions(options) {
 			skipNodeModulesBundle,
 			publint: publint$1,
 			alias,
-			tsconfig
+			tsconfig,
+			cwd
 		};
 		return config;
 	}));
@@ -432,6 +402,9 @@ async function mergeUserOptions(defaults, user, args) {
 
 //#endregion
 //#region src/index.ts
+/**
+* Build with tsdown.
+*/
 async function build(userOptions = {}) {
 	if (typeof userOptions.silent === "boolean") setSilent(userOptions.silent);
 	debug("Loading config");
@@ -454,6 +427,11 @@ async function build(userOptions = {}) {
 }
 const dirname$1 = path.dirname(fileURLToPath(import.meta.url));
 const pkgRoot = path.resolve(dirname$1, "..");
+/**
+* Build a single configuration, without watch and shortcuts features.
+*
+* @param config Resolved options
+*/
 async function buildSingle(config) {
 	const { outDir, format: formats, clean, dts, watch, onSuccess } = config;
 	let onSuccessCleanup;
@@ -495,13 +473,9 @@ async function buildSingle(config) {
 	}
 }
 async function getBuildOptions(config, pkg, format, cjsDts) {
-	const { entry, external, plugins: userPlugins, outDir, platform, alias, treeshake, sourcemap, dts, minify, unused, target, define, shims, tsconfig } = config;
+	const { entry, external, plugins: userPlugins, outDir, platform, alias, treeshake, sourcemap, dts, minify, unused, target, define, shims, tsconfig, cwd } = config;
 	const plugins = [];
 	if (pkg || config.skipNodeModulesBundle) plugins.push(ExternalPlugin(config, pkg));
-	if (unused && !cjsDts) {
-		const { Unused } = await import("unplugin-unused");
-		plugins.push(Unused.rolldown(unused === true ? {} : unused));
-	}
 	if (dts) {
 		const { dts: dtsPlugin } = await import("rolldown-plugin-dts");
 		const options = {
@@ -514,13 +488,22 @@ async function getBuildOptions(config, pkg, format, cjsDts) {
 			emitDtsOnly: true
 		}));
 	}
-	if (target && !cjsDts) plugins.push(transformPlugin({
-		target: target && (typeof target === "string" ? target : target.join(",")),
-		exclude: /\.d\.[cm]?ts$/
-	}));
+	if (!cjsDts) {
+		if (unused) {
+			const { Unused } = await import("unplugin-unused");
+			plugins.push(Unused.rolldown(unused === true ? {} : unused));
+		}
+		if (target) plugins.push(transformPlugin({
+			include: /\.[cm]?[jt]sx?$/,
+			exclude: /\.d\.[cm]?ts$/,
+			transformOptions: { target }
+		}));
+		plugins.push(ShebangPlugin(cwd));
+	}
 	plugins.push(userPlugins);
 	const inputOptions = await mergeUserOptions({
 		input: entry,
+		cwd,
 		external,
 		resolve: {
 			alias,

package/dist/{logger-4bmpqibt.js → logger-Dt3D6T-U.js}

@@ -1,9 +1,12 @@
 import process from "node:process";
 import Debug from "debug";
-import { consola as consola$1 } from "consola";
+import { consola } from "consola";
 
 //#region src/utils/logger.ts
-const logger = consola$1.withTag("tsdown");
+/**
+* Logger instance
+*/
+const logger = consola.withTag("tsdown");
 const debug = Debug("tsdown");
 function setSilent(silent) {
 	if (!("CONSOLA_LEVEL" in process.env)) logger.level = silent ? 0 : 3;

package/dist/{migrate-D8koNtWX.js → migrate-M59yd0BY.js}

@@ -1,16 +1,16 @@
-import { version } from "./package-BnNFONow.js";
+import { version } from "./package-DTByKj86.js";
 import process from "node:process";
 import { readFile, unlink, writeFile } from "node:fs/promises";
-import consola from "consola";
+import consola$1 from "consola";
 import { existsSync } from "node:fs";
 
 //#region src/migrate.ts
 async function migrate({ cwd, dryRun }) {
-	if (dryRun) consola.info("Dry run enabled. No changes were made.");
+	if (dryRun) consola$1.info("Dry run enabled. No changes were made.");
 	else {
-		const confirm = await consola.prompt("Please make sure to commit your changes before migrating. Continue?", { type: "confirm" });
+		const confirm = await consola$1.prompt("Please make sure to commit your changes before migrating. Continue?", { type: "confirm" });
 		if (!confirm) {
-			consola.error("Migration cancelled.");
+			consola$1.error("Migration cancelled.");
 			process.exitCode = 1;
 			return;
 		}
@@ -18,15 +18,15 @@ async function migrate({ cwd, dryRun }) {
 	if (cwd) process.chdir(cwd);
 	let migrated = await migratePackageJson(dryRun);
 	if (await migrateTsupConfig(dryRun)) migrated = true;
-	if (migrated) consola.success("Migration completed. Remember to run install command with your package manager.");
+	if (migrated) consola$1.success("Migration completed. Remember to run install command with your package manager.");
 	else {
-		consola.error("No migration performed.");
+		consola$1.error("No migration performed.");
 		process.exitCode = 1;
 	}
 }
 async function migratePackageJson(dryRun) {
 	if (!existsSync("package.json")) {
-		consola.error("No package.json found");
+		consola$1.error("No package.json found");
 		return false;
 	}
 	const pkgRaw = await readFile("package.json", "utf-8");
@@ -34,44 +34,44 @@ async function migratePackageJson(dryRun) {
 	const semver = `^${version}`;
 	let found = false;
 	if (pkg.dependencies?.tsup) {
-		consola.info("Migrating `dependencies` to tsdown.");
+		consola$1.info("Migrating `dependencies` to tsdown.");
 		found = true;
 		pkg.dependencies = renameKey(pkg.dependencies, "tsup", "tsdown", semver);
 	}
 	if (pkg.devDependencies?.tsup) {
-		consola.info("Migrating `devDependencies` to tsdown.");
+		consola$1.info("Migrating `devDependencies` to tsdown.");
 		found = true;
 		pkg.devDependencies = renameKey(pkg.devDependencies, "tsup", "tsdown", semver);
 	}
 	if (pkg.peerDependencies?.tsup) {
-		consola.info("Migrating `peerDependencies` to tsdown.");
+		consola$1.info("Migrating `peerDependencies` to tsdown.");
 		found = true;
 		pkg.peerDependencies = renameKey(pkg.peerDependencies, "tsup", "tsdown", "*");
 	}
 	if (pkg.scripts) {
 		for (const key of Object.keys(pkg.scripts)) if (pkg.scripts[key].includes("tsup")) {
-			consola.info(`Migrating \`${key}\` script to tsdown`);
+			consola$1.info(`Migrating \`${key}\` script to tsdown`);
 			found = true;
 			pkg.scripts[key] = pkg.scripts[key].replaceAll(/tsup(?:-node)?/g, "tsdown");
 		}
 	}
 	if (pkg.tsup) {
-		consola.info("Migrating `tsup` field in package.json to `tsdown`.");
+		consola$1.info("Migrating `tsup` field in package.json to `tsdown`.");
 		found = true;
 		pkg = renameKey(pkg, "tsup", "tsdown");
 	}
 	if (!found) {
-		consola.warn("No tsup-related fields found in package.json");
+		consola$1.warn("No tsup-related fields found in package.json");
 		return false;
 	}
 	const pkgStr = `${JSON.stringify(pkg, null, 2)}\n`;
 	if (dryRun) {
 		const { createPatch } = await import("diff");
-		consola.info("[dry-run] package.json:");
+		consola$1.info("[dry-run] package.json:");
 		console.info(createPatch("package.json", pkgRaw, pkgStr));
 	} else {
 		await writeFile("package.json", pkgStr);
-		consola.success("Migrated `package.json`");
+		consola$1.success("Migrated `package.json`");
 	}
 	return true;
 }
@@ -88,22 +88,22 @@ async function migrateTsupConfig(dryRun) {
 	let found = false;
 	for (const file of TSUP_FILES) {
 		if (!existsSync(file)) continue;
-		consola.info(`Found \`${file}\``);
+		consola$1.info(`Found \`${file}\``);
 		found = true;
 		const tsupConfigRaw = await readFile(file, "utf-8");
 		const tsupConfig = tsupConfigRaw.replaceAll(/\btsup\b/g, "tsdown").replaceAll(/\bTSUP\b/g, "TSDOWN");
 		const renamed = file.replaceAll("tsup", "tsdown");
 		if (dryRun) {
 			const { createTwoFilesPatch } = await import("diff");
-			consola.info(`[dry-run] ${file} -> ${renamed}:`);
+			consola$1.info(`[dry-run] ${file} -> ${renamed}:`);
 			console.info(createTwoFilesPatch(file, renamed, tsupConfigRaw, tsupConfig));
 		} else {
 			await writeFile(renamed, tsupConfig, "utf8");
 			await unlink(file);
-			consola.success(`Migrated \`${file}\` to \`${renamed}\``);
+			consola$1.success(`Migrated \`${file}\` to \`${renamed}\``);
 		}
 	}
-	if (!found) consola.warn("No tsup config found");
+	if (!found) consola$1.warn("No tsup config found");
 	return found;
 }
 function renameKey(obj, oldKey, newKey, newValue) {

package/dist/{options.d-BUmkLb5_.d.ts → options.d-DxODs1UG.d.ts}

@@ -1,11 +1,25 @@
-import { ExternalOption, InputOptions, InternalModuleFormat, ModuleFormat, OutputOptions } from "rolldown";
+import { ExternalOption, InputOption, InputOptions, InternalModuleFormat, ModuleFormat, OutputOptions } from "rolldown";
 import { Options } from "publint";
 import { Options as Options$1 } from "rolldown-plugin-dts";
 import { Options as Options$2 } from "unplugin-unused";
 import { PackageJson } from "pkg-types";
 
 //#region src/utils/package.d.ts
-type PackageType = "module" | "commonjs";
+type PackageType = "module" | "commonjs" | undefined;
+
+//#endregion
+//#region src/features/output.d.ts
+interface OutExtensionContext {
+	options: InputOptions;
+	format: NormalizedFormat;
+	/** "type" field in project's package.json */
+	pkgType?: PackageType;
+}
+interface OutExtensionObject {
+	js?: string;
+	dts?: string;
+}
+type OutExtensionFactory = (ctx: OutExtensionContext) => OutExtensionObject;
 
 //#endregion
 //#region src/utils/types.d.ts
@@ -23,22 +37,14 @@ type Arrayable<T> = T | T[];
 //#endregion
 //#region src/options.d.ts
 type Sourcemap = boolean | "inline" | "hidden";
-interface OutExtensionContext {
-	options: InputOptions;
-	format: NormalizedFormat;
-	/** "type" field in project's package.json */
-	pkgType: PackageType;
-}
-interface OutExtensionObject {
-	js?: string;
-	dts?: string;
-}
-type OutExtensionFactory = (ctx: OutExtensionContext) => OutExtensionObject;
+/**
+* Options for tsdown.
+*/
 /**
 * Options for tsdown.
 */
 interface Options$3 {
-	entry?: InputOptions["input"];
+	entry?: InputOption;
 	external?: ExternalOption;
 	noExternal?: Arrayable<string | RegExp> | ((id: string, importer: string | undefined) => boolean | null | undefined | void);
 	alias?: Record<string, string>;
@@ -46,8 +52,10 @@ interface Options$3 {
 	/** @default 'node' */
 	platform?: "node" | "neutral" | "browser";
 	inputOptions?: InputOptions | ((options: InputOptions, format: NormalizedFormat) => Awaitable<InputOptions | void | null>);
+	/** @default 'es' */
 	format?: ModuleFormat | ModuleFormat[];
 	globalName?: string;
+	/** @default 'dist' */
 	outDir?: string;
 	sourcemap?: Sourcemap;
 	clean?: boolean | string[];
@@ -55,13 +63,28 @@ interface Options$3 {
 	minify?: boolean;
 	target?: string | string[];
 	define?: Record<string, string>;
+	/** @default false */
 	shims?: boolean;
+	/**
+	* Use a fixed extension for output files.
+	* The extension will always be `.cjs` or `.mjs`.
+	* Otherwise, it will depend on the package type.
+	* @default false
+	*/
+	fixedExtension?: boolean;
+	/**
+	* Custom extensions for output files.
+	* `fixedExtension` will be overridden by this option.
+	*/
 	outExtensions?: OutExtensionFactory;
 	outputOptions?: OutputOptions | ((options: OutputOptions, format: NormalizedFormat) => Awaitable<OutputOptions | void | null>);
 	/** @default true */
 	treeshake?: boolean;
 	plugins?: InputOptions["plugins"];
 	silent?: boolean;
+	/**
+	* Config file path
+	*/
 	config?: boolean | string;
 	watch?: boolean | string | string[];
 	/**
@@ -73,19 +96,12 @@ interface Options$3 {
 	*/
 	skipNodeModulesBundle?: boolean;
 	/**
-	* Use a fixed extension for output files.
-	* The extension will always be `.cjs` or `.mjs`.
-	* Otherwise, it will depend on the package type.
-	* @default false
-	*/
-	fixedExtension?: boolean;
-	/**
 	* Reuse config from Vite or Vitest (experimental)
 	* @default false
 	*/
 	fromVite?: boolean | "vitest";
 	/**
-	* Enable dts generation with `isolatedDeclarations` (experimental)
+	* Emit declaration files
 	*/
 	dts?: boolean | Options$1;
 	/**
@@ -102,6 +118,9 @@ interface Options$3 {
 /**
 * Options without specifying config file path.
 */
+/**
+* Options without specifying config file path.
+*/
 type UserConfig = Arrayable<Omit<Options$3, "config">>;
 type NormalizedFormat = Exclude<InternalModuleFormat, "app"> | "experimental-app";
 type ResolvedOptions = Omit<Overwrite<MarkPartial<Options$3, "globalName" | "inputOptions" | "outputOptions" | "minify" | "target" | "define" | "alias" | "external" | "noExternal" | "onSuccess" | "dts" | "fixedExtension" | "outExtensions">, {
@@ -109,6 +128,7 @@ type ResolvedOptions = Omit<Overwrite<MarkPartial<Options$3, "globalName" | "inp
 	clean: string[] | false
 	dts: false | Options$1
 	tsconfig: string | false
+	cwd: string
 }>, "config" | "fromVite">;
 
 //#endregion

package/dist/package-DTByKj86.js

@@ -0,0 +1,5 @@
+//#region package.json
+var version = "0.9.2";
+
+//#endregion
+export { version };

package/dist/plugins-CATHxFm7.js

@@ -0,0 +1,117 @@
+import { logger } from "./logger-Dt3D6T-U.js";
+import path, { dirname, normalize, sep } from "node:path";
+import { access, chmod, rm } from "node:fs/promises";
+import Debug from "debug";
+import { underline } from "ansis";
+
+//#region src/utils/fs.ts
+function fsExists(path$1) {
+	return access(path$1).then(() => true, () => false);
+}
+function fsRemove(path$1) {
+	return rm(path$1, {
+		force: true,
+		recursive: true
+	}).catch(() => {});
+}
+function lowestCommonAncestor(...filepaths) {
+	if (filepaths.length === 0) return "";
+	if (filepaths.length === 1) return dirname(filepaths[0]);
+	filepaths = filepaths.map(normalize);
+	const [first, ...rest] = filepaths;
+	let ancestor = first.split(sep);
+	for (const filepath of rest) {
+		const directories = filepath.split(sep, ancestor.length);
+		let index = 0;
+		for (const directory of directories) if (directory === ancestor[index]) index += 1;
+		else {
+			ancestor = ancestor.slice(0, index);
+			break;
+		}
+		ancestor = ancestor.slice(0, index);
+	}
+	return ancestor.length <= 1 && ancestor[0] === "" ? sep + ancestor[0] : ancestor.join(sep);
+}
+
+//#endregion
+//#region src/utils/general.ts
+function toArray(val, defaultValue) {
+	if (Array.isArray(val)) return val;
+	else if (val == null) {
+		if (defaultValue) return [defaultValue];
+		return [];
+	} else return [val];
+}
+function debounce(fn, wait) {
+	let timeout;
+	return function(...args) {
+		if (timeout) clearTimeout(timeout);
+		timeout = setTimeout(() => {
+			timeout = void 0;
+			fn.apply(this, args);
+		}, wait);
+	};
+}
+
+//#endregion
+//#region src/features/external.ts
+const debug = Debug("tsdown:external");
+const RE_DTS = /\.d\.[cm]?ts$/;
+function ExternalPlugin(options, pkg) {
+	const deps = pkg && Array.from(getProductionDeps(pkg));
+	return {
+		name: "tsdown:external",
+		async resolveId(id, importer, { isEntry }) {
+			if (isEntry) return;
+			if (importer && RE_DTS.test(importer)) return;
+			const { noExternal } = options;
+			if (typeof noExternal === "function" && noExternal(id, importer)) return;
+			if (noExternal) {
+				const noExternalPatterns = toArray(noExternal);
+				if (noExternalPatterns.some((pattern) => {
+					return pattern instanceof RegExp ? pattern.test(id) : id === pattern;
+				})) return;
+			}
+			let shouldExternal = false;
+			if (options.skipNodeModulesBundle) {
+				const resolved = await this.resolve(id);
+				if (!resolved) return;
+				shouldExternal = resolved.external || /[\\/]node_modules[\\/]/.test(resolved.id);
+			}
+			if (deps) shouldExternal ||= deps.some((dep) => id === dep || id.startsWith(`${dep}/`));
+			if (shouldExternal) {
+				debug("External dependency:", id);
+				return {
+					id,
+					external: shouldExternal
+				};
+			}
+		}
+	};
+}
+function getProductionDeps(pkg) {
+	return new Set([...Object.keys(pkg.dependencies || {}), ...Object.keys(pkg.peerDependencies || {})]);
+}
+
+//#endregion
+//#region src/features/shebang.ts
+const RE_SHEBANG = /^#!.*/;
+function ShebangPlugin(cwd) {
+	return {
+		name: "tsdown:shebang",
+		async writeBundle(options, bundle) {
+			for (const chunk of Object.values(bundle)) {
+				if (chunk.type !== "chunk" || !chunk.isEntry) continue;
+				if (!RE_SHEBANG.test(chunk.code)) continue;
+				const filepath = path.resolve(cwd, options.file || path.join(options.dir, chunk.fileName));
+				if (await fsExists(filepath)) {
+					logger.info(`Granting execute permission to ${underline(path.relative(cwd, filepath))}`);
+					await chmod(filepath, 493);
+				}
+			}
+		}
+	};
+}
+
+//#endregion
+export { ExternalPlugin, ShebangPlugin, debounce, fsExists, fsRemove, lowestCommonAncestor, toArray };

package/dist/plugins.d.ts

@@ -1,4 +1,4 @@
-import { ResolvedOptions } from "./options.d-BUmkLb5_.js";
+import { ResolvedOptions } from "./options.d-DxODs1UG.js";
 import { Plugin } from "rolldown";
 import { PackageJson } from "pkg-types";
 
@@ -6,4 +6,8 @@ import { PackageJson } from "pkg-types";
 declare function ExternalPlugin(options: ResolvedOptions, pkg?: PackageJson): Plugin;
 
 //#endregion
-export { ExternalPlugin };
+//#region src/features/shebang.d.ts
+declare function ShebangPlugin(cwd: string): Plugin;
+
+//#endregion
+export { ExternalPlugin, ShebangPlugin };

package/dist/plugins.js

@@ -1,3 +1,4 @@
-import { ExternalPlugin } from "./external-DvQ4QDcG.js";
+import { ExternalPlugin, ShebangPlugin } from "./plugins-CATHxFm7.js";
+import "./logger-Dt3D6T-U.js";
 
-export { ExternalPlugin };
+export { ExternalPlugin, ShebangPlugin };

package/dist/run.js

@@ -1,5 +1,6 @@
-import { logger, setSilent } from "./logger-4bmpqibt.js";
-import { version } from "./package-BnNFONow.js";
+#!/usr/bin/env node
+import { logger, setSilent } from "./logger-Dt3D6T-U.js";
+import { version } from "./package-DTByKj86.js";
 import process from "node:process";
 import { VERSION } from "rolldown";
 import { dim } from "ansis";
@@ -16,7 +17,7 @@ cli.command("[...files]", "Bundle files", { ignoreOptionDefaultValue: true }).op
 	await build$1(flags);
 });
 cli.command("migrate", "Migrate from tsup to tsdown").option("-c, --cwd <dir>", "Working directory").option("-d, --dry-run", "Dry run").action(async (args) => {
-	const { migrate } = await import("./migrate-D8koNtWX.js");
+	const { migrate } = await import("./migrate-M59yd0BY.js");
 	await migrate(args);
 });
 async function runCLI() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tsdown",
-  "version": "0.9.0",
-  "description": "Smooth and fast library bundler powered by Rolldown.",
+  "version": "0.9.2",
+  "description": "The Elegant Bundler for Libraries",
   "type": "module",
   "license": "MIT",
   "homepage": "https://github.com/rolldown/tsdown#readme",
@@ -36,7 +36,7 @@
     }
   },
   "bin": {
-    "tsdown": "./bin/tsdown.js"
+    "tsdown": "./dist/run.js"
   },
   "publishConfig": {
     "access": "public"
@@ -61,19 +61,20 @@
     "debug": "^4.4.0",
     "diff": "^7.0.0",
     "find-up-simple": "^1.0.1",
-    "rolldown": "^1.0.0-beta.7",
+    "rolldown": "1.0.0-beta.7-commit.c2596d3",
     "rolldown-plugin-dts": "^0.8.0",
     "tinyexec": "^1.0.1",
     "tinyglobby": "^0.2.12",
     "unconfig": "^7.3.1"
   },
   "devDependencies": {
-    "@sxzz/eslint-config": "^6.1.1",
+    "@sxzz/eslint-config": "^6.1.2",
     "@sxzz/prettier-config": "^2.2.1",
     "@sxzz/test-utils": "^0.5.5",
     "@types/debug": "^4.1.12",
     "@types/diff": "^7.0.2",
     "@types/node": "^22.14.1",
+    "@unocss/eslint-plugin": "^66.1.0-beta.12",
     "bumpp": "^10.1.0",
     "eslint": "^9.25.0",
     "pkg-types": "^2.1.0",
@@ -81,11 +82,17 @@
     "publint": "^0.3.12",
     "tsup": "^8.4.0",
     "tsx": "^4.19.3",
+    "typedoc": "^0.28.2",
+    "typedoc-plugin-markdown": "^4.6.2",
     "typescript": "~5.8.3",
-    "unplugin-ast": "^0.14.6",
+    "unocss": "^66.1.0-beta.12",
     "unplugin-unused": "^0.4.4",
     "vite": "^6.3.2",
-    "vitest": "^3.1.1"
+    "vitepress": "^1.6.3",
+    "vitepress-plugin-group-icons": "^1.5.2",
+    "vitepress-plugin-llms": "^1.1.0",
+    "vitest": "^3.1.1",
+    "vue": "^3.5.13"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -99,6 +106,10 @@
     "test": "vitest",
     "typecheck": "tsc --noEmit",
     "format": "prettier --cache --write .",
-    "release": "bumpp && pnpm publish"
+    "release": "bumpp && pnpm publish",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "docs:generate": "./docs/.vitepress/scripts/docs-generate.sh"
   }
 }

package/bin/tsdown.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import '../dist/run.js'

package/dist/external-DvQ4QDcG.js

@@ -1,63 +0,0 @@
-import Debug from "debug";
-
-//#region src/utils/general.ts
-function toArray(val, defaultValue) {
-	if (Array.isArray(val)) return val;
-	else if (val == null) {
-		if (defaultValue) return [defaultValue];
-		return [];
-	} else return [val];
-}
-function debounce(fn, wait) {
-	let timeout;
-	return function(...args) {
-		if (timeout) clearTimeout(timeout);
-		timeout = setTimeout(() => {
-			timeout = void 0;
-			fn.apply(this, args);
-		}, wait);
-	};
-}
-
-//#endregion
-//#region src/features/external.ts
-const debug = Debug("tsdown:external");
-const RE_DTS = /\.d\.[cm]?ts$/;
-function ExternalPlugin(options, pkg) {
-	const deps = pkg && Array.from(getProductionDeps(pkg));
-	return {
-		name: "tsdown:external",
-		async resolveId(id, importer, { isEntry }) {
-			if (isEntry) return;
-			if (importer && RE_DTS.test(importer)) return;
-			const { noExternal } = options;
-			if (typeof noExternal === "function" && noExternal(id, importer)) return;
-			if (noExternal) {
-				const noExternalPatterns = toArray(noExternal);
-				if (noExternalPatterns.some((pattern) => {
-					return pattern instanceof RegExp ? pattern.test(id) : id === pattern;
-				})) return;
-			}
-			let shouldExternal = false;
-			if (options.skipNodeModulesBundle) {
-				const resolved = await this.resolve(id);
-				if (!resolved) return;
-				shouldExternal = resolved.external || /[\\/]node_modules[\\/]/.test(resolved.id);
-			}
-			if (deps) shouldExternal ||= deps.some((dep) => id === dep || id.startsWith(`${dep}/`));
-			if (shouldExternal) {
-				debug("External dependency:", id);
-				return {
-					id,
-					external: shouldExternal
-				};
-			}
-		}
-	};
-}
-function getProductionDeps(pkg) {
-	return new Set([...Object.keys(pkg.dependencies || {}), ...Object.keys(pkg.peerDependencies || {})]);
-}
-
-//#endregion
-export { ExternalPlugin, debounce, toArray };

package/dist/package-BnNFONow.js

@@ -1,6 +0,0 @@
-
-//#region package.json
-var version = "0.9.0";
-
-//#endregion
-export { version };