feat(deps)!: remove deprecated skipNodeModulesBundle

Use `deps.neverBundle: true` instead, which externalizes all
dependencies. tsup configs are migrated automatically by
`tsdown-migrate`.

Author: sxzz

__snapshots__/tsnapi/config.snapshot.d.ts

@@ -68,7 +68,6 @@ export interface UserConfig {
   external?: ExternalOption;
   noExternal?: Arrayable<string | RegExp> | NoExternalFn;
   inlineOnly?: Arrayable<string | RegExp> | false;
-  skipNodeModulesBundle?: boolean;
   removeNodeProtocol?: boolean;
   bundle?: boolean;
   outExtension?: OutExtensionFactory;

__snapshots__/tsnapi/index.snapshot.d.ts

@@ -29,7 +29,6 @@ export interface DepsConfig {
   alwaysBundle?: Arrayable<string | RegExp> | NoExternalFn;
   onlyBundle?: Arrayable<string | RegExp> | false;
   onlyImport?: Arrayable<string | RegExp>;
-  skipNodeModulesBundle?: boolean;
   resolveDepSubpath?: boolean;
   dts?: Pick<DepsConfig, "alwaysBundle" | "neverBundle">;
 }
@@ -93,7 +92,7 @@ export interface ReportOptions {
   brotli?: boolean;
   maxCompressSize?: number;
 }
-export interface ResolvedDepsConfig extends Pick<DepsConfig, "neverBundle" | "skipNodeModulesBundle" | "resolveDepSubpath"> {
+export interface ResolvedDepsConfig extends Pick<DepsConfig, "neverBundle" | "resolveDepSubpath"> {
   alwaysBundle?: NoExternalFn;
   onlyBundle?: Array<string | RegExp> | false;
   onlyImport?: Array<string | RegExp>;
@@ -196,7 +195,6 @@ export interface UserConfig {
   external?: ExternalOption;
   noExternal?: Arrayable<string | RegExp> | NoExternalFn;
   inlineOnly?: Arrayable<string | RegExp> | false;
-  skipNodeModulesBundle?: boolean;
   removeNodeProtocol?: boolean;
   bundle?: boolean;
   outExtension?: OutExtensionFactory;
@@ -224,7 +222,7 @@ export type NoExternalFn = (_: string, _: string | undefined) => boolean | null
 export type NormalizedFormat = InternalModuleFormat;
 export type OutExtensionFactory = (_: OutExtensionContext) => OutExtensionObject | undefined;
 export type PackageType = "module" | "commonjs" | undefined;
-export type ResolvedConfig = Overwrite<MarkPartial<Omit<UserConfig, "workspace" | "fromVite" | "publicDir" | "bundle" | "injectStyle" | "removeNodeProtocol" | "outExtension" | "external" | "noExternal" | "inlineOnly" | "skipNodeModulesBundle" | "logLevel" | "failOnWarn" | "suppressWarnings" | "customLogger" | "envFile" | "envPrefix">, "globalName" | "inputOptions" | "outputOptions" | "minify" | "define" | "alias" | "onSuccess" | "outExtensions" | "hooks" | "copy" | "loader" | "name" | "banner" | "footer" | "checks" | "css">, {
+export type ResolvedConfig = Overwrite<MarkPartial<Omit<UserConfig, "workspace" | "fromVite" | "publicDir" | "bundle" | "injectStyle" | "removeNodeProtocol" | "outExtension" | "external" | "noExternal" | "inlineOnly" | "logLevel" | "failOnWarn" | "suppressWarnings" | "customLogger" | "envFile" | "envPrefix">, "globalName" | "inputOptions" | "outputOptions" | "minify" | "define" | "alias" | "onSuccess" | "outExtensions" | "hooks" | "copy" | "loader" | "name" | "banner" | "footer" | "checks" | "css">, {
   entry: Record<string, string>;
   rawEntry?: TsdownInputOption;
   nameLabel: string | undefined;

__snapshots__/tsnapi/plugins.snapshot.d.ts

@@ -2,7 +2,7 @@
  * Generated by tsnapi — public API snapshot of `tsdown/plugins`
  */
 // #region Functions
-export declare function DepsPlugin({ pkg, deps: { neverBundle, alwaysBundle: jsAlwaysBundle, onlyBundle, onlyImport, skipNodeModulesBundle, resolveDepSubpath: shouldResolveDepSubpath, dts }, logger, nameLabel, platform }: ResolvedConfig, _: TsdownBundle): Plugin;
+export declare function DepsPlugin({ pkg, deps: { neverBundle, alwaysBundle: jsAlwaysBundle, onlyBundle, onlyImport, resolveDepSubpath: shouldResolveDepSubpath, dts }, logger, nameLabel, platform }: ResolvedConfig, _: TsdownBundle): Plugin;
 export declare function NodeProtocolPlugin(_: "strip" | true): Plugin;
 export declare function ReportPlugin(_: ResolvedConfig, _?: boolean, _?: boolean): Plugin;
 export declare function ShebangPlugin(_: Logger, _: string, _?: string, _?: boolean): Plugin;

docs/guide/migrate-from-tsup.md

@@ -54,11 +54,12 @@ While `tsdown` aims to be highly compatible with `tsup`, there are some differen
 
 Some options have been renamed for clarity:
 
-| tsup             | tsdown          | Notes                              |
-| ---------------- | --------------- | ---------------------------------- |
-| `cjsInterop`     | `cjsDefault`    | CJS default export handling        |
-| `esbuildPlugins` | `plugins`       | Now uses Rolldown/Unplugin plugins |
-| `outExtension`   | `outExtensions` | Custom output extensions           |
+| tsup                    | tsdown                        | Notes                              |
+| ----------------------- | ----------------------------- | ---------------------------------- |
+| `cjsInterop`            | `cjsDefault`                  | CJS default export handling        |
+| `esbuildPlugins`        | `plugins`                     | Now uses Rolldown/Unplugin plugins |
+| `outExtension`          | `outExtensions`               | Custom output extensions           |
+| `skipNodeModulesBundle` | `deps: { neverBundle: true }` | Externalize all dependencies       |
 
 ### Deprecated but Compatible Options
 
@@ -73,7 +74,6 @@ The following tsup options still work in tsdown for backward compatibility, but
 | `injectStyle: true`        | `css: { inject: true }`         | Moved into CSS namespace          |
 | `external: [...]`          | `deps: { neverBundle: [...] }`  | Moved to deps namespace           |
 | `noExternal: [...]`        | `deps: { alwaysBundle: [...] }` | Moved to deps namespace           |
-| `skipNodeModulesBundle`    | `deps: { neverBundle: true }`   | Externalize all dependencies      |
 
 tsdown also adds `deps.onlyBundle` for whitelisting allowed bundled packages.
 

docs/options/dependencies.md

@@ -37,12 +37,6 @@ export default defineConfig({
 })
 ```
 
-### `deps.skipNodeModulesBundle`
-
-::: warning Deprecated
-`skipNodeModulesBundle` is deprecated. Use [`deps.neverBundle: true`](#externalizing-all-dependencies) instead.
-:::
-
 ### `deps.resolveDepSubpath`
 
 By default, tsdown preserves external dependency subpath imports as written. Enable `resolveDepSubpath` to resolve subpath imports to their actual package-relative paths when a package has no `exports` field. For example, `my-dep/functions/lt` may become `my-dep/functions/lt.js`, and `my-dep/folder` may become `my-dep/folder/index.js`.
@@ -144,12 +138,12 @@ export default defineConfig({
 })
 ```
 
-When enabled, every import that follows npm package naming conventions (e.g. `lodash`, `@scope/pkg/utils`) is marked as external **as written, without being resolved**. This is faster than the deprecated `skipNodeModulesBundle` option and even works when dependencies are not installed. Note the following behaviors:
+When enabled, every import that follows npm package naming conventions (e.g. `lodash`, `@scope/pkg/utils`) is marked as external **as written, without being resolved**. This is fast and even works when dependencies are not installed. Note the following behaviors:
 
 - Package specifiers are preserved exactly as written; subpaths like `my-dep/utils` are not rewritten, and `resolveDepSubpath` has no effect.
 - Other non-relative imports — [subpath imports](https://nodejs.org/api/packages.html#subpath-imports) starting with `#` and path aliases like `~/utils` — are still resolved: if they resolve into `node_modules`, they are kept external with the original specifier; otherwise the resolved local file is bundled.
 
-Unlike the deprecated `skipNodeModulesBundle` option, `neverBundle: true` can be combined with `alwaysBundle` to bundle a few selected dependencies while externalizing everything else:
+`neverBundle: true` can be combined with `alwaysBundle` to bundle a few selected dependencies while externalizing everything else:
 
 ```ts [tsdown.config.ts]
 import { defineConfig } from 'tsdown'
@@ -202,13 +196,11 @@ export default defineConfig({
 
 The following top-level options are deprecated. Please migrate to the `deps` namespace:
 
-| Deprecated Option            | New Option               |
-| ---------------------------- | ------------------------ |
-| `external`                   | `deps.neverBundle`       |
-| `noExternal`                 | `deps.alwaysBundle`      |
-| `inlineOnly`                 | `deps.onlyBundle`        |
-| `skipNodeModulesBundle`      | `deps.neverBundle: true` |
-| `deps.skipNodeModulesBundle` | `deps.neverBundle: true` |
+| Deprecated Option | New Option          |
+| ----------------- | ------------------- |
+| `external`        | `deps.neverBundle`  |
+| `noExternal`      | `deps.alwaysBundle` |
+| `inlineOnly`      | `deps.onlyBundle`   |
 
 ## Summary
 

docs/reference/cli.md

@@ -74,12 +74,6 @@ Mark a module as external. This prevents the specified module from being include
 
 See also [Dependencies](../options/dependencies.md).
 
-## `--deps.skip-node-modules-bundle`
-
-Skip resolving and bundling all dependencies from `node_modules`.
-
-See also [Dependencies](../options/dependencies.md).
-
 ## `--external <module>` {#external}
 
 ::: warning Deprecated

docs/zh-CN/guide/migrate-from-tsup.md

@@ -54,11 +54,12 @@ npx tsdown-migrate packages/foo packages/bar
 
 部分选项已重命名以提高清晰度：
 
-| tsup             | tsdown          | 说明                          |
-| ---------------- | --------------- | ----------------------------- |
-| `cjsInterop`     | `cjsDefault`    | CJS 默认导出处理              |
-| `esbuildPlugins` | `plugins`       | 现使用 Rolldown/Unplugin 插件 |
-| `outExtension`   | `outExtensions` | 自定义输出扩展名              |
+| tsup                    | tsdown                        | 说明                          |
+| ----------------------- | ----------------------------- | ----------------------------- |
+| `cjsInterop`            | `cjsDefault`                  | CJS 默认导出处理              |
+| `esbuildPlugins`        | `plugins`                     | 现使用 Rolldown/Unplugin 插件 |
+| `outExtension`          | `outExtensions`               | 自定义输出扩展名              |
+| `skipNodeModulesBundle` | `deps: { neverBundle: true }` | 外部化所有依赖                |
 
 ### 已弃用但兼容的选项
 
@@ -73,7 +74,6 @@ npx tsdown-migrate packages/foo packages/bar
 | `injectStyle: true`        | `css: { inject: true }`         | 移入 CSS 命名空间      |
 | `external: [...]`          | `deps: { neverBundle: [...] }`  | 移入 deps 命名空间     |
 | `noExternal: [...]`        | `deps: { alwaysBundle: [...] }` | 移入 deps 命名空间     |
-| `skipNodeModulesBundle`    | `deps: { neverBundle: true }`   | 外部化所有依赖         |
 
 tsdown 还新增了 `deps.onlyBundle`，用于白名单指定允许打包的依赖。
 

docs/zh-CN/options/dependencies.md

@@ -37,12 +37,6 @@ export default defineConfig({
 })
 ```
 
-### `deps.skipNodeModulesBundle`
-
-::: warning 已废弃
-`skipNodeModulesBundle` 已废弃，请使用 [`deps.neverBundle: true`](#外部化所有依赖) 代替。
-:::
-
 ### `deps.resolveDepSubpath`
 
 默认情况下，tsdown 会保留外部依赖原有的子路径导入。当依赖没有 `exports` 字段时，可以启用 `resolveDepSubpath`，将子路径导入解析为包内的实际相对路径。例如，`my-dep/functions/lt` 可能会变为 `my-dep/functions/lt.js`，而 `my-dep/folder` 可能会变为 `my-dep/folder/index.js`。
@@ -144,12 +138,12 @@ export default defineConfig({
 })
 ```
 
-启用后，所有符合 npm 包名规范的导入（例如 `lodash`、`@scope/pkg/utils`）都会**按原样标记为外部依赖，不会进行解析**。这比已废弃的 `skipNodeModulesBundle` 选项更快，即使依赖没有安装也能正常工作。请注意以下行为：
+启用后，所有符合 npm 包名规范的导入（例如 `lodash`、`@scope/pkg/utils`）都会**按原样标记为外部依赖，不会进行解析**。这一过程非常快速，即使依赖没有安装也能正常工作。请注意以下行为：
 
 - 包说明符会按原样保留；`my-dep/utils` 这类子路径不会被改写，`resolveDepSubpath` 选项不生效。
 - 其他非相对导入——以 `#` 开头的[子路径导入](https://nodejs.org/api/packages.html#subpath-imports)和 `~/utils` 这类路径别名——仍会被解析：如果解析结果位于 `node_modules` 中，则保留原始说明符并外部化；否则打包解析到的本地文件。
 
-与已废弃的 `skipNodeModulesBundle` 选项不同，`neverBundle: true` 可以与 `alwaysBundle` 组合使用，在外部化其他所有依赖的同时打包少数指定依赖：
+`neverBundle: true` 可以与 `alwaysBundle` 组合使用，在外部化其他所有依赖的同时打包少数指定依赖：
 
 ```ts [tsdown.config.ts]
 import { defineConfig } from 'tsdown'
@@ -202,13 +196,11 @@ export default defineConfig({
 
 以下顶层选项已被废弃，请迁移到 `deps` 命名空间：
 
-| 废弃选项                     | 新选项                   |
-| ---------------------------- | ------------------------ |
-| `external`                   | `deps.neverBundle`       |
-| `noExternal`                 | `deps.alwaysBundle`      |
-| `inlineOnly`                 | `deps.onlyBundle`        |
-| `skipNodeModulesBundle`      | `deps.neverBundle: true` |
-| `deps.skipNodeModulesBundle` | `deps.neverBundle: true` |
+| 废弃选项     | 新选项              |
+| ------------ | ------------------- |
+| `external`   | `deps.neverBundle`  |
+| `noExternal` | `deps.alwaysBundle` |
+| `inlineOnly` | `deps.onlyBundle`   |
 
 ## 总结
 

docs/zh-CN/reference/cli.md

@@ -74,12 +74,6 @@ tsdown --tsconfig tsconfig.build.json
 
 另请参阅 [依赖处理](../options/dependencies.md)。
 
-## `--deps.skip-node-modules-bundle`
-
-跳过解析和打包所有来自 `node_modules` 的依赖。
-
-另请参阅 [依赖处理](../options/dependencies.md)。
-
 ## `--external <module>` {#external}
 
 ::: warning 已废弃

skills/tsdown-migrate/SKILL.md

@@ -86,7 +86,7 @@ These tsup options still work in tsdown for backward compatibility, but emit dep
 | `injectStyle: false` | _(remove)_ | Default behavior |
 | `external: [...]` | `deps: { neverBundle: [...] }` | Moved to deps namespace |
 | `noExternal: [...]` | `deps: { alwaysBundle: [...] }` | Moved to deps namespace |
-| `skipNodeModulesBundle` | `deps: { neverBundle: true }` | Externalize all dependencies |
+| `skipNodeModulesBundle` | `deps: { neverBundle: true }` | Removed; externalize all dependencies |
 
 ### Output Filename Differences