feat(dts): upgrade rolldown-plugin-dts to v0.30 (#1123)

Author: sxzzbot

AGENTS.md

@@ -181,7 +181,7 @@ Public plugin exports in `src/plugins.ts`: `DepsPlugin`, `NodeProtocolPlugin`, `
 
 ### Key Architectural Patterns
 
-1. **Multi-format builds:** Single config produces ESM + CJS + types. ES format handles types via dts plugin; CJS format has separate dts pass with `emitDtsOnly: true`
+1. **Multi-format builds:** Single config produces ESM + CJS + types. ES format handles types via dts plugin; CJS format has separate dts pass with `dtsOnly: true`
 
 2. **Package-aware building:** Detects package.json, auto-generates exports field, validates bundled dependencies, runs package linters
 
@@ -280,7 +280,7 @@ Entry points support:
 When `format: ['esm', 'cjs']`:
 
 1. First pass builds both formats with shared types from ESM build
-2. If CJS needs separate types, second pass runs with `emitDtsOnly: true`
+2. If CJS needs separate types, second pass runs with `dtsOnly: true`
 
 ### Package.json Integration
 

docs/options/dts.md

@@ -98,3 +98,20 @@ If `isolatedDeclarations` is not enabled, `tsdown` will fall back to using the T
 ## Advanced Options
 
 `rolldown-plugin-dts` provides several advanced options to customize `.d.ts` generation. For a detailed explanation of these options, refer to the [plugin's documentation](https://github.com/sxzz/rolldown-plugin-dts#options).
+
+### Filtering Entries
+
+By default, every entry gets a declaration file. Use `dts.entry` to emit declarations only for some entries:
+
+```ts [tsdown.config.ts]
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts', 'src/cli.ts'],
+  dts: {
+    entry: ['src/**/*.ts', '!src/cli.ts'],
+  },
+})
+```
+
+`dts.entry` only filters entries: a file that is not an entry never gets its own declaration file, even if it matches.

docs/zh-CN/options/dts.md

@@ -98,3 +98,20 @@ export default defineConfig({
 ## 高级选项
 
 `rolldown-plugin-dts` 提供了多个高级选项用于自定义 `.d.ts` 文件的生成。详细说明请参阅 [插件文档](https://github.com/sxzz/rolldown-plugin-dts#options)。
+
+### 筛选入口
+
+默认情况下，每个入口都会生成声明文件。使用 `dts.entry` 可以只为部分入口生成声明文件：
+
+```ts [tsdown.config.ts]
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts', 'src/cli.ts'],
+  dts: {
+    entry: ['src/**/*.ts', '!src/cli.ts'],
+  },
+})
+```
+
+`dts.entry` 只筛选入口：不是入口的文件即使匹配，也不会单独生成声明文件。

pnpm-lock.yaml

@@ -99,7 +99,7 @@ catalogs:
     picomatch: ^4.0.7
     postcss-load-config: ^6.0.1
     rolldown: ~1.2.16
-    rolldown-plugin-dts: ^0.29.0
+    rolldown-plugin-dts: ^0.30.0
     tinyexec: ^1.3.1
     tinyglobby: ^0.2.17
     tinyps: ^0.5.1

pnpm-workspace.yaml

@@ -4954,20 +4954,15 @@
             { "type": "string" },
             { "type": "array", "items": { "type": "string" } }
           ],
-          "description": "Glob pattern(s) that select source files for declaration generation.\n\nPatterns are relative to {@link cwd} and may be negated with `!`. Matching\nfiles are emitted even when they are not Rolldown entry points."
+          "description": "Glob pattern(s) that filter which Rolldown entries emit declarations.\n\nPatterns are relative to {@link cwd} and may be negated with `!`. Only\nRolldown entries are matched; other files never emit declarations.\n\nCannot be combined with {@link dtsOnly}; set Rolldown's `input` instead."
         },
         "cwd": {
           "type": "string",
           "description": "Base directory for config discovery, glob matching, and relative paths."
         },
-        "dtsInput": {
+        "dtsOnly": {
           "anyOf": [{ "const": false }, { "const": true }],
-          "description": "Treats entry files as existing declarations instead of source files.",
-          "default": false
-        },
-        "emitDtsOnly": {
-          "anyOf": [{ "const": false }, { "const": true }],
-          "description": "Removes non-declaration chunks from the output.",
+          "description": "Builds declarations only. Each entry resolves to its declaration, so the\nbuild emits no JavaScript. Entries may be source files or existing\ndeclaration files.",
           "default": false
         },
         "tsconfig": {
@@ -5034,6 +5029,16 @@
           "items": { "$ref": "#/$defs/CustomLanguage" },
           "description": "Registers non-standard source languages such as Vue or Astro.\n\nIf a language is supported via {@link https://volarjs.dev Volar},\n{@link CustomLanguage.volarTypeScript} and\n{@link CustomLanguage.createVolarPlugins} are both required. Volar\nlanguages require `tsc`. Non-Volar languages can use `tsgo` together\nwith {@link TsgoOptions.vfs`tsgo.vfs`}, or `tsrs` with\n{@link TsrsOptions.vfs`tsrs.vfs`}."
         },
+        "dtsInput": {
+          "anyOf": [{ "const": false }, { "const": true }],
+          "description": "Deprecated: Use `dtsOnly` instead.",
+          "deprecated": true
+        },
+        "emitDtsOnly": {
+          "anyOf": [{ "const": false }, { "const": true }],
+          "description": "Deprecated: Use `dtsOnly` instead.",
+          "deprecated": true
+        },
         "build": {
           "anyOf": [{ "const": false }, { "const": true }],
           "description": "Deprecated: Use `tsc.build` instead.",

schema.json

@@ -227,6 +227,7 @@ export default defineConfig({
 
 | Option | Type | Description |
 |--------|------|-------------|
+| `entry` | `string \| string[]` | Globs filtering which entries emit declarations; non-entry files never do |
 | `sourcemap` | `boolean` | Generate declaration source maps |
 | `compilerOptions` | `object` | Override TypeScript compiler options |
 | `vue` | `boolean` | Enable Vue type generation (requires vue-tsc) |

skills/tsdown/references/option-dts.md

@@ -132,6 +132,7 @@ async function resolveInputOptions(
   if (dts) {
     const { dts: dtsPlugin } = await import('rolldown-plugin-dts')
     const options: DtsOptions = {
+      cwd,
       tsconfig,
       logger,
       ...dts,
@@ -140,10 +141,13 @@ async function resolveInputOptions(
     if (format === 'es') {
       plugins.push(dtsPlugin(options))
     } else if (cjsDts) {
+      // `dtsOnly` cannot be combined with `entry`, so the entry filter is
+      // applied to `input` below instead.
+      const { entry: _, ...rest } = options
       plugins.push(
         dtsPlugin({
-          ...options,
-          emitDtsOnly: true,
+          ...rest,
+          dtsOnly: true,
           cjsDefault,
         }),
       )
@@ -248,7 +252,7 @@ async function resolveInputOptions(
 
   const inputOptions = await mergeUserOptions(
     {
-      input: entry,
+      input: cjsDts && dts ? filterDtsEntry(entry, cwd, dts) : entry,
       cwd,
       external,
       resolve: {
@@ -291,6 +295,35 @@ async function resolveInputOptions(
   return inputOptions
 }
 
+/**
+ * Applies `dts.entry` to the entries of a declaration-only build, matching
+ * the way rolldown-plugin-dts filters entries in a regular build.
+ */
+function filterDtsEntry(
+  entry: Record<string, string>,
+  cwd: string,
+  { entry: patterns, cwd: dtsCwd = cwd }: DtsOptions,
+): Record<string, string> {
+  if (patterns === undefined) return entry
+
+  const includes: string[] = []
+  const ignores: string[] = []
+  for (const pattern of toArray(patterns)) {
+    if (pattern[0] === '!') ignores.push(pattern.slice(1))
+    else includes.push(pattern)
+  }
+
+  return Object.fromEntries(
+    Object.entries(entry).filter(([, file]) => {
+      const id = path.relative(dtsCwd, path.resolve(cwd, file))
+      return (
+        includes.some((p) => path.matchesGlob(id, p)) &&
+        ignores.every((p) => !path.matchesGlob(id, p))
+      )
+    }),
+  )
+}
+
 async function resolveOutputOptions(
   inputOptions: InputOptions,
   config: ResolvedConfig,