@wcstack/upload 4.5.0 → 4.6.0

package/dist/index.d.ts

@@ -213,6 +213,7 @@ declare class WcsUpload extends HTMLElement {
     private _files;
     private _trigger;
     private _told;
+    private _waitingForUrl;
     private _connectedCallbackPromise;
     private _internals;
     constructor();
@@ -249,7 +250,7 @@ declare class WcsUpload extends HTMLElement {
     abort(): void;
     upload(): Promise<any>;
     private _warnNotReady;
-    attributeChangedCallback(_name: string, _oldValue: string | null, _newValue: string | null): void;
+    attributeChangedCallback(_name: string, _oldValue: string | null, newValue: string | null): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
 }

package/dist/index.esm.js

@@ -830,6 +830,21 @@ function hasAccessorOnPrototype(target, name) {
     }
     return false;
 }
+// 属性になってしまったオブジェクトの入力（`files="[object File]"`）を、要素ごとに 1 回だけ言う。
+// React 19 は定義前の要素にプロパティが無いのでオブジェクトを属性に書き、Vue の `.attr` も
+// 書く。要素はその入力をプロパティでしか読まないので、何も受け取らず、何も言わなかった
+// （docs/seam-apps.md、fw-inventory）。
+const toldObjectAttribute = new WeakSet();
+function warnObjectAttribute(element, name, value) {
+    if (toldObjectAttribute.has(element))
+        return;
+    toldObjectAttribute.add(element);
+    const tag = element.localName ?? "element";
+    console.warn(`[wcs/input-as-attribute] <${tag}> has the attribute ${name}="${value}": an object was written as an ` +
+        `attribute, so the element did not receive it. A framework does that when the property is set before the ` +
+        `element's definition loads (React 19), or when told to (Vue's .attr). Load the definition before rendering, ` +
+        `or assign the property through a ref (Vue: .prop). (Said once per element.)`, element);
+}
 /**
  * `connectedCallback` の先頭で呼ぶ。宣言済み input のうち upgrade 前の代入で
  * accessor をシャドウしている own プロパティを、delete → 再代入で setter に通し直す。
@@ -837,14 +852,19 @@ function hasAccessorOnPrototype(target, name) {
  * - 冪等: 再代入は accessor を通るので own プロパティは残らず、2 回目以降は no-op。
  * - 宣言に `inputs` が無い要素、`wcBindable` を持たない要素では何もしない。
  * - 値の意味は変えない。今まで捨てられていた代入が届くようになる一方向の変化。
+ * - 値が `[object …]` の属性（属性に書かれてしまったオブジェクトの入力）は、要素ごとに 1 回警告する。
  */
 function upgradeProperties(element) {
     const declaration = element.constructor?.wcBindable;
     const inputs = declaration?.inputs;
     if (inputs === undefined)
         return;
+    const getAttribute = element.getAttribute;
     for (const input of inputs) {
         const name = input.name;
+        const attribute = typeof getAttribute === "function" ? getAttribute.call(element, name.toLowerCase()) : null;
+        if (attribute !== null && attribute.startsWith("[object "))
+            warnObjectAttribute(element, name, attribute);
         if (!Object.prototype.hasOwnProperty.call(element, name))
             continue;
         if (!hasAccessorOnPrototype(element, name))
@@ -939,9 +959,10 @@ class WcsUpload extends HTMLElement {
             { name: "trigger" },
         ],
     };
-    // `url` を観測するのは FetchCore のシェルと構造を揃えるためだが、upload は
-    // url 変更だけでは送信できない（files が必須）。そのため attributeChangedCallback は
-    // 意図的に何もしない。url 変更で自動送信しないことは仕様であり、テストで担保している。
+    // `url` を観測するのは、url の無いうちに自動送信の files を受けたとき、url が来たらその
+    // files を送るため（4.5 までは url を待たずに黙って何もしなかった。JSX の props や data-wcs の
+    // 束縛は書いた順に当たるので、files を url より前に書くと送られなかった — docs/seam-apps.md、
+    // state-field-report と fw-inventory）。それ以外の url の変更では送らない。
     static get observedAttributes() { return ["url"]; }
     _core;
     _files = null;
@@ -949,6 +970,8 @@ class WcsUpload extends HTMLElement {
     // The reasons `[wcs/command-not-ready]` was said for, once each per element
     // (docs/v4-direction-2026-10.md §5.1, the I/O command policy).
     _told = null;
+    // automatic-mode files assigned while there was no url: sent when the url arrives
+    _waitingForUrl = false;
     _connectedCallbackPromise = Promise.resolve();
     _internals = null;
     constructor() {
@@ -1122,12 +1145,10 @@ class WcsUpload extends HTMLElement {
             detail: files,
             bubbles: true,
         }));
-        if (!this.manual && files && files.length > 0) {
-            if (this.url)
-                this.upload();
-            else
-                this._warnNotReady("files were assigned while there is no url");
-        }
+        // files that arrive before the url wait for it (automatic mode only)
+        this._waitingForUrl = !this.manual && !!files && files.length > 0 && !this.url;
+        if (!this.manual && files && files.length > 0 && this.url)
+            this.upload();
     }
     // --- Validation ---
     _validate(files) {
@@ -1207,20 +1228,26 @@ class WcsUpload extends HTMLElement {
         return result;
     }
     // A refused upload sent nothing and said nothing (no `error`, by design): a `trigger`
-    // written before `url` / `files` in one `data-wcs` (bindings apply in the order
-    // written), a retry after the files were used up, files picked before the url is known.
+    // written before `url` / `files` (`data-wcs` bindings and a framework's props are applied in
+    // the order written), a retry after the files were used up.
     _warnNotReady(reason) {
         if (this._told?.has(reason))
             return;
         (this._told ??= new Set()).add(reason);
         console.warn(`[@wcstack/upload] [wcs/command-not-ready] The upload was refused: ${reason}, so nothing is sent. ` +
-            "Write url and files before trigger (bindings apply in the order written), and assign files again " +
-            "for each retry: an upload uses them up. (Said once per element and reason.)", this);
+            "Write url and files before trigger (data-wcs bindings and a framework's props are applied in the order " +
+            "written), and assign files again for each retry: an upload uses them up. (Said once per element and reason.)", this);
     }
     // --- Lifecycle ---
-    attributeChangedCallback(_name, _oldValue, _newValue) {
-        // 意図的に空。url 変更ではアップロードを自動実行しない（files が必要なため）。
-        // observedAttributes のコメント参照。
+    attributeChangedCallback(_name, _oldValue, newValue) {
+        // url だけの変更では送らない。url の無いうちに受けた自動送信の files は、url が来たら送る。
+        // 接続は問わない: React 19 は要素を文書に入れる前に props を当てる（files の setter も、url が
+        // あれば接続の前に送る）。
+        if (!this._waitingForUrl || !newValue || this.manual)
+            return;
+        // (waiting means files were assigned and not replaced since: the setter resets it)
+        this._waitingForUrl = false;
+        this.upload();
     }
     connectedCallback() {
         // upgrade 前に代入された input を取り込み直す（doc 13 §1.2 / Phase A1）