@wcstack/ambient-light-sensor 1.20.0 → 1.21.0

package/README.ja.md

@@ -7,7 +7,7 @@
 `@wcstack/state` と組み合わせると、`<wcs-ambient-light-sensor>` はパス契約で直接バインドできます:
 
 - **入力サーフェス**: `frequency`（サンプリングレート、Hz）
-- **出力 state サーフェス**: `illuminance`、`error`
+- **出力 state サーフェス**: `illuminance`、`error`、`errorInfo`
 
 明るさ駆動のUI（自動ダークモード、画面減光）を、`AmbientLightSensor`/`reading`/`error`リスナーの配線コードを書かずにHTML上で宣言的に表現できます。
 
@@ -102,6 +102,7 @@ npm install @wcstack/ambient-light-sensor
 | -------------- | --------------------------------------- | ---- |
 | `illuminance`  | `wcs-ambient-light-sensor:reading`       | 周囲の明るさ（lux）。初回読み取り前は`null`。 |
 | `error`        | `wcs-ambient-light-sensor:error`         | 正規化された`{ error, message }`、無ければ`null`。 |
+| `errorInfo`    | `wcs-ambient-light-sensor:error-info-changed` | シリアライズ可能な失敗分類（`WcsIoErrorInfo` — 安定した `code` / `phase` / `recoverable`）、無ければ`null`。`error`から派生する追加的な出力で、既存の`error`の形状は不変。 |
 
 ## コマンド
 
@@ -164,6 +165,7 @@ wcs-ambient-light-sensor:state(error) ~ .fallback { display: block; }
 
 - **`_gen`世代ガードは無し。** `start()`/`stop()`は同期的な購読/購読解除のトグルであり、`dispose()`とレースしうる非同期probeが存在しません（`docs/sensor-tag-design.md` §1.5）。
 - **`error`は sticky（据え置き）です。** 最後に観測した失敗（`unsupported`、`SecurityError`等）を保持し、その後の`start()`成功や`reading`受信では自動クリアされません。`stop()`＋`start()`でリトライが成功しても直前の`error`は残り続けます。必要なら利用側の state でクリア／再解釈してください。
+- **`errorInfo` 分類（taxonomy）。** 同じ失敗をシリアライズ可能な `WcsIoErrorInfo`（安定した `code` / `phase` / `recoverable`）に分類する**追加的な**バインド可能出力（`wcs-ambient-light-sensor:error-info-changed`）で、`error`の形状は変更しません。正規化された error 名に応じて対応づけます: `unsupported` → `capability-missing`（phase `probe`）、`SecurityError` / `NotAllowedError` → `not-allowed`（phase `start`）、`NotReadableError` → `not-readable`（phase `execute`）、その他のセンサー失敗 → `sensor-error`（phase `execute`）。いずれも `recoverable: false` です。`errorInfo` は `error` と完全に同じタイミングで遷移するため、同様に **sticky** で、`error` が `null` に戻るときにのみ `null` に戻ります。共有の `WcsIoErrorInfo` 型と `WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE` 定数はエクスポートされます。
 - **生の`new AmbientLightSensor(...)`は唯一のガード付き構築ヘルパー以外では呼ばない。** 権限拒否・Permissions-Policyブロックは同期的に例外を投げます。
 - 権限状態（`granted`/`denied`/`prompt`）は意図的にこのノードでは重複実装していません — `<wcs-permission name="ambient-light-sensor">`と合成してください。
 - **採用前に現在のブラウザ対応状況を必ず確認してください** — 上記「なぜ存在するか」参照。

package/README.md

@@ -8,7 +8,7 @@ It is an **async primitive node** that turns ambient light readings into reactiv
 With `@wcstack/state`, `<wcs-ambient-light-sensor>` can be bound directly through path contracts:
 
 - **input surface**: `frequency` (sampling rate in Hz)
-- **output state surface**: `illuminance`, `error`
+- **output state surface**: `illuminance`, `error`, `errorInfo`
 
 This means light-level-driven UI (auto dark mode, screen dimming) can be expressed declaratively in HTML, without writing `AmbientLightSensor`/`reading`/`error`-listener glue in your UI layer.
 
@@ -103,6 +103,7 @@ Every bound state path must be declared up front — binding an undeclared path
 | ------------- | -------------------------------------- | ------------ |
 | `illuminance` | `wcs-ambient-light-sensor:reading`      | Ambient light level in lux, or `null` before the first reading. |
 | `error`       | `wcs-ambient-light-sensor:error`        | Normalized `{ error, message }`, or `null`. |
+| `errorInfo`   | `wcs-ambient-light-sensor:error-info-changed` | Serializable failure taxonomy (`WcsIoErrorInfo` — stable `code` / `phase` / `recoverable`), or `null`. Additive, derived from `error`; the existing `error` shape is unchanged. |
 
 ## Commands
 
@@ -167,6 +168,7 @@ DevTools open; it is not a supported styling hook.
 
 - **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.
+- **`errorInfo` taxonomy.** An **additive** bindable output (`wcs-ambient-light-sensor:error-info-changed`) that classifies the same failure into a serializable `WcsIoErrorInfo` with a stable `code` / `phase` / `recoverable`, without changing the `error` shape. The mapping keys off the normalized error name: `unsupported` → `capability-missing` (phase `probe`); `SecurityError` / `NotAllowedError` → `not-allowed` (phase `start`); `NotReadableError` → `not-readable` (phase `execute`); any other sensor failure → `sensor-error` (phase `execute`). All are `recoverable: false`. `errorInfo` transitions exactly when `error` does, so it is **sticky** in the same way and only returns to `null` when `error` does. The shared `WcsIoErrorInfo` type and the `WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE` constants are exported.
 - **Never call the raw `new AmbientLightSensor(...)` 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="ambient-light-sensor">`.
 - **Confirm current browser support before adopting this package** — see "Why this exists" above.

package/dist/index.d.ts

@@ -1,3 +1,14 @@
+/** operation error の phase(taxonomy)。 */
+type WcsIoErrorPhase = "probe" | "start" | "execute" | "decode" | "commit" | "dispose";
+/** serializable な error info(non-cloneable な cause とは分離。DevTools / remote へは info のみ)。 */
+interface WcsIoErrorInfo {
+    readonly code: string;
+    readonly phase: WcsIoErrorPhase;
+    readonly recoverable: boolean;
+    readonly capabilityId?: string;
+    readonly message: string;
+}
+
 interface IWcBindableProperty {
     readonly name: string;
     readonly event: string;
@@ -13,7 +24,8 @@ interface IWcBindableCommand {
 }
 interface IWcBindable {
     readonly protocol: "wc-bindable";
-    readonly version: 1;
+    /** Integer protocol version. All versions >= 1 are core-compatible. */
+    readonly version: number;
     readonly properties: readonly IWcBindableProperty[];
     readonly inputs?: readonly IWcBindableInput[];
     readonly commands?: readonly IWcBindableCommand[];
@@ -63,6 +75,8 @@ interface WcsAmbientLightSensorErrorDetail {
  */
 interface WcsAmbientLightSensorCoreValues extends WcsAmbientLightSensorReading {
     error: WcsAmbientLightSensorErrorDetail | null;
+    /** Additive failure taxonomy derived from `error` (stable code / phase / recoverable). */
+    errorInfo: WcsIoErrorInfo | null;
 }
 /**
  * Value types for the Shell (`<wcs-ambient-light-sensor>`) — identical observable
@@ -113,16 +127,25 @@ declare class AmbientLightSensorCore extends EventTarget {
     private _target;
     private _reading;
     private _error;
+    private _errorInfo;
     private _sensor;
     constructor(target?: EventTarget);
     get illuminance(): number | null;
     get error(): WcsAmbientLightSensorErrorDetail | null;
+    /**
+     * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /
+     * `recoverable`), or null. Additive wc-bindable property (event
+     * `wcs-ambient-light-sensor:error-info-changed`), derived from `error`; the existing
+     * `error` property/event are unchanged.
+     */
+    get errorInfo(): WcsIoErrorInfo | 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;
+    private _commitErrorInfo;
     /**
      * Start the sensor at the given `frequency` (Hz), or the platform default
      * when omitted. Idempotent while already started: a redundant start() does
@@ -204,6 +227,7 @@ declare class WcsAmbientLightSensor extends HTMLElement {
     set frequency(value: number | null | undefined);
     get illuminance(): number | null;
     get error(): WcsAmbientLightSensorErrorDetail | null;
+    get errorInfo(): WcsIoErrorInfo | null;
     get connectedCallbackPromise(): Promise<void>;
     start(): void;
     stop(): void;
@@ -211,5 +235,30 @@ declare class WcsAmbientLightSensor extends HTMLElement {
     disconnectedCallback(): void;
 }
 
-export { AmbientLightSensorCore, WcsAmbientLightSensor, bootstrapAmbientLightSensor, getConfig };
-export type { IWritableConfig, IWritableTagNames, WcsAmbientLightSensorCoreValues, WcsAmbientLightSensorErrorDetail, WcsAmbientLightSensorReading, WcsAmbientLightSensorValues };
+/**
+ * ambientLightSensorCapabilities.ts
+ *
+ * AmbientLightSensor node 固有の error code(taxonomy)と derivation。汎用の error info
+ * 型は `./platformCapability.js`(/io-core/ から copy-distribution される生成ファイル)から
+ * import する。sensor は監視系(継続 subscribe/unsubscribe)で競合する operation を持た
+ * ないため lane は持たず、error taxonomy(errorInfo)のみを採用する。
+ *
+ * sensor family(accelerometer / gyroscope / magnetometer / ambient-light-sensor)は
+ * error 面が構造同一(`{ error: <name>, message }`、`.error` が Error.name / "unsupported"
+ * / "error" fallback)なので、taxonomy も 4 兄弟で一致させる。
+ */
+
+/** 安定した ambient-light-sensor error code(taxonomy)。値は公開キーとして固定。 */
+declare const WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE: {
+    /** Sensor API 非対応(`globalThis.AmbientLightSensor` 不在)。 */
+    readonly CapabilityMissing: "capability-missing";
+    /** `SecurityError` / `NotAllowedError` — 権限拒否・feature-policy ブロック。 */
+    readonly NotAllowed: "not-allowed";
+    /** `NotReadableError` — センサーハードウェアを読めない。 */
+    readonly NotReadable: "not-readable";
+    /** その他の SensorErrorEvent / 想定外の失敗。 */
+    readonly SensorError: "sensor-error";
+};
+
+export { AmbientLightSensorCore, WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE, WcsAmbientLightSensor, bootstrapAmbientLightSensor, getConfig };
+export type { IWritableConfig, IWritableTagNames, WcsAmbientLightSensorCoreValues, WcsAmbientLightSensorErrorDetail, WcsAmbientLightSensorReading, WcsAmbientLightSensorValues, WcsIoErrorInfo, WcsIoErrorPhase };

package/dist/index.esm.js

@@ -36,6 +36,53 @@ function setConfig(partialConfig) {
     frozenConfig = null;
 }
 
+/**
+ * ambientLightSensorCapabilities.ts
+ *
+ * AmbientLightSensor node 固有の error code(taxonomy)と derivation。汎用の error info
+ * 型は `./platformCapability.js`(/io-core/ から copy-distribution される生成ファイル)から
+ * import する。sensor は監視系(継続 subscribe/unsubscribe)で競合する operation を持た
+ * ないため lane は持たず、error taxonomy(errorInfo)のみを採用する。
+ *
+ * sensor family(accelerometer / gyroscope / magnetometer / ambient-light-sensor)は
+ * error 面が構造同一(`{ error: <name>, message }`、`.error` が Error.name / "unsupported"
+ * / "error" fallback)なので、taxonomy も 4 兄弟で一致させる。
+ */
+/** 安定した ambient-light-sensor error code(taxonomy)。値は公開キーとして固定。 */
+const WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE = {
+    /** Sensor API 非対応(`globalThis.AmbientLightSensor` 不在)。 */
+    CapabilityMissing: "capability-missing",
+    /** `SecurityError` / `NotAllowedError` — 権限拒否・feature-policy ブロック。 */
+    NotAllowed: "not-allowed",
+    /** `NotReadableError` — センサーハードウェアを読めない。 */
+    NotReadable: "not-readable",
+    /** その他の SensorErrorEvent / 想定外の失敗。 */
+    SensorError: "sensor-error",
+};
+/**
+ * sensor の失敗を serializable な error taxonomy に写す。`name` は error detail の
+ * `.error`(`Error.name` / "unsupported" / "error" fallback)。
+ *
+ * - "unsupported" は開始前の能力欠如 → phase="probe" / capability-missing。
+ * - `SecurityError` / `NotAllowedError` は sensor 構築時の権限拒否 → phase="start" /
+ *   not-allowed。いずれも retry で回復しない(recoverable=false)。
+ * - `NotReadableError` は稼働中のハードウェア読取失敗 → phase="execute" / not-readable。
+ * - それ以外(SensorErrorEvent の他 name / "error" fallback)は phase="execute" /
+ *   sensor-error。
+ */
+function deriveAmbientLightSensorErrorInfo(name, message) {
+    if (name === "unsupported") {
+        return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.CapabilityMissing, phase: "probe", recoverable: false, message };
+    }
+    if (name === "SecurityError" || name === "NotAllowedError") {
+        return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.NotAllowed, phase: "start", recoverable: false, message };
+    }
+    if (name === "NotReadableError") {
+        return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.NotReadable, phase: "execute", recoverable: false, message };
+    }
+    return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.SensorError, phase: "execute", recoverable: false, message };
+}
+
 const NULL_READING = Object.freeze({ illuminance: null });
 /**
  * Headless AmbientLightSensor primitive. A thin, framework-agnostic wrapper around
@@ -78,12 +125,18 @@ class AmbientLightSensorCore extends EventTarget {
         properties: [
             { name: "illuminance", event: "wcs-ambient-light-sensor:reading", getter: (e) => e.detail.illuminance },
             { name: "error", event: "wcs-ambient-light-sensor:error" },
+            // Serializable failure taxonomy (stable code / phase / recoverable), or null.
+            // Additive bindable output derived from `error.error` (the Error.name /
+            // "unsupported"); the existing `error` property/event are unchanged. Fires
+            // wcs-ambient-light-sensor:error-info-changed. No lane — the sensor is a monitor.
+            { name: "errorInfo", event: "wcs-ambient-light-sensor:error-info-changed" },
         ],
         commands: [{ name: "start" }, { name: "stop" }],
     };
     _target;
     _reading = NULL_READING;
     _error = null;
+    _errorInfo = 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
@@ -99,6 +152,15 @@ class AmbientLightSensorCore extends EventTarget {
     get error() {
         return this._error;
     }
+    /**
+     * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /
+     * `recoverable`), or null. Additive wc-bindable property (event
+     * `wcs-ambient-light-sensor:error-info-changed`), derived from `error`; the existing
+     * `error` property/event are unchanged.
+     */
+    get errorInfo() {
+        return this._errorInfo;
+    }
     /** No asynchronous probe to await: start()/stop() are synchronous
      *  (docs/async-io-node-guidelines.md §3.8 is satisfied trivially, mirroring
      *  NetworkCore). */
@@ -125,11 +187,25 @@ class AmbientLightSensorCore extends EventTarget {
         if (this._error?.error === error?.error && this._error?.message === error?.message)
             return;
         this._error = error;
+        // Keep the additive `errorInfo` taxonomy in sync with `error`: derive from the
+        // error name (or null on clear). Fires before the `error` event so an observer
+        // binding both sees the classification first, mirroring the io-node family.
+        this._commitErrorInfo(error === null ? null : deriveAmbientLightSensorErrorInfo(error.error, error.message));
         this._target.dispatchEvent(new CustomEvent("wcs-ambient-light-sensor:error", {
             detail: error,
             bubbles: true,
         }));
     }
+    // Called only from _setError (which already same-value-guards on the error name
+    // + message), so errorInfo transitions exactly when error does — no separate
+    // guard needed here.
+    _commitErrorInfo(info) {
+        this._errorInfo = info;
+        this._target.dispatchEvent(new CustomEvent("wcs-ambient-light-sensor:error-info-changed", {
+            detail: info,
+            bubbles: true,
+        }));
+    }
     // --- Public API ---
     /**
      * Start the sensor at the given `frequency` (Hz), or the platform default
@@ -358,6 +434,9 @@ class WcsAmbientLightSensor extends HTMLElement {
     get error() {
         return this._core.error;
     }
+    get errorInfo() {
+        return this._core.errorInfo;
+    }
     get connectedCallbackPromise() {
         return this._connectedCallbackPromise;
     }
@@ -402,5 +481,5 @@ function bootstrapAmbientLightSensor(userConfig) {
     registerComponents();
 }
 
-export { AmbientLightSensorCore, WcsAmbientLightSensor, bootstrapAmbientLightSensor, getConfig };
+export { AmbientLightSensorCore, WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE, WcsAmbientLightSensor, bootstrapAmbientLightSensor, getConfig };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/core/AmbientLightSensorCore.ts","../src/components/AmbientLightSensor.ts","../src/registerComponents.ts","../src/bootstrapAmbientLightSensor.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    ambientLightSensor: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    ambientLightSensor: \"wcs-ambient-light-sensor\",\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, WcsAmbientLightSensorReading, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\n\nconst NULL_READING: WcsAmbientLightSensorReading = Object.freeze({ illuminance: null });\n\n/**\n * Headless AmbientLightSensor primitive. A thin, framework-agnostic wrapper around\n * the Generic Sensor API's `AmbientLightSensor` 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 `AmbientLightSensor`\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 * `illuminance` is a single getter derived from the `wcs-ambient-light-sensor:reading`\n * event (unlike Accelerometer/Gyroscope/Magnetometer's x/y/z, this sensor\n * reports one scalar — docs/sensor-tag-design.md §2). `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-ambient-light-sensor: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=\"ambient-light-sensor\">` instead — see\n * docs/sensor-tag-design.md §\"2番目の決定: Permissions APIとの合成\".\n */\nexport class AmbientLightSensorCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"illuminance\", event: \"wcs-ambient-light-sensor:reading\", getter: (e: Event) => (e as CustomEvent).detail.illuminance },\n      { name: \"error\", event: \"wcs-ambient-light-sensor:error\" },\n    ],\n    commands: [{ name: \"start\" }, { name: \"stop\" }],\n  };\n\n  private _target: EventTarget;\n  private _reading: WcsAmbientLightSensorReading = NULL_READING;\n  private _error: WcsAmbientLightSensorErrorDetail | 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 §3.5\n  // 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 illuminance(): number | null {\n    return this._reading.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | 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: WcsAmbientLightSensorReading): void {\n    this._reading = reading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:reading\", {\n      detail: reading,\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: WcsAmbientLightSensorErrorDetail | 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-ambient-light-sensor: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 `AmbientLightSensor`, guarding both non-support and a\n   * synchronous constructor exception. Never calls the raw `new AmbientLightSensor(...)`\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 the\n   * global freely and an unsupported environment is always reported correctly.\n   */\n  private _createSensor(frequency?: number): (EventTarget & { start(): void; stop(): void }) | null {\n    const Ctor = (globalThis as any).AmbientLightSensor;\n    if (typeof Ctor !== \"function\") {\n      this._setError({ error: \"unsupported\", message: \"AmbientLightSensor 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 { illuminance: number | null };\n    this._setReading({ illuminance: sensor.illuminance });\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, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\nimport { AmbientLightSensorCore } from \"../core/AmbientLightSensorCore.js\";\n\n/**\n * `<wcs-ambient-light-sensor>` — declarative Generic Sensor API (`AmbientLightSensor`)\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 `illuminance`/`error` observable surface (event-token: element →\n * state). The `frequency` attribute is the sole configuration input, forwarded\n * to the platform `AmbientLightSensor` 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=\"ambient-light-sensor\">` instead (see the README's permission\n * example, \"Gate on permission, then start\", and docs/sensor-tag-design.md).\n */\nexport class WcsAmbientLightSensor extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...AmbientLightSensorCore.wcBindable,\n    inputs: [{ name: \"frequency\" }],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: AmbientLightSensorCore.wcBindable.commands,\n  };\n\n  private _core: AmbientLightSensorCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n  private _internals: ElementInternals | null = null;\n\n  constructor() {\n    super();\n    this._core = new AmbientLightSensorCore(this);\n    this._internals = this._initInternals();\n    this._wireStates({\n      \"wcs-ambient-light-sensor:error\": (d) => ({ error: d != null }),\n    });\n  }\n\n  // CSS state reflection (:state()) — debug-only snapshot getter. NOT part of\n  // wc-bindable (not a bind target); see README \"CSS styling with :state()\".\n  // MUST NOT return the live CustomStateSet (that would let callers write\n  // states from outside, defeating the point of :state() being read-only).\n  get debugStates(): string[] {\n    return this._internals ? [...this._internals.states] : [];\n  }\n\n  private _initInternals(): ElementInternals | null {\n    // never-throw (async-io-node-guidelines.md §3.6): attachInternals is absent\n    // in happy-dom / older environments, and pre-125 Chromium rejects\n    // non-dashed state names from states.add() (probed and discarded here).\n    // Either case silently disables reflection — the component still works,\n    // it just doesn't expose :state() selectors.\n    try {\n      if (typeof this.attachInternals !== \"function\") return null;\n      const internals = this.attachInternals();\n      internals.states.add(\"wcs-probe\");\n      internals.states.delete(\"wcs-probe\");\n      return internals;\n    } catch {\n      return null;\n    }\n  }\n\n  private _wireStates(map: Record<string, (detail: any) => Record<string, boolean>>): void {\n    if (this._internals === null) return;\n    const states = this._internals.states;\n    for (const [event, toStates] of Object.entries(map)) {\n      this.addEventListener(event, (e) => {\n        const debug = this.hasAttribute(\"debug-states\");\n        for (const [name, on] of Object.entries(toStates((e as CustomEvent).detail))) {\n          try {\n            if (on) { states.add(name); } else { states.delete(name); }\n          } catch { /* never-throw */ }\n          if (debug) this.toggleAttribute(`data-wcs-state-${name}`, on);\n        }\n      });\n    }\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  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 illuminance(): number | null {\n    return this._core.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | 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), AmbientLightSensor 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=\"ambient-light-sensor\">`: 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 (§3.8); kept for SSR uniformity with\n    // other IO nodes.\n    this._connectedCallbackPromise = this._core.ready;\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { WcsAmbientLightSensor } from \"./components/AmbientLightSensor.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.ambientLightSensor)) {\n    customElements.define(config.tagNames.ambientLightSensor, WcsAmbientLightSensor);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapAmbientLightSensor(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/core/ambientLightSensorCapabilities.ts","../src/core/AmbientLightSensorCore.ts","../src/components/AmbientLightSensor.ts","../src/registerComponents.ts","../src/bootstrapAmbientLightSensor.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    ambientLightSensor: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    ambientLightSensor: \"wcs-ambient-light-sensor\",\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","/**\n * ambientLightSensorCapabilities.ts\n *\n * AmbientLightSensor node 固有の error code(taxonomy)と derivation。汎用の error info\n * 型は `./platformCapability.js`(/io-core/ から copy-distribution される生成ファイル)から\n * import する。sensor は監視系(継続 subscribe/unsubscribe)で競合する operation を持た\n * ないため lane は持たず、error taxonomy(errorInfo)のみを採用する。\n *\n * sensor family(accelerometer / gyroscope / magnetometer / ambient-light-sensor)は\n * error 面が構造同一(`{ error: <name>, message }`、`.error` が Error.name / \"unsupported\"\n * / \"error\" fallback)なので、taxonomy も 4 兄弟で一致させる。\n */\n\nimport type { WcsIoErrorInfo } from \"./platformCapability.js\";\n\n/** 安定した ambient-light-sensor error code(taxonomy)。値は公開キーとして固定。 */\nexport const WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE = {\n  /** Sensor API 非対応(`globalThis.AmbientLightSensor` 不在)。 */\n  CapabilityMissing: \"capability-missing\",\n  /** `SecurityError` / `NotAllowedError` — 権限拒否・feature-policy ブロック。 */\n  NotAllowed: \"not-allowed\",\n  /** `NotReadableError` — センサーハードウェアを読めない。 */\n  NotReadable: \"not-readable\",\n  /** その他の SensorErrorEvent / 想定外の失敗。 */\n  SensorError: \"sensor-error\",\n} as const;\n\n/**\n * sensor の失敗を serializable な error taxonomy に写す。`name` は error detail の\n * `.error`(`Error.name` / \"unsupported\" / \"error\" fallback)。\n *\n * - \"unsupported\" は開始前の能力欠如 → phase=\"probe\" / capability-missing。\n * - `SecurityError` / `NotAllowedError` は sensor 構築時の権限拒否 → phase=\"start\" /\n *   not-allowed。いずれも retry で回復しない(recoverable=false)。\n * - `NotReadableError` は稼働中のハードウェア読取失敗 → phase=\"execute\" / not-readable。\n * - それ以外(SensorErrorEvent の他 name / \"error\" fallback)は phase=\"execute\" /\n *   sensor-error。\n */\nexport function deriveAmbientLightSensorErrorInfo(name: string, message: string): WcsIoErrorInfo {\n  if (name === \"unsupported\") {\n    return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.CapabilityMissing, phase: \"probe\", recoverable: false, message };\n  }\n  if (name === \"SecurityError\" || name === \"NotAllowedError\") {\n    return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.NotAllowed, phase: \"start\", recoverable: false, message };\n  }\n  if (name === \"NotReadableError\") {\n    return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.NotReadable, phase: \"execute\", recoverable: false, message };\n  }\n  return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.SensorError, phase: \"execute\", recoverable: false, message };\n}\n","import { IWcBindable, WcsAmbientLightSensorReading, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\nimport { WcsIoErrorInfo } from \"./platformCapability.js\";\nimport { deriveAmbientLightSensorErrorInfo } from \"./ambientLightSensorCapabilities.js\";\n\nconst NULL_READING: WcsAmbientLightSensorReading = Object.freeze({ illuminance: null });\n\n/**\n * Headless AmbientLightSensor primitive. A thin, framework-agnostic wrapper around\n * the Generic Sensor API's `AmbientLightSensor` 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 `AmbientLightSensor`\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 * `illuminance` is a single getter derived from the `wcs-ambient-light-sensor:reading`\n * event (unlike Accelerometer/Gyroscope/Magnetometer's x/y/z, this sensor\n * reports one scalar — docs/sensor-tag-design.md §2). `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-ambient-light-sensor: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=\"ambient-light-sensor\">` instead — see\n * docs/sensor-tag-design.md §\"2番目の決定: Permissions APIとの合成\".\n */\nexport class AmbientLightSensorCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"illuminance\", event: \"wcs-ambient-light-sensor:reading\", getter: (e: Event) => (e as CustomEvent).detail.illuminance },\n      { name: \"error\", event: \"wcs-ambient-light-sensor:error\" },\n      // Serializable failure taxonomy (stable code / phase / recoverable), or null.\n      // Additive bindable output derived from `error.error` (the Error.name /\n      // \"unsupported\"); the existing `error` property/event are unchanged. Fires\n      // wcs-ambient-light-sensor:error-info-changed. No lane — the sensor is a monitor.\n      { name: \"errorInfo\", event: \"wcs-ambient-light-sensor:error-info-changed\" },\n    ],\n    commands: [{ name: \"start\" }, { name: \"stop\" }],\n  };\n\n  private _target: EventTarget;\n  private _reading: WcsAmbientLightSensorReading = NULL_READING;\n  private _error: WcsAmbientLightSensorErrorDetail | null = null;\n  private _errorInfo: WcsIoErrorInfo | 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 §3.5\n  // 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 illuminance(): number | null {\n    return this._reading.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | null {\n    return this._error;\n  }\n\n  /**\n   * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /\n   * `recoverable`), or null. Additive wc-bindable property (event\n   * `wcs-ambient-light-sensor:error-info-changed`), derived from `error`; the existing\n   * `error` property/event are unchanged.\n   */\n  get errorInfo(): WcsIoErrorInfo | null {\n    return this._errorInfo;\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: WcsAmbientLightSensorReading): void {\n    this._reading = reading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:reading\", {\n      detail: reading,\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: WcsAmbientLightSensorErrorDetail | 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    // Keep the additive `errorInfo` taxonomy in sync with `error`: derive from the\n    // error name (or null on clear). Fires before the `error` event so an observer\n    // binding both sees the classification first, mirroring the io-node family.\n    this._commitErrorInfo(error === null ? null : deriveAmbientLightSensorErrorInfo(error.error, error.message));\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  // Called only from _setError (which already same-value-guards on the error name\n  // + message), so errorInfo transitions exactly when error does — no separate\n  // guard needed here.\n  private _commitErrorInfo(info: WcsIoErrorInfo | null): void {\n    this._errorInfo = info;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:error-info-changed\", {\n      detail: info,\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 `AmbientLightSensor`, guarding both non-support and a\n   * synchronous constructor exception. Never calls the raw `new AmbientLightSensor(...)`\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 the\n   * global freely and an unsupported environment is always reported correctly.\n   */\n  private _createSensor(frequency?: number): (EventTarget & { start(): void; stop(): void }) | null {\n    const Ctor = (globalThis as any).AmbientLightSensor;\n    if (typeof Ctor !== \"function\") {\n      this._setError({ error: \"unsupported\", message: \"AmbientLightSensor 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 { illuminance: number | null };\n    this._setReading({ illuminance: sensor.illuminance });\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, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\nimport { AmbientLightSensorCore } from \"../core/AmbientLightSensorCore.js\";\nimport { WcsIoErrorInfo } from \"../core/platformCapability.js\";\n\n/**\n * `<wcs-ambient-light-sensor>` — declarative Generic Sensor API (`AmbientLightSensor`)\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 `illuminance`/`error` observable surface (event-token: element →\n * state). The `frequency` attribute is the sole configuration input, forwarded\n * to the platform `AmbientLightSensor` 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=\"ambient-light-sensor\">` instead (see the README's permission\n * example, \"Gate on permission, then start\", and docs/sensor-tag-design.md).\n */\nexport class WcsAmbientLightSensor extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...AmbientLightSensorCore.wcBindable,\n    inputs: [{ name: \"frequency\" }],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: AmbientLightSensorCore.wcBindable.commands,\n  };\n\n  private _core: AmbientLightSensorCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n  private _internals: ElementInternals | null = null;\n\n  constructor() {\n    super();\n    this._core = new AmbientLightSensorCore(this);\n    this._internals = this._initInternals();\n    this._wireStates({\n      \"wcs-ambient-light-sensor:error\": (d) => ({ error: d != null }),\n    });\n  }\n\n  // CSS state reflection (:state()) — debug-only snapshot getter. NOT part of\n  // wc-bindable (not a bind target); see README \"CSS styling with :state()\".\n  // MUST NOT return the live CustomStateSet (that would let callers write\n  // states from outside, defeating the point of :state() being read-only).\n  get debugStates(): string[] {\n    return this._internals ? [...this._internals.states] : [];\n  }\n\n  private _initInternals(): ElementInternals | null {\n    // never-throw (async-io-node-guidelines.md §3.6): attachInternals is absent\n    // in happy-dom / older environments, and pre-125 Chromium rejects\n    // non-dashed state names from states.add() (probed and discarded here).\n    // Either case silently disables reflection — the component still works,\n    // it just doesn't expose :state() selectors.\n    try {\n      if (typeof this.attachInternals !== \"function\") return null;\n      const internals = this.attachInternals();\n      internals.states.add(\"wcs-probe\");\n      internals.states.delete(\"wcs-probe\");\n      return internals;\n    } catch {\n      return null;\n    }\n  }\n\n  private _wireStates(map: Record<string, (detail: any) => Record<string, boolean>>): void {\n    if (this._internals === null) return;\n    const states = this._internals.states;\n    for (const [event, toStates] of Object.entries(map)) {\n      this.addEventListener(event, (e) => {\n        const debug = this.hasAttribute(\"debug-states\");\n        for (const [name, on] of Object.entries(toStates((e as CustomEvent).detail))) {\n          try {\n            if (on) { states.add(name); } else { states.delete(name); }\n          } catch { /* never-throw */ }\n          if (debug) this.toggleAttribute(`data-wcs-state-${name}`, on);\n        }\n      });\n    }\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  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 illuminance(): number | null {\n    return this._core.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | null {\n    return this._core.error;\n  }\n\n  get errorInfo(): WcsIoErrorInfo | null {\n    return this._core.errorInfo;\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), AmbientLightSensor 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=\"ambient-light-sensor\">`: 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 (§3.8); kept for SSR uniformity with\n    // other IO nodes.\n    this._connectedCallbackPromise = this._core.ready;\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { WcsAmbientLightSensor } from \"./components/AmbientLightSensor.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.ambientLightSensor)) {\n    customElements.define(config.tagNames.ambientLightSensor, WcsAmbientLightSensor);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapAmbientLightSensor(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

@@ -1,2 +1,2 @@
-const e={tagNames:{ambientLightSensor:"wcs-ambient-light-sensor"}};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 i(){return s||(s=t(r(e))),s}const o=Object.freeze({illuminance:null});class a extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"illuminance",event:"wcs-ambient-light-sensor:reading",getter:e=>e.detail.illuminance},{name:"error",event:"wcs-ambient-light-sensor:error"}],commands:[{name:"start"},{name:"stop"}]};_target;_reading=o;_error=null;_sensor=null;constructor(e){super(),this._target=e??this}get illuminance(){return this._reading.illuminance}get error(){return this._error}get ready(){return Promise.resolve()}_setReading(e){this._reading=e,this._target.dispatchEvent(new CustomEvent("wcs-ambient-light-sensor: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-ambient-light-sensor: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.AmbientLightSensor;if("function"!=typeof t)return this._setError({error:"unsupported",message:"AmbientLightSensor 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({illuminance:t.illuminance})};_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();_internals=null;constructor(){super(),this._core=new a(this),this._internals=this._initInternals(),this._wireStates({"wcs-ambient-light-sensor:error":e=>({error:null!=e})})}get debugStates(){return this._internals?[...this._internals.states]:[]}_initInternals(){try{if("function"!=typeof this.attachInternals)return null;const e=this.attachInternals();return e.states.add("wcs-probe"),e.states.delete("wcs-probe"),e}catch{return null}}_wireStates(e){if(null===this._internals)return;const t=this._internals.states;for(const[r,s]of Object.entries(e))this.addEventListener(r,e=>{const r=this.hasAttribute("debug-states");for(const[n,i]of Object.entries(s(e.detail))){try{i?t.add(n):t.delete(n)}catch{}r&&this.toggleAttribute(`data-wcs-state-${n}`,i)}})}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 illuminance(){return this._core.illuminance}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 l(t){var r;t&&((r=t).tagNames&&Object.assign(e.tagNames,r.tagNames),s=null),customElements.get(n.tagNames.ambientLightSensor)||customElements.define(n.tagNames.ambientLightSensor,c)}export{a as AmbientLightSensorCore,c as WcsAmbientLightSensor,l as bootstrapAmbientLightSensor,i as getConfig};
+const e={tagNames:{ambientLightSensor:"wcs-ambient-light-sensor"}};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={CapabilityMissing:"capability-missing",NotAllowed:"not-allowed",NotReadable:"not-readable",SensorError:"sensor-error"};const a=Object.freeze({illuminance:null});class c extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"illuminance",event:"wcs-ambient-light-sensor:reading",getter:e=>e.detail.illuminance},{name:"error",event:"wcs-ambient-light-sensor:error"},{name:"errorInfo",event:"wcs-ambient-light-sensor:error-info-changed"}],commands:[{name:"start"},{name:"stop"}]};_target;_reading=a;_error=null;_errorInfo=null;_sensor=null;constructor(e){super(),this._target=e??this}get illuminance(){return this._reading.illuminance}get error(){return this._error}get errorInfo(){return this._errorInfo}get ready(){return Promise.resolve()}_setReading(e){this._reading=e,this._target.dispatchEvent(new CustomEvent("wcs-ambient-light-sensor:reading",{detail:e,bubbles:!0}))}_setError(e){var t,r;this._error?.error===e?.error&&this._error?.message===e?.message||(this._error=e,this._commitErrorInfo(null===e?null:(t=e.error,r=e.message,"unsupported"===t?{code:i.CapabilityMissing,phase:"probe",recoverable:!1,message:r}:"SecurityError"===t||"NotAllowedError"===t?{code:i.NotAllowed,phase:"start",recoverable:!1,message:r}:"NotReadableError"===t?{code:i.NotReadable,phase:"execute",recoverable:!1,message:r}:{code:i.SensorError,phase:"execute",recoverable:!1,message:r})),this._target.dispatchEvent(new CustomEvent("wcs-ambient-light-sensor:error",{detail:e,bubbles:!0})))}_commitErrorInfo(e){this._errorInfo=e,this._target.dispatchEvent(new CustomEvent("wcs-ambient-light-sensor:error-info-changed",{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.AmbientLightSensor;if("function"!=typeof t)return this._setError({error:"unsupported",message:"AmbientLightSensor 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({illuminance:t.illuminance})};_onError=e=>{const t=e.error;this._setError({error:t?.name??"error",message:t?.message??"Sensor error"})}}class l extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...c.wcBindable,inputs:[{name:"frequency"}],commands:c.wcBindable.commands};_core;_connectedCallbackPromise=Promise.resolve();_internals=null;constructor(){super(),this._core=new c(this),this._internals=this._initInternals(),this._wireStates({"wcs-ambient-light-sensor:error":e=>({error:null!=e})})}get debugStates(){return this._internals?[...this._internals.states]:[]}_initInternals(){try{if("function"!=typeof this.attachInternals)return null;const e=this.attachInternals();return e.states.add("wcs-probe"),e.states.delete("wcs-probe"),e}catch{return null}}_wireStates(e){if(null===this._internals)return;const t=this._internals.states;for(const[r,s]of Object.entries(e))this.addEventListener(r,e=>{const r=this.hasAttribute("debug-states");for(const[n,o]of Object.entries(s(e.detail))){try{o?t.add(n):t.delete(n)}catch{}r&&this.toggleAttribute(`data-wcs-state-${n}`,o)}})}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 illuminance(){return this._core.illuminance}get error(){return this._core.error}get errorInfo(){return this._core.errorInfo}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 u(t){var r;t&&((r=t).tagNames&&Object.assign(e.tagNames,r.tagNames),s=null),customElements.get(n.tagNames.ambientLightSensor)||customElements.define(n.tagNames.ambientLightSensor,l)}export{c as AmbientLightSensorCore,i as WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE,l as WcsAmbientLightSensor,u as bootstrapAmbientLightSensor,o as getConfig};
 //# sourceMappingURL=index.esm.min.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.esm.min.js","sources":["../src/config.ts","../src/core/AmbientLightSensorCore.ts","../src/components/AmbientLightSensor.ts","../src/bootstrapAmbientLightSensor.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    ambientLightSensor: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    ambientLightSensor: \"wcs-ambient-light-sensor\",\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, WcsAmbientLightSensorReading, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\n\nconst NULL_READING: WcsAmbientLightSensorReading = Object.freeze({ illuminance: null });\n\n/**\n * Headless AmbientLightSensor primitive. A thin, framework-agnostic wrapper around\n * the Generic Sensor API's `AmbientLightSensor` 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 `AmbientLightSensor`\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 * `illuminance` is a single getter derived from the `wcs-ambient-light-sensor:reading`\n * event (unlike Accelerometer/Gyroscope/Magnetometer's x/y/z, this sensor\n * reports one scalar — docs/sensor-tag-design.md §2). `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-ambient-light-sensor: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=\"ambient-light-sensor\">` instead — see\n * docs/sensor-tag-design.md §\"2番目の決定: Permissions APIとの合成\".\n */\nexport class AmbientLightSensorCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"illuminance\", event: \"wcs-ambient-light-sensor:reading\", getter: (e: Event) => (e as CustomEvent).detail.illuminance },\n      { name: \"error\", event: \"wcs-ambient-light-sensor:error\" },\n    ],\n    commands: [{ name: \"start\" }, { name: \"stop\" }],\n  };\n\n  private _target: EventTarget;\n  private _reading: WcsAmbientLightSensorReading = NULL_READING;\n  private _error: WcsAmbientLightSensorErrorDetail | 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 §3.5\n  // 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 illuminance(): number | null {\n    return this._reading.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | 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: WcsAmbientLightSensorReading): void {\n    this._reading = reading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:reading\", {\n      detail: reading,\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: WcsAmbientLightSensorErrorDetail | 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-ambient-light-sensor: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 `AmbientLightSensor`, guarding both non-support and a\n   * synchronous constructor exception. Never calls the raw `new AmbientLightSensor(...)`\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 the\n   * global freely and an unsupported environment is always reported correctly.\n   */\n  private _createSensor(frequency?: number): (EventTarget & { start(): void; stop(): void }) | null {\n    const Ctor = (globalThis as any).AmbientLightSensor;\n    if (typeof Ctor !== \"function\") {\n      this._setError({ error: \"unsupported\", message: \"AmbientLightSensor 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 { illuminance: number | null };\n    this._setReading({ illuminance: sensor.illuminance });\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, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\nimport { AmbientLightSensorCore } from \"../core/AmbientLightSensorCore.js\";\n\n/**\n * `<wcs-ambient-light-sensor>` — declarative Generic Sensor API (`AmbientLightSensor`)\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 `illuminance`/`error` observable surface (event-token: element →\n * state). The `frequency` attribute is the sole configuration input, forwarded\n * to the platform `AmbientLightSensor` 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=\"ambient-light-sensor\">` instead (see the README's permission\n * example, \"Gate on permission, then start\", and docs/sensor-tag-design.md).\n */\nexport class WcsAmbientLightSensor extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...AmbientLightSensorCore.wcBindable,\n    inputs: [{ name: \"frequency\" }],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: AmbientLightSensorCore.wcBindable.commands,\n  };\n\n  private _core: AmbientLightSensorCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n  private _internals: ElementInternals | null = null;\n\n  constructor() {\n    super();\n    this._core = new AmbientLightSensorCore(this);\n    this._internals = this._initInternals();\n    this._wireStates({\n      \"wcs-ambient-light-sensor:error\": (d) => ({ error: d != null }),\n    });\n  }\n\n  // CSS state reflection (:state()) — debug-only snapshot getter. NOT part of\n  // wc-bindable (not a bind target); see README \"CSS styling with :state()\".\n  // MUST NOT return the live CustomStateSet (that would let callers write\n  // states from outside, defeating the point of :state() being read-only).\n  get debugStates(): string[] {\n    return this._internals ? [...this._internals.states] : [];\n  }\n\n  private _initInternals(): ElementInternals | null {\n    // never-throw (async-io-node-guidelines.md §3.6): attachInternals is absent\n    // in happy-dom / older environments, and pre-125 Chromium rejects\n    // non-dashed state names from states.add() (probed and discarded here).\n    // Either case silently disables reflection — the component still works,\n    // it just doesn't expose :state() selectors.\n    try {\n      if (typeof this.attachInternals !== \"function\") return null;\n      const internals = this.attachInternals();\n      internals.states.add(\"wcs-probe\");\n      internals.states.delete(\"wcs-probe\");\n      return internals;\n    } catch {\n      return null;\n    }\n  }\n\n  private _wireStates(map: Record<string, (detail: any) => Record<string, boolean>>): void {\n    if (this._internals === null) return;\n    const states = this._internals.states;\n    for (const [event, toStates] of Object.entries(map)) {\n      this.addEventListener(event, (e) => {\n        const debug = this.hasAttribute(\"debug-states\");\n        for (const [name, on] of Object.entries(toStates((e as CustomEvent).detail))) {\n          try {\n            if (on) { states.add(name); } else { states.delete(name); }\n          } catch { /* never-throw */ }\n          if (debug) this.toggleAttribute(`data-wcs-state-${name}`, on);\n        }\n      });\n    }\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  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 illuminance(): number | null {\n    return this._core.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | 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), AmbientLightSensor 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=\"ambient-light-sensor\">`: 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 (§3.8); kept for SSR uniformity with\n    // 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 bootstrapAmbientLightSensor(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { WcsAmbientLightSensor } from \"./components/AmbientLightSensor.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.ambientLightSensor)) {\n    customElements.define(config.tagNames.ambientLightSensor, WcsAmbientLightSensor);\n  }\n}\n"],"names":["_config","tagNames","ambientLightSensor","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","NULL_READING","illuminance","AmbientLightSensorCore","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","AmbientLightSensor","undefined","err","WcsAmbientLightSensor","HTMLElement","wcBindable","inputs","_core","_connectedCallbackPromise","_internals","_initInternals","_wireStates","d","debugStates","states","attachInternals","internals","add","delete","map","toStates","entries","debug","hasAttribute","on","toggleAttribute","attr","getAttribute","trim","parsed","Number","isFinite","value","removeAttribute","setAttribute","connectedCallbackPromise","connectedCallback","style","display","disconnectedCallback","bootstrapAmbientLightSensor","userConfig","partialConfig","assign","customElements","get","define"],"mappings":"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"}
+{"version":3,"file":"index.esm.min.js","sources":["../src/config.ts","../src/core/ambientLightSensorCapabilities.ts","../src/core/AmbientLightSensorCore.ts","../src/components/AmbientLightSensor.ts","../src/bootstrapAmbientLightSensor.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    ambientLightSensor: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    ambientLightSensor: \"wcs-ambient-light-sensor\",\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","/**\n * ambientLightSensorCapabilities.ts\n *\n * AmbientLightSensor node 固有の error code(taxonomy)と derivation。汎用の error info\n * 型は `./platformCapability.js`(/io-core/ から copy-distribution される生成ファイル)から\n * import する。sensor は監視系(継続 subscribe/unsubscribe)で競合する operation を持た\n * ないため lane は持たず、error taxonomy(errorInfo)のみを採用する。\n *\n * sensor family(accelerometer / gyroscope / magnetometer / ambient-light-sensor)は\n * error 面が構造同一(`{ error: <name>, message }`、`.error` が Error.name / \"unsupported\"\n * / \"error\" fallback)なので、taxonomy も 4 兄弟で一致させる。\n */\n\nimport type { WcsIoErrorInfo } from \"./platformCapability.js\";\n\n/** 安定した ambient-light-sensor error code(taxonomy)。値は公開キーとして固定。 */\nexport const WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE = {\n  /** Sensor API 非対応(`globalThis.AmbientLightSensor` 不在)。 */\n  CapabilityMissing: \"capability-missing\",\n  /** `SecurityError` / `NotAllowedError` — 権限拒否・feature-policy ブロック。 */\n  NotAllowed: \"not-allowed\",\n  /** `NotReadableError` — センサーハードウェアを読めない。 */\n  NotReadable: \"not-readable\",\n  /** その他の SensorErrorEvent / 想定外の失敗。 */\n  SensorError: \"sensor-error\",\n} as const;\n\n/**\n * sensor の失敗を serializable な error taxonomy に写す。`name` は error detail の\n * `.error`(`Error.name` / \"unsupported\" / \"error\" fallback)。\n *\n * - \"unsupported\" は開始前の能力欠如 → phase=\"probe\" / capability-missing。\n * - `SecurityError` / `NotAllowedError` は sensor 構築時の権限拒否 → phase=\"start\" /\n *   not-allowed。いずれも retry で回復しない(recoverable=false)。\n * - `NotReadableError` は稼働中のハードウェア読取失敗 → phase=\"execute\" / not-readable。\n * - それ以外(SensorErrorEvent の他 name / \"error\" fallback)は phase=\"execute\" /\n *   sensor-error。\n */\nexport function deriveAmbientLightSensorErrorInfo(name: string, message: string): WcsIoErrorInfo {\n  if (name === \"unsupported\") {\n    return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.CapabilityMissing, phase: \"probe\", recoverable: false, message };\n  }\n  if (name === \"SecurityError\" || name === \"NotAllowedError\") {\n    return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.NotAllowed, phase: \"start\", recoverable: false, message };\n  }\n  if (name === \"NotReadableError\") {\n    return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.NotReadable, phase: \"execute\", recoverable: false, message };\n  }\n  return { code: WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE.SensorError, phase: \"execute\", recoverable: false, message };\n}\n","import { IWcBindable, WcsAmbientLightSensorReading, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\nimport { WcsIoErrorInfo } from \"./platformCapability.js\";\nimport { deriveAmbientLightSensorErrorInfo } from \"./ambientLightSensorCapabilities.js\";\n\nconst NULL_READING: WcsAmbientLightSensorReading = Object.freeze({ illuminance: null });\n\n/**\n * Headless AmbientLightSensor primitive. A thin, framework-agnostic wrapper around\n * the Generic Sensor API's `AmbientLightSensor` 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 `AmbientLightSensor`\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 * `illuminance` is a single getter derived from the `wcs-ambient-light-sensor:reading`\n * event (unlike Accelerometer/Gyroscope/Magnetometer's x/y/z, this sensor\n * reports one scalar — docs/sensor-tag-design.md §2). `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-ambient-light-sensor: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=\"ambient-light-sensor\">` instead — see\n * docs/sensor-tag-design.md §\"2番目の決定: Permissions APIとの合成\".\n */\nexport class AmbientLightSensorCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"illuminance\", event: \"wcs-ambient-light-sensor:reading\", getter: (e: Event) => (e as CustomEvent).detail.illuminance },\n      { name: \"error\", event: \"wcs-ambient-light-sensor:error\" },\n      // Serializable failure taxonomy (stable code / phase / recoverable), or null.\n      // Additive bindable output derived from `error.error` (the Error.name /\n      // \"unsupported\"); the existing `error` property/event are unchanged. Fires\n      // wcs-ambient-light-sensor:error-info-changed. No lane — the sensor is a monitor.\n      { name: \"errorInfo\", event: \"wcs-ambient-light-sensor:error-info-changed\" },\n    ],\n    commands: [{ name: \"start\" }, { name: \"stop\" }],\n  };\n\n  private _target: EventTarget;\n  private _reading: WcsAmbientLightSensorReading = NULL_READING;\n  private _error: WcsAmbientLightSensorErrorDetail | null = null;\n  private _errorInfo: WcsIoErrorInfo | 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 §3.5\n  // 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 illuminance(): number | null {\n    return this._reading.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | null {\n    return this._error;\n  }\n\n  /**\n   * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /\n   * `recoverable`), or null. Additive wc-bindable property (event\n   * `wcs-ambient-light-sensor:error-info-changed`), derived from `error`; the existing\n   * `error` property/event are unchanged.\n   */\n  get errorInfo(): WcsIoErrorInfo | null {\n    return this._errorInfo;\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: WcsAmbientLightSensorReading): void {\n    this._reading = reading;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:reading\", {\n      detail: reading,\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: WcsAmbientLightSensorErrorDetail | 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    // Keep the additive `errorInfo` taxonomy in sync with `error`: derive from the\n    // error name (or null on clear). Fires before the `error` event so an observer\n    // binding both sees the classification first, mirroring the io-node family.\n    this._commitErrorInfo(error === null ? null : deriveAmbientLightSensorErrorInfo(error.error, error.message));\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  // Called only from _setError (which already same-value-guards on the error name\n  // + message), so errorInfo transitions exactly when error does — no separate\n  // guard needed here.\n  private _commitErrorInfo(info: WcsIoErrorInfo | null): void {\n    this._errorInfo = info;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-ambient-light-sensor:error-info-changed\", {\n      detail: info,\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 `AmbientLightSensor`, guarding both non-support and a\n   * synchronous constructor exception. Never calls the raw `new AmbientLightSensor(...)`\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 the\n   * global freely and an unsupported environment is always reported correctly.\n   */\n  private _createSensor(frequency?: number): (EventTarget & { start(): void; stop(): void }) | null {\n    const Ctor = (globalThis as any).AmbientLightSensor;\n    if (typeof Ctor !== \"function\") {\n      this._setError({ error: \"unsupported\", message: \"AmbientLightSensor 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 { illuminance: number | null };\n    this._setReading({ illuminance: sensor.illuminance });\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, WcsAmbientLightSensorErrorDetail } from \"../types.js\";\nimport { AmbientLightSensorCore } from \"../core/AmbientLightSensorCore.js\";\nimport { WcsIoErrorInfo } from \"../core/platformCapability.js\";\n\n/**\n * `<wcs-ambient-light-sensor>` — declarative Generic Sensor API (`AmbientLightSensor`)\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 `illuminance`/`error` observable surface (event-token: element →\n * state). The `frequency` attribute is the sole configuration input, forwarded\n * to the platform `AmbientLightSensor` 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=\"ambient-light-sensor\">` instead (see the README's permission\n * example, \"Gate on permission, then start\", and docs/sensor-tag-design.md).\n */\nexport class WcsAmbientLightSensor extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...AmbientLightSensorCore.wcBindable,\n    inputs: [{ name: \"frequency\" }],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: AmbientLightSensorCore.wcBindable.commands,\n  };\n\n  private _core: AmbientLightSensorCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n  private _internals: ElementInternals | null = null;\n\n  constructor() {\n    super();\n    this._core = new AmbientLightSensorCore(this);\n    this._internals = this._initInternals();\n    this._wireStates({\n      \"wcs-ambient-light-sensor:error\": (d) => ({ error: d != null }),\n    });\n  }\n\n  // CSS state reflection (:state()) — debug-only snapshot getter. NOT part of\n  // wc-bindable (not a bind target); see README \"CSS styling with :state()\".\n  // MUST NOT return the live CustomStateSet (that would let callers write\n  // states from outside, defeating the point of :state() being read-only).\n  get debugStates(): string[] {\n    return this._internals ? [...this._internals.states] : [];\n  }\n\n  private _initInternals(): ElementInternals | null {\n    // never-throw (async-io-node-guidelines.md §3.6): attachInternals is absent\n    // in happy-dom / older environments, and pre-125 Chromium rejects\n    // non-dashed state names from states.add() (probed and discarded here).\n    // Either case silently disables reflection — the component still works,\n    // it just doesn't expose :state() selectors.\n    try {\n      if (typeof this.attachInternals !== \"function\") return null;\n      const internals = this.attachInternals();\n      internals.states.add(\"wcs-probe\");\n      internals.states.delete(\"wcs-probe\");\n      return internals;\n    } catch {\n      return null;\n    }\n  }\n\n  private _wireStates(map: Record<string, (detail: any) => Record<string, boolean>>): void {\n    if (this._internals === null) return;\n    const states = this._internals.states;\n    for (const [event, toStates] of Object.entries(map)) {\n      this.addEventListener(event, (e) => {\n        const debug = this.hasAttribute(\"debug-states\");\n        for (const [name, on] of Object.entries(toStates((e as CustomEvent).detail))) {\n          try {\n            if (on) { states.add(name); } else { states.delete(name); }\n          } catch { /* never-throw */ }\n          if (debug) this.toggleAttribute(`data-wcs-state-${name}`, on);\n        }\n      });\n    }\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  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 illuminance(): number | null {\n    return this._core.illuminance;\n  }\n\n  get error(): WcsAmbientLightSensorErrorDetail | null {\n    return this._core.error;\n  }\n\n  get errorInfo(): WcsIoErrorInfo | null {\n    return this._core.errorInfo;\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), AmbientLightSensor 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=\"ambient-light-sensor\">`: 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 (§3.8); kept for SSR uniformity with\n    // 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 bootstrapAmbientLightSensor(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { WcsAmbientLightSensor } from \"./components/AmbientLightSensor.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.ambientLightSensor)) {\n    customElements.define(config.tagNames.ambientLightSensor, WcsAmbientLightSensor);\n  }\n}\n"],"names":["_config","tagNames","ambientLightSensor","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","WCS_AMBIENT_LIGHT_SENSOR_ERROR_CODE","CapabilityMissing","NotAllowed","NotReadable","SensorError","NULL_READING","illuminance","AmbientLightSensorCore","EventTarget","static","protocol","version","properties","name","event","getter","e","detail","commands","_target","_reading","_error","_errorInfo","_sensor","constructor","target","super","this","error","errorInfo","ready","Promise","resolve","_setReading","reading","dispatchEvent","CustomEvent","bubbles","_setError","message","_commitErrorInfo","code","phase","recoverable","info","start","frequency","sensor","_createSensor","addEventListener","_onReading","_onError","_teardownSensor","String","stop","observe","dispose","removeEventListener","Ctor","globalThis","AmbientLightSensor","undefined","err","WcsAmbientLightSensor","HTMLElement","wcBindable","inputs","_core","_connectedCallbackPromise","_internals","_initInternals","_wireStates","d","debugStates","states","attachInternals","internals","add","delete","map","toStates","entries","debug","hasAttribute","on","toggleAttribute","attr","getAttribute","trim","parsed","Number","isFinite","value","removeAttribute","setAttribute","connectedCallbackPromise","connectedCallback","style","display","disconnectedCallback","bootstrapAmbientLightSensor","userConfig","partialConfig","assign","customElements","get","define"],"mappings":"AAQA,MAAMA,EAA2B,CAC/BC,SAAU,CACRC,mBAAoB,6BAIxB,SAASC,EAAcC,GACrB,GAAY,OAARA,GAA+B,iBAARA,EAAkB,OAAOA,EACpDC,OAAOC,OAAOF,GACd,IAAK,MAAMG,KAAOF,OAAOG,KAAKJ,GAC5BD,EAAYC,EAAgCG,IAE9C,OAAOH,CACT,CAEA,SAASK,EAAaL,GACpB,GAAY,OAARA,GAA+B,iBAARA,EAAkB,OAAOA,EACpD,MAAMM,EAAiC,CAAA,EACvC,IAAK,MAAMH,KAAOF,OAAOG,KAAKJ,GAC5BM,EAAMH,GAAOE,EAAWL,EAAgCG,IAE1D,OAAOG,CACT,CAEA,IAAIC,EAA+B,KAE5B,MAAMC,EAAkBZ,WAEfa,IAId,OAHKF,IACHA,EAAeR,EAAWM,EAAUT,KAE/BW,CACT,CCzBO,MAAMG,EAAsC,CAEjDC,kBAAmB,qBAEnBC,WAAY,cAEZC,YAAa,eAEbC,YAAa,gBCpBf,MAAMC,EAA6Cd,OAAOC,OAAO,CAAEc,YAAa,OAoC1E,MAAOC,UAA+BC,YAC1CC,kBAAiC,CAC/BC,SAAU,cACVC,QAAS,EACTC,WAAY,CACV,CAAEC,KAAM,cAAeC,MAAO,mCAAoCC,OAASC,GAAcA,EAAkBC,OAAOX,aAClH,CAAEO,KAAM,QAASC,MAAO,kCAKxB,CAAED,KAAM,YAAaC,MAAO,gDAE9BI,SAAU,CAAC,CAAEL,KAAM,SAAW,CAAEA,KAAM,UAGhCM,QACAC,SAAyCf,EACzCgB,OAAkD,KAClDC,WAAoC,KAMpCC,QAAkE,KAE1E,WAAAC,CAAYC,GACVC,QACAC,KAAKR,QAAUM,GAAUE,IAC3B,CAEA,eAAIrB,GACF,OAAOqB,KAAKP,SAASd,WACvB,CAEA,SAAIsB,GACF,OAAOD,KAAKN,MACd,CAQA,aAAIQ,GACF,OAAOF,KAAKL,UACd,CAKA,SAAIQ,GACF,OAAOC,QAAQC,SACjB,CAOQ,WAAAC,CAAYC,GAClBP,KAAKP,SAAWc,EAChBP,KAAKR,QAAQgB,cAAc,IAAIC,YAAY,mCAAoC,CAC7EnB,OAAQiB,EACRG,SAAS,IAEb,CAEQ,SAAAC,CAAUV,GDxEd,IAA4Cf,EAAc0B,EC8ExDZ,KAAKN,QAAQO,QAAUA,GAAOA,OAASD,KAAKN,QAAQkB,UAAYX,GAAOW,UAC3EZ,KAAKN,OAASO,EAIdD,KAAKa,iBAA2B,OAAVZ,EAAiB,MDnFOf,ECmFkCe,EAAMA,MDnF1BW,ECmFiCX,EAAMW,QDlFxF,gBAAT1B,EACK,CAAE4B,KAAMzC,EAAoCC,kBAAmByC,MAAO,QAASC,aAAa,EAAOJ,WAE/F,kBAAT1B,GAAqC,oBAATA,EACvB,CAAE4B,KAAMzC,EAAoCE,WAAYwC,MAAO,QAASC,aAAa,EAAOJ,WAExF,qBAAT1B,EACK,CAAE4B,KAAMzC,EAAoCG,YAAauC,MAAO,UAAWC,aAAa,EAAOJ,WAEjG,CAAEE,KAAMzC,EAAoCI,YAAasC,MAAO,UAAWC,aAAa,EAAOJ,aC0EpGZ,KAAKR,QAAQgB,cAAc,IAAIC,YAAY,iCAAkC,CAC3EnB,OAAQW,EACRS,SAAS,KAEb,CAKQ,gBAAAG,CAAiBI,GACvBjB,KAAKL,WAAasB,EAClBjB,KAAKR,QAAQgB,cAAc,IAAIC,YAAY,8CAA+C,CACxFnB,OAAQ2B,EACRP,SAAS,IAEb,CAeA,KAAAQ,CAAMC,GACJ,GAAInB,KAAKJ,QAAS,OAClB,MAAMwB,EAASpB,KAAKqB,cAAcF,GAClC,GAAKC,EAAL,CACAA,EAAOE,iBAAiB,UAAWtB,KAAKuB,YACxCH,EAAOE,iBAAiB,QAAStB,KAAKwB,UACtCxB,KAAKJ,QAAUwB,EACf,IACEA,EAAOF,OACT,CAAE,MAAO7B,GAKPW,KAAKyB,kBACLzB,KAAKW,UAAU,CAAEV,MAAOZ,GAAGH,MAAQ,QAAS0B,QAASvB,GAAGuB,SAAWc,OAAOrC,IAC5E,CAba,CAcf,CAGA,IAAAsC,GACE,GAAK3B,KAAKJ,QAAV,CACA,IACEI,KAAKJ,QAAQ+B,MACf,CAAE,MAGF,CACA3B,KAAKyB,iBAPc,CAQrB,CAKA,OAAAG,CAAQT,GAEN,OADAnB,KAAKkB,MAAMC,GACJnB,KAAKG,KACd,CAGA,OAAA0B,GACE7B,KAAK2B,MACP,CAOQ,eAAAF,GACNzB,KAAKJ,QAASkC,oBAAoB,UAAW9B,KAAKuB,YAClDvB,KAAKJ,QAASkC,oBAAoB,QAAS9B,KAAKwB,UAChDxB,KAAKJ,QAAU,IACjB,CAWQ,aAAAyB,CAAcF,GACpB,MAAMY,EAAQC,WAAmBC,mBACjC,GAAoB,mBAATF,EAET,OADA/B,KAAKW,UAAU,CAAEV,MAAO,cAAeW,QAAS,wCACzC,KAET,IACE,OAAO,IAAImB,OAAmBG,IAAdf,EAA0B,CAAEA,kBAAce,EAC5D,CAAE,MAAO7C,GAMP,OADAW,KAAKW,UAAU,CAAEV,MAAOZ,GAAGH,MAAQ,QAAS0B,QAASvB,GAAGuB,SAAWc,OAAOrC,KACnE,IACT,CACF,CAEQkC,WAAcpC,IACpB,MAAMiC,EAASjC,EAAMW,OACrBE,KAAKM,YAAY,CAAE3B,YAAayC,EAAOzC,eAGjC6C,SAAYrC,IAClB,MAAMgD,EAAOhD,EAAcc,MAI3BD,KAAKW,UAAU,CAAEV,MAAOkC,GAAKjD,MAAQ,QAAS0B,QAASuB,GAAKvB,SAAW,kBC5NrE,MAAOwB,UAA8BC,YACzCvD,oCAAqC,EAErCA,kBAAiC,IAC5BF,EAAuB0D,WAC1BC,OAAQ,CAAC,CAAErD,KAAM,cAEjBK,SAAUX,EAAuB0D,WAAW/C,UAGtCiD,MACAC,0BAA2CrC,QAAQC,UACnDqC,WAAsC,KAE9C,WAAA7C,GACEE,QACAC,KAAKwC,MAAQ,IAAI5D,EAAuBoB,MACxCA,KAAK0C,WAAa1C,KAAK2C,iBACvB3C,KAAK4C,YAAY,CACf,iCAAmCC,IAAC,CAAQ5C,MAAY,MAAL4C,KAEvD,CAMA,eAAIC,GACF,OAAO9C,KAAK0C,WAAa,IAAI1C,KAAK0C,WAAWK,QAAU,EACzD,CAEQ,cAAAJ,GAMN,IACE,GAAoC,mBAAzB3C,KAAKgD,gBAAgC,OAAO,KACvD,MAAMC,EAAYjD,KAAKgD,kBAGvB,OAFAC,EAAUF,OAAOG,IAAI,aACrBD,EAAUF,OAAOI,OAAO,aACjBF,CACT,CAAE,MACA,OAAO,IACT,CACF,CAEQ,WAAAL,CAAYQ,GAClB,GAAwB,OAApBpD,KAAK0C,WAAqB,OAC9B,MAAMK,EAAS/C,KAAK0C,WAAWK,OAC/B,IAAK,MAAO5D,EAAOkE,KAAazF,OAAO0F,QAAQF,GAC7CpD,KAAKsB,iBAAiBnC,EAAQE,IAC5B,MAAMkE,EAAQvD,KAAKwD,aAAa,gBAChC,IAAK,MAAOtE,EAAMuE,KAAO7F,OAAO0F,QAAQD,EAAUhE,EAAkBC,SAAU,CAC5E,IACMmE,EAAMV,EAAOG,IAAIhE,GAAgB6D,EAAOI,OAAOjE,EACrD,CAAE,MAA0B,CACxBqE,GAAOvD,KAAK0D,gBAAgB,kBAAkBxE,IAAQuE,EAC5D,GAGN,CAgBA,aAAItC,GACF,MAAMwC,EAAO3D,KAAK4D,aAAa,aAC/B,GAAa,OAATD,GAAiC,KAAhBA,EAAKE,OAAe,OAAO,KAChD,MAAMC,EAASC,OAAOJ,GACtB,OAAOI,OAAOC,SAASF,IAAWA,EAAS,EAAIA,EAAS,IAC1D,CAEA,aAAI3C,CAAU8C,GACRA,QACFjE,KAAKkE,gBAAgB,aAErBlE,KAAKmE,aAAa,YAAazC,OAAOuC,GAE1C,CAIA,eAAItF,GACF,OAAOqB,KAAKwC,MAAM7D,WACpB,CAEA,SAAIsB,GACF,OAAOD,KAAKwC,MAAMvC,KACpB,CAEA,aAAIC,GACF,OAAOF,KAAKwC,MAAMtC,SACpB,CAEA,4BAAIkE,GACF,OAAOpE,KAAKyC,yBACd,CAIA,KAAAvB,GACElB,KAAKwC,MAAMtB,MAAMlB,KAAKmB,gBAAae,EACrC,CAEA,IAAAP,GACE3B,KAAKwC,MAAMb,MACb,CAaA,iBAAA0C,GACErE,KAAKsE,MAAMC,QAAU,OAGrBvE,KAAKyC,0BAA4BzC,KAAKwC,MAAMrC,KAC9C,CAEA,oBAAAqE,GACExE,KAAKwC,MAAMX,SACb,ECjKI,SAAU4C,EAA4BC,GJuCtC,IAAoBC,EItCpBD,KJsCoBC,EIrCZD,GJsCMlH,UAChBI,OAAOgH,OAAOrH,EAAQC,SAAUmH,EAAcnH,UAEhDU,EAAe,MK3CV2G,eAAeC,IAAI3G,EAAOX,SAASC,qBACtCoH,eAAeE,OAAO5G,EAAOX,SAASC,mBAAoB2E,EDI9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/ambient-light-sensor",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Declarative AmbientLightSensor component for Web Components. Framework-agnostic Generic Sensor API (AmbientLightSensor) monitor via wc-bindable-protocol.",
   "type": "module",
   "main": "./dist/index.esm.js",