@wcstack/camera 4.0.0-rc.8 → 4.0.0

package/dist/index.esm.js

@@ -702,6 +702,61 @@ function upgradeProperties(element) {
     }
 }
 
+// ===========================================================================
+// AUTO-GENERATED FILE - DO NOT EDIT.
+// Generated from /protocol/input-attribute.ts by scripts/sync-protocol-types.mjs.
+// Run `node scripts/sync-protocol-types.mjs` after editing the source.
+// ===========================================================================
+// 属性へ反映する wc-bindable 入力の producer 側（SPEC-extensions § Producer guidance for inputs の P1〜P3）。
+// 入力の setter は属性をこの 2 関数で書く。それで次が揃う:
+//   - `undefined` は「値が無い」（P1）: 属性を、この関数で最初に書く前の状態 — マークアップに書かれた値、
+//     無ければ属性なし（= その入力の文書化した既定値）— へ戻す。applier プロファイルを宣言する binder は
+//     値の後の `undefined` を書き（A2）、React 19 も書き、直接の代入でも届く。
+//   - `null` はクリア（P2）: 属性なし、つまり文書化した既定値。
+//   - どちらも文字列 "undefined" / "null" として属性に入らない。
+//
+// 「最初に書く前」は、その最初の書き込みのときに読む（遅延）。upgrade 前に代入されたプロパティは
+// connectedCallback の upgradeProperties() が通し直すので、そのときにはパーサが書いた属性が揃っている。
+// 要素自身が setter を通さずに書いた属性は、最初の書き込みより前なら「最初の状態」に含まれる。
+//
+// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/input-attribute.ts), then run
+// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies
+// (packages/<pkg>/src/protocol/inputAttribute.ts). Those copies are generated — do not edit them.
+const initialAttributes = new WeakMap();
+/** The attribute as it stood before the first write through these helpers. */
+function initialAttribute(el, name) {
+    let byName = initialAttributes.get(el);
+    if (byName === undefined) {
+        byName = new Map();
+        initialAttributes.set(el, byName);
+    }
+    if (!byName.has(name))
+        byName.set(name, el.getAttribute(name));
+    return byName.get(name);
+}
+function writeAttribute(el, name, value) {
+    if (value === null)
+        el.removeAttribute(name);
+    else
+        el.setAttribute(name, value);
+}
+/**
+ * A value attribute. `value` is written as `String(value)`; `null` removes the attribute;
+ * `undefined` restores the attribute the element started with.
+ */
+function reflectAttribute(el, name, value) {
+    const initial = initialAttribute(el, name);
+    writeAttribute(el, name, value === undefined ? initial : value === null ? null : String(value));
+}
+/**
+ * A boolean attribute, present while `value` is truthy (`null` and `false` remove it);
+ * `undefined` restores the attribute the element started with.
+ */
+function reflectBooleanAttribute(el, name, value) {
+    const initial = initialAttribute(el, name);
+    writeAttribute(el, name, value === undefined ? initial : value ? "" : null);
+}
+
 /**
  * `<wcs-camera>` — declarative camera capture with a built-in preview.
  *
@@ -825,22 +880,33 @@ class WcsCamera extends HTMLElement {
         }
     }
     // --- Attribute accessors ---
+    //
+    // The setters never let setAttribute stringify null / undefined (a "undefined"
+    // device-id would become an exact constraint no camera matches): `null`
+    // removes the attribute (the default), `undefined` restores the attribute the
+    // element started with (wc-bindable producer guidance P1; React 19 and a
+    // direct assignment deliver it, @wcstack/state does not).
     get audio() { return this.hasAttribute("audio"); }
-    set audio(value) { this._toggleAttr("audio", value); }
+    set audio(value) { reflectBooleanAttribute(this, "audio", value); }
     get facingMode() {
         return this.getAttribute("facing-mode") === "environment" ? "environment" : "user";
     }
-    set facingMode(value) { this.setAttribute("facing-mode", value); }
-    get deviceId() { return this.getAttribute("device-id") ?? ""; }
-    set deviceId(value) { this.setAttribute("device-id", value); }
+    set facingMode(value) { reflectAttribute(this, "facing-mode", value); }
+    // `deviceId` is an input (the `device-id` request) and an output (the device the
+    // stream uses, published with `wcs-camera:device-changed`). Reading it gives the
+    // device in use once one is known — what the event carries, and what a binder's
+    // initial sync reads — and the request until then. The constraints read the
+    // request from the attribute (`_constraints`), as <wcs-recorder>'s mimeType does.
+    get deviceId() { return this._core.deviceId ?? this.getAttribute("device-id") ?? ""; }
+    set deviceId(value) { reflectAttribute(this, "device-id", value); }
     get width() { return this._numberAttr("width"); }
-    set width(value) { this.setAttribute("width", String(value)); }
+    set width(value) { reflectAttribute(this, "width", value); }
     get height() { return this._numberAttr("height"); }
-    set height(value) { this.setAttribute("height", String(value)); }
+    set height(value) { reflectAttribute(this, "height", value); }
     get autostart() { return this.hasAttribute("autostart"); }
-    set autostart(value) { this._toggleAttr("autostart", value); }
+    set autostart(value) { reflectBooleanAttribute(this, "autostart", value); }
     get keepAlive() { return this.hasAttribute("keep-alive"); }
-    set keepAlive(value) { this._toggleAttr("keep-alive", value); }
+    set keepAlive(value) { reflectBooleanAttribute(this, "keep-alive", value); }
     /** The internal preview `<video>` (for advanced styling/measurement). */
     get videoElement() { return this._video; }
     // --- Core delegated getters ---
@@ -884,14 +950,6 @@ class WcsCamera extends HTMLElement {
         }
     }
     // --- Internal ---
-    _toggleAttr(name, value) {
-        if (value) {
-            this.setAttribute(name, "");
-        }
-        else {
-            this.removeAttribute(name);
-        }
-    }
     _numberAttr(name) {
         const attr = this.getAttribute(name);
         if (attr === null || attr.trim() === "")
@@ -901,8 +959,11 @@ class WcsCamera extends HTMLElement {
     }
     _constraints() {
         const c = { audio: this.audio, facingMode: this.facingMode };
-        if (this.deviceId)
-            c.deviceId = this.deviceId;
+        // the request, not `get deviceId()` (the device in use): after switchCamera()
+        // removed it, the previous device must not stay pinned
+        const requested = this.getAttribute("device-id");
+        if (requested)
+            c.deviceId = requested;
         if (Number.isFinite(this.width))
             c.width = this.width;
         if (Number.isFinite(this.height))
@@ -1398,14 +1459,20 @@ class WcsRecorder extends HTMLElement {
     // browser may pick a different type, or fill one in when none was requested, and
     // bindings must read the actual value. The input side is read straight from the
     // attribute in `_options()`. The setter still writes the request attribute.
+    //
+    // The setters never let setAttribute stringify null / undefined (a "undefined"
+    // mime-type would be requested from MediaRecorder): `null` removes the
+    // attribute (no request — the browser's default), `undefined` restores the
+    // attribute the element started with (wc-bindable producer guidance P1;
+    // React 19 and a direct assignment deliver it, @wcstack/state does not).
     get mimeType() { return this._core.mimeType; }
-    set mimeType(value) { this.setAttribute("mime-type", value); }
+    set mimeType(value) { reflectAttribute(this, "mime-type", value); }
     get timeslice() { return this._numberAttr("timeslice"); }
-    set timeslice(value) { this.setAttribute("timeslice", String(value)); }
+    set timeslice(value) { reflectAttribute(this, "timeslice", value); }
     get audioBitsPerSecond() { return this._numberAttr("audio-bits"); }
-    set audioBitsPerSecond(value) { this.setAttribute("audio-bits", String(value)); }
+    set audioBitsPerSecond(value) { reflectAttribute(this, "audio-bits", value); }
     get videoBitsPerSecond() { return this._numberAttr("video-bits"); }
-    set videoBitsPerSecond(value) { this.setAttribute("video-bits", String(value)); }
+    set videoBitsPerSecond(value) { reflectAttribute(this, "video-bits", value); }
     // --- Core delegated getters ---
     get recording() { return this._core.recording; }
     get paused() { return this._core.paused; }