@wcstack/upload 4.0.0-rc.8 → 4.0.0

package/dist/index.esm.js

@@ -849,6 +849,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);
+}
+
 class WcsUpload extends HTMLElement {
     static hasConnectedCallbackPromise = true;
     static wcBindable = {
@@ -861,9 +916,9 @@ class WcsUpload extends HTMLElement {
         // Shell-level input surface. The Core declares only the portable `url` / `method` /
         // `fieldName`; the Shell adds the DOM-driven settable surface. No `attribute` hints
         // are given: the `url` / `method` / `fieldName` / `multiple` / `maxSize` / `accept` /
-        // `manual` setters already reflect to their attributes, so a binding system that
-        // mirrors inputs[].attribute would set the attribute twice (`files` / `trigger` are
-        // not attribute-backed). `commands` (upload / abort) are inherited unchanged from the
+        // `manual` setters reflect to their attributes themselves, and a binding system that
+        // mirrored inputs[].attribute (@wcstack/state 3.x) would set the attribute twice
+        // (`files` / `trigger` are not attribute-backed). `commands` (upload / abort) are inherited unchanged from the
         // Core via the spread above.
         inputs: [
             { name: "url" },
@@ -947,34 +1002,34 @@ class WcsUpload extends HTMLElement {
         return this._connectedCallbackPromise;
     }
     // --- Attribute accessors ---
+    //
+    // setter は null / undefined を setAttribute に文字列化させない（"undefined" の url へ
+    // 送信したり、"null" の method を使ったりしないため）。`null` は属性を外して既定値に戻し、
+    // `undefined` は要素が最初に持っていた属性へ戻す（wc-bindable producer guidance P1。
+    // React 19 や直接の代入は undefined を書く。@wcstack/state は書かない）。
     get url() {
         return this.getAttribute("url") || "";
     }
     set url(value) {
-        this.setAttribute("url", value);
+        reflectAttribute(this, "url", value);
     }
     get method() {
         return (this.getAttribute("method") || "POST").toUpperCase();
     }
     set method(value) {
-        this.setAttribute("method", value);
+        reflectAttribute(this, "method", value);
     }
     get fieldName() {
         return this.getAttribute("field-name") || "file";
     }
     set fieldName(value) {
-        this.setAttribute("field-name", value);
+        reflectAttribute(this, "field-name", value);
     }
     get multiple() {
         return this.hasAttribute("multiple");
     }
     set multiple(value) {
-        if (value) {
-            this.setAttribute("multiple", "");
-        }
-        else {
-            this.removeAttribute("multiple");
-        }
+        reflectBooleanAttribute(this, "multiple", value);
     }
     get maxSize() {
         const attr = this.getAttribute("max-size");
@@ -988,24 +1043,19 @@ class WcsUpload extends HTMLElement {
         return Number.isFinite(n) && n >= 0 ? n : Infinity;
     }
     set maxSize(value) {
-        this.setAttribute("max-size", String(value));
+        reflectAttribute(this, "max-size", value);
     }
     get accept() {
         return this.getAttribute("accept") || "";
     }
     set accept(value) {
-        this.setAttribute("accept", value);
+        reflectAttribute(this, "accept", value);
     }
     get manual() {
         return this.hasAttribute("manual");
     }
     set manual(value) {
-        if (value) {
-            this.setAttribute("manual", "");
-        }
-        else {
-            this.removeAttribute("manual");
-        }
+        reflectBooleanAttribute(this, "manual", value);
     }
     // --- Core delegated getters ---
     get value() {
@@ -1054,12 +1104,15 @@ class WcsUpload extends HTMLElement {
         return this._files;
     }
     set files(value) {
-        this._files = value;
+        // undefined は「値が無い」= 初期状態（null）。null と同じく files をクリアし、
+        // files-changed にも undefined ではなく null を載せる。
+        const files = value ?? null;
+        this._files = files;
         this.dispatchEvent(new CustomEvent("wcs-upload:files-changed", {
-            detail: value,
+            detail: files,
             bubbles: true,
         }));
-        if (!this.manual && this.url && value && value.length > 0) {
+        if (!this.manual && this.url && files && files.length > 0) {
             this.upload();
         }
     }