feat(css)!: change default sass api to modern/modern-compiler (#484)

fixes #484.

Author: hi-ogawa

docs/config/shared-options.md

@@ -228,9 +228,12 @@ Hinweis: Wenn eine Inline-Konfiguration bereitgestellt wird, sucht Vite nicht na
 
 Geben Sie Optionen an, die an CSS-Präprozessoren übergeben werden sollen. Die Dateierweiterungen werden als Schlüssel für die Optionen verwendet. Die unterstützten Optionen für jeden Präprozessor finden Sie in der jeweiligen Dokumentation:
 
-- `sass`/`scss` - die Top-Level-Option `api: „legacy„ | ‚modern‘ | ‚modern-compiler‘` (Voreinstellung `“legacy"`) erlaubt es, die zu verwendende Sass-API zu wechseln. Für die beste Leistung wird die Verwendung von `api: „modern-compiler"` mit `sass-embedded` Paket. [Optionen (legacy)](https://sass-lang.com/documentation/js-api/interfaces/LegacyStringOptions), [Optionen (modern)](https://sass-lang.com/documentation/js-api/interfaces/stringoptions/).
-- `less` - [Optionen](https://lesscss.org/usage/#less-options).
-- `styl`/`stylus` - Nur [`define`](https://stylus-lang.com/docs/js.html#define-name-node) wird unterstützt, das als Objekt übergeben werden kann.
+- sass"/"scss":
+  - Wählen Sie die zu verwendende Sass-API mit `api: "modern-compiler" | "modern" | "legacy"` (Standard `"modern-compiler"` wenn `sass-embedded` installiert ist, sonst `"modern"`). Für die beste Leistung wird die Verwendung von `api: "modern-compiler"` mit dem `sass-embedded` Paket zu verwenden. Die `"legacy"` API ist veraltet und wird in Vite 7 entfernt werden.
+  - [Optionen (modern)](https://sass-lang.com/documentation/js-api/interfaces/stringoptions/)
+  - [Optionen (legacy)](https://sass-lang.com/documentation/js-api/interfaces/LegacyStringOptions).
+- `less`: [Optionen](https://lesscss.org/usage/#less-options).
+- `styl`/`stylus`: Nur [`define`](https://stylus-lang.com/docs/js.html#define-name-node) wird unterstützt, das als Objekt übergeben werden kann.
 
 **Beispiel:**
 

docs/guide/migration.md

@@ -20,6 +20,14 @@ Ab Vite 6 wird `json.namedExports` auch dann nicht deaktiviert, wenn `json.strin
 
 Vite 6 führt auch einen neuen Standardwert für `json.stringify` ein, nämlich `'auto'`, der nur große JSON-Dateien stringifizieren wird. Um dieses Verhalten zu deaktivieren, setzen Sie `json.stringify: false`.
 
+### Sass verwendet jetzt standardmäßig die moderne API
+
+In Vite 5 wurde standardmäßig die Legacy-API für Sass verwendet. Vite 5.4 fügte Unterstützung für die moderne API hinzu.
+
+Ab Vite 6 wird die moderne API standardmäßig für Sass verwendet. Wenn Sie weiterhin die Legacy-API verwenden möchten, können Sie [`css.preprocessorOptions.sass.api: 'legacy'` / `css.preprocessorOptions.scss.api: 'legacy'`](/config/shared-options#css-preprocessoroptions) einstellen. Beachten Sie jedoch, dass die Unterstützung der Legacy-API in Vite 7 entfernt wird.
+
+Um auf die moderne API umzusteigen, siehe [die Sass-Dokumentation](https://sass-lang.com/documentation/breaking-changes/legacy-js-api/).
+
 ## Erweitert
 
 Es gibt weitere Änderungen, die nur wenige Benutzer betreffen.