@wcstack/state 3.1.0 → 3.3.0

package/dist/split/chunks/version.js

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

package/dist/split/core.d.ts

@@ -47,7 +47,6 @@ interface ILoopContextStack {
 declare const setLoopContextSymbol: unique symbol;
 declare const getByAddressSymbol: unique symbol;
 declare const hasByAddressSymbol: unique symbol;
-declare const setByAddressSymbol: unique symbol;
 declare const connectedCallbackSymbol: unique symbol;
 declare const disconnectedCallbackSymbol: unique symbol;
 declare const updatedCallbackSymbol: unique symbol;
@@ -86,7 +85,6 @@ interface IStateProxy extends IState {
     [setLoopContextSymbol](loopContext: ILoopContext | null, callback: () => any): any;
     [getByAddressSymbol](address: IStateAddress): any;
     [hasByAddressSymbol](address: IStateAddress): boolean;
-    [setByAddressSymbol](address: IStateAddress, value: any): void;
     [connectedCallbackSymbol](): Promise<void>;
     [disconnectedCallbackSymbol](): void;
     [updatedCallbackSymbol](updatedAbsAddressList: IAbsoluteStateAddress[]): void;
@@ -151,6 +149,16 @@ type WrittenHook = (stateElement: IStateElement, pathInfo: IPathInfo, detail?: {
 type SwappedHook = (stateElement: IStateElement, elementAbsAddress: IAbsoluteStateAddress, displacedAbsAddress: IAbsoluteStateAddress) => void;
 type GetHook = (handler: IStateHandler, prop: string, receiver: any, target: object) => unknown;
 type IndexShiftHook = (handler: IStateHandler, lastAddress: IStateAddress) => number;
+/**
+ * ハンドラが受け取る添字の段数を決める（`event/handler.ts`）。
+ *
+ * **合成は未定義** — この hook は畳み込み（前の hook の結果が次の `wildcardCount` になる）で
+ * 呼ばれるが、現行唯一の実装（`webComponent/addressHooks.ts` の scopes）は「記録が引けて
+ * shift が無ければ 0」を返す**吸収型**で、可換でも結合的でもない。2 つ目の実装が足されると
+ * `0 - shift` のような負値になりうる。**実装は 1 つに保つこと**。2 つ目が要るなら、先に
+ * 「答えを持たない hook は次へ渡す」規約（`NOT_HANDLED` を返す形。`read` / `write` と同じ）
+ * へ寄せてから足す。
+ */
 type HandlerScopeHook = (stateElement: IStateElement, node: Node, rootNode: Node, loopContext: ILoopContext, wildcardCount: number) => number;
 type UpdatedHook = (stateElement: IStateElement, refs: IAbsoluteStateAddress[], receiver: any) => void;
 type SuppressPathDiagnosticHook = (stateElement: IStateElement, path: string) => boolean;
@@ -917,19 +925,23 @@ interface WcsStateApi {
      * 指定パスへの依存関係を明示的に登録する。
      * computed getter 内で動的にパスを組み立てる場合に使用。
      */
-    $trackDependency(path: string): void;
+    $dependOn(path: string): void;
     /**
      * コールバック実行中の依存追跡（動的依存・`$1` インデックス依存の登録）を
-     * 抑止して fn を実行し、その戻り値を返す（`$trackDependency` と対称）。
+     * 抑止して fn を実行し、その戻り値を返す。
      * リスト行 getter が「行外の単一値」を読みたいが、その値の変更で全行を
      * 再評価させたくない場合に使う（該当行へ直接書き込む設計と組で用いる）。
      */
+    $untracked<T>(fn: () => T): T;
+    /** @deprecated `$dependOn` の旧名（3.x の間は動き、4.0 で外れる — 要件 B12） */
+    $trackDependency(path: string): void;
+    /** @deprecated `$untracked` の旧名（3.x の間は動き、4.0 で外れる — 要件 B12） */
     $untrackDependency<T>(fn: () => T): T;
     /**
      * 鍵付き購読: `path` の現在値が `key` に等しいかを返し、評価中のリスト行 getter を
      * その鍵で購読する。`path` への書き込みは旧値・新値の鍵の行だけを再評価する
      * （パターン依存なら全行）。`path` 自体は依存として追跡しない。
-     * 例: `get "items.*.selected"() { return this.$eq("selectedId", this.$untrackDependency(() => this["items.*.id"])); }`
+     * 例: `get "items.*.selected"() { return this.$eq("selectedId", this.$untracked(() => this["items.*.id"])); }`
      */
     $eq(path: string, key: unknown): boolean;
     /**
@@ -954,9 +966,9 @@ interface WcsStateApi {
     readonly $command: Record<string, {
         emit(...args: any[]): any;
     }>;
-    /** `$streams` 各エントリの状態（"idle" | "active" | "done" | "error"）を返す読み取り専用名前空間 */
+    /** `$stream` 各エントリの状態（"idle" | "active" | "done" | "error"）を返す読み取り専用名前空間 */
     readonly $streamStatus: Record<string, "idle" | "active" | "done" | "error">;
-    /** `$streams` 各エントリの直近エラーを返す読み取り専用名前空間 */
+    /** `$stream` 各エントリの直近エラーを返す読み取り専用名前空間 */
     readonly $streamError: Record<string, unknown>;
     readonly [key: `$streamStatus.${string}`]: "idle" | "active" | "done" | "error";
     readonly [key: `$streamError.${string}`]: unknown;
@@ -1055,8 +1067,8 @@ type WcsThis<T> = T & WcsStateApi & WcsPathAccessor<T>;
  *   $disconnectedCallback() {
  *     // cleanup
  *   },
- *   $updatedCallback() {
- *     // called after DOM update
+ *   $renderedCallback() {
+ *     // called after the bindings are applied (old name: $updatedCallback)
  *   }
  * });
  * ```

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 n}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 o}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/setAll.js";import"./chunks/getAllPropertyDescriptors.js";import"./chunks/checkDependency.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),o(r),n()}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/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};
 //# sourceMappingURL=core.js.map

package/dist/split/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sources":["../../../../src/core/bootstrapCore.ts","../../../../src/core/features.ts","../../../../src/defineState.ts"],"sourcesContent":["/**\n * core/bootstrapCore.ts — 機能を 1 つも入れない bootstrap（設計案 §4、`@wcstack/state/core`）。\n *\n * 設定の解決・タグの登録・binder プロトコルの提供だけを行う。機能の install は\n * `installFeatures([...])` の仕事で、full / auto の `bootstrapState()` が全部入れてから\n * これを呼ぶ（従来と同じ順序 — install は要素の定義より前）。\n */\nimport { setConfig } from \"../config\";\nimport { registerBinder } from \"../bindings/binder\";\nimport { registerComponents } from \"../registerComponents\";\nimport { IWritableConfig } from \"../types\";\n\n/**\n * `<html lang>` を既定ロケールとして採る。\n *\n * ロケール依存フィルタ（`locale` / `date` / `time` / `datetime`）は `config.locale`\n * を読むが、それを設定できる公開の入口は `bootstrapState({ locale })` しかない。\n * 一方 `auto` エントリは `bootstrapState()` を引数なしで呼ぶため、CDN 一発\n * （`<script src=\".../@wcstack/state/auto\">`）で読み込んだページには**ロケールを\n * 渡す口が無かった**。auto バンドルは SRI のため自己完結で、別途 `@wcstack/state`\n * を import して `bootstrapState` を呼んでも別インスタンスになり効かない。\n *\n * `<html lang>` はページのロケールを書く HTML 標準の場所であり、SSR ではサーバーが、\n * 静的ページでは head のスニペットが DOM 解析前に書く。そこを既定にすると\n * **ロケールの正本が 1 つになり**、「設定を早く呼ぶ」という守りにくい順序の約束が\n * 「`<html lang>` が state のロードより前にある」という構造的な保証に変わる。\n *\n * 明示指定（`bootstrapState({ locale })`）が常に優先する。\n */\nfunction localeFromDocument(): string | undefined {\n  const lang = document.documentElement?.lang;\n  if (!lang) {\n    return undefined;\n  }\n  try {\n    // 妥当な BCP-47 タグでなければ Intl が RangeError を投げる。不正な lang を\n    // そのまま採ると、これまで既定 'en' で動いていたページのフィルタが実行時に\n    // 落ちる。既定へ落として警告するほうが、黙って壊すより回復しやすい。\n    Intl.getCanonicalLocales(lang);\n    return lang;\n  } catch {\n    console.warn(\n      `[@wcstack/state] <html lang=\"${lang}\"> is not a valid BCP-47 language tag. ` +\n      `Falling back to the default locale for filters.`\n    );\n    return undefined;\n  }\n}\n\nfunction resolveConfig(config?: IWritableConfig): IWritableConfig | undefined {\n  if (typeof config?.locale === \"string\") {\n    return config;\n  }\n  const locale = localeFromDocument();\n  if (locale === undefined) {\n    return config;\n  }\n  return { ...config, locale };\n}\n\nexport function bootstrapCore(config?: IWritableConfig, registry?: CustomElementRegistry): void {\n  const resolved = resolveConfig(config);\n  if (resolved) {\n    setConfig(resolved);\n  }\n  registerComponents(registry);\n  // binder プロトコルの提供（docs/binder-protocol-design.md）。router が後から\n  // 差し込むノードをバインドできるようにする。登録は冪等。\n  registerBinder();\n}\n","/**\n * core/features.ts — 分割エントリの install（設計案 §4、要件 D15）。\n *\n * 機能のエントリは「名前と install を持つ記述子」を export し、ページは要るものだけを入れる:\n *\n * ```js\n * import { bootstrapState, installFeatures } from \"@wcstack/state/core\";\n * import temporal from \"@wcstack/state/features/temporal\";\n * installFeatures([temporal]);\n * bootstrapState();\n * ```\n *\n * full（`@wcstack/state`）と `/auto` は `bootstrapState()` が全機能を入れるので、利用者から見た\n * 挙動は変わらない。\n *\n * **冪等は機能側の `install` が持つ**（どれも `installed` フラグで 2 回目を弾く）。ここで名前を\n * 覚えて重複を弾く手もあるが、同じことを 2 箇所で持つだけで、しかも「`bootstrapState()` を\n * 2 回呼ぶと 2 回目は機能の install に届かない」という観測できる差が増える。core は素直に並べた順に呼ぶ。\n */\nexport interface IStateFeature {\n  /** 機能の名前（受け口のレジストリのキーと同じ。barrier の文言が使う） */\n  readonly name: string;\n  /** 受け口へこの機能の実装を置く。**冪等であること** — core は 2 回呼ぶことがある */\n  install(): void;\n}\n\nexport function installFeatures(features: readonly IStateFeature[]): void {\n  for (let i = 0; i < features.length; i++) {\n    features[i].install();\n  }\n}\n","/**\n * defineState.ts\n *\n * 状態オブジェクトに型付けを提供するためのユーティリティ。\n * defineState() はアイデンティティ関数で、ThisType<> を付与することで\n * メソッド・computed getter 内の this に型補完を提供する。\n *\n * テンプレートリテラル型によるドットパスの型解決:\n * - WcsPaths<T>      : T から生成される全ドットパスの union\n * - WcsPathValue<T,P>: パス P に対応する値の型\n * - WcsPathAccessor<T>: ブラケットアクセス用マップ型\n */\n\n// ============================================================\n// Internal helper types\n// ============================================================\n\n/**\n * `any` 型を検出する。\n * `0 extends (1 & T)` は T が `any` の場合のみ true になる。\n */\ntype IsAny<T> = 0 extends (1 & T) ? true : false;\n\n/**\n * T がドットパス再帰の対象となる「プレーンなデータオブジェクト」かどうかを判定する。\n * プリミティブ、組み込みオブジェクト (Date, Map 等)、関数、配列、any は除外。\n */\ntype IsPlainObject<T> =\n  IsAny<T> extends true ? false :\n  T extends\n    | string | number | boolean | null | undefined | symbol | bigint\n    | ((...args: any[]) => any) | Date | RegExp | Error\n    | Map<any, any> | Set<any> | WeakMap<any, any> | WeakSet<any>\n    | Promise<any> | readonly any[]\n    ? false\n    : T extends Record<string, any>\n      ? true\n      : false;\n\n/**\n * T のキーのうち、関数でないもの（データプロパティ・computed getter）を抽出する。\n * メソッド（イベントハンドラ等）はドットパスの対象外。\n * `$` プレフィックスキー（$streams / $commandTokens / $on 等の予約宣言）もドットパスにならない。\n * any 型のプロパティは除外せず保持する。\n */\ntype DataKeys<T> = {\n  [K in keyof T & string]:\n    K extends `$${string}` ? never :\n    IsAny<T[K]> extends true ? K : T[K] extends (...args: any[]) => any ? never : K;\n}[keyof T & string];\n\n// ============================================================\n// WcsPaths — ドットパスの union 生成\n// ============================================================\n\n/**\n * 型 T から生成される全てのドットパスの union。\n * 配列プロパティはワイルドカード `*` を使用: `items.*.name`\n *\n * 再帰の深さは最大4レベルに制限（コンパイル性能の確保）。\n *\n * @example\n * ```ts\n * type S = {\n *   count: number;\n *   users: { name: string; age: number }[];\n *   cart: { items: { price: number }[] };\n * };\n * type P = WcsPaths<S>;\n * // = \"count\" | \"users\" | \"users.*\" | \"users.*.name\" | \"users.*.age\"\n * //   | \"cart\" | \"cart.items\" | \"cart.items.*\" | \"cart.items.*.price\"\n * ```\n */\nexport type WcsPaths<T, Depth extends readonly any[] = []> =\n  Depth[\"length\"] extends 4 ? never :\n  {\n    [K in DataKeys<T>]:\n      | K\n      | (T[K] extends readonly (infer E)[]\n          ? IsPlainObject<E> extends true\n            ? `${K}.*` | WcsSubPaths<E, `${K}.*.`, [...Depth, 0]>\n            : `${K}.*`\n          : IsPlainObject<T[K]> extends true\n            ? WcsSubPaths<T[K], `${K}.`, [...Depth, 0]>\n            : never)\n  }[DataKeys<T>];\n\n/** @internal プレフィックス付きサブパスの生成ヘルパー */\ntype WcsSubPaths<T, Prefix extends string, Depth extends readonly any[]> =\n  WcsPaths<T, Depth> extends infer P extends string\n    ? `${Prefix}${P}`\n    : never;\n\n// ============================================================\n// WcsPathValue — パスから値の型を解決\n// ============================================================\n\n/**\n * ドットパス P に対応する値の型を T から解決する。\n *\n * 解決順序:\n * 1. T の直接キー（computed getter 含む）\n * 2. `K.*` → 配列要素型\n * 3. `K.rest` → オブジェクト/配列のネストを再帰的に辿る\n *\n * @example\n * ```ts\n * type S = { cart: { items: { price: number; qty: number }[] } };\n * type V1 = WcsPathValue<S, \"cart.items.*.price\">; // number\n * type V2 = WcsPathValue<S, \"cart.items.*\">;        // { price: number; qty: number }\n * type V3 = WcsPathValue<S, \"cart\">;                 // { items: ... }\n * ```\n */\nexport type WcsPathValue<T, P extends string> =\n  // 1. Direct key (includes computed getters like \"users.*.ageCategory\")\n  P extends keyof T\n    ? T[P]\n  // 2. K.* → array element type\n  : P extends `${infer K}.*`\n    ? K extends keyof T\n      ? T[K] extends readonly (infer E)[] ? E : never\n      : never\n  // 3. K.rest → recurse into nested structure\n  : P extends `${infer K}.${infer Rest}`\n    ? K extends keyof T\n      ? T[K] extends readonly (infer E)[]\n        // Array: expect *.subpath or *\n        ? Rest extends `*.${infer SubRest}`\n          ? WcsPathValue<E, SubRest>\n          : Rest extends \"*\"\n            ? E\n            : never\n        // Object: recurse\n        : T[K] extends Record<string, any>\n          ? WcsPathValue<T[K], Rest>\n          : never\n      : never\n    : never;\n\n// ============================================================\n// WcsPathAccessor — ブラケットアクセス用マップ型\n// ============================================================\n\n/**\n * 全ドットパスに対する型付きブラケットアクセスを提供するマップ型。\n *\n * `this[\"users.*.name\"]` のようなアクセスに対して、\n * WcsPaths で生成されたパスに対応する値の型を返す。\n */\ntype WcsPathAccessor<T> = {\n  [P in WcsPaths<T>]: WcsPathValue<T, P>;\n};\n\n// ============================================================\n// State Proxy API — this 経由でアクセスできるAPI\n// ============================================================\n\n/**\n * `<wcs-state>` の Proxy 経由で提供されるAPIメソッド。\n * state定義オブジェクト内のメソッド・getter で `this.` 経由で利用可能。\n */\nexport interface WcsStateApi {\n  /**\n   * ワイルドカードを含むパスにマッチする全要素を配列で取得する。\n   *\n   * @param path - ワイルドカードを含むパス\n   * @param indexes - 各ワイルドカード階層のインデックス（前方一致の接頭辞。`[]` は全階層を展開）。\n   *   省略時はループ文脈の添字（`[$1..$n]` 相当）のうち path と共有するワイルドカード連鎖の\n   *   分が接頭辞として敷かれる（文脈が path より深い分は切り詰め）。共有が無いのに文脈が\n   *   添字を持つ場合は throw する — 異なる文脈の添字は流用しない。\n   *\n   * @example\n   * ```ts\n   * get \"cart.totalPrice\"() {\n   *   return this.$getAll(\"cart.items.*.price\").reduce((sum, v) => sum + v, 0);\n   * }\n   * ```\n   */\n  $getAll<V = any>(path: string, indexes?: number[]): V[];\n\n  /**\n   * ワイルドカードを含むパスにマッチする**全アドレスへ一括で書き込む**（`$getAll` の対称形）。\n   *\n   * 配列を作り直さずに一括更新するための API。`this.users = this.users.map(...)` は\n   * ListIndex・行 getter キャッシュ・差分描画をまとめて作り直すが、`$setAll` は\n   * in-place な個別書き込みに分解するのでリストの同一性が保たれる。\n   *\n   * - `indexes` は `$getAll` と同じ**前方一致の接頭辞**（`[]` で全階層を展開）。省略は不可。\n   * - 関数を渡すと **mapper**（`(current, ...indexes) => next`）として要素ごとに評価される。\n   * - 配列は既定でブロードキャストされる。1 件ずつ配るには `{ spread: true }` を明示する。\n   * - `undefined` を書こうとした要素はスキップされる（クリアは `null`）。\n   *\n   * @returns 実際に書き込んだ件数（`undefined` でスキップした分を含まない）\n   *\n   * @example\n   * ```ts\n   * toggleAll(e: Event) {\n   *   this.$setAll(\"users.*.selected\", [], (e.target as HTMLInputElement).checked);\n   * }\n   * invertAll() {\n   *   this.$setAll(\"users.*.selected\", [], cur => !cur);\n   * }\n   * ```\n   */\n  $setAll<V = any>(\n    path: string,\n    indexes: number[],\n    value: V | ((current: V, ...indexes: number[]) => V | undefined),\n  ): number;\n  $setAll<V = any>(\n    path: string,\n    indexes: number[],\n    values: readonly V[],\n    options: { spread: true },\n  ): number;\n\n  /**\n   * 指定パスの更新を手動でトリガーする。\n   * Proxy の set トラップを経由せずに内部状態を変更した場合に使用。\n   */\n  $postUpdate(path: string): void;\n\n  /**\n   * パスとインデックス配列を指定して、ワイルドカードを解決した値を取得・設定する。\n   *\n   * @param path - ワイルドカードを含むパス\n   * @param indexes - 各ワイルドカード階層のインデックス\n   * @param value - 設定する値（省略時は取得）\n   */\n  $resolve(path: string, indexes: number[], value?: any): any;\n\n  /**\n   * 指定パスへの依存関係を明示的に登録する。\n   * computed getter 内で動的にパスを組み立てる場合に使用。\n   */\n  $trackDependency(path: string): void;\n\n  /**\n   * コールバック実行中の依存追跡（動的依存・`$1` インデックス依存の登録）を\n   * 抑止して fn を実行し、その戻り値を返す（`$trackDependency` と対称）。\n   * リスト行 getter が「行外の単一値」を読みたいが、その値の変更で全行を\n   * 再評価させたくない場合に使う（該当行へ直接書き込む設計と組で用いる）。\n   */\n  $untrackDependency<T>(fn: () => T): T;\n\n  /**\n   * 鍵付き購読: `path` の現在値が `key` に等しいかを返し、評価中のリスト行 getter を\n   * その鍵で購読する。`path` への書き込みは旧値・新値の鍵の行だけを再評価する\n   * （パターン依存なら全行）。`path` 自体は依存として追跡しない。\n   * 例: `get \"items.*.selected\"() { return this.$eq(\"selectedId\", this.$untrackDependency(() => this[\"items.*.id\"])); }`\n   */\n  $eq(path: string, key: unknown): boolean;\n\n  /**\n   * `$eq` の鍵を `keyPath`（ワイルドカードは評価中の行で解決）から依存を張らずに読む形。\n   * 例: `get \"items.*.selected\"() { return this.$eqPath(\"selectedId\", \"items.*.id\"); }`\n   */\n  $eqPath(path: string, keyPath: string): boolean;\n\n  /**\n   * `$eq` の鍵を評価中の行の index（`$1` 相当。`level` でワイルドカード段を選ぶ）にする形。\n   * getter を index 依存には記録せず、行の移動時はリスト差分が鍵を付け替えるので、\n   * 1 行削除で再評価されるのは高々 2 行。\n   * 例: `get \"items.*.selected\"() { return this.$eqIndex(\"selectedIndex\"); }`\n   */\n  $eqIndex(path: string, level?: number): boolean;\n\n  /** `<wcs-state>` 要素への参照 */\n  readonly $stateElement: HTMLElement;\n\n  /**\n   * `$commandTokens` で宣言した command token の名前空間。\n   * `this.$command.<name>` で token を解決できる（バインディングでは\n   * `onclick: $command.<name>` / `command.<method>: $command.<name>`）。\n   */\n  readonly $command: Record<string, { emit(...args: any[]): any }>;\n\n  /** `$streams` 各エントリの状態（\"idle\" | \"active\" | \"done\" | \"error\"）を返す読み取り専用名前空間 */\n  readonly $streamStatus: Record<string, \"idle\" | \"active\" | \"done\" | \"error\">;\n\n  /** `$streams` 各エントリの直近エラーを返す読み取り専用名前空間 */\n  readonly $streamError: Record<string, unknown>;\n\n  // computed getter 内での依存追跡付き読み取りの正規形は dotted パス\n  // （`this[\"$streamStatus.<name>\"]` — docs/state-streams-design.md §4-3）\n  readonly [key: `$streamStatus.${string}`]: \"idle\" | \"active\" | \"done\" | \"error\";\n  readonly [key: `$streamError.${string}`]: unknown;\n\n  // ループインデックス変数 ($1〜$9)\n  // for テンプレート内のイベントハンドラで、ネストされたループの\n  // 各階層のインデックスにアクセスするために使用。\n  // （ランタイムは $1〜$128 まで解決するが、型宣言は実用域の $9 までとする）\n  readonly $1: number;\n  readonly $2: number;\n  readonly $3: number;\n  readonly $4: number;\n  readonly $5: number;\n  readonly $6: number;\n  readonly $7: number;\n  readonly $8: number;\n  readonly $9: number;\n\n  // `$recursion` 宣言済みの再帰パス（`this[\"nodes.**.total\"]`）。深さの族なので\n  // `WcsPaths<T>` の有限展開には現れず、getter のキーに書いた 1 本しか T に現れない。\n  // パターン索引で「`**` を含むキーは読める」とだけ言う（型は any — 深さを型で表せない\n  // 以上、値の型も辿れない）。パターンは `**` を必ず含むので、通常のドットパスの型付けは\n  // 損なわない。VS Code 拡張の preamble（vscode-wcs src/language/preamble.ts）と同じ形 —\n  // 公開型面とエディタの型面は対で保つ。\n  // 素の `nodes.**`（再帰 getter の中でノード自身に束縛される読み）は `.**.` を含まないので、\n  // 末尾が `.**` のキーにも同じ索引を置く。\n  readonly [key: `${string}.**.${string}`]: any;\n  readonly [key: `${string}.**`]: any;\n}\n\n// ============================================================\n// WcsThis — state メソッド/getter 内の this の型\n// ============================================================\n\n/**\n * state定義オブジェクト内の `this` の型。\n *\n * - `T` のプロパティに型付きでアクセス可能（直接キー）\n * - `WcsPathAccessor<T>` によるネストされたドットパスの型付きアクセス\n * - `WcsStateApi` のメソッド ($getAll, $postUpdate 等) にアクセス可能\n * - 動的パス (`this[\\`items.${i}.name\\`]`) は型チェック対象外（キャストが必要）\n *\n * @example\n * ```ts\n * defineState({\n *   count: 0,\n *   users: [] as { name: string; age: number }[],\n *   increment() {\n *     this.count++;                // number\n *     this[\"users.*.name\"];        // string (パス型解決)\n *     this.$getAll(\"users.*.age\"); // API\n *   }\n * });\n * ```\n */\nexport type WcsThis<T> = T & WcsStateApi & WcsPathAccessor<T>;\n\n// ============================================================\n// defineState — 型付き状態定義関数\n// ============================================================\n\n/**\n * `<wcs-state>` 用の型付き状態オブジェクトを定義する。\n *\n * ランタイムではアイデンティティ関数（引数をそのまま返す）として動作し、\n * コストはゼロ。TypeScript の `ThisType<>` を利用して、メソッド・getter 内の\n * `this` に型補完を提供する。\n *\n * ### 基本的な使い方 (TypeScript)\n * ```ts\n * import { defineState } from '@wcstack/state';\n *\n * export default defineState({\n *   count: 0,\n *   users: [] as { name: string; age: number }[],\n *\n *   increment() {\n *     this.count++;            // ✅ number\n *     this[\"users.*.name\"];    // ✅ string (ドットパス型解決)\n *   },\n *\n *   get \"users.*.ageCategory\"() {\n *     return this[\"users.*.age\"] < 25 ? \"Young\" : \"Adult\";\n *   }\n * });\n * ```\n *\n * ### JavaScript (JSDoc)\n * ```js\n * import { defineState } from '@wcstack/state';\n *\n * export default defineState({\n *   count: 0,\n *   increment() {\n *     this.count++;  // ✅ JSDoc + tsconfig checkJs で型補完\n *   }\n * });\n * ```\n *\n * ### HTML インラインスクリプト\n * ```html\n * <wcs-state>\n *   <script type=\"module\">\n *     import { defineState } from '@wcstack/state';\n *     export default defineState({\n *       count: 0,\n *       increment() { this.count++; }\n *     });\n *   </script>\n * </wcs-state>\n * ```\n *\n * ### ライフサイクルコールバック\n * ```ts\n * export default defineState({\n *   data: null,\n *   async $connectedCallback() {\n *     this.data = await fetch('/api/data').then(r => r.json());\n *   },\n *   $disconnectedCallback() {\n *     // cleanup\n *   },\n *   $updatedCallback() {\n *     // called after DOM update\n *   }\n * });\n * ```\n */\nexport function defineState<T extends Record<string, any>>(\n  definition: T & ThisType<WcsThis<T>>\n): T {\n  return definition;\n}\n"],"names":["resolveConfig","config","locale","lang","document","documentElement","Intl","getCanonicalLocales","console","warn","localeFromDocument","undefined","bootstrapCore","registry","resolved","setConfig","registerComponents","registerBinder","installFeatures","features","i","length","install","defineState","definition"],"mappings":"uoBAiDA,SAASA,EAAcC,GACrB,GAA8B,iBAAnBA,GAAQC,OACjB,OAAOD,EAET,MAAMC,EAxBR,WACE,MAAMC,EAAOC,SAASC,iBAAiBF,KACvC,GAAKA,EAGL,IAKE,OADAG,KAAKC,oBAAoBJ,GAClBA,CACT,CAAE,MAKA,YAJAK,QAAQC,KACN,gCAAgCN,0FAIpC,CACF,CAMiBO,GACf,YAAeC,IAAXT,EACKD,EAEF,IAAKA,EAAQC,SACtB,CAEM,SAAUU,EAAcX,EAA0BY,GACtD,MAAMC,EAAWd,EAAcC,GAC3Ba,GACFC,EAAUD,GAEZE,EAAmBH,GAGnBI,GACF,CC3CM,SAAUC,EAAgBC,GAC9B,IAAK,IAAIC,EAAI,EAAGA,EAAID,EAASE,OAAQD,IACnCD,EAASC,GAAGE,SAEhB,CC8XM,SAAUC,EACdC,GAEA,OAAOA,CACT"}
+{"version":3,"file":"core.js","sources":["../../../../src/core/bootstrapCore.ts","../../../../src/core/features.ts","../../../../src/defineState.ts"],"sourcesContent":["/**\n * core/bootstrapCore.ts — 機能を 1 つも入れない bootstrap（設計案 §4、`@wcstack/state/core`）。\n *\n * 設定の解決・タグの登録・binder プロトコルの提供だけを行う。機能の install は\n * `installFeatures([...])` の仕事で、full / auto の `bootstrapState()` が全部入れてから\n * これを呼ぶ（従来と同じ順序 — install は要素の定義より前）。\n */\nimport { setConfig } from \"../config\";\nimport { registerBinder } from \"../bindings/binder\";\nimport { registerComponents } from \"../registerComponents\";\nimport { IWritableConfig } from \"../types\";\n\n/**\n * `<html lang>` を既定ロケールとして採る。\n *\n * ロケール依存フィルタ（`locale` / `date` / `time` / `datetime`）は `config.locale`\n * を読むが、それを設定できる公開の入口は `bootstrapState({ locale })` しかない。\n * 一方 `auto` エントリは `bootstrapState()` を引数なしで呼ぶため、CDN 一発\n * （`<script src=\".../@wcstack/state/auto\">`）で読み込んだページには**ロケールを\n * 渡す口が無かった**。auto バンドルは SRI のため自己完結で、別途 `@wcstack/state`\n * を import して `bootstrapState` を呼んでも別インスタンスになり効かない。\n *\n * `<html lang>` はページのロケールを書く HTML 標準の場所であり、SSR ではサーバーが、\n * 静的ページでは head のスニペットが DOM 解析前に書く。そこを既定にすると\n * **ロケールの正本が 1 つになり**、「設定を早く呼ぶ」という守りにくい順序の約束が\n * 「`<html lang>` が state のロードより前にある」という構造的な保証に変わる。\n *\n * 明示指定（`bootstrapState({ locale })`）が常に優先する。\n */\nfunction localeFromDocument(): string | undefined {\n  const lang = document.documentElement?.lang;\n  if (!lang) {\n    return undefined;\n  }\n  try {\n    // 妥当な BCP-47 タグでなければ Intl が RangeError を投げる。不正な lang を\n    // そのまま採ると、これまで既定 'en' で動いていたページのフィルタが実行時に\n    // 落ちる。既定へ落として警告するほうが、黙って壊すより回復しやすい。\n    Intl.getCanonicalLocales(lang);\n    return lang;\n  } catch {\n    console.warn(\n      `[@wcstack/state] <html lang=\"${lang}\"> is not a valid BCP-47 language tag. ` +\n      `Falling back to the default locale for filters.`\n    );\n    return undefined;\n  }\n}\n\nfunction resolveConfig(config?: IWritableConfig): IWritableConfig | undefined {\n  if (typeof config?.locale === \"string\") {\n    return config;\n  }\n  const locale = localeFromDocument();\n  if (locale === undefined) {\n    return config;\n  }\n  return { ...config, locale };\n}\n\nexport function bootstrapCore(config?: IWritableConfig, registry?: CustomElementRegistry): void {\n  const resolved = resolveConfig(config);\n  if (resolved) {\n    setConfig(resolved);\n  }\n  registerComponents(registry);\n  // binder プロトコルの提供（docs/binder-protocol-design.md）。router が後から\n  // 差し込むノードをバインドできるようにする。登録は冪等。\n  registerBinder();\n}\n","/**\n * core/features.ts — 分割エントリの install（設計案 §4、要件 D15）。\n *\n * 機能のエントリは「名前と install を持つ記述子」を export し、ページは要るものだけを入れる:\n *\n * ```js\n * import { bootstrapState, installFeatures } from \"@wcstack/state/core\";\n * import temporal from \"@wcstack/state/features/temporal\";\n * installFeatures([temporal]);\n * bootstrapState();\n * ```\n *\n * full（`@wcstack/state`）と `/auto` は `bootstrapState()` が全機能を入れるので、利用者から見た\n * 挙動は変わらない。\n *\n * **冪等は機能側の `install` が持つ**（どれも `installed` フラグで 2 回目を弾く）。ここで名前を\n * 覚えて重複を弾く手もあるが、同じことを 2 箇所で持つだけで、しかも「`bootstrapState()` を\n * 2 回呼ぶと 2 回目は機能の install に届かない」という観測できる差が増える。core は素直に並べた順に呼ぶ。\n */\nexport interface IStateFeature {\n  /** 機能の名前（受け口のレジストリのキーと同じ。barrier の文言が使う） */\n  readonly name: string;\n  /** 受け口へこの機能の実装を置く。**冪等であること** — core は 2 回呼ぶことがある */\n  install(): void;\n}\n\nexport function installFeatures(features: readonly IStateFeature[]): void {\n  for (let i = 0; i < features.length; i++) {\n    features[i].install();\n  }\n}\n","/**\n * defineState.ts\n *\n * 状態オブジェクトに型付けを提供するためのユーティリティ。\n * defineState() はアイデンティティ関数で、ThisType<> を付与することで\n * メソッド・computed getter 内の this に型補完を提供する。\n *\n * テンプレートリテラル型によるドットパスの型解決:\n * - WcsPaths<T>      : T から生成される全ドットパスの union\n * - WcsPathValue<T,P>: パス P に対応する値の型\n * - WcsPathAccessor<T>: ブラケットアクセス用マップ型\n */\n\n// ============================================================\n// Internal helper types\n// ============================================================\n\n/**\n * `any` 型を検出する。\n * `0 extends (1 & T)` は T が `any` の場合のみ true になる。\n */\ntype IsAny<T> = 0 extends (1 & T) ? true : false;\n\n/**\n * T がドットパス再帰の対象となる「プレーンなデータオブジェクト」かどうかを判定する。\n * プリミティブ、組み込みオブジェクト (Date, Map 等)、関数、配列、any は除外。\n */\ntype IsPlainObject<T> =\n  IsAny<T> extends true ? false :\n  T extends\n    | string | number | boolean | null | undefined | symbol | bigint\n    | ((...args: any[]) => any) | Date | RegExp | Error\n    | Map<any, any> | Set<any> | WeakMap<any, any> | WeakSet<any>\n    | Promise<any> | readonly any[]\n    ? false\n    : T extends Record<string, any>\n      ? true\n      : false;\n\n/**\n * T のキーのうち、関数でないもの（データプロパティ・computed getter）を抽出する。\n * メソッド（イベントハンドラ等）はドットパスの対象外。\n * `$` プレフィックスキー（$streams / $commandTokens / $on 等の予約宣言）もドットパスにならない。\n * any 型のプロパティは除外せず保持する。\n */\ntype DataKeys<T> = {\n  [K in keyof T & string]:\n    K extends `$${string}` ? never :\n    IsAny<T[K]> extends true ? K : T[K] extends (...args: any[]) => any ? never : K;\n}[keyof T & string];\n\n// ============================================================\n// WcsPaths — ドットパスの union 生成\n// ============================================================\n\n/**\n * 型 T から生成される全てのドットパスの union。\n * 配列プロパティはワイルドカード `*` を使用: `items.*.name`\n *\n * 再帰の深さは最大4レベルに制限（コンパイル性能の確保）。\n *\n * @example\n * ```ts\n * type S = {\n *   count: number;\n *   users: { name: string; age: number }[];\n *   cart: { items: { price: number }[] };\n * };\n * type P = WcsPaths<S>;\n * // = \"count\" | \"users\" | \"users.*\" | \"users.*.name\" | \"users.*.age\"\n * //   | \"cart\" | \"cart.items\" | \"cart.items.*\" | \"cart.items.*.price\"\n * ```\n */\nexport type WcsPaths<T, Depth extends readonly any[] = []> =\n  Depth[\"length\"] extends 4 ? never :\n  {\n    [K in DataKeys<T>]:\n      | K\n      | (T[K] extends readonly (infer E)[]\n          ? IsPlainObject<E> extends true\n            ? `${K}.*` | WcsSubPaths<E, `${K}.*.`, [...Depth, 0]>\n            : `${K}.*`\n          : IsPlainObject<T[K]> extends true\n            ? WcsSubPaths<T[K], `${K}.`, [...Depth, 0]>\n            : never)\n  }[DataKeys<T>];\n\n/** @internal プレフィックス付きサブパスの生成ヘルパー */\ntype WcsSubPaths<T, Prefix extends string, Depth extends readonly any[]> =\n  WcsPaths<T, Depth> extends infer P extends string\n    ? `${Prefix}${P}`\n    : never;\n\n// ============================================================\n// WcsPathValue — パスから値の型を解決\n// ============================================================\n\n/**\n * ドットパス P に対応する値の型を T から解決する。\n *\n * 解決順序:\n * 1. T の直接キー（computed getter 含む）\n * 2. `K.*` → 配列要素型\n * 3. `K.rest` → オブジェクト/配列のネストを再帰的に辿る\n *\n * @example\n * ```ts\n * type S = { cart: { items: { price: number; qty: number }[] } };\n * type V1 = WcsPathValue<S, \"cart.items.*.price\">; // number\n * type V2 = WcsPathValue<S, \"cart.items.*\">;        // { price: number; qty: number }\n * type V3 = WcsPathValue<S, \"cart\">;                 // { items: ... }\n * ```\n */\nexport type WcsPathValue<T, P extends string> =\n  // 1. Direct key (includes computed getters like \"users.*.ageCategory\")\n  P extends keyof T\n    ? T[P]\n  // 2. K.* → array element type\n  : P extends `${infer K}.*`\n    ? K extends keyof T\n      ? T[K] extends readonly (infer E)[] ? E : never\n      : never\n  // 3. K.rest → recurse into nested structure\n  : P extends `${infer K}.${infer Rest}`\n    ? K extends keyof T\n      ? T[K] extends readonly (infer E)[]\n        // Array: expect *.subpath or *\n        ? Rest extends `*.${infer SubRest}`\n          ? WcsPathValue<E, SubRest>\n          : Rest extends \"*\"\n            ? E\n            : never\n        // Object: recurse\n        : T[K] extends Record<string, any>\n          ? WcsPathValue<T[K], Rest>\n          : never\n      : never\n    : never;\n\n// ============================================================\n// WcsPathAccessor — ブラケットアクセス用マップ型\n// ============================================================\n\n/**\n * 全ドットパスに対する型付きブラケットアクセスを提供するマップ型。\n *\n * `this[\"users.*.name\"]` のようなアクセスに対して、\n * WcsPaths で生成されたパスに対応する値の型を返す。\n */\ntype WcsPathAccessor<T> = {\n  [P in WcsPaths<T>]: WcsPathValue<T, P>;\n};\n\n// ============================================================\n// State Proxy API — this 経由でアクセスできるAPI\n// ============================================================\n\n/**\n * `<wcs-state>` の Proxy 経由で提供されるAPIメソッド。\n * state定義オブジェクト内のメソッド・getter で `this.` 経由で利用可能。\n */\nexport interface WcsStateApi {\n  /**\n   * ワイルドカードを含むパスにマッチする全要素を配列で取得する。\n   *\n   * @param path - ワイルドカードを含むパス\n   * @param indexes - 各ワイルドカード階層のインデックス（前方一致の接頭辞。`[]` は全階層を展開）。\n   *   省略時はループ文脈の添字（`[$1..$n]` 相当）のうち path と共有するワイルドカード連鎖の\n   *   分が接頭辞として敷かれる（文脈が path より深い分は切り詰め）。共有が無いのに文脈が\n   *   添字を持つ場合は throw する — 異なる文脈の添字は流用しない。\n   *\n   * @example\n   * ```ts\n   * get \"cart.totalPrice\"() {\n   *   return this.$getAll(\"cart.items.*.price\").reduce((sum, v) => sum + v, 0);\n   * }\n   * ```\n   */\n  $getAll<V = any>(path: string, indexes?: number[]): V[];\n\n  /**\n   * ワイルドカードを含むパスにマッチする**全アドレスへ一括で書き込む**（`$getAll` の対称形）。\n   *\n   * 配列を作り直さずに一括更新するための API。`this.users = this.users.map(...)` は\n   * ListIndex・行 getter キャッシュ・差分描画をまとめて作り直すが、`$setAll` は\n   * in-place な個別書き込みに分解するのでリストの同一性が保たれる。\n   *\n   * - `indexes` は `$getAll` と同じ**前方一致の接頭辞**（`[]` で全階層を展開）。省略は不可。\n   * - 関数を渡すと **mapper**（`(current, ...indexes) => next`）として要素ごとに評価される。\n   * - 配列は既定でブロードキャストされる。1 件ずつ配るには `{ spread: true }` を明示する。\n   * - `undefined` を書こうとした要素はスキップされる（クリアは `null`）。\n   *\n   * @returns 実際に書き込んだ件数（`undefined` でスキップした分を含まない）\n   *\n   * @example\n   * ```ts\n   * toggleAll(e: Event) {\n   *   this.$setAll(\"users.*.selected\", [], (e.target as HTMLInputElement).checked);\n   * }\n   * invertAll() {\n   *   this.$setAll(\"users.*.selected\", [], cur => !cur);\n   * }\n   * ```\n   */\n  $setAll<V = any>(\n    path: string,\n    indexes: number[],\n    value: V | ((current: V, ...indexes: number[]) => V | undefined),\n  ): number;\n  $setAll<V = any>(\n    path: string,\n    indexes: number[],\n    values: readonly V[],\n    options: { spread: true },\n  ): number;\n\n  /**\n   * 指定パスの更新を手動でトリガーする。\n   * Proxy の set トラップを経由せずに内部状態を変更した場合に使用。\n   */\n  $postUpdate(path: string): void;\n\n  /**\n   * パスとインデックス配列を指定して、ワイルドカードを解決した値を取得・設定する。\n   *\n   * @param path - ワイルドカードを含むパス\n   * @param indexes - 各ワイルドカード階層のインデックス\n   * @param value - 設定する値（省略時は取得）\n   */\n  $resolve(path: string, indexes: number[], value?: any): any;\n\n  /**\n   * 指定パスへの依存関係を明示的に登録する。\n   * computed getter 内で動的にパスを組み立てる場合に使用。\n   */\n  $dependOn(path: string): void;\n\n  /**\n   * コールバック実行中の依存追跡（動的依存・`$1` インデックス依存の登録）を\n   * 抑止して fn を実行し、その戻り値を返す。\n   * リスト行 getter が「行外の単一値」を読みたいが、その値の変更で全行を\n   * 再評価させたくない場合に使う（該当行へ直接書き込む設計と組で用いる）。\n   */\n  $untracked<T>(fn: () => T): T;\n\n  /** @deprecated `$dependOn` の旧名（3.x の間は動き、4.0 で外れる — 要件 B12） */\n  $trackDependency(path: string): void;\n\n  /** @deprecated `$untracked` の旧名（3.x の間は動き、4.0 で外れる — 要件 B12） */\n  $untrackDependency<T>(fn: () => T): T;\n\n  /**\n   * 鍵付き購読: `path` の現在値が `key` に等しいかを返し、評価中のリスト行 getter を\n   * その鍵で購読する。`path` への書き込みは旧値・新値の鍵の行だけを再評価する\n   * （パターン依存なら全行）。`path` 自体は依存として追跡しない。\n   * 例: `get \"items.*.selected\"() { return this.$eq(\"selectedId\", this.$untracked(() => this[\"items.*.id\"])); }`\n   */\n  $eq(path: string, key: unknown): boolean;\n\n  /**\n   * `$eq` の鍵を `keyPath`（ワイルドカードは評価中の行で解決）から依存を張らずに読む形。\n   * 例: `get \"items.*.selected\"() { return this.$eqPath(\"selectedId\", \"items.*.id\"); }`\n   */\n  $eqPath(path: string, keyPath: string): boolean;\n\n  /**\n   * `$eq` の鍵を評価中の行の index（`$1` 相当。`level` でワイルドカード段を選ぶ）にする形。\n   * getter を index 依存には記録せず、行の移動時はリスト差分が鍵を付け替えるので、\n   * 1 行削除で再評価されるのは高々 2 行。\n   * 例: `get \"items.*.selected\"() { return this.$eqIndex(\"selectedIndex\"); }`\n   */\n  $eqIndex(path: string, level?: number): boolean;\n\n  /** `<wcs-state>` 要素への参照 */\n  readonly $stateElement: HTMLElement;\n\n  /**\n   * `$commandTokens` で宣言した command token の名前空間。\n   * `this.$command.<name>` で token を解決できる（バインディングでは\n   * `onclick: $command.<name>` / `command.<method>: $command.<name>`）。\n   */\n  readonly $command: Record<string, { emit(...args: any[]): any }>;\n\n  /** `$stream` 各エントリの状態（\"idle\" | \"active\" | \"done\" | \"error\"）を返す読み取り専用名前空間 */\n  readonly $streamStatus: Record<string, \"idle\" | \"active\" | \"done\" | \"error\">;\n\n  /** `$stream` 各エントリの直近エラーを返す読み取り専用名前空間 */\n  readonly $streamError: Record<string, unknown>;\n\n  // computed getter 内での依存追跡付き読み取りの正規形は dotted パス\n  // （`this[\"$streamStatus.<name>\"]` — docs/state-streams-design.md §4-3）\n  readonly [key: `$streamStatus.${string}`]: \"idle\" | \"active\" | \"done\" | \"error\";\n  readonly [key: `$streamError.${string}`]: unknown;\n\n  // ループインデックス変数 ($1〜$9)\n  // for テンプレート内のイベントハンドラで、ネストされたループの\n  // 各階層のインデックスにアクセスするために使用。\n  // （ランタイムは $1〜$128 まで解決するが、型宣言は実用域の $9 までとする）\n  readonly $1: number;\n  readonly $2: number;\n  readonly $3: number;\n  readonly $4: number;\n  readonly $5: number;\n  readonly $6: number;\n  readonly $7: number;\n  readonly $8: number;\n  readonly $9: number;\n\n  // `$recursion` 宣言済みの再帰パス（`this[\"nodes.**.total\"]`）。深さの族なので\n  // `WcsPaths<T>` の有限展開には現れず、getter のキーに書いた 1 本しか T に現れない。\n  // パターン索引で「`**` を含むキーは読める」とだけ言う（型は any — 深さを型で表せない\n  // 以上、値の型も辿れない）。パターンは `**` を必ず含むので、通常のドットパスの型付けは\n  // 損なわない。VS Code 拡張の preamble（vscode-wcs src/language/preamble.ts）と同じ形 —\n  // 公開型面とエディタの型面は対で保つ。\n  // 素の `nodes.**`（再帰 getter の中でノード自身に束縛される読み）は `.**.` を含まないので、\n  // 末尾が `.**` のキーにも同じ索引を置く。\n  readonly [key: `${string}.**.${string}`]: any;\n  readonly [key: `${string}.**`]: any;\n}\n\n// ============================================================\n// WcsThis — state メソッド/getter 内の this の型\n// ============================================================\n\n/**\n * state定義オブジェクト内の `this` の型。\n *\n * - `T` のプロパティに型付きでアクセス可能（直接キー）\n * - `WcsPathAccessor<T>` によるネストされたドットパスの型付きアクセス\n * - `WcsStateApi` のメソッド ($getAll, $postUpdate 等) にアクセス可能\n * - 動的パス (`this[\\`items.${i}.name\\`]`) は型チェック対象外（キャストが必要）\n *\n * @example\n * ```ts\n * defineState({\n *   count: 0,\n *   users: [] as { name: string; age: number }[],\n *   increment() {\n *     this.count++;                // number\n *     this[\"users.*.name\"];        // string (パス型解決)\n *     this.$getAll(\"users.*.age\"); // API\n *   }\n * });\n * ```\n */\nexport type WcsThis<T> = T & WcsStateApi & WcsPathAccessor<T>;\n\n// ============================================================\n// defineState — 型付き状態定義関数\n// ============================================================\n\n/**\n * `<wcs-state>` 用の型付き状態オブジェクトを定義する。\n *\n * ランタイムではアイデンティティ関数（引数をそのまま返す）として動作し、\n * コストはゼロ。TypeScript の `ThisType<>` を利用して、メソッド・getter 内の\n * `this` に型補完を提供する。\n *\n * ### 基本的な使い方 (TypeScript)\n * ```ts\n * import { defineState } from '@wcstack/state';\n *\n * export default defineState({\n *   count: 0,\n *   users: [] as { name: string; age: number }[],\n *\n *   increment() {\n *     this.count++;            // ✅ number\n *     this[\"users.*.name\"];    // ✅ string (ドットパス型解決)\n *   },\n *\n *   get \"users.*.ageCategory\"() {\n *     return this[\"users.*.age\"] < 25 ? \"Young\" : \"Adult\";\n *   }\n * });\n * ```\n *\n * ### JavaScript (JSDoc)\n * ```js\n * import { defineState } from '@wcstack/state';\n *\n * export default defineState({\n *   count: 0,\n *   increment() {\n *     this.count++;  // ✅ JSDoc + tsconfig checkJs で型補完\n *   }\n * });\n * ```\n *\n * ### HTML インラインスクリプト\n * ```html\n * <wcs-state>\n *   <script type=\"module\">\n *     import { defineState } from '@wcstack/state';\n *     export default defineState({\n *       count: 0,\n *       increment() { this.count++; }\n *     });\n *   </script>\n * </wcs-state>\n * ```\n *\n * ### ライフサイクルコールバック\n * ```ts\n * export default defineState({\n *   data: null,\n *   async $connectedCallback() {\n *     this.data = await fetch('/api/data').then(r => r.json());\n *   },\n *   $disconnectedCallback() {\n *     // cleanup\n *   },\n *   $renderedCallback() {\n *     // called after the bindings are applied (old name: $updatedCallback)\n *   }\n * });\n * ```\n */\nexport function defineState<T extends Record<string, any>>(\n  definition: T & ThisType<WcsThis<T>>\n): T {\n  return definition;\n}\n"],"names":["resolveConfig","config","locale","lang","document","documentElement","Intl","getCanonicalLocales","console","warn","localeFromDocument","undefined","bootstrapCore","registry","resolved","setConfig","registerComponents","registerBinder","installFeatures","features","i","length","install","defineState","definition"],"mappings":"mtBAiDA,SAASA,EAAcC,GACrB,GAA8B,iBAAnBA,GAAQC,OACjB,OAAOD,EAET,MAAMC,EAxBR,WACE,MAAMC,EAAOC,SAASC,iBAAiBF,KACvC,GAAKA,EAGL,IAKE,OADAG,KAAKC,oBAAoBJ,GAClBA,CACT,CAAE,MAKA,YAJAK,QAAQC,KACN,gCAAgCN,0FAIpC,CACF,CAMiBO,GACf,YAAeC,IAAXT,EACKD,EAEF,IAAKA,EAAQC,SACtB,CAEM,SAAUU,EAAcX,EAA0BY,GACtD,MAAMC,EAAWd,EAAcC,GAC3Ba,GACFC,EAAUD,GAEZE,EAAmBH,GAGnBI,GACF,CC3CM,SAAUC,EAAgBC,GAC9B,IAAK,IAAIC,EAAI,EAAGA,EAAID,EAASE,OAAQD,IACnCD,EAASC,GAAGE,SAEhB,CCoYM,SAAUC,EACdC,GAEA,OAAOA,CACT"}

package/dist/split/features/devtools.js

@@ -1,2 +1,2 @@
-import{c as e,i as t}from"../chunks/filterRegistry.js";import{K as n,p as s,L as o}from"../chunks/pathDiagnostics.js";import{aN as r,D as i,Q as a,aO as c,aP as l,aQ as u,f as d,aR as f,y as m}from"../chunks/binder.js";import{g as p}from"../chunks/mount.js";import{r as h}from"../chunks/errorGuidance.js";import{V as y}from"../chunks/version.js";const g=/^\s*@@\s*(.*?)\s*:\s*(.+?)\s*$/;function k(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}}const v="__WCSTACK_DEVTOOLS_HOOK__";function N(){const e=globalThis,t=e[v];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[v]=n,n}const S=e=>{null!==s&&s({type:"state:update-batch",addresses:e})};function T(e){const t=null!==s;o(e);const r=null!==e;r&&!t?d(S,n):!r&&t&&f(S)}function w(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 P(e){return m(e)??h("devtools: no state tree on this root")}let b=null;function x(){if(t())return;if(null!==b)return;const n={id:"state:"+Math.random().toString(36).slice(2,10),kind:"state",packageVersion:y,getStateElements(){const e=[];for(const t of u())e.push(w(t));return e},overlays(e){const t=P(e);return p(t).map(e=>({marker:e.marker,componentTag:e.component.tagName.toLowerCase(),stateProp:e.stateProp,mountTable:e.entries.map(e=>({inner:e.innerSegments.join("."),outer:e.outerPathInfo.path})),delta:e.delta,privateKeys:Object.keys(e.privateSnapshot),getterKeys:[...e.getterKeys],exports:[...e.exports.keys()]}))},keyedSubscriptions:e=>function(e){const t=l(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}(P(e)),keys(e){const t=P(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 P(e).createState("readonly",e=>{s=e.$resolve(t,n??[])}),s},write(e,t,n,s){P(e).createState("writable",e=>{void 0!==s&&s.length>0?e.$resolve(t,s,n):e[t]=n})},getDeclaredBindings:t=>function(t){const n=[],s=new Set,o=new Set,l=e=>{const t=function(e){const t=[...e.inFilters,...e.outFilters].map(e=>`${e.filterName}(${e.args.join(",")})`).join("|");return[e.statePathName,e.propName,e.bindingType,t].join("\0")}(e);s.has(t)||(s.add(t),n.push(e))},u=e=>{if(o.has(e))return;o.add(e);const t=a(e);if(null!==t)for(const e of t.nodeInfos)for(const t of e.parseBindTextResults)l(k(null,t,"fragment","")),null!=t.uuid&&u(t.uuid)},d=(t.ownerDocument??t).createTreeWalker(t,NodeFilter.SHOW_ELEMENT|NodeFilter.SHOW_COMMENT);for(let t=d.nextNode();null!==t;t=d.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=r(n,i(s));for(const t of e)l(k(n,t,"attribute",s))}catch{}continue}const n=g.exec(t.data.trim());if(null===n)continue;const s=n[1]||e.commentTextPrefix,o=n[2],d=a(o);if(null===d){if(s===e.commentTextPrefix)try{l(k(t,c(o),"comment",o))}catch{}}else l(k(t,d.parseBindTextResult,"comment",o)),u(o)}return n}(t),_setSink:T};b=n,N().register(n)}const _={name:"devtools",install(){x()}};export{_ as default,_ as devtools};
+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};
 //# 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 { 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  const filters = [...info.inFilters, ...info.outFilters]\n    .map((f) => `${f.filterName}(${f.args.join(\",\")})`)\n    .join(\"|\");\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 */\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  readonly inFilters: readonly { readonly filterName: string; readonly args: readonly string[] }[];\n  readonly outFilters: readonly { readonly filterName: string; readonly args: readonly string[] }[];\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\";\nimport { getMountRecordsForStateElement } from \"../webComponent/mount\";\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      const element = requireStateElement(rootNode);\n      return getMountRecordsForStateElement(element).map((record) => ({\n        marker: record.marker,\n        componentTag: record.component.tagName.toLowerCase(),\n        stateProp: record.stateProp,\n        mountTable: record.entries.map((entry) => ({\n          inner: entry.innerSegments.join(\".\"),\n          outer: entry.outerPathInfo.path,\n        })),\n        delta: record.delta,\n        privateKeys: Object.keys(record.privateSnapshot),\n        getterKeys: [...record.getterKeys],\n        exports: [...record.exports.keys()],\n      }));\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","DEVTOOLS_HOOK_GLOBAL","getOrCreateHookRegistry","globals","globalThis","existing","undefined","version","console","warn","registry","sources","Map","listeners","Set","applySink","source","size","_setSink","sourceId","id","event","listener","onEvent","register","has","set","onSourceRegistered","unregister","get","delete","onSourceUnregistered","addListener","add","values","createMinimalRegistry","onUpdateBatch","batch","devtoolsSink","type","addresses","setSink","sink","wasActive","setDevtoolsSink","isActive","registerUpdateBatchListener","DEVTOOLS_LISTENER_PRIORITY","unregisterUpdateBatchListener","createStateElementSummary","element","rootNode","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","push","overlays","getMountRecordsForStateElement","map","record","marker","componentTag","component","tagName","toLowerCase","stateProp","mountTable","entries","entry","inner","innerSegments","join","outer","outerPathInfo","path","delta","privateKeys","Object","privateSnapshot","getterKeys","exports","keyedSubscriptions","stateElement","view","getKeyedLedgerView","byPath","tracked","watchers","sort","keyMap","rows","lists","lastValue","collectKeyedSubscriptions","result","createState","state","key","includes","startsWith","read","indexes","write","value","length","getDeclaredBindings","out","seenKeys","visitedFragments","info","filters","f","filterName","args","declarationKey","visitFragment","uuid","fragmentInfo","getFragmentInfoByUUID","nodeInfo","nodeInfos","parseBindTextResults","walker","ownerDocument","createTreeWalker","NodeFilter","SHOW_ELEMENT","SHOW_COMMENT","nextNode","nodeType","Node","ELEMENT_NODE","bindText","getAttribute","config","bindAttributeName","results","expandSpread","parseBindTextsForElement","match","exec","data","trim","keyword","commentTextPrefix","parseBindTextForEmbeddedNode","parseBindTextResult","collectDeclaredBindings","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      // `$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,p 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,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};
 //# sourceMappingURL=diagnostics.js.map