@wcstack/network 1.16.0

package/README.ja.md

@@ -0,0 +1,167 @@
+# @wcstack/network
+
+`@wcstack/network` は wcstack エコシステム向けのヘッドレスな Network Information コンポーネントです。
+
+視覚的な UI ウィジェットではありません。
+`@wcstack/permission` がパーミッション許可状態をリアクティブな state に変えるのと同じように、ブラウザの回線品質シグナルをリアクティブな state に変える **非同期プリミティブノード** です。
+
+`@wcstack/state` と組み合わせると、`<wcs-network>` はパス契約で直接バインドできます:
+
+- **入力サーフェス**: 無し — `navigator.connection` は設定すべきものを持たない単一のグローバル
+- **出力 state サーフェス**: `effectiveType`、`downlink`、`rtt`、`saveData`、`supported`
+
+これにより、適応的な読み込み制御（低速回線時の画像品質低下、データセーバー時の自動再生停止）を、UI 層で `navigator.connection` や `change` リスナーの配線を書かずに、HTML 上で宣言的に表現できます。
+
+`@wcstack/network` は [CSBC](https://github.com/csbc-dev/arch/blob/main/README.md)（Core / Shell / Binding Contract）アーキテクチャに従います:
+
+- **Core**（`NetworkCore`）が `navigator.connection` を読み取り、live な `change` イベントを追従
+- **Shell**（`<wcs-network>`）がその state を DOM ライフサイクルに接続
+- **Binding Contract**（`static wcBindable`）が観測可能な `properties` を宣言（そして意図的に **コマンドも属性も持たない**）
+
+## なぜ存在するか — wcstack で最小の Shell、そして unsupported が常態
+
+他の wcstack IO ノードはいずれも何かしらを設定する（`target`、`name`、`url`）。`navigator.connection` は指し示す対象を持たない単一のグローバルオブジェクトなので、`<wcs-network>` は **属性を一切持ちません**。
+
+さらに重要な点として、**Firefox と Safari は `navigator.connection` を実装していません。** 大半の IO ノードでは unsupported は稀なフォールバックですが、本ノードでは多くのユーザーにとって既定の現実です。「発火すれば使う、発火しなければ既定の挙動にフォールバックする」という漸進的強化を前提に UI を設計してください。このデータが必ず得られる前提で組んではいけません。
+
+> **secure context 不要。** `@wcstack/geolocation` や `@wcstack/permission` と異なり、Network Information API に secure-context 制約はありません。
+
+## インストール
+
+```bash
+npm install @wcstack/network
+```
+
+## クイックスタート
+
+### 1. 回線品質に応じた画像品質の切り替え
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/network/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      effectiveType: null,
+      get lowQuality() {
+        return this.effectiveType === "2g" || this.effectiveType === "slow-2g";
+      },
+      get imgSrc() {
+        return this.lowQuality ? "/thumb.jpg" : "/full.jpg";
+      },
+      // 初回スナップショットはバインド確立前に発火するため、一度だけ pull する（「注意・制限」参照）。
+      async $connectedCallback() {
+        await customElements.whenDefined("wcs-network");
+        this.effectiveType = document.querySelector("wcs-network").effectiveType;
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-network data-wcs="effectiveType: effectiveType"></wcs-network>
+
+<img data-wcs="attr.src: imgSrc">
+```
+
+このページの全例に共通するタイミング規則が1つあります: `<wcs-network>` はスナップショットを `wcs-network:change` イベントで公開しますが、*初回*のスナップショットは接続時に同期発火するため、`@wcstack/state` がバインドリスナーを張るより先に流れてしまい、バインドしたパスは*次*の回線変化からしか更新されません。上の `$connectedCallback` ブロックはその初回スナップショットを一度だけ pull しています。これが無いと、読込時点で既に低速回線だった場合にページが適応しません（「注意・制限」参照）。
+
+### 2. データセーバーを尊重する
+
+```html
+<wcs-state>
+  <script type="module">
+    export default {
+      saveData: null,
+      // 例1と同じ初期 pull — 読込時点で既にデータセーバーONの場合があるため。
+      async $connectedCallback() {
+        await customElements.whenDefined("wcs-network");
+        this.saveData = document.querySelector("wcs-network").saveData;
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-network data-wcs="saveData: saveData"></wcs-network>
+<video data-wcs="autoplay: saveData|falsy" muted loop></video>
+```
+
+`saveData` は `boolean | null`（未知・非対応の間は `null`）なので、boolean 限定の `|not` ではなく null 許容の `|falsy` フィルタを使います: データセーバーが有効と*判明*しない限り autoplay を維持する、という漸進的強化の既定動作になります。`autoplay` を `attr.autoplay` でなくプロパティとしてバインドしているのは、boolean content attribute は属性バインドでは無効化（属性削除）できないためです。
+
+### 3. 非対応環境では回線品質 UI を隠す
+
+```html
+<wcs-state>
+  <script type="module">
+    export default {
+      netSupported: false,
+      effectiveType: null,
+      async $connectedCallback() {
+        await customElements.whenDefined("wcs-network");
+        const net = document.querySelector("wcs-network");
+        this.netSupported = net.supported;
+        this.effectiveType = net.effectiveType;
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-network data-wcs="supported: netSupported; effectiveType: effectiveType"></wcs-network>
+<div data-wcs="hidden: netSupported|not">回線: <span data-wcs="textContent: effectiveType"></span></div>
+```
+
+バインドする state パスは必ず事前に宣言してください — 未宣言パスへのバインドは初期化時に例外になります。例2の `saveData` と異なり `supported` は厳密な boolean（`null` になり得ない）なので、ここでは `|not` が安全です。この例では初期 pull が*必須*です: `supported` は接続時に一度だけ確定し、安定した回線では以後 `change` が二度と発火しないため、pull が無いと対応ブラウザでも UI が永久に隠れたままになります。非対応ブラウザでは pull が `false` を読むだけなので、UI はそのまま隠れ続けます。
+
+## 観測可能プロパティ（出力）
+
+| プロパティ       | イベント             | 説明 |
+| ---------------- | -------------------- | ---- |
+| `effectiveType`  | `wcs-network:change` | `"slow-2g"` / `"2g"` / `"3g"` / `"4g"`、非対応環境では `null`。 |
+| `downlink`       | `wcs-network:change` | 概算ダウンリンク帯域（Mbps）、非対応環境では `null`。 |
+| `rtt`            | `wcs-network:change` | 概算往復遅延（ms）、非対応環境では `null`。 |
+| `saveData`       | `wcs-network:change` | ユーザーがデータセーバーモードを有効にしていれば `true`、非対応環境では `null`。 |
+| `supported`      | `wcs-network:change` | 実在する `navigator.connection` が見つかれば `true`、それ以外は `false`。 |
+
+5 つすべては単一の `wcs-network:change` イベントから派生します（ネイティブ API が全フィールドを1つの `change` イベントで報告するのと同じく、スナップショット全体を1つのイベントにまとめて発火します）。また、`supported` が `true` の環境でも、ブラウザが該当フィールドを欠落または期待外の型で報告した場合、4 つのデータフィールドは個別に `null` へ正規化されます。
+
+`downlinkMax` と接続種別（wifi/cellular等）の `type` は意図的に公開していません — 理由は `docs/network-tag-design.md` §2 を参照（実用上の使用例が乏しい、`type` はfingerprinting対策によりブラウザ間で信頼性が低い）。
+
+## コマンド
+
+**無し。** `navigator.connection` は read-only で、呼ぶべきアクションがありません。`<wcs-network>` は純粋なモニタです。
+
+## 属性 / 入力
+
+**無し。** `navigator.connection` は単一のグローバルであり、インスタンスごとに設定すべきものがありません。
+
+## 注意・制限
+
+- **Firefox と Safari は `navigator.connection` を実装していません。** これらのブラウザでは `supported` は `false` のまま、他の4プロパティは `null` のままです — これを例外ケースでなく常態として設計してください。
+- **初回スナップショットはバインドに届きません。** 最初の `wcs-network:change` は `connectedCallback` 中に同期発火しますが、`@wcstack/state` のバインドリスナー確立はそれより後です（バインド構築は後続の microtask に遅延 — `docs/timing-and-firing-contract.md` §4.1 参照）。イベントは後から購読した相手に再送されないため、バインドしたパスは*次*の回線変化からしか更新されません。初期値が重要な場合（`supported` と `saveData` ではほぼ常に重要）は、クイックスタートの各例のように `$connectedCallback` で一度だけ pull してください。これは全 monitor ノード共通の wc-bindable イベント契約の性質であり、本パッケージ固有の癖ではありません。
+- **`_gen` 世代ガードが無い。** 他の大半の wcstack IO ノードと異なり、`navigator.connection` の `change` イベント購読・購読解除は完全に同期的です。dispose() とレースしうる非同期probeの解決が存在しません。詳細は `docs/network-tag-design.md` §5。
+- **再接続で再購読。** 要素を取り外して再挿入すると、切断時に `change` リスナーを解除し、再接続時に（その時点の `navigator.connection` に対して）再確立します。
+- **SSR（`@wcstack/server`）。** `static hasConnectedCallbackPromise = true` を宣言し `connectedCallbackPromise` を公開しますが、`observe()` が同期的なため、この promise は常に即座に settle します。
+- **同値ガード。** ブラウザが万一同じ値で `change` を重複発火しても、フィールド単位の防御的比較により冗長な dispatch を抑止します。
+
+## ヘッドレス利用（`NetworkCore`）
+
+Core は DOM 非依存で、`@wc-bindable/core` の `bind()` と直接使えます:
+
+```typescript
+import { NetworkCore } from "@wcstack/network";
+
+const net = new NetworkCore();
+net.addEventListener("wcs-network:change", (e) => {
+  console.log((e as CustomEvent).detail); // { effectiveType, downlink, rtt, saveData, supported }
+});
+
+net.observe();           // 同期的 — データ取得にpromiseを待つ必要は無い
+console.log(net.effectiveType);
+
+// 後始末:
+net.dispose();           // live な `change` リスナーを外す
+```
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,167 @@
+# @wcstack/network
+
+`@wcstack/network` is a headless Network Information component for the wcstack ecosystem.
+
+It is not a visual UI widget.
+It is an **async primitive node** that turns the browser's connection-quality signal into reactive state — the same way `@wcstack/permission` turns a permission grant into reactive state.
+
+With `@wcstack/state`, `<wcs-network>` can be bound directly through path contracts:
+
+- **input surface**: none — `navigator.connection` is a single global with nothing to configure
+- **output state surface**: `effectiveType`, `downlink`, `rtt`, `saveData`, `supported`
+
+This means adaptive-loading UI — lower image quality on a slow connection, pausing autoplay when Data Saver is on — can be expressed declaratively in HTML, without writing `navigator.connection` or `change`-listener glue in your UI layer.
+
+`@wcstack/network` follows the [CSBC](https://github.com/csbc-dev/arch/blob/main/README.md) (Core / Shell / Binding Contract) architecture:
+
+- **Core** (`NetworkCore`) reads `navigator.connection` and tracks its live `change` event
+- **Shell** (`<wcs-network>`) connects that state to DOM lifecycle
+- **Binding Contract** (`static wcBindable`) declares observable `properties` (and, deliberately, **no commands and no inputs**)
+
+## Why this exists — the smallest Shell in wcstack, and unsupported is the common case
+
+Every other wcstack IO node configures *something* (a `target`, a `name`, a `url`). `navigator.connection` is a single global object with nothing to point at, so `<wcs-network>` takes **no attributes at all**.
+
+More importantly: **Firefox and Safari do not implement `navigator.connection`.** Unlike most IO nodes, where "unsupported" is a rare fallback, here it is the default reality for a large share of users. Design your UI around graceful degradation — "if it fires, use it; if it never fires, fall back to sensible defaults" — not around the assumption that this data will be available.
+
+> **No secure-context requirement.** Unlike `@wcstack/geolocation` or `@wcstack/permission`, the Network Information API has no secure-context restriction.
+
+## Install
+
+```bash
+npm install @wcstack/network
+```
+
+## Quick Start
+
+### 1. Adaptive image quality
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/network/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      effectiveType: null,
+      get lowQuality() {
+        return this.effectiveType === "2g" || this.effectiveType === "slow-2g";
+      },
+      get imgSrc() {
+        return this.lowQuality ? "/thumb.jpg" : "/full.jpg";
+      },
+      // The initial snapshot fires before bindings attach — pull it once (see Notes).
+      async $connectedCallback() {
+        await customElements.whenDefined("wcs-network");
+        this.effectiveType = document.querySelector("wcs-network").effectiveType;
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-network data-wcs="effectiveType: effectiveType"></wcs-network>
+
+<img data-wcs="attr.src: imgSrc">
+```
+
+One timing rule applies to every example on this page: `<wcs-network>` publishes its snapshot through `wcs-network:change` events, and the *first* snapshot fires synchronously at connect — before `@wcstack/state` has attached its binding listeners — so bound paths only start updating from the *next* connection change. The `$connectedCallback` block pulls that initial snapshot once; without it, this page would not adapt when the connection is already slow at load time (see Notes & limitations).
+
+### 2. Respect Data Saver
+
+```html
+<wcs-state>
+  <script type="module">
+    export default {
+      saveData: null,
+      // Initial pull, as in example 1 — Data Saver may already be on at load time.
+      async $connectedCallback() {
+        await customElements.whenDefined("wcs-network");
+        this.saveData = document.querySelector("wcs-network").saveData;
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-network data-wcs="saveData: saveData"></wcs-network>
+<video data-wcs="autoplay: saveData|falsy" muted loop></video>
+```
+
+`saveData` is `boolean | null` (`null` while unknown or unsupported), so the null-tolerant `|falsy` filter is used instead of the boolean-only `|not`: autoplay stays on unless Data Saver is *known* to be on — the graceful-degradation default. `autoplay` is bound as a property (not `attr.autoplay`) because a boolean content attribute cannot be switched off through an attribute binding.
+
+### 3. Hide connection-quality UI when unsupported
+
+```html
+<wcs-state>
+  <script type="module">
+    export default {
+      netSupported: false,
+      effectiveType: null,
+      async $connectedCallback() {
+        await customElements.whenDefined("wcs-network");
+        const net = document.querySelector("wcs-network");
+        this.netSupported = net.supported;
+        this.effectiveType = net.effectiveType;
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-network data-wcs="supported: netSupported; effectiveType: effectiveType"></wcs-network>
+<div data-wcs="hidden: netSupported|not">Connection: <span data-wcs="textContent: effectiveType"></span></div>
+```
+
+Every bound state path must be declared up front — binding an undeclared path throws at initialization. Unlike `saveData` above, `supported` is a strict boolean (never `null`), so `|not` is safe here. The initial pull is *essential* in this example: `supported` is set exactly once at connect, and a stable connection never fires another `change` — without the pull the UI would stay hidden forever even in supporting browsers. In an unsupported browser the pull reads `false`, so the UI simply stays hidden.
+
+## Observable Properties (outputs)
+
+| Property        | Event               | Description |
+| ---------------- | -------------------- | ------------ |
+| `effectiveType`  | `wcs-network:change` | `"slow-2g"` / `"2g"` / `"3g"` / `"4g"`, or `null` when unsupported. |
+| `downlink`       | `wcs-network:change` | Estimated downlink bandwidth in Mbps, or `null` when unsupported. |
+| `rtt`            | `wcs-network:change` | Estimated round-trip time in ms, or `null` when unsupported. |
+| `saveData`       | `wcs-network:change` | `true` when the user has enabled Data Saver mode, or `null` when unsupported. |
+| `supported`      | `wcs-network:change` | `true` once a real `navigator.connection` was found; `false` otherwise. |
+
+All five derive from the single `wcs-network:change` event (a full snapshot dispatched together, mirroring how the native API reports all fields on one `change` event). The four data fields also normalize to `null` individually — even when `supported` is `true` — if the browser reports a field as missing or with an unexpected type.
+
+`downlinkMax` and connection `type` (wifi/cellular/…) are intentionally not surfaced — see `docs/network-tag-design.md` §2 for the rationale (low real-world utility, and `type` is unreliable across browsers for fingerprinting-mitigation reasons).
+
+## Commands
+
+**None.** `navigator.connection` is read-only — there is no action to invoke. `<wcs-network>` is a pure monitor.
+
+## Attributes / Inputs
+
+**None.** `navigator.connection` is a single global; there is nothing per-instance to configure.
+
+## Notes & limitations
+
+- **Firefox and Safari do not implement `navigator.connection`.** `supported` stays `false` and the other four properties stay `null` in those browsers — design around this as the common case, not an edge case.
+- **The initial snapshot does not reach bindings.** The first `wcs-network:change` fires synchronously during `connectedCallback` — before `@wcstack/state` attaches its binding listeners (binding setup is deferred to a later microtask; see `docs/timing-and-firing-contract.md` §4.1) — and events are not replayed to late subscribers, so bound paths update only from the *next* connection change. If the initial value matters (it almost always does for `supported` and `saveData`), pull it once in `$connectedCallback` as the Quick Start examples do. This is a property of the wc-bindable event contract shared by all monitor nodes, not a quirk of this package.
+- **No `_gen` generation guard.** Unlike most wcstack IO nodes, subscribing to `navigator.connection`'s `change` event is fully synchronous — there is no asynchronous probe whose stale resolution could race a `dispose()`. See `docs/network-tag-design.md` §5.
+- **Reconnect re-subscribes.** Removing and re-inserting the element tears down the `change` listener on disconnect and re-establishes it (against whatever `navigator.connection` currently is) on reconnect.
+- **SSR (`@wcstack/server`).** Declares `static hasConnectedCallbackPromise = true` and exposes `connectedCallbackPromise`, though since `observe()` is synchronous this promise always settles immediately.
+- **Same-value guard.** A defensive field-by-field comparison suppresses a redundant `change` dispatch if the browser were ever to fire `change` with identical values.
+
+## Headless usage (`NetworkCore`)
+
+The Core has no DOM dependency and can be used directly with `bind()` from `@wc-bindable/core`:
+
+```typescript
+import { NetworkCore } from "@wcstack/network";
+
+const net = new NetworkCore();
+net.addEventListener("wcs-network:change", (e) => {
+  console.log((e as CustomEvent).detail); // { effectiveType, downlink, rtt, saveData, supported }
+});
+
+net.observe();          // synchronous — no promise to await for data
+console.log(net.effectiveType);
+
+// later, when done:
+net.dispose();           // detach the live `change` listener
+```
+
+## License
+
+MIT

package/dist/auto.js

@@ -0,0 +1,3 @@
+import { bootstrapNetwork } from "./index.esm.js";
+
+bootstrapNetwork();

package/dist/auto.min.js

@@ -0,0 +1 @@
+import{bootstrapNetwork}from"./index.esm.min.js";bootstrapNetwork();

package/dist/index.d.ts

@@ -0,0 +1,132 @@
+interface IWcBindableProperty {
+    readonly name: string;
+    readonly event: string;
+    readonly getter?: (event: Event) => any;
+}
+interface IWcBindableInput {
+    readonly name: string;
+    readonly attribute?: string;
+}
+interface IWcBindableCommand {
+    readonly name: string;
+    readonly async?: boolean;
+}
+interface IWcBindable {
+    readonly protocol: "wc-bindable";
+    readonly version: 1;
+    readonly properties: readonly IWcBindableProperty[];
+    readonly inputs?: readonly IWcBindableInput[];
+    readonly commands?: readonly IWcBindableCommand[];
+}
+
+interface ITagNames {
+    readonly network: string;
+}
+interface IWritableTagNames {
+    network?: string;
+}
+interface IConfig {
+    readonly tagNames: ITagNames;
+}
+interface IWritableConfig {
+    tagNames?: IWritableTagNames;
+}
+
+/**
+ * A single snapshot of `navigator.connection` (Network Information API), or the
+ * unsupported default. `effectiveType`/`downlink`/`rtt`/`saveData` are `null`
+ * when the API is absent (`supported === false`) — and each also normalizes to
+ * `null` individually, even while `supported` is `true`, when the browser
+ * reports that field as missing or with an unexpected type; `downlinkMax` and
+ * `type` are intentionally not surfaced (see docs/network-tag-design.md §2).
+ */
+interface WcsNetworkSnapshot {
+    effectiveType: string | null;
+    downlink: number | null;
+    rtt: number | null;
+    saveData: boolean | null;
+    supported: boolean;
+}
+/**
+ * Value types for NetworkCore (headless) — the observable state properties.
+ * Use with `bind()` from a wc-bindable binding core for compile-time type checking.
+ *
+ * @example
+ * ```typescript
+ * const core = new NetworkCore();
+ * bind(core, (name: keyof WcsNetworkCoreValues, value) => { ... });
+ * ```
+ */
+type WcsNetworkCoreValues = WcsNetworkSnapshot;
+/**
+ * Value types for the Shell (`<wcs-network>`) — identical observable surface to
+ * the Core. The Shell adds no inputs and no commands: `navigator.connection` is a
+ * single global with nothing to configure and no request()-style action.
+ */
+type WcsNetworkValues = WcsNetworkCoreValues;
+
+declare function bootstrapNetwork(userConfig?: IWritableConfig): void;
+
+declare function getConfig(): IConfig;
+
+/**
+ * Headless Network Information primitive. A thin, framework-agnostic wrapper
+ * around `navigator.connection` exposed through the wc-bindable protocol.
+ *
+ * Unlike most wcstack IO nodes, this Core needs no `_gen` generation guard
+ * (§3.4): subscribing/unsubscribing to `navigator.connection`'s `change` event
+ * is fully synchronous, so there is no asynchronous probe whose stale
+ * resolution could race a dispose() (docs/network-tag-design.md §5).
+ *
+ * `navigator.connection` is unimplemented in Firefox/Safari — unsupported is
+ * the common case here, not an edge case (docs/network-tag-design.md §0). All
+ * four data fields collapse to `null` and `supported` to `false` in that case.
+ */
+declare class NetworkCore extends EventTarget {
+    static wcBindable: IWcBindable;
+    private _target;
+    private _snapshot;
+    private _connection;
+    private _subscribed;
+    private _ready;
+    constructor(target?: EventTarget);
+    get ready(): Promise<void>;
+    get effectiveType(): string | null;
+    get downlink(): number | null;
+    get rtt(): number | null;
+    get saveData(): boolean | null;
+    get supported(): boolean;
+    observe(): Promise<void>;
+    dispose(): void;
+    private _api;
+    private _read;
+    private _onChange;
+    private _apply;
+}
+
+/**
+ * `<wcs-network>` — declarative Network Information API monitor.
+ *
+ * The smallest Shell in the batch (docs/network-tag-design.md §9): no
+ * attributes at all. `navigator.connection` is a single global with nothing to
+ * configure, unlike target-based nodes (`intersection`/`resize`) or
+ * descriptor-based ones (`permission`).
+ */
+declare class WcsNetwork extends HTMLElement {
+    static hasConnectedCallbackPromise: boolean;
+    static wcBindable: IWcBindable;
+    private _core;
+    private _connectedCallbackPromise;
+    constructor();
+    get effectiveType(): string | null;
+    get downlink(): number | null;
+    get rtt(): number | null;
+    get saveData(): boolean | null;
+    get supported(): boolean;
+    get connectedCallbackPromise(): Promise<void>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}
+
+export { NetworkCore, WcsNetwork, bootstrapNetwork, getConfig };
+export type { IWritableConfig, IWritableTagNames, WcsNetworkCoreValues, WcsNetworkSnapshot, WcsNetworkValues };

package/dist/index.esm.js

@@ -0,0 +1,245 @@
+const _config = {
+    tagNames: {
+        network: "wcs-network",
+    },
+};
+function deepFreeze(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    Object.freeze(obj);
+    for (const key of Object.keys(obj)) {
+        deepFreeze(obj[key]);
+    }
+    return obj;
+}
+function deepClone(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    const clone = {};
+    for (const key of Object.keys(obj)) {
+        clone[key] = deepClone(obj[key]);
+    }
+    return clone;
+}
+let frozenConfig = null;
+const config = _config;
+function getConfig() {
+    if (!frozenConfig) {
+        frozenConfig = deepFreeze(deepClone(_config));
+    }
+    return frozenConfig;
+}
+function setConfig(partialConfig) {
+    if (partialConfig.tagNames) {
+        Object.assign(_config.tagNames, partialConfig.tagNames);
+    }
+    frozenConfig = null;
+}
+
+const UNSUPPORTED_SNAPSHOT = Object.freeze({
+    effectiveType: null,
+    downlink: null,
+    rtt: null,
+    saveData: null,
+    supported: false,
+});
+/**
+ * Headless Network Information primitive. A thin, framework-agnostic wrapper
+ * around `navigator.connection` exposed through the wc-bindable protocol.
+ *
+ * Unlike most wcstack IO nodes, this Core needs no `_gen` generation guard
+ * (§3.4): subscribing/unsubscribing to `navigator.connection`'s `change` event
+ * is fully synchronous, so there is no asynchronous probe whose stale
+ * resolution could race a dispose() (docs/network-tag-design.md §5).
+ *
+ * `navigator.connection` is unimplemented in Firefox/Safari — unsupported is
+ * the common case here, not an edge case (docs/network-tag-design.md §0). All
+ * four data fields collapse to `null` and `supported` to `false` in that case.
+ */
+class NetworkCore extends EventTarget {
+    static wcBindable = {
+        protocol: "wc-bindable",
+        version: 1,
+        properties: [
+            { name: "effectiveType", event: "wcs-network:change", getter: (e) => e.detail.effectiveType },
+            { name: "downlink", event: "wcs-network:change", getter: (e) => e.detail.downlink },
+            { name: "rtt", event: "wcs-network:change", getter: (e) => e.detail.rtt },
+            { name: "saveData", event: "wcs-network:change", getter: (e) => e.detail.saveData },
+            { name: "supported", event: "wcs-network:change", getter: (e) => e.detail.supported },
+        ],
+        // Pure monitor: navigator.connection has no request()/action method to invoke.
+        commands: [],
+    };
+    _target;
+    _snapshot = UNSUPPORTED_SNAPSHOT;
+    // The live NetworkInformation object the `change` listener is attached to (kept
+    // so dispose() can remove it precisely; not read for anything else).
+    _connection = null;
+    // True once observe() has attached the live listener (or determined there is
+    // nothing to attach to). Guards observe() so a redundant call does not
+    // re-subscribe; dispose() resets it so a later observe() resumes cleanly.
+    _subscribed = false;
+    // SSR (§3.8): no asynchronous probe to await — observe() completes
+    // synchronously, so readiness is immediate.
+    _ready = Promise.resolve();
+    constructor(target) {
+        super();
+        this._target = target ?? this;
+    }
+    get ready() {
+        return this._ready;
+    }
+    get effectiveType() {
+        return this._snapshot.effectiveType;
+    }
+    get downlink() {
+        return this._snapshot.downlink;
+    }
+    get rtt() {
+        return this._snapshot.rtt;
+    }
+    get saveData() {
+        return this._snapshot.saveData;
+    }
+    get supported() {
+        return this._snapshot.supported;
+    }
+    // Lifecycle (§3.5). Idempotent: a second observe() while already subscribed
+    // is a no-op (no double listener, no redundant dispatch). Synchronous overall
+    // (no probe to await), so the returned promise is only for API uniformity
+    // with other IO nodes.
+    observe() {
+        if (!this._subscribed) {
+            this._subscribed = true;
+            const api = this._api();
+            if (api) {
+                this._connection = api;
+                api.addEventListener("change", this._onChange);
+            }
+            this._apply(this._read());
+        }
+        return this._ready;
+    }
+    dispose() {
+        this._subscribed = false;
+        if (this._connection) {
+            this._connection.removeEventListener("change", this._onChange);
+            this._connection = null;
+        }
+    }
+    // API resolution is call-time, never cached (§3.7): lets tests install/remove
+    // navigator.connection freely and lets an unsupported environment be detected
+    // correctly on every observe()/reading.
+    _api() {
+        const nav = globalThis.navigator;
+        return typeof nav !== "undefined" && nav.connection ? nav.connection : undefined;
+    }
+    _read() {
+        const c = this._api();
+        if (!c) {
+            return UNSUPPORTED_SNAPSHOT;
+        }
+        return {
+            effectiveType: typeof c.effectiveType === "string" ? c.effectiveType : null,
+            downlink: typeof c.downlink === "number" ? c.downlink : null,
+            rtt: typeof c.rtt === "number" ? c.rtt : null,
+            saveData: typeof c.saveData === "boolean" ? c.saveData : null,
+            supported: true,
+        };
+    }
+    _onChange = () => {
+        this._apply(this._read());
+    };
+    // Same-value guard (§3.3 MUST): the native `change` event already fires only
+    // on a real change, but this Core still verifies field-by-field before
+    // dispatching — defense in depth against a browser quirk double-firing
+    // `change` with identical values.
+    _apply(next) {
+        const prev = this._snapshot;
+        if (prev.effectiveType === next.effectiveType &&
+            prev.downlink === next.downlink &&
+            prev.rtt === next.rtt &&
+            prev.saveData === next.saveData &&
+            prev.supported === next.supported) {
+            return;
+        }
+        this._snapshot = next;
+        this._target.dispatchEvent(new CustomEvent("wcs-network:change", {
+            detail: next,
+            // Family-wide MUST (async-io-node-guidelines.md §3.3): the event bubbles
+            // from the Shell element so document-level consumers can delegate.
+            bubbles: true,
+        }));
+    }
+}
+
+/**
+ * `<wcs-network>` — declarative Network Information API monitor.
+ *
+ * The smallest Shell in the batch (docs/network-tag-design.md §9): no
+ * attributes at all. `navigator.connection` is a single global with nothing to
+ * configure, unlike target-based nodes (`intersection`/`resize`) or
+ * descriptor-based ones (`permission`).
+ */
+class WcsNetwork extends HTMLElement {
+    // SSR (§4.4): observe() completes synchronously, but the Shell still exposes
+    // connectedCallbackPromise so SSR (@wcstack/server render.ts) can await it
+    // uniformly across all IO nodes before snapshotting the HTML. Mirrors
+    // WcsPermission.connectedCallbackPromise.
+    static hasConnectedCallbackPromise = true;
+    static wcBindable = {
+        ...NetworkCore.wcBindable,
+        inputs: [],
+        // Core の commands をそのまま継承（単一情報源）。permission と同型。
+        commands: NetworkCore.wcBindable.commands,
+    };
+    _core;
+    _connectedCallbackPromise = Promise.resolve();
+    constructor() {
+        super();
+        this._core = new NetworkCore(this);
+    }
+    // --- Core delegated getters ---
+    get effectiveType() {
+        return this._core.effectiveType;
+    }
+    get downlink() {
+        return this._core.downlink;
+    }
+    get rtt() {
+        return this._core.rtt;
+    }
+    get saveData() {
+        return this._core.saveData;
+    }
+    get supported() {
+        return this._core.supported;
+    }
+    get connectedCallbackPromise() {
+        return this._connectedCallbackPromise;
+    }
+    // --- Lifecycle ---
+    connectedCallback() {
+        this.style.display = "none";
+        this._connectedCallbackPromise = this._core.observe();
+    }
+    disconnectedCallback() {
+        this._core.dispose();
+    }
+}
+
+function registerComponents() {
+    if (!customElements.get(config.tagNames.network)) {
+        customElements.define(config.tagNames.network, WcsNetwork);
+    }
+}
+
+function bootstrapNetwork(userConfig) {
+    if (userConfig) {
+        setConfig(userConfig);
+    }
+    registerComponents();
+}
+
+export { NetworkCore, WcsNetwork, bootstrapNetwork, getConfig };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/core/NetworkCore.ts","../src/components/Network.ts","../src/registerComponents.ts","../src/bootstrapNetwork.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    network: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    network: \"wcs-network\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IWcBindable, WcsNetworkSnapshot } from \"../types.js\";\n\nconst UNSUPPORTED_SNAPSHOT: WcsNetworkSnapshot = Object.freeze({\n  effectiveType: null,\n  downlink: null,\n  rtt: null,\n  saveData: null,\n  supported: false,\n});\n\n/**\n * Headless Network Information primitive. A thin, framework-agnostic wrapper\n * around `navigator.connection` exposed through the wc-bindable protocol.\n *\n * Unlike most wcstack IO nodes, this Core needs no `_gen` generation guard\n * (§3.4): subscribing/unsubscribing to `navigator.connection`'s `change` event\n * is fully synchronous, so there is no asynchronous probe whose stale\n * resolution could race a dispose() (docs/network-tag-design.md §5).\n *\n * `navigator.connection` is unimplemented in Firefox/Safari — unsupported is\n * the common case here, not an edge case (docs/network-tag-design.md §0). All\n * four data fields collapse to `null` and `supported` to `false` in that case.\n */\nexport class NetworkCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"effectiveType\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.effectiveType },\n      { name: \"downlink\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.downlink },\n      { name: \"rtt\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.rtt },\n      { name: \"saveData\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.saveData },\n      { name: \"supported\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.supported },\n    ],\n    // Pure monitor: navigator.connection has no request()/action method to invoke.\n    commands: [],\n  };\n\n  private _target: EventTarget;\n  private _snapshot: WcsNetworkSnapshot = UNSUPPORTED_SNAPSHOT;\n\n  // The live NetworkInformation object the `change` listener is attached to (kept\n  // so dispose() can remove it precisely; not read for anything else).\n  private _connection: EventTarget | null = null;\n\n  // True once observe() has attached the live listener (or determined there is\n  // nothing to attach to). Guards observe() so a redundant call does not\n  // re-subscribe; dispose() resets it so a later observe() resumes cleanly.\n  private _subscribed = false;\n\n  // SSR (§3.8): no asynchronous probe to await — observe() completes\n  // synchronously, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  get effectiveType(): string | null {\n    return this._snapshot.effectiveType;\n  }\n\n  get downlink(): number | null {\n    return this._snapshot.downlink;\n  }\n\n  get rtt(): number | null {\n    return this._snapshot.rtt;\n  }\n\n  get saveData(): boolean | null {\n    return this._snapshot.saveData;\n  }\n\n  get supported(): boolean {\n    return this._snapshot.supported;\n  }\n\n  // Lifecycle (§3.5). Idempotent: a second observe() while already subscribed\n  // is a no-op (no double listener, no redundant dispatch). Synchronous overall\n  // (no probe to await), so the returned promise is only for API uniformity\n  // with other IO nodes.\n  observe(): Promise<void> {\n    if (!this._subscribed) {\n      this._subscribed = true;\n      const api = this._api();\n      if (api) {\n        this._connection = api;\n        api.addEventListener(\"change\", this._onChange);\n      }\n      this._apply(this._read());\n    }\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._subscribed = false;\n    if (this._connection) {\n      this._connection.removeEventListener(\"change\", this._onChange);\n      this._connection = null;\n    }\n  }\n\n  // API resolution is call-time, never cached (§3.7): lets tests install/remove\n  // navigator.connection freely and lets an unsupported environment be detected\n  // correctly on every observe()/reading.\n  private _api(): (EventTarget & { effectiveType?: string; downlink?: number; rtt?: number; saveData?: boolean }) | undefined {\n    const nav = (globalThis as any).navigator;\n    return typeof nav !== \"undefined\" && nav.connection ? nav.connection : undefined;\n  }\n\n  private _read(): WcsNetworkSnapshot {\n    const c = this._api();\n    if (!c) {\n      return UNSUPPORTED_SNAPSHOT;\n    }\n    return {\n      effectiveType: typeof c.effectiveType === \"string\" ? c.effectiveType : null,\n      downlink: typeof c.downlink === \"number\" ? c.downlink : null,\n      rtt: typeof c.rtt === \"number\" ? c.rtt : null,\n      saveData: typeof c.saveData === \"boolean\" ? c.saveData : null,\n      supported: true,\n    };\n  }\n\n  private _onChange = (): void => {\n    this._apply(this._read());\n  };\n\n  // Same-value guard (§3.3 MUST): the native `change` event already fires only\n  // on a real change, but this Core still verifies field-by-field before\n  // dispatching — defense in depth against a browser quirk double-firing\n  // `change` with identical values.\n  private _apply(next: WcsNetworkSnapshot): void {\n    const prev = this._snapshot;\n    if (\n      prev.effectiveType === next.effectiveType &&\n      prev.downlink === next.downlink &&\n      prev.rtt === next.rtt &&\n      prev.saveData === next.saveData &&\n      prev.supported === next.supported\n    ) {\n      return;\n    }\n    this._snapshot = next;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-network:change\", {\n      detail: next,\n      // Family-wide MUST (async-io-node-guidelines.md §3.3): the event bubbles\n      // from the Shell element so document-level consumers can delegate.\n      bubbles: true,\n    }));\n  }\n}\n","import { IWcBindable } from \"../types.js\";\nimport { NetworkCore } from \"../core/NetworkCore.js\";\n\n/**\n * `<wcs-network>` — declarative Network Information API monitor.\n *\n * The smallest Shell in the batch (docs/network-tag-design.md §9): no\n * attributes at all. `navigator.connection` is a single global with nothing to\n * configure, unlike target-based nodes (`intersection`/`resize`) or\n * descriptor-based ones (`permission`).\n */\nexport class WcsNetwork extends HTMLElement {\n  // SSR (§4.4): observe() completes synchronously, but the Shell still exposes\n  // connectedCallbackPromise so SSR (@wcstack/server render.ts) can await it\n  // uniformly across all IO nodes before snapshotting the HTML. Mirrors\n  // WcsPermission.connectedCallbackPromise.\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...NetworkCore.wcBindable,\n    inputs: [],\n    // Core の commands をそのまま継承（単一情報源）。permission と同型。\n    commands: NetworkCore.wcBindable.commands,\n  };\n\n  private _core: NetworkCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new NetworkCore(this);\n  }\n\n  // --- Core delegated getters ---\n\n  get effectiveType(): string | null {\n    return this._core.effectiveType;\n  }\n\n  get downlink(): number | null {\n    return this._core.downlink;\n  }\n\n  get rtt(): number | null {\n    return this._core.rtt;\n  }\n\n  get saveData(): boolean | null {\n    return this._core.saveData;\n  }\n\n  get supported(): boolean {\n    return this._core.supported;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Lifecycle ---\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    this._connectedCallbackPromise = this._core.observe();\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { WcsNetwork } from \"./components/Network.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.network)) {\n    customElements.define(config.tagNames.network, WcsNetwork);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapNetwork(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n"],"names":[],"mappings":"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"}

package/dist/index.esm.min.js

@@ -0,0 +1,2 @@
+const e={tagNames:{network:"wcs-network"}};function t(e){if(null===e||"object"!=typeof e)return e;Object.freeze(e);for(const n of Object.keys(e))t(e[n]);return e}function n(e){if(null===e||"object"!=typeof e)return e;const t={};for(const s of Object.keys(e))t[s]=n(e[s]);return t}let s=null;const o=e;function r(){return s||(s=t(n(e))),s}const a=Object.freeze({effectiveType:null,downlink:null,rtt:null,saveData:null,supported:!1});class i extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"effectiveType",event:"wcs-network:change",getter:e=>e.detail.effectiveType},{name:"downlink",event:"wcs-network:change",getter:e=>e.detail.downlink},{name:"rtt",event:"wcs-network:change",getter:e=>e.detail.rtt},{name:"saveData",event:"wcs-network:change",getter:e=>e.detail.saveData},{name:"supported",event:"wcs-network:change",getter:e=>e.detail.supported}],commands:[]};_target;_snapshot=a;_connection=null;_subscribed=!1;_ready=Promise.resolve();constructor(e){super(),this._target=e??this}get ready(){return this._ready}get effectiveType(){return this._snapshot.effectiveType}get downlink(){return this._snapshot.downlink}get rtt(){return this._snapshot.rtt}get saveData(){return this._snapshot.saveData}get supported(){return this._snapshot.supported}observe(){if(!this._subscribed){this._subscribed=!0;const e=this._api();e&&(this._connection=e,e.addEventListener("change",this._onChange)),this._apply(this._read())}return this._ready}dispose(){this._subscribed=!1,this._connection&&(this._connection.removeEventListener("change",this._onChange),this._connection=null)}_api(){const e=globalThis.navigator;return void 0!==e&&e.connection?e.connection:void 0}_read(){const e=this._api();return e?{effectiveType:"string"==typeof e.effectiveType?e.effectiveType:null,downlink:"number"==typeof e.downlink?e.downlink:null,rtt:"number"==typeof e.rtt?e.rtt:null,saveData:"boolean"==typeof e.saveData?e.saveData:null,supported:!0}:a}_onChange=()=>{this._apply(this._read())};_apply(e){const t=this._snapshot;t.effectiveType===e.effectiveType&&t.downlink===e.downlink&&t.rtt===e.rtt&&t.saveData===e.saveData&&t.supported===e.supported||(this._snapshot=e,this._target.dispatchEvent(new CustomEvent("wcs-network:change",{detail:e,bubbles:!0})))}}class c extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...i.wcBindable,inputs:[],commands:i.wcBindable.commands};_core;_connectedCallbackPromise=Promise.resolve();constructor(){super(),this._core=new i(this)}get effectiveType(){return this._core.effectiveType}get downlink(){return this._core.downlink}get rtt(){return this._core.rtt}get saveData(){return this._core.saveData}get supported(){return this._core.supported}get connectedCallbackPromise(){return this._connectedCallbackPromise}connectedCallback(){this.style.display="none",this._connectedCallbackPromise=this._core.observe()}disconnectedCallback(){this._core.dispose()}}function l(t){var n;t&&((n=t).tagNames&&Object.assign(e.tagNames,n.tagNames),s=null),customElements.get(o.tagNames.network)||customElements.define(o.tagNames.network,c)}export{i as NetworkCore,c as WcsNetwork,l as bootstrapNetwork,r as getConfig};
+//# sourceMappingURL=index.esm.min.js.map

package/dist/index.esm.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.min.js","sources":["../src/config.ts","../src/core/NetworkCore.ts","../src/components/Network.ts","../src/bootstrapNetwork.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    network: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    network: \"wcs-network\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IWcBindable, WcsNetworkSnapshot } from \"../types.js\";\n\nconst UNSUPPORTED_SNAPSHOT: WcsNetworkSnapshot = Object.freeze({\n  effectiveType: null,\n  downlink: null,\n  rtt: null,\n  saveData: null,\n  supported: false,\n});\n\n/**\n * Headless Network Information primitive. A thin, framework-agnostic wrapper\n * around `navigator.connection` exposed through the wc-bindable protocol.\n *\n * Unlike most wcstack IO nodes, this Core needs no `_gen` generation guard\n * (§3.4): subscribing/unsubscribing to `navigator.connection`'s `change` event\n * is fully synchronous, so there is no asynchronous probe whose stale\n * resolution could race a dispose() (docs/network-tag-design.md §5).\n *\n * `navigator.connection` is unimplemented in Firefox/Safari — unsupported is\n * the common case here, not an edge case (docs/network-tag-design.md §0). All\n * four data fields collapse to `null` and `supported` to `false` in that case.\n */\nexport class NetworkCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"effectiveType\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.effectiveType },\n      { name: \"downlink\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.downlink },\n      { name: \"rtt\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.rtt },\n      { name: \"saveData\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.saveData },\n      { name: \"supported\", event: \"wcs-network:change\", getter: (e: Event) => (e as CustomEvent).detail.supported },\n    ],\n    // Pure monitor: navigator.connection has no request()/action method to invoke.\n    commands: [],\n  };\n\n  private _target: EventTarget;\n  private _snapshot: WcsNetworkSnapshot = UNSUPPORTED_SNAPSHOT;\n\n  // The live NetworkInformation object the `change` listener is attached to (kept\n  // so dispose() can remove it precisely; not read for anything else).\n  private _connection: EventTarget | null = null;\n\n  // True once observe() has attached the live listener (or determined there is\n  // nothing to attach to). Guards observe() so a redundant call does not\n  // re-subscribe; dispose() resets it so a later observe() resumes cleanly.\n  private _subscribed = false;\n\n  // SSR (§3.8): no asynchronous probe to await — observe() completes\n  // synchronously, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  get effectiveType(): string | null {\n    return this._snapshot.effectiveType;\n  }\n\n  get downlink(): number | null {\n    return this._snapshot.downlink;\n  }\n\n  get rtt(): number | null {\n    return this._snapshot.rtt;\n  }\n\n  get saveData(): boolean | null {\n    return this._snapshot.saveData;\n  }\n\n  get supported(): boolean {\n    return this._snapshot.supported;\n  }\n\n  // Lifecycle (§3.5). Idempotent: a second observe() while already subscribed\n  // is a no-op (no double listener, no redundant dispatch). Synchronous overall\n  // (no probe to await), so the returned promise is only for API uniformity\n  // with other IO nodes.\n  observe(): Promise<void> {\n    if (!this._subscribed) {\n      this._subscribed = true;\n      const api = this._api();\n      if (api) {\n        this._connection = api;\n        api.addEventListener(\"change\", this._onChange);\n      }\n      this._apply(this._read());\n    }\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._subscribed = false;\n    if (this._connection) {\n      this._connection.removeEventListener(\"change\", this._onChange);\n      this._connection = null;\n    }\n  }\n\n  // API resolution is call-time, never cached (§3.7): lets tests install/remove\n  // navigator.connection freely and lets an unsupported environment be detected\n  // correctly on every observe()/reading.\n  private _api(): (EventTarget & { effectiveType?: string; downlink?: number; rtt?: number; saveData?: boolean }) | undefined {\n    const nav = (globalThis as any).navigator;\n    return typeof nav !== \"undefined\" && nav.connection ? nav.connection : undefined;\n  }\n\n  private _read(): WcsNetworkSnapshot {\n    const c = this._api();\n    if (!c) {\n      return UNSUPPORTED_SNAPSHOT;\n    }\n    return {\n      effectiveType: typeof c.effectiveType === \"string\" ? c.effectiveType : null,\n      downlink: typeof c.downlink === \"number\" ? c.downlink : null,\n      rtt: typeof c.rtt === \"number\" ? c.rtt : null,\n      saveData: typeof c.saveData === \"boolean\" ? c.saveData : null,\n      supported: true,\n    };\n  }\n\n  private _onChange = (): void => {\n    this._apply(this._read());\n  };\n\n  // Same-value guard (§3.3 MUST): the native `change` event already fires only\n  // on a real change, but this Core still verifies field-by-field before\n  // dispatching — defense in depth against a browser quirk double-firing\n  // `change` with identical values.\n  private _apply(next: WcsNetworkSnapshot): void {\n    const prev = this._snapshot;\n    if (\n      prev.effectiveType === next.effectiveType &&\n      prev.downlink === next.downlink &&\n      prev.rtt === next.rtt &&\n      prev.saveData === next.saveData &&\n      prev.supported === next.supported\n    ) {\n      return;\n    }\n    this._snapshot = next;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-network:change\", {\n      detail: next,\n      // Family-wide MUST (async-io-node-guidelines.md §3.3): the event bubbles\n      // from the Shell element so document-level consumers can delegate.\n      bubbles: true,\n    }));\n  }\n}\n","import { IWcBindable } from \"../types.js\";\nimport { NetworkCore } from \"../core/NetworkCore.js\";\n\n/**\n * `<wcs-network>` — declarative Network Information API monitor.\n *\n * The smallest Shell in the batch (docs/network-tag-design.md §9): no\n * attributes at all. `navigator.connection` is a single global with nothing to\n * configure, unlike target-based nodes (`intersection`/`resize`) or\n * descriptor-based ones (`permission`).\n */\nexport class WcsNetwork extends HTMLElement {\n  // SSR (§4.4): observe() completes synchronously, but the Shell still exposes\n  // connectedCallbackPromise so SSR (@wcstack/server render.ts) can await it\n  // uniformly across all IO nodes before snapshotting the HTML. Mirrors\n  // WcsPermission.connectedCallbackPromise.\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...NetworkCore.wcBindable,\n    inputs: [],\n    // Core の commands をそのまま継承（単一情報源）。permission と同型。\n    commands: NetworkCore.wcBindable.commands,\n  };\n\n  private _core: NetworkCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new NetworkCore(this);\n  }\n\n  // --- Core delegated getters ---\n\n  get effectiveType(): string | null {\n    return this._core.effectiveType;\n  }\n\n  get downlink(): number | null {\n    return this._core.downlink;\n  }\n\n  get rtt(): number | null {\n    return this._core.rtt;\n  }\n\n  get saveData(): boolean | null {\n    return this._core.saveData;\n  }\n\n  get supported(): boolean {\n    return this._core.supported;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Lifecycle ---\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    this._connectedCallbackPromise = this._core.observe();\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapNetwork(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { WcsNetwork } from \"./components/Network.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.network)) {\n    customElements.define(config.tagNames.network, WcsNetwork);\n  }\n}\n"],"names":["_config","tagNames","network","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","UNSUPPORTED_SNAPSHOT","effectiveType","downlink","rtt","saveData","supported","NetworkCore","EventTarget","static","protocol","version","properties","name","event","getter","e","detail","commands","_target","_snapshot","_connection","_subscribed","_ready","Promise","resolve","constructor","target","super","this","ready","observe","api","_api","addEventListener","_onChange","_apply","_read","dispose","removeEventListener","nav","globalThis","navigator","connection","undefined","c","next","prev","dispatchEvent","CustomEvent","bubbles","WcsNetwork","HTMLElement","wcBindable","inputs","_core","_connectedCallbackPromise","connectedCallbackPromise","connectedCallback","style","display","disconnectedCallback","bootstrapNetwork","userConfig","partialConfig","assign","customElements","get","define"],"mappings":"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"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@wcstack/network",
+  "version": "1.16.0",
+  "description": "Declarative Network Information component for Web Components. Framework-agnostic navigator.connection monitor via wc-bindable-protocol.",
+  "type": "module",
+  "main": "./dist/index.esm.js",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js"
+    },
+    "./auto": "./dist/auto.min.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist .tsc-out",
+    "build": "rimraf dist .tsc-out && tsc && rollup -c",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "prepublishOnly": "npm run build && npm run test:coverage"
+  },
+  "keywords": [
+    "web-components",
+    "network-information",
+    "connection",
+    "adaptive-loading",
+    "custom-elements",
+    "wc-bindable",
+    "declarative",
+    "zero-dependencies",
+    "framework-agnostic"
+  ],
+  "author": "mogera551",
+  "homepage": "https://wcstack.github.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wcstack/wcstack.git",
+    "directory": "packages/network"
+  },
+  "bugs": {
+    "url": "https://github.com/wcstack/wcstack/issues"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@vitest/coverage-v8": "^4.0.15",
+    "@vitest/ui": "^4.0.15",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "happy-dom": "^20.0.11",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.22.4",
+    "rollup-plugin-dts": "^6.1.1",
+    "rollup-plugin-copy": "^3.5.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0",
+    "vitest": "^4.0.15"
+  }
+}