docs: migration guide (#1291) (#1542)

Co-authored-by: Rush Ali <s0aPii.ra@googlemail.com>

closes #1291 #1542

Author: mstelbrink

docs/config/build-options.md

@@ -123,10 +123,10 @@ Es sollte nur verwendet werden, wenn Sie einen nicht-mainstream Browser anvisier
 
 ## build.cssMinify
 
-- **Typ:** `boolean | 'esbuild' | 'lightningcss'`
-- **Standard:** dasselbe wie [`build.minify`](#build-minify) für Clients, `'esbuild'` für SSR
+- **Typ:** `boolean | 'lightningcss' | 'esbuild'`
+- **Standard:** dasselbe wie [`build.minify`](#build-minify) für Clients, `'lightningcss'` für SSR
 
-Diese Option ermöglicht es Benutzern, die CSS-Minimierung speziell zu überschreiben, anstatt auf die Standardwerte von `build.minify` zurückzugreifen. Vite verwendet standardmäßig `esbuild` zur Minimierung von CSS. Setzen Sie die Option auf `'lightningcss'`, um stattdessen [Lightning CSS](https://lightningcss.dev/minification.html) zu verwenden. Wenn ausgewählt, kann es mit [`css.lightningcss`](./shared-options.md#css-lightningcss) konfiguriert werden.
+Diese Option ermöglicht es Benutzern, die CSS-Minimierung speziell zu überschreiben, anstatt auf die Standardwerte von `build.minify` zurückzugreifen. Dadurch können Sie die Minimierung für JS und CSS unabhängig voneinander konfigurieren. Vite verwendet standardmäßig [Lightning CSS](https://lightningcss.dev/minification.html), um CSS zu minimieren. Es kann mit [`css.lightningcss`](./shared-options.md#css-lightningcss) konfiguriert werden. Setzen sie die Option auf `'esbuild'`, um esbuild stattdessen zu verwenden.
 
 ## build.sourcemap
 
@@ -255,16 +255,19 @@ Während des SSR-Builds werden statische Assets nicht ausgegeben, da davon ausge
 
 ## build.minify
 
-- **Typ:** `boolean | 'terser' | 'esbuild'`
-- **Standard:** 'esbuild' für Client-Build, 'false' für SSR-Build
+- **Typ:** `boolean | 'oxc' | 'terser' | 'esbuild'`
+- **Standard:** 'oxc' für Client-Build, 'false' für SSR-Build
 
-Setzen Sie dies auf `false`, um die Minimierung zu deaktivieren, oder geben Sie den Minimierer an, der verwendet werden soll. Die Standardeinstellung ist [esbuild](https://github.com/evanw/esbuild), das 20 ~ 40x schneller als terser ist und nur eine 1 ~ 2% schlechtere Komprimierung bietet. [Benchmarks](https://github.com/privatenumber/minification-benchmarks)
+Setzen Sie dies auf `false`, um die Minimierung zu deaktivieren, oder geben Sie den Minimierer an, der verwendet werden soll. Die Standardeinstellung ist [Oxc Minimierer](https://oxc.rs/docs/guide/usage/minifier), das 30 ~ 90x schneller als terser ist und nur eine 0,5 ~ 2% schlechtere Komprimierung bietet. [Benchmarks](https://github.com/privatenumber/minification-benchmarks)
+
+`build.minify: 'esbuild'` ist veraltet und wird in der Zukunft entfernt.
 
 Beachten Sie, dass die Option `build.minify` keine Leerzeichen minimiert, wenn das Format `'es'` im Lib-Modus verwendet wird, da es reine Anmerkungen entfernt und Tree-Shaking bricht.
 
-Terser muss installiert sein, wenn es auf `'terser'` eingestellt ist.
+esbuild oder Terser müssen installiert sein, wenn der Wert auf `'esbuild'` oder `'terser'` gesetzt ist.
 
 ```sh
+npm add -D esbuild
 npm add -D terser
 ```
 

docs/config/dep-optimization-options.md

@@ -47,6 +47,23 @@ export default defineConfig({
 })
 ```
 
+## optimizeDeps.rolldownOptions <NonInheritBadge />
+
+- **Typ:** [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<``RolldownOptions`, `'input' | 'logLevel' | 'output'> & {
+  output?: [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<`
+    `RolldownOutputOptions`,
+    `'format' | 'sourcemap' | 'dir' | 'banner'>`
+`}`
+
+<!-- TODO: add link to RolldownOptions -->
+<!-- TODO: add link to RolldownOutputOptions -->
+
+Optionen die an Rolldown übergeben werden, während die Abhängigkeiten gescannt und optimiert werden.
+
+Bestimmte Optionen werden ausgelassen, da eine Änderungen an ihnen nicht kompatibel mit der Abhängigkeitsoptimierung von Vite wäre.
+
+- `plugins` werden mit dem Abhängigkeits-Plugin von Vite zusammengeführt
+
 ## optimizeDeps.esbuildOptions <NonInheritBadge />
 
 - **Typ:** [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<`[`EsbuildBuildOptions`](https://esbuild.github.io/api/#general-options)`,
@@ -60,13 +77,9 @@ export default defineConfig({
 | 'outbase'
 | 'outExtension'
 | 'metafile'>`
+- **Veraltet**
 
-Optionen, die an esbuild während des Abhängigkeits-Scannens und der Optimierung übergeben werden sollen.
-
-Bestimmte Optionen werden ausgelassen, da ihre Änderung nicht mit der Abhängigkeitsoptimierung von Vite kompatibel wäre.
-
-- `external` wird ebenfalls ausgelassen, verwenden Sie Vites `optimizeDeps.exclude`-Option
-- `plugins` werden mit dem Abhängigkeits-Plugin von Vite zusammengeführt
+Diese Option ist intern zu `optimizeDeps.rolldownOptions` konvertiert. Nutzen Sie `optimizeDeps.rolldownOptions` stattdessen.
 
 ## optimizeDeps.force <NonInheritBadge />
 

docs/config/shared-options.md

@@ -354,36 +354,44 @@ Wenn auf `true` gesetzt, wird importiertes JSON in `export default JSON.parse(".
 
 Bei der Einstellung `'auto'` werden die Daten nur dann stringifiziert, wenn [die Daten größer als 10kB sind](https://v8.dev/blog/cost-of-javascript-2019#json:~:text=A%20good%20rule%20of%20thumb%20is%20to%20apply%20this%20technique%20for%20objects%20of%2010%20kB%20or%20larger).
 
-## esbuild
+## oxc
 
-- **Typ:** `ESBuildOptions | false`
+- **Typ:** `OxcOptions | false`
 
-`ESBuildOptions` erweitert [die eigenen Transformationsoptionen von esbuild](https://esbuild.github.io/api/#transform). Der häufigste Anwendungsfall ist die Anpassung von JSX:
+`OxcOptions` erweitert [die Transformationsoptionen von Oxc](https://oxc.rs/docs/guide/usage/transformer). Der häufigste Anwendungsfall ist die Anpassung von JSX:
 
 ```js
 export default defineConfig({
-  esbuild: {
-    jsxFactory: 'h',
-    jsxFragment: 'Fragment',
+  oxc: {
+    jsx: {
+      runtime: 'classic',
+      pragma: 'h',
+      pragmaFrag: 'Fragment',
+    },
   },
 })
 ```
 
-Standardmäßig wird esbuild auf Dateien mit den Erweiterungen `ts`, `jsx` und `tsx` angewendet. Sie können dies mit `esbuild.include` und `esbuild.exclude` anpassen, die eine Regex, ein [picomatch-Muster](https://github.com/micromatch/picomatch#globbing-features) oder ein Array davon sein können.
+Standardmäßig wird die Transformation von Oxc auf Dateien mit den Erweiterungen `ts`, `jsx` und `tsx` angewendet. Sie können dies mit `oxc.include` und `oxc.exclude` anpassen, die eine Regex, ein [picomatch-Muster](https://github.com/micromatch/picomatch#globbing-features) oder ein Array davon sein können.
 
-Darüber hinaus können Sie auch `esbuild.jsxInject` verwenden, um automatisch JSX-Helper-Imports für jede von esbuild transformierte Datei einzufügen:
+Darüber hinaus können Sie auch `oxc.jsxInject` verwenden, um automatisch JSX-Helper-Imports für jede von Oxc transformierte Datei einzufügen:
 
 ```js
 export default defineConfig({
-  esbuild: {
+  oxc: {
     jsxInject: `import React from 'react'`,
   },
 })
 ```
 
-Wenn [`build.minify`](./build-options.md#build-minify) auf `true` gesetzt ist, werden standardmäßig alle Minify-Optimierungen angewendet. Um bestimmte Aspekte davon zu deaktivieren, setzen Sie eine der Optionen `esbuild.minifyIdentifiers`, `esbuild.minifySyntax` oder `esbuild.minifyWhitespace` auf `false`. Beachten Sie, dass die Option `esbuild.minify` nicht verwendet werden kann, um `build.minify` zu überschreiben.
+Auf `false` setzen, um die Oxc-Transformation zu deaktivieren.
+
+## esbuild
+
+- **Typ:** `ESBuildOptions | false`
+- **Veraltet**
 
-Auf `false` setzen, um esbuild-Transformationen zu deaktivieren.
+Diese Option wird intern zu `oxc` konvertiert. Verwenden Sie stattdessen die `oxc`-Option.
 
 ## assetsInclude
 
@@ -503,4 +511,4 @@ Weitere Informationen finden Sie im [SSR-Handbuch von Vite](/guide/ssr#vite-cli)
 
 Aktivieren Sie zukünftige grundlegende Änderungen, um eine reibungslose Migration zur nächsten Hauptversion von Vite vorzubereiten. Die Liste kann jederzeit aktualisiert, ergänzt oder gekürzt werden, wenn neue Funktionen entwickelt werden.
 
-Weitere Informationen zu den möglichen Optionen finden Sie auf der Seite [Grundlegende Änderungen](/changes/).
+Weitere Informationen zu den möglichen Optionen finden Sie auf der Seite [Grundlegende Änderungen](/changes/).