@wcstack/camera 1.20.0 → 1.21.1

package/README.ja.md

@@ -46,7 +46,7 @@ $on: {
 
 **コマンド:** `start()`・`stop()`・`switchCamera()`（前後カメラ切替）。
 
-**バインド可能な値:** `active`（ストリーム生存）・`permission` / `audioPermission`（`prompt`/`granted`/`denied`/`unsupported`）・`deviceId`・`devices`・`error`。
+**バインド可能な値:** `active`（ストリーム生存）・`permission` / `audioPermission`（`prompt`/`granted`/`denied`/`unsupported`）・`deviceId`・`devices`・`error`・`errorInfo`（`WcsIoErrorInfo | null`——`error` から派生するシリアライズ可能な失敗分類。`wcs-camera:error-info-changed` で publish。下記「注意・落とし穴」参照）。
 
 **イベント（event-token）:** `streamReady`（`wcs-camera:stream-ready`、detail = 生 `MediaStream`）・`error`・`ended`（OS によるトラック剥奪）。`streamReady` の「プロパティ」は event-token 配線用で、値としてバインドしないでください。
 
@@ -65,7 +65,7 @@ $on: {
 
 **コマンド:** `attachStream(stream)`・`start()`・`stop()`・`pause()`・`resume()`。
 
-**バインド可能な値:** `recording`・`paused`・`duration`（ms・下記注記参照）・`mimeType`（**解決後**の録画タイプ。要求した `mime-type` 属性と異なる、または未指定時にブラウザが補完した値）・`blob`・`objectURL`・`error`。
+**バインド可能な値:** `recording`・`paused`・`duration`（ms・下記注記参照）・`mimeType`（**解決後**の録画タイプ。要求した `mime-type` 属性と異なる、または未指定時にブラウザが補完した値）・`blob`・`objectURL`・`error`・`errorInfo`（`WcsIoErrorInfo | null`——`error` から派生するシリアライズ可能な失敗分類。`wcs-recorder:error-info-changed` で publish。下記「注意・落とし穴」参照）。
 
 **イベント（event-token）:** `recorded`（`wcs-recorder:recorded`、detail = `{ blob, objectURL, mimeType, duration }`）・`dataavailable`（`timeslice` モードのみ）・`error`。
 
@@ -147,6 +147,17 @@ wcs-recorder:state(paused) ~ .rec-dot      { animation: none; opacity: .4; }
 - **カメラインジケータ＝リーク検出器。** 終了後も点灯したままなら、トラックが停止されていません。
 - **ユーザージェスチャ。** 一部ブラウザは `getUserMedia` をユーザー操作起点で要求します。タイマーから撃つと無言で失敗することがあります（`error` に出ます・throw しません）。
 - **エラーは分類され throw されません:** `NotAllowedError`（拒否）・`NotFoundError`（デバイス無し）・`NotReadableError`（他アプリ使用中）・`OverconstrainedError`。
+- **`errorInfo`——付加的な失敗分類。** `error` と並んで、`<wcs-camera>` / `<wcs-recorder>` はどちらも付加的なバインド可能出力 `errorInfo`（`WcsIoErrorInfo` = 安定した `code` / `phase` / `recoverable` / `message`）を公開します。同じ失敗から派生し、`wcs-camera:error-info-changed` / `wcs-recorder:error-info-changed` で publish されます。`error` の形状は不変で、`errorInfo` は `error` と完全に同期して遷移します（成功時に `null` へクリア）。両要素は 1 つの code セット（`core/mediaCapabilities.ts` の `WCS_MEDIA_ERROR_CODE`）を共有します:
+  - `capability-missing`（phase `probe`）——`getUserMedia` / `MediaRecorder` 非対応（非セキュアコンテキスト含む）。
+  - `not-allowed`（phase `start`）——`NotAllowedError` / `SecurityError`（権限拒否・feature-policy ブロック）。
+  - `not-found`（phase `start`）——`NotFoundError`（要求した種類のカメラ / マイクが存在しない）。
+  - `not-readable`（phase `start`）——`NotReadableError`（デバイス占有・ハードウェア障害）。
+  - `invalid-argument`（phase `start`）——`OverconstrainedError` / `NotSupportedError`（制約・mimeType が満たせない）。
+  - `invalid-state`（phase `start`）——`NoStreamError`（stream 未 attach で録画開始）。
+  - `aborted`（phase `execute`・`recoverable: true`）——`AbortError`（実行途中の中断、retry で回復しうる）。
+  - `media-error`（phase `execute`）——その他の実行時失敗（例: `RecorderError` / 想定外の `MediaRecorder` エラー）。
+
+  `WcsIoErrorInfo` 型と `WCS_MEDIA_ERROR_CODE` 定数は export されます。
 - **ストリームの所有権はカメラ側。** recorder は借用するだけ。録画中のカメラ切替は非対応（先に録画停止）。
 - **mimeType の対応はブラウザ差**（webm/mp4）。非対応の `mime-type` は無視され既定が使われます。
 

package/README.md

@@ -46,7 +46,7 @@ Acquires a camera stream and renders a preview. Acquisition is **explicit** —
 
 **Commands:** `start()`, `stop()`, `switchCamera()` (toggle front/back).
 
-**Bindable values:** `active` (a stream is live), `permission` / `audioPermission` (`prompt`/`granted`/`denied`/`unsupported`), `deviceId`, `devices`, `error`.
+**Bindable values:** `active` (a stream is live), `permission` / `audioPermission` (`prompt`/`granted`/`denied`/`unsupported`), `deviceId`, `devices`, `error`, `errorInfo` (`WcsIoErrorInfo | null` — a serializable failure taxonomy derived from `error`, published via `wcs-camera:error-info-changed`; see [Notes & gotchas](#notes--gotchas) below).
 
 **Events (event-token):** `streamReady` (`wcs-camera:stream-ready`, detail = the live `MediaStream`), `error`, `ended` (a track was revoked by the OS). The `streamReady` "property" exists for event-token wiring only — never bind it as a value.
 
@@ -65,7 +65,7 @@ Records a **borrowed** stream received via `attachStream` (the direct channel fr
 
 **Commands:** `attachStream(stream)`, `start()`, `stop()`, `pause()`, `resume()`.
 
-**Bindable values:** `recording`, `paused`, `duration` (ms — see note below), `mimeType` (the **resolved** recording type, which may differ from the requested `mime-type` attribute or be filled in when none was requested), `blob`, `objectURL`, `error`.
+**Bindable values:** `recording`, `paused`, `duration` (ms — see note below), `mimeType` (the **resolved** recording type, which may differ from the requested `mime-type` attribute or be filled in when none was requested), `blob`, `objectURL`, `error`, `errorInfo` (`WcsIoErrorInfo | null` — a serializable failure taxonomy derived from `error`, published via `wcs-recorder:error-info-changed`; see [Notes & gotchas](#notes--gotchas) below).
 
 **Events (event-token):** `recorded` (`wcs-recorder:recorded`, detail = `{ blob, objectURL, mimeType, duration }`), `dataavailable` (only in `timeslice` mode), `error`.
 
@@ -148,6 +148,17 @@ DevTools open; they are not a supported styling hook.
 - **The camera indicator = a leak detector.** If it stays on after you are done, a track was not stopped.
 - **User gesture.** Some browsers require `getUserMedia` to be triggered by a user action; firing it from a timer may silently fail (surfaced via `error`, never thrown).
 - **Errors are classified, never thrown:** `NotAllowedError` (denied), `NotFoundError` (no device), `NotReadableError` (in use by another app), `OverconstrainedError`.
+- **`errorInfo` — additive failure taxonomy.** Alongside `error`, both `<wcs-camera>` and `<wcs-recorder>` expose an **additive** bindable output `errorInfo` (`WcsIoErrorInfo` = a stable `code` / `phase` / `recoverable` / `message`), derived from the same failure and published via `wcs-camera:error-info-changed` / `wcs-recorder:error-info-changed`. The `error` shape is unchanged; `errorInfo` transitions exactly when `error` does (cleared to `null` on success). Both elements share one code set (`WCS_MEDIA_ERROR_CODE`, defined in `core/mediaCapabilities.ts`):
+  - `capability-missing` (phase `probe`) — `getUserMedia` / `MediaRecorder` unavailable, including non-secure context.
+  - `not-allowed` (phase `start`) — `NotAllowedError` / `SecurityError` (permission denied or feature-policy block).
+  - `not-found` (phase `start`) — `NotFoundError` (no camera / mic of the requested kind).
+  - `not-readable` (phase `start`) — `NotReadableError` (device busy or hardware fault).
+  - `invalid-argument` (phase `start`) — `OverconstrainedError` / `NotSupportedError` (constraints or mimeType unsatisfiable).
+  - `invalid-state` (phase `start`) — `NoStreamError` (recorder started with no stream attached).
+  - `aborted` (phase `execute`, `recoverable: true`) — `AbortError` (interrupted mid-flight, may recover on retry).
+  - `media-error` (phase `execute`) — any other runtime failure (e.g. `RecorderError` / unexpected `MediaRecorder` error).
+
+  The `WcsIoErrorInfo` type and the `WCS_MEDIA_ERROR_CODE` constants are exported.
 - **Stream ownership stays with the camera.** A recorder borrows it; switching cameras while recording is not supported (stop recording first).
 - **mimeType support varies** (webm/mp4). Unsupported `mime-type` values are ignored and the browser default is used.
 

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[];
@@ -89,6 +101,8 @@ interface WcsCameraCoreValues {
     deviceId: string | null;
     devices: MediaDeviceSnapshot[];
     error: WcsMediaErrorDetail | null;
+    /** Serializable Phase 6 failure taxonomy derived from `error`, or null. */
+    errorInfo: WcsIoErrorInfo | null;
 }
 type WcsCameraValues = WcsCameraCoreValues;
 interface WcsCameraInputs {
@@ -153,6 +167,8 @@ interface WcsRecorderCoreValues {
     blob: Blob | null;
     objectURL: string | null;
     error: WcsMediaErrorDetail | null;
+    /** Serializable Phase 6 failure taxonomy derived from `error`, or null. */
+    errorInfo: WcsIoErrorInfo | null;
 }
 type WcsRecorderValues = WcsRecorderCoreValues;
 interface WcsRecorderInputs {
@@ -204,6 +220,7 @@ declare class CameraCore extends EventTarget {
     private _deviceId;
     private _devices;
     private _error;
+    private _errorInfo;
     private _stream;
     private _desired;
     private _constraints;
@@ -219,6 +236,13 @@ declare class CameraCore extends EventTarget {
     get deviceId(): string | null;
     get devices(): MediaDeviceSnapshot[];
     get error(): WcsMediaErrorDetail | null;
+    /**
+     * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /
+     * `recoverable`), or null. Additive wc-bindable property (event
+     * `wcs-camera:error-info-changed`), derived from `error`; the existing `error`
+     * property/event are unchanged.
+     */
+    get errorInfo(): WcsIoErrorInfo | null;
     get ready(): Promise<void>;
     private _setActive;
     private _setPermission;
@@ -226,6 +250,7 @@ declare class CameraCore extends EventTarget {
     private _setDeviceId;
     private _setDevices;
     private _setError;
+    private _commitErrorInfo;
     private _dispatch;
     private _devicesEqual;
     /**
@@ -325,6 +350,8 @@ declare class WcsCamera extends HTMLElement {
     get audioPermission(): MediaPermissionState | null;
     get devices(): MediaDeviceSnapshot[];
     get error(): WcsMediaErrorDetail | null;
+    /** The last failure's serializable `WcsIoErrorInfo` (Phase 6 taxonomy), or null. */
+    get errorInfo(): WcsIoErrorInfo | null;
     get connectedCallbackPromise(): Promise<void>;
     start(): void;
     stop(): void;
@@ -384,6 +411,7 @@ declare class RecorderCore extends EventTarget {
     private _blob;
     private _objectURL;
     private _error;
+    private _errorInfo;
     private _recorder;
     private _stream;
     private _chunks;
@@ -399,12 +427,20 @@ declare class RecorderCore extends EventTarget {
     get blob(): Blob | null;
     get objectURL(): string | null;
     get error(): WcsMediaErrorDetail | null;
+    /**
+     * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /
+     * `recoverable`), or null. Additive wc-bindable property (event
+     * `wcs-recorder:error-info-changed`), derived from `error`; the existing `error`
+     * property/event are unchanged.
+     */
+    get errorInfo(): WcsIoErrorInfo | null;
     get ready(): Promise<void>;
     private _setRecording;
     private _setPaused;
     private _setDuration;
     private _setMimeType;
     private _setError;
+    private _commitErrorInfo;
     private _dispatch;
     /**
      * Borrow a stream for recording (the direct-channel sink). Synchronous, no
@@ -475,6 +511,8 @@ declare class WcsRecorder extends HTMLElement {
     get blob(): Blob | null;
     get objectURL(): string | null;
     get error(): WcsMediaErrorDetail | null;
+    /** The last failure's serializable `WcsIoErrorInfo` (Phase 6 taxonomy), or null. */
+    get errorInfo(): WcsIoErrorInfo | null;
     /** Borrow a stream (the direct-channel sink). */
     attachStream(stream: MediaStream): void;
     start(): void;
@@ -487,5 +525,39 @@ declare class WcsRecorder extends HTMLElement {
     disconnectedCallback(): void;
 }
 
-export { CameraCore, RecorderCore, WcsCamera, WcsRecorder, bootstrapCamera, getConfig };
-export type { CameraConstraints, FacingMode, IWritableConfig, IWritableTagNames, MediaDeviceSnapshot, MediaPermissionState, RecorderOptions, WcsCameraCommands, WcsCameraCoreCommands, WcsCameraCoreValues, WcsCameraInputs, WcsCameraValues, WcsMediaErrorDetail, WcsRecordedDetail, WcsRecorderCommands, WcsRecorderCoreCommands, WcsRecorderCoreValues, WcsRecorderInputs, WcsRecorderValues };
+/**
+ * mediaCapabilities.ts
+ *
+ * camera / recorder node 固有の error code(taxonomy)と derivation。汎用の error info
+ * 型は `./platformCapability.js`(/io-core/ から copy-distribution される生成ファイル)から
+ * import する。
+ *
+ * この 1 ファイルを CameraCore(getUserMedia)と RecorderCore(MediaRecorder)の両方が
+ * import する。両 Core は同一の error detail 型(`WcsMediaErrorDetail = { name, message }`、
+ * `.name` が DOMException 名 / "unsupported" sentinel / 各 Core 固有の合成名)を共有する
+ * ため、derivation も 1 本で両者を賄える。lane は持たず(getUserMedia は acquire を
+ * `_gen` で switchMap 済み、録画は command-driven)、error taxonomy(errorInfo)のみを採用する。
+ */
+
+/** 安定した media(camera / recorder)error code(taxonomy)。値は公開キーとして固定。 */
+declare const WCS_MEDIA_ERROR_CODE: {
+    /** getUserMedia / MediaRecorder API 不在(非セキュアコンテキスト含む) — "unsupported" sentinel。 */
+    readonly CapabilityMissing: "capability-missing";
+    /** `NotAllowedError` / `SecurityError` — 権限拒否・feature-policy ブロック。 */
+    readonly NotAllowed: "not-allowed";
+    /** `NotFoundError` — 要求した種類のデバイス(カメラ/マイク)が存在しない。 */
+    readonly NotFound: "not-found";
+    /** `NotReadableError` — デバイスがハードウェア障害/他アプリ占有で読めない。 */
+    readonly NotReadable: "not-readable";
+    /** `OverconstrainedError` / `NotSupportedError` — 制約・構成(mimeType 等)が満たせない。 */
+    readonly InvalidArgument: "invalid-argument";
+    /** `NoStreamError` — stream 未 attach で録画開始(前提状態の不備)。 */
+    readonly InvalidState: "invalid-state";
+    /** `AbortError` — 実行途中の中断(retry で回復しうる)。 */
+    readonly Aborted: "aborted";
+    /** その他の実行時失敗(`RecorderError` / 想定外の MediaRecorder エラー等)。 */
+    readonly MediaError: "media-error";
+};
+
+export { CameraCore, RecorderCore, WCS_MEDIA_ERROR_CODE, WcsCamera, WcsRecorder, bootstrapCamera, getConfig };
+export type { CameraConstraints, FacingMode, IWritableConfig, IWritableTagNames, MediaDeviceSnapshot, MediaPermissionState, RecorderOptions, WcsCameraCommands, WcsCameraCoreCommands, WcsCameraCoreValues, WcsCameraInputs, WcsCameraValues, WcsIoErrorInfo, WcsIoErrorPhase, WcsMediaErrorDetail, WcsRecordedDetail, WcsRecorderCommands, WcsRecorderCoreCommands, WcsRecorderCoreValues, WcsRecorderInputs, WcsRecorderValues };

package/dist/index.esm.js

@@ -198,6 +198,83 @@ class MediaPermissionWatcher {
     };
 }
 
+/**
+ * mediaCapabilities.ts
+ *
+ * camera / recorder node 固有の error code(taxonomy)と derivation。汎用の error info
+ * 型は `./platformCapability.js`(/io-core/ から copy-distribution される生成ファイル)から
+ * import する。
+ *
+ * この 1 ファイルを CameraCore(getUserMedia)と RecorderCore(MediaRecorder)の両方が
+ * import する。両 Core は同一の error detail 型(`WcsMediaErrorDetail = { name, message }`、
+ * `.name` が DOMException 名 / "unsupported" sentinel / 各 Core 固有の合成名)を共有する
+ * ため、derivation も 1 本で両者を賄える。lane は持たず(getUserMedia は acquire を
+ * `_gen` で switchMap 済み、録画は command-driven)、error taxonomy(errorInfo)のみを採用する。
+ */
+/** 安定した media(camera / recorder)error code(taxonomy)。値は公開キーとして固定。 */
+const WCS_MEDIA_ERROR_CODE = {
+    /** getUserMedia / MediaRecorder API 不在(非セキュアコンテキスト含む) — "unsupported" sentinel。 */
+    CapabilityMissing: "capability-missing",
+    /** `NotAllowedError` / `SecurityError` — 権限拒否・feature-policy ブロック。 */
+    NotAllowed: "not-allowed",
+    /** `NotFoundError` — 要求した種類のデバイス(カメラ/マイク)が存在しない。 */
+    NotFound: "not-found",
+    /** `NotReadableError` — デバイスがハードウェア障害/他アプリ占有で読めない。 */
+    NotReadable: "not-readable",
+    /** `OverconstrainedError` / `NotSupportedError` — 制約・構成(mimeType 等)が満たせない。 */
+    InvalidArgument: "invalid-argument",
+    /** `NoStreamError` — stream 未 attach で録画開始(前提状態の不備)。 */
+    InvalidState: "invalid-state",
+    /** `AbortError` — 実行途中の中断(retry で回復しうる)。 */
+    Aborted: "aborted",
+    /** その他の実行時失敗(`RecorderError` / 想定外の MediaRecorder エラー等)。 */
+    MediaError: "media-error",
+};
+/**
+ * 正規化済み media error(`WcsMediaErrorDetail = { name, message }`)を serializable な
+ * error taxonomy に写す。`name` は DOMException 名 / "unsupported" sentinel / Core 固有の
+ * 合成名(`NoStreamError` / `RecorderError`)。公開 `error` shape は不変で、これはその
+ * 付加的な分類。
+ *
+ * - "unsupported" は利用直前の能力欠如 → phase="probe" / capability-missing。
+ * - `NotAllowedError` / `SecurityError` は取得開始時の権限拒否 → phase="start" /
+ *   not-allowed。retry で回復しない。
+ * - `NotFoundError` は要求デバイス不在 → phase="start" / not-found。
+ * - `NotReadableError` はデバイス占有/ハードウェア障害 → phase="start" / not-readable。
+ * - `OverconstrainedError` / `NotSupportedError` は制約・構成が満たせない
+ *   → phase="start" / invalid-argument。
+ * - `NoStreamError`(stream 未 attach で録画開始)は前提状態の不備 → phase="start" /
+ *   invalid-state。
+ * - `AbortError` は実行途中の中断 → phase="execute" / aborted(recoverable=true)。
+ * - それ以外(`RecorderError` / runtime MediaRecorder エラー / "Error" fallback 等)は
+ *   phase="execute" / media-error。
+ */
+function deriveMediaErrorInfo(error) {
+    const { name, message } = error;
+    if (name === "unsupported") {
+        return { code: WCS_MEDIA_ERROR_CODE.CapabilityMissing, phase: "probe", recoverable: false, message };
+    }
+    if (name === "NotAllowedError" || name === "SecurityError") {
+        return { code: WCS_MEDIA_ERROR_CODE.NotAllowed, phase: "start", recoverable: false, message };
+    }
+    if (name === "NotFoundError") {
+        return { code: WCS_MEDIA_ERROR_CODE.NotFound, phase: "start", recoverable: false, message };
+    }
+    if (name === "NotReadableError") {
+        return { code: WCS_MEDIA_ERROR_CODE.NotReadable, phase: "start", recoverable: false, message };
+    }
+    if (name === "OverconstrainedError" || name === "NotSupportedError") {
+        return { code: WCS_MEDIA_ERROR_CODE.InvalidArgument, phase: "start", recoverable: false, message };
+    }
+    if (name === "NoStreamError") {
+        return { code: WCS_MEDIA_ERROR_CODE.InvalidState, phase: "start", recoverable: false, message };
+    }
+    if (name === "AbortError") {
+        return { code: WCS_MEDIA_ERROR_CODE.Aborted, phase: "execute", recoverable: true, message };
+    }
+    return { code: WCS_MEDIA_ERROR_CODE.MediaError, phase: "execute", recoverable: false, message };
+}
+
 /**
  * Headless camera-capture primitive. Wraps getUserMedia + the Permissions API and
  * exposes a `MediaStream` through the wc-bindable protocol — but the live stream is
@@ -223,6 +300,12 @@ class CameraCore extends EventTarget {
             { name: "deviceId", event: "wcs-camera:device-changed" },
             { name: "devices", event: "wcs-camera:devices-changed" },
             { name: "error", event: "wcs-camera:error" },
+            // Serializable failure taxonomy (stable code / phase / recoverable), or null.
+            // Additive bindable output derived from `error` (the DOMException name /
+            // "unsupported" sentinel); the existing `error` property/event are unchanged.
+            // Fires wcs-camera:error-info-changed. No lane — acquisition is switchMap'd by
+            // `_gen`, so there is no per-node operation policy to attach here.
+            { name: "errorInfo", event: "wcs-camera:error-info-changed" },
             // Direct-channel handle: event-token only — never bound as a reactive value.
             { name: "streamReady", event: "wcs-camera:stream-ready", getter: (e) => e.detail },
             // event-token: a bare signal (detail is always null) — surface detail, not the raw Event.
@@ -241,6 +324,7 @@ class CameraCore extends EventTarget {
     _deviceId = null;
     _devices = [];
     _error = null;
+    _errorInfo = null;
     // The live stream — internal only, never a reactive value (see class docs).
     _stream = null;
     // desired/actual split (wakelock-style): `_desired` is whether the user wants the
@@ -268,6 +352,13 @@ class CameraCore extends EventTarget {
     get deviceId() { return this._deviceId; }
     get devices() { return this._devices; }
     get error() { return this._error; }
+    /**
+     * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /
+     * `recoverable`), or null. Additive wc-bindable property (event
+     * `wcs-camera:error-info-changed`), derived from `error`; the existing `error`
+     * property/event are unchanged.
+     */
+    get errorInfo() { return this._errorInfo; }
     get ready() { return this._ready; }
     // --- State setters with event dispatch (same-value guarded) ---
     _setActive(active) {
@@ -310,8 +401,18 @@ class CameraCore extends EventTarget {
         if (error === null && this._error === null)
             return;
         this._error = error;
+        // Keep the additive `errorInfo` taxonomy in sync with `error`: derive from the
+        // error detail (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 : deriveMediaErrorInfo(error));
         this._dispatch("wcs-camera:error", error);
     }
+    // Called only from _setError (which already collapses the null→null transition), so
+    // errorInfo transitions exactly when error does — no separate guard needed here.
+    _commitErrorInfo(info) {
+        this._errorInfo = info;
+        this._dispatch("wcs-camera:error-info-changed", info);
+    }
     _dispatch(type, detail) {
         this._target.dispatchEvent(new CustomEvent(type, { detail, bubbles: true }));
     }
@@ -684,6 +785,8 @@ class WcsCamera extends HTMLElement {
     get audioPermission() { return this._core.audioPermission; }
     get devices() { return this._core.devices; }
     get error() { return this._core.error; }
+    /** The last failure's serializable `WcsIoErrorInfo` (Phase 6 taxonomy), or null. */
+    get errorInfo() { return this._core.errorInfo; }
     get connectedCallbackPromise() { return this._connectedCallbackPromise; }
     // --- Commands ---
     start() { this._core.start(); }
@@ -832,6 +935,12 @@ class RecorderCore extends EventTarget {
             { name: "blob", event: "wcs-recorder:recorded", getter: (e) => e.detail?.blob ?? null },
             { name: "objectURL", event: "wcs-recorder:recorded", getter: (e) => e.detail?.objectURL ?? null },
             { name: "error", event: "wcs-recorder:error" },
+            // Serializable failure taxonomy (stable code / phase / recoverable), or null.
+            // Additive bindable output derived from `error` (the DOMException name /
+            // "unsupported"/"NoStreamError"/"RecorderError" sentinel); the existing `error`
+            // property/event are unchanged. Fires wcs-recorder:error-info-changed. No lane —
+            // recording is command-driven.
+            { name: "errorInfo", event: "wcs-recorder:error-info-changed" },
             // event-token: detail = the assembled clip { blob, objectURL, mimeType, duration }.
             { name: "recorded", event: "wcs-recorder:recorded", getter: (e) => e.detail },
             // event-token (timeslice mode): detail = the streamed Blob chunk.
@@ -853,6 +962,7 @@ class RecorderCore extends EventTarget {
     _blob = null;
     _objectURL = null;
     _error = null;
+    _errorInfo = null;
     _recorder = null;
     _stream = null; // borrowed — never stopped here
     _chunks = [];
@@ -878,6 +988,13 @@ class RecorderCore extends EventTarget {
     get blob() { return this._blob; }
     get objectURL() { return this._objectURL; }
     get error() { return this._error; }
+    /**
+     * The last failure's serializable `WcsIoErrorInfo` (stable `code` / `phase` /
+     * `recoverable`), or null. Additive wc-bindable property (event
+     * `wcs-recorder:error-info-changed`), derived from `error`; the existing `error`
+     * property/event are unchanged.
+     */
+    get errorInfo() { return this._errorInfo; }
     get ready() { return this._ready; }
     // --- State setters ---
     _setRecording(v) {
@@ -913,8 +1030,18 @@ class RecorderCore extends EventTarget {
         if (error === null && this._error === null)
             return;
         this._error = error;
+        // Keep the additive `errorInfo` taxonomy in sync with `error`: derive from the
+        // error detail (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 : deriveMediaErrorInfo(error));
         this._dispatch("wcs-recorder:error", error);
     }
+    // Called only from _setError (which already collapses the null→null transition), so
+    // errorInfo transitions exactly when error does — no separate guard needed here.
+    _commitErrorInfo(info) {
+        this._errorInfo = info;
+        this._dispatch("wcs-recorder:error-info-changed", info);
+    }
     _dispatch(type, detail) {
         this._target.dispatchEvent(new CustomEvent(type, { detail, bubbles: true }));
     }
@@ -1220,6 +1347,8 @@ class WcsRecorder extends HTMLElement {
     get blob() { return this._core.blob; }
     get objectURL() { return this._core.objectURL; }
     get error() { return this._core.error; }
+    /** The last failure's serializable `WcsIoErrorInfo` (Phase 6 taxonomy), or null. */
+    get errorInfo() { return this._core.errorInfo; }
     // --- Commands ---
     /** Borrow a stream (the direct-channel sink). */
     attachStream(stream) {
@@ -1280,5 +1409,5 @@ function bootstrapCamera(userConfig) {
     registerComponents();
 }
 
-export { CameraCore, RecorderCore, WcsCamera, WcsRecorder, bootstrapCamera, getConfig };
+export { CameraCore, RecorderCore, WCS_MEDIA_ERROR_CODE, WcsCamera, WcsRecorder, bootstrapCamera, getConfig };
 //# sourceMappingURL=index.esm.js.map