サイズ予算
ブラウザユーザーはバイトごとにコストを払うため、WASM パッケージにはサイズ予算があります。Native Node / Python / CLI は同じ厳格さでは制限しませんが（200 KB 増えてもユーザーに見えづらい環境向け）、WASM ビルドがコア全体の依存方針を決めます。
用語: サイズ予算
target 別の成果物サイズ上限です。上限を超えるとビルド失敗、目標を超えると警告で要調査。CI では make size-check で検査します。
用語: Brotli と非圧縮サイズ
非圧縮サイズ はディスク上の WASM ファイルサイズです。Brotli は適切に設定された CDN がブラウザに配信する圧縮後サイズです。ユーザーに見えるのは Brotli の数値で、非圧縮サイズは Brotli を配信できないホストでもロード可能にする上限です。
| 対象 | 予算 |
|---|---|
| 非圧縮サイズ | ソフト目標 2.5 MiB / ハード上限 3.0 MiB |
| Brotli | ソフト目標 640 KiB / ハード上限 768 KiB |
非圧縮サイズと Brotli サイズは同じ基準でゲートします。Brotli は報告だけの指標ではありません。
「予算化」が意味すること
予算違反はプロダクトの不具合と同じ扱いです。エンジンに依存を追加する前にビルドサイズを測り、その機能が支払いに見合うか判断します。「あとで直す」は出荷済みバイナリでは通用しません。ユーザーはすでにバイトを払い終えています。
サイズを減らすには
上限に近づいたら、次の順で見ます。
- 使われていない新コードパス: ほとんどのワークブックが触らない関数族は遅延呼び出しにできる。
- 依存の見直し: 汎用ライブラリは魅力的だが、重複排除後でも採算が合わないことが多い。スプレッドシート固有のごく小さなヘルパは in-tree が有利。
- ビルドフラグの調整: Emscripten の optimization pass、LTO、dead-code elimination。
- 公開 API の縮小: export したシンボルはエンジンが依存を保持し続ける原因になる。内部 API にできるものは内部に置く。
ビルド出力の読み方
sh
make wasm
make size-checksize-check は現状の非圧縮サイズと Brotli サイズを出し、予算と比較します。PR を送る前にローカルで通しておけば、CI 側で同じ検査が通ります。