feat: Environment API 4/4 (#1546)

Author: jay-es

.vitepress/config.ts

@@ -272,6 +272,10 @@ export default defineConfig({
               text: 'v4 からの移行',
               link: '/guide/migration',
             },
+            {
+              text: '破壊的変更',
+              link: '/changes/',
+            },
           ],
         },
         {
@@ -339,6 +343,45 @@ export default defineConfig({
           ],
         },
       ],
+      '/changes/': [
+        {
+          text: '破壊的変更',
+          link: '/changes/',
+        },
+        {
+          text: '現在',
+          items: [],
+        },
+        {
+          text: '将来',
+          items: [
+            {
+              text: 'フック内の this.environment',
+              link: '/changes/this-environment-in-hooks',
+            },
+            {
+              text: 'HMR hotUpdate プラグインフック',
+              link: '/changes/hotupdate-hook',
+            },
+            {
+              text: '環境ごとの API への移行',
+              link: '/changes/per-environment-apis',
+            },
+            {
+              text: 'ModuleRunner API を使った SSR',
+              link: '/changes/ssr-using-modulerunner',
+            },
+            {
+              text: 'ビルド時の共有プラグイン',
+              link: '/changes/shared-plugins-during-build',
+            },
+          ],
+        },
+        {
+          text: '過去',
+          items: [],
+        },
+      ],
     },
 
     outline: {

config/build-options.md

@@ -192,12 +192,19 @@ CSS コード分割を有効/無効にします。有効にすると、非同期
 
 SSR 向けのビルドを生成します。この値は、SSR エントリーを直接指定する文字列か、`true` にして `rollupOptions.input` で SSR エントリーを指定する必要があります。
 
+## build.emitAssets
+
+- **型:** `boolean`
+- **デフォルト:** `false`
+
+クライアント以外のビルド時、静的アセットはクライアントビルドの一部として生成されると仮定されているため、出力されません。このオプションは、フレームワークが他の環境のビルドで静的アセットを強制的に出力することを可能にします。ビルド後のステップでアセットをマージするのはフレームワークの責任です。
+
 ## build.ssrEmitAssets
 
 - **型:** `boolean`
 - **デフォルト:** `false`
 
-SSR ビルドの間、静的アセットはクライアントビルドの一部として出力されると想定されているため、出力されません。このオプションを使用すると、フレームワークはクライアントと SSR ビルドの両方でアセットを出力することを強制できます。フレームワークは、ビルド後のステップでアセットをマージする責任があります。
+SSR ビルドの間、静的アセットはクライアントビルドの一部として出力されると想定されているため、出力されません。このオプションを使用すると、フレームワークはクライアントと SSR ビルドの両方でアセットを出力することを強制できます。フレームワークは、ビルド後のステップでアセットをマージする責任があります。このオプションは Environment API が安定したら `build.emitAssets` に置き換えられます。
 
 ## build.minify
 

config/shared-options.md

@@ -490,3 +490,12 @@ define: {
 - `'custom'`: HTML ミドルウェアを含めない
 
 詳細は Vite の [SSR ガイド](/guide/ssr#vite-cli) 参照してください。関連: [`server.middlewareMode`](./server-options#server-middlewaremode)。
+
+## future
+
+- **型:** `Record<string, 'warn' | undefined>`
+- **関連:** [破壊的変更](/changes/)
+
+Vite の次期メジャーバージョンへのスムーズな移行に備え、将来的な破壊的変更を可能にします。このリストは、新機能の開発に伴い、いつでも更新、追加、削除される可能性があります。
+
+設定可能なオプションの詳細については、[破壊的変更](/changes/) ページを参照してください。

guide/cli.md

@@ -69,6 +69,7 @@ vite build [root]
 | `-f, --filter <filter>`        | デバッグログをフィルタリングする（`string`）                                                                                       |
 | `-m, --mode <mode>`            | env モードを設定する（`string`）                                                                                            |
 | `-h, --help`                   | 利用可能な CLI オプションを表示する                                                                                       |
+| `--app`                        | すべての環境をビルドする。`builder.entireApp` と同じ。（`boolean`、実験的機能）                                       |
 
 ## その他