@wcstack/state 4.6.1 → 4.7.0

package/README.ja.md

@@ -193,9 +193,9 @@
 <script type="importmap">
 {
   "imports": {
-    "@wcstack/state/core": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/core.js",
-    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/features/temporal.js",
-    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/features/scopes.js"
+    "@wcstack/state/core": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/core.js",
+    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/features/temporal.js",
+    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/features/scopes.js"
   }
 }
 </script>
@@ -220,12 +220,18 @@
 版を固定するか（素のパスは `exports` を読まないので、`dist/split/` 以下のファイル名を書く）、バンドラを
 通します。**`esm.run` からは読まないでください**。`+esm` はエントリごとにサーバー側で再バンドルし、
 共有の core チャンクをそれぞれに取り込むため、エントリごとに別のエンジンを抱えます。機能は core から
-見えないコピーへ install され、`installFeatures` を呼んでも `[wcs/feature-not-installed]` で落ちます。
-素のファイルなら、どのエントリの相対 import も同じチャンクの URL に解決され、エンジンは 1 回だけ評価
-されます。この形の integrity は [docs/sri.ja.md §5.1](../../docs/sri.ja.md#51-wcstackstate-の分割エントリ) を参照。
+見えないコピーへ install されます。素のファイルなら、どのエントリの相対 import も同じチャンクの URL に
+解決され、エンジンは 1 回だけ評価されます。この形の integrity は [docs/sri.ja.md §5.1](../../docs/sri.ja.md#51-wcstackstate-の分割エントリ) を参照。
 `dist/split/chunks/` 以下のファイル名にはコンテンツハッシュが入ります。チャンクのファイルを自分で列挙する
 場合（preload リンク、import map の `integrity`）は、読み込むビルドからファイル名を取ってください。
 
+**core とアドオンは 1 つのビルドから読みます。** 4.7 から、`installFeatures` は別のエンジンの
+コピーのアドオン — 別の URL の同じファイル（`esm.run`）や、別の版（タブが古い core を動かしている間に
+その場で置き換えた自前配信のディレクトリ）— を `[wcs/feature-foreign] The add-on "temporal" is from another copy of @wcstack/state`
+で拒みます。4.6 までは受け入れ、アドオンは別のコピーの口を埋めたので、`$watch` は黙って一度も動かず、
+`formats` のフィルタは入っていないと報告されました。`dist/split/features/` のアドオンのファイル名には
+コンテンツハッシュが入りません。自前で配信するなら、URL に版を入れ、配備の後も古いものを残してください。
+
 | エントリ | 足されるもの |
 |---|---|
 | `@wcstack/state/core` | バインディングの本体: `data-wcs`・`{{ }}` とコメントバインディング・`for` / `if`・パス getter・イベント・`$command` / `$on`・条件の 10 個のフィルタ（`eq` `ne` `not` `lt` `le` `gt` `ge` `truthy` `falsy` `boolean`）・`bootstrapState`・`installFeatures` |
@@ -255,7 +261,7 @@
 ページが名指したアドオンを、同じビルドから読み込みます。
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/auto.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/auto.js"></script>
 <wcs-state features="scopes diagnostics">
   <script type="module">
     export default {
@@ -288,6 +294,13 @@
 ページは `@wcstack/state/core` を import して `installFeatures` を呼びます。実行時に import するアドオンは
 その `<script>` の `integrity` の外にあり、CSP の下では CDN のホストを許可しておく必要があります。
 
+バンドルするページでは、アドオンはすべて `bootstrapState()` の前に入れます — 1 つのルートだけが使うものも。
+state ごとにアドオンを読み込むのは分割版の auto エントリの仕事で、ルートに入るときに import したアドオンは、
+ディープリンクの部品が作られた後に届きます。HTML を処理するバンドラ（Vite）は、`<wcs-state>` の中の
+インラインの `<script type="module">` も — router の `<wcs-guard-handler>` の中のもの、`<template>` の中のものも —
+警告なしにバンドルへ取り込みます: state は `setInitialState()` を待ったままになり、何も束ねられません。
+そうしたスクリプトには `vite-ignore` を付ける（Vite はページに残します）か、state を `src=` で読んでください。
+
 ## 基本的な使い方
 
 ```html
@@ -745,7 +758,7 @@ export default {
 
 **`undefined` は「無意見」** — 展開された state パスが `undefined` に解決される場合（slot オブジェクトでその input を初期化していない場合など）、プロパティ書き込みは**スキップ**され、要素側の既定値がそのまま生きます。実際に使うパスだけ初期化すれば十分で、`<wcs-fetch>` が `method` / `manual` / `body` を宣言していても `usersFetch: { value: null, loading: false }` だけで動きます。明示的にクリアしたい場合は `null` を代入してください（`null` は常に書き込まれます）。（このスキップは spread に限らず、要素の input に値を渡すすべてのプロパティバインディングに適用されます。前にそのパスが値を持っていても同じで、要素には状態が最後に書いた値が残ります。これは wc-bindable の applier プロファイル（0.10.0 の A2）より厳しい規則で、A2 は値の後の `undefined` を書いて要素を初期状態に戻させます。状態はこのプロファイルを宣言しません。ほかの書き手 — React 19 や直接の代入 — は `undefined` を届けるので、wcstack の I/O ノードは `undefined` を「値が無い」として扱います。）**表示の表面は別です:** `textContent` / `innerText` / `innerHTML`・mustache やコメントバインディングのテキスト・`attr.*`・`style.*`・`class.*` には生かすべき要素側の既定値が無いので、`undefined` も `null` も「値が無い」— テキストは空になり、属性やスタイルは削除され、クラスは外れます。`class.*` だけは範囲が狭く、「値が無い」扱いになるのは `undefined` と `null` だけです — **それ以外の非 boolean は今も throw します**。クラスの束縛は真偽の切り替えなので、truthy な文字列は意図というより書き間違いである方がずっと多いためです。「truthy として扱う」つもりなら `class.on: flag|truthy` と書いてください。
 
-**フィルタを挟んでも契約は保たれます。** 空値の判定はフィルタ**後**の値に対して行われるため、`String(value)` で結果を組み立てるフィルタは、値が無いときに `"undefined"` という**文字**を作ってしまいかねません。書式の族（`upper` / `lower` / `capitalize` / `trim` / `slice` / `padStart` / `padEnd` / `repeat` / `reverse` / `truncate` / `unit`）は代わりに `undefined` / `null` を素通しするので、`attr.title: x|trim` はフィルタの無い `attr.title: x` と同じく属性を消します。次の 3 群は**意図的に素通ししません**: 空値そのものが入力として意味を持つフィルタ（`defaults` / `coalesce` / `nullIfEmpty` / `boolean` / `truthy` / `falsy` / `not` / `eq` / `ne`）、変換が仕事のフィルタ（`int` / `float` / `number` / `string` — `undefined|string` は今も `"undefined"`）、値の型を検査するフィルタ（数値・日付・配列の族。`toFixed` / `date` / `join` など）。最後の群は throw しますが、それは束縛 1 本に閉じ込められ `$errorCallback` に報告されます。値が無いことが正当にありうるなら前に `coalesce` を置いてください（`price|coalesce(0)|toFixed(2)`）。
+**フィルタを挟んでも契約は保たれます。** 空値の判定はフィルタ**後**の値に対して行われるため、`String(value)` で結果を組み立てるフィルタは、値が無いときに `"undefined"` という**文字**を作ってしまいかねません。書式の族（`upper` / `lower` / `capitalize` / `trim` / `slice` / `padStart` / `padEnd` / `repeat` / `reverse` / `truncate` / `unit`）は代わりに `undefined` / `null` を素通しするので、`attr.title: x|trim` はフィルタの無い `attr.title: x` と同じく属性を消します。4.7 から、日付の族（`date` / `time` / `datetime` / `ymd` / `hms`）も素通しします: 後から届く日付（fetch、ルート）は、届くまで何も描きません — 4.6 までは読み込むたびに拒否され、無い日付の代わりになる `coalesce` の値もありませんでした。次の 3 群は**意図的に素通ししません**: 空値そのものが入力として意味を持つフィルタ（`defaults` / `coalesce` / `nullIfEmpty` / `boolean` / `truthy` / `falsy` / `not` / `eq` / `ne`）、変換が仕事のフィルタ（`int` / `float` / `number` / `string` — `undefined|string` は今も `"undefined"`）、値の型を検査するフィルタ（数値・配列の族。`toFixed` / `join` など）。最後の群は throw しますが、それは束縛 1 本に閉じ込められ `$errorCallback` に報告されます。値が無いことが正当にありうるなら前に `coalesce` を置いてください（`price|coalesce(0)|toFixed(2)`）。
 
 **制約事項**：
 
@@ -1757,7 +1770,7 @@ export default {
 | `ymd(sep?)` | YYYY-MM-DD（既定は `-`） | `createdAt\|ymd` / `createdAt\|ymd(/)` |
 | `hms(sep?)` | HH:MM:SS（既定は `:`） | `createdAt\|hms` / `createdAt\|hms(-)` |
 
-**5 つとも `Date` を取ります**（タイムスタンプではありません）。他の型は「requires a date value」で拒否されます。JSON から読み込んだ state は数値か ISO 文字列を持つので、束縛ではなく読み出し側で変換してください: `get createdAt() { return new Date(this.createdAtMs); }`。`loc?` の既定はページのロケール（[ロケール](#ロケール)）で、**適用のたびに**読み直されるため、束縛を組み立てた後に確定したロケールも反映されます（明示引数 `date(ja-JP)` は束縛式の一部なので組み立て時に固定されます）。`style?` は `full`・`long`・`medium`・`short`（Intl の `dateStyle` / `timeStyle`）で、無ければロケールの数字の書式（`2026/10/13`）、書式だけならページのロケールです（`date(medium)`）。`currency` の通貨は束縛を組み立てるときに確かめ、数は `loc` が無ければページのロケールで書きます。複数形などほかの書式は getter で書きます（`Intl.PluralRules`、`Intl.NumberFormat`）。
+**5 つとも `Date` を取ります**（タイムスタンプではありません）。他の型は「requires a date value」で拒否されます。値が無いとき（`undefined` / `null`）は、4.7 から何も描きません。JSON から読み込んだ state は数値か ISO 文字列を持つので、束縛ではなく読み出し側で変換してください: `get createdAt() { return new Date(this.createdAtMs); }`。`loc?` の既定はページのロケール（[ロケール](#ロケール)）で、**適用のたびに**読み直されるため、束縛を組み立てた後に確定したロケールも反映されます（明示引数 `date(ja-JP)` は束縛式の一部なので組み立て時に固定されます）。`style?` は `full`・`long`・`medium`・`short`（Intl の `dateStyle` / `timeStyle`）で、無ければロケールの数字の書式（`2026/10/13`）、書式だけならページのロケールです（`date(medium)`）。`currency` の通貨は束縛を組み立てるときに確かめ、数は `loc` が無ければページのロケールで書きます。複数形などほかの書式は getter で書きます（`Intl.PluralRules`、`Intl.NumberFormat`）。
 
 ### 真偽値 / デフォルト
 
@@ -2607,7 +2620,7 @@ $renderedCallback(paths) {
 - **行 watch も headless です** —— `for:` も `$listKeys` も要りません: watch は、自分が範囲とするリストを自分で追従させます。同じ配列やその写しの代入と `$postUpdate("items")` では発火しません —— どの行もリストに入っておらず、どの行パスも書かれていないためです —— が、行を読む getter（`$getAll("items.*.price", [])`）はその場で変えた値を読みます。
 - **共有配列は位置ごとに発火します** —— 複数の外側の行が同じ配列を持っているとき、その要素の 1 つへの書き込みは、その配列を持つ外側の行ごとに 1 回ずつ、それぞれの添字で `$watch("groups.*.items.*")` を発火させます: それらのどのパスでも値が変わったからです。
 - **ハンドラの例外は隔離されます** —— throw は報告され（`$watch "…" failed; the other watches still run.`）、残りの watch（と stream の restart）は続行します。
-- **書き込みの連鎖には上限があります** —— ハンドラの書き込みは新しいバッチを作るため、相互に書き合う watch は無限ループになり得ます。書き込みはそれぞれ連鎖の深さを持ちます: その書き込みをしたハンドラを起こした書き込みの深さに 1 を足したものです。32 段より深くで起こされたハンドラは実行されません: 連鎖は断ち切られ、`console.error`（`$watch handlers / $stream restarts kept writing for 32 batches; the chain is cut (nothing is rolled back).`）と DevTools の `state:watch-chain-limit` で 1 回報告され、そのバッチのほかのハンドラは実行されます。値と DOM は巻き戻しません。同じバッチに載る書き込み —— 描画の書き戻し —— は連鎖を伸ばしもリセットもしないので、長い有限の描画の連鎖（`$renderedCallback` が描画ごとに見出しを 1 段ずつ詰める）を見るハンドラは打ち切られません。`$stream` の restart もハンドラと同じく数えます: restart の書き込み（`initial` への戻し・status）は `args` に届いた書き込みの連鎖の続きで、上限を越えた restart は行いません。実行が（再）開始と同じタスクの中で書くもの —— source が出した値、status の `done` / `error` —— はその実行の連鎖に数え、それが起こすハンドラも restart も連鎖の続きになります。そのため、すぐに値を出す source を通るループはページを固まらせずに打ち切られます: `args` で互いの値を読む 2 つの stream も、stream の値を見る `$watch` がその `args` の読むものを進める形も。後者の 1 周（ハンドラ → restart）は 2 段なので、有限かどうかに関わらず 16 周ほどで止まります（メモリ上の source を使う自動ページ送りも）。後のタスク（ネットワークの応答、メッセージ、タイマー）から来た値と、それが起こすハンドラは、数え直しになります。
+- **書き込みの連鎖には上限があります** —— ハンドラの書き込みは新しいバッチを作るため、相互に書き合う watch は無限ループになり得ます。書き込みはそれぞれ連鎖の深さを持ちます: その書き込みをしたハンドラを起こした書き込みの深さに 1 を足したものです。32 段より深くで起こされたハンドラは実行されません: 連鎖は断ち切られ、エラーとして（[本番でのエラーの報告](#本番でのエラーの報告)。`$watch handlers / $stream restarts kept writing for 32 batches; the chain is cut (nothing is rolled back).`）と DevTools の `state:watch-chain-limit` で 1 回報告され、そのバッチのほかのハンドラは実行されます。値と DOM は巻き戻しません。同じバッチに載る書き込み —— 描画の書き戻し —— は連鎖を伸ばしもリセットもしないので、長い有限の描画の連鎖（`$renderedCallback` が描画ごとに見出しを 1 段ずつ詰める）を見るハンドラは打ち切られません。`$stream` の restart もハンドラと同じく数えます: restart の書き込み（`initial` への戻し・status）は `args` に届いた書き込みの連鎖の続きで、上限を越えた restart は行いません。実行が（再）開始と同じタスクの中で書くもの —— source が出した値、status の `done` / `error` —— はその実行の連鎖に数え、それが起こすハンドラも restart も連鎖の続きになります。そのため、すぐに値を出す source を通るループはページを固まらせずに打ち切られます: `args` で互いの値を読む 2 つの stream も、stream の値を見る `$watch` がその `args` の読むものを進める形も。後者の 1 周（ハンドラ → restart）は 2 段なので、有限かどうかに関わらず 16 周ほどで止まります（メモリ上の source を使う自動ページ送りも）。後のタスク（ネットワークの応答、メッセージ、タイマー）から来た値と、それが起こすハンドラは、数え直しになります。
 - **マウントされた `bind-component` スコープでは実行されません** —— マウントされたコンポーネントの `$watch` 宣言は、ルート state へ誘導する `wcs/mount-dollar-declaration` の警告を 1 回出して無視されます。`$stream` と `$renderedCallback` も同様です。ボリュームは `$watch` を拒否します（[`mount=`](#追加の状態をマウントするmount)）: ルートにフルパス（`"cart.total"`）で宣言してください。plain な（配線なし Shadow の）子は独立ツリーを持つので宣言できます。
 - **SSR では実行されません** —— ハンドラの副作用がサーバーとクライアントで二重に走るためです。
 
@@ -3083,7 +3096,7 @@ this.$getAll("matrix.*.*", [row]);
 
 ### 初期化の失敗
 
-初期化に失敗した `<wcs-state>` は `console.error` で 1 回報告されます —— まず要素とその state の出どころ、続いてエラー:
+初期化に失敗した `<wcs-state>` は 1 回報告されます（[本番でのエラーの報告](#本番でのエラーの報告)）—— まず要素とその state の出どころ、続いてエラー:
 
 ```
 [@wcstack/state] <wcs-state src="./state.js"> failed to initialize. SyntaxError: …
@@ -3117,7 +3130,7 @@ this.$getAll("matrix.*.*", [row]);
 
 ### バインディング 1 本の失敗は 1 本に閉じ込められます
 
-バインディングの適用が throw しても、そのバッチの残り・`$renderedCallback`・`$watch`・`$stream` の restart はすべて続行します。失敗は握り潰されず、`$errorCallback` に、それが無ければ `console.error` にエラーを続けて出し、DevTools（`state:binding-apply-error`）にも届きます。
+バインディングの適用が throw しても、そのバッチの残り・`$renderedCallback`・`$watch`・`$stream` の restart はすべて続行します。失敗は握り潰されず、`$errorCallback` に、それが無ければ報告され（[本番でのエラーの報告](#本番でのエラーの報告)）、エラーを続けて出し、DevTools（`state:binding-apply-error`）にも届きます。
 
 ```
 [@wcstack/state] binding "text: items.*.label" failed to apply.
@@ -3125,6 +3138,20 @@ this.$getAll("matrix.*.*", [row]);
 
 同期や描画に失敗したリスト（キーが無い、getter が throw した）も、その `for` バインディングの失敗として同じように報告され、それまでの行を保ちます。
 
+### 本番でのエラーの報告
+
+4.7 から、エンジンが報告するエラーはすべてプラットフォームの `reportError()` を通ります: 初期化に失敗した `<wcs-state>`、適用に失敗したバインディング（`$errorCallback` が受けないとき）、ページの getter・フィルタ・イベントハンドラ・ライフサイクルのコールバック・`$watch` のハンドラ・トークンの購読者の throw、そしてエンジンが打ち切った更新のループ。ページのエラーハンドラはどれも捕まえられなかったエラーとして受け取り、コンソールには 1 回出ます。4.6 までは `console.error` にだけ出たので、`window.onerror` で作ったエラーの収集には何も届きませんでした — ページ全体の初期化が失敗したときでさえ。
+
+報告される `Error` は、どこで何が起きたかを言います: メッセージはエンジンの文面（要素、バインディング）に元のエラーを続けたもので、元のエラーは `cause` に入ります。`diagnostics` アドオンが無いと、エンジンの文面はメッセージ番号と値です（`#12 "prop" "count" "textContent" 1 TypeError: …`、`#49 "wcs-state" Error: … #501 "uc"`）— [エラーメッセージと番号](#エラーメッセージと番号) で引けます。
+
+```js
+window.addEventListener("error", (e) => {
+  navigator.sendBeacon("/api/client-errors", JSON.stringify({ message: e.message, stack: e.error?.stack, cause: String(e.error?.cause ?? "") }));
+});
+```
+
+`$errorCallback` は、これまでどおり state のバインディングの失敗を代わりに受けます（描く、自分で報告する）。`reportError()` の無い環境 — happy-dom、Node、`@wcstack/server` — では、これまでどおり `console.error` です。警告は `console.warn` のままです。
+
 ### 描画中の書き込みは無限ループになりません
 
 描画そのものが書き込みを送り返すことがあります: 要素の書き戻し（双方向の入力欄、wc-bindable のイベント —— バインディングが要素のプロパティを設定したときに要素がその場で同期に出すものも含む ——、出力専用メンバーの初期値）と、`$renderedCallback` の中での書き込み（その中の `await` の後も、決着するまで）、`$watch` ハンドラの中での書き込み、`$stream` の restart による書き込みです。こうした書き込みはそれぞれ新しいバッチを作り、そのバッチがまた描画されます。描画が毎回新しい値を書く形 —— たとえば行の要素の出力を、その一覧の getter が読むキーそのものへ束ね、要素がインスタンスごとに違う値を返す —— では、microtask が回り続けてページが固まります。描画だけが送り込んだバッチが続いた数を数え、100 を超えると次のバッチは描画せず（値は state に残ります）、そのバッチに載っていたパスを 1 回だけ報告します：

package/README.md

@@ -194,9 +194,9 @@ leaves features out, it can compose them instead:
 <script type="importmap">
 {
   "imports": {
-    "@wcstack/state/core": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/core.js",
-    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/features/temporal.js",
-    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/features/scopes.js"
+    "@wcstack/state/core": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/core.js",
+    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/features/temporal.js",
+    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/features/scopes.js"
   }
 }
 </script>
@@ -221,12 +221,19 @@ Load the split form from the package's own files — jsDelivr's plain, version-p
 above (it does not read `exports`, so name the file under `dist/split/`), or a bundler — and **never
 through `esm.run`**. Its `+esm` endpoint re-bundles every entry on the server and inlines the shared
 core chunk into each one, so every entry would carry its own engine: a feature would install into a
-copy the core never sees, and the page throws `[wcs/feature-not-installed]` in spite of
-`installFeatures`. From the plain files, every entry's relative import resolves to the same chunk URL,
-so the browser evaluates the engine once. Integrity for this form: [docs/sri.md §5.1](../../docs/sri.md#51-the-split-entries-of-wcstackstate).
+copy the core never sees. From the plain files, every entry's relative import resolves to the same
+chunk URL, so the browser evaluates the engine once. Integrity for this form: [docs/sri.md §5.1](../../docs/sri.md#51-the-split-entries-of-wcstackstate).
 The file names under `dist/split/chunks/` carry a content hash: if you list chunk files yourself
 (preload links, `integrity` in an import map), take the names from the build you load.
 
+**The core and its add-ons come from one build.** Since 4.7 `installFeatures` refuses an
+add-on of another copy of the engine — the same files under another URL (`esm.run`), or another version
+(a self-hosted directory replaced in place while a tab still runs the old core) — with
+`[wcs/feature-foreign] The add-on "temporal" is from another copy of @wcstack/state`. Up to 4.6 it
+accepted it: the add-on filled the other copy's slots, so a `$watch` never ran, without a word, and a
+filter of `formats` was reported missing. The add-on files under `dist/split/features/` are not
+content-hashed: self-hosted, put the version in their URL and keep the old ones after a deploy.
+
 | Entry | What it adds |
 |---|---|
 | `@wcstack/state/core` | The binding engine: `data-wcs`, `{{ }}` and comment bindings, `for` / `if`, path getters, events, `$command` / `$on`, the 10 condition filters (`eq` `ne` `not` `lt` `le` `gt` `ge` `truthy` `falsy` `boolean`), `bootstrapState`, `installFeatures` |
@@ -256,7 +263,7 @@ receptacle the owning add-on fills on install).
 core, and the add-ons the page names from the same build.
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@wcstack/state@4.6.1/dist/split/auto.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@wcstack/state@4.7.0/dist/split/auto.js"></script>
 <wcs-state features="scopes diagnostics">
   <script type="module">
     export default {
@@ -289,6 +296,14 @@ reason above. It is not in `exports`: a bundler cannot follow the URLs it builds
 bundled page imports `@wcstack/state/core` and calls `installFeatures` instead. The add-ons it imports
 at run time are outside the `integrity` of its `<script>`; under a CSP they need the CDN host allowed.
 
+In a bundled page, install every add-on before `bootstrapState()` — also one only a route needs: loading
+add-ons per state is what the split auto entry does, and an add-on imported when a route is entered
+arrives after a deep link's components were built. A bundler that processes the HTML (Vite) also takes
+the inline `<script type="module">` out of `<wcs-state>` — and out of the router's `<wcs-guard-handler>`,
+even inside a `<template>` — into its bundle, without a warning: the state then waits for
+`setInitialState()` and nothing binds. Mark such scripts `vite-ignore` (Vite keeps them in the page), or load
+the state with `src=`.
+
 ## Basic Usage
 
 ```html
@@ -751,7 +766,7 @@ Runtime reads `customClass.wcBindable.properties + inputs` and expands each name
 
 **`undefined` is "no opinion"** — when an expanded state path resolves to `undefined` (e.g. the slot object doesn't initialize that input), the property write is **skipped** and the element keeps its own default. You only need to initialize the paths you actually use; `usersFetch: { value: null, loading: false }` is enough even though `<wcs-fetch>` also declares `method` / `manual` / `body`. To explicitly clear a value, assign `null` — `null` is always written. (This skip applies to every property binding that feeds an element input, not just spread, and also when the path held a value before: the element keeps the last value state wrote. That is stricter than the wc-bindable applier profile (0.10.0, A2), which writes `undefined` after a value so the element returns to its initial state; state does not claim that profile. Other writers — React 19, a direct assignment — do deliver `undefined`, and the wcstack I/O nodes treat it as "no value supplied".) **Display surfaces are different:** `textContent` / `innerText` / `innerHTML`, mustache and comment-binding text, `attr.*`, `style.*` and `class.*` have no element default worth keeping, so `undefined` and `null` both mean "no value" there — the text becomes empty, the attribute or style is removed, and the class is taken off. `class.*` is the narrow case: only `undefined` and `null` mean "no value"; **any other non-boolean still throws**, because a class binding is a boolean toggle and a truthy string is far more likely a mistake than an intent. Write `class.on: flag|truthy` when you mean "treat it as truthy".
 
-**Filters keep the contract.** The emptiness test runs on the value *after* the filters, so a filter that built its result with `String(value)` would turn an absent value back into the characters `"undefined"`. The formatting family (`upper`, `lower`, `capitalize`, `trim`, `slice`, `padStart`, `padEnd`, `repeat`, `reverse`, `truncate`, `unit`) passes `undefined` / `null` straight through instead, so `attr.title: x|trim` removes the attribute just as `attr.title: x` does. Three groups deliberately do **not**: the filters for which an absent value *is* the input (`defaults`, `coalesce`, `nullIfEmpty`, `boolean`, `truthy`, `falsy`, `not`, `eq`, `ne`), the conversions whose whole job is to convert (`int`, `float`, `number`, `string` — `undefined|string` is still `"undefined"`), and the filters that check the value's type (the number, date and array families, e.g. `toFixed` / `date` / `join`). Those last ones throw, which is confined to the one binding and reported through `$errorCallback` — put a `coalesce` in front when the value can legitimately be absent (`price|coalesce(0)|toFixed(2)`).
+**Filters keep the contract.** The emptiness test runs on the value *after* the filters, so a filter that built its result with `String(value)` would turn an absent value back into the characters `"undefined"`. The formatting family (`upper`, `lower`, `capitalize`, `trim`, `slice`, `padStart`, `padEnd`, `repeat`, `reverse`, `truncate`, `unit`) passes `undefined` / `null` straight through instead, so `attr.title: x|trim` removes the attribute just as `attr.title: x` does. Since 4.7 the date family (`date`, `time`, `datetime`, `ymd`, `hms`) passes them through too: a date that arrives later (a fetch, a route) renders nothing until it is there — up to 4.6 it was rejected on every load, and no `coalesce` value could stand for a missing date. Three groups deliberately do **not**: the filters for which an absent value *is* the input (`defaults`, `coalesce`, `nullIfEmpty`, `boolean`, `truthy`, `falsy`, `not`, `eq`, `ne`), the conversions whose whole job is to convert (`int`, `float`, `number`, `string` — `undefined|string` is still `"undefined"`), and the filters that check the value's type (the number and array families, e.g. `toFixed` / `join`). Those last ones throw, which is confined to the one binding and reported through `$errorCallback` — put a `coalesce` in front when the value can legitimately be absent (`price|coalesce(0)|toFixed(2)`).
 
 **Constraints**:
 
@@ -1763,7 +1778,7 @@ The names 3.x kept as aliases of the 3.2 renames (`inc`, `dec`, `fix`, `uc`, `lc
 | `ymd(sep?)` | YYYY-MM-DD (default `-`) | `createdAt\|ymd` / `createdAt\|ymd(/)` |
 | `hms(sep?)` | HH:MM:SS (default `:`) | `createdAt\|hms` / `createdAt\|hms(-)` |
 
-**All five take a `Date`,** not a timestamp — a value of any other type is rejected with "requires a date value". State loaded from JSON carries a number or an ISO string, so convert it where it is read rather than in the binding: `get createdAt() { return new Date(this.createdAtMs); }`. `loc?` defaults to the page locale ([Locale](#locale)), and the default is re-read on **every** apply, so a locale settled after the bindings were planned still takes effect (an explicit `date(ja-JP)` is part of the binding expression and is fixed when it is planned). `style?` is `full`, `long`, `medium` or `short` (Intl's `dateStyle` / `timeStyle`); without it the format is the locale's numeric one (`10/13/2026`), and a style alone keeps the page locale (`date(medium)`). `currency`'s code is checked when the bindings are planned; the number is formatted in the page locale unless `loc` names one. Plurals and other formats belong in a getter (`Intl.PluralRules`, `Intl.NumberFormat`).
+**All five take a `Date`,** not a timestamp — a value of any other type is rejected with "requires a date value". An absent one (`undefined` / `null`) renders nothing since 4.7. State loaded from JSON carries a number or an ISO string, so convert it where it is read rather than in the binding: `get createdAt() { return new Date(this.createdAtMs); }`. `loc?` defaults to the page locale ([Locale](#locale)), and the default is re-read on **every** apply, so a locale settled after the bindings were planned still takes effect (an explicit `date(ja-JP)` is part of the binding expression and is fixed when it is planned). `style?` is `full`, `long`, `medium` or `short` (Intl's `dateStyle` / `timeStyle`); without it the format is the locale's numeric one (`10/13/2026`), and a style alone keeps the page locale (`date(medium)`). `currency`'s code is checked when the bindings are planned; the number is formatted in the page locale unless `loc` names one. Plurals and other formats belong in a getter (`Intl.PluralRules`, `Intl.NumberFormat`).
 
 ### Boolean / Default
 
@@ -2617,7 +2632,7 @@ Key rules:
 - **A row watch is headless too** — it needs no `for:` and no `$listKeys`: the watch keeps the lists it ranges over in step itself. Reassigning the same array or a copy of it, and `$postUpdate("items")`, do not fire it — no row entered the list and no row path was written — but a getter over the rows (`$getAll("items.*.price", [])`) sees values changed in place.
 - **Shared arrays fire per position** — when several outer rows hold the same array, writing one of its elements fires `$watch("groups.*.items.*")` once for every outer row that holds it, each with its own indexes: the value changed at every one of those paths.
 - **Handler exceptions are isolated** — a throw is reported (`$watch "…" failed; the other watches still run.`) and the remaining watches (and stream restarts) still run.
-- **Write chains are bounded** — a handler's writes form a new batch, so mutually-writing watches would loop forever. Each write carries a chain depth: one more than that of the write that fired the handler making it. A handler fired more than 32 deep does not run: the chain is cut, reported once with `console.error` (`$watch handlers / $stream restarts kept writing for 32 batches; the chain is cut (nothing is rolled back).`) and to DevTools as `state:watch-chain-limit`, while the batch's other handlers still run. Values and DOM are not rolled back. Writes riding in the same batch — a render's write-back — neither lengthen nor reset a chain, so a handler that follows a long finite render chain — `$renderedCallback` shrinking a heading one step per render — is not cut off. A `$stream` restart counts like a handler: its writes (the reset to `initial`, the status) continue the chain of the write that reached its `args`, and a restart past the limit is not made. What a run writes in the same task as its (re)start — a value its source yields, its status `done` / `error` — counts toward that run's chain, for the handlers it fires as for the restarts it causes. A loop through a source that yields at once is therefore cut instead of freezing the page: two streams whose `args` read each other's values, or a `$watch` on a stream's value that moves what its `args` reads. One lap of the latter — the handler, then the restart — is two links, so it stops after about 16 laps, finite or not (auto-paging over an in-memory source included). A value from a later task (a network response, a message, a timer), and the handlers it fires, start afresh.
+- **Write chains are bounded** — a handler's writes form a new batch, so mutually-writing watches would loop forever. Each write carries a chain depth: one more than that of the write that fired the handler making it. A handler fired more than 32 deep does not run: the chain is cut, reported once as an error ([Reporting errors in production](#reporting-errors-in-production): `$watch handlers / $stream restarts kept writing for 32 batches; the chain is cut (nothing is rolled back).`) and to DevTools as `state:watch-chain-limit`, while the batch's other handlers still run. Values and DOM are not rolled back. Writes riding in the same batch — a render's write-back — neither lengthen nor reset a chain, so a handler that follows a long finite render chain — `$renderedCallback` shrinking a heading one step per render — is not cut off. A `$stream` restart counts like a handler: its writes (the reset to `initial`, the status) continue the chain of the write that reached its `args`, and a restart past the limit is not made. What a run writes in the same task as its (re)start — a value its source yields, its status `done` / `error` — counts toward that run's chain, for the handlers it fires as for the restarts it causes. A loop through a source that yields at once is therefore cut instead of freezing the page: two streams whose `args` read each other's values, or a `$watch` on a stream's value that moves what its `args` reads. One lap of the latter — the handler, then the restart — is two links, so it stops after about 16 laps, finite or not (auto-paging over an in-memory source included). A value from a later task (a network response, a message, a timer), and the handlers it fires, start afresh.
 - **Not run on a mounted `bind-component` scope** — the `$watch` declaration of a mounted component is ignored with a one-time `wcs/mount-dollar-declaration` warning that points to the root state; this applies to `$stream` and `$renderedCallback` too. A volume refuses `$watch` ([`mount=`](#mounting-additional-state-mount)): declare it on the root with the full path (`"cart.total"`). A plain (unwired Shadow) child owns an independent tree and can declare it.
 - **SSR does not run watches** — handler side effects would otherwise execute on both server and client.
 
@@ -3094,7 +3109,7 @@ this.$getAll("matrix.*.*", [row]);
 
 ### Initialization failures
 
-A `<wcs-state>` that fails to initialize is reported once with `console.error` — first the element and where its state comes from, then the error:
+A `<wcs-state>` that fails to initialize is reported once ([Reporting errors in production](#reporting-errors-in-production)) — first the element and where its state comes from, then the error:
 
 ```
 [@wcstack/state] <wcs-state src="./state.js"> failed to initialize. SyntaxError: …
@@ -3128,7 +3143,7 @@ Inside a `for:` / `if:` row, an error found while a binding is attached (an unde
 
 ### One failing binding is confined to that binding
 
-If applying a binding throws, the rest of that batch, `$renderedCallback`, `$watch`, and `$stream` restarts all still run. The failure is not swallowed — it goes to `$errorCallback`, or else to `console.error`, followed by the error, and to DevTools (`state:binding-apply-error`):
+If applying a binding throws, the rest of that batch, `$renderedCallback`, `$watch`, and `$stream` restarts all still run. The failure is not swallowed — it goes to `$errorCallback`, or else it is reported ([Reporting errors in production](#reporting-errors-in-production)), followed by the error, and to DevTools (`state:binding-apply-error`):
 
 ```
 [@wcstack/state] binding "text: items.*.label" failed to apply.
@@ -3136,6 +3151,20 @@ If applying a binding throws, the rest of that batch, `$renderedCallback`, `$wat
 
 A list that fails to sync or render (a missing key, a getter that throws) is reported the same way, as its `for` binding's failure, and keeps the rows it had.
 
+### Reporting errors in production
+
+Since 4.7, every error the engine reports goes through the platform's `reportError()`: a `<wcs-state>` that fails to initialize, a binding that fails to apply (when no `$errorCallback` takes it), and a getter, filter, event handler, lifecycle callback, `$watch` handler or token subscriber of the page that throws — and an update loop it cuts. The page's error handlers see each one as an uncaught error, and the console shows it once. Up to 4.6 they went to `console.error` only, so an error reporter built on `window.onerror` heard nothing — not even when the whole page failed to initialize.
+
+The reported `Error` says where and what: its message is the engine's (the element, the binding) followed by the original error, which is its `cause`. Without the `diagnostics` add-on the engine's part is the message number and its values (`#12 "prop" "count" "textContent" 1 TypeError: …`, `#49 "wcs-state" Error: … #501 "uc"`) — look them up in [Error messages and numbers](#error-messages-and-numbers).
+
+```js
+window.addEventListener("error", (e) => {
+  navigator.sendBeacon("/api/client-errors", JSON.stringify({ message: e.message, stack: e.error?.stack, cause: String(e.error?.cause ?? "") }));
+});
+```
+
+`$errorCallback` still takes a state's binding failures instead (render them, report them yourself). Where there is no `reportError()` — happy-dom, Node, `@wcstack/server` — the report is `console.error`, as before. Warnings stay `console.warn`.
+
 ### A write made while rendering cannot loop forever
 
 Some writes are fed back by rendering itself: an element's write-back (a two-way input, a wc-bindable event — including one an element dispatches synchronously while a binding sets one of its properties —, an output-only member's initial value), and a write made in `$renderedCallback` (also after an `await` in it, until it settles), in a `$watch` handler, or by a `$stream` restart. Each such write starts a new batch, and that batch renders again. If the rendering writes something new every time — say a row element whose output is bound to the very key the list's getter reads, returning a different value per instance — the page would spin in microtasks and freeze. Batches in a row that only rendering fed are counted: past 100, the next one is not rendered (its values stay in the state), and one report names the paths it carried: