@wcstack/network 1.26.0 → 1.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.ja.md +3 -3
  2. package/package.json +1 -1
package/README.ja.md CHANGED
@@ -125,7 +125,7 @@ npm install @wcstack/network
125
125
  ## 注意・制限
126
126
 
127
127
  - **Firefox と Safari は `navigator.connection` を実装していません。** これらのブラウザでは `supported` は `false` のまま、他の4プロパティは `null` のままです — これを例外ケースでなく常態として設計してください。
128
- - **初回スナップショットの*イベント*はバインドに届きませんが、値は届きます。** 最初の `wcs-network:change` は `connectedCallback` 中に同期発火しますが、`@wcstack/state` のバインドリスナー確立はそれより後です(バインド構築は後続の microtask に遅延 — `docs/timing-and-firing-contract.md` §4.1 参照)。イベントは後から購読した相手に再送されません。それでも初期値が失われないのは、本ノードの観測可能プロパティがすべて output-only(`properties` のみ・`inputs` に無い)で、既定の binding authority が `element` になるためです: バインドは確立時にプロパティを直接読みます(directional initial sync、v1.21.0 以降は既定 ON)。手動 pull は不要で、これは全 monitor ノード共通の挙動です。`enableDirectionalInitialSync: false` に倒した構成でのみ、`$connectedCallback` + `whenDefined` での手動 pull が再び必要になります。
128
+ - **初回スナップショットの*イベント*はバインドに届きませんが、値は届きます。** 最初の `wcs-network:change` は `connectedCallback` 中に同期発火しますが、`@wcstack/state` のバインドリスナー確立はそれより後です(バインド構築は後続の microtask に遅延 — `docs/timing-and-firing-contract.ja.md` §4.1 参照)。イベントは後から購読した相手に再送されません。それでも初期値が失われないのは、本ノードの観測可能プロパティがすべて output-only(`properties` のみ・`inputs` に無い)で、既定の binding authority が `element` になるためです: バインドは確立時にプロパティを直接読みます(directional initial sync、v1.21.0 以降は既定 ON)。手動 pull は不要で、これは全 monitor ノード共通の挙動です。`enableDirectionalInitialSync: false` に倒した構成でのみ、`$connectedCallback` + `whenDefined` での手動 pull が再び必要になります。
129
129
  - **`_gen` 世代ガードが無い。** 他の大半の wcstack IO ノードと異なり、`navigator.connection` の `change` イベント購読・購読解除は完全に同期的です。dispose() とレースしうる非同期probeの解決が存在しません。詳細は `docs/network-tag-design.md` §5。
130
130
  - **再接続で再購読。** 要素を取り外して再挿入すると、切断時に `change` リスナーを解除し、再接続時に(その時点の `navigator.connection` に対して)再確立します。
131
131
  - **SSR(`@wcstack/server`)。** `static hasConnectedCallbackPromise = true` を宣言し `connectedCallbackPromise` を公開しますが、`observe()` が同期的なため、この promise は常に即座に settle します。
@@ -143,7 +143,7 @@ npm install @wcstack/network
143
143
  | `save-data` | `wcs-network:change` が `saveData === true` で発火(`saveData` が `null`=非対応の場合も含め off) |
144
144
  | `supported` | `wcs-network:change` が `supported === true` で発火(`supported === false` で off) |
145
145
 
146
- `effectiveType` / `downlink` / `rtt` は反映されません — 理由は `docs/custom-state-reflection-design.md` §3.2(連続値・高頻度値は `:state()` 反映の対象外)を参照してください。
146
+ `effectiveType` / `downlink` / `rtt` は反映されません — 理由は `docs/custom-state-reflection-design.ja.md` §3.2(連続値・高頻度値は `:state()` 反映の対象外)を参照してください。
147
147
 
148
148
  ```css
149
149
  wcs-network:state(supported) ~ .connection-badge { display: block; }
@@ -203,7 +203,7 @@ console.log(net.effectiveType);
203
203
  net.dispose(); // live な `change` リスナーを外す
204
204
  ```
205
205
 
206
- Core の構造サーフェスは wcstack I/O ノード横断の規範です([async-io-node-guidelines §3.9](../../docs/async-io-node-guidelines.md))。要素なしで signals に束縛するには [@wcstack/signals — Core を直接束縛する](../signals/README.ja.md#core-を直接束縛する要素なし) を参照。
206
+ Core の構造サーフェスは wcstack I/O ノード横断の規範です([async-io-node-guidelines §3.9](../../docs/async-io-node-guidelines.ja.md))。要素なしで signals に束縛するには [@wcstack/signals — Core を直接束縛する](../signals/README.ja.md#core-を直接束縛する要素なし) を参照。
207
207
 
208
208
  ## ライセンス
209
209
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wcstack/network",
3
- "version": "1.26.0",
3
+ "version": "1.28.0",
4
4
  "description": "Declarative Network Information component for Web Components. Framework-agnostic navigator.connection monitor via wc-bindable-protocol.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.esm.js",