@wcstack/magnetometer 1.16.0

package/README.ja.md

@@ -0,0 +1,139 @@
+# @wcstack/magnetometer
+
+`@wcstack/magnetometer` は wcstack エコシステム向けのヘッドレスな Generic Sensor API（Magnetometer）コンポーネントです。
+
+視覚的な UI ウィジェットではありません。デバイスの磁束密度読み取りをリアクティブな state に変える**非同期プリミティブノード**です。
+
+`@wcstack/state` と組み合わせると、`<wcs-magnetometer>` はパス契約で直接バインドできます:
+
+- **入力サーフェス**: `frequency`（サンプリングレート、Hz）
+- **出力 state サーフェス**: `x`、`y`、`z`、`error`
+
+`@wcstack/magnetometer` は [CSBC](https://github.com/csbc-dev/arch/blob/main/README.md)（Core / Shell / Binding Contract）アーキテクチャに従います:
+
+- **Core**（`MagnetometerCore`）がプラットフォームの`Magnetometer`を構築し、live な`reading`/`error`イベントを追従
+- **Shell**（`<wcs-magnetometer>`）がその state を DOM ライフサイクルに接続
+- **Binding Contract**（`static wcBindable`）が観測可能な`properties`と`start`/`stop`の`commands`を宣言
+
+## なぜ存在するか — プラットフォームAPI自体がnever-throwと最初から一致する稀な例
+
+Generic Sensor API の`Accelerometer`/`Gyroscope`/`Magnetometer`/`AmbientLightSensor`族は全て共通の形状を持ちます: `.start()`/`.stop()`、サンプルごとの`'reading'`イベント、そして——注目すべき点として——失敗は例外ではなく**`'error'`イベント**で通知されます。これは wcstack の never-throw 方針と最初から噛み合っています。唯一防御的な`try/catch`が要るのは、権限拒否やPermissions-Policyブロックで**同期的に例外を投げうる**`Magnetometer`のコンストラクタ自体です。
+
+> **`@wcstack/permission`との合成を推奨。** `navigator.permissions.query({name:"magnetometer"})`が既に存在するため、`<wcs-magnetometer>`は`<wcs-permission name="magnetometer">`と併置して`granted`/`denied`/`prompt`状態を得てください（権限状態はこのノード自身では重複実装しません、`docs/sensor-tag-design.md`参照）。
+
+> **Chromium/Android中心の対応。** デスクトップでは`Magnetometer`クラスが存在しても`SecurityError`になりがちです。unsupported/deniedを既定状態として設計してください。
+
+## インストール
+
+```bash
+npm install @wcstack/magnetometer
+```
+
+## クイックスタート
+
+### 1. 磁束密度をライブ表示
+
+`<wcs-magnetometer>`は接続時に**自動開始しません** — バインドしただけでは
+`x`/`y`/`z`は初期値`null`のままです。読み取りを流すには（例えばボタンから）
+`start`コマンドを発火する必要があります:
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/magnetometer/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      $commandTokens: ["startMagnet"],
+      x: null, y: null, z: null,
+    };
+  </script>
+</wcs-state>
+
+<wcs-magnetometer
+  data-wcs="x: x; y: y; z: z; command.start: $command.startMagnet"
+></wcs-magnetometer>
+
+<button data-wcs="onclick: $command.startMagnet">開始</button>
+<p data-wcs="textContent: x"></p>
+```
+
+ボタンは`<wcs-magnetometer>`に直接触れません: クリックは`startMagnet`コマンドトークンを発火し（`$commandTokens: ["startMagnet"]`で名前を宣言）、`<wcs-magnetometer>`は`command.start: $command.startMagnet`でそれを購読します（[command-token プロトコル](../state/) — コマンドメソッドを持つ要素が*subscriber*であり、emitter ではありません）。
+
+### 2. 権限を確認してから start する
+
+この例では`@wcstack/permission`の登録も必要です（例1の`@wcstack/state` /
+`@wcstack/magnetometer`の script に加えて）。`magnetGranted`を宣言する
+独立した`<wcs-state>`を持ちます:
+
+```html
+<script type="module" src="https://esm.run/@wcstack/permission/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      $commandTokens: ["startMagnet"],
+      magnetGranted: false,
+    };
+  </script>
+</wcs-state>
+
+<wcs-permission name="magnetometer" data-wcs="granted: magnetGranted"></wcs-permission>
+<wcs-magnetometer data-wcs="command.start: $command.startMagnet"></wcs-magnetometer>
+
+<button data-wcs="onclick: $command.startMagnet; disabled: magnetGranted|not">開始</button>
+```
+
+バインドする state パスは事前にすべて宣言する必要があります — 未宣言のパスへのバインドは初期化時に例外を投げます。`data-wcs`パス内の否定は先頭`!`ではなく`|not`フィルタ(`magnetGranted|not`)で行います。
+
+## 属性 / 入力
+
+| 属性        | 型     | 既定値 | 説明 |
+| ----------- | ------ | ------ | ---- |
+| `frequency` | number | —      | サンプリングレート（Hz）。`Magnetometer`コンストラクタへそのまま渡る。読み取られるのは`start()`実行時のみ — 稼働中に変更しても`stop()`＋`start()`し直すまで反映されない（注意・制限を参照）。 |
+
+## 観測可能プロパティ（出力）
+
+| プロパティ | イベント                    | 説明 |
+| ---------- | --------------------------- | ---- |
+| `x`        | `wcs-magnetometer:reading` | x軸方向の磁束密度。初回読み取り前は`null`。 |
+| `y`        | `wcs-magnetometer:reading` | y軸方向の磁束密度。 |
+| `z`        | `wcs-magnetometer:reading` | z軸方向の磁束密度。 |
+| `error`    | `wcs-magnetometer:error`   | 正規化された`{ error, message }`、無ければ`null`。 |
+
+`x`/`y`/`z`は単一の`wcs-magnetometer:reading`イベントから派生します（ネイティブの1回の`reading`イベントで3軸が同時に更新される）。
+
+## コマンド
+
+| コマンド | 非同期 | 説明 |
+| -------- | ------ | ---- |
+| `start`  | いいえ | センサーを構築（never-throw: コンストラクタの同期例外はキャッチし`error`へ）し読み取りを開始する。開始済みの間は冪等（再度呼んでも何もしない）。 |
+| `stop`   | いいえ | センサーを停止しリスナーを解除する。未開始でも安全に呼べる。 |
+
+## 注意・制限
+
+- **`_gen`世代ガードは無し。** `start()`/`stop()`は同期的な購読/購読解除のトグルであり、`dispose()`とレースしうる非同期probeが存在しません（`docs/sensor-tag-design.md` §1.5）。
+- **`error`は sticky（据え置き）です。** 最後に観測した失敗（`unsupported`、`SecurityError`等）を保持し、その後の`start()`成功や`reading`受信では自動クリアされません。`stop()`＋`start()`でリトライが成功しても直前の`error`は残り続けます。必要なら利用側の state でクリア／再解釈してください。
+- **`frequency`は`start()`時にのみ読み取られます。** `attributeChangedCallback`は無く、`start()`は既に開始済みの間は冪等（再度呼んでも何もしない、上記コマンド参照）であるため、稼働中に`frequency`（属性またはプロパティ）を変更しても反映されません。新しいサンプリングレートを適用するには`stop()`してから`start()`し直してください。
+- **再親付け（別の親要素への移動）はセンサーを停止し、自動再開しません。** 接続中の`<wcs-magnetometer>`要素を別の親へ移動すると`disconnectedCallback`→`connectedCallback`が発火します。Shellは接続時に自動開始しないため（上記クイックスタート参照）、これは実質的な停止であり自動再開はされません。`x`/`y`/`z`は最後のサンプル値のまま凍結され、`error`も発生しません — `start`を再度発行するまでセンサーは inert のままです。
+- **生の`new Magnetometer(...)`は唯一のガード付き構築ヘルパー以外では呼ばない。** 権限拒否・Permissions-Policyブロックは同期的に例外を投げます。
+- 権限状態（`granted`/`denied`/`prompt`）は意図的にこのノードでは重複実装していません — `<wcs-permission name="magnetometer">`と合成してください。
+
+## ヘッドレス利用（`MagnetometerCore`）
+
+```typescript
+import { MagnetometerCore } from "@wcstack/magnetometer";
+
+const core = new MagnetometerCore();
+core.addEventListener("wcs-magnetometer:reading", (e) => {
+  console.log((e as CustomEvent).detail); // { x, y, z }
+});
+
+core.start();
+// 後始末:
+core.dispose();
+```
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,142 @@
+# @wcstack/magnetometer
+
+`@wcstack/magnetometer` is a headless Generic Sensor API (Magnetometer) component for the wcstack ecosystem.
+
+It is not a visual UI widget.
+It is an **async primitive node** that turns device magnetic field readings into reactive state.
+
+With `@wcstack/state`, `<wcs-magnetometer>` can be bound directly through path contracts:
+
+- **input surface**: `frequency` (sampling rate in Hz)
+- **output state surface**: `x`, `y`, `z`, `error`
+
+This means compass/magnetic-field-driven UI can be expressed declaratively in HTML, without writing `Magnetometer`/`reading`/`error`-listener glue in your UI layer.
+
+`@wcstack/magnetometer` follows the [CSBC](https://github.com/csbc-dev/arch/blob/main/README.md) (Core / Shell / Binding Contract) architecture:
+
+- **Core** (`MagnetometerCore`) constructs the platform `Magnetometer`, tracks its live `reading`/`error` events
+- **Shell** (`<wcs-magnetometer>`) connects that state to DOM lifecycle
+- **Binding Contract** (`static wcBindable`) declares observable `properties` and `start`/`stop` `commands`
+
+## Why this exists — a rare case where the platform API already matches never-throw
+
+The Generic Sensor API's `Accelerometer`/`Gyroscope`/`Magnetometer`/`AmbientLightSensor` family all share one base shape: `.start()`/`.stop()`, a `'reading'` event per sample, and — notably — an `'error'` **event** for failures instead of a thrown exception. This already lines up with wcstack's never-throw convention; the one place this Core still needs a defensive `try/catch` is the synchronous `Magnetometer` **constructor** itself, which can throw (`SecurityError`) on permission denial or a Permissions-Policy block.
+
+> **Compose with `@wcstack/permission`.** `navigator.permissions.query({name:"magnetometer"})` already exists — pair `<wcs-magnetometer>` with `<wcs-permission name="magnetometer">` for `granted`/`denied`/`prompt` status rather than duplicating that state here (see `docs/sensor-tag-design.md`).
+
+> **Chromium/Android-centric support.** Desktop browsers commonly reject with `SecurityError` even when the `Magnetometer` class exists. Design any UI around `unsupported`/denied being the common case, not the exception.
+
+## Install
+
+```bash
+npm install @wcstack/magnetometer
+```
+
+## Quick Start
+
+### 1. Read live magnetic field
+
+`<wcs-magnetometer>` does **not** auto-start on connect — binding alone leaves
+`x`/`y`/`z` at their initial `null`. You must fire the `start` command
+(e.g. from a button) before readings flow:
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/magnetometer/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      $commandTokens: ["startMagnet"],
+      x: null, y: null, z: null,
+    };
+  </script>
+</wcs-state>
+
+<wcs-magnetometer
+  data-wcs="x: x; y: y; z: z; command.start: $command.startMagnet"
+></wcs-magnetometer>
+
+<button data-wcs="onclick: $command.startMagnet">Start</button>
+<p data-wcs="textContent: x"></p>
+```
+
+The button never touches `<wcs-magnetometer>` directly: its click emits the `startMagnet` command token (`$commandTokens: ["startMagnet"]` declares the name), and `<wcs-magnetometer>` subscribes to it via `command.start: $command.startMagnet` (the [command-token protocol](../state/) — the element with the command method is the *subscriber*, not the emitter).
+
+### 2. Gate on permission, then start
+
+This example also needs `@wcstack/permission` registered (alongside the
+`@wcstack/state` / `@wcstack/magnetometer` scripts from example 1), with its
+own self-contained `<wcs-state>` declaring `magnetGranted`:
+
+```html
+<script type="module" src="https://esm.run/@wcstack/permission/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      $commandTokens: ["startMagnet"],
+      magnetGranted: false,
+    };
+  </script>
+</wcs-state>
+
+<wcs-permission name="magnetometer" data-wcs="granted: magnetGranted"></wcs-permission>
+<wcs-magnetometer data-wcs="command.start: $command.startMagnet"></wcs-magnetometer>
+
+<button data-wcs="onclick: $command.startMagnet; disabled: magnetGranted|not">Start</button>
+```
+
+Every bound state path must be declared up front — binding an undeclared path throws at initialization. Negation in a `data-wcs` path is done with the `|not` filter (`magnetGranted|not`), not a leading `!`.
+
+## Attributes / Inputs
+
+| Attribute   | Type   | Default | Description |
+| ----------- | ------ | ------- | ------------ |
+| `frequency` | number | —       | Sampling rate in Hz, forwarded to the `Magnetometer` constructor. Read only when `start()` runs — changing it while already started has no effect until `stop()` + `start()` (see Notes). |
+
+## Observable Properties (outputs)
+
+| Property | Event                     | Description |
+| -------- | ------------------------- | ------------ |
+| `x`      | `wcs-magnetometer:reading` | Magnetic flux density along the x-axis, or `null` before the first reading. |
+| `y`      | `wcs-magnetometer:reading` | Magnetic flux density along the y-axis. |
+| `z`      | `wcs-magnetometer:reading` | Magnetic flux density along the z-axis. |
+| `error`  | `wcs-magnetometer:error`   | Normalized `{ error, message }`, or `null`. |
+
+`x`/`y`/`z` all derive from the single `wcs-magnetometer:reading` event (one native `reading` event updates all three axes together).
+
+## Commands
+
+| Command | Async | Description |
+| ------- | ----- | ------------ |
+| `start` | no    | Construct the sensor (never-throw: a synchronous constructor exception is caught and surfaced via `error`) and begin reading. Idempotent while already started (a redundant call is a no-op). |
+| `stop`  | no    | Stop the sensor and detach its listeners. Safe to call when not started. |
+
+## Notes & limitations
+
+- **No `_gen` generation guard.** `start()`/`stop()` are a synchronous subscribe/unsubscribe toggle with no asynchronous probe to race against a `dispose()` — see `docs/sensor-tag-design.md` §1.5.
+- **`error` is sticky.** It holds the last observed failure (e.g. `unsupported`, `SecurityError`) and is **not** auto-cleared by a later successful `start()` or by incoming `reading`s. A `stop()` + `start()` retry that succeeds still leaves the previous `error` in place — clear or reinterpret it in your own state if needed.
+- **`frequency` is read only at `start()`.** There is no `attributeChangedCallback`, and `start()` is idempotent while already started (a redundant call is a no-op — see Commands above), so changing the `frequency` attribute/property on a running sensor has no effect. To apply a new sampling rate, `stop()` then `start()` again.
+- **Reparenting stops the sensor and does not resume it.** Moving a connected `<wcs-magnetometer>` element to a different parent runs `disconnectedCallback` → `connectedCallback`; since the Shell does not auto-start on connect (see Quick Start above), this is effectively a stop with no automatic restart. `x`/`y`/`z` freeze at their last sample, and no `error` is raised — the sensor stays inert until `start` is invoked again.
+- **Never call the raw `new Magnetometer(...)` anywhere but the one guarded construction helper** — permission denial and Permissions-Policy blocks throw synchronously.
+- Permission status (`granted`/`denied`/`prompt`) is intentionally not duplicated here — compose with `<wcs-permission name="magnetometer">`.
+
+## Headless usage (`MagnetometerCore`)
+
+```typescript
+import { MagnetometerCore } from "@wcstack/magnetometer";
+
+const core = new MagnetometerCore();
+core.addEventListener("wcs-magnetometer:reading", (e) => {
+  console.log((e as CustomEvent).detail); // { x, y, z }
+});
+
+core.start();
+// later:
+core.dispose();
+```
+
+## License
+
+MIT

package/dist/auto.js

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

package/dist/auto.min.js

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

package/dist/index.d.ts

@@ -0,0 +1,225 @@
+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 magnetometer: string;
+}
+interface IWritableTagNames {
+    magnetometer?: string;
+}
+interface IConfig {
+    readonly tagNames: ITagNames;
+}
+interface IWritableConfig {
+    tagNames?: IWritableTagNames;
+}
+
+/**
+ * A single `reading` sample from the Magnetometer sensor: magnetic flux
+ * density along the x/y/z axes, in microtesla (µT).
+ */
+interface WcsMagnetometerReading {
+    x: number | null;
+    y: number | null;
+    z: number | null;
+}
+/**
+ * Error detail published on the `wcs-magnetometer:error` event. Mirrors the
+ * Generic Sensor API's `SensorErrorEvent.error` (a `DOMException`-like value)
+ * flattened to a plain object, plus the synthetic `"unsupported"` name used
+ * when the global `Magnetometer` constructor is absent.
+ */
+interface WcsMagnetometerErrorDetail {
+    error: string;
+    message: string;
+}
+/**
+ * Value types for MagnetometerCore (headless) — the observable state
+ * properties. Use with `bind()` from a wc-bindable binding core for
+ * compile-time type checking.
+ *
+ * @example
+ * ```typescript
+ * const core = new MagnetometerCore();
+ * bind(core, (name: keyof WcsMagnetometerCoreValues, value) => { ... });
+ * ```
+ */
+interface WcsMagnetometerCoreValues extends WcsMagnetometerReading {
+    error: WcsMagnetometerErrorDetail | null;
+}
+/**
+ * Value types for the Shell (`<wcs-magnetometer>`) — identical observable
+ * surface to the Core, plus the `frequency` attribute-backed input.
+ */
+type WcsMagnetometerValues = WcsMagnetometerCoreValues;
+
+declare function bootstrapMagnetometer(userConfig?: IWritableConfig): void;
+
+declare function getConfig(): IConfig;
+
+/**
+ * Headless Magnetometer primitive. A thin, framework-agnostic wrapper around
+ * the Generic Sensor API's `Magnetometer` class exposed through the
+ * wc-bindable protocol.
+ *
+ * The platform `Sensor` base class (shared by `Accelerometer` / `Gyroscope` /
+ * `Magnetometer` / `AmbientLightSensor`) reports failure through an `'error'`
+ * event rather than a rejected promise, so this Core can satisfy never-throw
+ * (docs/async-io-node-guidelines.md §3.6) by simply forwarding that event —
+ * see docs/sensor-tag-design.md §0. The one place a synchronous
+ * exception *can* still escape the platform API is the `Magnetometer`
+ * constructor itself (e.g. `SecurityError` on permission denial or a
+ * feature-policy block); `_createSensor()` wraps that single call in
+ * try/catch, mirroring FetchCore's `_doFetch` try/catch around
+ * `globalThis.fetch` (packages/fetch/src/core/FetchCore.ts).
+ *
+ * `x`/`y`/`z` are three getters derived from the single `wcs-magnetometer:reading`
+ * event (mirroring how NetworkCore exposes effectiveType/downlink/… from one
+ * `wcs-network:change` event): the native `reading` event already reports all
+ * three axes together, so they are not split into independent events. `reading`
+ * is an event-like signal (a fresh sample every time, not a settled state) and
+ * is therefore deliberately NOT same-value guarded — every sample dispatches.
+ * `error` is state-like (denial / unsupported does not change from tick to
+ * tick) and IS same-value guarded, and is published on its own
+ * `wcs-magnetometer:error` event, independent of `reading`.
+ *
+ * No `_gen` generation guard: start()/stop() are a synchronous
+ * subscribe/unsubscribe toggle with no asynchronous probe whose stale
+ * resolution could race a dispose() — see docs/sensor-tag-design.md §1.5
+ * (the same reasoning as NetworkCore, docs/network-tag-design.md §5).
+ *
+ * Permissions: this Core does not query `navigator.permissions` itself.
+ * Compose with `<wcs-permission name="magnetometer">` instead — see
+ * docs/sensor-tag-design.md §"2番目の決定: Permissions APIとの合成".
+ */
+declare class MagnetometerCore extends EventTarget {
+    static wcBindable: IWcBindable;
+    private _target;
+    private _reading;
+    private _error;
+    private _sensor;
+    constructor(target?: EventTarget);
+    get x(): number | null;
+    get y(): number | null;
+    get z(): number | null;
+    get error(): WcsMagnetometerErrorDetail | null;
+    /** No asynchronous probe to await: start()/stop() are synchronous
+     *  (docs/async-io-node-guidelines.md §3.8 is satisfied trivially, mirroring
+     *  NetworkCore). */
+    get ready(): Promise<void>;
+    private _setReading;
+    private _setError;
+    /**
+     * Start the sensor at the given `frequency` (Hz), or the platform default
+     * when omitted. Idempotent while already started: a redundant start() does
+     * not construct a second sensor instance (which would leak the first).
+     * Restart with a different frequency via stop() + start().
+     *
+     * Synchronous, mirroring the native `Sensor.start()` — never throws
+     * (docs/async-io-node-guidelines.md §3.6): both "unsupported" and a
+     * synchronous constructor exception (permission denial, feature-policy
+     * block) are converted to the `error` property instead of propagating.
+     */
+    start(frequency?: number): void;
+    /** Stop the sensor and detach its listeners. Safe to call when not started. */
+    stop(): void;
+    /** Lifecycle alias for start(), so the Shell's connectedCallback can drive
+     *  this Core the same way as other IO nodes' observe()/dispose() pair. No
+     *  asynchronous probe, so the returned promise always resolves immediately. */
+    observe(frequency?: number): Promise<void>;
+    /** Lifecycle alias for stop(), invoked from the Shell's disconnectedCallback. */
+    dispose(): void;
+    private _teardownSensor;
+    /**
+     * Construct the platform `Magnetometer`, guarding both non-support and a
+     * synchronous constructor exception. Never calls the raw `new Magnetometer(...)`
+     * anywhere else in this class — see docs/sensor-tag-design.md §1.5.
+     *
+     * API resolution is call-time (docs/async-io-node-guidelines.md §3.7):
+     * re-checked on every start(), never cached, so tests can install/remove
+     * the global freely and an unsupported environment is always reported
+     * correctly.
+     */
+    private _createSensor;
+    private _onReading;
+    private _onError;
+}
+
+/**
+ * `<wcs-magnetometer>` — declarative Generic Sensor API (`Magnetometer`)
+ * monitor + start/stop control.
+ *
+ * Unlike `<wcs-network>` / `<wcs-permission>` (pure monitors), this Shell is a
+ * bidirectional node: `start`/`stop` commands (command-token: state → element)
+ * alongside the `x`/`y`/`z`/`error` observable surface (event-token: element →
+ * state). The `frequency` attribute is the sole configuration input, forwarded
+ * to the platform `Magnetometer` constructor's `{ frequency }` option
+ * (docs/sensor-tag-design.md §1.2). The getter normalizes it: a non-finite or
+ * non-positive value (NaN, 0, negative) reads back as `null` — meaning "no
+ * frequency specified" — so start() falls back to the platform default rather
+ * than forwarding a value the sensor would reject. Any positive finite value is
+ * passed through verbatim (no upper-bound clamping — an out-of-range-but-positive
+ * rate is still left to the browser/sensor to reject via `error`).
+ *
+ * Permission handling is intentionally NOT implemented here. Compose with
+ * `<wcs-permission name="magnetometer">` instead (see the README's permission
+ * example, "Gate on permission, then start", and docs/sensor-tag-design.md).
+ */
+declare class WcsMagnetometer extends HTMLElement {
+    static hasConnectedCallbackPromise: boolean;
+    static wcBindable: IWcBindable;
+    private _core;
+    private _connectedCallbackPromise;
+    constructor();
+    /**
+     * Sampling frequency in Hz. Reads back `null` when unset, blank, or when the
+     * attribute does not parse to a positive finite number (NaN, `"0"`, negative)
+     * — in every such "no usable value" case the platform default applies.
+     *
+     * Note the deliberate set/get asymmetry: `set frequency(0)` (or any
+     * non-positive/non-finite value) still writes the attribute verbatim for
+     * transparency/inspectability, but the getter normalizes it back to `null`.
+     * A round-trip through a non-positive value therefore does NOT preserve it —
+     * that value carries no valid sampling meaning, so it is treated as "unset"
+     * on read. Only positive finite frequencies survive a set→get round-trip.
+     *
+     * This value is read only at `start()` time. There is no
+     * `attributeChangedCallback`, and `MagnetometerCore.start()` is idempotent
+     * while already started (a redundant call is a no-op), so setting
+     * `frequency` (attribute or property) on an already-running sensor has no
+     * effect until the caller `stop()`s and `start()`s again (see the README's
+     * "Notes & limitations").
+     */
+    get frequency(): number | null;
+    set frequency(value: number | null | undefined);
+    get x(): number | null;
+    get y(): number | null;
+    get z(): number | null;
+    get error(): WcsMagnetometerErrorDetail | null;
+    get connectedCallbackPromise(): Promise<void>;
+    start(): void;
+    stop(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}
+
+export { MagnetometerCore, WcsMagnetometer, bootstrapMagnetometer, getConfig };
+export type { IWritableConfig, IWritableTagNames, WcsMagnetometerCoreValues, WcsMagnetometerErrorDetail, WcsMagnetometerReading, WcsMagnetometerValues };

package/dist/index.esm.js

@@ -0,0 +1,376 @@
+const _config = {
+    tagNames: {
+        magnetometer: "wcs-magnetometer",
+    },
+};
+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 NULL_READING = Object.freeze({ x: null, y: null, z: null });
+/**
+ * Headless Magnetometer primitive. A thin, framework-agnostic wrapper around
+ * the Generic Sensor API's `Magnetometer` class exposed through the
+ * wc-bindable protocol.
+ *
+ * The platform `Sensor` base class (shared by `Accelerometer` / `Gyroscope` /
+ * `Magnetometer` / `AmbientLightSensor`) reports failure through an `'error'`
+ * event rather than a rejected promise, so this Core can satisfy never-throw
+ * (docs/async-io-node-guidelines.md §3.6) by simply forwarding that event —
+ * see docs/sensor-tag-design.md §0. The one place a synchronous
+ * exception *can* still escape the platform API is the `Magnetometer`
+ * constructor itself (e.g. `SecurityError` on permission denial or a
+ * feature-policy block); `_createSensor()` wraps that single call in
+ * try/catch, mirroring FetchCore's `_doFetch` try/catch around
+ * `globalThis.fetch` (packages/fetch/src/core/FetchCore.ts).
+ *
+ * `x`/`y`/`z` are three getters derived from the single `wcs-magnetometer:reading`
+ * event (mirroring how NetworkCore exposes effectiveType/downlink/… from one
+ * `wcs-network:change` event): the native `reading` event already reports all
+ * three axes together, so they are not split into independent events. `reading`
+ * is an event-like signal (a fresh sample every time, not a settled state) and
+ * is therefore deliberately NOT same-value guarded — every sample dispatches.
+ * `error` is state-like (denial / unsupported does not change from tick to
+ * tick) and IS same-value guarded, and is published on its own
+ * `wcs-magnetometer:error` event, independent of `reading`.
+ *
+ * No `_gen` generation guard: start()/stop() are a synchronous
+ * subscribe/unsubscribe toggle with no asynchronous probe whose stale
+ * resolution could race a dispose() — see docs/sensor-tag-design.md §1.5
+ * (the same reasoning as NetworkCore, docs/network-tag-design.md §5).
+ *
+ * Permissions: this Core does not query `navigator.permissions` itself.
+ * Compose with `<wcs-permission name="magnetometer">` instead — see
+ * docs/sensor-tag-design.md §"2番目の決定: Permissions APIとの合成".
+ */
+class MagnetometerCore extends EventTarget {
+    static wcBindable = {
+        protocol: "wc-bindable",
+        version: 1,
+        properties: [
+            { name: "x", event: "wcs-magnetometer:reading", getter: (e) => e.detail.x },
+            { name: "y", event: "wcs-magnetometer:reading", getter: (e) => e.detail.y },
+            { name: "z", event: "wcs-magnetometer:reading", getter: (e) => e.detail.z },
+            { name: "error", event: "wcs-magnetometer:error" },
+        ],
+        commands: [{ name: "start" }, { name: "stop" }],
+    };
+    _target;
+    _reading = NULL_READING;
+    _error = null;
+    // The live sensor instance while started (null otherwise), kept so stop()
+    // can remove its listeners precisely and so start() can detect "already
+    // started" without a separate boolean (docs/async-io-node-guidelines.md
+    // §3.5 idempotency).
+    _sensor = null;
+    constructor(target) {
+        super();
+        this._target = target ?? this;
+    }
+    get x() {
+        return this._reading.x;
+    }
+    get y() {
+        return this._reading.y;
+    }
+    get z() {
+        return this._reading.z;
+    }
+    get error() {
+        return this._error;
+    }
+    /** No asynchronous probe to await: start()/stop() are synchronous
+     *  (docs/async-io-node-guidelines.md §3.8 is satisfied trivially, mirroring
+     *  NetworkCore). */
+    get ready() {
+        return Promise.resolve();
+    }
+    // --- State setters ---
+    // Deliberately NOT same-value guarded: a `reading` is a fresh sample, not a
+    // settled state, so it must dispatch every time even when the values happen
+    // to repeat (docs/sensor-tag-design.md §1.1).
+    _setReading(reading) {
+        this._reading = reading;
+        this._target.dispatchEvent(new CustomEvent("wcs-magnetometer:reading", {
+            detail: reading,
+            bubbles: true,
+        }));
+    }
+    _setError(error) {
+        // Same-value guard (by error name + message): error is state-like, unlike
+        // reading — a repeated identical error (same name and message) must not
+        // redispatch. Note `error` is also STICKY: nothing calls _setError(null),
+        // so a successful (re)start does not clear a prior failure — the monitoring
+        // sensor family deliberately keeps the last observed error (docs/sensor-tag-design.md §1.5).
+        if (this._error?.error === error?.error && this._error?.message === error?.message)
+            return;
+        this._error = error;
+        this._target.dispatchEvent(new CustomEvent("wcs-magnetometer:error", {
+            detail: error,
+            bubbles: true,
+        }));
+    }
+    // --- Public API ---
+    /**
+     * Start the sensor at the given `frequency` (Hz), or the platform default
+     * when omitted. Idempotent while already started: a redundant start() does
+     * not construct a second sensor instance (which would leak the first).
+     * Restart with a different frequency via stop() + start().
+     *
+     * Synchronous, mirroring the native `Sensor.start()` — never throws
+     * (docs/async-io-node-guidelines.md §3.6): both "unsupported" and a
+     * synchronous constructor exception (permission denial, feature-policy
+     * block) are converted to the `error` property instead of propagating.
+     */
+    start(frequency) {
+        if (this._sensor)
+            return;
+        const sensor = this._createSensor(frequency);
+        if (!sensor)
+            return;
+        sensor.addEventListener("reading", this._onReading);
+        sensor.addEventListener("error", this._onError);
+        this._sensor = sensor;
+        try {
+            sensor.start();
+        }
+        catch (e) {
+            // Defensive: the platform contract says start()/stop() do not throw
+            // (failures surface via the 'error' event), but never-throw is a hard
+            // requirement here, so guard against a non-conformant implementation
+            // too.
+            this._teardownSensor();
+            this._setError({ error: e?.name ?? "error", message: e?.message ?? String(e) });
+        }
+    }
+    /** Stop the sensor and detach its listeners. Safe to call when not started. */
+    stop() {
+        if (!this._sensor)
+            return;
+        try {
+            this._sensor.stop();
+        }
+        catch {
+            // Never-throw defensive guard, symmetric with start(). Teardown below
+            // still runs so listeners are detached regardless.
+        }
+        this._teardownSensor();
+    }
+    /** Lifecycle alias for start(), so the Shell's connectedCallback can drive
+     *  this Core the same way as other IO nodes' observe()/dispose() pair. No
+     *  asynchronous probe, so the returned promise always resolves immediately. */
+    observe(frequency) {
+        this.start(frequency);
+        return this.ready;
+    }
+    /** Lifecycle alias for stop(), invoked from the Shell's disconnectedCallback. */
+    dispose() {
+        this.stop();
+    }
+    // --- Internal ---
+    // Both call sites (start()'s catch, stop()) only ever invoke this once
+    // `this._sensor` is already known non-null, so there is no null-guard here
+    // (nothing to defend against).
+    _teardownSensor() {
+        this._sensor.removeEventListener("reading", this._onReading);
+        this._sensor.removeEventListener("error", this._onError);
+        this._sensor = null;
+    }
+    /**
+     * Construct the platform `Magnetometer`, guarding both non-support and a
+     * synchronous constructor exception. Never calls the raw `new Magnetometer(...)`
+     * anywhere else in this class — see docs/sensor-tag-design.md §1.5.
+     *
+     * API resolution is call-time (docs/async-io-node-guidelines.md §3.7):
+     * re-checked on every start(), never cached, so tests can install/remove
+     * the global freely and an unsupported environment is always reported
+     * correctly.
+     */
+    _createSensor(frequency) {
+        const Ctor = globalThis.Magnetometer;
+        if (typeof Ctor !== "function") {
+            this._setError({ error: "unsupported", message: "Magnetometer is not supported" });
+            return null;
+        }
+        try {
+            return new Ctor(frequency !== undefined ? { frequency } : undefined);
+        }
+        catch (e) {
+            // SecurityError (permission denial, feature-policy block) or any other
+            // synchronous construction failure. Mirrors the FetchCore._doFetch
+            // try/catch structure (packages/fetch/src/core/FetchCore.ts) — a
+            // synchronous constructor call here instead of an awaited fetch().
+            this._setError({ error: e?.name ?? "error", message: e?.message ?? String(e) });
+            return null;
+        }
+    }
+    _onReading = (event) => {
+        const sensor = event.target;
+        this._setReading({ x: sensor.x, y: sensor.y, z: sensor.z });
+    };
+    _onError = (event) => {
+        const err = event.error;
+        // Fallback is a meaningful constant, NOT String(err): a SensorErrorEvent
+        // without an `error` field would otherwise stringify `undefined` into the
+        // literal message "undefined" (aligned across the sensor family).
+        this._setError({ error: err?.name ?? "error", message: err?.message ?? "Sensor error" });
+    };
+}
+
+/**
+ * `<wcs-magnetometer>` — declarative Generic Sensor API (`Magnetometer`)
+ * monitor + start/stop control.
+ *
+ * Unlike `<wcs-network>` / `<wcs-permission>` (pure monitors), this Shell is a
+ * bidirectional node: `start`/`stop` commands (command-token: state → element)
+ * alongside the `x`/`y`/`z`/`error` observable surface (event-token: element →
+ * state). The `frequency` attribute is the sole configuration input, forwarded
+ * to the platform `Magnetometer` constructor's `{ frequency }` option
+ * (docs/sensor-tag-design.md §1.2). The getter normalizes it: a non-finite or
+ * non-positive value (NaN, 0, negative) reads back as `null` — meaning "no
+ * frequency specified" — so start() falls back to the platform default rather
+ * than forwarding a value the sensor would reject. Any positive finite value is
+ * passed through verbatim (no upper-bound clamping — an out-of-range-but-positive
+ * rate is still left to the browser/sensor to reject via `error`).
+ *
+ * Permission handling is intentionally NOT implemented here. Compose with
+ * `<wcs-permission name="magnetometer">` instead (see the README's permission
+ * example, "Gate on permission, then start", and docs/sensor-tag-design.md).
+ */
+class WcsMagnetometer extends HTMLElement {
+    static hasConnectedCallbackPromise = true;
+    static wcBindable = {
+        ...MagnetometerCore.wcBindable,
+        inputs: [{ name: "frequency" }],
+        // Core の commands をそのまま継承（単一情報源）。
+        commands: MagnetometerCore.wcBindable.commands,
+    };
+    _core;
+    _connectedCallbackPromise = Promise.resolve();
+    constructor() {
+        super();
+        this._core = new MagnetometerCore(this);
+    }
+    // --- Attribute accessors ---
+    /**
+     * Sampling frequency in Hz. Reads back `null` when unset, blank, or when the
+     * attribute does not parse to a positive finite number (NaN, `"0"`, negative)
+     * — in every such "no usable value" case the platform default applies.
+     *
+     * Note the deliberate set/get asymmetry: `set frequency(0)` (or any
+     * non-positive/non-finite value) still writes the attribute verbatim for
+     * transparency/inspectability, but the getter normalizes it back to `null`.
+     * A round-trip through a non-positive value therefore does NOT preserve it —
+     * that value carries no valid sampling meaning, so it is treated as "unset"
+     * on read. Only positive finite frequencies survive a set→get round-trip.
+     *
+     * This value is read only at `start()` time. There is no
+     * `attributeChangedCallback`, and `MagnetometerCore.start()` is idempotent
+     * while already started (a redundant call is a no-op), so setting
+     * `frequency` (attribute or property) on an already-running sensor has no
+     * effect until the caller `stop()`s and `start()`s again (see the README's
+     * "Notes & limitations").
+     */
+    get frequency() {
+        const attr = this.getAttribute("frequency");
+        if (attr === null || attr.trim() === "")
+            return null;
+        const parsed = Number(attr);
+        return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+    }
+    set frequency(value) {
+        if (value === null || value === undefined) {
+            this.removeAttribute("frequency");
+        }
+        else {
+            this.setAttribute("frequency", String(value));
+        }
+    }
+    // --- Core delegated getters ---
+    get x() {
+        return this._core.x;
+    }
+    get y() {
+        return this._core.y;
+    }
+    get z() {
+        return this._core.z;
+    }
+    get error() {
+        return this._core.error;
+    }
+    get connectedCallbackPromise() {
+        return this._connectedCallbackPromise;
+    }
+    // --- Commands ---
+    start() {
+        this._core.start(this.frequency ?? undefined);
+    }
+    stop() {
+        this._core.stop();
+    }
+    // --- Lifecycle ---
+    // Deliberately does NOT auto-start the sensor on connect. Unlike
+    // Geolocation (whose default phase acquires a fix immediately unless
+    // `manual` is set), Magnetometer has no such "connect implies observing"
+    // precedent in the design doc (docs/sensor-tag-design.md §1.3):
+    // start/stop are the only commands, so connecting the element merely makes
+    // it inert until a command-token `start` (or the `start()` method) is
+    // invoked. This also keeps behavior predictable when composed with
+    // `<wcs-permission name="magnetometer">`: the caller decides when to start,
+    // typically gated on `granted`.
+    connectedCallback() {
+        this.style.display = "none";
+        // No asynchronous probe to await (docs/async-io-node-guidelines.md §3.8);
+        // kept for SSR uniformity with other IO nodes.
+        this._connectedCallbackPromise = this._core.ready;
+    }
+    disconnectedCallback() {
+        this._core.dispose();
+    }
+}
+
+function registerComponents() {
+    if (!customElements.get(config.tagNames.magnetometer)) {
+        customElements.define(config.tagNames.magnetometer, WcsMagnetometer);
+    }
+}
+
+function bootstrapMagnetometer(userConfig) {
+    if (userConfig) {
+        setConfig(userConfig);
+    }
+    registerComponents();
+}
+
+export { MagnetometerCore, WcsMagnetometer, bootstrapMagnetometer, 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/MagnetometerCore.ts","../src/components/Magnetometer.ts","../src/registerComponents.ts","../src/bootstrapMagnetometer.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    magnetometer: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    magnetometer: \"wcs-magnetometer\",\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, WcsMagnetometerReading, WcsMagnetometerErrorDetail } from \"../types.js\";\n\nconst NULL_READING: WcsMagnetometerReading = Object.freeze({ x: null, y: null, z: null });\n\n/**\n * Headless Magnetometer primitive. A thin, framework-agnostic wrapper around\n * the Generic Sensor API's `Magnetometer` class exposed through the\n * wc-bindable protocol.\n *\n * The platform `Sensor` base class (shared by `Accelerometer` / `Gyroscope` /\n * `Magnetometer` / `AmbientLightSensor`) reports failure through an `'error'`\n * event rather than a rejected promise, so this Core can satisfy never-throw\n * (docs/async-io-node-guidelines.md §3.6) by simply forwarding that event —\n * see docs/sensor-tag-design.md §0. The one place a synchronous\n * exception *can* still escape the platform API is the `Magnetometer`\n * constructor itself (e.g. `SecurityError` on permission denial or a\n * feature-policy block); `_createSensor()` wraps that single call in\n * try/catch, mirroring FetchCore's `_doFetch` try/catch around\n * `globalThis.fetch` (packages/fetch/src/core/FetchCore.ts).\n *\n * `x`/`y`/`z` are three getters derived from the single `wcs-magnetometer:reading`\n * event (mirroring how NetworkCore exposes effectiveType/downlink/… from one\n * `wcs-network:change` event): the native `reading` event already reports all\n * three axes together, so they are not split into independent events. `reading`\n * is an event-like signal (a fresh sample every time, not a settled state) and\n * is therefore deliberately NOT same-value guarded — every sample dispatches.\n * `error` is state-like (denial / unsupported does not change from tick to\n * tick) and IS same-value guarded, and is published on its own\n * `wcs-magnetometer:error` event, independent of `reading`.\n *\n * No `_gen` generation guard: start()/stop() are a synchronous\n * subscribe/unsubscribe toggle with no asynchronous probe whose stale\n * resolution could race a dispose() — see docs/sensor-tag-design.md §1.5\n * (the same reasoning as NetworkCore, docs/network-tag-design.md §5).\n *\n * Permissions: this Core does not query `navigator.permissions` itself.\n * Compose with `<wcs-permission name=\"magnetometer\">` instead — see\n * docs/sensor-tag-design.md §\"2番目の決定: Permissions APIとの合成\".\n */\nexport class MagnetometerCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"x\", event: \"wcs-magnetometer:reading\", getter: (e: Event) => (e as CustomEvent).detail.x },\n      { name: \"y\", event: \"wcs-magnetometer:reading\", getter: (e: Event) => (e as CustomEvent).detail.y },\n      { name: \"z\", event: \"wcs-magnetometer:reading\", getter: (e: Event) => (e as CustomEvent).detail.z },\n      { name: \"error\", event: \"wcs-magnetometer:error\" },\n    ],\n    commands: [{ name: \"start\" }, { name: \"stop\" }],\n  };\n\n  private _target: EventTarget;\n  private _reading: WcsMagnetometerReading = NULL_READING;\n  private _error: WcsMagnetometerErrorDetail | null = null;\n\n  // The live sensor instance while started (null otherwise), kept so stop()\n  // can remove its listeners precisely and so start() can detect \"already\n  // started\" without a separate boolean (docs/async-io-node-guidelines.md\n  // §3.5 idempotency).\n  private _sensor: (EventTarget & { start(): void; stop(): void }) | null = null;\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get x(): number | null {\n    return this._reading.x;\n  }\n\n  get y(): number | null {\n    return this._reading.y;\n  }\n\n  get z(): number | null {\n    return this._reading.z;\n  }\n\n  get error(): WcsMagnetometerErrorDetail | null {\n    return this._error;\n  }\n\n  /** No asynchronous probe to await: start()/stop() are synchronous\n   *  (docs/async-io-node-guidelines.md §3.8 is satisfied trivially, mirroring\n   *  NetworkCore). */\n  get ready(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  // --- State setters ---\n\n  // Deliberately NOT same-value guarded: a `reading` is a fresh sample, not a\n  // settled state, so it must dispatch every time even when the values happen\n  // to repeat (docs/sensor-tag-design.md §1.1).\n  private _setReading(reading: WcsMagnetometerReading): void {\n    this._reading = reading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-magnetometer:reading\", {\n      detail: reading,\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: WcsMagnetometerErrorDetail | null): void {\n    // Same-value guard (by error name + message): error is state-like, unlike\n    // reading — a repeated identical error (same name and message) must not\n    // redispatch. Note `error` is also STICKY: nothing calls _setError(null),\n    // so a successful (re)start does not clear a prior failure — the monitoring\n    // sensor family deliberately keeps the last observed error (docs/sensor-tag-design.md §1.5).\n    if (this._error?.error === error?.error && this._error?.message === error?.message) return;\n    this._error = error;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-magnetometer:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  // --- Public API ---\n\n  /**\n   * Start the sensor at the given `frequency` (Hz), or the platform default\n   * when omitted. Idempotent while already started: a redundant start() does\n   * not construct a second sensor instance (which would leak the first).\n   * Restart with a different frequency via stop() + start().\n   *\n   * Synchronous, mirroring the native `Sensor.start()` — never throws\n   * (docs/async-io-node-guidelines.md §3.6): both \"unsupported\" and a\n   * synchronous constructor exception (permission denial, feature-policy\n   * block) are converted to the `error` property instead of propagating.\n   */\n  start(frequency?: number): void {\n    if (this._sensor) return;\n    const sensor = this._createSensor(frequency);\n    if (!sensor) return;\n    sensor.addEventListener(\"reading\", this._onReading as EventListener);\n    sensor.addEventListener(\"error\", this._onError as EventListener);\n    this._sensor = sensor;\n    try {\n      sensor.start();\n    } catch (e: any) {\n      // Defensive: the platform contract says start()/stop() do not throw\n      // (failures surface via the 'error' event), but never-throw is a hard\n      // requirement here, so guard against a non-conformant implementation\n      // too.\n      this._teardownSensor();\n      this._setError({ error: e?.name ?? \"error\", message: e?.message ?? String(e) });\n    }\n  }\n\n  /** Stop the sensor and detach its listeners. Safe to call when not started. */\n  stop(): void {\n    if (!this._sensor) return;\n    try {\n      this._sensor.stop();\n    } catch {\n      // Never-throw defensive guard, symmetric with start(). Teardown below\n      // still runs so listeners are detached regardless.\n    }\n    this._teardownSensor();\n  }\n\n  /** Lifecycle alias for start(), so the Shell's connectedCallback can drive\n   *  this Core the same way as other IO nodes' observe()/dispose() pair. No\n   *  asynchronous probe, so the returned promise always resolves immediately. */\n  observe(frequency?: number): Promise<void> {\n    this.start(frequency);\n    return this.ready;\n  }\n\n  /** Lifecycle alias for stop(), invoked from the Shell's disconnectedCallback. */\n  dispose(): void {\n    this.stop();\n  }\n\n  // --- Internal ---\n\n  // Both call sites (start()'s catch, stop()) only ever invoke this once\n  // `this._sensor` is already known non-null, so there is no null-guard here\n  // (nothing to defend against).\n  private _teardownSensor(): void {\n    this._sensor!.removeEventListener(\"reading\", this._onReading as EventListener);\n    this._sensor!.removeEventListener(\"error\", this._onError as EventListener);\n    this._sensor = null;\n  }\n\n  /**\n   * Construct the platform `Magnetometer`, guarding both non-support and a\n   * synchronous constructor exception. Never calls the raw `new Magnetometer(...)`\n   * anywhere else in this class — see docs/sensor-tag-design.md §1.5.\n   *\n   * API resolution is call-time (docs/async-io-node-guidelines.md §3.7):\n   * re-checked on every start(), never cached, so tests can install/remove\n   * the global freely and an unsupported environment is always reported\n   * correctly.\n   */\n  private _createSensor(frequency?: number): (EventTarget & { start(): void; stop(): void }) | null {\n    const Ctor = (globalThis as any).Magnetometer;\n    if (typeof Ctor !== \"function\") {\n      this._setError({ error: \"unsupported\", message: \"Magnetometer is not supported\" });\n      return null;\n    }\n    try {\n      return new Ctor(frequency !== undefined ? { frequency } : undefined);\n    } catch (e: any) {\n      // SecurityError (permission denial, feature-policy block) or any other\n      // synchronous construction failure. Mirrors the FetchCore._doFetch\n      // try/catch structure (packages/fetch/src/core/FetchCore.ts) — a\n      // synchronous constructor call here instead of an awaited fetch().\n      this._setError({ error: e?.name ?? \"error\", message: e?.message ?? String(e) });\n      return null;\n    }\n  }\n\n  private _onReading = (event: Event): void => {\n    const sensor = event.target as unknown as { x: number | null; y: number | null; z: number | null };\n    this._setReading({ x: sensor.x, y: sensor.y, z: sensor.z });\n  };\n\n  private _onError = (event: Event): void => {\n    const err = (event as any).error as { name?: string; message?: string } | undefined;\n    // Fallback is a meaningful constant, NOT String(err): a SensorErrorEvent\n    // without an `error` field would otherwise stringify `undefined` into the\n    // literal message \"undefined\" (aligned across the sensor family).\n    this._setError({ error: err?.name ?? \"error\", message: err?.message ?? \"Sensor error\" });\n  };\n}\n","import { IWcBindable, WcsMagnetometerErrorDetail } from \"../types.js\";\nimport { MagnetometerCore } from \"../core/MagnetometerCore.js\";\n\n/**\n * `<wcs-magnetometer>` — declarative Generic Sensor API (`Magnetometer`)\n * monitor + start/stop control.\n *\n * Unlike `<wcs-network>` / `<wcs-permission>` (pure monitors), this Shell is a\n * bidirectional node: `start`/`stop` commands (command-token: state → element)\n * alongside the `x`/`y`/`z`/`error` observable surface (event-token: element →\n * state). The `frequency` attribute is the sole configuration input, forwarded\n * to the platform `Magnetometer` constructor's `{ frequency }` option\n * (docs/sensor-tag-design.md §1.2). The getter normalizes it: a non-finite or\n * non-positive value (NaN, 0, negative) reads back as `null` — meaning \"no\n * frequency specified\" — so start() falls back to the platform default rather\n * than forwarding a value the sensor would reject. Any positive finite value is\n * passed through verbatim (no upper-bound clamping — an out-of-range-but-positive\n * rate is still left to the browser/sensor to reject via `error`).\n *\n * Permission handling is intentionally NOT implemented here. Compose with\n * `<wcs-permission name=\"magnetometer\">` instead (see the README's permission\n * example, \"Gate on permission, then start\", and docs/sensor-tag-design.md).\n */\nexport class WcsMagnetometer extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...MagnetometerCore.wcBindable,\n    inputs: [{ name: \"frequency\" }],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: MagnetometerCore.wcBindable.commands,\n  };\n\n  private _core: MagnetometerCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new MagnetometerCore(this);\n  }\n\n  // --- Attribute accessors ---\n\n  /**\n   * Sampling frequency in Hz. Reads back `null` when unset, blank, or when the\n   * attribute does not parse to a positive finite number (NaN, `\"0\"`, negative)\n   * — in every such \"no usable value\" case the platform default applies.\n   *\n   * Note the deliberate set/get asymmetry: `set frequency(0)` (or any\n   * non-positive/non-finite value) still writes the attribute verbatim for\n   * transparency/inspectability, but the getter normalizes it back to `null`.\n   * A round-trip through a non-positive value therefore does NOT preserve it —\n   * that value carries no valid sampling meaning, so it is treated as \"unset\"\n   * on read. Only positive finite frequencies survive a set→get round-trip.\n   *\n   * This value is read only at `start()` time. There is no\n   * `attributeChangedCallback`, and `MagnetometerCore.start()` is idempotent\n   * while already started (a redundant call is a no-op), so setting\n   * `frequency` (attribute or property) on an already-running sensor has no\n   * effect until the caller `stop()`s and `start()`s again (see the README's\n   * \"Notes & limitations\").\n   */\n  get frequency(): number | null {\n    const attr = this.getAttribute(\"frequency\");\n    if (attr === null || attr.trim() === \"\") return null;\n    const parsed = Number(attr);\n    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;\n  }\n\n  set frequency(value: number | null | undefined) {\n    if (value === null || value === undefined) {\n      this.removeAttribute(\"frequency\");\n    } else {\n      this.setAttribute(\"frequency\", String(value));\n    }\n  }\n\n  // --- Core delegated getters ---\n\n  get x(): number | null {\n    return this._core.x;\n  }\n\n  get y(): number | null {\n    return this._core.y;\n  }\n\n  get z(): number | null {\n    return this._core.z;\n  }\n\n  get error(): WcsMagnetometerErrorDetail | null {\n    return this._core.error;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Commands ---\n\n  start(): void {\n    this._core.start(this.frequency ?? undefined);\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  // --- Lifecycle ---\n\n  // Deliberately does NOT auto-start the sensor on connect. Unlike\n  // Geolocation (whose default phase acquires a fix immediately unless\n  // `manual` is set), Magnetometer has no such \"connect implies observing\"\n  // precedent in the design doc (docs/sensor-tag-design.md §1.3):\n  // start/stop are the only commands, so connecting the element merely makes\n  // it inert until a command-token `start` (or the `start()` method) is\n  // invoked. This also keeps behavior predictable when composed with\n  // `<wcs-permission name=\"magnetometer\">`: the caller decides when to start,\n  // typically gated on `granted`.\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    // No asynchronous probe to await (docs/async-io-node-guidelines.md §3.8);\n    // kept for SSR uniformity with other IO nodes.\n    this._connectedCallbackPromise = this._core.ready;\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { WcsMagnetometer } from \"./components/Magnetometer.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.magnetometer)) {\n    customElements.define(config.tagNames.magnetometer, WcsMagnetometer);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapMagnetometer(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:{magnetometer:"wcs-magnetometer"}};function t(e){if(null===e||"object"!=typeof e)return e;Object.freeze(e);for(const r of Object.keys(e))t(e[r]);return e}function r(e){if(null===e||"object"!=typeof e)return e;const t={};for(const s of Object.keys(e))t[s]=r(e[s]);return t}let s=null;const n=e;function o(){return s||(s=t(r(e))),s}const i=Object.freeze({x:null,y:null,z:null});class a extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"x",event:"wcs-magnetometer:reading",getter:e=>e.detail.x},{name:"y",event:"wcs-magnetometer:reading",getter:e=>e.detail.y},{name:"z",event:"wcs-magnetometer:reading",getter:e=>e.detail.z},{name:"error",event:"wcs-magnetometer:error"}],commands:[{name:"start"},{name:"stop"}]};_target;_reading=i;_error=null;_sensor=null;constructor(e){super(),this._target=e??this}get x(){return this._reading.x}get y(){return this._reading.y}get z(){return this._reading.z}get error(){return this._error}get ready(){return Promise.resolve()}_setReading(e){this._reading=e,this._target.dispatchEvent(new CustomEvent("wcs-magnetometer:reading",{detail:e,bubbles:!0}))}_setError(e){this._error?.error===e?.error&&this._error?.message===e?.message||(this._error=e,this._target.dispatchEvent(new CustomEvent("wcs-magnetometer:error",{detail:e,bubbles:!0})))}start(e){if(this._sensor)return;const t=this._createSensor(e);if(t){t.addEventListener("reading",this._onReading),t.addEventListener("error",this._onError),this._sensor=t;try{t.start()}catch(e){this._teardownSensor(),this._setError({error:e?.name??"error",message:e?.message??String(e)})}}}stop(){if(this._sensor){try{this._sensor.stop()}catch{}this._teardownSensor()}}observe(e){return this.start(e),this.ready}dispose(){this.stop()}_teardownSensor(){this._sensor.removeEventListener("reading",this._onReading),this._sensor.removeEventListener("error",this._onError),this._sensor=null}_createSensor(e){const t=globalThis.Magnetometer;if("function"!=typeof t)return this._setError({error:"unsupported",message:"Magnetometer is not supported"}),null;try{return new t(void 0!==e?{frequency:e}:void 0)}catch(e){return this._setError({error:e?.name??"error",message:e?.message??String(e)}),null}}_onReading=e=>{const t=e.target;this._setReading({x:t.x,y:t.y,z:t.z})};_onError=e=>{const t=e.error;this._setError({error:t?.name??"error",message:t?.message??"Sensor error"})}}class c extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...a.wcBindable,inputs:[{name:"frequency"}],commands:a.wcBindable.commands};_core;_connectedCallbackPromise=Promise.resolve();constructor(){super(),this._core=new a(this)}get frequency(){const e=this.getAttribute("frequency");if(null===e||""===e.trim())return null;const t=Number(e);return Number.isFinite(t)&&t>0?t:null}set frequency(e){null==e?this.removeAttribute("frequency"):this.setAttribute("frequency",String(e))}get x(){return this._core.x}get y(){return this._core.y}get z(){return this._core.z}get error(){return this._core.error}get connectedCallbackPromise(){return this._connectedCallbackPromise}start(){this._core.start(this.frequency??void 0)}stop(){this._core.stop()}connectedCallback(){this.style.display="none",this._connectedCallbackPromise=this._core.ready}disconnectedCallback(){this._core.dispose()}}function m(t){var r;t&&((r=t).tagNames&&Object.assign(e.tagNames,r.tagNames),s=null),customElements.get(n.tagNames.magnetometer)||customElements.define(n.tagNames.magnetometer,c)}export{a as MagnetometerCore,c as WcsMagnetometer,m as bootstrapMagnetometer,o 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/MagnetometerCore.ts","../src/components/Magnetometer.ts","../src/bootstrapMagnetometer.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    magnetometer: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    magnetometer: \"wcs-magnetometer\",\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, WcsMagnetometerReading, WcsMagnetometerErrorDetail } from \"../types.js\";\n\nconst NULL_READING: WcsMagnetometerReading = Object.freeze({ x: null, y: null, z: null });\n\n/**\n * Headless Magnetometer primitive. A thin, framework-agnostic wrapper around\n * the Generic Sensor API's `Magnetometer` class exposed through the\n * wc-bindable protocol.\n *\n * The platform `Sensor` base class (shared by `Accelerometer` / `Gyroscope` /\n * `Magnetometer` / `AmbientLightSensor`) reports failure through an `'error'`\n * event rather than a rejected promise, so this Core can satisfy never-throw\n * (docs/async-io-node-guidelines.md §3.6) by simply forwarding that event —\n * see docs/sensor-tag-design.md §0. The one place a synchronous\n * exception *can* still escape the platform API is the `Magnetometer`\n * constructor itself (e.g. `SecurityError` on permission denial or a\n * feature-policy block); `_createSensor()` wraps that single call in\n * try/catch, mirroring FetchCore's `_doFetch` try/catch around\n * `globalThis.fetch` (packages/fetch/src/core/FetchCore.ts).\n *\n * `x`/`y`/`z` are three getters derived from the single `wcs-magnetometer:reading`\n * event (mirroring how NetworkCore exposes effectiveType/downlink/… from one\n * `wcs-network:change` event): the native `reading` event already reports all\n * three axes together, so they are not split into independent events. `reading`\n * is an event-like signal (a fresh sample every time, not a settled state) and\n * is therefore deliberately NOT same-value guarded — every sample dispatches.\n * `error` is state-like (denial / unsupported does not change from tick to\n * tick) and IS same-value guarded, and is published on its own\n * `wcs-magnetometer:error` event, independent of `reading`.\n *\n * No `_gen` generation guard: start()/stop() are a synchronous\n * subscribe/unsubscribe toggle with no asynchronous probe whose stale\n * resolution could race a dispose() — see docs/sensor-tag-design.md §1.5\n * (the same reasoning as NetworkCore, docs/network-tag-design.md §5).\n *\n * Permissions: this Core does not query `navigator.permissions` itself.\n * Compose with `<wcs-permission name=\"magnetometer\">` instead — see\n * docs/sensor-tag-design.md §\"2番目の決定: Permissions APIとの合成\".\n */\nexport class MagnetometerCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"x\", event: \"wcs-magnetometer:reading\", getter: (e: Event) => (e as CustomEvent).detail.x },\n      { name: \"y\", event: \"wcs-magnetometer:reading\", getter: (e: Event) => (e as CustomEvent).detail.y },\n      { name: \"z\", event: \"wcs-magnetometer:reading\", getter: (e: Event) => (e as CustomEvent).detail.z },\n      { name: \"error\", event: \"wcs-magnetometer:error\" },\n    ],\n    commands: [{ name: \"start\" }, { name: \"stop\" }],\n  };\n\n  private _target: EventTarget;\n  private _reading: WcsMagnetometerReading = NULL_READING;\n  private _error: WcsMagnetometerErrorDetail | null = null;\n\n  // The live sensor instance while started (null otherwise), kept so stop()\n  // can remove its listeners precisely and so start() can detect \"already\n  // started\" without a separate boolean (docs/async-io-node-guidelines.md\n  // §3.5 idempotency).\n  private _sensor: (EventTarget & { start(): void; stop(): void }) | null = null;\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get x(): number | null {\n    return this._reading.x;\n  }\n\n  get y(): number | null {\n    return this._reading.y;\n  }\n\n  get z(): number | null {\n    return this._reading.z;\n  }\n\n  get error(): WcsMagnetometerErrorDetail | null {\n    return this._error;\n  }\n\n  /** No asynchronous probe to await: start()/stop() are synchronous\n   *  (docs/async-io-node-guidelines.md §3.8 is satisfied trivially, mirroring\n   *  NetworkCore). */\n  get ready(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  // --- State setters ---\n\n  // Deliberately NOT same-value guarded: a `reading` is a fresh sample, not a\n  // settled state, so it must dispatch every time even when the values happen\n  // to repeat (docs/sensor-tag-design.md §1.1).\n  private _setReading(reading: WcsMagnetometerReading): void {\n    this._reading = reading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-magnetometer:reading\", {\n      detail: reading,\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: WcsMagnetometerErrorDetail | null): void {\n    // Same-value guard (by error name + message): error is state-like, unlike\n    // reading — a repeated identical error (same name and message) must not\n    // redispatch. Note `error` is also STICKY: nothing calls _setError(null),\n    // so a successful (re)start does not clear a prior failure — the monitoring\n    // sensor family deliberately keeps the last observed error (docs/sensor-tag-design.md §1.5).\n    if (this._error?.error === error?.error && this._error?.message === error?.message) return;\n    this._error = error;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-magnetometer:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  // --- Public API ---\n\n  /**\n   * Start the sensor at the given `frequency` (Hz), or the platform default\n   * when omitted. Idempotent while already started: a redundant start() does\n   * not construct a second sensor instance (which would leak the first).\n   * Restart with a different frequency via stop() + start().\n   *\n   * Synchronous, mirroring the native `Sensor.start()` — never throws\n   * (docs/async-io-node-guidelines.md §3.6): both \"unsupported\" and a\n   * synchronous constructor exception (permission denial, feature-policy\n   * block) are converted to the `error` property instead of propagating.\n   */\n  start(frequency?: number): void {\n    if (this._sensor) return;\n    const sensor = this._createSensor(frequency);\n    if (!sensor) return;\n    sensor.addEventListener(\"reading\", this._onReading as EventListener);\n    sensor.addEventListener(\"error\", this._onError as EventListener);\n    this._sensor = sensor;\n    try {\n      sensor.start();\n    } catch (e: any) {\n      // Defensive: the platform contract says start()/stop() do not throw\n      // (failures surface via the 'error' event), but never-throw is a hard\n      // requirement here, so guard against a non-conformant implementation\n      // too.\n      this._teardownSensor();\n      this._setError({ error: e?.name ?? \"error\", message: e?.message ?? String(e) });\n    }\n  }\n\n  /** Stop the sensor and detach its listeners. Safe to call when not started. */\n  stop(): void {\n    if (!this._sensor) return;\n    try {\n      this._sensor.stop();\n    } catch {\n      // Never-throw defensive guard, symmetric with start(). Teardown below\n      // still runs so listeners are detached regardless.\n    }\n    this._teardownSensor();\n  }\n\n  /** Lifecycle alias for start(), so the Shell's connectedCallback can drive\n   *  this Core the same way as other IO nodes' observe()/dispose() pair. No\n   *  asynchronous probe, so the returned promise always resolves immediately. */\n  observe(frequency?: number): Promise<void> {\n    this.start(frequency);\n    return this.ready;\n  }\n\n  /** Lifecycle alias for stop(), invoked from the Shell's disconnectedCallback. */\n  dispose(): void {\n    this.stop();\n  }\n\n  // --- Internal ---\n\n  // Both call sites (start()'s catch, stop()) only ever invoke this once\n  // `this._sensor` is already known non-null, so there is no null-guard here\n  // (nothing to defend against).\n  private _teardownSensor(): void {\n    this._sensor!.removeEventListener(\"reading\", this._onReading as EventListener);\n    this._sensor!.removeEventListener(\"error\", this._onError as EventListener);\n    this._sensor = null;\n  }\n\n  /**\n   * Construct the platform `Magnetometer`, guarding both non-support and a\n   * synchronous constructor exception. Never calls the raw `new Magnetometer(...)`\n   * anywhere else in this class — see docs/sensor-tag-design.md §1.5.\n   *\n   * API resolution is call-time (docs/async-io-node-guidelines.md §3.7):\n   * re-checked on every start(), never cached, so tests can install/remove\n   * the global freely and an unsupported environment is always reported\n   * correctly.\n   */\n  private _createSensor(frequency?: number): (EventTarget & { start(): void; stop(): void }) | null {\n    const Ctor = (globalThis as any).Magnetometer;\n    if (typeof Ctor !== \"function\") {\n      this._setError({ error: \"unsupported\", message: \"Magnetometer is not supported\" });\n      return null;\n    }\n    try {\n      return new Ctor(frequency !== undefined ? { frequency } : undefined);\n    } catch (e: any) {\n      // SecurityError (permission denial, feature-policy block) or any other\n      // synchronous construction failure. Mirrors the FetchCore._doFetch\n      // try/catch structure (packages/fetch/src/core/FetchCore.ts) — a\n      // synchronous constructor call here instead of an awaited fetch().\n      this._setError({ error: e?.name ?? \"error\", message: e?.message ?? String(e) });\n      return null;\n    }\n  }\n\n  private _onReading = (event: Event): void => {\n    const sensor = event.target as unknown as { x: number | null; y: number | null; z: number | null };\n    this._setReading({ x: sensor.x, y: sensor.y, z: sensor.z });\n  };\n\n  private _onError = (event: Event): void => {\n    const err = (event as any).error as { name?: string; message?: string } | undefined;\n    // Fallback is a meaningful constant, NOT String(err): a SensorErrorEvent\n    // without an `error` field would otherwise stringify `undefined` into the\n    // literal message \"undefined\" (aligned across the sensor family).\n    this._setError({ error: err?.name ?? \"error\", message: err?.message ?? \"Sensor error\" });\n  };\n}\n","import { IWcBindable, WcsMagnetometerErrorDetail } from \"../types.js\";\nimport { MagnetometerCore } from \"../core/MagnetometerCore.js\";\n\n/**\n * `<wcs-magnetometer>` — declarative Generic Sensor API (`Magnetometer`)\n * monitor + start/stop control.\n *\n * Unlike `<wcs-network>` / `<wcs-permission>` (pure monitors), this Shell is a\n * bidirectional node: `start`/`stop` commands (command-token: state → element)\n * alongside the `x`/`y`/`z`/`error` observable surface (event-token: element →\n * state). The `frequency` attribute is the sole configuration input, forwarded\n * to the platform `Magnetometer` constructor's `{ frequency }` option\n * (docs/sensor-tag-design.md §1.2). The getter normalizes it: a non-finite or\n * non-positive value (NaN, 0, negative) reads back as `null` — meaning \"no\n * frequency specified\" — so start() falls back to the platform default rather\n * than forwarding a value the sensor would reject. Any positive finite value is\n * passed through verbatim (no upper-bound clamping — an out-of-range-but-positive\n * rate is still left to the browser/sensor to reject via `error`).\n *\n * Permission handling is intentionally NOT implemented here. Compose with\n * `<wcs-permission name=\"magnetometer\">` instead (see the README's permission\n * example, \"Gate on permission, then start\", and docs/sensor-tag-design.md).\n */\nexport class WcsMagnetometer extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...MagnetometerCore.wcBindable,\n    inputs: [{ name: \"frequency\" }],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: MagnetometerCore.wcBindable.commands,\n  };\n\n  private _core: MagnetometerCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new MagnetometerCore(this);\n  }\n\n  // --- Attribute accessors ---\n\n  /**\n   * Sampling frequency in Hz. Reads back `null` when unset, blank, or when the\n   * attribute does not parse to a positive finite number (NaN, `\"0\"`, negative)\n   * — in every such \"no usable value\" case the platform default applies.\n   *\n   * Note the deliberate set/get asymmetry: `set frequency(0)` (or any\n   * non-positive/non-finite value) still writes the attribute verbatim for\n   * transparency/inspectability, but the getter normalizes it back to `null`.\n   * A round-trip through a non-positive value therefore does NOT preserve it —\n   * that value carries no valid sampling meaning, so it is treated as \"unset\"\n   * on read. Only positive finite frequencies survive a set→get round-trip.\n   *\n   * This value is read only at `start()` time. There is no\n   * `attributeChangedCallback`, and `MagnetometerCore.start()` is idempotent\n   * while already started (a redundant call is a no-op), so setting\n   * `frequency` (attribute or property) on an already-running sensor has no\n   * effect until the caller `stop()`s and `start()`s again (see the README's\n   * \"Notes & limitations\").\n   */\n  get frequency(): number | null {\n    const attr = this.getAttribute(\"frequency\");\n    if (attr === null || attr.trim() === \"\") return null;\n    const parsed = Number(attr);\n    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;\n  }\n\n  set frequency(value: number | null | undefined) {\n    if (value === null || value === undefined) {\n      this.removeAttribute(\"frequency\");\n    } else {\n      this.setAttribute(\"frequency\", String(value));\n    }\n  }\n\n  // --- Core delegated getters ---\n\n  get x(): number | null {\n    return this._core.x;\n  }\n\n  get y(): number | null {\n    return this._core.y;\n  }\n\n  get z(): number | null {\n    return this._core.z;\n  }\n\n  get error(): WcsMagnetometerErrorDetail | null {\n    return this._core.error;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Commands ---\n\n  start(): void {\n    this._core.start(this.frequency ?? undefined);\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  // --- Lifecycle ---\n\n  // Deliberately does NOT auto-start the sensor on connect. Unlike\n  // Geolocation (whose default phase acquires a fix immediately unless\n  // `manual` is set), Magnetometer has no such \"connect implies observing\"\n  // precedent in the design doc (docs/sensor-tag-design.md §1.3):\n  // start/stop are the only commands, so connecting the element merely makes\n  // it inert until a command-token `start` (or the `start()` method) is\n  // invoked. This also keeps behavior predictable when composed with\n  // `<wcs-permission name=\"magnetometer\">`: the caller decides when to start,\n  // typically gated on `granted`.\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    // No asynchronous probe to await (docs/async-io-node-guidelines.md §3.8);\n    // kept for SSR uniformity with other IO nodes.\n    this._connectedCallbackPromise = this._core.ready;\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 bootstrapMagnetometer(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { WcsMagnetometer } from \"./components/Magnetometer.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.magnetometer)) {\n    customElements.define(config.tagNames.magnetometer, WcsMagnetometer);\n  }\n}\n"],"names":["_config","tagNames","magnetometer","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","NULL_READING","x","y","z","MagnetometerCore","EventTarget","static","protocol","version","properties","name","event","getter","e","detail","commands","_target","_reading","_error","_sensor","constructor","target","super","this","error","ready","Promise","resolve","_setReading","reading","dispatchEvent","CustomEvent","bubbles","_setError","message","start","frequency","sensor","_createSensor","addEventListener","_onReading","_onError","_teardownSensor","String","stop","observe","dispose","removeEventListener","Ctor","globalThis","Magnetometer","undefined","err","WcsMagnetometer","HTMLElement","wcBindable","inputs","_core","_connectedCallbackPromise","attr","getAttribute","trim","parsed","Number","isFinite","value","removeAttribute","setAttribute","connectedCallbackPromise","connectedCallback","style","display","disconnectedCallback","bootstrapMagnetometer","userConfig","partialConfig","assign","customElements","get","define"],"mappings":"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"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@wcstack/magnetometer",
+  "version": "1.16.0",
+  "description": "Declarative Magnetometer component for Web Components. Framework-agnostic Generic Sensor API (Magnetometer) 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",
+    "magnetometer",
+    "generic-sensor",
+    "motion",
+    "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/magnetometer"
+  },
+  "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"
+  }
+}