Skip to content

Commit 4d6defe

Browse files
authored
docs(rolldown): update to reflect the latest changes (#2023)
1 parent d123045 commit 4d6defe

File tree

1 file changed

+22
-11
lines changed

1 file changed

+22
-11
lines changed

guide/rolldown.md

Lines changed: 22 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -89,15 +89,15 @@ Vitepress や Vite をピア依存関係として持つメタフレームワー
8989

9090
Rolldown は Rollup の代替として機能することを目指していますが、まだ実装中の機能や意図的な動作の違いがあります。包括的なリストについては、定期的に更新される[この GitHub PR](https://github.com/vitejs/rolldown-vite/pull/84#issue-2903144667) を参照してください。
9191

92-
### オプション検証エラー {#option-validation-errors}
92+
### オプション検証警告 {#option-validation-errors}
9393

94-
Rolldown は不明または無効なオプションが渡されるとエラーをスローします。Rollup で利用可能な一部のオプションは Rolldown ではサポートされていないため、使用しているメタフレームワークや自身が設定したオプションに応じてエラーが発生する可能性があります。以下に、このようなエラーメッセージの例を示します:
94+
Rolldown は不明または無効なオプションが渡されると警告を出力します。Rollup で利用可能な一部のオプションは Rolldown ではサポートされていないため、使用しているメタフレームワークや自身が設定したオプションに応じて警告が発生する可能性があります。以下に、このような警告メッセージの例を示します:
9595

96-
> Error: Failed validate input options.
96+
> Warning validate output options.
9797
>
98-
> - For the "preserveEntrySignatures". Invalid key: Expected never but received "preserveEntrySignatures".
98+
> - For the "generatedCode". Invalid key: Expected never but received "generatedCode".
9999
100-
このオプションを自身で設定していない場合は、使用しているフレームワークで修正される可能性があります。それまでの間、`ROLLDOWN_OPTIONS_VALIDATION=loose` 環境変数を設定することでこのエラーを抑制できます
100+
このオプションを自身で設定していない場合は、使用しているフレームワークで修正される必要があります
101101

102102
### API の違い
103103

@@ -257,6 +257,12 @@ const plugin = {
257257
}
258258
```
259259

260+
::: tip
261+
262+
Vite 7.0.0 以降、`this.meta` はすべてのフックで利用可能です。以前のバージョンでは、`this.meta``config` フックのような Vite 固有のフックでは利用できませんでした。
263+
264+
:::
265+
260266
<br>
261267

262268
`rolldownversion` エクスポートの存在を確認する:
@@ -275,16 +281,15 @@ if (vite.rolldownVersion) {
275281

276282
### Rolldown のオプション検証を無視するには
277283

278-
[上記で述べたように](#option-validation-errors)、Rolldown は不明または無効なオプションが渡されるとエラーをスローします
284+
[上記で述べたように](#option-validation-errors)、Rolldown は不明または無効なオプションが渡されると警告を出力します
279285

280286
これは[上記のように](#detecting-rolldown-vite)`rolldown-vite` で実行されているかどうかを確認することでオプションを条件的に渡すことで修正できます。
281287

282-
この場合、`ROLLDOWN_OPTIONS_VALIDATION=loose` 環境変数を設定してエラーを抑制することもできます。
283-
ただし、**最終的には Rolldown でサポートされていないオプションを渡さないようにする必要がある** ことに注意してください。
284-
285288
### `transformwithesbuild``esbuild` を個別にインストールする必要があります
286289

287-
`esbuild` の代わりに Oxc を使用する `transformWithOxc` と呼ばれる同様の関数は、`rolldown-vite` からエクスポートされます。
290+
Vite 自体はもう `esbuild` を使用しないため、`esbuild` はオプションのピア依存関係になりました。プラグインが `transformWithEsbuild` を使用する場合、プラグインは `esbuild` を依存関係に追加するか、ユーザーが手動でインストールする必要があります。
291+
292+
推奨される移行方法は、新しくエクスポートされた `transformWithOxc` 関数を使用することです。これは `esbuild` の代わりに Oxc を利用します。
288293

289294
### `esbuild` オプションの互換性レイヤー
290295

@@ -306,6 +311,12 @@ const plugin = {
306311
Rolldown は[フックフィルター機能](https://rolldown.rs/guide/plugin-development#plugin-hook-filters)を導入して、Rust と JavaScript のランタイムの間の通信を縮小しました。この機能を使用することで、プラグインのパフォーマンスを向上させることができます。
307312
これは、Rollup 4.38.0+ および Vite 6.3.0+ によってサポートされています。プラグインを古いバージョンとの後方互換性を持たせるには、フックハンドラー内でフィルターを実行してください。
308313

314+
::: tip
315+
316+
[`@rolldown/pluginutils`](https://www.npmjs.com/package/@rolldown/pluginutils) は、`exactRegex``prefixRegex` のようなフックフィルター用のいくつかのユーティリティーをエクスポートしています。
317+
318+
:::
319+
309320
### `load` または `transform` フックでコンテンツを JavaScript に変換する
310321

311322
`load` または `Transform` フックでコンテンツを他のタイプから JavaScript に変換する場合、`moduleType: 'js'` を返された値に追加する必要がある場合があります。
@@ -325,4 +336,4 @@ const plugin = {
325336
}
326337
```
327338

328-
これは、[Rolldown は JavaScript 以外のモジュールもサポート](https://rolldown.rs/guide/in-depth/module-types)しており、指定がない限り拡張子からモジュールタイプを拡張するためです。`rolldown-vite` は開発時にはモジュールタイプをサポートしていないことに注意してください。
339+
これは、[Rolldown は JavaScript 以外のモジュールもサポート](https://rolldown.rs/guide/in-depth/module-types)しており、指定がない限り拡張子からモジュールタイプを拡張するためです。

0 commit comments

Comments
 (0)