@voidzero-dev/vite-plus-core 0.1.21-alpha.2 → 0.1.21-alpha.4

package/dist/tsdown/index-types.d.ts

@@ -1,6 +1,5 @@
 import * as Rolldown from "@voidzero-dev/vite-plus-core/rolldown";
 import { BuildOptions, ChecksOptions, ExternalOption, InputOptions, InternalModuleFormat, MinifyOptions, ModuleFormat, ModuleTypes, OutputAsset, OutputChunk, OutputOptions, Plugin, RolldownPlugin, TreeshakingOptions } from "@voidzero-dev/vite-plus-core/rolldown";
-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";
@@ -8,10 +7,11 @@ 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 { IsolatedDeclarationsOptions } from "@voidzero-dev/vite-plus-core/rolldown/experimental";
 import { Options as UnusedOptions } from "unplugin-unused";
 
-//#region ../../node_modules/.pnpm/tsdown@0.21.10_@arethetypeswrong+core@0.18.2_@tsdown+css@0.21.10_@tsdown+exe@0.21.10_@t_1dda983e987248a6524e731dd43b2076/node_modules/tsdown/dist/index-DraNj4FA.d.mts
+//#region ../../node_modules/.pnpm/tsdown@0.22.0_@arethetypeswrong+core@0.18.2_@tsdown+css@0.22.0_@tsdown+exe@0.22.0_@type_65ddfddc5f00cd757c3739c1cdd4e920/node_modules/tsdown/dist/index-CTZ4qxd_.d.mts
 //#region src/utils/types.d.ts
 type Overwrite<T, U> = Omit<T, keyof U> & U;
 type Awaitable<T> = T | Promise<T>;
@@ -37,7 +37,9 @@ interface Logger {
   clearScreen: (type: LogType) => void;
 }
 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.
@@ -331,7 +333,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}.
@@ -396,7 +399,7 @@ declare global {
 }
 /** @deprecated */
 //#endregion
-//#region ../../node_modules/.pnpm/get-tsconfig@4.13.7/node_modules/get-tsconfig/dist/index.d.cts
+//#region ../../node_modules/.pnpm/get-tsconfig@5.0.0-beta.5/node_modules/get-tsconfig/dist/index.d.mts
 declare namespace TsConfigJson {
   namespace CompilerOptions {
     type JSX = 'preserve' | 'react' | 'react-jsx' | 'react-jsxdev' | 'react-native';
@@ -1145,7 +1148,7 @@ type TsConfigJson = {
   references?: TsConfigJson.References[];
 };
 //#endregion
-//#region ../../node_modules/.pnpm/rolldown-plugin-dts@0.23.2_@typescript+native-preview@7.0.0-dev.20260122.2_oxc-resolver_766394248e9ecd4faca560651c4c5680/node_modules/rolldown-plugin-dts/dist/index.d.mts
+//#region ../../node_modules/.pnpm/rolldown-plugin-dts@0.25.0_@typescript+native-preview@7.0.0-dev.20260122.2_oxc-resolver_b3cc7660f16ac76b66135f298381de19/node_modules/rolldown-plugin-dts/dist/index.d.mts
 //#region src/options.d.ts
 interface GeneralOptions {
   /**
@@ -1345,7 +1348,7 @@ interface TsgoOptions {
   path?: string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/tsdown@0.21.10_@arethetypeswrong+core@0.18.2_@tsdown+css@0.21.10_@tsdown+exe@0.21.10_@t_1dda983e987248a6524e731dd43b2076/node_modules/tsdown/dist/types-BZNNnDKc.d.mts
+//#region ../../node_modules/.pnpm/tsdown@0.22.0_@arethetypeswrong+core@0.18.2_@tsdown+css@0.22.0_@tsdown+exe@0.22.0_@type_65ddfddc5f00cd757c3739c1cdd4e920/node_modules/tsdown/dist/types-CQaSBA5U.d.mts
 //#region src/features/copy.d.ts
 interface CopyEntry {
   /**
@@ -1390,7 +1393,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;
   /**
@@ -1408,13 +1412,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
   */
@@ -1463,18 +1467,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>;
 } //#endregion
@@ -1518,7 +1535,9 @@ type PackageType = "module" | "commonjs" | undefined; //#endregion
 interface OutExtensionContext {
   options: InputOptions;
   format: NormalizedFormat;
-  /** "type" field in project's package.json */
+  /**
+  * `"type"` field in project's `package.json`.
+  */
   pkgType?: PackageType;
 }
 interface OutExtensionObject {
@@ -1582,6 +1601,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 & {}))[];
 } //#endregion
@@ -1589,17 +1612,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;
   /**
@@ -1609,7 +1657,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)[];
   /**
@@ -1626,10 +1676,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
@@ -1649,7 +1701,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
@@ -1669,19 +1721,62 @@ interface ExportsOptions {
   */
   extensions?: boolean;
   /**
-  * Auto-generate the `bin` field in package.json.
-  *
-  * - `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.
+  * Generate the `bin` field in `package.json` for CLI executables.
+  *
+  * 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>;
 } //#endregion
@@ -1691,8 +1786,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.
@@ -1702,18 +1797,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>;
@@ -1722,18 +1818,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;
@@ -1756,7 +1854,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;
 }
@@ -1806,10 +1904,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>;
   /**
@@ -1819,7 +1919,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.
@@ -1835,6 +1938,8 @@ interface UserConfig {
   *   "hooks/*": ["./src/hooks/*.ts", "!./src/hooks/index.ts"],
   * }
   * ```
+  *
+  * @default { index: 'src/index.ts'}
   */
   entry?: TsdownInputOption;
   /**
@@ -1842,23 +1947,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.
@@ -1911,6 +2019,8 @@ interface UserConfig {
   *   "NODE_ENV": "production"
   * }
   * ```
+  *
+  * @default {}
   */
   env?: Record<string, any>;
   /**
@@ -1925,7 +2035,9 @@ interface UserConfig {
   */
   envPrefix?: string | string[];
   define?: Record<string, string>;
-  /** @default false */
+  /**
+  * @default false
+  */
   shims?: boolean;
   /**
   * Configure tree shaking options.
@@ -1939,36 +2051,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;
   /**
@@ -1998,11 +2144,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.
@@ -2014,7 +2162,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
@@ -2034,8 +2182,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;
@@ -2049,7 +2197,7 @@ interface UserConfig {
   */
   root?: string;
   /**
-  * @deprecated Use `unbundle` instead.
+  * @deprecated Use {@linkcode unbundle} instead.
   * @default true
   */
   bundle?: boolean;
@@ -2058,12 +2206,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;
   /**
@@ -2083,8 +2234,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;
   /**
@@ -2123,7 +2276,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.
   *
@@ -2138,7 +2291,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.
   */
@@ -2150,7 +2303,7 @@ interface UserConfig {
   */
   unused?: WithEnabled<UnusedOptions>;
   /**
-  * Run publint after bundling.
+  * Run `publint` after bundling.
   * Requires `publint` to be installed.
   * @default false
   */
@@ -2179,19 +2332,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;
   /**
@@ -2214,6 +2370,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>;
   /**
@@ -2231,7 +2389,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.
   */
@@ -2243,7 +2401,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;
@@ -2253,7 +2417,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;
@@ -2267,7 +2434,7 @@ type ResolvedConfig = Overwrite<MarkPartial<Omit<UserConfig, "workspace" | "from
   exe: false | ExeOptions;
 }>; //#endregion
 //#endregion
-//#region ../../node_modules/.pnpm/tsdown@0.21.10_@arethetypeswrong+core@0.18.2_@tsdown+css@0.21.10_@tsdown+exe@0.21.10_@t_1dda983e987248a6524e731dd43b2076/node_modules/tsdown/dist/config-CuK0i1Bc.d.mts
+//#region ../../node_modules/.pnpm/tsdown@0.22.0_@arethetypeswrong+core@0.18.2_@tsdown+css@0.22.0_@tsdown+exe@0.22.0_@type_65ddfddc5f00cd757c3739c1cdd4e920/node_modules/tsdown/dist/config-BWeUm0f3.d.mts
 //#region src/config/options.d.ts
 /**
 * Resolve user config into resolved configs
@@ -2287,7 +2454,7 @@ declare function defineConfig(options: UserConfig[]): UserConfig[];
 declare function defineConfig(options: UserConfigFn): UserConfigFn;
 declare function defineConfig(options: UserConfigExport): UserConfigExport; //#endregion
 //#endregion
-//#region ../../node_modules/.pnpm/tsdown@0.21.10_@arethetypeswrong+core@0.18.2_@tsdown+css@0.21.10_@tsdown+exe@0.21.10_@t_1dda983e987248a6524e731dd43b2076/node_modules/tsdown/dist/index.d.mts
+//#region ../../node_modules/.pnpm/tsdown@0.22.0_@arethetypeswrong+core@0.18.2_@tsdown+css@0.22.0_@tsdown+exe@0.22.0_@type_65ddfddc5f00cd757c3739c1cdd4e920/node_modules/tsdown/dist/index.d.mts
 //#region src/build.d.ts
 /**
 * Build with tsdown.