Merge branch 'main' into unbuild-migration

CodeMan62 · web-flow · commit c21ee1093602 · 2025-04-28T14:41:46.000+05:30
diff --git a/docs/guide/cleaning.md b/docs/guide/cleaning.md
@@ -1,14 +1,12 @@
 # Cleaning
 
-<!-- TODO enable clean by default -->
+By default, `tsdown` will **clean the output directory** (`outDir`) before each build. This ensures that any files from previous builds are removed, preventing outdated or unused files from remaining in your output.
 
-By default, `tsdown` does not clean the output folder for you. This means that if your bundling process generates files with different names compared to a previous build, the older files will remain in the output directory.
-
-To ensure the output directory is cleaned before building, you can use the `--clean` option:
+If you want to disable this behavior and keep existing files in the output directory, you can use the `--no-clean` option:
 
 ```bash
-tsdown --clean
+tsdown --no-clean
 ```
 
 > [!NOTE]
-> Using the `--clean` option will remove all files in the output directory before the build process begins. Make sure this behavior aligns with your project requirements to avoid accidentally deleting important files.
+> By default, all files in the output directory will be removed before the build process begins. Make sure this behavior aligns with your project requirements to avoid accidentally deleting important files.
diff --git a/docs/guide/dts.md b/docs/guide/dts.md
@@ -12,7 +12,9 @@ If you encounter any issues related to `.d.ts` generation, please report them di
 
 ## Enabling dts Generation
 
-You can enable `.d.ts` generation using the `--dts` option in the CLI or by setting `dts: true` in your configuration file.
+If your `package.json` contains a `types` or `typings` field, declaration file generation will be **enabled by default** in `tsdown`.
+
+You can also explicitly enable `.d.ts` generation using the `--dts` option in the CLI or by setting `dts: true` in your configuration file.
 
 ### CLI
 
diff --git a/docs/guide/migrate-from-tsup.md b/docs/guide/migrate-from-tsup.md
@@ -2,6 +2,8 @@
 
 [tsup](https://tsup.egoist.dev/) is a powerful and widely-used bundler that shares many similarities with `tsdown`. While `tsup` is built on top of [esbuild](https://esbuild.github.io/), `tsdown` leverages the power of [Rolldown](https://rolldown.rs/) to deliver a **faster** and more **powerful** bundling experience.
 
+## Migration Guide
+
 If you're currently using `tsup` and want to migrate to `tsdown`, the process is straightforward thanks to the dedicated `migrate` command:
 
 ```bash
@@ -20,6 +22,22 @@ The `migrate` command supports the following options to customize the migration
 
 With these options, you can easily tailor the migration process to fit your specific project setup.
 
+## Differences from tsup
+
+While `tsdown` aims to be highly compatible with `tsup`, there are some differences to be aware of:
+
+### Default Values
+
+- **`format`**: Defaults to `esm`.
+- **`clean`**: Enabled by default and will clean the `outDir` before each build.
+- **`dts`**: Automatically enabled if your `package.json` contains a `typings` or `types` field.
+
+### Feature Gaps
+
+Some features available in `tsup` are not yet implemented in `tsdown`. If you find an option missing that you need, please [open an issue](https://github.com/rolldown/tsdown/issues) to let us know your requirements.
+
+Please review your configuration after migration to ensure it matches your expectations.
+
 ## Acknowledgements
 
 `tsdown` would not have been possible without the inspiration and contributions of the open-source community. We would like to express our heartfelt gratitude to the following:
diff --git a/docs/zh-CN/guide/cleaning.md b/docs/zh-CN/guide/cleaning.md
@@ -1,14 +1,12 @@
 # 清理
 
-<!-- TODO enable clean by default -->
+默认情况下，`tsdown` 会在每次构建之前**清理输出目录**（`outDir`）。这可以确保移除之前构建中生成的文件，防止过时或未使用的文件留在输出目录中。
 
-默认情况下，`tsdown` 不会自动清理输出文件夹。这意味着，如果您的打包过程生成的文件名与之前的构建不同，旧的文件将会保留在输出目录中。
-
-为了在构建之前清理输出目录，您可以使用 `--clean` 选项：
+如果您希望禁用此行为并保留输出目录中的现有文件，可以使用 `--no-clean` 选项：
 
 ```bash
-tsdown --clean
+tsdown --no-clean
 ```
 
-> [!NOTE]
-> 使用 `--clean` 选项会在构建过程开始之前删除输出目录中的所有文件。请确保此行为符合您的项目需求，以避免意外删除重要文件。
+> [!NOTE]  
+> 默认情况下，输出目录中的所有文件将在构建过程开始之前被删除。请确保此行为符合您的项目需求，以避免意外删除重要文件。
diff --git a/docs/zh-CN/guide/dts.md b/docs/zh-CN/guide/dts.md
@@ -12,7 +12,9 @@
 
 ## 启用 dts 生成
 
-您可以通过 CLI 中的 `--dts` 选项或在配置文件中设置 `dts: true` 来启用 `.d.ts` 生成。
+如果您的 `package.json` 中包含 `types` 或 `typings` 字段，`tsdown` 将**默认启用**声明文件的生成。
+
+您还可以通过 CLI 中的 `--dts` 选项或在配置文件中设置 `dts: true` 来显式启用 `.d.ts` 文件的生成。
 
 ### CLI
 
diff --git a/docs/zh-CN/guide/migrate-from-tsup.md b/docs/zh-CN/guide/migrate-from-tsup.md
@@ -2,6 +2,8 @@
 
 [tsup](https://tsup.egoist.dev/) 是一个功能强大且广泛使用的打包器，与 `tsdown` 有许多相似之处。虽然 `tsup` 构建于 [esbuild](https://esbuild.github.io/) 之上，`tsdown` 则利用了 [Rolldown](https://rolldown.rs/) 的强大功能，提供了更**快速**且更**强大**的打包体验。
 
+## 迁移指南
+
 如果您当前正在使用 `tsup` 并希望迁移到 `tsdown`，迁移过程非常简单，因为 `tsdown` 提供了专门的 `migrate` 命令：
 
 ```bash
@@ -20,6 +22,22 @@ npx tsdown migrate
 
 通过这些选项，您可以轻松调整迁移过程以适应您的特定项目设置。
 
+## 与 tsup 的区别
+
+虽然 `tsdown` 旨在与 `tsup` 高度兼容，但仍有一些差异需要注意：
+
+### 默认值
+
+- **`format`**：默认值为 `esm`。
+- **`clean`**：默认启用，每次构建前会清理 `outDir`。
+- **`dts`**：如果您的 `package.json` 中包含 `typings` 或 `types` 字段，则会自动启用。
+
+### 功能差距
+
+`tsdown` 尚未实现 `tsup` 中的某些功能。如果您发现缺少某些您需要的选项，请 [提交问题](https://github.com/rolldown/tsdown/issues) 告诉我们您的需求。
+
+迁移后，请仔细检查您的配置以确保其符合您的预期。
+
 ## 致谢
 
 `tsdown` 的诞生离不开开源社区的启发和贡献。我们衷心感谢以下项目和个人：
diff --git a/jsr.json b/jsr.json
@@ -1,6 +1,6 @@
 {
   "name": "@sxzz/tsdown",
-  "version": "0.9.9",
+  "version": "0.10.0",
   "exports": "./src/index.ts",
   "publish": {
     "include": [
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "tsdown",
-  "version": "0.9.9",
+  "version": "0.10.0",
   "packageManager": "pnpm@10.9.0",
   "description": "The Elegant Bundler for Libraries",
   "type": "module",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
@@ -39,7 +39,7 @@ catalogs:
     hookable: ^5.5.3
     lightningcss: ^1.29.3
     rolldown: 1.0.0-beta.8-commit.151352b
-    rolldown-plugin-dts: ^0.9.4
+    rolldown-plugin-dts: ^0.9.5
     tinyexec: ^1.0.1
     tinyglobby: ^0.2.13
     unconfig: ^7.3.2
diff --git a/src/cli.ts b/src/cli.ts
@@ -33,7 +33,7 @@ cli
   .option('--platform <platform>', 'Target platform', {
     default: 'node',
   })
-  .option('--dts', 'Generate dts files', { default: false })
+  .option('--dts', 'Generate dts files')
   .option('--publint', 'Enable publint', { default: false })
   .option('--unused', 'Enable unused dependencies check', { default: false })
   .option('-w, --watch [path]', 'Watch mode')
diff --git a/src/features/clean.ts b/src/features/clean.ts
@@ -1,29 +1,41 @@
-import { readdir } from 'node:fs/promises'
-import path from 'node:path'
 import Debug from 'debug'
 import { glob } from 'tinyglobby'
-import { fsExists, fsRemove } from '../utils/fs'
+import { fsRemove } from '../utils/fs'
 import { logger } from '../utils/logger'
+import type { Options, ResolvedOptions } from '../options'
 
 const debug = Debug('tsdown:clean')
 
-// clean cwd dir + patterns
-export async function cleanOutDir(
-  cwd: string,
-  patterns: string[],
-): Promise<void> {
-  const files = []
+export async function cleanOutDir(configs: ResolvedOptions[]): Promise<void> {
+  const removes = new Set<string>()
 
-  if (await fsExists(cwd))
-    files.push(...(await readdir(cwd)).map((file) => path.resolve(cwd, file)))
-
-  if (patterns.length) {
-    files.push(...(await glob(patterns, { cwd, absolute: true })))
+  for (const config of configs) {
+    if (!config.clean.length) continue
+    const files = await glob(config.clean, { cwd: config.cwd, absolute: true })
+    for (const file of files) {
+      removes.add(file)
+    }
   }
+  if (!removes.size) return
+
+  logger.info('Cleaning %d files', removes.size)
+  await Promise.all(
+    [...removes].map(async (file) => {
+      debug('Removing', file)
+      await fsRemove(file)
+    }),
+  )
+  debug('Removed %d files', removes.size)
+}
 
-  logger.info('Cleaning output folder')
-  for (const file of files) {
-    debug('Removing', file)
-    await fsRemove(file)
+export function resolveClean(
+  clean: Options['clean'],
+  outDir: string,
+): string[] {
+  if (clean === true) {
+    clean = [outDir]
+  } else if (!clean) {
+    clean = []
   }
+  return clean
 }
diff --git a/src/features/external.ts b/src/features/external.ts
@@ -7,11 +7,8 @@ import type { Plugin } from 'rolldown'
 const debug = Debug('tsdown:external')
 const RE_DTS = /\.d\.[cm]?ts$/
 
-export function ExternalPlugin(
-  options: ResolvedOptions,
-  pkg?: PackageJson,
-): Plugin {
-  const deps = pkg && Array.from(getProductionDeps(pkg))
+export function ExternalPlugin(options: ResolvedOptions): Plugin {
+  const deps = options.pkg && Array.from(getProductionDeps(options.pkg))
   return {
     name: 'tsdown:external',
     async resolveId(id, importer, { isEntry }) {
diff --git a/src/features/output.ts b/src/features/output.ts
@@ -1,6 +1,5 @@
 import { getPackageType, type PackageType } from '../utils/package'
 import type { NormalizedFormat, ResolvedOptions } from '../options'
-import type { PackageJson } from 'pkg-types'
 import type { InputOptions, PreRenderedChunk } from 'rolldown'
 
 export interface OutExtensionContext {
@@ -33,10 +32,9 @@ function resolveJsOutputExtension(
 }
 
 export function resolveChunkFilename(
-  pkg: PackageJson | undefined,
+  { outExtensions, fixedExtension, pkg }: ResolvedOptions,
   inputOptions: InputOptions,
   format: NormalizedFormat,
-  { outExtensions, fixedExtension }: ResolvedOptions,
 ): [entry: ChunkFileName, chunk: ChunkFileName] {
   const packageType = getPackageType(pkg)
 
diff --git a/src/features/tsconfig.ts b/src/features/tsconfig.ts
@@ -0,0 +1,47 @@
+import path from 'node:path'
+import { underline } from 'ansis'
+import { up as findUp } from 'empathic/find'
+import { fsExists } from '../utils/fs'
+import { logger } from '../utils/logger'
+import type { Options } from '../options'
+
+export function findTsconfig(
+  cwd?: string,
+  name: string = 'tsconfig.json',
+): string | false {
+  return findUp(name, { cwd }) || false
+}
+
+export async function resolveTsconfig(
+  tsconfig: Options['tsconfig'],
+  cwd: string,
+): Promise<string | false> {
+  if (tsconfig !== false) {
+    if (tsconfig === true || tsconfig == null) {
+      const isSet = tsconfig
+      tsconfig = findTsconfig(cwd)
+      if (isSet && !tsconfig) {
+        logger.warn(`No tsconfig found in \`${cwd}\``)
+      }
+    } else {
+      const tsconfigPath = path.resolve(cwd, tsconfig)
+      if (await fsExists(tsconfigPath)) {
+        tsconfig = tsconfigPath
+      } else if (tsconfig.includes('\\') || tsconfig.includes('/')) {
+        logger.warn(`tsconfig \`${tsconfig}\` doesn't exist`)
+        tsconfig = false
+      } else {
+        tsconfig = findTsconfig(cwd, tsconfig)
+        if (!tsconfig) {
+          logger.warn(`No \`${tsconfig}\` found in \`${cwd}\``)
+        }
+      }
+    }
+
+    if (tsconfig) {
+      logger.info(`Using tsconfig: ${underline(path.relative(cwd, tsconfig))}`)
+    }
+  }
+
+  return tsconfig
+}
diff --git a/src/index.ts b/src/index.ts
diff --git a/src/migrate.ts b/src/migrate.ts
diff --git a/src/options.ts b/src/options.ts
diff --git a/src/utils/tsconfig.ts b/src/utils/tsconfig.ts
diff --git a/tests/utils.ts b/tests/utils.ts
diff --git a/tsdown.config.ts b/tsdown.config.ts

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@sxzz/tsdown",`
`3`		`- "version": "0.9.9",`
	`3`	`+ "version": "0.10.0",`
`4`	`4`	`"exports": "./src/index.ts",`
`5`	`5`	`"publish": {`
`6`	`6`	`"include": [`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "tsdown",`
`3`		`- "version": "0.9.9",`
	`3`	`+ "version": "0.10.0",`
`4`	`4`	`"packageManager": "[email protected]",`
`5`	`5`	`"description": "The Elegant Bundler for Libraries",`
`6`	`6`	`"type": "module",`