refactor: deprecate esbuild / optimizeDeps.esbuild options (#355)

Author: sapphi-red

packages/vite/src/node/config.ts

@@ -372,6 +372,8 @@ export interface UserConfig extends DefaultEnvironmentOptions {
   /**
    * Transform options to pass to esbuild.
    * Or set to `false` to disable esbuild.
+   *
+   * @deprecated Use `oxc` option instead.
    */
   esbuild?: ESBuildOptions | false
   /**
@@ -626,6 +628,7 @@ export interface ResolvedConfig
       plugins: readonly Plugin[]
       css: ResolvedCSSOptions
       json: Required<JsonOptions>
+      /** @deprecated Use `oxc` option instead. */
       esbuild: ESBuildOptions | false
       oxc: OxcOptions | false
       server: ResolvedServerOptions

packages/vite/src/node/optimizer/index.ts

@@ -95,6 +95,8 @@ export interface DepOptimizationConfig {
    * - `plugins` are merged with Vite's dep plugin
    *
    * https://esbuild.github.io/api
+   *
+   * @deprecated Use `rolldownOptions` instead.
    */
   esbuildOptions?: DepsOptimizerEsbuildOptions
   /**
@@ -106,6 +108,14 @@ export interface DepOptimizationConfig {
       'format' | 'sourcemap' | 'dir' | 'banner'
     >
   }
+  /**
+   * Options to pass to rolldown during the dep scanning and optimization
+   *
+   * Certain options are omitted since changing them would not be compatible
+   * with Vite's dep optimization.
+   *
+   * - `plugins` are merged with Vite's dep plugin
+   */
   rolldownOptions?: Omit<RolldownOptions, 'input' | 'logLevel' | 'output'> & {
     output?: Omit<
       RolldownOutputOptions,