From 5f226cd37c19f1376df903a5598df3703c36dcf0 Mon Sep 17 00:00:00 2001 From: Matteo Stelbrink <147656301+mstelbrink@users.noreply.github.com> Date: Wed, 27 May 2026 18:16:57 +0200 Subject: [PATCH] docs: link to Rolldown docs (#1359) --- docs/config/build-options.md | 4 +-- docs/config/dep-optimization-options.md | 7 ++--- docs/guide/build.md | 4 --- docs/guide/migration.md | 36 ++++++++++--------------- 4 files changed, 17 insertions(+), 34 deletions(-) diff --git a/docs/config/build-options.md b/docs/config/build-options.md index 3b7b1e33..fac27087 100644 --- a/docs/config/build-options.md +++ b/docs/config/build-options.md @@ -220,9 +220,7 @@ Wenn `fileName` mit `.json` endet, werden die rohen JSON-Metadaten stattdessen g ::: tip -Falls Sie die Lizenzdatei im gebauten Code referenzieren möchten, können Sie `build.rolldownOptions.output.postBanner` nutzen, um einen Kommentar am Beginn der Dateien einzufügen. Zum Beispiel: - - +Falls Sie die Lizenzdatei im gebauten Code referenzieren möchten, können Sie [`build.rolldownOptions.output.postBanner`](https://rolldown.rs/reference/OutputOptions.postBanner#postbanner) nutzen, um einen Kommentar am Beginn der Dateien einzufügen. Zum Beispiel: ```js twoslash [vite.config.js] import { defineConfig } from 'vite' diff --git a/docs/config/dep-optimization-options.md b/docs/config/dep-optimization-options.md index a2d4834b..33ca0162 100644 --- a/docs/config/dep-optimization-options.md +++ b/docs/config/dep-optimization-options.md @@ -49,15 +49,12 @@ export default defineConfig({ ## optimizeDeps.rolldownOptions -- **Typ:** [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<``RolldownOptions`, `'input' | 'logLevel' | 'output'> & { +- **Typ:** [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<`[`RolldownOptions`](https://rolldown.rs/reference/), `'input' | 'logLevel' | 'output'> & { output?: [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)`<` - `RolldownOutputOptions`, + [`RolldownOutputOptions`](https://rolldown.rs/reference/), `'format' | 'sourcemap' | 'dir' | 'banner'>` `}` - - - 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. diff --git a/docs/guide/build.md b/docs/guide/build.md index 9e356e5c..21310167 100644 --- a/docs/guide/build.md +++ b/docs/guide/build.md @@ -42,8 +42,6 @@ Für erweiterte Steuerung des Basispfads siehe [Erweiterte Basisoptionen](#erwei Der Build kann über verschiedene [Build-Konfigurationsoptionen](/config/build-options.md) angepasst werden. Konkret können Sie die zugrunde liegenden [Rolldown-Optionen](https://rolldown.rs/reference/) direkt über `build.rolldownOptions` anpassen: - - ```js [vite.config.js] export default defineConfig({ build: { @@ -76,8 +74,6 @@ Bei einer neuen Bereitstellung kann der Hosting-Dienst die Assets aus früheren Sie können den Rollup Watcher mit `vite build --watch` aktivieren. Oder Sie können die zugrundeliegenden [`WatcherOptions`](https://rolldown.rs/reference/InputOptions.watch) direkt über `build.watch` anpassen: - - ```js [vite.config.js] export default defineConfig({ build: { diff --git a/docs/guide/migration.md b/docs/guide/migration.md index c70bd6ea..4f085473 100644 --- a/docs/guide/migration.md +++ b/docs/guide/migration.md @@ -38,19 +38,17 @@ Rolldown wird nun anstelle von esbuild für die Abhängigkeitsoptimierung verwen Die folgenden Optionen werden automatisch konvertiert: -- [`esbuildOptions.minify`](https://esbuild.github.io/api/#minify) -> `rolldownOptions.output.minify` -- [`esbuildOptions.treeShaking`](https://esbuild.github.io/api/#tree-shaking) -> `rolldownOptions.treeshake` -- [`esbuildOptions.define`](https://esbuild.github.io/api/#define) -> `rolldownOptions.transform.define` -- [`esbuildOptions.loader`](https://esbuild.github.io/api/#loader) -> `rolldownOptions.moduleTypes` -- [`esbuildOptions.preserveSymlinks`](https://esbuild.github.io/api/#preserve-symlinks) -> `!rolldownOptions.resolve.symlinks` -- [`esbuildOptions.resolveExtensions`](https://esbuild.github.io/api/#resolve-extensions) -> `rolldownOptions.resolve.extensions` -- [`esbuildOptions.mainFields`](https://esbuild.github.io/api/#main-fields) -> `rolldownOptions.resolve.mainFields` -- [`esbuildOptions.conditions`](https://esbuild.github.io/api/#conditions) -> `rolldownOptions.resolve.conditionNames` -- [`esbuildOptions.keepNames`](https://esbuild.github.io/api/#keep-names) -> `rolldownOptions.output.keepNames` -- [`esbuildOptions.platform`](https://esbuild.github.io/api/#platform) -> `rolldownOptions.platform` -- [`esbuildOptions.plugins`](https://esbuild.github.io/plugins/) -> `rolldownOptions.plugins` (teilweise Unterstützung) - - +- [`esbuildOptions.minify`](https://esbuild.github.io/api/#minify) -> [`rolldownOptions.output.minify`](https://rolldown.rs/reference/OutputOptions.minify) +- [`esbuildOptions.treeShaking`](https://esbuild.github.io/api/#tree-shaking) -> [`rolldownOptions.treeshake`](https://rolldown.rs/reference/InputOptions.treeshake) +- [`esbuildOptions.define`](https://esbuild.github.io/api/#define) -> [`rolldownOptions.transform.define`](https://rolldown.rs/reference/InputOptions.transform#define) +- [`esbuildOptions.loader`](https://esbuild.github.io/api/#loader) -> [`rolldownOptions.moduleTypes`](https://rolldown.rs/reference/InputOptions.moduleTypes) +- [`esbuildOptions.preserveSymlinks`](https://esbuild.github.io/api/#preserve-symlinks) -> [`!rolldownOptions.resolve.symlinks`](https://rolldown.rs/reference/InputOptions.resolve#symlinks) +- [`esbuildOptions.resolveExtensions`](https://esbuild.github.io/api/#resolve-extensions) -> [`rolldownOptions.resolve.extensions`](https://rolldown.rs/reference/InputOptions.resolve#extensions) +- [`esbuildOptions.mainFields`](https://esbuild.github.io/api/#main-fields) -> [`rolldownOptions.resolve.mainFields`](https://rolldown.rs/reference/InputOptions.resolve#mainfields) +- [`esbuildOptions.conditions`](https://esbuild.github.io/api/#conditions) -> [`rolldownOptions.resolve.conditionNames`](https://rolldown.rs/reference/InputOptions.resolve#conditionnames) +- [`esbuildOptions.keepNames`](https://esbuild.github.io/api/#keep-names) -> [`rolldownOptions.output.keepNames`](https://rolldown.rs/reference/OutputOptions.keepNames) +- [`esbuildOptions.platform`](https://esbuild.github.io/api/#platform) -> [`rolldownOptions.platform`](https://rolldown.rs/reference/InputOptions.platform) +- [`esbuildOptions.plugins`](https://esbuild.github.io/plugins/) -> [`rolldownOptions.plugins`](https://rolldown.rs/reference/InputOptions.plugins) (teilweise unterstützt) Sie können die von der Kompatibilitätsschicht festgelegten Optionen auch über den `configResolved`-Hook abrufen: @@ -98,8 +96,6 @@ const plugin = { }, ``` - - Derzeit unterstützt der Oxc-Transformer das Herunterkonvertieren nativer Dekoratoren nicht, da wir auf das Fortschreiten der Spezifikation warten, siehe([oxc-project/oxc#9170](https://github.com/oxc-project/oxc/issues/9170)). :::: details Workaround für das Herunterkonvertieren nativer Dekoratoren @@ -316,19 +312,15 @@ Weitere Informationen finden Sie in der Dokumentation von Rolldown: [`require` e ### `import.meta.url` in UMD / IIFE -`import.meta.url` wird in den Ausgabeformaten UMD / IIFE nicht länger polyfilled. Es wird standardmäßig durch `undefined` ersetzt. Wenn Sie das bisherige Verhalten bevorzugen, können Sie die Option `define` zusammen mit der Option `build.rolldownOptions.output.intro` verwenden. Weitere Details finden Sie in der Rolldown-Dokumentation: [Bekannte `import.meta`-Eigenschaften - Nicht-ESM-Ausgabeformate | Rolldown](https://rolldown.rs/in-depth/non-esm-output-formats#well-known-import-meta-properties). +`import.meta.url` wird in den Ausgabeformaten UMD / IIFE nicht länger polyfilled. Es wird standardmäßig durch `undefined` ersetzt. Wenn Sie das bisherige Verhalten bevorzugen, können Sie die Option [`define`](/config/shared-options#define) zusammen mit der Option [`build.rolldownOptions.output.intro`](https://rolldown.rs/reference/OutputOptions.intro) verwenden. Weitere Details finden Sie in der Rolldown-Dokumentation: [Bekannte `import.meta`-Eigenschaften - Nicht-ESM-Ausgabeformate | Rolldown](https://rolldown.rs/in-depth/non-esm-output-formats#well-known-import-meta-properties). ### Option `build.rollupOptions.watch.chokidar` entfernt -Die Option `build.rollupOptions.watch.chokidar` wurde entfernt. Bitte wechseln Sie zur Option `build.rolldownOptions.watch.notify`. - - +Die Option `build.rollupOptions.watch.chokidar` wurde entfernt. Bitte wechseln Sie zur Option [`build.rolldownOptions.watch.notify`](https://rolldown.rs/reference/InputOptions.watch#notify). ### Die Option `build.rollupOptions.output.manualChunks` ist veraltet -Die Option `output.manualChunks` ist veraltet. Rolldown verfügt über die flexiblere Option `advancedChunks`. Weitere Informationen zu `advancedChunks` finden Sie in der Dokumentation von Rolldown: [Advanced Chunks - Rolldown](https://rolldown.rs/in-depth/advanced-chunks). - - +Die Option `output.manualChunks` ist veraltet. Rolldown verfügt über die flexiblere Option [`advancedChunks`](https://rolldown.rs/reference/OutputOptions.advancedChunks). Weitere Informationen zu `advancedChunks` finden Sie in der Dokumentation von Rolldown: [Advanced Chunks - Rolldown](https://rolldown.rs/in-depth/advanced-chunks). ### Modultypunterstützung und automatische Erkennung