Merge branch 'main' into patch-15

rojadesign · web-flow · commit 06c8a75a985a · 2025-11-21T14:09:27.000+01:00
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
@@ -270,16 +270,25 @@ export default defineConfig({
     sidebar: {
       '/guide/': [
         {
-          text: 'Leitfaden',
+          text: 'Einführung',
           items: [
-            {
-              text: 'Wieso Vite?',
-              link: '/guide/why',
-            },
             {
               text: 'Erste Schritte',
               link: '/guide/',
             },
+            {
+              text: 'Projekt-Philosophie',
+              link: '/guide/philosophy',
+            },
+            {
+              text: 'Wieso Vite?',
+              link: '/guide/why',
+            },
+          ],
+        },
+        {
+          text: 'Guide',
+          items: [
             {
               text: 'Funktionen',
               link: '/guide/features',
@@ -329,8 +338,8 @@ export default defineConfig({
               link: '/guide/performance',
             },
             {
-              text: 'Projekt-Philosophie',
-              link: '/guide/philosophy',
+              text: 'Rolldown',
+              link: '/guide/rolldown',
             },
             {
               text: 'Migration von v4',
diff --git a/docs/.vitepress/theme/composables/sponsor.ts b/docs/.vitepress/theme/composables/sponsor.ts
@@ -39,12 +39,6 @@ const viteSponsors: Pick<Sponsors, 'special' | 'gold'> = {
       url: 'https://nuxtlabs.com',
       img: '/nuxtlabs.svg',
     },
-    // sponsors bluwy
-    {
-      name: 'Astro',
-      url: 'https://astro.build',
-      img: '/astro.svg',
-    },
   ],
   gold: [
     // now automated via sponsors.vuejs.org too
diff --git a/docs/_data/team.js b/docs/_data/team.js
@@ -45,7 +45,7 @@ export const core = [
     avatar: 'https://github.com/bluwy.png',
     name: 'Bjorn Lu',
     title: 'Open Source Developer',
-    desc: 'Vite, Astro, and Svelte core team member.',
+    desc: 'Building tools for fun.',
     links: [
       { icon: 'github', link: 'https://github.com/bluwy' },
       { icon: 'bluesky', link: 'https://bsky.app/profile/bluwy.me' },
diff --git a/docs/config/build-options.md b/docs/config/build-options.md
@@ -186,15 +186,19 @@ export default defineConfig({
 - **Standard:** `false`
 - **Verwandt:** [Backend-Integration](/guide/backend-integration)
 
-Wenn auf `true` gesetzt, wird der Build auch eine `.vite/manifest.json`-Datei generieren, die eine Zuordnung von nicht gehashten Asset-Dateinamen zu ihren gehashten Versionen enthält, die dann von einem Server-Framework verwendet werden kann, um die richtigen Asset-Links zu rendern. Wenn der Wert eine Zeichenkette ist, wird er als Name der Manifestdatei verwendet.
+Legt fest, ob eine Manifestdatei erstellt werden soll, die eine Zuordnung von nicht gehashten Dateinamen von Assets zu ihren gehashten Versionen enthält, die dann von einem Server-Framework verwendet werden kann, um die richtigen Asset-Links zu rendern.
+
+Wenn der Wert eine Zeichenfolge ist, wird er als Manifestdateipfad relativ zu `build.outDir` verwendet. Bei der Einstellung `true` lautet der Pfad `.vite/manifest.json`.
 
 ## build.ssrManifest
 
 - **Typ:** `boolean | string`
 - **Standard:** `false`
 - **Verwandt:** [Server-seitiges Rendern](/guide/ssr)
 
-Wenn auf `true` gesetzt, wird der Build auch ein SSR-Manifest generieren, um Style-Links und Asset-Preload-Anweisungen in der Produktion zu bestimmen. Wenn der Wert eine Zeichenkette ist, wird er als Name der Manifestdatei verwendet.
+Legt fest, ob eine SSR-Manifestdatei zur Bestimmung von Stilverknüpfungen und Anweisungen zum Vorladen von Assets in der Produktion generiert werden soll.
+
+Wenn der Wert eine Zeichenfolge ist, wird er als Manifestdateipfad relativ zu `build.outDir` verwendet. Bei der Einstellung `true` lautet der Pfad `.vite/ssr-manifest.json`.
 
 ## build.ssr
 
diff --git a/docs/config/preview-options.md b/docs/config/preview-options.md
@@ -60,9 +60,9 @@ Setzen Sie dies auf `true`, um den Vorgang zu beenden, wenn der Port bereits ver
 - **Typ:** `https.ServerOptions`
 - **Standardwert:** [`server.https`](./server-options#server-https)
 
-Aktivieren Sie TLS + HTTP/2. Beachten Sie, dass dies auf TLS allein downgradet, wenn auch die [`server.proxy`-Option](./server-options#server-proxy) verwendet wird.
+Aktivieren Sie TLS + HTTP/2.
 
-Der Wert kann auch ein [Optionsobjekt](https://nodejs.org/api/https.html#https_https_createserver_options_requestlistener) sein, das an `https.createServer()` übergeben wird.
+Siehe [`server.https`](./server-options#server-https) für mehr Details.
 
 ## preview.open
 
diff --git a/docs/config/server-options.md b/docs/config/server-options.md
@@ -90,9 +90,9 @@ Legen Sie fest, dass der Server bei Verwendung des Ports bereits in Verwendung i
 
 - **Typ:** `https.ServerOptions`
 
-Aktivieren Sie TLS + HTTP/2. Beachten Sie, dass dies auf TLS herabgestuft wird, wenn die [`server.proxy`-Option](#server-proxy) ebenfalls verwendet wird.
+Aktivieren Sie TLS + HTTP/2. Der Wert ist ein [Option-Objekt](https://nodejs.org/api/https.html#https_https_createserver_options_requestlistener), dass an `https.createServer()` weitergegeben wird.
 
-Der Wert kann auch ein [Optionsobjekt](https://nodejs.org/api/https.html#https_https_createserver_options_requestlistener) sein, das an `https.createServer()` übergeben wird.
+Beachten Sie, dass dies nur dann zu einem Downgrade auf TLS führt, wenn auch die Option [`server.proxy`](#server-proxy) verwendet wird.
 
 Ein gültiges Zertifikat ist erforderlich. Für eine grundlegende Einrichtung können Sie [@vitejs/plugin-basic-ssl](https://github.com/vitejs/vite-plugin-basic-ssl) zu den Projekt-Plugins hinzufügen, das automatisch ein selbstsigniertes Zertifikat erstellt und zwischenspeichert. Wir empfehlen jedoch, eigene Zertifikate zu erstellen.
 
diff --git a/docs/guide/api-environment-frameworks.md b/docs/guide/api-environment-frameworks.md
@@ -37,7 +37,48 @@ if (isRunnableDevEnvironment(server.environments.ssr)) {
 ```
 
 :::warning
-Der `Runner` wird eifrig ausgewertet, wenn das erste Mal auf ihn zugegriffen wird. Achten Sie darauf, dass Vite die Source-Map-Unterstützung aktiviert, wenn der `Runner` erstellt wird, indem Sie `process.setSourceMapsEnabled` aufrufen oder `Error.prepareStackTrace` überschreiben, wenn es nicht verfügbar ist.
+Der `Runner` wird faul ausgewertet, wenn das erste Mal auf ihn zugegriffen wird. Achten Sie darauf, dass Vite die Source-Map-Unterstützung aktiviert, wenn der `Runner` erstellt wird, indem Sie `process.setSourceMapsEnabled` aufrufen oder `Error.prepareStackTrace` überschreiben, wenn es nicht verfügbar ist.
+:::
+
+Frameworks die mit ihrer Laufzeit via [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch) kommunizieren, können `FetchableDevEnvironment` nutzen, welches über die `handleRequest`-Methode einen standardisierten Weg bereitstellt, Anfragen zu bearbeiten:
+
+```ts
+import {
+  createServer,
+  createFetchableDevEnvironment,
+  isFetchableDevEnvironment,
+} from 'vite'
+
+const server = await createServer({
+  server: { middlewareMode: true },
+  appType: 'custom',
+  environments: {
+    custom: {
+      dev: {
+        createEnvironment(name, config) {
+          return createFetchableDevEnvironment(name, config, {
+            handleRequest(request: Request): Promise<Response> | Response {
+              // bearbeite Anfragen und gib eine Antwort zurück
+            },
+          })
+        },
+      },
+    },
+  },
+})
+
+// Jeder Konsument der Umgebungs API kann nun `dispatchFetch` aufrufen
+if (isFetchableDevEnvironment(server.environments.custom)) {
+  const response: Response = await server.environments.custom.dispatchFetch(
+    new Request('/request-to-handle'),
+  )
+}
+```
+
+:::warning
+Vite validiert den Input und den Output der `dispatchFetch`-Methode: Die Anfrage muss eine Instanz der globalen Klasse `Request` sein und die Antwort eine Instanz der globalen Klasse `Response`. Vite wird einen `TypeError` hervorrufen, wenn dies nicht der Fall ist.
+
+Beachten Sie, dass auch wenn `FetchableDevEnvironment` als Klasse implementiert wurde, wird sie vom Vite-Team als Implementationsdetail betrachtet und könnte jederzeit geändert werden.
 :::
 
 ## Standardwert `RunnableDevEnvironment`
diff --git a/docs/guide/api-hmr.md b/docs/guide/api-hmr.md
@@ -8,15 +8,18 @@ Die manuelle HMR API ist hauptsächlich für Framework- und Tool-Autoren gedacht
 
 Vite stellt seine manuelle HMR API über das spezielle `import.meta.hot` Objekt zur Verfügung:
 
-```ts
+```ts twoslash
+import type { ModuleNamespace } from 'vite/types/hot.d.ts'
+import type {
+  CustomEventName,
+  InferCustomEventPayload,
+} from 'vite/types/customEvent.d.ts'
+
+// ---cut---
 interface ImportMeta {
   readonly hot?: ViteHotContext
 }
 
-type ModuleNamespace = Record<string, any> & {
-  [Symbol.toStringTag]: 'Module'
-}
-
 interface ViteHotContext {
   readonly data: any
 
@@ -25,23 +28,25 @@ interface ViteHotContext {
   accept(dep: string, cb: (mod: ModuleNamespace | undefined) => void): void
   accept(
     deps: readonly string[],
-    cb: (mods: Array<ModuleNamespace | undefined>) => void
+    cb: (mods: Array<ModuleNamespace | undefined>) => void,
   ): void
 
   dispose(cb: (data: any) => void): void
   prune(cb: (data: any) => void): void
   invalidate(message?: string): void
 
-  // `InferCustomEventPayload` bietet Typen für integrierte Vite-Ereignisse
-  on<T extends string>(
+  on<T extends CustomEventName>(
+    event: T,
+    cb: (payload: InferCustomEventPayload<T>) => void,
+  ): void
+  off<T extends CustomEventName>(
     event: T,
-    cb: (payload: InferCustomEventPayload<T>) => void
+    cb: (payload: InferCustomEventPayload<T>) => void,
   ): void
-  off<T extends string>(
+  send<T extends CustomEventName>(
     event: T,
-    cb: (payload: InferCustomEventPayload<T>) => void
+    data?: InferCustomEventPayload<T>,
   ): void
-  send<T extends string>(event: T, data?: InferCustomEventPayload<T>): void
 }
 ```
 
diff --git a/docs/guide/env-and-mode.md b/docs/guide/env-and-mode.md
@@ -108,6 +108,12 @@ Um dies zu erreichen, können Sie eine `vite-env.d.ts`-Datei im `src`-Verzeichni
 ```typescript [vite-env.d.ts]
 /// <reference types="vite/client" />
 
+interface ViteTypeOptions {
+  // Durch das Hinzufügen der Zeile, können Sie den Typ von ImportMetaEnv strikt machen,
+  // um unbekannte Typen zu verbieten.
+  // strictImportMetaEnv: unknown
+}
+
 interface ImportMetaEnv {
   readonly VITE_APP_TITLE: string
   // mehr Umgebungsvariablen...
diff --git a/docs/guide/features.md b/docs/guide/features.md
@@ -141,7 +141,7 @@ Beachten Sie, dass wenn [`compilerOptions.types`](https://www.typescriptlang.org
 `vite/client` stellt die folgenden Arten von Shims bereit:
 
 - Asset-Importe (z.B. Importieren einer `.svg`-Datei)
-- Typen für die in Vite eingefügten [konstanten Variablen](./env-and-mode#env-variables) auf `import.meta.env`
+- Typen für die in Vite eingefügten [Konstanten](./env-and-mode#env-variables) auf `import.meta.env`
 - Typen für die [HMR-API](./api-hmr) unter `import.meta.hot`
 
 ::: tip
@@ -208,22 +208,26 @@ Von HTML-Elementen wie `<script type="module" src>` und `<link href>` referenzie
 
 Um die HTML-Verarbeitung für bestimmte Elemente zu deaktivieren, können Sie das Attribut `vite-ignore` zum Element hinzufügen. Dies kann nützlich sein, wenn Sie auf externe Assets oder CDN verweisen.
 
-## Vue
+## Frameworks
 
-Vite bietet First-Class Vue Support:
+Alle modernen Frameworks unterstützen die Integration mit Vite. Die meisten Framework-Plugins werden von den jeweiligen Framework-Teams gepflegt, mit Ausnahme der offiziellen Vue- und React-Vite-Plugins, die von der Vite-Organsitation gepflegt werden:
 
-- Vue 3 SFC Unterstützung über [@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue)
-- Ansicht 3 JSX Unterstützung via [@vitejs/plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx)
+- Vue Unterstützung via [@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue)
+- Vue JSX Unterstützung via [@vitejs/plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx)
+- React Unterstützung via [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/tree/main/packages/plugin-react)
+- React mit SWC Unterstützung via [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc)
+
+Siehe [Plugins Guide](https://vite.dev/plugins) für mehr Informationen.
 
 Siehe [Plugins Guide](/plugins/) für mehr Informationen.
 
 ## JSX
 
 .jsx"- und "tsx"-Dateien werden ebenfalls von Haus aus unterstützt. JSX Transpilierung wird auch über [esbuild](https://esbuild.github.io) gehandhabt.
 
-Vue-Benutzer sollten das offizielle [@vitejs/plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx) Plugin verwenden, das Vue 3-spezifische Funktionen wie HMR, globale Komponentenauflösung, Direktiven und Slots bietet.
+Das Framework Ihrer Wahl konfiguriert JSX standardmäßig (z. B. Vue-Benutzer sollten das offizielle [@vitejs/plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx) Plugin verwenden, das Vue 3-spezifische Funktionen wie HMR, globale Komponentenauflösung, Direktiven und Slots bietet).
 
-Wenn JSX ohne React oder Vue verwendet wird, können benutzerdefinierte `jsxFactory` und `jsxFragment` mit der [`esbuild` Option](/config/shared-options.md#esbuild) konfiguriert werden. Zum Beispiel für Preact:
+Wenn JSX mit einem eigenen Framework verwendet wird, können benutzerdefinierte `jsxFactory` und `jsxFragment` mit der [`esbuild` Option](/config/shared-options.md#esbuild) konfiguriert werden. Zum Beispiel das Preact-Plugin würde Folgendes nutzen:
 
 ```js twoslash [vite.config.js]
 import { defineConfig } from 'vite'
@@ -343,10 +347,6 @@ Um CSS-Module zu konfigurieren, verwenden Sie [`css.lightningcss.cssModules`](ht
 
 Standardmäßig verwendet Vite esbuild zum Minifizieren von CSS. Lightning CSS kann auch als CSS-Minifizierer mit [`build.cssMinify: 'lightningcss'`](../config/build-options.md#build-cssminify) verwendet werden.
 
-:::tip HINWEIS
-[CSS-Präprozessoren](#css-pre-processors) werden bei der Verwendung von Lightning CSS nicht unterstützt.
-:::
-
 ## Statische Assets
 
 Beim Importieren eines statischen Assets wird die aufgelöste öffentliche URL zurückgegeben, wenn es bereitgestellt wird:
diff --git a/docs/guide/index.md b/docs/guide/index.md
@@ -219,7 +219,31 @@ Erfahren Sie mehr über die [Befehlszeilenschnittstelle](./cli.md)
 
 ## Unveröffentlichte Commits verwenden
 
-Wenn Sie nicht auf eine neue Version warten können, um die neuesten Funktionen zu testen, müssen Sie das [vite repo](https://github.com/vitejs/vite) auf Ihren lokalen Rechner klonen und es dann selbst bauen und verlinken ([pnpm](https://pnpm.io/) ist erforderlich):
+Wenn Sie nicht auf eine neue Version warten können, um die neuesten Funktionen zu testen, können Sie einen spezifischen Commit von Vite installieren mit https://pkg.pr.new:
+
+::: code-group
+
+```bash [npm]
+npm install -D https://pkg.pr.new/vite@SHA
+```
+
+```bash [Yarn]
+$ yarn add -D https://pkg.pr.new/vite@SHA
+```
+
+```bash [pnpm]
+$ pnpm add -D https://pkg.pr.new/vite@SHA
+```
+
+```bash [Bun]
+$ bun add -D https://pkg.pr.new/vite@SHA
+```
+
+:::
+
+Ersetzen Sie `SHA` mit irgendeinem von [Vites Commit SHAs](https://github.com/vitejs/vite/commits/main/). Beachten Sie, dass nur Commits innerhalb des letzten Monats funktionieren werden, da ältere Veröffentlichungen gelöscht werden.
+
+Alternativ können Sie auch das [Vite Repository](https://github.com/vitejs/vite) auf Ihrer lokalen Maschine klonen, anschließend bauen und es selbst verknüpfen ([pnpm](https://pnpm.io/) is required):
 
 ```bash
 git clone https://github.com/vitejs/vite.git
@@ -232,6 +256,12 @@ pnpm link --global # use your preferred package manager for this step
 
 Gehen Sie dann zu Ihrem Vite-basierten Projekt und führen Sie `pnpm link --global vite` aus (oder den Paketmanager, den Sie zum globalen Verlinken von `vite` verwendet haben). Starten Sie nun den Entwicklungsserver neu, um auf dem neuesten Stand zu sein!
 
+::: tip Abhängigkeiten die Vite benutzen
+
+Um die von Abhängigkeiten transitiv verwendeter Vite-Version zu ersetzen, sollten Sie [npm-Überschreibungen](https://docs.npmjs.com/cli/v11/configuring-npm/package-json#overrides) oder [pnpm-Überschreibungen](https://pnpm.io/package_json#pnpmoverrides) verwenden.
+
+:::
+
 ## Community
 
 Wenn Sie Fragen haben oder Hilfe benötigen, wenden Sie sich an die Community unter [Discord](https://chat.vite.dev) und [GitHub Discussions](https://github.com/vitejs/vite/discussions).
diff --git a/docs/guide/performance.md b/docs/guide/performance.md
@@ -122,5 +122,7 @@ Beispiele für die Verwendung von nativen Werkzeugen:
 
 Die Verwendung von nativem Werkzeug bringt oft eine größere Installation mit sich und ist daher nicht der Standard, wenn ein neues Vite-Projekt initialisiert wird. Für größere Anwendungen hingegen kann es sich aber lohnen.
 
+Nutzen Sie [Rolldown anstelle von Rollup und esbuild](./rolldown) für schnellere Builds und eine angeglichenere Erfahrung zwischen dev und build.
+
 - Probieren Sie die experimentelle Unterstützung für [LightningCSS](https://github.com/vitejs/vite/discussions/13835) aus.
 - Verwenden Sie [`@vitejs/plugin-react-swc`](https://github.com/vitejs/vite-plugin-react-swc) anstelle von `@vitejs/plugin-react`.
diff --git a/docs/guide/rolldown.md b/docs/guide/rolldown.md
diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md
diff --git a/docs/public/_redirects b/docs/public/_redirects
