@wcstack/state 3.3.0 → 3.4.0

package/dist/split/chunks/version.js

@@ -1,2 +1,2 @@
-const o="3.3.0";export{o as V};
+const o="3.4.0";export{o as V};
 //# sourceMappingURL=version.js.map

package/dist/split/core.d.ts

@@ -92,6 +92,25 @@ interface IStateProxy extends IState {
 }
 type Mutability = "readonly" | "writable";
 
+type ParseBindTextResult = IParsedBinding;
+
+/**
+ * パース結果の変換フック（Phase 2 のマウント — impl-plan §3-0 の 1）。
+ * マウントされたスコープの収集は、これで各パース結果を親ツリーの絶対パスへ書き換える。
+ * `uuid` を持つエントリ（構造フラグメントの参照）には掛けない — フラグメント側の
+ * パース結果は登録時（collectStructuralFragments）に変換済みで、二重に掛けると
+ * 接頭辞が二重になる。
+ */
+type ParseResultTransform = (parsed: ParseBindTextResult, forPath?: string) => ParseBindTextResult;
+interface IDeferredSpreadEntry {
+    readonly node: Node;
+    readonly tagName: string;
+    readonly parseResults: ParseBindTextResult[];
+    readonly transform?: ParseResultTransform;
+    /** 予約中の定義待ちの取り消し（`scheduleDeferredSpreads` が持つ。行の活性化し直しで待ちを重ねない） */
+    cancel?: () => void;
+}
+
 interface IContent {
     readonly firstNode: Node | null;
     readonly lastNode: Node | null;
@@ -111,6 +130,11 @@ interface IContent {
      * 従来経路（deactivate + unmount）で解体する。
      */
     tryDestroy(): boolean;
+    /**
+     * まだ展開していない、未定義カスタム要素への spread（#330）。持つ行だけに付く（形を増やさない）。
+     * 活性化のたびに定義待ちへ予約し、展開したものは外れる
+     */
+    spreads?: IDeferredSpreadEntry[];
 }
 
 /**
@@ -651,6 +675,36 @@ interface IAbsoluteStateAddress {
 }
 
 type BindingType = 'text' | 'prop' | 'event' | 'for' | 'if' | 'elseif' | 'else' | 'radio' | 'checkbox' | 'spread';
+/**
+ * 文法の段が読むフィルタ（名前と引数だけ。要件 D16）。実関数は束縛計画の段で
+ * 登録簿から解決される（`core/filterRegistry.ts`）ので、パース結果はここで止まる。
+ */
+interface IParsedFilter {
+    readonly filterName: string;
+    readonly args: string[];
+    /**
+     * 引数の型付きの値（要件 B9）。引用符の無い `true` / `false` / `null` / 数値は型付き、引用符付きは
+     * 文字列のまま。`args` は引用符を外した原文（書式フィルタはこちらを読む）。組み立てた側が省略したら
+     * `args` と同じ扱い。
+     */
+    readonly literals?: readonly unknown[];
+}
+/**
+ * バインディング式のパース結果（DOM 非依存の部分）。`@wcstack/state/parser` の
+ * ParseBindTextResult がこれをそのまま公開するため、Node 等の DOM lib 型を
+ * ここに足してはならない（足すなら IBindingInfo 側へ）。
+ */
+interface IParsedBinding {
+    readonly propName: string;
+    readonly propSegments: string[];
+    readonly propModifiers: string[];
+    readonly statePathName: string;
+    readonly statePathInfo: IPathInfo;
+    readonly inFilters: IParsedFilter[];
+    readonly outFilters: IParsedFilter[];
+    readonly bindingType: BindingType;
+    readonly uuid?: string | null;
+}
 
 interface IState {
     [key: string]: any;

package/dist/split/core.js

@@ -1,2 +1,2 @@
-import{s as t}from"./chunks/filterRegistry.js";export{g as getConfig}from"./chunks/filterRegistry.js";import{r as o}from"./chunks/binder.js";export{T as TRUSTED_TYPES_POLICY_SLOT,b as buildBindings,g as getBindingsReady,a as getTrustedTypesPolicy,s as setTrustedTypesPolicy}from"./chunks/binder.js";import{r as n}from"./chunks/registerComponents.js";export{V as VERSION}from"./chunks/version.js";import"./chunks/errorGuidance.js";import"./chunks/pathDiagnostics.js";import"./chunks/lifecycleHooks.js";import"./chunks/declarationAliases.js";import"./chunks/setAll.js";import"./chunks/getAllPropertyDescriptors.js";import"./chunks/checkDependency.js";import"./chunks/declarationHooks.js";import"./chunks/diagnosticsHooks.js";function e(s){if("string"==typeof s?.locale)return s;const t=function(){const s=document.documentElement?.lang;if(s)try{return Intl.getCanonicalLocales(s),s}catch{return void console.warn(`[@wcstack/state] <html lang="${s}"> is not a valid BCP-47 language tag. Falling back to the default locale for filters.`)}}();return void 0===t?s:{...s,locale:t}}function r(s,r){const i=e(s);i&&t(i),n(r),o()}function i(s){for(let t=0;t<s.length;t++)s[t].install()}function c(s){return s}export{r as bootstrapState,c as defineState,i as installFeatures};
+import{s as t}from"./chunks/filterRegistry.js";export{g as getConfig}from"./chunks/filterRegistry.js";import{r as o}from"./chunks/binder.js";export{T as TRUSTED_TYPES_POLICY_SLOT,b as buildBindings,g as getBindingsReady,a as getTrustedTypesPolicy,s as setTrustedTypesPolicy}from"./chunks/binder.js";import{r as n}from"./chunks/registerComponents.js";export{V as VERSION}from"./chunks/version.js";import"./chunks/errorGuidance.js";import"./chunks/pathDiagnostics.js";import"./chunks/lifecycleHooks.js";import"./chunks/declarationAliases.js";import"./chunks/setAll.js";import"./chunks/checkDependency.js";import"./chunks/getAllPropertyDescriptors.js";import"./chunks/declarationHooks.js";import"./chunks/diagnosticsHooks.js";function e(s){if("string"==typeof s?.locale)return s;const t=function(){const s=document.documentElement?.lang;if(s)try{return Intl.getCanonicalLocales(s),s}catch{return void console.warn(`[@wcstack/state] <html lang="${s}"> is not a valid BCP-47 language tag. Falling back to the default locale for filters.`)}}();return void 0===t?s:{...s,locale:t}}function r(s,r){const i=e(s);i&&t(i),n(r),o()}function i(s){for(let t=0;t<s.length;t++)s[t].install()}function c(s){return s}export{r as bootstrapState,c as defineState,i as installFeatures};
 //# sourceMappingURL=core.js.map

package/dist/split/features/devtools.js

@@ -1,2 +1,2 @@
-import{c as e,f as t,i as n}from"../chunks/filterRegistry.js";import{K as s,d as o,L as r}from"../chunks/pathDiagnostics.js";import{aR as i,K as a,S as c,aS as l,aT as u,aU as d,f,aV as m,F as h}from"../chunks/binder.js";import{g as p}from"../chunks/featureBridge.js";import{r as g}from"../chunks/errorGuidance.js";import{V as y}from"../chunks/version.js";const k=/^\s*@@\s*(.*?)\s*:\s*(.+?)\s*$/;function v(e,t,n,s){return{node:e,propName:t.propName,statePathName:t.statePathName,bindingType:t.bindingType,inFilters:t.inFilters,outFilters:t.outFilters,origin:n,raw:s}}function S(n){const s=[],o=new Set,r=new Set,u=e=>{const n=function(e){const n=`${t(e.inFilters)}\0${t(e.outFilters)}`;return[e.statePathName,e.propName,e.bindingType,n].join("\0")}(e);o.has(n)||(o.add(n),s.push(e))},d=e=>{if(r.has(e))return;r.add(e);const t=c(e);if(null!==t)for(const e of t.nodeInfos)for(const t of e.parseBindTextResults)u(v(null,t,"fragment","")),null!=t.uuid&&d(t.uuid)},f=(n.ownerDocument??n).createTreeWalker(n,NodeFilter.SHOW_ELEMENT|NodeFilter.SHOW_COMMENT);for(let t=f.nextNode();null!==t;t=f.nextNode()){if(t.nodeType===Node.ELEMENT_NODE){const n=t,s=n.getAttribute(e.bindAttributeName);if(null===s||0===s.length)continue;try{const e=i(n,a(s));for(const t of e)u(v(n,t,"attribute",s))}catch{}continue}const n=k.exec(t.data.trim());if(null===n)continue;const s=n[1]||e.commentTextPrefix,o=n[2],r=c(o);if(null===r){if(s===e.commentTextPrefix)try{u(v(t,l(o),"comment",o))}catch{}}else u(v(t,r.parseBindTextResult,"comment",o)),d(o)}return s}const N="__WCSTACK_DEVTOOLS_HOOK__";function T(){const e=globalThis,t=e[N];if(void 0!==t)return 2!==t.version&&console.warn(`[wcstack/state] devtools hook registry version mismatch: found ${t.version}, expected 2. Keeping the existing registry (first-wins).`),t;const n=function(){const e=new Map,t=new Set,n=e=>{if(0===t.size)return void e._setSink(null);const n=e.id;e._setSink(e=>{for(const s of t)s.onEvent?.(n,e)})};return{version:2,sources:e,register(s){if(!e.has(s.id)){e.set(s.id,s),n(s);for(const e of t)e.onSourceRegistered?.(s)}},unregister(n){const s=e.get(n);if(void 0!==s){s._setSink(null),e.delete(n);for(const e of t)e.onSourceUnregistered?.(n)}},addListener(s){t.add(s);for(const t of e.values())n(t),s.onSourceRegistered?.(t);return()=>{if(t.delete(s))for(const t of e.values())n(t)}}}}();return e[N]=n,n}const w=e=>{null!==o&&o({type:"state:update-batch",addresses:e})};function b(e){const t=null!==o;r(e);const n=null!==e;n&&!t?f(w,s):!n&&t&&m(w)}function P(e){return{rootNode:e.rootNode,element:e,paths:{list:e.listPaths,element:e.elementPaths,getter:e.getterPaths,setter:e.setterPaths},commandTokenNames:e.commandTokenNames,eventTokenNames:e.eventTokenNames,staticDependency:e.staticDependency,dynamicDependency:e.dynamicDependency,watchPaths:e.watchPaths??null,keyedListPaths:void 0===e.listKeys||null===e.listKeys?null:new Set(e.listKeys.keys())}}function _(e){return h(e)??g("devtools: no state tree on this root")}let x=null;function E(){if(n())return;if(null!==x)return;const e={id:"state:"+Math.random().toString(36).slice(2,10),kind:"state",packageVersion:y,getStateElements(){const e=[];for(const t of d())e.push(P(t));return e},overlays:e=>p(_(e)),keyedSubscriptions:e=>function(e){const t=u(e);if(null===t)return[];const n=new Set([...t.byPath.keys(),...t.tracked]);if(void 0!==t.watchers)for(const e of t.watchers.keys())n.add(e);const s=[];for(const e of[...n].sort()){const n=t.byPath.get(e);let o=0;if(void 0!==n)for(const e of n.values())o+=e.size;s.push({path:e,tracked:t.tracked.has(e),rows:o,keys:n?.size??0,lists:t.watchers?.get(e)?.size??0,lastValue:t.lastValue.get(e)})}return s}(_(e)),keys(e){const t=_(e),n=[];return t.createState("readonly",e=>{for(const t of Object.keys(e))if(!t.includes("*")&&!t.startsWith("$")){try{if("function"==typeof e[t])continue}catch{}n.push(t)}}),n},read(e,t,n){let s;return _(e).createState("readonly",e=>{s=e.$resolve(t,n??[])}),s},write(e,t,n,s){_(e).createState("writable",e=>{void 0!==s&&s.length>0?e.$resolve(t,s,n):e[t]=n})},getDeclaredBindings:e=>S(e),_setSink:b};x=e,T().register(e)}const D={name:"devtools",install(){E()}};export{D as default,D as devtools};
+import{c as e,f as t,i as n}from"../chunks/filterRegistry.js";import{L as s,d as o,O as r}from"../chunks/pathDiagnostics.js";import{bk as i,K as a,S as c,bl as l,bm as u,bn as d,f,bo as m,F as h}from"../chunks/binder.js";import{g as p}from"../chunks/featureBridge.js";import{r as g}from"../chunks/errorGuidance.js";import{V as y}from"../chunks/version.js";const k=/^\s*@@\s*(.*?)\s*:\s*(.+?)\s*$/;function v(e,t,n,s){return{node:e,propName:t.propName,statePathName:t.statePathName,bindingType:t.bindingType,inFilters:t.inFilters,outFilters:t.outFilters,origin:n,raw:s}}function S(n){const s=[],o=new Set,r=new Set,u=e=>{const n=function(e){const n=`${t(e.inFilters)}\0${t(e.outFilters)}`;return[e.statePathName,e.propName,e.bindingType,n].join("\0")}(e);o.has(n)||(o.add(n),s.push(e))},d=e=>{if(r.has(e))return;r.add(e);const t=c(e);if(null!==t)for(const e of t.nodeInfos)for(const t of e.parseBindTextResults)u(v(null,t,"fragment","")),null!=t.uuid&&d(t.uuid)},f=(n.ownerDocument??n).createTreeWalker(n,NodeFilter.SHOW_ELEMENT|NodeFilter.SHOW_COMMENT);for(let t=f.nextNode();null!==t;t=f.nextNode()){if(t.nodeType===Node.ELEMENT_NODE){const n=t,s=n.getAttribute(e.bindAttributeName);if(null===s||0===s.length)continue;try{const e=i(n,a(s));for(const t of e)u(v(n,t,"attribute",s))}catch{}continue}const n=k.exec(t.data.trim());if(null===n)continue;const s=n[1]||e.commentTextPrefix,o=n[2],r=c(o);if(null===r){if(s===e.commentTextPrefix)try{u(v(t,l(o),"comment",o))}catch{}}else u(v(t,r.parseBindTextResult,"comment",o)),d(o)}return s}const N="__WCSTACK_DEVTOOLS_HOOK__";function b(){const e=globalThis,t=e[N];if(void 0!==t)return 2!==t.version&&console.warn(`[wcstack/state] devtools hook registry version mismatch: found ${t.version}, expected 2. Keeping the existing registry (first-wins).`),t;const n=function(){const e=new Map,t=new Set,n=e=>{if(0===t.size)return void e._setSink(null);const n=e.id;e._setSink(e=>{for(const s of t)s.onEvent?.(n,e)})};return{version:2,sources:e,register(s){if(!e.has(s.id)){e.set(s.id,s),n(s);for(const e of t)e.onSourceRegistered?.(s)}},unregister(n){const s=e.get(n);if(void 0!==s){s._setSink(null),e.delete(n);for(const e of t)e.onSourceUnregistered?.(n)}},addListener(s){t.add(s);for(const t of e.values())n(t),s.onSourceRegistered?.(t);return()=>{if(t.delete(s))for(const t of e.values())n(t)}}}}();return e[N]=n,n}const w=e=>{null!==o&&o({type:"state:update-batch",addresses:e})};function T(e){const t=null!==o;r(e);const n=null!==e;n&&!t?f(w,s):!n&&t&&m(w)}function P(e){return{rootNode:e.rootNode,element:e,paths:{list:e.listPaths,element:e.elementPaths,getter:e.getterPaths,setter:e.setterPaths},commandTokenNames:e.commandTokenNames,eventTokenNames:e.eventTokenNames,staticDependency:e.staticDependency,dynamicDependency:e.dynamicDependency,watchPaths:e.watchPaths??null,keyedListPaths:void 0===e.listKeys||null===e.listKeys?null:new Set(e.listKeys.keys())}}function _(e){return h(e)??g("devtools: no state tree on this root")}let x=null;function E(){if(n())return;if(null!==x)return;const e={id:"state:"+Math.random().toString(36).slice(2,10),kind:"state",packageVersion:y,getStateElements(){const e=[];for(const t of d())e.push(P(t));return e},overlays:e=>p(_(e)),keyedSubscriptions:e=>function(e){const t=u(e);if(null===t)return[];const n=new Set([...t.byPath.keys(),...t.tracked]);if(void 0!==t.watchers)for(const e of t.watchers.keys())n.add(e);const s=[];for(const e of[...n].sort()){const n=t.byPath.get(e);let o=0;if(void 0!==n)for(const e of n.values())o+=e.size;s.push({path:e,tracked:t.tracked.has(e),rows:o,keys:n?.size??0,lists:t.watchers?.get(e)?.size??0,lastValue:t.lastValue.get(e)})}return s}(_(e)),keys(e){const t=_(e),n=[];return t.createState("readonly",e=>{for(const t of Object.keys(e))if(!t.includes("*")&&!t.startsWith("$")){try{if("function"==typeof e[t])continue}catch{}n.push(t)}}),n},read(e,t,n){let s;return _(e).createState("readonly",e=>{s=e.$resolve(t,n??[])}),s},write(e,t,n,s){_(e).createState("writable",e=>{void 0!==s&&s.length>0?e.$resolve(t,s,n):e[t]=n})},getDeclaredBindings:e=>S(e),_setSink:T};x=e,b().register(e)}const O={name:"devtools",install(){E()}};export{O as default,O as devtools};
 //# sourceMappingURL=devtools.js.map

package/dist/split/features/devtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.js","sources":["../../../../../src/devtools/declaredBindings.ts","../../../../../src/devtools/types.ts","../../../../../src/devtools/bridge.ts","../../../../../src/devtools/keyedSubscriptions.ts","../../../../../src/features/devtools.ts"],"sourcesContent":["/**\n * devtools/declaredBindings.ts — 宣言レベルのバインディング列挙\n * （IDevtoolsSource.getDeclaredBindings の実装・protocol v1 追補）。\n *\n * devtools 側の DOM 再スキャン（declaredScan — 「正本 bindTextParser に非追随」と\n * 自己申告する簡易パーサ）を置き換える正本実装。ランタイム自身のパーサと\n * fragment レジストリで答えるため:\n * - パース結果は実行時解釈と**同一**（複製パーサのドリフトが構造的に消える）\n * - DOM から引き上げられた構造テンプレート内部（for/if の中身）も列挙できる\n *   （DOM 再スキャンでは原理的に不可視だった領域）\n *\n * **戻り値は「宣言の集合」であり、インスタンスの multiset ではない**:\n * レンダリング済みページでは行クローンが `data-wcs` 属性とネストアンカー\n * （同一 UUID）を保持したまま live DOM に入るため、素朴な走査は宣言 1 件を\n * 行数分だけ重複列挙してしまう。ここでは宣言タプル（path / prop /\n * bindingType / フィルタ列）で dedupe し、宣言 1 件 = エントリ 1 件を保証する。\n * インスタンス粒度（どの行のどのノードか）は live の binding 台帳\n * （state:binding-added）の守備範囲で、こちらには持たせない。\n * 同一タプルの独立した静的宣言（同じバインディングを書いた別要素）も 1 件に\n * 畳まれる — node は最初に見つかったものを代表として持つ。\n *\n * fragment（構造テンプレート内部）は **rootNode 配下の live アンカーから到達可能な\n * UUID の推移閉包**として列挙する。ページ大域のレジストリを直接舐めないため、\n * 別 root の fragment や破棄済みビューの stale fragment は載らない。\n *\n * spread（`...:`）は attribute 起点では live Element の wcBindable から展開する\n * （設計 §5-1）。対象カスタム要素が未定義なら既存契約どおり spread のまま残す。\n *\n * **既知の盲点（時系列依存）**: 構造テンプレート外のテキストバインディングは、\n * binding start がコメントアンカーを空 Text に差し替えるため、**活性化後の DOM\n * から消えて列挙に現れない**（mustache は変換前も素の Text で不可視）。早期\n * アタッチ時は live 台帳（binding-added）が同領域を持つ。遅延アタッチでは\n * declared / live のどちらからも見えない — protocol §6 の既知非対称の一部。\n *\n * エラーパス以外もフック接続時にしか呼ばれない pull API であり、ホットパスには\n * 乗らない。壊れた宣言（不正 bindText）はエントリを捨てて先へ進む（検査は lint の\n * 責務 — ここは観測面）。\n */\n\nimport { config } from \"../config\";\nimport { parseBindTextsForElement } from \"../bindTextParser/parseBindTextsForElement\";\nimport { parseBindTextForEmbeddedNode } from \"../bindTextParser/parseBindTextForEmbeddedNode\";\nimport { expandSpread } from \"../bindTextParser/expandSpread\";\nimport { getFragmentInfoByUUID } from \"../structural/fragmentInfoByUUID\";\nimport { filterListKey } from \"../binding/filterKey\";\nimport { ParseBindTextResult } from \"../bindTextParser/types\";\nimport { IDeclaredBindingInfo } from \"./types\";\n\n// bindings/parseCommentNode.ts の EMBEDDED_REGEX と同形（keyword を自前で保持する\n// ために複製する — parseCommentNode は keyword を捨てて値しか返さないため、\n// 「未登録の構造アンカー（SSR pre-hydration ウィンドウ等）」と「埋め込みテキスト」\n// を区別できず、UUID をパスとして誤パースした bogus エントリが生まれる）。\nconst COMMENT_PATTERN = /^\\s*@@\\s*(.*?)\\s*:\\s*(.+?)\\s*$/;\n\nfunction declarationKey(info: IDeclaredBindingInfo): string {\n  // 引数は型付きの値で書き出す（要件 B9）— `defaults(0)` と `defaults('0')` を同じ宣言に畳まない。\n  // 入力フィルタと出力フィルタは**別の成分**にする: 連結すると `value|trim: memo`（入力）と\n  // `value: memo|trim`（出力）が同じ鍵になり、片方が宣言集合から黙って落ちる\n  const filters = `${filterListKey(info.inFilters)}\\u0000${filterListKey(info.outFilters)}`;\n  return [info.statePathName, info.propName, info.bindingType, filters].join(\"\\u0000\");\n}\n\nfunction toInfo(\n  node: Node | null,\n  parsed: ParseBindTextResult,\n  origin: IDeclaredBindingInfo[\"origin\"],\n  raw: string,\n): IDeclaredBindingInfo {\n  return {\n    node,\n    propName: parsed.propName,\n    statePathName: parsed.statePathName,\n    bindingType: parsed.bindingType,\n    inFilters: parsed.inFilters,\n    outFilters: parsed.outFilters,\n    origin,\n    raw,\n  };\n}\n\n/**\n * rootNode 配下の live DOM と、そこから到達可能な fragment から宣言集合を列挙する。\n * ヘッダの規定（宣言集合 / 到達閉包 / spread 展開 / テキストの盲点）を参照。\n */\nexport function collectDeclaredBindings(rootNode: Node): IDeclaredBindingInfo[] {\n  const out: IDeclaredBindingInfo[] = [];\n  const seenKeys = new Set<string>();\n  const visitedFragments = new Set<string>();\n\n  const push = (info: IDeclaredBindingInfo): void => {\n    const key = declarationKey(info);\n    if (seenKeys.has(key)) return;\n    seenKeys.add(key);\n    out.push(info);\n  };\n\n  /** fragment の内部宣言を emit し、ネストした構造アンカーへ再帰する（到達閉包）。 */\n  const visitFragment = (uuid: string): void => {\n    if (visitedFragments.has(uuid)) return;\n    visitedFragments.add(uuid);\n    const fragmentInfo = getFragmentInfoByUUID(uuid);\n    if (fragmentInfo === null) return;\n    for (const nodeInfo of fragmentInfo.nodeInfos) {\n      for (const parsed of nodeInfo.parseBindTextResults) {\n        push(toInfo(null, parsed, \"fragment\", \"\"));\n        if (parsed.uuid != null) {\n          visitFragment(parsed.uuid);\n        }\n      }\n    }\n  };\n\n  const doc = rootNode.ownerDocument ?? (rootNode as Document);\n  const walker = doc.createTreeWalker(\n    rootNode,\n    NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_COMMENT,\n  );\n\n  for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) {\n    if (node.nodeType === Node.ELEMENT_NODE) {\n      const element = node as Element;\n      const bindText = element.getAttribute(config.bindAttributeName);\n      if (bindText === null || bindText.length === 0) continue;\n      try {\n        // spread は live Element の wcBindable から展開（未定義要素は spread のまま = 既存契約）\n        const results = expandSpread(element, parseBindTextsForElement(bindText));\n        for (const parsed of results) {\n          push(toInfo(element, parsed, \"attribute\", bindText));\n        }\n      } catch {\n        // 不正な宣言は観測面では捨てる（検査は lint / ランタイム raiseError の責務）\n      }\n      continue;\n    }\n    // コメントアンカー: 構造ディレクティブ（UUID → fragment 登録済み）または\n    // 埋め込みテキストバインディング。\n    const match = COMMENT_PATTERN.exec((node as Comment).data.trim());\n    if (match === null) continue;\n    const keyword = match[1] || config.commentTextPrefix;\n    const value = match[2];\n    const fragmentInfo = getFragmentInfoByUUID(value);\n    if (fragmentInfo !== null) {\n      push(toInfo(node, fragmentInfo.parseBindTextResult, \"comment\", value));\n      visitFragment(value);\n      continue;\n    }\n    if (keyword !== config.commentTextPrefix) {\n      // 構造アンカーなのに fragment 未登録（SSR の pre-hydration ウィンドウ等）、\n      // または未知 keyword — UUID や不明値をパスとして誤パースしない。\n      continue;\n    }\n    try {\n      push(toInfo(node, parseBindTextForEmbeddedNode(value), \"comment\", value));\n    } catch {\n      // 同上\n    }\n  }\n\n  return out;\n}\n","/**\n * devtools/types.ts\n *\n * DevTools Hook Protocol (docs/devtools-hook-protocol.md) の型定義。\n *\n * イベント payload はランタイム内部オブジェクト（IAbsoluteStateAddress /\n * IBindingInfo 等）への生参照を含む（同一 realm・オーバーレイ前提、protocol 原則 4）。\n * 消費者はこれらを変異してはならない。\n */\n\nimport type { IAbsoluteStateAddress } from \"../address/types\";\nimport type { IBindingInfo } from \"../binding/types\";\nimport type { IStateElement } from \"../components/types\";\n\n/** グローバル registry のプロパティ名 */\nexport const DEVTOOLS_HOOK_GLOBAL = \"__WCSTACK_DEVTOOLS_HOOK__\";\n\n/** プロトコル版。additive change では上げない（protocol §2） */\nexport const DEVTOOLS_PROTOCOL_VERSION = 2;\n\nexport type DevtoolsEvent =\n  | {\n      readonly type: \"state:element-registered\";\n      readonly rootNode: Node;\n      readonly element: IStateElement;\n    }\n  | {\n      readonly type: \"state:element-unregistered\";\n      readonly rootNode: Node;\n      readonly element: IStateElement;\n    }\n  | {\n      readonly type: \"state:write\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly value: unknown;\n      /** same-value guard が既に取得していた場合のみ意味を持つ（protocol §4.2） */\n      readonly oldValue: unknown;\n      readonly hasOldValue: boolean;\n    }\n  | {\n      readonly type: \"state:update-batch\";\n      readonly addresses: ReadonlySet<IAbsoluteStateAddress>;\n    }\n  | {\n      readonly type: \"state:binding-added\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly binding: IBindingInfo;\n    }\n  | {\n      readonly type: \"state:binding-removed\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly binding: IBindingInfo;\n    }\n  | {\n      readonly type: \"state:binding-cleared\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n    }\n  | {\n      readonly type: \"state:token-emit\";\n      readonly kind: \"command\" | \"event\";\n      readonly tokenName: string;\n      readonly args: readonly unknown[];\n      readonly subscriberCount: number;\n      /**\n       * 発火元ツリーの state 要素（protocol v2 追補 2026-09-05・additive）。\n       * registry（getOrCreate*Token）経由で作られた token だけが持つ — 直接生成された\n       * token や旧ランタイムの payload には無い（optional）。無い emit の実測は\n       * ツリー別に分けられないため、消費側は全ツリーの照会へ合算で残す。\n       */\n      readonly stateElement?: IStateElement;\n    }\n  | {\n      // `$watch` の実行中に throw した（docs/state-watch-hook-design.md §7-1）。\n      // watch は 1 バッチで N 個走り drain フックを他機能と共有するため、例外は\n      // watch 側で閉じる（console.error のみ）。それだと devtools から\n      // 「静かに握られた失敗」が見えないので、同じ地点からここにも流す。\n      readonly type: \"state:watch-error\";\n      /**\n       * throw 元。cur の評価（getter）とハンドラ本体では原因も直し方も違う。\n       * `$scan`（scan/scanReport.ts）は `evaluate`（source / 出力の読み）・`fold`（fold の throw・\n       * Promise の戻り値・接ぎ木で getter になった from）・`write`（出力の書き込み）を使う\n       */\n      readonly phase: \"prime\" | \"evaluate\" | \"handler\" | \"fold\" | \"write\";\n      /** `$watch` の宣言キー（ワイルドカードを含む生のパス）。`$scan` は `$scan.<出力名>` */\n      readonly path: string;\n      readonly error: unknown;\n    }\n  | {\n      // watch 起点の書き込み連鎖が深さ上限で打ち切られた（設計書 §7-2）。\n      // 値と binding 適用は巻き戻さない ＝ propagation:hop-limit と同じ姿勢。\n      readonly type: \"state:watch-chain-limit\";\n      readonly maxDepth: number;\n      /** 打ち切ったバッチに載っていたアドレスのパス（報告用） */\n      readonly paths: readonly string[];\n    }\n  | {\n      // `$watch` ハンドラの正常発火（state-watch-hook-design.md §11 で予約済み・\n      // static-wiring-dx-design.md §4 の配線カバレッジが消費）。値は載せない —\n      // 「宣言したのに一度も発火しない」の検出には発火の事実だけで足りる。\n      readonly type: \"state:watch-fired\";\n      /** `$watch` の宣言キー（ワイルドカードを含む生のパス） */\n      readonly path: string;\n      /**\n       * 発火元ツリーの state 要素（protocol v2 追補 2026-09-05・additive）。\n       * 複数ツリーが同名の watch パスを宣言するページで実測台帳をツリー別に\n       * 分けるための識別。旧ランタイムの payload には無い（optional）— 無い発火は\n       * 消費側が全ツリーの照会へ合算で残す。値を載せない契約（§4.3.1）は不変。\n       */\n      readonly stateElement?: IStateElement;\n    }\n  | {\n      // バインド / `$watch` の対象パスが state 上で解決しないと確定した\n      // （pathDiagnostics.ts）。ランタイムは console.warn に留めて続行するため、\n      // 「配線したのに黙って死んでいる」を devtools からも見えるようにする。\n      readonly type: \"state:path-unresolved\";\n      /** 書き手が書いた面。診断 code が binding / watch で変わる */\n      readonly source: \"binding\" | \"watch\" | \"scan\";\n      /** 宣言されたパス（ワイルドカードを含む生の文字列） */\n      readonly path: string;\n      /** 解決に失敗したセグメント */\n      readonly missingSegment: string;\n    }\n  | {\n      // binding 適用が throw したが、バッチの残りは続行した（apply/applyChangeFromBindings）。\n      // 例外を握らずに隔離した事実を観測可能にする（state:watch-error と同じ位置づけ）。\n      readonly type: \"state:binding-apply-error\";\n      /** バインディングの state パス（ワイルドカードを含む生の文字列） */\n      readonly path: string;\n      readonly bindingType: string;\n      readonly error: unknown;\n    }\n  | {\n      readonly type: \"propagation:suppressed\";\n      readonly reason: \"confirmation\" | \"visited-edge\";\n      readonly transactionId: number;\n      readonly edgeId: number;\n      readonly node: Node;\n      readonly member: string;\n    }\n  | {\n      readonly type: \"propagation:coalesced\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly droppedTransactionId: number;\n      readonly winnerTransactionId: number;\n    }\n  | {\n      readonly type: \"propagation:hop-limit\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly transactionId: number;\n      readonly hop: number;\n    }\n  // --- contract analyzer (Phase 5b, §6 contract category) ---\n  | {\n      // sidecar manifest から 1 コンポーネント契約を読んだ(dev-time analyzer)。\n      readonly type: \"contract:manifest-read\";\n      readonly tag: string;\n      /** 実行時に該当タグが登録済みか(未登録なら drift の起点)。 */\n      readonly loaded: boolean;\n    }\n  | {\n      // manifest の未知 namespace / extension(runtime analyzer が解釈しない)。\n      readonly type: \"contract:unsupported-extension\";\n      readonly namespace: string;\n    }\n  | {\n      // sidecar と live wcBindable 宣言の drift。live 宣言が正本。\n      readonly type: \"contract:drift\";\n      readonly reason: \"component-not-loaded\" | \"missing-member\" | \"event-mismatch\";\n      readonly tag: string;\n      readonly member?: string;\n      /** event-mismatch のとき: sidecar 宣言 event / live event。 */\n      readonly sidecarEvent?: string;\n      readonly liveEvent?: string;\n    };\n\nexport type DevtoolsSink = (event: DevtoolsEvent) => void;\n\n/** contract analyzer(Phase 5b)が生成しうる event だけの狭い union(公開 API の戻り型)。 */\nexport type ContractEvent = Extract<\n  DevtoolsEvent,\n  { readonly type: \"contract:manifest-read\" | \"contract:unsupported-extension\" | \"contract:drift\" }\n>;\n\n/** マウント記録 1 件の要約（overlays — protocol v2）。 */\nexport interface IMountOverlaySummary {\n  /** D20 の予約セグメント（`#m<id>`） */\n  readonly marker: string;\n  /** マウントされたコンポーネントのタグ名（小文字） */\n  readonly componentTag: string;\n  readonly stateProp: string;\n  /** マウント表: 内側接頭辞（空 = ルートエントリ）→ 外側パス */\n  readonly mountTable: readonly { readonly inner: string; readonly outer: string }[];\n  /** `$n` 補正の Δ（ルート接頭辞のワイルドカード数） */\n  readonly delta: number;\n  /** 私有キー（作者の own data key — オーバーレイ空間に住む） */\n  readonly privateKeys: readonly string[];\n  /** 公開 getter の公開パス（親スコープから読める・docs/state-overlay-export-design.md） */\n  readonly exports: readonly string[];\n  /** マーカーパスに載る getter のキー */\n  readonly getterKeys: readonly string[];\n}\n\n/**\n * 鍵付き購読（`$eq` / `$eqPath` / `$eqIndex`）の path 1 つ分の要約（keyedSubscriptions の要素 —\n * protocol v2 追補・additive、要件 D17）。取り出した時点の数えで、台帳への参照は持たない。\n */\nexport interface IKeyedSubscriptionSummary {\n  /** `$eq` 系の第 1 引数（選択を持つパス） */\n  readonly path: string;\n  /**\n   * `path` が getter かその下にあるので鍵付きで購読できず、追跡付きの読みに落ちた。`path` が\n   * 変わるたびに、それを読む getter がすべて再評価される（README「鍵付き選択」）\n   */\n  readonly tracked: boolean;\n  /** 行ごとの購読の数（`$eq` / `$eqPath`、`$eqIndex` の外側の段、行の外の getter） */\n  readonly rows: number;\n  /** 行ごとの購読が使っている鍵の数 */\n  readonly keys: number;\n  /** `$eqIndex` の最内段が置くリスト単位の監視の数（行ごとの購読を持たない） */\n  readonly lists: number;\n  /** `path` の最後に見た値（登録時か書き込み時）。見ていなければ undefined。生値（protocol 原則 4） */\n  readonly lastValue: unknown;\n}\n\nexport interface IStateElementSummary {\n  readonly rootNode: Node;\n  readonly element: IStateElement;\n  readonly paths: {\n    readonly list: ReadonlySet<string>;\n    readonly element: ReadonlySet<string>;\n    readonly getter: ReadonlySet<string>;\n    readonly setter: ReadonlySet<string>;\n  };\n  readonly commandTokenNames: ReadonlySet<string>;\n  readonly eventTokenNames: ReadonlySet<string>;\n  readonly staticDependency: ReadonlyMap<string, readonly string[]>;\n  readonly dynamicDependency: ReadonlyMap<string, readonly string[]>;\n  /**\n   * `$watch` の宣言パス集合（宣言なしは null）。protocol v1 追補（additive）—\n   * 配線カバレッジの「宣言面」（static-wiring-dx-design.md §4）。\n   */\n  readonly watchPaths: ReadonlySet<string> | null;\n  /**\n   * `$listKeys` で宣言されたリストパス集合（宣言なしは null）。protocol v1 追補\n   * （additive）— ワイルドカード行 watch に**リスト書き込み**が届く前提は\n   * 「for バインド or $listKeys 宣言」（state-watch-hook-design.md §6-3）なので、\n   * paths.list（for 由来）と合わせて初めてカバレッジの前提判定が正確になる\n   *（明示 index 書き込みは前提に依らず発火し得る）。\n   */\n  readonly keyedListPaths: ReadonlySet<string> | null;\n}\n\n/**\n * 宣言レベルのバインディング 1 件（getDeclaredBindings の要素）。\n * 正本パーサ（bindTextParser）の結果をそのまま流す — devtools 側の簡易パーサ\n * （declaredScan）が「bindTextParser 非追随」と自己申告していたドリフトの恒久解消。\n * filters は IFilterInfo の構造的サブセット（filterName / args）として読める。\n *\n * getDeclaredBindings の戻り値は**宣言の集合**（宣言タプルで dedupe 済み）であり、\n * レンダリング行数に比例したインスタンス列ではない。インスタンス粒度は live の\n * binding 台帳（state:binding-added）の守備範囲。\n */\n/** 宣言されたフィルタ 1 つ（`IParsedFilter` の devtools 向けの写し） */\nexport interface IDeclaredFilter {\n  readonly filterName: string;\n  readonly args: readonly string[];\n  /** 引数の型付きの値（要件 B9）。省略されたら `args` で代用される */\n  readonly literals?: readonly unknown[];\n}\n\nexport interface IDeclaredBindingInfo {\n  /**\n   * 宣言を代表するノード（要素またはコメントアンカー。同一宣言の複数出現は\n   * 最初に見つかったノード）。構造テンプレート内部の宣言（origin: 'fragment'）は\n   * live DOM にノードを持たないため null。\n   */\n  readonly node: Node | null;\n  readonly propName: string;\n  readonly statePathName: string;\n  readonly bindingType: string;\n  /**\n   * 宣言されたフィルタ。`literals`（引数の型付きの値・要件 B9）は宣言の同一判定\n   * （`binding/filterKey.ts`）が読む。型から落とすと、型どおりのオブジェクトを渡した瞬間に\n   * `defaults(0)` と `defaults('0')` が同じ宣言に畳まれる（`literals ?? args` のフォールバックで\n   * 黙って原文比較へ落ちるため）。\n   */\n  readonly inFilters: readonly IDeclaredFilter[];\n  readonly outFilters: readonly IDeclaredFilter[];\n  readonly origin: \"attribute\" | \"comment\" | \"fragment\";\n  /**\n   * 宣言の原文。構造ディレクティブのアンカー（origin: 'comment'）は原文が DOM に\n   * 残らないためレジストリ UUID、fragment 由来は空文字。\n   */\n  readonly raw: string;\n}\n\nexport interface IDevtoolsSource {\n  readonly id: string;\n  readonly kind: \"state\";\n  readonly packageVersion: string;\n  getStateElements(): IStateElementSummary[];\n  /**\n   * state のトップレベルキー（データプロパティ + 実行可能な getter）を列挙する。\n   * メソッド・`$` 始まり・ワイルドカードを含むキーは除外。\n   * 状態ツリー UI の描画起点（protocol §3）。\n   */\n  keys(rootNode: Node): string[];\n  /**\n   * rootNode のツリーに載っているマウント記録の列挙（protocol v2 — D20 の可視化）。\n   * マーカー（`#m<id>`）ごとに、マウント表と私有面（オーバーレイ専用アドレス空間に\n   * 住むキー）を出す。マウントが無ければ空配列。\n   */\n  overlays(rootNode: Node): IMountOverlaySummary[];\n  /**\n   * rootNode のツリーの鍵付き購読を path ごとに要約する（protocol v2 追補・additive、要件 D17）。\n   * 購読は依存グラフの動的な変化なので、イベントではなくここで取る（protocol §4.6）。\n   * 一度も `$eq` 系が評価されていなければ空配列。\n   */\n  keyedSubscriptions(rootNode: Node): IKeyedSubscriptionSummary[];\n  read(rootNode: Node, path: string, indexes?: number[]): unknown;\n  write(rootNode: Node, path: string, value: unknown, indexes?: number[]): void;\n  /**\n   * rootNode 配下の宣言レベルのバインディングを正本パーサで列挙する\n   * （protocol v1 追補・additive）。live DOM（属性 + コメントアンカー）に加え、\n   * DOM から引き上げられた構造テンプレート内部（fragment レジストリ）も含む —\n   * DOM 再スキャン方式の declared ビューでは原理的に見えなかった領域。\n   */\n  getDeclaredBindings(rootNode: Node): IDeclaredBindingInfo[];\n  /** registry 専用。listener の有無に応じて registry が差し替える */\n  _setSink(sink: DevtoolsSink | null): void;\n}\n\nexport interface IDevtoolsListener {\n  onSourceRegistered?(source: IDevtoolsSource): void;\n  onSourceUnregistered?(sourceId: string): void;\n  onEvent?(sourceId: string, event: DevtoolsEvent): void;\n}\n\nexport interface IDevtoolsHookRegistry {\n  readonly version: number;\n  readonly sources: Map<string, IDevtoolsSource>;\n  register(source: IDevtoolsSource): void;\n  unregister(sourceId: string): void;\n  /** 戻り値は解除関数。既登録 source は onSourceRegistered で即時リプレイされる */\n  addListener(listener: IDevtoolsListener): () => void;\n}\n","/**\n * devtools/bridge.ts\n *\n * DevTools Hook Protocol (docs/devtools-hook-protocol.md) の state 側実装。\n *\n * - registry 最小実装: `globalThis.__WCSTACK_DEVTOOLS_HOOK__` を create-if-missing で\n *   確保する（ロード順非依存・先勝ち。devtools 側 client も同一仕様の実装を持つ）。\n * - source: この state モジュールコピーを 1 source として登録する。同一ページに\n *   コピーが複数あれば複数 source になる（正常系、protocol §5）。\n * - sink 切替: listener の有無に応じて registry が `_setSink` を呼び、ここで\n *   updater の drain リスナー登録/解除も連動させる（protocol §4.3）。\n */\n\nimport { inSsr } from \"../config\";\nimport { DEVTOOLS_LISTENER_PRIORITY } from \"../define\";\nimport { getStateElement, getLiveStateElements } from \"../stateElementByName\";\n// スコープ機能のコードは静的 import しない（要件 B13 — devtools だけのページに\n// `webComponent/*` が乗る）。受け口は bridge/featureBridge.ts で、scopes の install が置く\nimport { getMountOverlays } from \"../bridge/featureBridge\";\nimport { registerUpdateBatchListener, unregisterUpdateBatchListener, UpdateBatchListener } from \"../updater/updater\";\nimport { raiseError } from \"../raiseError\";\nimport { VERSION } from \"../version\";\nimport { IStateElement } from \"../components/types\";\nimport { collectDeclaredBindings } from \"./declaredBindings\";\nimport { collectKeyedSubscriptions } from \"./keyedSubscriptions\";\nimport { devtoolsSink, setDevtoolsSink } from \"../platform/devtoolsSink\";\nimport {\n  DEVTOOLS_HOOK_GLOBAL,\n  DEVTOOLS_PROTOCOL_VERSION,\n  DevtoolsSink,\n  IDevtoolsHookRegistry,\n  IDevtoolsListener,\n  IDevtoolsSource,\n  IStateElementSummary,\n  IMountOverlaySummary,\n} from \"./types\";\n\n/**\n * registry の最小実装（protocol §2）。30 行程度に抑え、振る舞いは\n * 「source/listener の管理と sink の配線」のみ。台帳・整形は devtools 側の責務。\n */\nfunction createMinimalRegistry(): IDevtoolsHookRegistry {\n  const sources = new Map<string, IDevtoolsSource>();\n  const listeners = new Set<IDevtoolsListener>();\n  const applySink = (source: IDevtoolsSource): void => {\n    if (listeners.size === 0) {\n      source._setSink(null);\n      return;\n    }\n    const sourceId = source.id;\n    source._setSink((event) => {\n      for (const listener of listeners) {\n        listener.onEvent?.(sourceId, event);\n      }\n    });\n  };\n  return {\n    version: DEVTOOLS_PROTOCOL_VERSION,\n    sources,\n    register(source: IDevtoolsSource): void {\n      if (sources.has(source.id)) {\n        return;\n      }\n      sources.set(source.id, source);\n      applySink(source);\n      for (const listener of listeners) {\n        listener.onSourceRegistered?.(source);\n      }\n    },\n    unregister(sourceId: string): void {\n      const source = sources.get(sourceId);\n      if (source === undefined) {\n        return;\n      }\n      source._setSink(null);\n      sources.delete(sourceId);\n      for (const listener of listeners) {\n        listener.onSourceUnregistered?.(sourceId);\n      }\n    },\n    addListener(listener: IDevtoolsListener): () => void {\n      listeners.add(listener);\n      // 既登録 source をリプレイ（遅延アタッチの起点、protocol §6）\n      for (const source of sources.values()) {\n        applySink(source);\n        listener.onSourceRegistered?.(source);\n      }\n      return () => {\n        if (!listeners.delete(listener)) {\n          return;\n        }\n        for (const source of sources.values()) {\n          applySink(source);\n        }\n      };\n    },\n  };\n}\n\nexport function getOrCreateHookRegistry(): IDevtoolsHookRegistry {\n  const globals = globalThis as unknown as Record<string, unknown>;\n  const existing = globals[DEVTOOLS_HOOK_GLOBAL] as IDevtoolsHookRegistry | undefined;\n  if (existing !== undefined) {\n    if (existing.version !== DEVTOOLS_PROTOCOL_VERSION) {\n      // 先勝ち固定。振る舞いは差し替えない（protocol §2）\n      console.warn(\n        `[wcstack/state] devtools hook registry version mismatch: found ${existing.version}, expected ${DEVTOOLS_PROTOCOL_VERSION}. Keeping the existing registry (first-wins).`\n      );\n    }\n    return existing;\n  }\n  const registry = createMinimalRegistry();\n  globals[DEVTOOLS_HOOK_GLOBAL] = registry;\n  return registry;\n}\n\n/**\n * drain 終了バッチの転送リスナー。sink 接続中のみ updater に登録される。\n */\nconst onUpdateBatch: UpdateBatchListener = (batch) => {\n  if (devtoolsSink !== null) {\n    devtoolsSink({ type: \"state:update-batch\", addresses: batch });\n  }\n};\n\n/**\n * registry からの sink 差し替え。updater の drain リスナー登録/解除を連動させる。\n * detach 時に登録が残らないこと（protocol §7-2）。\n */\nfunction setSink(sink: DevtoolsSink | null): void {\n  const wasActive = devtoolsSink !== null;\n  setDevtoolsSink(sink);\n  const isActive = sink !== null;\n  if (isActive && !wasActive) {\n    // `$watch` / `$streams` restart より先に流す（protocol §4.3）。優先度を省略しても\n    // 既定 0 で結果は同じだが、それは偶然なので定数で意図を固定する。\n    registerUpdateBatchListener(onUpdateBatch, DEVTOOLS_LISTENER_PRIORITY);\n  } else if (!isActive && wasActive) {\n    unregisterUpdateBatchListener(onUpdateBatch);\n  }\n}\n\nfunction createStateElementSummary(element: IStateElement): IStateElementSummary {\n  return {\n    rootNode: element.rootNode,\n    element,\n    paths: {\n      list: element.listPaths,\n      element: element.elementPaths,\n      getter: element.getterPaths,\n      setter: element.setterPaths,\n    },\n    commandTokenNames: element.commandTokenNames,\n    eventTokenNames: element.eventTokenNames,\n    staticDependency: element.staticDependency,\n    dynamicDependency: element.dynamicDependency,\n    // protocol v1 追補（additive）— 配線カバレッジの宣言面（設計 §4）。\n    // 旧 IStateElement 実装（optional）では undefined になりうるため null に畳む。\n    watchPaths: element.watchPaths ?? null,\n    // ワイルドカード行 watch の発火前提「for バインド or $listKeys 宣言」の後者。\n    // ListKeyMap のキー（リストパス）だけを出す — キー指定（文字列/関数）は\n    // カバレッジ判定に不要で、関数はシリアライズ境界にも載せない。\n    keyedListPaths:\n      element.listKeys === undefined || element.listKeys === null\n        ? null\n        : new Set(element.listKeys.keys()),\n  };\n}\n\nfunction requireStateElement(rootNode: Node): IStateElement {\n  return getStateElement(rootNode) ??\n    raiseError(`devtools: no state tree on this root`);\n}\n\nfunction createSourceId(): string {\n  // getUUID() はモジュールローカル連番のため、state コピーが複数ある\n  // ページで source id が衝突する。ランダム採番で回避する。\n  return \"state:\" + Math.random().toString(36).slice(2, 10);\n}\n\nlet registeredSource: IDevtoolsSource | null = null;\n\n/**\n * この state ランタイムを 1 source として registry に登録する。\n * bootstrapState() から呼ばれる。冪等・SSR では何もしない（protocol 原則 6）。\n */\nexport function registerDevtoolsSource(): void {\n  if (inSsr()) {\n    return;\n  }\n  if (registeredSource !== null) {\n    return;\n  }\n  const source: IDevtoolsSource = {\n    id: createSourceId(),\n    kind: \"state\",\n    packageVersion: VERSION,\n    getStateElements(): IStateElementSummary[] {\n      const summaries: IStateElementSummary[] = [];\n      for (const element of getLiveStateElements()) {\n        summaries.push(createStateElementSummary(element));\n      }\n      return summaries;\n    },\n    overlays(rootNode: Node): IMountOverlaySummary[] {\n      // スコープ機能が入っていないページにマウントは存在しえない（受け口が空なら空配列）\n      return getMountOverlays(requireStateElement(rootNode));\n    },\n    keyedSubscriptions(rootNode: Node) {\n      return collectKeyedSubscriptions(requireStateElement(rootNode));\n    },\n    keys(rootNode: Node): string[] {\n      const element = requireStateElement(rootNode);\n      const result: string[] = [];\n      element.createState(\"readonly\", (state) => {\n        // Object.keys は Proxy の ownKeys 経由で target の own key を返す。\n        // メソッド判別の typeof アクセスは getter を 1 回実行する副作用があるため、\n        // ループ文脈依存で throw する getter は catch して「キーとしては存在する」\n        // 側に倒す（値の表示可否は UI 側の責務）。\n        for (const key of Object.keys(state)) {\n          if (key.includes(\"*\") || key.startsWith(\"$\")) {\n            continue;\n          }\n          try {\n            if (typeof (state as unknown as Record<string, unknown>)[key] === \"function\") {\n              continue;\n            }\n          } catch {\n            // 読めない getter もキーとしては列挙する\n          }\n          result.push(key);\n        }\n      });\n      return result;\n    },\n    read(rootNode: Node, path: string, indexes?: number[]): unknown {\n      const element = requireStateElement(rootNode);\n      let result: unknown;\n      element.createState(\"readonly\", (state) => {\n        result = (state as unknown as Record<string, (p: string, i: number[]) => unknown>)[\"$resolve\"](path, indexes ?? []);\n      });\n      return result;\n    },\n    write(rootNode: Node, path: string, value: unknown, indexes?: number[]): void {\n      const element = requireStateElement(rootNode);\n      element.createState(\"writable\", (state) => {\n        if (indexes !== undefined && indexes.length > 0) {\n          // 3 引数の $resolve は値が undefined でも書き（引数の個数で読み書きを分ける — 要件 B7）\n          (state as unknown as Record<string, (p: string, i: number[], v: unknown) => void>)[\"$resolve\"](path, indexes, value);\n        } else {\n          (state as unknown as Record<string, unknown>)[path] = value;\n        }\n      });\n    },\n    getDeclaredBindings(rootNode: Node) {\n      return collectDeclaredBindings(rootNode);\n    },\n    _setSink: setSink,\n  };\n  registeredSource = source;\n  getOrCreateHookRegistry().register(source);\n}\n\n/**\n * テスト専用: sink を解除し source 登録状態をリセットする。\n * グローバル registry 自体の掃除（delete globalThis[DEVTOOLS_HOOK_GLOBAL]）は\n * テスト側の責務。アプリケーションからの利用は想定しない。\n */\nexport function __resetDevtoolsBridgeForTest(): void {\n  setSink(null);\n  registeredSource = null;\n}\n\n/** テスト専用: 現在登録済みの source を返す */\nexport function __getRegisteredSourceForTest(): IDevtoolsSource | null {\n  return registeredSource;\n}\n","/**\n * devtools/keyedSubscriptions.ts\n *\n * DevTools Hook Protocol の `keyedSubscriptions(rootNode)`（protocol v2 追補・要件 D17）。\n * 鍵付き購読（`$eq` / `$eqPath` / `$eqIndex`）の台帳を path ごとに数えて返す。\n *\n * 購読は描画のたびに行単位で増減する依存グラフの動的な変化なので、イベントでは流さず\n * pull で取る（protocol §4.6。1 万行の描画で 1 万件のイベントにしない）。数えるのは\n * 呼ばれた時点だけで、台帳への参照は返さない。このモジュールは devtools 機能だけが\n * import する — core は台帳を読ませるアクセサしか持たない。\n */\n\nimport { IStateElement } from \"../components/types\";\nimport { getKeyedLedgerView } from \"../dependency/keyedDependency\";\nimport { IKeyedSubscriptionSummary } from \"./types\";\n\nexport function collectKeyedSubscriptions(stateElement: IStateElement): IKeyedSubscriptionSummary[] {\n  const view = getKeyedLedgerView(stateElement);\n  if (view === null) {\n    return [];\n  }\n  const paths = new Set<string>([...view.byPath.keys(), ...view.tracked]);\n  if (typeof view.watchers !== \"undefined\") {\n    for (const path of view.watchers.keys()) {\n      paths.add(path);\n    }\n  }\n  const summaries: IKeyedSubscriptionSummary[] = [];\n  for (const path of [...paths].sort()) {\n    const keyMap = view.byPath.get(path);\n    let rows = 0;\n    if (typeof keyMap !== \"undefined\") {\n      for (const addresses of keyMap.values()) {\n        rows += addresses.size;\n      }\n    }\n    summaries.push({\n      path,\n      tracked: view.tracked.has(path),\n      rows,\n      keys: keyMap?.size ?? 0,\n      lists: view.watchers?.get(path)?.size ?? 0,\n      lastValue: view.lastValue.get(path),\n    });\n  }\n  return summaries;\n}\n","/**\n * features/devtools.ts — DevTools Hook Protocol への source 登録（@wcstack/state/features/devtools）。\n */\nimport type { IStateFeature } from \"../core/features\";\nimport { registerDevtoolsSource } from \"../devtools/bridge\";\n\nexport const devtools: IStateFeature = {\n  name: \"devtools\",\n  install(): void {\n    registerDevtoolsSource();\n  },\n};\nexport default devtools;\n"],"names":["COMMENT_PATTERN","toInfo","node","parsed","origin","raw","propName","statePathName","bindingType","inFilters","outFilters","collectDeclaredBindings","rootNode","out","seenKeys","Set","visitedFragments","push","info","key","filters","filterListKey","join","declarationKey","has","add","visitFragment","uuid","fragmentInfo","getFragmentInfoByUUID","nodeInfo","nodeInfos","parseBindTextResults","walker","ownerDocument","createTreeWalker","NodeFilter","SHOW_ELEMENT","SHOW_COMMENT","nextNode","nodeType","Node","ELEMENT_NODE","element","bindText","getAttribute","config","bindAttributeName","length","results","expandSpread","parseBindTextsForElement","match","exec","data","trim","keyword","commentTextPrefix","value","parseBindTextForEmbeddedNode","parseBindTextResult","DEVTOOLS_HOOK_GLOBAL","getOrCreateHookRegistry","globals","globalThis","existing","undefined","version","console","warn","registry","sources","Map","listeners","applySink","source","size","_setSink","sourceId","id","event","listener","onEvent","register","set","onSourceRegistered","unregister","get","delete","onSourceUnregistered","addListener","values","createMinimalRegistry","onUpdateBatch","batch","devtoolsSink","type","addresses","setSink","sink","wasActive","setDevtoolsSink","isActive","registerUpdateBatchListener","DEVTOOLS_LISTENER_PRIORITY","unregisterUpdateBatchListener","createStateElementSummary","paths","list","listPaths","elementPaths","getter","getterPaths","setter","setterPaths","commandTokenNames","eventTokenNames","staticDependency","dynamicDependency","watchPaths","keyedListPaths","listKeys","keys","requireStateElement","getStateElement","raiseError","registeredSource","registerDevtoolsSource","inSsr","Math","random","toString","slice","kind","packageVersion","VERSION","getStateElements","summaries","getLiveStateElements","overlays","getMountOverlays","keyedSubscriptions","stateElement","view","getKeyedLedgerView","byPath","tracked","watchers","path","sort","keyMap","rows","lists","lastValue","collectKeyedSubscriptions","result","createState","state","Object","includes","startsWith","read","indexes","write","getDeclaredBindings","devtools","name","install"],"mappings":"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"}
+{"version":3,"file":"devtools.js","sources":["../../../../../src/devtools/declaredBindings.ts","../../../../../src/devtools/types.ts","../../../../../src/devtools/bridge.ts","../../../../../src/devtools/keyedSubscriptions.ts","../../../../../src/features/devtools.ts"],"sourcesContent":["/**\n * devtools/declaredBindings.ts — 宣言レベルのバインディング列挙\n * （IDevtoolsSource.getDeclaredBindings の実装・protocol v1 追補）。\n *\n * devtools 側の DOM 再スキャン（declaredScan — 「正本 bindTextParser に非追随」と\n * 自己申告する簡易パーサ）を置き換える正本実装。ランタイム自身のパーサと\n * fragment レジストリで答えるため:\n * - パース結果は実行時解釈と**同一**（複製パーサのドリフトが構造的に消える）\n * - DOM から引き上げられた構造テンプレート内部（for/if の中身）も列挙できる\n *   （DOM 再スキャンでは原理的に不可視だった領域）\n *\n * **戻り値は「宣言の集合」であり、インスタンスの multiset ではない**:\n * レンダリング済みページでは行クローンが `data-wcs` 属性とネストアンカー\n * （同一 UUID）を保持したまま live DOM に入るため、素朴な走査は宣言 1 件を\n * 行数分だけ重複列挙してしまう。ここでは宣言タプル（path / prop /\n * bindingType / フィルタ列）で dedupe し、宣言 1 件 = エントリ 1 件を保証する。\n * インスタンス粒度（どの行のどのノードか）は live の binding 台帳\n * （state:binding-added）の守備範囲で、こちらには持たせない。\n * 同一タプルの独立した静的宣言（同じバインディングを書いた別要素）も 1 件に\n * 畳まれる — node は最初に見つかったものを代表として持つ。\n *\n * fragment（構造テンプレート内部）は **rootNode 配下の live アンカーから到達可能な\n * UUID の推移閉包**として列挙する。ページ大域のレジストリを直接舐めないため、\n * 別 root の fragment や破棄済みビューの stale fragment は載らない。\n *\n * spread（`...:`）は attribute 起点では live Element の wcBindable から展開する\n * （設計 §5-1）。対象カスタム要素が未定義なら既存契約どおり spread のまま残す。\n *\n * **既知の盲点（時系列依存）**: 構造テンプレート外のテキストバインディングは、\n * binding start がコメントアンカーを空 Text に差し替えるため、**活性化後の DOM\n * から消えて列挙に現れない**（mustache は変換前も素の Text で不可視）。早期\n * アタッチ時は live 台帳（binding-added）が同領域を持つ。遅延アタッチでは\n * declared / live のどちらからも見えない — protocol §6 の既知非対称の一部。\n *\n * エラーパス以外もフック接続時にしか呼ばれない pull API であり、ホットパスには\n * 乗らない。壊れた宣言（不正 bindText）はエントリを捨てて先へ進む（検査は lint の\n * 責務 — ここは観測面）。\n */\n\nimport { config } from \"../config\";\nimport { parseBindTextsForElement } from \"../bindTextParser/parseBindTextsForElement\";\nimport { parseBindTextForEmbeddedNode } from \"../bindTextParser/parseBindTextForEmbeddedNode\";\nimport { expandSpread } from \"../bindTextParser/expandSpread\";\nimport { getFragmentInfoByUUID } from \"../structural/fragmentInfoByUUID\";\nimport { filterListKey } from \"../binding/filterKey\";\nimport { ParseBindTextResult } from \"../bindTextParser/types\";\nimport { IDeclaredBindingInfo } from \"./types\";\n\n// bindings/parseCommentNode.ts の EMBEDDED_REGEX と同形（keyword を自前で保持する\n// ために複製する — parseCommentNode は keyword を捨てて値しか返さないため、\n// 「未登録の構造アンカー（SSR pre-hydration ウィンドウ等）」と「埋め込みテキスト」\n// を区別できず、UUID をパスとして誤パースした bogus エントリが生まれる）。\nconst COMMENT_PATTERN = /^\\s*@@\\s*(.*?)\\s*:\\s*(.+?)\\s*$/;\n\nfunction declarationKey(info: IDeclaredBindingInfo): string {\n  // 引数は型付きの値で書き出す（要件 B9）— `defaults(0)` と `defaults('0')` を同じ宣言に畳まない。\n  // 入力フィルタと出力フィルタは**別の成分**にする: 連結すると `value|trim: memo`（入力）と\n  // `value: memo|trim`（出力）が同じ鍵になり、片方が宣言集合から黙って落ちる\n  const filters = `${filterListKey(info.inFilters)}\\u0000${filterListKey(info.outFilters)}`;\n  return [info.statePathName, info.propName, info.bindingType, filters].join(\"\\u0000\");\n}\n\nfunction toInfo(\n  node: Node | null,\n  parsed: ParseBindTextResult,\n  origin: IDeclaredBindingInfo[\"origin\"],\n  raw: string,\n): IDeclaredBindingInfo {\n  return {\n    node,\n    propName: parsed.propName,\n    statePathName: parsed.statePathName,\n    bindingType: parsed.bindingType,\n    inFilters: parsed.inFilters,\n    outFilters: parsed.outFilters,\n    origin,\n    raw,\n  };\n}\n\n/**\n * rootNode 配下の live DOM と、そこから到達可能な fragment から宣言集合を列挙する。\n * ヘッダの規定（宣言集合 / 到達閉包 / spread 展開 / テキストの盲点）を参照。\n */\nexport function collectDeclaredBindings(rootNode: Node): IDeclaredBindingInfo[] {\n  const out: IDeclaredBindingInfo[] = [];\n  const seenKeys = new Set<string>();\n  const visitedFragments = new Set<string>();\n\n  const push = (info: IDeclaredBindingInfo): void => {\n    const key = declarationKey(info);\n    if (seenKeys.has(key)) return;\n    seenKeys.add(key);\n    out.push(info);\n  };\n\n  /** fragment の内部宣言を emit し、ネストした構造アンカーへ再帰する（到達閉包）。 */\n  const visitFragment = (uuid: string): void => {\n    if (visitedFragments.has(uuid)) return;\n    visitedFragments.add(uuid);\n    const fragmentInfo = getFragmentInfoByUUID(uuid);\n    if (fragmentInfo === null) return;\n    for (const nodeInfo of fragmentInfo.nodeInfos) {\n      for (const parsed of nodeInfo.parseBindTextResults) {\n        push(toInfo(null, parsed, \"fragment\", \"\"));\n        if (parsed.uuid != null) {\n          visitFragment(parsed.uuid);\n        }\n      }\n    }\n  };\n\n  const doc = rootNode.ownerDocument ?? (rootNode as Document);\n  const walker = doc.createTreeWalker(\n    rootNode,\n    NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_COMMENT,\n  );\n\n  for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) {\n    if (node.nodeType === Node.ELEMENT_NODE) {\n      const element = node as Element;\n      const bindText = element.getAttribute(config.bindAttributeName);\n      if (bindText === null || bindText.length === 0) continue;\n      try {\n        // spread は live Element の wcBindable から展開（未定義要素は spread のまま = 既存契約）\n        const results = expandSpread(element, parseBindTextsForElement(bindText));\n        for (const parsed of results) {\n          push(toInfo(element, parsed, \"attribute\", bindText));\n        }\n      } catch {\n        // 不正な宣言は観測面では捨てる（検査は lint / ランタイム raiseError の責務）\n      }\n      continue;\n    }\n    // コメントアンカー: 構造ディレクティブ（UUID → fragment 登録済み）または\n    // 埋め込みテキストバインディング。\n    const match = COMMENT_PATTERN.exec((node as Comment).data.trim());\n    if (match === null) continue;\n    const keyword = match[1] || config.commentTextPrefix;\n    const value = match[2];\n    const fragmentInfo = getFragmentInfoByUUID(value);\n    if (fragmentInfo !== null) {\n      push(toInfo(node, fragmentInfo.parseBindTextResult, \"comment\", value));\n      visitFragment(value);\n      continue;\n    }\n    if (keyword !== config.commentTextPrefix) {\n      // 構造アンカーなのに fragment 未登録（SSR の pre-hydration ウィンドウ等）、\n      // または未知 keyword — UUID や不明値をパスとして誤パースしない。\n      continue;\n    }\n    try {\n      push(toInfo(node, parseBindTextForEmbeddedNode(value), \"comment\", value));\n    } catch {\n      // 同上\n    }\n  }\n\n  return out;\n}\n","/**\n * devtools/types.ts\n *\n * DevTools Hook Protocol (docs/devtools-hook-protocol.md) の型定義。\n *\n * イベント payload はランタイム内部オブジェクト（IAbsoluteStateAddress /\n * IBindingInfo 等）への生参照を含む（同一 realm・オーバーレイ前提、protocol 原則 4）。\n * 消費者はこれらを変異してはならない。\n */\n\nimport type { IAbsoluteStateAddress } from \"../address/types\";\nimport type { IBindingInfo } from \"../binding/types\";\nimport type { IStateElement } from \"../components/types\";\n\n/** グローバル registry のプロパティ名 */\nexport const DEVTOOLS_HOOK_GLOBAL = \"__WCSTACK_DEVTOOLS_HOOK__\";\n\n/** プロトコル版。additive change では上げない（protocol §2） */\nexport const DEVTOOLS_PROTOCOL_VERSION = 2;\n\nexport type DevtoolsEvent =\n  | {\n      readonly type: \"state:element-registered\";\n      readonly rootNode: Node;\n      readonly element: IStateElement;\n    }\n  | {\n      readonly type: \"state:element-unregistered\";\n      readonly rootNode: Node;\n      readonly element: IStateElement;\n    }\n  | {\n      readonly type: \"state:write\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly value: unknown;\n      /** same-value guard が既に取得していた場合のみ意味を持つ（protocol §4.2） */\n      readonly oldValue: unknown;\n      readonly hasOldValue: boolean;\n    }\n  | {\n      readonly type: \"state:update-batch\";\n      readonly addresses: ReadonlySet<IAbsoluteStateAddress>;\n    }\n  | {\n      readonly type: \"state:binding-added\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly binding: IBindingInfo;\n    }\n  | {\n      readonly type: \"state:binding-removed\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly binding: IBindingInfo;\n    }\n  | {\n      readonly type: \"state:binding-cleared\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n    }\n  | {\n      readonly type: \"state:token-emit\";\n      readonly kind: \"command\" | \"event\";\n      readonly tokenName: string;\n      readonly args: readonly unknown[];\n      readonly subscriberCount: number;\n      /**\n       * 発火元ツリーの state 要素（protocol v2 追補 2026-09-05・additive）。\n       * registry（getOrCreate*Token）経由で作られた token だけが持つ — 直接生成された\n       * token や旧ランタイムの payload には無い（optional）。無い emit の実測は\n       * ツリー別に分けられないため、消費側は全ツリーの照会へ合算で残す。\n       */\n      readonly stateElement?: IStateElement;\n    }\n  | {\n      // `$watch` の実行中に throw した（docs/state-watch-hook-design.md §7-1）。\n      // watch は 1 バッチで N 個走り drain フックを他機能と共有するため、例外は\n      // watch 側で閉じる（console.error のみ）。それだと devtools から\n      // 「静かに握られた失敗」が見えないので、同じ地点からここにも流す。\n      readonly type: \"state:watch-error\";\n      /**\n       * throw 元。cur の評価（getter）とハンドラ本体では原因も直し方も違う。\n       * `$scan`（scan/scanReport.ts）は `evaluate`（source / 出力の読み）・`fold`（fold の throw・\n       * Promise の戻り値・接ぎ木で getter になった from）・`write`（出力の書き込み）を使う\n       */\n      readonly phase: \"prime\" | \"evaluate\" | \"handler\" | \"fold\" | \"write\";\n      /** `$watch` の宣言キー（ワイルドカードを含む生のパス）。`$scan` は `$scan.<出力名>` */\n      readonly path: string;\n      readonly error: unknown;\n    }\n  | {\n      // watch 起点の書き込み連鎖が深さ上限で打ち切られた（設計書 §7-2）。\n      // 値と binding 適用は巻き戻さない ＝ propagation:hop-limit と同じ姿勢。\n      readonly type: \"state:watch-chain-limit\";\n      readonly maxDepth: number;\n      /** 打ち切ったバッチに載っていたアドレスのパス（報告用） */\n      readonly paths: readonly string[];\n    }\n  | {\n      // 描画起点の書き込み連鎖（binding の適用中の書き込みが次のバッチを起こす）が深さ上限で\n      // 打ち切られた（#338・updater/updater.ts）。そのバッチの binding は適用せず、値は巻き戻さない。\n      readonly type: \"state:render-chain-limit\";\n      readonly maxDepth: number;\n      /** 打ち切ったバッチに載っていたアドレスのパス（＝ 直前の描画の中で書かれたパス） */\n      readonly paths: readonly string[];\n    }\n  | {\n      // `$watch` ハンドラの正常発火（state-watch-hook-design.md §11 で予約済み・\n      // static-wiring-dx-design.md §4 の配線カバレッジが消費）。値は載せない —\n      // 「宣言したのに一度も発火しない」の検出には発火の事実だけで足りる。\n      readonly type: \"state:watch-fired\";\n      /** `$watch` の宣言キー（ワイルドカードを含む生のパス） */\n      readonly path: string;\n      /**\n       * 発火元ツリーの state 要素（protocol v2 追補 2026-09-05・additive）。\n       * 複数ツリーが同名の watch パスを宣言するページで実測台帳をツリー別に\n       * 分けるための識別。旧ランタイムの payload には無い（optional）— 無い発火は\n       * 消費側が全ツリーの照会へ合算で残す。値を載せない契約（§4.3.1）は不変。\n       */\n      readonly stateElement?: IStateElement;\n    }\n  | {\n      // バインド / `$watch` の対象パスが state 上で解決しないと確定した\n      // （pathDiagnostics.ts）。ランタイムは console.warn に留めて続行するため、\n      // 「配線したのに黙って死んでいる」を devtools からも見えるようにする。\n      readonly type: \"state:path-unresolved\";\n      /** 書き手が書いた面。診断 code が binding / watch で変わる */\n      readonly source: \"binding\" | \"watch\" | \"scan\";\n      /** 宣言されたパス（ワイルドカードを含む生の文字列） */\n      readonly path: string;\n      /** 解決に失敗したセグメント */\n      readonly missingSegment: string;\n    }\n  | {\n      // binding 適用が throw したが、バッチの残りは続行した（apply/applyChangeFromBindings）。\n      // 例外を握らずに隔離した事実を観測可能にする（state:watch-error と同じ位置づけ）。\n      readonly type: \"state:binding-apply-error\";\n      /** バインディングの state パス（ワイルドカードを含む生の文字列） */\n      readonly path: string;\n      readonly bindingType: string;\n      readonly error: unknown;\n    }\n  | {\n      readonly type: \"propagation:suppressed\";\n      readonly reason: \"confirmation\" | \"visited-edge\";\n      readonly transactionId: number;\n      readonly edgeId: number;\n      readonly node: Node;\n      readonly member: string;\n    }\n  | {\n      readonly type: \"propagation:coalesced\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly droppedTransactionId: number;\n      readonly winnerTransactionId: number;\n    }\n  | {\n      readonly type: \"propagation:hop-limit\";\n      readonly absoluteAddress: IAbsoluteStateAddress;\n      readonly transactionId: number;\n      readonly hop: number;\n    }\n  // --- contract analyzer (Phase 5b, §6 contract category) ---\n  | {\n      // sidecar manifest から 1 コンポーネント契約を読んだ(dev-time analyzer)。\n      readonly type: \"contract:manifest-read\";\n      readonly tag: string;\n      /** 実行時に該当タグが登録済みか(未登録なら drift の起点)。 */\n      readonly loaded: boolean;\n    }\n  | {\n      // manifest の未知 namespace / extension(runtime analyzer が解釈しない)。\n      readonly type: \"contract:unsupported-extension\";\n      readonly namespace: string;\n    }\n  | {\n      // sidecar と live wcBindable 宣言の drift。live 宣言が正本。\n      readonly type: \"contract:drift\";\n      readonly reason: \"component-not-loaded\" | \"missing-member\" | \"event-mismatch\";\n      readonly tag: string;\n      readonly member?: string;\n      /** event-mismatch のとき: sidecar 宣言 event / live event。 */\n      readonly sidecarEvent?: string;\n      readonly liveEvent?: string;\n    };\n\nexport type DevtoolsSink = (event: DevtoolsEvent) => void;\n\n/** contract analyzer(Phase 5b)が生成しうる event だけの狭い union(公開 API の戻り型)。 */\nexport type ContractEvent = Extract<\n  DevtoolsEvent,\n  { readonly type: \"contract:manifest-read\" | \"contract:unsupported-extension\" | \"contract:drift\" }\n>;\n\n/** マウント記録 1 件の要約（overlays — protocol v2）。 */\nexport interface IMountOverlaySummary {\n  /** D20 の予約セグメント（`#m<id>`） */\n  readonly marker: string;\n  /** マウントされたコンポーネントのタグ名（小文字） */\n  readonly componentTag: string;\n  readonly stateProp: string;\n  /** マウント表: 内側接頭辞（空 = ルートエントリ）→ 外側パス */\n  readonly mountTable: readonly { readonly inner: string; readonly outer: string }[];\n  /** `$n` 補正の Δ（ルート接頭辞のワイルドカード数） */\n  readonly delta: number;\n  /** 私有キー（作者の own data key — オーバーレイ空間に住む） */\n  readonly privateKeys: readonly string[];\n  /** 公開 getter の公開パス（親スコープから読める・docs/state-overlay-export-design.md） */\n  readonly exports: readonly string[];\n  /** マーカーパスに載る getter のキー */\n  readonly getterKeys: readonly string[];\n}\n\n/**\n * 鍵付き購読（`$eq` / `$eqPath` / `$eqIndex`）の path 1 つ分の要約（keyedSubscriptions の要素 —\n * protocol v2 追補・additive、要件 D17）。取り出した時点の数えで、台帳への参照は持たない。\n */\nexport interface IKeyedSubscriptionSummary {\n  /** `$eq` 系の第 1 引数（選択を持つパス） */\n  readonly path: string;\n  /**\n   * `path` が getter かその下にあるので鍵付きで購読できず、追跡付きの読みに落ちた。`path` が\n   * 変わるたびに、それを読む getter がすべて再評価される（README「鍵付き選択」）\n   */\n  readonly tracked: boolean;\n  /** 行ごとの購読の数（`$eq` / `$eqPath`、`$eqIndex` の外側の段、行の外の getter） */\n  readonly rows: number;\n  /** 行ごとの購読が使っている鍵の数 */\n  readonly keys: number;\n  /** `$eqIndex` の最内段が置くリスト単位の監視の数（行ごとの購読を持たない） */\n  readonly lists: number;\n  /** `path` の最後に見た値（登録時か書き込み時）。見ていなければ undefined。生値（protocol 原則 4） */\n  readonly lastValue: unknown;\n}\n\nexport interface IStateElementSummary {\n  readonly rootNode: Node;\n  readonly element: IStateElement;\n  readonly paths: {\n    readonly list: ReadonlySet<string>;\n    readonly element: ReadonlySet<string>;\n    readonly getter: ReadonlySet<string>;\n    readonly setter: ReadonlySet<string>;\n  };\n  readonly commandTokenNames: ReadonlySet<string>;\n  readonly eventTokenNames: ReadonlySet<string>;\n  readonly staticDependency: ReadonlyMap<string, readonly string[]>;\n  readonly dynamicDependency: ReadonlyMap<string, readonly string[]>;\n  /**\n   * `$watch` の宣言パス集合（宣言なしは null）。protocol v1 追補（additive）—\n   * 配線カバレッジの「宣言面」（static-wiring-dx-design.md §4）。\n   */\n  readonly watchPaths: ReadonlySet<string> | null;\n  /**\n   * `$listKeys` で宣言されたリストパス集合（宣言なしは null）。protocol v1 追補\n   * （additive）— ワイルドカード行 watch に**リスト書き込み**が届く前提は\n   * 「for バインド or $listKeys 宣言」（state-watch-hook-design.md §6-3）なので、\n   * paths.list（for 由来）と合わせて初めてカバレッジの前提判定が正確になる\n   *（明示 index 書き込みは前提に依らず発火し得る）。\n   */\n  readonly keyedListPaths: ReadonlySet<string> | null;\n}\n\n/**\n * 宣言レベルのバインディング 1 件（getDeclaredBindings の要素）。\n * 正本パーサ（bindTextParser）の結果をそのまま流す — devtools 側の簡易パーサ\n * （declaredScan）が「bindTextParser 非追随」と自己申告していたドリフトの恒久解消。\n * filters は IFilterInfo の構造的サブセット（filterName / args）として読める。\n *\n * getDeclaredBindings の戻り値は**宣言の集合**（宣言タプルで dedupe 済み）であり、\n * レンダリング行数に比例したインスタンス列ではない。インスタンス粒度は live の\n * binding 台帳（state:binding-added）の守備範囲。\n */\n/** 宣言されたフィルタ 1 つ（`IParsedFilter` の devtools 向けの写し） */\nexport interface IDeclaredFilter {\n  readonly filterName: string;\n  readonly args: readonly string[];\n  /** 引数の型付きの値（要件 B9）。省略されたら `args` で代用される */\n  readonly literals?: readonly unknown[];\n}\n\nexport interface IDeclaredBindingInfo {\n  /**\n   * 宣言を代表するノード（要素またはコメントアンカー。同一宣言の複数出現は\n   * 最初に見つかったノード）。構造テンプレート内部の宣言（origin: 'fragment'）は\n   * live DOM にノードを持たないため null。\n   */\n  readonly node: Node | null;\n  readonly propName: string;\n  readonly statePathName: string;\n  readonly bindingType: string;\n  /**\n   * 宣言されたフィルタ。`literals`（引数の型付きの値・要件 B9）は宣言の同一判定\n   * （`binding/filterKey.ts`）が読む。型から落とすと、型どおりのオブジェクトを渡した瞬間に\n   * `defaults(0)` と `defaults('0')` が同じ宣言に畳まれる（`literals ?? args` のフォールバックで\n   * 黙って原文比較へ落ちるため）。\n   */\n  readonly inFilters: readonly IDeclaredFilter[];\n  readonly outFilters: readonly IDeclaredFilter[];\n  readonly origin: \"attribute\" | \"comment\" | \"fragment\";\n  /**\n   * 宣言の原文。構造ディレクティブのアンカー（origin: 'comment'）は原文が DOM に\n   * 残らないためレジストリ UUID、fragment 由来は空文字。\n   */\n  readonly raw: string;\n}\n\nexport interface IDevtoolsSource {\n  readonly id: string;\n  readonly kind: \"state\";\n  readonly packageVersion: string;\n  getStateElements(): IStateElementSummary[];\n  /**\n   * state のトップレベルキー（データプロパティ + 実行可能な getter）を列挙する。\n   * メソッド・`$` 始まり・ワイルドカードを含むキーは除外。\n   * 状態ツリー UI の描画起点（protocol §3）。\n   */\n  keys(rootNode: Node): string[];\n  /**\n   * rootNode のツリーに載っているマウント記録の列挙（protocol v2 — D20 の可視化）。\n   * マーカー（`#m<id>`）ごとに、マウント表と私有面（オーバーレイ専用アドレス空間に\n   * 住むキー）を出す。マウントが無ければ空配列。\n   */\n  overlays(rootNode: Node): IMountOverlaySummary[];\n  /**\n   * rootNode のツリーの鍵付き購読を path ごとに要約する（protocol v2 追補・additive、要件 D17）。\n   * 購読は依存グラフの動的な変化なので、イベントではなくここで取る（protocol §4.6）。\n   * 一度も `$eq` 系が評価されていなければ空配列。\n   */\n  keyedSubscriptions(rootNode: Node): IKeyedSubscriptionSummary[];\n  read(rootNode: Node, path: string, indexes?: number[]): unknown;\n  write(rootNode: Node, path: string, value: unknown, indexes?: number[]): void;\n  /**\n   * rootNode 配下の宣言レベルのバインディングを正本パーサで列挙する\n   * （protocol v1 追補・additive）。live DOM（属性 + コメントアンカー）に加え、\n   * DOM から引き上げられた構造テンプレート内部（fragment レジストリ）も含む —\n   * DOM 再スキャン方式の declared ビューでは原理的に見えなかった領域。\n   */\n  getDeclaredBindings(rootNode: Node): IDeclaredBindingInfo[];\n  /** registry 専用。listener の有無に応じて registry が差し替える */\n  _setSink(sink: DevtoolsSink | null): void;\n}\n\nexport interface IDevtoolsListener {\n  onSourceRegistered?(source: IDevtoolsSource): void;\n  onSourceUnregistered?(sourceId: string): void;\n  onEvent?(sourceId: string, event: DevtoolsEvent): void;\n}\n\nexport interface IDevtoolsHookRegistry {\n  readonly version: number;\n  readonly sources: Map<string, IDevtoolsSource>;\n  register(source: IDevtoolsSource): void;\n  unregister(sourceId: string): void;\n  /** 戻り値は解除関数。既登録 source は onSourceRegistered で即時リプレイされる */\n  addListener(listener: IDevtoolsListener): () => void;\n}\n","/**\n * devtools/bridge.ts\n *\n * DevTools Hook Protocol (docs/devtools-hook-protocol.md) の state 側実装。\n *\n * - registry 最小実装: `globalThis.__WCSTACK_DEVTOOLS_HOOK__` を create-if-missing で\n *   確保する（ロード順非依存・先勝ち。devtools 側 client も同一仕様の実装を持つ）。\n * - source: この state モジュールコピーを 1 source として登録する。同一ページに\n *   コピーが複数あれば複数 source になる（正常系、protocol §5）。\n * - sink 切替: listener の有無に応じて registry が `_setSink` を呼び、ここで\n *   updater の drain リスナー登録/解除も連動させる（protocol §4.3）。\n */\n\nimport { inSsr } from \"../config\";\nimport { DEVTOOLS_LISTENER_PRIORITY } from \"../define\";\nimport { getStateElement, getLiveStateElements } from \"../stateElementByName\";\n// スコープ機能のコードは静的 import しない（要件 B13 — devtools だけのページに\n// `webComponent/*` が乗る）。受け口は bridge/featureBridge.ts で、scopes の install が置く\nimport { getMountOverlays } from \"../bridge/featureBridge\";\nimport { registerUpdateBatchListener, unregisterUpdateBatchListener, UpdateBatchListener } from \"../updater/updater\";\nimport { raiseError } from \"../raiseError\";\nimport { VERSION } from \"../version\";\nimport { IStateElement } from \"../components/types\";\nimport { collectDeclaredBindings } from \"./declaredBindings\";\nimport { collectKeyedSubscriptions } from \"./keyedSubscriptions\";\nimport { devtoolsSink, setDevtoolsSink } from \"../platform/devtoolsSink\";\nimport {\n  DEVTOOLS_HOOK_GLOBAL,\n  DEVTOOLS_PROTOCOL_VERSION,\n  DevtoolsSink,\n  IDevtoolsHookRegistry,\n  IDevtoolsListener,\n  IDevtoolsSource,\n  IStateElementSummary,\n  IMountOverlaySummary,\n} from \"./types\";\n\n/**\n * registry の最小実装（protocol §2）。30 行程度に抑え、振る舞いは\n * 「source/listener の管理と sink の配線」のみ。台帳・整形は devtools 側の責務。\n */\nfunction createMinimalRegistry(): IDevtoolsHookRegistry {\n  const sources = new Map<string, IDevtoolsSource>();\n  const listeners = new Set<IDevtoolsListener>();\n  const applySink = (source: IDevtoolsSource): void => {\n    if (listeners.size === 0) {\n      source._setSink(null);\n      return;\n    }\n    const sourceId = source.id;\n    source._setSink((event) => {\n      for (const listener of listeners) {\n        listener.onEvent?.(sourceId, event);\n      }\n    });\n  };\n  return {\n    version: DEVTOOLS_PROTOCOL_VERSION,\n    sources,\n    register(source: IDevtoolsSource): void {\n      if (sources.has(source.id)) {\n        return;\n      }\n      sources.set(source.id, source);\n      applySink(source);\n      for (const listener of listeners) {\n        listener.onSourceRegistered?.(source);\n      }\n    },\n    unregister(sourceId: string): void {\n      const source = sources.get(sourceId);\n      if (source === undefined) {\n        return;\n      }\n      source._setSink(null);\n      sources.delete(sourceId);\n      for (const listener of listeners) {\n        listener.onSourceUnregistered?.(sourceId);\n      }\n    },\n    addListener(listener: IDevtoolsListener): () => void {\n      listeners.add(listener);\n      // 既登録 source をリプレイ（遅延アタッチの起点、protocol §6）\n      for (const source of sources.values()) {\n        applySink(source);\n        listener.onSourceRegistered?.(source);\n      }\n      return () => {\n        if (!listeners.delete(listener)) {\n          return;\n        }\n        for (const source of sources.values()) {\n          applySink(source);\n        }\n      };\n    },\n  };\n}\n\nexport function getOrCreateHookRegistry(): IDevtoolsHookRegistry {\n  const globals = globalThis as unknown as Record<string, unknown>;\n  const existing = globals[DEVTOOLS_HOOK_GLOBAL] as IDevtoolsHookRegistry | undefined;\n  if (existing !== undefined) {\n    if (existing.version !== DEVTOOLS_PROTOCOL_VERSION) {\n      // 先勝ち固定。振る舞いは差し替えない（protocol §2）\n      console.warn(\n        `[wcstack/state] devtools hook registry version mismatch: found ${existing.version}, expected ${DEVTOOLS_PROTOCOL_VERSION}. Keeping the existing registry (first-wins).`\n      );\n    }\n    return existing;\n  }\n  const registry = createMinimalRegistry();\n  globals[DEVTOOLS_HOOK_GLOBAL] = registry;\n  return registry;\n}\n\n/**\n * drain 終了バッチの転送リスナー。sink 接続中のみ updater に登録される。\n */\nconst onUpdateBatch: UpdateBatchListener = (batch) => {\n  if (devtoolsSink !== null) {\n    devtoolsSink({ type: \"state:update-batch\", addresses: batch });\n  }\n};\n\n/**\n * registry からの sink 差し替え。updater の drain リスナー登録/解除を連動させる。\n * detach 時に登録が残らないこと（protocol §7-2）。\n */\nfunction setSink(sink: DevtoolsSink | null): void {\n  const wasActive = devtoolsSink !== null;\n  setDevtoolsSink(sink);\n  const isActive = sink !== null;\n  if (isActive && !wasActive) {\n    // `$watch` / `$streams` restart より先に流す（protocol §4.3）。優先度を省略しても\n    // 既定 0 で結果は同じだが、それは偶然なので定数で意図を固定する。\n    registerUpdateBatchListener(onUpdateBatch, DEVTOOLS_LISTENER_PRIORITY);\n  } else if (!isActive && wasActive) {\n    unregisterUpdateBatchListener(onUpdateBatch);\n  }\n}\n\nfunction createStateElementSummary(element: IStateElement): IStateElementSummary {\n  return {\n    rootNode: element.rootNode,\n    element,\n    paths: {\n      list: element.listPaths,\n      element: element.elementPaths,\n      getter: element.getterPaths,\n      setter: element.setterPaths,\n    },\n    commandTokenNames: element.commandTokenNames,\n    eventTokenNames: element.eventTokenNames,\n    staticDependency: element.staticDependency,\n    dynamicDependency: element.dynamicDependency,\n    // protocol v1 追補（additive）— 配線カバレッジの宣言面（設計 §4）。\n    // 旧 IStateElement 実装（optional）では undefined になりうるため null に畳む。\n    watchPaths: element.watchPaths ?? null,\n    // ワイルドカード行 watch の発火前提「for バインド or $listKeys 宣言」の後者。\n    // ListKeyMap のキー（リストパス）だけを出す — キー指定（文字列/関数）は\n    // カバレッジ判定に不要で、関数はシリアライズ境界にも載せない。\n    keyedListPaths:\n      element.listKeys === undefined || element.listKeys === null\n        ? null\n        : new Set(element.listKeys.keys()),\n  };\n}\n\nfunction requireStateElement(rootNode: Node): IStateElement {\n  return getStateElement(rootNode) ??\n    raiseError(`devtools: no state tree on this root`);\n}\n\nfunction createSourceId(): string {\n  // getUUID() はモジュールローカル連番のため、state コピーが複数ある\n  // ページで source id が衝突する。ランダム採番で回避する。\n  return \"state:\" + Math.random().toString(36).slice(2, 10);\n}\n\nlet registeredSource: IDevtoolsSource | null = null;\n\n/**\n * この state ランタイムを 1 source として registry に登録する。\n * bootstrapState() から呼ばれる。冪等・SSR では何もしない（protocol 原則 6）。\n */\nexport function registerDevtoolsSource(): void {\n  if (inSsr()) {\n    return;\n  }\n  if (registeredSource !== null) {\n    return;\n  }\n  const source: IDevtoolsSource = {\n    id: createSourceId(),\n    kind: \"state\",\n    packageVersion: VERSION,\n    getStateElements(): IStateElementSummary[] {\n      const summaries: IStateElementSummary[] = [];\n      for (const element of getLiveStateElements()) {\n        summaries.push(createStateElementSummary(element));\n      }\n      return summaries;\n    },\n    overlays(rootNode: Node): IMountOverlaySummary[] {\n      // スコープ機能が入っていないページにマウントは存在しえない（受け口が空なら空配列）\n      return getMountOverlays(requireStateElement(rootNode));\n    },\n    keyedSubscriptions(rootNode: Node) {\n      return collectKeyedSubscriptions(requireStateElement(rootNode));\n    },\n    keys(rootNode: Node): string[] {\n      const element = requireStateElement(rootNode);\n      const result: string[] = [];\n      element.createState(\"readonly\", (state) => {\n        // Object.keys は Proxy の ownKeys 経由で target の own key を返す。\n        // メソッド判別の typeof アクセスは getter を 1 回実行する副作用があるため、\n        // ループ文脈依存で throw する getter は catch して「キーとしては存在する」\n        // 側に倒す（値の表示可否は UI 側の責務）。\n        for (const key of Object.keys(state)) {\n          if (key.includes(\"*\") || key.startsWith(\"$\")) {\n            continue;\n          }\n          try {\n            if (typeof (state as unknown as Record<string, unknown>)[key] === \"function\") {\n              continue;\n            }\n          } catch {\n            // 読めない getter もキーとしては列挙する\n          }\n          result.push(key);\n        }\n      });\n      return result;\n    },\n    read(rootNode: Node, path: string, indexes?: number[]): unknown {\n      const element = requireStateElement(rootNode);\n      let result: unknown;\n      element.createState(\"readonly\", (state) => {\n        result = (state as unknown as Record<string, (p: string, i: number[]) => unknown>)[\"$resolve\"](path, indexes ?? []);\n      });\n      return result;\n    },\n    write(rootNode: Node, path: string, value: unknown, indexes?: number[]): void {\n      const element = requireStateElement(rootNode);\n      element.createState(\"writable\", (state) => {\n        if (indexes !== undefined && indexes.length > 0) {\n          // 3 引数の $resolve は値が undefined でも書き（引数の個数で読み書きを分ける — 要件 B7）\n          (state as unknown as Record<string, (p: string, i: number[], v: unknown) => void>)[\"$resolve\"](path, indexes, value);\n        } else {\n          (state as unknown as Record<string, unknown>)[path] = value;\n        }\n      });\n    },\n    getDeclaredBindings(rootNode: Node) {\n      return collectDeclaredBindings(rootNode);\n    },\n    _setSink: setSink,\n  };\n  registeredSource = source;\n  getOrCreateHookRegistry().register(source);\n}\n\n/**\n * テスト専用: sink を解除し source 登録状態をリセットする。\n * グローバル registry 自体の掃除（delete globalThis[DEVTOOLS_HOOK_GLOBAL]）は\n * テスト側の責務。アプリケーションからの利用は想定しない。\n */\nexport function __resetDevtoolsBridgeForTest(): void {\n  setSink(null);\n  registeredSource = null;\n}\n\n/** テスト専用: 現在登録済みの source を返す */\nexport function __getRegisteredSourceForTest(): IDevtoolsSource | null {\n  return registeredSource;\n}\n","/**\n * devtools/keyedSubscriptions.ts\n *\n * DevTools Hook Protocol の `keyedSubscriptions(rootNode)`（protocol v2 追補・要件 D17）。\n * 鍵付き購読（`$eq` / `$eqPath` / `$eqIndex`）の台帳を path ごとに数えて返す。\n *\n * 購読は描画のたびに行単位で増減する依存グラフの動的な変化なので、イベントでは流さず\n * pull で取る（protocol §4.6。1 万行の描画で 1 万件のイベントにしない）。数えるのは\n * 呼ばれた時点だけで、台帳への参照は返さない。このモジュールは devtools 機能だけが\n * import する — core は台帳を読ませるアクセサしか持たない。\n */\n\nimport { IStateElement } from \"../components/types\";\nimport { getKeyedLedgerView } from \"../dependency/keyedDependency\";\nimport { IKeyedSubscriptionSummary } from \"./types\";\n\nexport function collectKeyedSubscriptions(stateElement: IStateElement): IKeyedSubscriptionSummary[] {\n  const view = getKeyedLedgerView(stateElement);\n  if (view === null) {\n    return [];\n  }\n  const paths = new Set<string>([...view.byPath.keys(), ...view.tracked]);\n  if (typeof view.watchers !== \"undefined\") {\n    for (const path of view.watchers.keys()) {\n      paths.add(path);\n    }\n  }\n  const summaries: IKeyedSubscriptionSummary[] = [];\n  for (const path of [...paths].sort()) {\n    const keyMap = view.byPath.get(path);\n    let rows = 0;\n    if (typeof keyMap !== \"undefined\") {\n      for (const addresses of keyMap.values()) {\n        rows += addresses.size;\n      }\n    }\n    summaries.push({\n      path,\n      tracked: view.tracked.has(path),\n      rows,\n      keys: keyMap?.size ?? 0,\n      lists: view.watchers?.get(path)?.size ?? 0,\n      lastValue: view.lastValue.get(path),\n    });\n  }\n  return summaries;\n}\n","/**\n * features/devtools.ts — DevTools Hook Protocol への source 登録（@wcstack/state/features/devtools）。\n */\nimport type { IStateFeature } from \"../core/features\";\nimport { registerDevtoolsSource } from \"../devtools/bridge\";\n\nexport const devtools: IStateFeature = {\n  name: \"devtools\",\n  install(): void {\n    registerDevtoolsSource();\n  },\n};\nexport default devtools;\n"],"names":["COMMENT_PATTERN","toInfo","node","parsed","origin","raw","propName","statePathName","bindingType","inFilters","outFilters","collectDeclaredBindings","rootNode","out","seenKeys","Set","visitedFragments","push","info","key","filters","filterListKey","join","declarationKey","has","add","visitFragment","uuid","fragmentInfo","getFragmentInfoByUUID","nodeInfo","nodeInfos","parseBindTextResults","walker","ownerDocument","createTreeWalker","NodeFilter","SHOW_ELEMENT","SHOW_COMMENT","nextNode","nodeType","Node","ELEMENT_NODE","element","bindText","getAttribute","config","bindAttributeName","length","results","expandSpread","parseBindTextsForElement","match","exec","data","trim","keyword","commentTextPrefix","value","parseBindTextForEmbeddedNode","parseBindTextResult","DEVTOOLS_HOOK_GLOBAL","getOrCreateHookRegistry","globals","globalThis","existing","undefined","version","console","warn","registry","sources","Map","listeners","applySink","source","size","_setSink","sourceId","id","event","listener","onEvent","register","set","onSourceRegistered","unregister","get","delete","onSourceUnregistered","addListener","values","createMinimalRegistry","onUpdateBatch","batch","devtoolsSink","type","addresses","setSink","sink","wasActive","setDevtoolsSink","isActive","registerUpdateBatchListener","DEVTOOLS_LISTENER_PRIORITY","unregisterUpdateBatchListener","createStateElementSummary","paths","list","listPaths","elementPaths","getter","getterPaths","setter","setterPaths","commandTokenNames","eventTokenNames","staticDependency","dynamicDependency","watchPaths","keyedListPaths","listKeys","keys","requireStateElement","getStateElement","raiseError","registeredSource","registerDevtoolsSource","inSsr","Math","random","toString","slice","kind","packageVersion","VERSION","getStateElements","summaries","getLiveStateElements","overlays","getMountOverlays","keyedSubscriptions","stateElement","view","getKeyedLedgerView","byPath","tracked","watchers","path","sort","keyMap","rows","lists","lastValue","collectKeyedSubscriptions","result","createState","state","Object","includes","startsWith","read","indexes","write","getDeclaredBindings","devtools","name","install"],"mappings":"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"}

package/dist/split/features/diagnostics.js

@@ -1,2 +1,2 @@
-import{s as e}from"../chunks/diagnosticsHooks.js";import{g as t,C as n,W as s,a8 as i,a9 as r,aa as o,d as a,D as c}from"../chunks/pathDiagnostics.js";import{d,L as u}from"../chunks/errorGuidance.js";const g=Object.freeze({existence:"unknown",missingSegment:"",candidates:Object.freeze([])}),f=Object.freeze({existence:"exists",missingSegment:"",candidates:Object.freeze([])});const l=new WeakMap;const m=new WeakMap,h=new WeakSet,p=new WeakMap;function k(e,t,n,s){console.warn(`[@wcstack/state] [${r[n]}] ${o[n]} "${t}" does not resolve on the state tree: "${s.missingSegment}" is not declared.${d(s.missingSegment,s.candidates)} Updates to this path will be silently dropped.${u}`),null!==a&&a({type:"state:path-unresolved",source:n,path:t,missingSegment:s.missingSegment})}const v={check:function(e,r,o,a){if("internal"===a||void 0===r)return;if(o.startsWith("$"))return;if(-1!==o.indexOf("#"))return;const d=e.addressHooks;if(d){const t=d.suppressPathDiagnostic;for(let n=0;n<t.length;n++)if(t[n](e,o))return}const u=t(o).segments;if("binding"===a&&u.length<2)return;if(function(e,t){let n=l.get(e);return void 0===n&&(n=new Set,l.set(e,n)),!!n.has(t)||(n.add(t),!1)}(e,o))return;if(!0===e.hasRecursion&&null!==e.recursionRegistry.recursiveGetterOwning(o))return;const v=function(e,r,o){if(void 0!==n(e,r))return f;const a=t(r).segments;let d=e,u="";for(let t=0;t<a.length;t++){const r=a[t],l=u;if(u=0===t?r:u+c+r,t>0&&t<a.length-1&&void 0!==n(e,u))return g;if(Object(d)!==d)return g;if(r===s){if(!Array.isArray(d)||0===d.length)return g;d=d[0];continue}const m=n(d,r);if(void 0===m)return{existence:"missing",missingSegment:r,candidates:i(d,l,o)};if("function"==typeof m.get)return t===a.length-1?f:g;d=m.value}return f}(r,o,e.getterPaths);"missing"===v.existence&&(function(e,t){return!0===p.get(e)?.has(t)}(e,o)||("binding"!==a?k(e,o,a,v):function(e,t,n){let s=m.get(e);void 0===s&&(s=new Map,m.set(e,s));if(s.set(t,n),h.has(e))return;h.add(e),setTimeout(()=>function(e){h.delete(e);const t=m.get(e);if(void 0===t)return;m.delete(e);for(const[n,s]of t)k(e,n,"binding",s)}(e),0)}(e,o,v)))},reset:function(e){l.delete(e),m.delete(e)},markExported:function(e,t){let n=p.get(e);void 0===n&&(n=new Set,p.set(e,n)),n.add(t),m.get(e)?.delete(t)}};let w=!1;const S={name:"diagnostics",install(){w||(w=!0,e(v))}};export{S as default,S as diagnostics};
+import{s as e}from"../chunks/diagnosticsHooks.js";import{g as t,E as n,W as s,y as i,aa as r,ab as a,ac as o,d as c,D as d}from"../chunks/pathDiagnostics.js";import{d as u,L as g}from"../chunks/errorGuidance.js";const f=Object.freeze({existence:"unknown",missingSegment:"",candidates:Object.freeze([])}),l=Object.freeze({existence:"exists",missingSegment:"",candidates:Object.freeze([])});const m=new WeakMap;const h=new WeakMap,p=new WeakSet,k=new WeakMap;function w(e,t,n,s){console.warn(`[@wcstack/state] [${a[n]}] ${o[n]} "${t}" does not resolve on the state tree: "${s.missingSegment}" is not declared.${u(s.missingSegment,s.candidates)} Updates to this path will be silently dropped.${g}`),null!==c&&c({type:"state:path-unresolved",source:n,path:t,missingSegment:s.missingSegment})}const v={check:function(e,a,o,c,u){if("internal"===c||void 0===a)return;if(o.startsWith("$"))return;if(-1!==o.indexOf("#"))return;const g=e.addressHooks;if(g){const t=g.suppressPathDiagnostic;for(let n=0;n<t.length;n++)if(t[n](e,o))return}const v=t(o).segments;if("binding"===c&&v.length<2)return;if(function(e,t){let n=m.get(e);return void 0===n&&(n=new Set,m.set(e,n)),!!n.has(t)||(n.add(t),!1)}(e,o))return;if(!0===e.hasRecursion&&null!==e.recursionRegistry.recursiveGetterOwning(o))return;const b=function(e,a,o,c){if(void 0!==n(e,a))return l;const u=t(a).segments;let g=e,m="";for(let t=0;t<u.length;t++){const a=c&&Array.isArray(g)&&+u[t]>=0?s:u[t],h=m;m=0===t?a:m+d+a;const p=t>0&&n(e,m),k=p&&i.get(p.get);if(p&&(!k||n(e,k)))return t<u.length-1?f:l;if(Object(g)!==g)return f;if(a===s){if(!Array.isArray(g)||0===g.length)return f;g=g[0];continue}const w=n(g,a);if(void 0===w)return{existence:"missing",missingSegment:a,candidates:r(g,h,o,e)};if("function"==typeof w.get)return t===u.length-1?l:f;g=w.value}return l}(a,o,e.getterPaths,u);"missing"===b.existence&&(function(e,t){return!0===k.get(e)?.has(t)}(e,o)||("binding"!==c?w(e,o,c,b):function(e,t,n){let s=h.get(e);void 0===s&&(s=new Map,h.set(e,s));if(s.set(t,n),p.has(e))return;p.add(e),setTimeout(()=>function(e){p.delete(e);const t=h.get(e);if(void 0===t)return;h.delete(e);for(const[n,s]of t)w(e,n,"binding",s)}(e),0)}(e,o,b)))},reset:function(e){m.delete(e),h.delete(e)},markExported:function(e,t){let n=k.get(e);void 0===n&&(n=new Set,k.set(e,n)),n.add(t),h.get(e)?.delete(t)}};let b=!1;const S={name:"diagnostics",install(){b||(b=!0,e(v))}};export{S as default,S as diagnostics};
 //# sourceMappingURL=diagnostics.js.map

package/dist/split/features/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sources":["../../../../../src/diagnostics/pathChecks.ts","../../../../../src/diagnostics/install.ts","../../../../../src/features/diagnostics.ts"],"sourcesContent":["/**\n * diagnostics/pathChecks.ts — バインド / `$watch` / `$scan` 対象パスの存在検査\n * （@wcstack/state/features/diagnostics。silent failure の可視化）。\n *\n * なぜ必要か:\n * `getByAddress` は「親が null / undefined のパスの読み」を undefined で返し、\n * undefined はプロパティ書き込みがスキップされる値なので、`user.nmae` のような\n * 打ち間違いは**エラーも警告も出さずに DOM が更新されない**だけになる。一方で\n * トップレベルの打ち間違い（`cout`）は parentAddress を辿れず raiseError で落ちる。\n * 同じ「パスを打ち間違えた」という 1 つの失敗が、パスの深さで silent / loud に\n * 割れており、書き手からは区別がつかない。ここはその silent 側を埋める。\n *\n * 開発時の診断なので機能として分けてある（full / auto は入れる。`@wcstack/state/core` だけの\n * ページは入れなければ警告を出さない — 本番向けの軽量形）。core の受け口は\n * core/diagnosticsHooks.ts。\n *\n * 精度方針（過小近似）:\n * 「確実に存在しない」と言い切れる場合にだけ報告する。getter の戻り値の先・\n * 空配列・null 親・mapped な `bind-component` など、静的に決められない形はすべて\n * `\"unknown\"` に倒して黙る（偽陽性ゼロ優先。docs/static-wiring-dx-design.md D7 /\n * [ADR-06](../../../docs/architecture-hardening/06-path-type-safety.md) の精度哲学）。\n */\n\nimport { getPathInfo } from \"../address/PathInfo\";\nimport type { IStateElement } from \"../components/types\";\nimport { DELIMITER, WILDCARD } from \"../define\";\nimport { devtoolsSink } from \"../platform/devtoolsSink\";\nimport { didYouMean, LINT_HINT } from \"../errorGuidance\";\nimport { collectCandidates, DIAGNOSTIC_CODE, findDescriptor, PathInfoSource, SUBJECT } from \"../pathDiagnostics\";\n\nexport type PathExistence = \"exists\" | \"missing\" | \"unknown\";\n\nexport interface IPathExistenceResult {\n  readonly existence: PathExistence;\n  /** `\"missing\"` のとき、解決に失敗したセグメント */\n  readonly missingSegment: string;\n  /** `\"missing\"` のとき、その階層に実在する兄弟キー（did-you-mean 用） */\n  readonly candidates: readonly string[];\n}\n\nconst UNKNOWN: IPathExistenceResult = Object.freeze({\n  existence: \"unknown\" as const,\n  missingSegment: \"\",\n  candidates: Object.freeze([]) as readonly string[],\n});\n\nconst EXISTS: IPathExistenceResult = Object.freeze({\n  existence: \"exists\" as const,\n  missingSegment: \"\",\n  candidates: Object.freeze([]) as readonly string[],\n});\n\n/**\n * `target` に対して `path` が解決しうるかを、値を読まずに（getter を評価せずに）判定する。\n *\n * 解決の順序は `getByAddress` の実装に合わせる: まず「パス文字列そのものがキーか」\n * （ドットパス getter がこれ）、次にセグメントを 1 つずつ降りる。\n */\nexport function resolvePathExistence(\n  target: object,\n  path: string,\n  declaredPaths: Iterable<string>,\n): IPathExistenceResult {\n  // ドットパス getter / フラットキーの完全一致（`get \"users.*.fullName\"()` 等）\n  if (findDescriptor(target, path) !== undefined) {\n    return EXISTS;\n  }\n  const segments = getPathInfo(path).segments;\n  let current: unknown = target;\n  let prefix = \"\";\n  for (let i = 0; i < segments.length; i++) {\n    const segment = segments[i];\n    const parentPrefix = prefix;\n    prefix = i === 0 ? segment : prefix + DELIMITER + segment;\n    // 途中のプレフィックスがフラット宣言されている（`cart.totalPrice` が getter で、\n    // その戻り値のサブプロパティを読む形）。戻り値の形は評価しないと分からない\n    if (i > 0 && i < segments.length - 1 && findDescriptor(target, prefix) !== undefined) {\n      return UNKNOWN;\n    }\n    // null / undefined / primitive より深い読みは実行時 undefined 解決 = 判定不能。\n    // 「初期値 null のオブジェクトに後から代入する」形を偽陽性で潰さないため\n    if (Object(current) !== current) {\n      return UNKNOWN;\n    }\n    if (segment === WILDCARD) {\n      // 行の形は「いま入っている要素」からしか分からない。空配列・非配列は判定不能\n      if (!Array.isArray(current) || current.length === 0) {\n        return UNKNOWN;\n      }\n      current = current[0];\n      continue;\n    }\n    const descriptor = findDescriptor(current as object, segment);\n    if (typeof descriptor === \"undefined\") {\n      return {\n        existence: \"missing\",\n        missingSegment: segment,\n        candidates: collectCandidates(current as object, parentPrefix, declaredPaths),\n      };\n    }\n    if (typeof descriptor.get === \"function\") {\n      // getter の戻り値の先は評価しないと分からない（末尾なら存在は確定）\n      return i === segments.length - 1 ? EXISTS : UNKNOWN;\n    }\n    current = descriptor.value;\n  }\n  return EXISTS;\n}\n\n/** 同じ (state 要素, パス) の報告は 1 回だけにする台帳 */\nconst reportedPathsByStateElement: WeakMap<IStateElement, Set<string>> = new WeakMap();\n\n/** テスト間の分離用（本番経路からは呼ばれない） */\nexport function clearReportedPaths(stateElement: IStateElement): void {\n  reportedPathsByStateElement.delete(stateElement);\n}\n\n/**\n * state の世代が進んだ（再セット）ときに、この要素の検査済みの印と遅延中の報告を捨てる（#270）。\n *\n * 「パスごとに 1 回」は同じ誤りを更新のたびに報告し続けないための台帳で、世代をまたいで\n * 持ち越す理由は無い。持ち越すと、第 1 世代で検査済みのパスが第 2 世代の state から消えても\n * 無言のままになる。遅延中の報告は前の世代の state で判定した結果なので、あわせて捨てる\n * （呼び手の経路情報の作り直しが、新しい世代で判定し直して積み直す）。公開 getter の登録\n * （`markExportedPath`）はマウント記録の寿命に属するので触らない。\n */\nexport function resetPathDiagnostics(stateElement: IStateElement): void {\n  reportedPathsByStateElement.delete(stateElement);\n  deferredReportsByStateElement.delete(stateElement);\n}\n\nfunction alreadyReported(stateElement: IStateElement, path: string): boolean {\n  let reported = reportedPathsByStateElement.get(stateElement);\n  if (typeof reported === \"undefined\") {\n    reported = new Set<string>();\n    reportedPathsByStateElement.set(stateElement, reported);\n  }\n  if (reported.has(path)) {\n    return true;\n  }\n  reported.add(path);\n  return false;\n}\n\n/**\n * バインド確立時 / `$watch` 宣言時にパスの存在を検査し、確実に存在しないものだけ報告する。\n *\n * 報告は `console.warn` に留める（`raiseError` にしない）:\n * 判定は過小近似とはいえ動的にキーが生える形まで排除できたわけではなく、\n * 既存ページを起動不能にする代償に見合わない。silent を破ることが目的であり、\n * 停止させることではない。\n */\nexport function checkDeclaredPath(\n  stateElement: IStateElement,\n  state: object | undefined,\n  path: string,\n  source: PathInfoSource,\n): void {\n  if (source === \"internal\" || typeof state === \"undefined\") {\n    return;\n  }\n  // `$command` / `$streamStatus` / `$1` 等の予約名前空間は raw state に実体を持たない\n  if (path.startsWith(\"$\")) {\n    return;\n  }\n  // マウントの予約セグメント（`users.*.#m1.editing` — D20）はオーバーレイに実体があり\n  // raw state には無い。`#else`（構造プレースホルダ）も同様（webComponent/mount.ts）\n  if (path.indexOf(\"#\") !== -1) {\n    return;\n  }\n  // 機能が黙らせる領域（予約済みボリュームスロットの配下 — D22。webComponent/addressHooks.ts）は\n  // suppressPathDiagnostic hook に聞く。hook の無い state は判定 1 個で抜ける\n  const hooks = stateElement.addressHooks;\n  if (hooks) {\n    const suppress = hooks.suppressPathDiagnostic;\n    for (let i = 0; i < suppress.length; i++) {\n      if (suppress[i](stateElement, path)) {\n        return;\n      }\n    }\n  }\n\n  // 単一セグメントのバインディングは読み取り時に raiseError で loud に落ちるので、\n  // ここで二重に報告しない。`$watch` は落ちずに黙って発火しないだけなので検査する\n  const segments = getPathInfo(path).segments;\n  if (source === \"binding\" && segments.length < 2) {\n    return;\n  }\n  if (alreadyReported(stateElement, path)) {\n    return;\n  }\n  // 再帰 getter の展開形は、バインド確立の時点ではまだ生えていない（読む直前に\n  // 遅延実体化する — recursion/registry.ts）。素の存在検査では必ず「解決できない」に\n  // なるので、宣言済みの `**` getter に合致するかを先に見る。実体化はしない。\n  // 展開形の**値の内側**（`nodes.*.stats.count` で `get \"nodes.**.stats\"()` がオブジェクトを\n  // 返す形）も同じ — 通常の getter なら下の「途中のプレフィックスがフラット宣言」で\n  // UNKNOWN に倒れるところ、未実体化のアクセサは findDescriptor に見えないのでここで畳む。\n  if (stateElement.hasRecursion === true && stateElement.recursionRegistry!.recursiveGetterOwning(path) !== null) {\n    return;\n  }\n  const result = resolvePathExistence(state, path, stateElement.getterPaths);\n  if (result.existence !== \"missing\") {\n    return;\n  }\n  if (isExportedPath(stateElement, path)) {\n    return;\n  }\n  if (source === \"binding\") {\n    // 遅延報告（docs/state-overlay-export-design.md X7）: バインド確立時点では、その位置に\n    // マウントされるコンポーネントの getter（公開 getter）がまだ登録されていない。\n    // 1 マクロタスク待って、登録で解消しなかったものだけを報告する\n    deferReport(stateElement, path, result);\n    return;\n  }\n  reportMissing(stateElement, path, source, result);\n}\n\ninterface IMissingResult {\n  readonly missingSegment: string;\n  readonly candidates: readonly string[];\n}\n\nconst deferredReportsByStateElement = new WeakMap<IStateElement, Map<string, IMissingResult>>();\nconst flushScheduled = new WeakSet<IStateElement>();\nconst exportedPathsByStateElement = new WeakMap<IStateElement, Set<string>>();\n\n/** 公開 getter の登録（webComponent/exportIndex.ts）— このパスは「存在しない」ではない */\nexport function markExportedPath(stateElement: IStateElement, path: string): void {\n  let paths = exportedPathsByStateElement.get(stateElement);\n  if (typeof paths === \"undefined\") {\n    paths = new Set<string>();\n    exportedPathsByStateElement.set(stateElement, paths);\n  }\n  paths.add(path);\n  deferredReportsByStateElement.get(stateElement)?.delete(path);\n}\n\nfunction isExportedPath(stateElement: IStateElement, path: string): boolean {\n  return exportedPathsByStateElement.get(stateElement)?.has(path) === true;\n}\n\nfunction deferReport(stateElement: IStateElement, path: string, result: IMissingResult): void {\n  let pending = deferredReportsByStateElement.get(stateElement);\n  if (typeof pending === \"undefined\") {\n    pending = new Map();\n    deferredReportsByStateElement.set(stateElement, pending);\n  }\n  pending.set(path, result);\n  if (flushScheduled.has(stateElement)) {\n    return;\n  }\n  flushScheduled.add(stateElement);\n  setTimeout(() => flushDeferredPathReports(stateElement), 0);\n}\n\n/** 遅延中の報告を今すぐ流す（タイマー到達時・テスト用） */\nexport function flushDeferredPathReports(stateElement: IStateElement): void {\n  flushScheduled.delete(stateElement);\n  const pending = deferredReportsByStateElement.get(stateElement);\n  if (typeof pending === \"undefined\") {\n    return;\n  }\n  deferredReportsByStateElement.delete(stateElement);\n  // 登録で解消したものは markExportedPath が pending から消している\n  for (const [path, result] of pending) {\n    reportMissing(stateElement, path, \"binding\", result);\n  }\n}\n\nfunction reportMissing(\n  stateElement: IStateElement,\n  path: string,\n  source: PathInfoSource & (\"binding\" | \"watch\" | \"scan\"),\n  result: IMissingResult,\n): void {\n  // 接頭辞は raiseError と同じ `[@wcstack/state] [wcs/...]` の並び（コンソールの\n  // grep 単位をパッケージで揃える）\n  console.warn(\n    `[@wcstack/state] [${DIAGNOSTIC_CODE[source]}] ${SUBJECT[source]} \"${path}\" does not resolve on the state tree: ` +\n    `\"${result.missingSegment}\" is not declared.${didYouMean(result.missingSegment, result.candidates)}` +\n    ` Updates to this path will be silently dropped.${LINT_HINT}`,\n  );\n  if (devtoolsSink !== null) {\n    devtoolsSink({\n      type: \"state:path-unresolved\",\n      source,\n      path,\n      missingSegment: result.missingSegment,\n    });\n  }\n}\n","/**\n * diagnostics/install.ts — 開発時の診断の install（@wcstack/state/features/diagnostics）。\n * core の受け口（core/diagnosticsHooks.ts）へ、束縛時のパス存在検査を置く。\n */\nimport { IPathDiagnostics, setPathDiagnostics } from \"../core/diagnosticsHooks\";\nimport { checkDeclaredPath, markExportedPath, resetPathDiagnostics } from \"./pathChecks\";\n\n/** 受け口へ置く実装。外へ出す口は `installDiagnostics` だけなので export しない */\nconst pathDiagnosticsFeature: IPathDiagnostics = {\n  check: checkDeclaredPath,\n  reset: resetPathDiagnostics,\n  markExported: markExportedPath,\n};\n\nlet installed = false;\n/** 冪等。full / auto では `bootstrapState()` が呼ぶ */\nexport function installDiagnostics(): void {\n  if (installed) return;\n  installed = true;\n  setPathDiagnostics(pathDiagnosticsFeature);\n}\n","/**\n * features/diagnostics.ts — 開発時の診断（@wcstack/state/features/diagnostics）。\n * 束縛・`$watch`・`$scan` のパスが state に無いときの console.warn（did-you-mean 付き）。\n * 入れなければ何も出さない — `@wcstack/state/core` だけの本番ページの軽量形。\n */\nimport type { IStateFeature } from \"../core/features\";\nimport { installDiagnostics } from \"../diagnostics/install\";\n\nexport const diagnostics: IStateFeature = {\n  name: \"diagnostics\",\n  install(): void {\n    installDiagnostics();\n  },\n};\nexport default diagnostics;\n"],"names":["UNKNOWN","Object","freeze","existence","missingSegment","candidates","EXISTS","reportedPathsByStateElement","WeakMap","deferredReportsByStateElement","flushScheduled","WeakSet","exportedPathsByStateElement","reportMissing","stateElement","path","source","result","console","warn","DIAGNOSTIC_CODE","SUBJECT","didYouMean","LINT_HINT","devtoolsSink","type","pathDiagnosticsFeature","check","state","startsWith","indexOf","hooks","addressHooks","suppress","suppressPathDiagnostic","i","length","segments","getPathInfo","reported","get","Set","set","has","add","alreadyReported","hasRecursion","recursionRegistry","recursiveGetterOwning","target","declaredPaths","undefined","findDescriptor","current","prefix","segment","parentPrefix","DELIMITER","WILDCARD","Array","isArray","descriptor","collectCandidates","value","resolvePathExistence","getterPaths","isExportedPath","pending","Map","setTimeout","delete","flushDeferredPathReports","deferReport","reset","markExported","paths","installed","diagnostics","name","install","setPathDiagnostics"],"mappings":"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"}
+{"version":3,"file":"diagnostics.js","sources":["../../../../../src/diagnostics/pathChecks.ts","../../../../../src/diagnostics/install.ts","../../../../../src/features/diagnostics.ts"],"sourcesContent":["/**\n * diagnostics/pathChecks.ts — バインド / `$watch` / `$scan` 対象パスの存在検査\n * （@wcstack/state/features/diagnostics。silent failure の可視化）。\n *\n * なぜ必要か:\n * `getByAddress` は「親が null / undefined のパスの読み」を undefined で返し、\n * undefined はプロパティ書き込みがスキップされる値なので、`user.nmae` のような\n * 打ち間違いは**エラーも警告も出さずに DOM が更新されない**だけになる。一方で\n * トップレベルの打ち間違い（`cout`）は parentAddress を辿れず raiseError で落ちる。\n * 同じ「パスを打ち間違えた」という 1 つの失敗が、パスの深さで silent / loud に\n * 割れており、書き手からは区別がつかない。ここはその silent 側を埋める。\n *\n * 開発時の診断なので機能として分けてある（full / auto は入れる。`@wcstack/state/core` だけの\n * ページは入れなければ警告を出さない — 本番向けの軽量形）。core の受け口は\n * core/diagnosticsHooks.ts。\n *\n * 精度方針（過小近似）:\n * 「確実に存在しない」と言い切れる場合にだけ報告する。getter の戻り値の先・\n * 空配列・null 親・mapped な `bind-component` など、静的に決められない形はすべて\n * `\"unknown\"` に倒して黙る（偽陽性ゼロ優先。docs/static-wiring-dx-design.md D7 /\n * [ADR-06](../../../docs/architecture-hardening/06-path-type-safety.md) の精度哲学）。\n */\n\nimport { getPathInfo } from \"../address/PathInfo\";\nimport type { IStateElement } from \"../components/types\";\nimport { DELIMITER, WILDCARD } from \"../define\";\nimport { devtoolsSink } from \"../platform/devtoolsSink\";\nimport { didYouMean, LINT_HINT } from \"../errorGuidance\";\nimport {\n  collectCandidates, DIAGNOSTIC_CODE, findDescriptor, indexPathRowPaths, PathInfoSource, SUBJECT,\n} from \"../pathDiagnostics\";\n\nexport type PathExistence = \"exists\" | \"missing\" | \"unknown\";\n\nexport interface IPathExistenceResult {\n  readonly existence: PathExistence;\n  /** `\"missing\"` のとき、解決に失敗したセグメント */\n  readonly missingSegment: string;\n  /** `\"missing\"` のとき、その階層に実在する兄弟キー（did-you-mean 用） */\n  readonly candidates: readonly string[];\n}\n\nconst UNKNOWN: IPathExistenceResult = Object.freeze({\n  existence: \"unknown\" as const,\n  missingSegment: \"\",\n  candidates: Object.freeze([]) as readonly string[],\n});\n\nconst EXISTS: IPathExistenceResult = Object.freeze({\n  existence: \"exists\" as const,\n  missingSegment: \"\",\n  candidates: Object.freeze([]) as readonly string[],\n});\n\n/**\n * `target` に対して `path` が解決しうるかを、値を読まずに（getter を評価せずに）判定する。\n *\n * 解決の順序は `getByAddress` の実装に合わせる: まず「パス文字列そのものがキーか」\n * （ドットパス getter がこれ）、次にセグメントを 1 つずつ降りる。\n *\n * `indexPath` は数値添字の束縛（address/indexPathAccessor.ts の isIndexPath・#332）: いまその位置にある\n * 行を読むので、親が配列なら数値の区切りを `*` として降りる（`items.0.double` は行 getter\n * `items.*.double` を見る。行の形は `*` と同じく先頭の要素で見る）。負の添字のような行になりえない\n * 区切りと、配列でない親（`sales.2024.total`）は素のキーのまま検査する。\n */\nexport function resolvePathExistence(\n  target: object,\n  path: string,\n  declaredPaths: Iterable<string>,\n  indexPath?: boolean,\n): IPathExistenceResult {\n  // ドットパス getter / フラットキーの完全一致（`get \"users.*.fullName\"()` 等）\n  if (findDescriptor(target, path) !== undefined) {\n    return EXISTS;\n  }\n  const segments = getPathInfo(path).segments;\n  let current: unknown = target;\n  let prefix = \"\";\n  for (let i = 0; i < segments.length; i++) {\n    const segment = indexPath && Array.isArray(current) && +segments[i] >= 0 ? WILDCARD : segments[i];\n    const parentPrefix = prefix;\n    prefix = i === 0 ? segment : prefix + DELIMITER + segment;\n    // 途中のプレフィックスがフラット宣言されている（`cart.totalPrice` が getter で、\n    // その戻り値のサブプロパティを読む形）。戻り値の形は評価しないと分からない。\n    // 末尾で当たるのは `*` へ読み替えたパスだけ（読み替えの無いパスは冒頭の完全一致で済んでいる）。\n    // 数値添字の束縛の暗黙の getter（`for: groups.0.items` が生やす — #332）は作者の宣言ではない: いまその\n    // 位置にある行を読むだけなので、それが読む行のパス（`groups.*.items`）の宣言に読み替え、宣言が無ければ\n    // そのままデータを辿る（#388）。作者の宣言は接頭辞そのものの宣言\n    const declared = i > 0 && findDescriptor(target, prefix);\n    const rowPath = declared && indexPathRowPaths.get(declared.get as object);\n    if (declared && (!rowPath || findDescriptor(target, rowPath))) {\n      return i < segments.length - 1 ? UNKNOWN : EXISTS;\n    }\n    // null / undefined / primitive より深い読みは実行時 undefined 解決 = 判定不能。\n    // 「初期値 null のオブジェクトに後から代入する」形を偽陽性で潰さないため\n    if (Object(current) !== current) {\n      return UNKNOWN;\n    }\n    if (segment === WILDCARD) {\n      // 行の形は「いま入っている要素」からしか分からない。空配列・非配列は判定不能\n      if (!Array.isArray(current) || current.length === 0) {\n        return UNKNOWN;\n      }\n      current = current[0];\n      continue;\n    }\n    const descriptor = findDescriptor(current as object, segment);\n    if (typeof descriptor === \"undefined\") {\n      return {\n        existence: \"missing\",\n        missingSegment: segment,\n        candidates: collectCandidates(current as object, parentPrefix, declaredPaths, target),\n      };\n    }\n    if (typeof descriptor.get === \"function\") {\n      // getter の戻り値の先は評価しないと分からない（末尾なら存在は確定）\n      return i === segments.length - 1 ? EXISTS : UNKNOWN;\n    }\n    current = descriptor.value;\n  }\n  return EXISTS;\n}\n\n/** 同じ (state 要素, パス) の報告は 1 回だけにする台帳 */\nconst reportedPathsByStateElement: WeakMap<IStateElement, Set<string>> = new WeakMap();\n\n/** テスト間の分離用（本番経路からは呼ばれない） */\nexport function clearReportedPaths(stateElement: IStateElement): void {\n  reportedPathsByStateElement.delete(stateElement);\n}\n\n/**\n * state の世代が進んだ（再セット）ときに、この要素の検査済みの印と遅延中の報告を捨てる（#270）。\n *\n * 「パスごとに 1 回」は同じ誤りを更新のたびに報告し続けないための台帳で、世代をまたいで\n * 持ち越す理由は無い。持ち越すと、第 1 世代で検査済みのパスが第 2 世代の state から消えても\n * 無言のままになる。遅延中の報告は前の世代の state で判定した結果なので、あわせて捨てる\n * （呼び手の経路情報の作り直しが、新しい世代で判定し直して積み直す）。公開 getter の登録\n * （`markExportedPath`）はマウント記録の寿命に属するので触らない。\n */\nexport function resetPathDiagnostics(stateElement: IStateElement): void {\n  reportedPathsByStateElement.delete(stateElement);\n  deferredReportsByStateElement.delete(stateElement);\n}\n\nfunction alreadyReported(stateElement: IStateElement, path: string): boolean {\n  let reported = reportedPathsByStateElement.get(stateElement);\n  if (typeof reported === \"undefined\") {\n    reported = new Set<string>();\n    reportedPathsByStateElement.set(stateElement, reported);\n  }\n  if (reported.has(path)) {\n    return true;\n  }\n  reported.add(path);\n  return false;\n}\n\n/**\n * バインド確立時 / `$watch` 宣言時にパスの存在を検査し、確実に存在しないものだけ報告する。\n *\n * 報告は `console.warn` に留める（`raiseError` にしない）:\n * 判定は過小近似とはいえ動的にキーが生える形まで排除できたわけではなく、\n * 既存ページを起動不能にする代償に見合わない。silent を破ることが目的であり、\n * 停止させることではない。\n */\nexport function checkDeclaredPath(\n  stateElement: IStateElement,\n  state: object | undefined,\n  path: string,\n  source: PathInfoSource,\n  indexPath?: boolean,\n): void {\n  if (source === \"internal\" || typeof state === \"undefined\") {\n    return;\n  }\n  // `$command` / `$streamStatus` / `$1` 等の予約名前空間は raw state に実体を持たない\n  if (path.startsWith(\"$\")) {\n    return;\n  }\n  // マウントの予約セグメント（`users.*.#m1.editing` — D20）はオーバーレイに実体があり\n  // raw state には無い。`#else`（構造プレースホルダ）も同様（webComponent/mount.ts）\n  if (path.indexOf(\"#\") !== -1) {\n    return;\n  }\n  // 機能が黙らせる領域（予約済みボリュームスロットの配下 — D22。webComponent/addressHooks.ts）は\n  // suppressPathDiagnostic hook に聞く。hook の無い state は判定 1 個で抜ける\n  const hooks = stateElement.addressHooks;\n  if (hooks) {\n    const suppress = hooks.suppressPathDiagnostic;\n    for (let i = 0; i < suppress.length; i++) {\n      if (suppress[i](stateElement, path)) {\n        return;\n      }\n    }\n  }\n\n  // 単一セグメントのバインディングは読み取り時に raiseError で loud に落ちるので、\n  // ここで二重に報告しない。`$watch` は落ちずに黙って発火しないだけなので検査する\n  const segments = getPathInfo(path).segments;\n  if (source === \"binding\" && segments.length < 2) {\n    return;\n  }\n  if (alreadyReported(stateElement, path)) {\n    return;\n  }\n  // 再帰 getter の展開形は、バインド確立の時点ではまだ生えていない（読む直前に\n  // 遅延実体化する — recursion/registry.ts）。素の存在検査では必ず「解決できない」に\n  // なるので、宣言済みの `**` getter に合致するかを先に見る。実体化はしない。\n  // 展開形の**値の内側**（`nodes.*.stats.count` で `get \"nodes.**.stats\"()` がオブジェクトを\n  // 返す形）も同じ — 通常の getter なら下の「途中のプレフィックスがフラット宣言」で\n  // UNKNOWN に倒れるところ、未実体化のアクセサは findDescriptor に見えないのでここで畳む。\n  if (stateElement.hasRecursion === true && stateElement.recursionRegistry!.recursiveGetterOwning(path) !== null) {\n    return;\n  }\n  const result = resolvePathExistence(state, path, stateElement.getterPaths, indexPath);\n  if (result.existence !== \"missing\") {\n    return;\n  }\n  if (isExportedPath(stateElement, path)) {\n    return;\n  }\n  if (source === \"binding\") {\n    // 遅延報告（docs/state-overlay-export-design.md X7）: バインド確立時点では、その位置に\n    // マウントされるコンポーネントの getter（公開 getter）がまだ登録されていない。\n    // 1 マクロタスク待って、登録で解消しなかったものだけを報告する\n    deferReport(stateElement, path, result);\n    return;\n  }\n  reportMissing(stateElement, path, source, result);\n}\n\ninterface IMissingResult {\n  readonly missingSegment: string;\n  readonly candidates: readonly string[];\n}\n\nconst deferredReportsByStateElement = new WeakMap<IStateElement, Map<string, IMissingResult>>();\nconst flushScheduled = new WeakSet<IStateElement>();\nconst exportedPathsByStateElement = new WeakMap<IStateElement, Set<string>>();\n\n/** 公開 getter の登録（webComponent/exportIndex.ts）— このパスは「存在しない」ではない */\nexport function markExportedPath(stateElement: IStateElement, path: string): void {\n  let paths = exportedPathsByStateElement.get(stateElement);\n  if (typeof paths === \"undefined\") {\n    paths = new Set<string>();\n    exportedPathsByStateElement.set(stateElement, paths);\n  }\n  paths.add(path);\n  deferredReportsByStateElement.get(stateElement)?.delete(path);\n}\n\nfunction isExportedPath(stateElement: IStateElement, path: string): boolean {\n  return exportedPathsByStateElement.get(stateElement)?.has(path) === true;\n}\n\nfunction deferReport(stateElement: IStateElement, path: string, result: IMissingResult): void {\n  let pending = deferredReportsByStateElement.get(stateElement);\n  if (typeof pending === \"undefined\") {\n    pending = new Map();\n    deferredReportsByStateElement.set(stateElement, pending);\n  }\n  pending.set(path, result);\n  if (flushScheduled.has(stateElement)) {\n    return;\n  }\n  flushScheduled.add(stateElement);\n  setTimeout(() => flushDeferredPathReports(stateElement), 0);\n}\n\n/** 遅延中の報告を今すぐ流す（タイマー到達時・テスト用） */\nexport function flushDeferredPathReports(stateElement: IStateElement): void {\n  flushScheduled.delete(stateElement);\n  const pending = deferredReportsByStateElement.get(stateElement);\n  if (typeof pending === \"undefined\") {\n    return;\n  }\n  deferredReportsByStateElement.delete(stateElement);\n  // 登録で解消したものは markExportedPath が pending から消している\n  for (const [path, result] of pending) {\n    reportMissing(stateElement, path, \"binding\", result);\n  }\n}\n\nfunction reportMissing(\n  stateElement: IStateElement,\n  path: string,\n  source: PathInfoSource & (\"binding\" | \"watch\" | \"scan\"),\n  result: IMissingResult,\n): void {\n  // 接頭辞は raiseError と同じ `[@wcstack/state] [wcs/...]` の並び（コンソールの\n  // grep 単位をパッケージで揃える）\n  console.warn(\n    `[@wcstack/state] [${DIAGNOSTIC_CODE[source]}] ${SUBJECT[source]} \"${path}\" does not resolve on the state tree: ` +\n    `\"${result.missingSegment}\" is not declared.${didYouMean(result.missingSegment, result.candidates)}` +\n    ` Updates to this path will be silently dropped.${LINT_HINT}`,\n  );\n  if (devtoolsSink !== null) {\n    devtoolsSink({\n      type: \"state:path-unresolved\",\n      source,\n      path,\n      missingSegment: result.missingSegment,\n    });\n  }\n}\n","/**\n * diagnostics/install.ts — 開発時の診断の install（@wcstack/state/features/diagnostics）。\n * core の受け口（core/diagnosticsHooks.ts）へ、束縛時のパス存在検査を置く。\n */\nimport { IPathDiagnostics, setPathDiagnostics } from \"../core/diagnosticsHooks\";\nimport { checkDeclaredPath, markExportedPath, resetPathDiagnostics } from \"./pathChecks\";\n\n/** 受け口へ置く実装。外へ出す口は `installDiagnostics` だけなので export しない */\nconst pathDiagnosticsFeature: IPathDiagnostics = {\n  check: checkDeclaredPath,\n  reset: resetPathDiagnostics,\n  markExported: markExportedPath,\n};\n\nlet installed = false;\n/** 冪等。full / auto では `bootstrapState()` が呼ぶ */\nexport function installDiagnostics(): void {\n  if (installed) return;\n  installed = true;\n  setPathDiagnostics(pathDiagnosticsFeature);\n}\n","/**\n * features/diagnostics.ts — 開発時の診断（@wcstack/state/features/diagnostics）。\n * 束縛・`$watch`・`$scan` のパスが state に無いときの console.warn（did-you-mean 付き）。\n * 入れなければ何も出さない — `@wcstack/state/core` だけの本番ページの軽量形。\n */\nimport type { IStateFeature } from \"../core/features\";\nimport { installDiagnostics } from \"../diagnostics/install\";\n\nexport const diagnostics: IStateFeature = {\n  name: \"diagnostics\",\n  install(): void {\n    installDiagnostics();\n  },\n};\nexport default diagnostics;\n"],"names":["UNKNOWN","Object","freeze","existence","missingSegment","candidates","EXISTS","reportedPathsByStateElement","WeakMap","deferredReportsByStateElement","flushScheduled","WeakSet","exportedPathsByStateElement","reportMissing","stateElement","path","source","result","console","warn","DIAGNOSTIC_CODE","SUBJECT","didYouMean","LINT_HINT","devtoolsSink","type","pathDiagnosticsFeature","check","state","indexPath","startsWith","indexOf","hooks","addressHooks","suppress","suppressPathDiagnostic","i","length","segments","getPathInfo","reported","get","Set","set","has","add","alreadyReported","hasRecursion","recursionRegistry","recursiveGetterOwning","target","declaredPaths","undefined","findDescriptor","current","prefix","segment","Array","isArray","WILDCARD","parentPrefix","DELIMITER","declared","rowPath","indexPathRowPaths","descriptor","collectCandidates","value","resolvePathExistence","getterPaths","isExportedPath","pending","Map","setTimeout","delete","flushDeferredPathReports","deferReport","reset","markExported","paths","installed","diagnostics","name","install","setPathDiagnostics"],"mappings":"oNA0CA,MAAMA,EAAgCC,OAAOC,OAAO,CAClDC,UAAW,UACXC,eAAgB,GAChBC,WAAYJ,OAAOC,OAAO,MAGtBI,EAA+BL,OAAOC,OAAO,CACjDC,UAAW,SACXC,eAAgB,GAChBC,WAAYJ,OAAOC,OAAO,MAyE5B,MAAMK,EAAmE,IAAIC,QAiH7E,MAAMC,EAAgC,IAAID,QACpCE,EAAiB,IAAIC,QACrBC,EAA8B,IAAIJ,QA6CxC,SAASK,EACPC,EACAC,EACAC,EACAC,GAIAC,QAAQC,KACN,qBAAqBC,EAAgBJ,OAAYK,EAAQL,OAAYD,2CACjEE,EAAOb,mCAAmCkB,EAAWL,EAAOb,eAAgBa,EAAOZ,6DACrCkB,KAE/B,OAAjBC,GACFA,EAAa,CACXC,KAAM,wBACNT,SACAD,OACAX,eAAgBa,EAAOb,gBAG7B,CCzSA,MAAMsB,EAA2C,CAC/CC,MD6JI,SACJb,EACAc,EACAb,EACAC,EACAa,GAEA,GAAe,aAAXb,QAA0C,IAAVY,EAClC,OAGF,GAAIb,EAAKe,WAAW,KAClB,OAIF,IAA0B,IAAtBf,EAAKgB,QAAQ,KACf,OAIF,MAAMC,EAAQlB,EAAamB,aAC3B,GAAID,EAAO,CACT,MAAME,EAAWF,EAAMG,uBACvB,IAAK,IAAIC,EAAI,EAAGA,EAAIF,EAASG,OAAQD,IACnC,GAAIF,EAASE,GAAGtB,EAAcC,GAC5B,MAGN,CAIA,MAAMuB,EAAWC,EAAYxB,GAAMuB,SACnC,GAAe,YAAXtB,GAAwBsB,EAASD,OAAS,EAC5C,OAEF,GA1DF,SAAyBvB,EAA6BC,GACpD,IAAIyB,EAAWjC,EAA4BkC,IAAI3B,GAK/C,YAJwB,IAAb0B,IACTA,EAAW,IAAIE,IACfnC,EAA4BoC,IAAI7B,EAAc0B,MAE5CA,EAASI,IAAI7B,KAGjByB,EAASK,IAAI9B,IACN,EACT,CA+CM+B,CAAgBhC,EAAcC,GAChC,OAQF,IAAkC,IAA9BD,EAAaiC,cAAyF,OAAhEjC,EAAakC,kBAAmBC,sBAAsBlC,GAC9F,OAEF,MAAME,EAtJF,SACJiC,EACAnC,EACAoC,EACAtB,GAGA,QAAqCuB,IAAjCC,EAAeH,EAAQnC,GACzB,OAAOT,EAET,MAAMgC,EAAWC,EAAYxB,GAAMuB,SACnC,IAAIgB,EAAmBJ,EACnBK,EAAS,GACb,IAAK,IAAInB,EAAI,EAAGA,EAAIE,EAASD,OAAQD,IAAK,CACxC,MAAMoB,EAAU3B,GAAa4B,MAAMC,QAAQJ,KAAahB,EAASF,IAAM,EAAIuB,EAAWrB,EAASF,GACzFwB,EAAeL,EACrBA,EAAe,IAANnB,EAAUoB,EAAUD,EAASM,EAAYL,EAOlD,MAAMM,EAAW1B,EAAI,GAAKiB,EAAeH,EAAQK,GAC3CQ,EAAUD,GAAYE,EAAkBvB,IAAIqB,EAASrB,KAC3D,GAAIqB,KAAcC,GAAWV,EAAeH,EAAQa,IAClD,OAAO3B,EAAIE,EAASD,OAAS,EAAIrC,EAAUM,EAI7C,GAAIL,OAAOqD,KAAaA,EACtB,OAAOtD,EAET,GAAIwD,IAAYG,EAAU,CAExB,IAAKF,MAAMC,QAAQJ,IAA+B,IAAnBA,EAAQjB,OACrC,OAAOrC,EAETsD,EAAUA,EAAQ,GAClB,QACF,CACA,MAAMW,EAAaZ,EAAeC,EAAmBE,GACrD,QAA0B,IAAfS,EACT,MAAO,CACL9D,UAAW,UACXC,eAAgBoD,EAChBnD,WAAY6D,EAAkBZ,EAAmBM,EAAcT,EAAeD,IAGlF,GAA8B,mBAAnBe,EAAWxB,IAEpB,OAAOL,IAAME,EAASD,OAAS,EAAI/B,EAASN,EAE9CsD,EAAUW,EAAWE,KACvB,CACA,OAAO7D,CACT,CA8FiB8D,CAAqBxC,EAAOb,EAAMD,EAAauD,YAAaxC,GAClD,YAArBZ,EAAOd,YAoCb,SAAwBW,EAA6BC,GACnD,OAAoE,IAA7DH,EAA4B6B,IAAI3B,IAAe8B,IAAI7B,EAC5D,CAnCMuD,CAAexD,EAAcC,KAGlB,YAAXC,EAOJH,EAAcC,EAAcC,EAAMC,EAAQC,GA2B5C,SAAqBH,EAA6BC,EAAcE,GAC9D,IAAIsD,EAAU9D,EAA8BgC,IAAI3B,QACzB,IAAZyD,IACTA,EAAU,IAAIC,IACd/D,EAA8BkC,IAAI7B,EAAcyD,IAGlD,GADAA,EAAQ5B,IAAI5B,EAAME,GACdP,EAAekC,IAAI9B,GACrB,OAEFJ,EAAemC,IAAI/B,GACnB2D,WAAW,IAIP,SAAmC3D,GACvCJ,EAAegE,OAAO5D,GACtB,MAAMyD,EAAU9D,EAA8BgC,IAAI3B,GAClD,QAAuB,IAAZyD,EACT,OAEF9D,EAA8BiE,OAAO5D,GAErC,IAAK,MAAOC,EAAME,KAAWsD,EAC3B1D,EAAcC,EAAcC,EAAM,UAAWE,EAEjD,CAfmB0D,CAAyB7D,GAAe,EAC3D,CA1CI8D,CAAY9D,EAAcC,EAAME,IAIpC,EC5NE4D,MDkII,SAA+B/D,GACnCP,EAA4BmE,OAAO5D,GACnCL,EAA8BiE,OAAO5D,EACvC,ECpIEgE,aDuOI,SAA2BhE,EAA6BC,GAC5D,IAAIgE,EAAQnE,EAA4B6B,IAAI3B,QACvB,IAAViE,IACTA,EAAQ,IAAIrC,IACZ9B,EAA4B+B,IAAI7B,EAAciE,IAEhDA,EAAMlC,IAAI9B,GACVN,EAA8BgC,IAAI3B,IAAe4D,OAAO3D,EAC1D,GC5OA,IAAIiE,GAAY,ECNT,MAAMC,EAA6B,CACxCC,KAAM,cACN,OAAAC,GDOIH,IACJA,GAAY,EACZI,EAAmB1D,GCPnB"}

package/dist/split/features/formats.js

@@ -1,2 +1,2 @@
-import{c as t,b as e}from"../chunks/filterRegistry.js";import{r}from"../chunks/errorGuidance.js";function n(t){r(`filter ${t} requires at least one option`)}function o(t){r(`filter ${t} requires a number as option`)}function a(t){r(`filter ${t} requires a number value`)}function u(t){r(`filter ${t} requires a date value`)}const s={inc:"add",dec:"sub",fix:"toFixed",uc:"upper",lc:"lower",cap:"capitalize",rep:"repeat",rev:"reverse",pad:"padStart",null:"nullIfEmpty"};function i(t){return!(!t||isNaN(Number(t)))}function l(t,e){return i(t)||o(e),Number(t)}function c(t,e,r){return l(t?.[e]??n(r),r)}const p=t=>e=>{const r=t(e);return t=>null==t?t:r(t)},d={eq:(t,e)=>{const r=t?.[0]??n("eq"),a=void 0!==e&&e.length>0?e[0]:r;return t=>"number"==typeof t?"string"!=typeof a?t===a:(i(r)||o("eq"),t===Number(r)):"string"==typeof t?t===r:t===a},ne:(t,e)=>{const r=t?.[0]??n("ne"),a=void 0!==e&&e.length>0?e[0]:r;return t=>"number"==typeof t?"string"!=typeof a?t!==a:(i(r)||o("ne"),t!==Number(r)):"string"==typeof t?t!==r:t!==a},not:t=>t=>!t,lt:t=>{const e=c(t,0,"lt");return t=>("number"!=typeof t&&a("lt"),t<e)},le:t=>{const e=c(t,0,"le");return t=>("number"!=typeof t&&a("le"),t<=e)},gt:t=>{const e=c(t,0,"gt");return t=>("number"!=typeof t&&a("gt"),t>e)},ge:t=>{const e=c(t,0,"ge");return t=>("number"!=typeof t&&a("ge"),t>=e)},add:t=>{const e=c(t,0,"add");return t=>("number"!=typeof t&&a("add"),t+e)},sub:t=>{const e=c(t,0,"sub");return t=>("number"!=typeof t&&a("sub"),t-e)},mul:t=>{const e=c(t,0,"mul");return t=>("number"!=typeof t&&a("mul"),t*e)},div:t=>{const e=c(t,0,"div");return t=>("number"!=typeof t&&a("div"),t/e)},mod:t=>{const e=c(t,0,"mod");return t=>("number"!=typeof t&&a("mod"),t%e)},abs:t=>t=>("number"!=typeof t&&a("abs"),Math.abs(t)),clamp:t=>{const e=c(t,0,"clamp"),r=c(t,1,"clamp");return t=>("number"!=typeof t&&a("clamp"),Math.min(Math.max(t,e),r))},toFixed:t=>{const e=l(t?.[0]??"0","toFixed");return t=>("number"!=typeof t&&a("toFixed"),t.toFixed(e))},locale:e=>{const r=e?.[0];return e=>("number"!=typeof e&&a("locale"),e.toLocaleString(r??t.locale))},upper:p(t=>t=>String(t).toUpperCase()),lower:p(t=>t=>String(t).toLowerCase()),capitalize:p(t=>t=>{const e=String(t);return 0===e.length?e:1===e.length?e.toUpperCase():e.charAt(0).toUpperCase()+e.slice(1)}),trim:p(t=>t=>String(t).trim()),slice:p(t=>{const e=[c(t,0,"slice")],r=t?.[1];return void 0!==r&&e.push(l(r,"slice")),t=>String(t).slice(...e)}),substr:p(t=>{const e=c(t,0,"substr"),r=c(t,1,"substr");return t=>String(t).substr(e,r)}),padStart:p(t=>{const e=c(t,0,"padStart"),r=t?.[1]??"0";return t=>String(t).padStart(e,r)}),padEnd:p(t=>{const e=c(t,0,"padEnd"),r=t?.[1]??" ";return t=>String(t).padEnd(e,r)}),repeat:p(t=>{const e=c(t,0,"repeat");return t=>String(t).repeat(e)}),reverse:p(t=>t=>String(t).split("").reverse().join("")),truncate:p(t=>{const e=c(t,0,"truncate"),r=t?.[1]??"…";return t=>{const n=String(t);return n.length<=e?n:n.slice(0,e)+r}}),join:t=>{const e=t?.[0]??", ";return t=>(Array.isArray(t)||r(`filter ${"join"} requires an array value`),t.join(e))},int:t=>t=>parseInt(String(t),10),float:t=>t=>parseFloat(String(t)),round:t=>{const e=Math.pow(10,l(t?.[0]??"0","round"));return t=>("number"!=typeof t&&a("round"),Math.round(t*e)/e)},floor:t=>{const e=Math.pow(10,l(t?.[0]??"0","floor"));return t=>("number"!=typeof t&&a("floor"),Math.floor(t*e)/e)},ceil:t=>{const e=Math.pow(10,l(t?.[0]??"0","ceil"));return t=>("number"!=typeof t&&a("ceil"),Math.ceil(t*e)/e)},percent:t=>{const e=l(t?.[0]??"0","percent");return t=>("number"!=typeof t&&a("percent"),`${(100*t).toFixed(e)}%`)},unit:p(t=>{const e=t?.[0]??n("unit");return t=>String(t)+e}),date:e=>{const r=e?.[0];return e=>(e instanceof Date||u("date"),e.toLocaleDateString(r??t.locale))},time:e=>{const r=e?.[0];return e=>(e instanceof Date||u("time"),e.toLocaleTimeString(r??t.locale))},datetime:e=>{const r=e?.[0];return e=>(e instanceof Date||u("datetime"),e.toLocaleString(r??t.locale))},ymd:t=>{const e=t?.[0]??"-";return t=>{t instanceof Date||u("ymd");const r=t.getFullYear().toString(),n=(t.getMonth()+1).toString().padStart(2,"0"),o=t.getDate().toString().padStart(2,"0");return`${r}${e}${n}${e}${o}`}},hms:t=>{const e=t?.[0]??":";return t=>{t instanceof Date||u("hms");const r=t.getHours().toString().padStart(2,"0"),n=t.getMinutes().toString().padStart(2,"0"),o=t.getSeconds().toString().padStart(2,"0");return`${r}${e}${n}${e}${o}`}},falsy:t=>t=>!t,truthy:t=>t=>!!t,defaults:(t,e)=>{const r=t?.[0]??n("defaults"),o=void 0!==e&&e.length>0?e[0]:r;return t=>t||o},coalesce:(t,e)=>{const r=t?.[0]??n("coalesce"),o=void 0!==e&&e.length>0?e[0]:r;return t=>t??o},boolean:t=>t=>Boolean(t),number:t=>t=>Number(t),string:t=>t=>String(t),nullIfEmpty:t=>t=>""===t?null:t},m={eq:[1,1],not:[0,0],ne:[1,1],lt:[1,1],le:[1,1],gt:[1,1],ge:[1,1],add:[1,1],sub:[1,1],mul:[1,1],div:[1,1],mod:[1,1],abs:[0,0],clamp:[2,2],toFixed:[0,1],locale:[0,1],upper:[0,0],lower:[0,0],capitalize:[0,0],trim:[0,0],slice:[1,2],substr:[2,2],padStart:[1,2],padEnd:[1,2],repeat:[1,1],reverse:[0,0],truncate:[1,2],join:[0,1],int:[0,0],float:[0,0],round:[0,1],floor:[0,1],ceil:[0,1],percent:[0,1],unit:[1,1],date:[0,1],time:[0,1],datetime:[0,1],ymd:[0,1],hms:[0,1],falsy:[0,0],truthy:[0,0],defaults:[1,1],coalesce:[1,1],boolean:[0,0],number:[0,0],string:[0,0],nullIfEmpty:[0,0]},f=d,g=d;let b=!1;const y={name:"formats",install(){b||(b=!0,e("input",g,m,s),e("output",f,m,s))}};export{y as default,y as formats};
+import{c as t,d as e}from"../chunks/filterRegistry.js";import{r}from"../chunks/errorGuidance.js";function n(t){r(`filter ${t} requires at least one option`)}function o(t){r(`filter ${t} requires a number as option`)}function a(t){r(`filter ${t} requires a number value`)}function u(t){r(`filter ${t} requires a date value`)}const s={inc:"add",dec:"sub",fix:"toFixed",uc:"upper",lc:"lower",cap:"capitalize",rep:"repeat",rev:"reverse",pad:"padStart",null:"nullIfEmpty"};function i(t){return!(!t||isNaN(Number(t)))}function l(t,e){return i(t)||o(e),Number(t)}function c(t,e,r){return l(t?.[e]??n(r),r)}const p=t=>e=>{const r=t(e);return t=>null==t?t:r(t)},d={eq:(t,e)=>{const r=t?.[0]??n("eq"),a=void 0!==e&&e.length>0?e[0]:r;return t=>"number"==typeof t?"string"!=typeof a?t===a:(i(r)||o("eq"),t===Number(r)):"string"==typeof t?t===r:t===a},ne:(t,e)=>{const r=t?.[0]??n("ne"),a=void 0!==e&&e.length>0?e[0]:r;return t=>"number"==typeof t?"string"!=typeof a?t!==a:(i(r)||o("ne"),t!==Number(r)):"string"==typeof t?t!==r:t!==a},not:t=>t=>!t,lt:t=>{const e=c(t,0,"lt");return t=>("number"!=typeof t&&a("lt"),t<e)},le:t=>{const e=c(t,0,"le");return t=>("number"!=typeof t&&a("le"),t<=e)},gt:t=>{const e=c(t,0,"gt");return t=>("number"!=typeof t&&a("gt"),t>e)},ge:t=>{const e=c(t,0,"ge");return t=>("number"!=typeof t&&a("ge"),t>=e)},add:t=>{const e=c(t,0,"add");return t=>("number"!=typeof t&&a("add"),t+e)},sub:t=>{const e=c(t,0,"sub");return t=>("number"!=typeof t&&a("sub"),t-e)},mul:t=>{const e=c(t,0,"mul");return t=>("number"!=typeof t&&a("mul"),t*e)},div:t=>{const e=c(t,0,"div");return t=>("number"!=typeof t&&a("div"),t/e)},mod:t=>{const e=c(t,0,"mod");return t=>("number"!=typeof t&&a("mod"),t%e)},abs:t=>t=>("number"!=typeof t&&a("abs"),Math.abs(t)),clamp:t=>{const e=c(t,0,"clamp"),r=c(t,1,"clamp");return t=>("number"!=typeof t&&a("clamp"),Math.min(Math.max(t,e),r))},toFixed:t=>{const e=l(t?.[0]??"0","toFixed");return t=>("number"!=typeof t&&a("toFixed"),t.toFixed(e))},locale:e=>{const r=e?.[0];return e=>("number"!=typeof e&&a("locale"),e.toLocaleString(r??t.locale))},upper:p(t=>t=>String(t).toUpperCase()),lower:p(t=>t=>String(t).toLowerCase()),capitalize:p(t=>t=>{const e=String(t);return 0===e.length?e:1===e.length?e.toUpperCase():e.charAt(0).toUpperCase()+e.slice(1)}),trim:p(t=>t=>String(t).trim()),slice:p(t=>{const e=[c(t,0,"slice")],r=t?.[1];return void 0!==r&&e.push(l(r,"slice")),t=>String(t).slice(...e)}),substr:p(t=>{const e=c(t,0,"substr"),r=c(t,1,"substr");return t=>String(t).substr(e,r)}),padStart:p(t=>{const e=c(t,0,"padStart"),r=t?.[1]??"0";return t=>String(t).padStart(e,r)}),padEnd:p(t=>{const e=c(t,0,"padEnd"),r=t?.[1]??" ";return t=>String(t).padEnd(e,r)}),repeat:p(t=>{const e=c(t,0,"repeat");return t=>String(t).repeat(e)}),reverse:p(t=>t=>String(t).split("").reverse().join("")),truncate:p(t=>{const e=c(t,0,"truncate"),r=t?.[1]??"…";return t=>{const n=String(t);return n.length<=e?n:n.slice(0,e)+r}}),join:t=>{const e=t?.[0]??", ";return t=>(Array.isArray(t)||r(`filter ${"join"} requires an array value`),t.join(e))},int:t=>t=>parseInt(String(t),10),float:t=>t=>parseFloat(String(t)),round:t=>{const e=Math.pow(10,l(t?.[0]??"0","round"));return t=>("number"!=typeof t&&a("round"),Math.round(t*e)/e)},floor:t=>{const e=Math.pow(10,l(t?.[0]??"0","floor"));return t=>("number"!=typeof t&&a("floor"),Math.floor(t*e)/e)},ceil:t=>{const e=Math.pow(10,l(t?.[0]??"0","ceil"));return t=>("number"!=typeof t&&a("ceil"),Math.ceil(t*e)/e)},percent:t=>{const e=l(t?.[0]??"0","percent");return t=>("number"!=typeof t&&a("percent"),`${(100*t).toFixed(e)}%`)},unit:p(t=>{const e=t?.[0]??n("unit");return t=>String(t)+e}),date:e=>{const r=e?.[0];return e=>(e instanceof Date||u("date"),e.toLocaleDateString(r??t.locale))},time:e=>{const r=e?.[0];return e=>(e instanceof Date||u("time"),e.toLocaleTimeString(r??t.locale))},datetime:e=>{const r=e?.[0];return e=>(e instanceof Date||u("datetime"),e.toLocaleString(r??t.locale))},ymd:t=>{const e=t?.[0]??"-";return t=>{t instanceof Date||u("ymd");const r=t.getFullYear().toString(),n=(t.getMonth()+1).toString().padStart(2,"0"),o=t.getDate().toString().padStart(2,"0");return`${r}${e}${n}${e}${o}`}},hms:t=>{const e=t?.[0]??":";return t=>{t instanceof Date||u("hms");const r=t.getHours().toString().padStart(2,"0"),n=t.getMinutes().toString().padStart(2,"0"),o=t.getSeconds().toString().padStart(2,"0");return`${r}${e}${n}${e}${o}`}},falsy:t=>t=>!t,truthy:t=>t=>!!t,defaults:(t,e)=>{const r=t?.[0]??n("defaults"),o=void 0!==e&&e.length>0?e[0]:r;return t=>t||o},coalesce:(t,e)=>{const r=t?.[0]??n("coalesce"),o=void 0!==e&&e.length>0?e[0]:r;return t=>t??o},boolean:t=>t=>Boolean(t),number:t=>t=>Number(t),string:t=>t=>String(t),nullIfEmpty:t=>t=>""===t?null:t},m={eq:[1,1],not:[0,0],ne:[1,1],lt:[1,1],le:[1,1],gt:[1,1],ge:[1,1],add:[1,1],sub:[1,1],mul:[1,1],div:[1,1],mod:[1,1],abs:[0,0],clamp:[2,2],toFixed:[0,1],locale:[0,1],upper:[0,0],lower:[0,0],capitalize:[0,0],trim:[0,0],slice:[1,2],substr:[2,2],padStart:[1,2],padEnd:[1,2],repeat:[1,1],reverse:[0,0],truncate:[1,2],join:[0,1],int:[0,0],float:[0,0],round:[0,1],floor:[0,1],ceil:[0,1],percent:[0,1],unit:[1,1],date:[0,1],time:[0,1],datetime:[0,1],ymd:[0,1],hms:[0,1],falsy:[0,0],truthy:[0,0],defaults:[1,1],coalesce:[1,1],boolean:[0,0],number:[0,0],string:[0,0],nullIfEmpty:[0,0]},f=d,g=d;let b=!1;const y={name:"formats",install(){b||(b=!0,e("input",g,m,s),e("output",f,m,s))}};export{y as default,y as formats};
 //# sourceMappingURL=formats.js.map