@wcstack/state 4.10.1 → 4.11.0

package/README.ja.md

@@ -193,9 +193,9 @@
 <script type="importmap">
 {
   "imports": {
-    "@wcstack/state/core": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.10.1/dist/split/core.js",
-    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.10.1/dist/split/features/temporal.js",
-    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.10.1/dist/split/features/scopes.js"
+    "@wcstack/state/core": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/core.js",
+    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/features/temporal.js",
+    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/features/scopes.js"
   }
 }
 </script>
@@ -232,6 +232,14 @@
 `formats` のフィルタは入っていないと報告されました。`dist/split/features/` のアドオンのファイル名には
 コンテンツハッシュが入りません。自前で配信するなら、URL に版を入れ、配備の後も古いものを残してください。
 
+**1 ページにパッケージのコピーは 1 つ。** ページが先に評価したコピーが `<wcs-state>` を定義し、2 つ目の
+コピーは何もしません。4.11 から、先のコピーが別の版のとき — 上げた後に新しいものの横に残った
+古い `<script>` — `/auto` と `.` の `bootstrapState` がそう言います: `[wcs/package-twice] <wcs-state> is
+already defined by another copy of @wcstack/state that does not name its version; this copy,
+@wcstack/state@4.11.0, does nothing. Load each package once.` 同じ版のコピー（同じリリースの `wcstack/auto` のバンドルと `@wcstack/state/auto`）は何も
+言わず、`/core` は確かめません（core のサイズの予算）。どのパッケージも同じ規則に従います:
+[docs/timing-and-firing-contract.ja.md §24](../../docs/timing-and-firing-contract.ja.md)。
+
 | エントリ | 足されるもの |
 |---|---|
 | `@wcstack/state/core` | バインディングの本体: `data-wcs`・`{{ }}` とコメントバインディング・`for` / `if`・パス getter・イベント・`$command` / `$on`・条件の 10 個のフィルタ（`eq` `ne` `not` `lt` `le` `gt` `ge` `truthy` `falsy` `boolean`）・`bootstrapState`・`installFeatures` |
@@ -261,7 +269,7 @@
 ページが名指したアドオンを、同じビルドから読み込みます。
 
 ```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@wcstack/state@4.10.1/dist/split/auto.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/auto.js"></script>
 <wcs-state features="scopes diagnostics">
   <script type="module">
     export default {
@@ -765,7 +773,7 @@ export default {
 - spread 右辺へのフィルタ（`...: target|filter`）はエラー
 - 右辺パスの途中に `*` を含めても OK（例：`...: stores.*.fetch`）
 - 右辺は素のツリーパス（`...: fetchX`、途中の `*` も可）
-- カスタム要素クラスが未登録の場合、`customElements.whenDefined(tag)` 解決時に遅延展開される（autoloader による遅延ロードに対応）。`for:` / `if:` のテンプレートの中でも同じ — 行や枝はすぐに描かれ、クラスが定義されたらそれぞれの行の要素をその行の値で展開する。定義前に消えた行・閉じた枝は展開せず、何も生かし続けない。待つのはその要素を定義するレジストリ —— 要素が置かれた shadow root のスコープ付きレジストリも含む
+- カスタム要素クラスが未登録の場合、`customElements.whenDefined(tag)` 解決時に遅延展開される（autoloader による遅延ロードに対応）。`for:` / `if:` のテンプレートの中でも同じ — 行や枝はすぐに描かれ、クラスが定義されたらそれぞれの行の要素をその行の値で展開する。定義前に消えた行・閉じた枝は展開せず、何も生かし続けない。待つのはその要素を定義するレジストリ —— 要素が置かれた shadow root のスコープ付きレジストリも含む。待つ時間に限りは無い: 定義が来なければ、スプレッドはエラー無しに展開されないまま —— 4.11 から、`diagnostics` アドオンがそれを報告する（[カスタム要素の束縛はすべて定義を待つ](#inputs-と-attribute-ヒント)）
 - `wcBindable` 宣言**のない**要素はエラー（`[wcs/spread-no-bindable]`。明示配線で書いてください）— ネイティブ要素は定義を待たずに即座にエラーになる。spread は何を展開すべきかを契約から読み取るため
 
 **Composite shell**（wc-bindable Composition Profile）はそのままサポートされます：composite shell は標準の `target.constructor.wcBindable` を通じて synthesized declaration を露出するため、`"s3.progress"` のような composed name はフラットな要素メンバーキーとして扱われます。state を composed 構造に合わせて (`{ s3: { progress: 0 } }`) 持てば、`...: pipeline` が自動的に nested state path へ展開されます。
@@ -819,6 +827,15 @@ export default {
 
 getter はコピーを返しますが、書き込みは両側に届きます。元のパスを通した書き込み（`this["items.1.name"] = "z"`）はコピー側の行に、行を通した書き込み（`firstTwo.1.name`、または行の中のバインディング）は元のリストの行に届きます。getter の配列が書いたオブジェクトを持つので、getter は評価し直されます —— 絞り込み（`todos` の未完了の要素を返す `get shown()` を `for: shown` で描画する場合）なら、チェックボックスが `.done` を書いた行は表示から抜けます。新しいオブジェクトを返す getter（`map`）は、こうした書き込みでは評価し直しません。届かない場合は [同じオブジェクトが 2 つの位置にあるとき](#resolve--明示的なインデックスでのアクセス) を参照してください。
 
+**`for:` が取るのは配列です。** それ以外の値 —— 数、文字列、オブジェクト（`items` を渡すつもりだった応答 `{ items: [...] }`）—— は行を 1 つも描かず、何も失敗しません。`null` と `undefined` は意図して何も描きません: 後から届くリストです。4.11 から、`diagnostics` アドオンは、配列でも `null` / `undefined` でもない値を、リストのパスごとに 1 回警告します:
+
+```
+[@wcstack/state] [wcs/binding-type-expectation] "for: count" needs an array, not a number (3): it renders
+no rows (null and undefined render none on purpose). Validate statically: npx @wcstack/lint <file>.
+```
+
+見るのは、リストの最初の値、配列を置き換えた後の値、そして行の外の `for:` では後のすべての値です。行の中のリストで、`null` が後から配列でない値に置き換わったものは見ません。lint は、値の型が見えるところ —— state のリテラルなど —— で同じ誤りを同じコードで報告します（`stateSchema` があれば `wcs/path-type-mismatch`）。後から `createStateAsync` で書かれた値や fetch の値は見えません。
+
 #### `$listKeys` — 再取得された行の同一性
 
 行がバインディングの管理外の DOM 状態（フォーカス、IME 変換中の文字列、`<details>` の開閉、行内スクロール位置、`<canvas>` の描画内容、`<video>` の再生位置）を持つ場合、行の再構築でそれらは失われます。キーを宣言すると、リフレッシュをまたいで行を同定できます：
@@ -2171,7 +2188,7 @@ class MyFetcher extends HTMLElement {
 - `methodName` は `wcBindable.commands` に（`name` で）現れること（ネイティブ要素では [ネイティブ要素のコマンド](#ネイティブ要素のコマンド) の表にあること）
 - `<tokenName>` は `$commandTokens` で宣言されていること（`$command.typo` は `[wcs/token-undeclared]` を throw する）
 
-カスタム要素はクラスが定義された時点で検査され、ネイティブ要素はその場で検査されます —— アドオンが入っていれば（`@wcstack/state` と `/auto` には含まれています）[native-commands](#ネイティブ要素のコマンド) の表と照合し、入っていなければ拒否します（`[wcs/token-misconfigured]` `#1202`）。ページのバインド中に見つかった違反は `<wcs-state>` の初期化を失敗させます。`for:` / `if:` の行の中で見つかった違反や、ページのバインド後にクラスが定義されて見つかった違反は、そのバインディング 1 本の失敗として `$errorCallback` に届き、行はそのまま構築されます（[初期化の失敗](#初期化の失敗)）。
+カスタム要素はクラスが定義された時点で検査され（それまでメソッドは購読されず、定義が来なければ購読されないままです —— [カスタム要素の束縛はすべて定義を待つ](#inputs-と-attribute-ヒント)）、ネイティブ要素はその場で検査されます —— アドオンが入っていれば（`@wcstack/state` と `/auto` には含まれています）[native-commands](#ネイティブ要素のコマンド) の表と照合し、入っていなければ拒否します（`[wcs/token-misconfigured]` `#1202`）。ページのバインド中に見つかった違反は `<wcs-state>` の初期化を失敗させます。`for:` / `if:` の行の中で見つかった違反や、ページのバインド後にクラスが定義されて見つかった違反は、そのバインディング 1 本の失敗として `$errorCallback` に届き、行はそのまま構築されます（[初期化の失敗](#初期化の失敗)）。
 
 ### Token API
 
@@ -2673,6 +2690,7 @@ class MyChip extends HTMLElement {
 
 - 3.x はプロパティの後に属性にも書いていました（`String(value)`、オブジェクトは JSON）。setter で反映する要素は影響を受けません。setter を持たず、binder が属性を書くことに頼っていた要素には、setter が要ります（移行ガイド §3.4）。
 - ネイティブ HTML 要素は `inputs` を完全に無視します —— 宣言が効くのは `static wcBindable` を公開するカスタム要素だけです。
+- **カスタム要素の束縛は、wc-bindable のメンバーに限らず、すべてその要素の定義を待ちます**: どんな名前のプロパティの束縛も（`textContent:`、`text:`、`title:`、`value:` …）、スプレッドも、`command.` と `eventToken.` も。要素を定義するレジストリで `customElements.whenDefined(tag)` が解決するまで、どれも当たりません: 未定義の `<my-badge data-wcs="attr.cat: cat; textContent: label">` は、`cat` 属性は付き、中身は空のままです。定義の有無に関わらずすぐに当たるのは、`attr.*`、`class.*`、`style.*`、`html:` / `innerHTML:`、`radio:` / `checkbox:` と、`on*:` のリスナーです。待つ時間に限りは無いので、来ない定義 —— ページが読み込まなかったスクリプト（`@wcstack/upload/auto` の書き忘れ）、失敗した autoloader のパス —— は、それらの束縛をエラー無しに当たらないままにします。4.11 から、`diagnostics` アドオンがそれを報告します: ページがそろってから —— `load`、または state の `$connectedCallback` がそれより後ならその時点から —— 5 秒後に、`<wcs-state>` がバインドするルートを 1 回見て、そうした束縛を持ちまだ定義されていない要素を、タグごとに 1 回警告します（`[wcs/element-undefined]`）。`wcs-*` のタグには、それを定義する wcstack のパッケージ（の `/auto`）を読み込むよう言いますが、パッケージの名前は挙げません —— `wcs-<名前>` が `@wcstack/<名前>` とは限らないからです（`<wcs-ws>` は `@wcstack/websocket`、`<wcs-link>` は router）。ほかのタグには、それを定義するスクリプトを読み込むよう言います。見るのはページの要素と、その時点で描かれている `for:` / `if:` の行と枝です。後から加わった要素と、コンポーネント自身の state が描く行は見ません。
 - `for:` の行と `if:` の枝は、挿入する前にバインドします。その中のカスタム要素は、`connectedCallback` が走る前に入力（`element.value = …`）を受け取ります。ページの直下では、要素は先に接続されています。既定値から描く `connectedCallback` は、setter が受け取ったものを上書きします —— 今のプロパティから描いてください（外部の評価では、金額欄が、まだ採用していない入力をこれで失いました。ページを 3.x から 4.0 に上げたときです）。もう 1 つの早い書き込み、要素が定義される前に代入されたプロパティは、[I/O ノードのガイドライン](../../docs/async-io-node-guidelines.ja.md)の `upgradeProperties` の手順が扱います。
 
 ## コンポーネント機構の選び方
@@ -2893,6 +2911,8 @@ export default {
   ```
 
   フックはバッチの後（`$renderedCallback` の後）に走り、await されず、フック内で throw しても console に報告されるだけで drain は壊れません。DevTools にはフックの有無に関わらず全失敗が `state:binding-apply-error` として届きます。ボリューム（`<wcs-state mount>`）は実行しません（`console.warn`）。マウントされたコンポーネントのフックは、そのコンポーネント自身のバインディングの失敗を受け取ります。`$watch` ハンドラの失敗（別途隔離・報告）、throw した `$renderedCallback`（`console.error` で報告）、失敗した `$connectedCallback`（[初期化の失敗](#初期化の失敗)）は対象外です。
+
+  4.7 から、エンジンが報告するエラーは `reportError()` を通ってページのエラーハンドラ（`window.onerror`、`error` リスナー）に届きます（[本番でのエラーの報告](#本番でのエラーの報告)）—— ただし `$errorCallback` を宣言した state のバインディングの失敗は別です: それはフックにだけ届き、ページのエラーハンドラには届きません。エラーの報告係にバインディングの失敗も見せたいページは、フックから渡します: `$errorCallback(error, { path }) { this.loadError = …; reportError(error); }`。（4.2 向けに書かれ、上の例のようにバインディングの失敗を描いていた state は、アップグレードの後、ページが頼っていたエラーの報告係から、その失敗をすべて遠ざけていました —— 継ぎ目アプリ `homeroom`。）
 - Web Component を使用している場合は、コンポーネント側に `async $stateReadyCallback(stateProp)` を定義おくことで、`bind-component` でバインドした状態が利用可能になった瞬間にフックとして呼び出されます。
 
 ## 遷移アニメーション
@@ -3168,7 +3188,7 @@ window.addEventListener("error", (e) => {
 });
 ```
 
-`$errorCallback` は、これまでどおり state のバインディングの失敗を代わりに受けます（描く、自分で報告する）。`reportError()` の無い環境 — happy-dom、Node、`@wcstack/server` — では、これまでどおり `console.error` です。警告は `console.warn` のままです。
+`$errorCallback` は、これまでどおり state のバインディングの失敗を代わりに受けます（描く、自分で報告する —— フックの中で `reportError(error)` を呼べば、ページのエラーハンドラにも渡ります）。`reportError()` の無い環境 — happy-dom、Node、`@wcstack/server` — では、これまでどおり `console.error` です。警告は `console.warn` のままです。
 
 ### 描画中の書き込みは無限ループになりません
 

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.10.1/dist/split/core.js",
-    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.10.1/dist/split/features/temporal.js",
-    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.10.1/dist/split/features/scopes.js"
+    "@wcstack/state/core": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/core.js",
+    "@wcstack/state/features/temporal": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/features/temporal.js",
+    "@wcstack/state/features/scopes": "https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/features/scopes.js"
   }
 }
 </script>
@@ -234,6 +234,15 @@ accepted it: the add-on filled the other copy's slots, so a `$watch` never ran,
 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.
 
+**One copy of the package per page.** The copy a page evaluates first defines `<wcs-state>`, and a
+second copy does nothing. Since 4.11, `/auto` and `.`'s `bootstrapState` say so
+when the first copy is of another version — an old `<script>` left beside the new one after an
+upgrade: `[wcs/package-twice] <wcs-state> is already defined by another copy of @wcstack/state that does
+not name its version; this copy, @wcstack/state@4.11.0, does nothing. Load each package once.` A copy of the same version stays
+silent (the `wcstack/auto` bundle beside `@wcstack/state/auto` of one release), and `/core` does not
+check (the core's size budget). Every package follows the same rule:
+[docs/timing-and-firing-contract.md §24](../../docs/timing-and-firing-contract.md).
+
 | 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` |
@@ -263,7 +272,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.10.1/dist/split/auto.js"></script>
+<script type="module" src="https://cdn.jsdelivr.net/npm/@wcstack/state@4.11.0/dist/split/auto.js"></script>
 <wcs-state features="scopes diagnostics">
   <script type="module">
     export default {
@@ -773,7 +782,7 @@ Runtime reads `customClass.wcBindable.properties + inputs` and expands each name
 - Filters on the spread target (`...: target|filter`) are rejected.
 - The right-hand path may contain `*` anywhere (e.g. `...: stores.*.fetch`).
 - The right-hand side is a plain tree path (`...: fetchX` or `...: stores.*.fetch`).
-- If the custom element class is not yet registered, expansion is deferred until `customElements.whenDefined(tag)` resolves — autoloader-style late registration is supported. This holds inside `for:` / `if:` templates too: the rows and the branch render right away, and each row's element is expanded with that row's values once the class is defined. A row removed, or a branch closed, before the definition is not expanded, and holds nothing alive. The wait is on the registry that defines the element — a scoped registry of the shadow root it is placed in included.
+- If the custom element class is not yet registered, expansion is deferred until `customElements.whenDefined(tag)` resolves — autoloader-style late registration is supported. This holds inside `for:` / `if:` templates too: the rows and the branch render right away, and each row's element is expanded with that row's values once the class is defined. A row removed, or a branch closed, before the definition is not expanded, and holds nothing alive. The wait is on the registry that defines the element — a scoped registry of the shadow root it is placed in included. The wait has no limit: a definition that never comes leaves the spread unexpanded, without an error — since 4.11 the `diagnostics` add-on reports it ([every binding on a custom element waits for its definition](#inputs-and-the-attribute-hint)).
 - Elements **without** a `wcBindable` declaration are rejected (`[wcs/spread-no-bindable]`; write bindings explicitly) — a native element at once, without waiting for a definition. Spread requires the contract to know what to expand.
 
 **Composite shells** (wc-bindable Composition Profile) are supported transparently: a composite shell exposes its synthesized declaration through the standard `target.constructor.wcBindable` surface, and composed names like `"s3.progress"` are kept as flat element member keys. Mirror the composed structure in state (`{ s3: { progress: 0 } }`) and `...: pipeline` expands into nested state paths automatically.
@@ -827,6 +836,15 @@ The exception is data that arrives as **freshly created objects** — `fetch(...
 
 The getter returns a copy, and a write reaches both sides: a write through the original path (`this["items.1.name"] = "z"`) reaches the copy's row, and a write through the row (`firstTwo.1.name`, or a binding inside the row) reaches the original list's row. The getter is evaluated again, because its array holds the written object — with a filter (`get shown()` returning the undone items of `todos`, rendered with `for: shown`), a row whose checkbox writes `.done` leaves the view. A getter that returns new objects (`map`) is not evaluated again by such a write. See [One object at two positions](#resolve--access-by-explicit-index) for what is not reached.
 
+**`for:` takes an array.** Any other value — a number, a string, an object (a response `{ items: [...] }` where its `items` was meant) — renders no rows, and nothing fails. `null` and `undefined` render none on purpose: a list that arrives later. Since 4.11 the `diagnostics` add-on warns once per list path about a value that is neither an array nor `null` / `undefined`:
+
+```
+[@wcstack/state] [wcs/binding-type-expectation] "for: count" needs an array, not a number (3): it renders
+no rows (null and undefined render none on purpose). Validate statically: npx @wcstack/lint <file>.
+```
+
+It looks at a list's first value, at a later value that replaces an array, and, for a `for:` outside any row, at every later value. A list inside a row whose `null` is later replaced by something that is not an array is not looked at. The lint reports the same mistake under the same code (`wcs/path-type-mismatch` with a `stateSchema`) where it can see the value's type, as in the state's literal — not a value written later through `createStateAsync` or from a fetch.
+
 #### `$listKeys` — identity for refetched rows
 
 When rows carry DOM state the bindings do not own — focus, an in-flight IME composition, `<details>` open state, inner scroll position, `<canvas>` contents, `<video>` playback — rebuilding the rows loses it. Declare a key so the framework can recognize rows across a refresh:
@@ -2183,7 +2201,7 @@ Validation rules (enforced at binding time):
 - `methodName` must appear (by `name`) in `wcBindable.commands` (on a native element: in the table of [Native Element Commands](#native-element-commands))
 - `<tokenName>` must be declared in `$commandTokens` (`$command.typo` throws `[wcs/token-undeclared]`)
 
-A custom element is checked once its class is defined; a native element at once — against the [native-commands](#native-element-commands) table where the add-on is installed (`@wcstack/state` and `/auto` include it), and refused otherwise (`[wcs/token-misconfigured]` `#1202`). A violation found while the page is bound fails the `<wcs-state>`'s initialization; one found inside a `for:` / `if:` row, or when a class is defined after the page was bound, fails that one binding, which goes to `$errorCallback`, and the row is still built ([Initialization failures](#initialization-failures)).
+A custom element is checked once its class is defined — its method is not subscribed before that, and never when no definition comes ([every binding on a custom element waits for its definition](#inputs-and-the-attribute-hint)); a native element at once — against the [native-commands](#native-element-commands) table where the add-on is installed (`@wcstack/state` and `/auto` include it), and refused otherwise (`[wcs/token-misconfigured]` `#1202`). A violation found while the page is bound fails the `<wcs-state>`'s initialization; one found inside a `for:` / `if:` row, or when a class is defined after the page was bound, fails that one binding, which goes to `$errorCallback`, and the row is still built ([Initialization failures](#initialization-failures)).
 
 ### Token API
 
@@ -2685,6 +2703,7 @@ Notes:
 
 - 3.x also wrote the attribute after the property (`String(value)`, JSON for an object). An element that reflects in its setter is unaffected; one that has no setter and relied on the binder to write its attribute needs a setter now (Migration guide, §3.4).
 - Native HTML elements ignore `inputs` entirely — the declaration only applies to custom elements that expose `static wcBindable`.
+- **Every binding on a custom element waits for its definition**, not only its wc-bindable members: a property binding of any name (`textContent:`, `text:`, `title:`, `value:` …), a spread, `command.` and `eventToken.`. None of them is applied before `customElements.whenDefined(tag)` resolves in the registry that defines the element: an undefined `<my-badge data-wcs="attr.cat: cat; textContent: label">` gets its `cat` attribute and stays empty. What is applied at once, defined or not: `attr.*`, `class.*`, `style.*`, `html:` / `innerHTML:`, `radio:` / `checkbox:`, and the `on*:` listeners. The wait has no limit, so a definition that never comes — a script the page did not load (`@wcstack/upload/auto` left out), an autoloader path that fails — leaves those bindings unapplied without an error. Since 4.11 the `diagnostics` add-on reports it: 5 s after the page was ready — its `load`, or the state's `$connectedCallback` when that is later — it looks once at the root the `<wcs-state>` binds, and warns once per tag about an element with such a binding that is still not defined (`[wcs/element-undefined]`). For a `wcs-*` tag it says to load the wcstack package that defines it (its `/auto`) without naming one — `wcs-<name>` is not always `@wcstack/<name>` (`<wcs-ws>` is `@wcstack/websocket`, `<wcs-link>` the router) — for another tag the script that defines it. It sees the page's elements and the `for:` / `if:` rows and branches rendered at that moment; an element added later, and the rows a component's own state renders, are not looked at.
 - A `for:` row or an `if:` branch is bound before it is inserted: a custom element in it receives its inputs (`element.value = …`) before its `connectedCallback` runs. At page level the element is connected first. A `connectedCallback` that renders from its defaults overwrites what the setters received — render from the current properties instead. (An outside evaluation's amount field lost an entry it had not accepted yet this way when its page moved from 3.x to 4.0.) The other early write, a property set before the element is defined, is the [I/O node guidelines](../../docs/async-io-node-guidelines.md)' `upgradeProperties` step.
 
 ## Choosing a Component Mechanism
@@ -2905,6 +2924,8 @@ All hooks except `$disconnectedCallback` support `async` — you can use `async/
   ```
 
   The hook runs after the batch (after `$renderedCallback`), is not awaited, and an exception thrown inside it is reported to the console without breaking the drain. DevTools still receives every failure as `state:binding-apply-error` whether or not the hook exists. A volume (`<wcs-state mount>`) does not run it (`console.warn`); a mounted component's receives the failures of the component's own bindings. It does not cover `$watch` handlers (isolated and reported separately), a `$renderedCallback` that throws (reported with `console.error`), or a `$connectedCallback` that fails ([Initialization failures](#initialization-failures)).
+
+  Since 4.7 the errors the engine reports reach the page's error handlers (`window.onerror`, an `error` listener) through `reportError()` ([Reporting errors in production](#reporting-errors-in-production)) — except a binding failure of a state that declares `$errorCallback`: it goes to the hook only, and the page's error handlers never see it. A page whose error reporter must see binding failures too hands them on from the hook: `$errorCallback(error, { path }) { this.loadError = …; reportError(error); }`. (A state written for 4.2 that rendered its binding failures this way, as above, kept every one of them from the error reporter its page relied on after the upgrade — the `homeroom` seam app.)
 - In Web Components, define `async $stateReadyCallback(stateProp)` to receive a hook when the bound state becomes available via `bind-component`
 
 ## Transition animations
@@ -3181,7 +3202,7 @@ window.addEventListener("error", (e) => {
 });
 ```
 
-`$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`.
+`$errorCallback` still takes a state's binding failures instead (render them, report them yourself — `reportError(error)` in the hook hands them to the page's error handlers too). 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