@wcstack/devtools 3.2.0 → 3.4.0

package/dist/index.d.ts

@@ -92,6 +92,12 @@ interface IMountOverlaySummaryLike {
     readonly delta: number;
     /** 私有キー（オーバーレイ空間に住む own data key） */
     readonly privateKeys: readonly string[];
+    /**
+     * 公開 getter の公開パス（親スコープから読める — docs/state-overlay-export-design.md）。
+     * オーバーレイ export より前の v2 ランタイムにはフィールド自体が無いため optional
+     * （protocol §3 の `summary.exports ?? []`）。
+     */
+    readonly exports?: readonly string[];
     /** マーカーパスに載る getter のキー */
     readonly getterKeys: readonly string[];
 }
@@ -113,6 +119,18 @@ interface IKeyedSubscriptionSummaryLike {
     /** path の最後に見た値（見ていなければ undefined）。生値 */
     readonly lastValue: unknown;
 }
+/**
+ * 宣言されたフィルタ 1 件（ランタイム `IFilterInfo` の構造的サブセット）。
+ * `literals`（引数の型付きの値・要件 B9）は原文 `args` と別物で、フィルタの鍵
+ * （`filterKey.ts` の `filter.literals ?? filter.args`）と `eq` / `ne` / `defaults` の
+ * 比較が読む。宣言が無いと、独自 source を TS で書く採用者が `{ filterName, args }`
+ * だけのオブジェクトを渡し、型は通るのに鍵が縮退する（`"1"` と `1` が同じ鍵になる）。
+ */
+interface IDeclaredFilterLike {
+    readonly filterName: string;
+    readonly args: readonly string[];
+    readonly literals?: readonly unknown[];
+}
 /**
  * 宣言レベルのバインディング 1 件（getDeclaredBindings の要素・protocol v1 追補）。
  * ランタイム正本パーサの結果が構造的に流れる。宣言タプルで dedupe 済みの
@@ -124,14 +142,8 @@ interface IDeclaredBindingLike {
     readonly propName: string;
     readonly statePathName: string;
     readonly bindingType: string;
-    readonly inFilters: readonly {
-        readonly filterName: string;
-        readonly args: readonly string[];
-    }[];
-    readonly outFilters: readonly {
-        readonly filterName: string;
-        readonly args: readonly string[];
-    }[];
+    readonly inFilters: readonly IDeclaredFilterLike[];
+    readonly outFilters: readonly IDeclaredFilterLike[];
     readonly origin: "attribute" | "comment" | "fragment";
     readonly raw: string;
 }
@@ -184,6 +196,10 @@ type DevtoolsEventLike = {
     readonly type: "state:watch-chain-limit";
     readonly maxDepth: number;
     readonly paths: readonly string[];
+} | {
+    readonly type: "state:render-chain-limit";
+    readonly maxDepth: number;
+    readonly paths: readonly string[];
 } | {
     readonly type: "state:watch-fired";
     readonly path: string;
@@ -293,7 +309,7 @@ interface IDevtoolsHookRegistryLike {
  * sources / roster / wiring をクリアし、残留参照を持たない。
  */
 
-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";
+type TimelineKind = "write" | "batch" | "command" | "event" | "element-registered" | "element-unregistered" | "watch-error" | "watch-chain-limit" | "render-chain-limit" | "path-unresolved" | "binding-apply-error" | "propagation-suppressed" | "propagation-coalesced" | "propagation-hop-limit" | "contract-drift";
 interface ITimelineEntry {
     readonly seq: number;
     readonly time: number;
@@ -630,4 +646,4 @@ declare global {
 }
 
 export { DEVTOOLS_HOOK_GLOBAL, DEVTOOLS_PROTOCOL_VERSION, DevtoolsCore, WcsDevtools, bootstrapDevtools, formatArgs, formatValue, getOrCreateHookRegistry, scanDeclaredBindings };
-export type { CoreChangeKind, CoreChangeListener, DevtoolsEventLike, DevtoolsSinkLike, IAbsoluteAddressLike, IAbsolutePathInfoLike, IBindingLike, IDeclaredBinding, IDevtoolsCoreOptions, IDevtoolsHookRegistryLike, IDevtoolsListenerLike, IDevtoolsSourceLike, IListIndexLike, IPathInfoLike, IRosterEntry, IStateElementSummaryLike, ITimelineEntry, IWiringEntry, TimelineKind };
+export type { CoreChangeKind, CoreChangeListener, DevtoolsEventLike, DevtoolsSinkLike, IAbsoluteAddressLike, IAbsolutePathInfoLike, IBindingLike, IDeclaredBinding, IDeclaredBindingLike, IDeclaredFilterLike, IDevtoolsCoreOptions, IDevtoolsHookRegistryLike, IDevtoolsListenerLike, IDevtoolsSourceLike, IKeyedSubscriptionSummaryLike, IListIndexLike, IMountOverlaySummaryLike, IPathInfoLike, IRosterEntry, IStateElementSummaryLike, ITimelineEntry, IWiringEntry, TimelineKind };

package/dist/index.esm.js

@@ -863,6 +863,17 @@ class DevtoolsCore {
                 });
                 return;
             }
+            case "state:render-chain-limit": {
+                // 描画の循環（#338）。watch-chain-limit と同じくバッチ単位の打ち切りなので同じ形で並べる
+                this._appendTimeline({
+                    sourceId,
+                    kind: "render-chain-limit",
+                    label: `depth > ${event.maxDepth}`,
+                    detail: event.paths.join(", "),
+                    subscriberCount: null,
+                });
+                return;
+            }
             case "state:path-unresolved": {
                 // ランタイムは warn で続行する（既存ページを止めないため）。lint を
                 // 走らせていない相手には、ここが「配線が死んでいる」唯一の可視面になる。
@@ -1638,6 +1649,12 @@ class WcsDevtools extends HTMLElement {
         if (overlay.privateKeys.length > 0) {
             details.push(`private: ${overlay.privateKeys.join(", ")}`);
         }
+        // 公開 getter の公開パス。オーバーレイ export より前の v2 ランタイムは
+        // フィールドを持たないので `?? []` で受ける（protocol §3）
+        const exports = overlay.exports ?? [];
+        if (exports.length > 0) {
+            details.push(`exports: ${exports.join(", ")}`);
+        }
         if (overlay.getterKeys.length > 0) {
             details.push(`getters: ${overlay.getterKeys.join(", ")}`);
         }
@@ -2005,6 +2022,11 @@ class WcsDevtools extends HTMLElement {
                 ? "a $watch or $scan failure (read, handler, fold or write — see the phase in the detail); the runtime isolated it (console.error only)"
                 : "a $watch write chain hit the depth limit and was cut off";
         }
+        // 描画の循環の打ち切り（#338）もランタイムは console に出すだけで続行する（バッチの binding は未適用）
+        if (entry.kind === "render-chain-limit") {
+            kind.classList.add("warn");
+            kind.title = "writes made while rendering kept starting new batches; the chain hit the depth limit and this batch was not rendered";
+        }
         // 配線の死（解決しないパス）と隔離された適用失敗も、ランタイムが console に
         // 出すだけで続行する ＝ 見ていなければ気づけない種類なので warn に乗せる。
         if (entry.kind === "path-unresolved" || entry.kind === "binding-apply-error") {