@wcstack/devtools 1.30.0 → 1.32.0

package/dist/index.d.ts

@@ -148,6 +148,18 @@ type DevtoolsEventLike = {
     readonly type: "state:watch-fired";
     readonly stateName: string;
     readonly path: string;
+} | {
+    readonly type: "state:path-unresolved";
+    readonly source: "binding" | "watch";
+    readonly stateName: string;
+    readonly path: string;
+    readonly missingSegment: string;
+} | {
+    readonly type: "state:binding-apply-error";
+    readonly stateName: string;
+    readonly path: string;
+    readonly bindingType: string;
+    readonly error: unknown;
 } | {
     readonly type: "propagation:suppressed";
     readonly reason: "confirmation" | "visited-edge";
@@ -227,7 +239,7 @@ interface IDevtoolsHookRegistryLike {
 
 /** 予約 state 名 prefix（protocol §5）。この prefix の要素・イベントは常に除外 */
 declare const RESERVED_STATE_NAME_PREFIX = "wcs-devtools";
-type TimelineKind = "write" | "batch" | "command" | "event" | "element-registered" | "element-unregistered" | "watch-error" | "watch-chain-limit" | "propagation-suppressed" | "propagation-coalesced" | "propagation-hop-limit" | "contract-drift";
+type TimelineKind = "write" | "batch" | "command" | "event" | "element-registered" | "element-unregistered" | "watch-error" | "watch-chain-limit" | "path-unresolved" | "binding-apply-error" | "propagation-suppressed" | "propagation-coalesced" | "propagation-hop-limit" | "contract-drift";
 interface ITimelineEntry {
     readonly seq: number;
     readonly time: number;

package/dist/index.esm.js

@@ -808,6 +808,38 @@ class DevtoolsCore {
                 });
                 return;
             }
+            case "state:path-unresolved": {
+                if (this.isHiddenStateName(event.stateName)) {
+                    return;
+                }
+                // ランタイムは warn で続行する（既存ページを止めないため）。lint を
+                // 走らせていない相手には、ここが「配線が死んでいる」唯一の可視面になる。
+                this._appendTimeline({
+                    sourceId,
+                    kind: "path-unresolved",
+                    stateName: event.stateName,
+                    label: event.path,
+                    detail: `${event.source}: "${event.missingSegment}" is not declared`,
+                    subscriberCount: null,
+                });
+                return;
+            }
+            case "state:binding-apply-error": {
+                if (this.isHiddenStateName(event.stateName)) {
+                    return;
+                }
+                // 隔離された適用失敗。bindingType を detail 先頭に置くのは、構造
+                // （for / if）の失敗と値の失敗で影響範囲が違うため。
+                this._appendTimeline({
+                    sourceId,
+                    kind: "binding-apply-error",
+                    stateName: event.stateName,
+                    label: event.path,
+                    detail: `${event.bindingType}: ${formatError(event.error)}`,
+                    subscriberCount: null,
+                });
+                return;
+            }
             case "propagation:suppressed": {
                 // two-way エコーの辺単位抑止。state 名を持たない（node+member が主語）
                 // ため hidden 判定はここでは行わない。
@@ -1820,6 +1852,14 @@ class WcsDevtools extends HTMLElement {
                 ? "a $watch threw; the runtime isolated it (console.error only)"
                 : "a $watch write chain hit the depth limit and was cut off";
         }
+        // 配線の死（解決しないパス）と隔離された適用失敗も、ランタイムが console に
+        // 出すだけで続行する ＝ 見ていなければ気づけない種類なので warn に乗せる。
+        if (entry.kind === "path-unresolved" || entry.kind === "binding-apply-error") {
+            kind.classList.add("warn");
+            kind.title = entry.kind === "path-unresolved"
+                ? "a wired path does not resolve on the state; its updates are dropped"
+                : "a binding threw while applying; the runtime isolated it (console.error only)";
+        }
         // 伝播の打ち切りと契約 drift も「黙って起きる異常」なので warn に乗せる。
         // suppressed / coalesced は定常動作（エコー抑止・合流）のため通常表示。
         if (entry.kind === "propagation-hop-limit" || entry.kind === "contract-drift") {