@wcstack/state 2.6.1 → 3.0.0

package/dist/split/core.js

@@ -0,0 +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};
+//# sourceMappingURL=core.js.map

package/dist/split/core.js.map

@@ -0,0 +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"}

package/dist/split/features/devtools.d.ts

@@ -0,0 +1,9 @@
+import { I as IStateFeature } from '../chunks/features.js';
+
+/**
+ * features/devtools.ts — DevTools Hook Protocol への source 登録（@wcstack/state/features/devtools）。
+ */
+
+declare const devtools: IStateFeature;
+
+export { devtools as default, devtools };

package/dist/split/features/devtools.js

@@ -0,0 +1,2 @@
+import{c as e,i as t}from"../chunks/filterRegistry.js";import{J as n,o as s,K as o}from"../chunks/pathDiagnostics.js";import{aN as r,Y as i,P 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};
+//# sourceMappingURL=devtools.js.map

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

@@ -0,0 +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":"0VAmDA,MAAMA,EAAkB,iCASxB,SAASC,EACPC,EACAC,EACAC,EACAC,GAEA,MAAO,CACLH,OACAI,SAAUH,EAAOG,SACjBC,cAAeJ,EAAOI,cACtBC,YAAaL,EAAOK,YACpBC,UAAWN,EAAOM,UAClBC,WAAYP,EAAOO,WACnBN,SACAC,MAEJ,CC7DO,MAAMM,EAAuB,qCCkFpBC,IACd,MAAMC,EAAUC,WACVC,EAAWF,EAAQF,GACzB,QAAiBK,IAAbD,EAOF,ODzFqC,ICmFjCA,EAASE,SAEXC,QAAQC,KACN,kEAAkEJ,EAASE,oEAGxEF,EAET,MAAMK,EAtER,WACE,MAAMC,EAAU,IAAIC,IACdC,EAAY,IAAIC,IAChBC,EAAaC,IACjB,GAAuB,IAAnBH,EAAUI,KAEZ,YADAD,EAAOE,SAAS,MAGlB,MAAMC,EAAWH,EAAOI,GACxBJ,EAAOE,SAAUG,IACf,IAAK,MAAMC,KAAYT,EACrBS,EAASC,UAAUJ,EAAUE,MAInC,MAAO,CACLd,QDrCqC,ECsCrCI,UACA,QAAAa,CAASR,GACP,IAAIL,EAAQc,IAAIT,EAAOI,IAAvB,CAGAT,EAAQe,IAAIV,EAAOI,GAAIJ,GACvBD,EAAUC,GACV,IAAK,MAAMM,KAAYT,EACrBS,EAASK,qBAAqBX,EAJhC,CAMF,EACA,UAAAY,CAAWT,GACT,MAAMH,EAASL,EAAQkB,IAAIV,GAC3B,QAAeb,IAAXU,EAAJ,CAGAA,EAAOE,SAAS,MAChBP,EAAQmB,OAAOX,GACf,IAAK,MAAMG,KAAYT,EACrBS,EAASS,uBAAuBZ,EAJlC,CAMF,EACA,WAAAa,CAAYV,GACVT,EAAUoB,IAAIX,GAEd,IAAK,MAAMN,KAAUL,EAAQuB,SAC3BnB,EAAUC,GACVM,EAASK,qBAAqBX,GAEhC,MAAO,KACL,GAAKH,EAAUiB,OAAOR,GAGtB,IAAK,MAAMN,KAAUL,EAAQuB,SAC3BnB,EAAUC,GAGhB,EAEJ,CAcmBmB,GAEjB,OADAhC,EAAQF,GAAwBS,EACzBA,CACT,CAKA,MAAM0B,EAAsCC,IACrB,OAAjBC,GACFA,EAAa,CAAEC,KAAM,qBAAsBC,UAAWH,KAQ1D,SAASI,EAAQC,GACf,MAAMC,EAA6B,OAAjBL,EAClBM,EAAgBF,GAChB,MAAMG,EAAoB,OAATH,EACbG,IAAaF,EAGfG,EAA4BV,EAAeW,IACjCF,GAAYF,GACtBK,EAA8BZ,EAElC,CAEA,SAASa,EAA0BC,GACjC,MAAO,CACLC,SAAUD,EAAQC,SAClBD,UACAE,MAAO,CACLC,KAAMH,EAAQI,UACdJ,QAASA,EAAQK,aACjBC,OAAQN,EAAQO,YAChBC,OAAQR,EAAQS,aAElBC,kBAAmBV,EAAQU,kBAC3BC,gBAAiBX,EAAQW,gBACzBC,iBAAkBZ,EAAQY,iBAC1BC,kBAAmBb,EAAQa,kBAG3BC,WAAYd,EAAQc,YAAc,KAIlCC,oBACuB3D,IAArB4C,EAAQgB,UAA+C,OAArBhB,EAAQgB,SACtC,KACA,IAAIpD,IAAIoC,EAAQgB,SAASC,QAEnC,CAEA,SAASC,EAAoBjB,GAC3B,OAAOkB,EAAgBlB,IACrBmB,EAAW,uCACf,CAQA,IAAIC,EAA2C,cAM/BC,IACd,GAAIC,IACF,OAEF,GAAyB,OAArBF,EACF,OAEF,MAAMvD,EAA0B,CAC9BI,GAjBK,SAAWsD,KAAKC,SAASC,SAAS,IAAIC,MAAM,EAAG,IAkBpDC,KAAM,QACNC,eAAgBC,EAChB,gBAAAC,GACE,MAAMC,EAAoC,GAC1C,IAAK,MAAMhC,KAAWiC,IACpBD,EAAUE,KAAKnC,EAA0BC,IAE3C,OAAOgC,CACT,EACA,QAAAG,CAASlC,GACP,MAAMD,EAAUkB,EAAoBjB,GACpC,OAAOmC,EAA+BpC,GAASqC,IAAKC,IAAM,CACxDC,OAAQD,EAAOC,OACfC,aAAcF,EAAOG,UAAUC,QAAQC,cACvCC,UAAWN,EAAOM,UAClBC,WAAYP,EAAOQ,QAAQT,IAAKU,IAAK,CACnCC,MAAOD,EAAME,cAAcC,KAAK,KAChCC,MAAOJ,EAAMK,cAAcC,QAE7BC,MAAOhB,EAAOgB,MACdC,YAAaC,OAAOvC,KAAKqB,EAAOmB,iBAChCC,WAAY,IAAIpB,EAAOoB,YACvBC,QAAS,IAAIrB,EAAOqB,QAAQ1C,UAEhC,EACA2C,mBAAmB3D,GC1MjB,SAAoC4D,GACxC,MAAMC,EAAOC,EAAmBF,GAChC,GAAa,OAATC,EACF,MAAO,GAET,MAAM5D,EAAQ,IAAItC,IAAY,IAAIkG,EAAKE,OAAO/C,UAAW6C,EAAKG,UAC9D,QAA6B,IAAlBH,EAAKI,SACd,IAAK,MAAMb,KAAQS,EAAKI,SAASjD,OAC/Bf,EAAMnB,IAAIsE,GAGd,MAAMrB,EAAyC,GAC/C,IAAK,MAAMqB,IAAQ,IAAInD,GAAOiE,OAAQ,CACpC,MAAMC,EAASN,EAAKE,OAAOrF,IAAI0E,GAC/B,IAAIgB,EAAO,EACX,QAAsB,IAAXD,EACT,IAAK,MAAM9E,KAAa8E,EAAOpF,SAC7BqF,GAAQ/E,EAAUvB,KAGtBiE,EAAUE,KAAK,CACbmB,OACAY,QAASH,EAAKG,QAAQ1F,IAAI8E,GAC1BgB,OACApD,KAAMmD,GAAQrG,MAAQ,EACtBuG,MAAOR,EAAKI,UAAUvF,IAAI0E,IAAOtF,MAAQ,EACzCwG,UAAWT,EAAKS,UAAU5F,IAAI0E,IAElC,CACA,OAAOrB,CACT,CD6KawC,CAA0BtD,EAAoBjB,IAEvD,IAAAgB,CAAKhB,GACH,MAAMD,EAAUkB,EAAoBjB,GAC9BwE,EAAmB,GAoBzB,OAnBAzE,EAAQ0E,YAAY,WAAaC,IAK/B,IAAK,MAAMC,KAAOpB,OAAOvC,KAAK0D,GAC5B,IAAIC,EAAIC,SAAS,OAAQD,EAAIE,WAAW,KAAxC,CAGA,IACE,GAAkE,mBAAtDH,EAA6CC,GACvD,QAEJ,CAAE,MAEF,CACAH,EAAOvC,KAAK0C,EARZ,IAWGH,CACT,EACA,IAAAM,CAAK9E,EAAgBoD,EAAc2B,GAEjC,IAAIP,EAIJ,OALgBvD,EAAoBjB,GAE5ByE,YAAY,WAAaC,IAC/BF,EAAUE,EAAmF,SAAEtB,EAAM2B,GAAW,MAE3GP,CACT,EACA,KAAAQ,CAAMhF,EAAgBoD,EAAc6B,EAAgBF,GAClC9D,EAAoBjB,GAC5ByE,YAAY,WAAaC,SACfvH,IAAZ4H,GAAyBA,EAAQG,OAAS,EAE3CR,EAA4F,SAAEtB,EAAM2B,EAASE,GAE7GP,EAA6CtB,GAAQ6B,GAG5D,EACAE,oBAAoBnF,GFtLlB,SAAkCA,GACtC,MAAMoF,EAA8B,GAC9BC,EAAW,IAAI1H,IACf2H,EAAmB,IAAI3H,IAEvBsE,EAAQsD,IACZ,MAAMZ,EAnCV,SAAwBY,GACtB,MAAMC,EAAU,IAAID,EAAK3I,aAAc2I,EAAK1I,YACzCuF,IAAKqD,GAAM,GAAGA,EAAEC,cAAcD,EAAEE,KAAK1C,KAAK,SAC1CA,KAAK,KACR,MAAO,CAACsC,EAAK7I,cAAe6I,EAAK9I,SAAU8I,EAAK5I,YAAa6I,GAASvC,KAAK,KAC7E,CA8BgB2C,CAAeL,GACvBF,EAAS/G,IAAIqG,KACjBU,EAASvG,IAAI6F,GACbS,EAAInD,KAAKsD,KAILM,EAAiBC,IACrB,GAAIR,EAAiBhH,IAAIwH,GAAO,OAChCR,EAAiBxG,IAAIgH,GACrB,MAAMC,EAAeC,EAAsBF,GAC3C,GAAqB,OAAjBC,EACJ,IAAK,MAAME,KAAYF,EAAaG,UAClC,IAAK,MAAM5J,KAAU2J,EAASE,qBAC5BlE,EAAK7F,EAAO,KAAME,EAAQ,WAAY,KACnB,MAAfA,EAAOwJ,MACTD,EAAcvJ,EAAOwJ,OAOvBM,GADMpG,EAASqG,eAAkBrG,GACpBsG,iBACjBtG,EACAuG,WAAWC,aAAeD,WAAWE,cAGvC,IAAK,IAAIpK,EAAO+J,EAAOM,WAAqB,OAATrK,EAAeA,EAAO+J,EAAOM,WAAY,CAC1E,GAAIrK,EAAKsK,WAAaC,KAAKC,aAAc,CACvC,MAAM9G,EAAU1D,EACVyK,EAAW/G,EAAQgH,aAAaC,EAAOC,mBAC7C,GAAiB,OAAbH,GAAyC,IAApBA,EAAS5B,OAAc,SAChD,IAEE,MAAMgC,EAAUC,EAAapH,EAASqH,EAAyBN,IAC/D,IAAK,MAAMxK,KAAU4K,EACnBjF,EAAK7F,EAAO2D,EAASzD,EAAQ,YAAawK,GAE9C,CAAE,MAEF,CACA,QACF,CAGA,MAAMO,EAAQlL,EAAgBmL,KAAMjL,EAAiBkL,KAAKC,QAC1D,GAAc,OAAVH,EAAgB,SACpB,MAAMI,EAAUJ,EAAM,IAAML,EAAOU,kBAC7BzC,EAAQoC,EAAM,GACdtB,EAAeC,EAAsBf,GAC3C,GAAqB,OAAjBc,GAKJ,GAAI0B,IAAYT,EAAOU,kBAKvB,IACEzF,EAAK7F,EAAOC,EAAMsL,EAA6B1C,GAAQ,UAAWA,GACpE,CAAE,MAEF,OAbEhD,EAAK7F,EAAOC,EAAM0J,EAAa6B,oBAAqB,UAAW3C,IAC/DY,EAAcZ,EAalB,CAEA,OAAOG,CACT,CE4GayC,CAAwB7H,GAEjCjC,SAAUuB,GAEZ8B,EAAmBvD,EACnBd,IAA0BsB,SAASR,EACrC,CEzQO,MAAMiK,EAA0B,CACrCC,KAAM,WACN,OAAAC,GACE3G,GACF"}

package/dist/split/features/diagnostics.d.ts

@@ -0,0 +1,11 @@
+import { I as IStateFeature } from '../chunks/features.js';
+
+/**
+ * features/diagnostics.ts — 開発時の診断（@wcstack/state/features/diagnostics）。
+ * 束縛・`$watch`・`$scan` のパスが state に無いときの console.warn（did-you-mean 付き）。
+ * 入れなければ何も出さない — `@wcstack/state/core` だけの本番ページの軽量形。
+ */
+
+declare const diagnostics: IStateFeature;
+
+export { diagnostics as default, diagnostics };

package/dist/split/features/diagnostics.js

@@ -0,0 +1,2 @@
+import{s as e}from"../chunks/diagnosticsHooks.js";import{g as t,B as n,W as s,a7 as i,a8 as r,a9 as o,o 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sources":["../../../../../src/diagnostics/pathChecks.ts","../../../../../src/diagnostics/install.ts","../../../../../src/features/diagnostics.ts"],"sourcesContent":["/**\n * diagnostics/pathChecks.ts — バインド / `$watch` / `$scan` 対象パスの存在検査\n * （@wcstack/state/features/diagnostics。silent failure の可視化）。\n *\n * なぜ必要か:\n * `getByAddress` は「親が null / undefined のパスの読み」を undefined で返し、\n * undefined はプロパティ書き込みがスキップされる値なので、`user.nmae` のような\n * 打ち間違いは**エラーも警告も出さずに DOM が更新されない**だけになる。一方で\n * トップレベルの打ち間違い（`cout`）は parentAddress を辿れず raiseError で落ちる。\n * 同じ「パスを打ち間違えた」という 1 つの失敗が、パスの深さで silent / loud に\n * 割れており、書き手からは区別がつかない。ここはその silent 側を埋める。\n *\n * 開発時の診断なので機能として分けてある（full / auto は入れる。`@wcstack/state/core` だけの\n * ページは入れなければ警告を出さない — 本番向けの軽量形）。core の受け口は\n * core/diagnosticsHooks.ts。\n *\n * 精度方針（過小近似）:\n * 「確実に存在しない」と言い切れる場合にだけ報告する。getter の戻り値の先・\n * 空配列・null 親・mapped な `bind-component` など、静的に決められない形はすべて\n * `\"unknown\"` に倒して黙る（偽陽性ゼロ優先。docs/static-wiring-dx-design.md D7 /\n * [ADR-06](../../../docs/architecture-hardening/06-path-type-safety.md) の精度哲学）。\n */\n\nimport { getPathInfo } from \"../address/PathInfo\";\nimport type { IStateElement } from \"../components/types\";\nimport { DELIMITER, WILDCARD } from \"../define\";\nimport { devtoolsSink } from \"../platform/devtoolsSink\";\nimport { didYouMean, LINT_HINT } from \"../errorGuidance\";\nimport { collectCandidates, DIAGNOSTIC_CODE, findDescriptor, PathInfoSource, SUBJECT } from \"../pathDiagnostics\";\n\nexport type PathExistence = \"exists\" | \"missing\" | \"unknown\";\n\nexport interface IPathExistenceResult {\n  readonly existence: PathExistence;\n  /** `\"missing\"` のとき、解決に失敗したセグメント */\n  readonly missingSegment: string;\n  /** `\"missing\"` のとき、その階層に実在する兄弟キー（did-you-mean 用） */\n  readonly candidates: readonly string[];\n}\n\nconst UNKNOWN: IPathExistenceResult = Object.freeze({\n  existence: \"unknown\" as const,\n  missingSegment: \"\",\n  candidates: Object.freeze([]) as readonly string[],\n});\n\nconst EXISTS: IPathExistenceResult = Object.freeze({\n  existence: \"exists\" as const,\n  missingSegment: \"\",\n  candidates: Object.freeze([]) as readonly string[],\n});\n\n/**\n * `target` に対して `path` が解決しうるかを、値を読まずに（getter を評価せずに）判定する。\n *\n * 解決の順序は `getByAddress` の実装に合わせる: まず「パス文字列そのものがキーか」\n * （ドットパス getter がこれ）、次にセグメントを 1 つずつ降りる。\n */\nexport function resolvePathExistence(\n  target: object,\n  path: string,\n  declaredPaths: Iterable<string>,\n): IPathExistenceResult {\n  // ドットパス getter / フラットキーの完全一致（`get \"users.*.fullName\"()` 等）\n  if (findDescriptor(target, path) !== undefined) {\n    return EXISTS;\n  }\n  const segments = getPathInfo(path).segments;\n  let current: unknown = target;\n  let prefix = \"\";\n  for (let i = 0; i < segments.length; i++) {\n    const segment = segments[i];\n    const parentPrefix = prefix;\n    prefix = i === 0 ? segment : prefix + DELIMITER + segment;\n    // 途中のプレフィックスがフラット宣言されている（`cart.totalPrice` が getter で、\n    // その戻り値のサブプロパティを読む形）。戻り値の形は評価しないと分からない\n    if (i > 0 && i < segments.length - 1 && findDescriptor(target, prefix) !== undefined) {\n      return UNKNOWN;\n    }\n    // null / undefined / primitive より深い読みは実行時 undefined 解決 = 判定不能。\n    // 「初期値 null のオブジェクトに後から代入する」形を偽陽性で潰さないため\n    if (Object(current) !== current) {\n      return UNKNOWN;\n    }\n    if (segment === WILDCARD) {\n      // 行の形は「いま入っている要素」からしか分からない。空配列・非配列は判定不能\n      if (!Array.isArray(current) || current.length === 0) {\n        return UNKNOWN;\n      }\n      current = current[0];\n      continue;\n    }\n    const descriptor = findDescriptor(current as object, segment);\n    if (typeof descriptor === \"undefined\") {\n      return {\n        existence: \"missing\",\n        missingSegment: segment,\n        candidates: collectCandidates(current as object, parentPrefix, declaredPaths),\n      };\n    }\n    if (typeof descriptor.get === \"function\") {\n      // getter の戻り値の先は評価しないと分からない（末尾なら存在は確定）\n      return i === segments.length - 1 ? EXISTS : UNKNOWN;\n    }\n    current = descriptor.value;\n  }\n  return EXISTS;\n}\n\n/** 同じ (state 要素, パス) の報告は 1 回だけにする台帳 */\nconst reportedPathsByStateElement: WeakMap<IStateElement, Set<string>> = new WeakMap();\n\n/** テスト間の分離用（本番経路からは呼ばれない） */\nexport function clearReportedPaths(stateElement: IStateElement): void {\n  reportedPathsByStateElement.delete(stateElement);\n}\n\n/**\n * state の世代が進んだ（再セット）ときに、この要素の検査済みの印と遅延中の報告を捨てる（#270）。\n *\n * 「パスごとに 1 回」は同じ誤りを更新のたびに報告し続けないための台帳で、世代をまたいで\n * 持ち越す理由は無い。持ち越すと、第 1 世代で検査済みのパスが第 2 世代の state から消えても\n * 無言のままになる。遅延中の報告は前の世代の state で判定した結果なので、あわせて捨てる\n * （呼び手の経路情報の作り直しが、新しい世代で判定し直して積み直す）。公開 getter の登録\n * （`markExportedPath`）はマウント記録の寿命に属するので触らない。\n */\nexport function resetPathDiagnostics(stateElement: IStateElement): void {\n  reportedPathsByStateElement.delete(stateElement);\n  deferredReportsByStateElement.delete(stateElement);\n}\n\nfunction alreadyReported(stateElement: IStateElement, path: string): boolean {\n  let reported = reportedPathsByStateElement.get(stateElement);\n  if (typeof reported === \"undefined\") {\n    reported = new Set<string>();\n    reportedPathsByStateElement.set(stateElement, reported);\n  }\n  if (reported.has(path)) {\n    return true;\n  }\n  reported.add(path);\n  return false;\n}\n\n/**\n * バインド確立時 / `$watch` 宣言時にパスの存在を検査し、確実に存在しないものだけ報告する。\n *\n * 報告は `console.warn` に留める（`raiseError` にしない）:\n * 判定は過小近似とはいえ動的にキーが生える形まで排除できたわけではなく、\n * 既存ページを起動不能にする代償に見合わない。silent を破ることが目的であり、\n * 停止させることではない。\n */\nexport function checkDeclaredPath(\n  stateElement: IStateElement,\n  state: object | undefined,\n  path: string,\n  source: PathInfoSource,\n): void {\n  if (source === \"internal\" || typeof state === \"undefined\") {\n    return;\n  }\n  // `$command` / `$streamStatus` / `$1` 等の予約名前空間は raw state に実体を持たない\n  if (path.startsWith(\"$\")) {\n    return;\n  }\n  // マウントの予約セグメント（`users.*.#m1.editing` — D20）はオーバーレイに実体があり\n  // raw state には無い。`#else`（構造プレースホルダ）も同様（webComponent/mount.ts）\n  if (path.indexOf(\"#\") !== -1) {\n    return;\n  }\n  // 機能が黙らせる領域（予約済みボリュームスロットの配下 — D22。webComponent/addressHooks.ts）は\n  // suppressPathDiagnostic hook に聞く。hook の無い state は判定 1 個で抜ける\n  const hooks = stateElement.addressHooks;\n  if (hooks) {\n    const suppress = hooks.suppressPathDiagnostic;\n    for (let i = 0; i < suppress.length; i++) {\n      if (suppress[i](stateElement, path)) {\n        return;\n      }\n    }\n  }\n\n  // 単一セグメントのバインディングは読み取り時に raiseError で loud に落ちるので、\n  // ここで二重に報告しない。`$watch` は落ちずに黙って発火しないだけなので検査する\n  const segments = getPathInfo(path).segments;\n  if (source === \"binding\" && segments.length < 2) {\n    return;\n  }\n  if (alreadyReported(stateElement, path)) {\n    return;\n  }\n  // 再帰 getter の展開形は、バインド確立の時点ではまだ生えていない（読む直前に\n  // 遅延実体化する — recursion/registry.ts）。素の存在検査では必ず「解決できない」に\n  // なるので、宣言済みの `**` getter に合致するかを先に見る。実体化はしない。\n  // 展開形の**値の内側**（`nodes.*.stats.count` で `get \"nodes.**.stats\"()` がオブジェクトを\n  // 返す形）も同じ — 通常の getter なら下の「途中のプレフィックスがフラット宣言」で\n  // UNKNOWN に倒れるところ、未実体化のアクセサは findDescriptor に見えないのでここで畳む。\n  if (stateElement.hasRecursion === true && stateElement.recursionRegistry!.recursiveGetterOwning(path) !== null) {\n    return;\n  }\n  const result = resolvePathExistence(state, path, stateElement.getterPaths);\n  if (result.existence !== \"missing\") {\n    return;\n  }\n  if (isExportedPath(stateElement, path)) {\n    return;\n  }\n  if (source === \"binding\") {\n    // 遅延報告（docs/state-overlay-export-design.md X7）: バインド確立時点では、その位置に\n    // マウントされるコンポーネントの getter（公開 getter）がまだ登録されていない。\n    // 1 マクロタスク待って、登録で解消しなかったものだけを報告する\n    deferReport(stateElement, path, result);\n    return;\n  }\n  reportMissing(stateElement, path, source, result);\n}\n\ninterface IMissingResult {\n  readonly missingSegment: string;\n  readonly candidates: readonly string[];\n}\n\nconst deferredReportsByStateElement = new WeakMap<IStateElement, Map<string, IMissingResult>>();\nconst flushScheduled = new WeakSet<IStateElement>();\nconst exportedPathsByStateElement = new WeakMap<IStateElement, Set<string>>();\n\n/** 公開 getter の登録（webComponent/exportIndex.ts）— このパスは「存在しない」ではない */\nexport function markExportedPath(stateElement: IStateElement, path: string): void {\n  let paths = exportedPathsByStateElement.get(stateElement);\n  if (typeof paths === \"undefined\") {\n    paths = new Set<string>();\n    exportedPathsByStateElement.set(stateElement, paths);\n  }\n  paths.add(path);\n  deferredReportsByStateElement.get(stateElement)?.delete(path);\n}\n\nfunction isExportedPath(stateElement: IStateElement, path: string): boolean {\n  return exportedPathsByStateElement.get(stateElement)?.has(path) === true;\n}\n\nfunction deferReport(stateElement: IStateElement, path: string, result: IMissingResult): void {\n  let pending = deferredReportsByStateElement.get(stateElement);\n  if (typeof pending === \"undefined\") {\n    pending = new Map();\n    deferredReportsByStateElement.set(stateElement, pending);\n  }\n  pending.set(path, result);\n  if (flushScheduled.has(stateElement)) {\n    return;\n  }\n  flushScheduled.add(stateElement);\n  setTimeout(() => flushDeferredPathReports(stateElement), 0);\n}\n\n/** 遅延中の報告を今すぐ流す（タイマー到達時・テスト用） */\nexport function flushDeferredPathReports(stateElement: IStateElement): void {\n  flushScheduled.delete(stateElement);\n  const pending = deferredReportsByStateElement.get(stateElement);\n  if (typeof pending === \"undefined\") {\n    return;\n  }\n  deferredReportsByStateElement.delete(stateElement);\n  // 登録で解消したものは markExportedPath が pending から消している\n  for (const [path, result] of pending) {\n    reportMissing(stateElement, path, \"binding\", result);\n  }\n}\n\nfunction reportMissing(\n  stateElement: IStateElement,\n  path: string,\n  source: PathInfoSource & (\"binding\" | \"watch\" | \"scan\"),\n  result: IMissingResult,\n): void {\n  // 接頭辞は raiseError と同じ `[@wcstack/state] [wcs/...]` の並び（コンソールの\n  // grep 単位をパッケージで揃える）\n  console.warn(\n    `[@wcstack/state] [${DIAGNOSTIC_CODE[source]}] ${SUBJECT[source]} \"${path}\" does not resolve on the state tree: ` +\n    `\"${result.missingSegment}\" is not declared.${didYouMean(result.missingSegment, result.candidates)}` +\n    ` Updates to this path will be silently dropped.${LINT_HINT}`,\n  );\n  if (devtoolsSink !== null) {\n    devtoolsSink({\n      type: \"state:path-unresolved\",\n      source,\n      path,\n      missingSegment: result.missingSegment,\n    });\n  }\n}\n","/**\n * diagnostics/install.ts — 開発時の診断の install（@wcstack/state/features/diagnostics）。\n * core の受け口（core/diagnosticsHooks.ts）へ、束縛時のパス存在検査を置く。\n */\nimport { IPathDiagnostics, setPathDiagnostics } from \"../core/diagnosticsHooks\";\nimport { checkDeclaredPath, markExportedPath, resetPathDiagnostics } from \"./pathChecks\";\n\nexport const pathDiagnosticsFeature: IPathDiagnostics = {\n  check: checkDeclaredPath,\n  reset: resetPathDiagnostics,\n  markExported: markExportedPath,\n};\n\nlet installed = false;\n/** 冪等。full / auto では `bootstrapState()` が呼ぶ */\nexport function installDiagnostics(): void {\n  if (installed) return;\n  installed = true;\n  setPathDiagnostics(pathDiagnosticsFeature);\n}\n","/**\n * features/diagnostics.ts — 開発時の診断（@wcstack/state/features/diagnostics）。\n * 束縛・`$watch`・`$scan` のパスが state に無いときの console.warn（did-you-mean 付き）。\n * 入れなければ何も出さない — `@wcstack/state/core` だけの本番ページの軽量形。\n */\nimport type { IStateFeature } from \"../core/features\";\nimport { installDiagnostics } from \"../diagnostics/install\";\n\nexport const diagnostics: IStateFeature = {\n  name: \"diagnostics\",\n  install(): void {\n    installDiagnostics();\n  },\n};\nexport default diagnostics;\n"],"names":["UNKNOWN","Object","freeze","existence","missingSegment","candidates","EXISTS","reportedPathsByStateElement","WeakMap","deferredReportsByStateElement","flushScheduled","WeakSet","exportedPathsByStateElement","reportMissing","stateElement","path","source","result","console","warn","DIAGNOSTIC_CODE","SUBJECT","didYouMean","LINT_HINT","devtoolsSink","type","pathDiagnosticsFeature","check","state","startsWith","indexOf","hooks","addressHooks","suppress","suppressPathDiagnostic","i","length","segments","getPathInfo","reported","get","Set","set","has","add","alreadyReported","hasRecursion","recursionRegistry","recursiveGetterOwning","target","declaredPaths","undefined","findDescriptor","current","prefix","segment","parentPrefix","DELIMITER","WILDCARD","Array","isArray","descriptor","collectCandidates","value","resolvePathExistence","getterPaths","isExportedPath","pending","Map","setTimeout","delete","flushDeferredPathReports","deferReport","reset","markExported","paths","installed","diagnostics","name","install","setPathDiagnostics"],"mappings":"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"}

package/dist/split/features/formats.d.ts

@@ -0,0 +1,10 @@
+import { I as IStateFeature } from '../chunks/features.js';
+
+/**
+ * features/formats.ts — 書式フィルタ群（@wcstack/state/features/formats）。
+ * `|uc` `|date(…)` `|round(…)` のような宣言が要求する実関数を core の登録簿へ置く。
+ */
+
+declare const formats: IStateFeature;
+
+export { formats as default, formats };

package/dist/split/features/formats.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sources":["../../../../../src/formats/errorMessages.ts","../../../../../src/formats/builtinFilters.ts","../../../../../src/formats/install.ts","../../../../../src/features/formats.ts"],"sourcesContent":["/**\n * errorMessages.ts\n *\n * Error message generation utilities used by filter functions.\n *\n * Main responsibilities:\n * - Throws clear error messages when filter options or value type checks fail\n * - Takes function name as argument to specify which filter caused the error\n *\n * Design points:\n * - optionsRequired: Error when required option is not specified\n * - optionMustBeNumber: Error when option value is not a number\n * - valueMustBeNumber: Error when value is not a number\n * - valueMustBeBoolean: Error when value is not boolean\n * - valueMustBeDate: Error when value is not a Date\n */\nimport { raiseError } from \"../raiseError\";\n\n/**\n * Throws error when filter requires at least one option but none provided.\n * \n * @param fnName - Name of the filter function\n * @returns Never returns (always throws)\n */\nexport function optionsRequired(fnName:string): never {\n  raiseError(`filter ${fnName} requires at least one option`);\n}\n\n/**\n * Throws error when filter option must be a number but invalid value provided.\n * \n * @param fnName - Name of the filter function\n * @returns Never returns (always throws)\n */\nexport function optionMustBeNumber(fnName:string): never {\n  raiseError(`filter ${fnName} requires a number as option`);\n}\n\n/**\n * Throws error when filter requires numeric value but non-number provided.\n * \n * @param fnName - Name of the filter function\n * @returns Never returns (always throws)\n */\nexport function valueMustBeNumber(fnName:string): never {\n  raiseError(`filter ${fnName} requires a number value`);\n}\n\n/**\n * Throws error when filter requires numeric value but non-number provided.\n * \n * @param fnName - Name of the filter function\n * @returns Never returns (always throws)\n */\nexport function valueMustBeString(fnName:string): never {\n  raiseError(`filter ${fnName} requires a string value`);\n}\n\n/**\n * Throws error when filter requires boolean value but non-boolean provided.\n * \n * @param fnName - Name of the filter function\n * @returns Never returns (always throws)\n */\nexport function valueMustBeBoolean(fnName:string): never {\n  raiseError(`filter ${fnName} requires a boolean value`);\n} \n\n/**\n * Throws error when filter requires Date value but non-Date provided.\n *\n * @param fnName - Name of the filter function\n * @returns Never returns (always throws)\n */\nexport function valueMustBeDate(fnName:string): never {\n  raiseError(`filter ${fnName} requires a date value`);\n}\n\n/**\n * Throws error when filter requires array value but non-array provided.\n *\n * @param fnName - Name of the filter function\n * @returns Never returns (always throws)\n */\nexport function valueMustBeArray(fnName:string): never {\n  raiseError(`filter ${fnName} requires an array value`);\n}","/**\n * builtinFilters.ts\n *\n * Implementation file for built-in filter functions available in Structive.\n *\n * Main responsibilities:\n * - Provides filters for conversion, comparison, formatting, and validation of numbers, strings, dates, booleans, etc.\n * - Defines functions with options for each filter name, enabling flexible use during binding\n * - Designed for common use as both input and output filters\n *\n * Design points:\n * - Comprehensive coverage of diverse filters: eq, ne, lt, gt, inc, abs, clamp, fix, locale, uc, lc, cap, trim, slice, pad, truncate, join, int, float, round, percent, unit, date, time, ymd, hms, falsy, truthy, defaults, boolean, number, string, null, etc.\n * - Rich type checking and error handling for option values\n * - Centralized management of filter functions with FilterWithOptions type, easy to extend\n * - Dynamic retrieval of filter functions from filter names and options via builtinFilterFn\n */\nimport { config } from \"../config.js\";\nimport { didYouMean, LINT_HINT } from \"../errorGuidance.js\";\nimport { raiseError } from \"../raiseError.js\";\nimport { optionMustBeNumber, optionsRequired, valueMustBeArray, valueMustBeBoolean, valueMustBeDate, valueMustBeNumber } from \"./errorMessages.js\";\nimport { FilterFn, FilterWithOptions } from \"../filters/types\";\n\nfunction validateNumberString(value: string): boolean {\n  if (!value || isNaN(Number(value))) {\n    return false;\n  }\n  return true;\n}\n\n/**\n * Equality filter - compares value with option.\n * \n * @param options - Array with comparison value as first element\n * @returns Filter function that returns boolean\n */\nconst eq = (options?:string[], literals?: readonly unknown[]): FilterFn<boolean> => {\n  const opt = options?.[0] ?? optionsRequired('eq');\n  // The typed literal (B9): unquoted true / false / null / numbers are typed, quoted arguments are strings\n  const literal = literals !== undefined && literals.length > 0 ? literals[0] : opt;\n  return (value: unknown): boolean => {\n    // Align types for comparison\n    if (typeof value === 'number') {\n      if (!validateNumberString(opt)) {optionMustBeNumber('eq');}\n      return value === Number(opt);\n    }\n    if (typeof value === 'string') {\n      return value === opt;\n    }\n    // Booleans, null and the rest compare with the typed literal: eq(true) matches true (B9)\n    return value === literal;\n  }\n}\n\n/**\n * Inequality filter - compares value with option.\n * \n * @param options - Array with comparison value as first element\n * @returns Filter function that returns boolean\n */\nconst ne = (options?:string[], literals?: readonly unknown[]): FilterFn<boolean> => {\n  const opt = options?.[0] ?? optionsRequired('ne');\n  const literal = literals !== undefined && literals.length > 0 ? literals[0] : opt;\n  return (value: unknown): boolean => {\n    // Align types for comparison\n    if (typeof value === 'number') {\n      if (!validateNumberString(opt)) {optionMustBeNumber('ne');}\n      return value !== Number(opt);\n    }\n    if (typeof value === 'string') {\n      return value !== opt;\n    }\n    // Booleans, null and the rest compare with the typed literal (B9)\n    return value !== literal;\n  }\n}\n\n/**\n * Boolean NOT filter - inverts boolean value.\n * \n * @param options - Unused\n * @returns Filter function that returns inverted boolean\n */\nconst not = (_options?:string[]): FilterFn<boolean> => {\n  return (value: unknown): boolean => {\n    if (typeof value !== 'boolean') {valueMustBeBoolean('not');}\n    return !value;\n  }\n}\n\n/**\n * Less than filter - checks if value is less than option.\n * \n * @param options - Array with comparison number as first element\n * @returns Filter function that returns boolean\n */\nconst lt = (options?:string[]): FilterFn<boolean> => {\n  const opt = options?.[0] ?? optionsRequired('lt');\n  if (!validateNumberString(opt)) {optionMustBeNumber('lt');}\n  return (value: unknown): boolean => {\n    if (typeof value !== 'number') {valueMustBeNumber('lt');}\n    return value < Number(opt);\n  }\n}\n\n/**\n * Less than or equal filter - checks if value is less than or equal to option.\n * \n * @param options - Array with comparison number as first element\n * @returns Filter function that returns boolean\n */\nconst le = (options?:string[]): FilterFn<boolean> => {\n  const opt = options?.[0] ?? optionsRequired('le');\n  if (!validateNumberString(opt)) {optionMustBeNumber('le');}\n  return (value: unknown): boolean => {\n    if (typeof value !== 'number') {valueMustBeNumber('le');}\n    return value <= Number(opt);\n  }\n}\n\n/**\n * Greater than filter - checks if value is greater than option.\n * \n * @param options - Array with comparison number as first element\n * @returns Filter function that returns boolean\n */\nconst gt = (options?:string[]): FilterFn<boolean> => {\n  const opt = options?.[0] ?? optionsRequired('gt');\n  if (!validateNumberString(opt)) {optionMustBeNumber('gt');}\n  return (value: unknown): boolean => {\n    if (typeof value !== 'number') {valueMustBeNumber('gt');}\n    return value > Number(opt);\n  }\n}\n\n/**\n * Greater than or equal filter - checks if value is greater than or equal to option.\n * \n * @param options - Array with comparison number as first element\n * @returns Filter function that returns boolean\n */\nconst ge = (options?:string[]): FilterFn<boolean> => {\n  const opt = options?.[0] ?? optionsRequired('ge');\n  if (!validateNumberString(opt)) {optionMustBeNumber('ge');}\n  return (value: unknown): boolean => {\n    if (typeof value !== 'number') {valueMustBeNumber('ge');}\n    return value >= Number(opt);\n  }\n}\n\n/**\n * Increment filter - adds option value to input value.\n * \n * @param options - Array with increment number as first element\n * @returns Filter function that returns incremented number\n */\nconst inc = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? optionsRequired('inc');\n  if (!validateNumberString(opt)) {optionMustBeNumber('inc');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('inc');}\n    return value + Number(opt);\n  }\n}\n\n/**\n * Decrement filter - subtracts option value from input value.\n * \n * @param options - Array with decrement number as first element\n * @returns Filter function that returns decremented number\n */\nconst dec = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? optionsRequired('dec');\n  if (!validateNumberString(opt)) {optionMustBeNumber('dec');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('dec');}\n    return value - Number(opt);\n  }\n}\n\n/**\n * Multiply filter - multiplies value by option.\n * \n * @param options - Array with multiplier number as first element\n * @returns Filter function that returns multiplied number\n */\nconst mul = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? optionsRequired('mul');\n  if (!validateNumberString(opt)) {optionMustBeNumber('mul');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('mul');}\n    return value * Number(opt);\n  }\n}\n\n/**\n * Divide filter - divides value by option.\n * \n * @param options - Array with divisor number as first element\n * @returns Filter function that returns divided number\n */\nconst div = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? optionsRequired('div');\n  if (!validateNumberString(opt)) {optionMustBeNumber('div');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('div');}\n    return value / Number(opt);\n  }\n}\n\n/**\n * Modulo filter - returns remainder of division.\n * \n * @param options - Array with divisor number as first element\n * @returns Filter function that returns remainder\n */\nconst mod = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? optionsRequired('mod');\n  if (!validateNumberString(opt)) {optionMustBeNumber('mod');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('mod');}\n    return value % Number(opt);\n  }\n}\n\n/**\n * Absolute value filter - returns the magnitude of a number.\n *\n * @param options - Unused\n * @returns Filter function that returns the absolute value\n */\nconst abs = (_options?:string[]): FilterFn<number> => {\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('abs');}\n    return Math.abs(value);\n  }\n}\n\n/**\n * Clamp filter - constrains a number to the inclusive range [min, max].\n *\n * Saturating conversion in the same family as round/floor/ceil, so it stays on\n * the wire rather than in state. Pairs with `unit` for style bindings:\n * `style.width: ratio|clamp(0,1)|percent(0)`.\n *\n * @param options - Array with minimum as first element and maximum as second (both required)\n * @returns Filter function that returns the clamped number\n */\nconst clamp = (options?:string[]): FilterFn<number> => {\n  const opt1 = options?.[0] ?? optionsRequired('clamp');\n  if (!validateNumberString(opt1)) {optionMustBeNumber('clamp');}\n  const opt2 = options?.[1] ?? optionsRequired('clamp');\n  if (!validateNumberString(opt2)) {optionMustBeNumber('clamp');}\n  const min = Number(opt1);\n  const max = Number(opt2);\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('clamp');}\n    return Math.min(Math.max(value, min), max);\n  }\n}\n\n/**\n * Fixed decimal filter - formats number to fixed decimal places.\n *\n * @param options - Array with decimal places as first element (default: 0)\n * @returns Filter function that returns formatted string\n */\nconst fix = (options?:string[]): FilterFn<string> => {\n  const opt = options?.[0] ?? \"0\";\n  if (!validateNumberString(opt)) {optionMustBeNumber('fix');}\n  return (value: unknown): string => {\n    if (typeof value !== 'number') {valueMustBeNumber('fix');}\n    return value.toFixed(Number(opt));\n  }\n}\n\n/**\n * Locale number filter - formats number according to locale.\n *\n * ロケール依存フィルタ（`locale` / `date` / `time` / `datetime`）は\n * **明示引数だけを構築時に確定し、既定の `config.locale` は適用のたびに読む**。\n *\n * 以前は `options?.[0] ?? config.locale` を返り値の関数の**外**で解決していた。\n * フィルタ関数はバインド構築時に一度だけ作られるので、これはロケールを\n * クロージャに焼き込むことを意味する。`config.locale` の確定がバインド構築より\n * 遅れると、それ以降どう直しても「同じページの中で日付だけ既定ロケール」が\n * 永続し、しかも `config.locale` は依存グラフに載らないので再描画で回復もしない。\n * 症状（日付だけ英語）は原因（起動順序）から遠く、追いにくい。\n *\n * 適用のたびに読めば、少なくとも**再適用されたバインドは回復する**。ロケールは\n * 起動時に確定する前提（docs/i18n-design.md D1）なので通常この差は現れず、\n * これは順序事故から復帰できるようにするための保険である。\n *\n * 明示引数（`|date(ja-JP)`）は構築時に固定でよい — バインド式の一部であり、\n * 実行中に変わらない。\n *\n * @param options - Array with locale string as first element (default: config.locale)\n * @returns Filter function that returns localized number string\n */\nconst locale = (options?:string[]): FilterFn<string> => {\n  const explicit = options?.[0];\n  return (value: unknown): string => {\n    if (typeof value !== 'number') {valueMustBeNumber('locale');}\n    return value.toLocaleString(explicit ?? config.locale);\n  }\n}\n\n/**\n * Uppercase filter - converts string to uppercase.\n * \n * @param options - Unused\n * @returns Filter function that returns uppercase string\n */\nconst uc = (_options?:string[]): FilterFn<string> => {\n  return (value: unknown): string => {\n    return String(value).toUpperCase();\n  }\n}\n\n/**\n * Lowercase filter - converts string to lowercase.\n * \n * @param options - Unused\n * @returns Filter function that returns lowercase string\n */\nconst lc = (_options?:string[]): FilterFn<string> => {\n  return (value: unknown): string => {\n    return String(value).toLowerCase();\n  }\n}\n\n/**\n * Capitalize filter - capitalizes first character of string.\n * \n * @param options - Unused\n * @returns Filter function that returns capitalized string\n */\nconst cap = (_options?:string[]): FilterFn<string> => {\n  return (value: unknown): string => {\n    const v = String(value);\n    if (v.length === 0) {return v;}\n    if (v.length === 1) {return v.toUpperCase();}\n    return v.charAt(0).toUpperCase() + v.slice(1);\n  }\n}\n\n/**\n * Trim filter - removes whitespace from both ends of string.\n * \n * @param options - Unused\n * @returns Filter function that returns trimmed string\n */\nconst trim = (_options?:string[]): FilterFn<string> => {\n  return (value: unknown): string => {\n    return String(value).trim();\n  }\n}\n\n/**\n * Slice filter - extracts portion of string from specified index.\n * \n * @param options - Array with start index and optional end index\n * @returns Filter function that returns sliced string\n */\nconst slice = (options?:string[]): FilterFn<string> => {\n  const numberedOpts: number[] = [];\n  const opt1 = options?.[0] ?? optionsRequired('slice');\n  if (!validateNumberString(opt1)) {optionMustBeNumber('slice');}\n  numberedOpts.push(Number(opt1));\n  const opt2 = options?.[1];\n  if (typeof opt2 !== 'undefined') {\n    if (!validateNumberString(opt2)) {optionMustBeNumber('slice');}\n    numberedOpts.push(Number(opt2));\n  }\n  return (value: unknown): string => {\n    return String(value).slice(...numberedOpts);\n  }\n}\n\n/**\n * Substring filter - extracts substring from specified position and length.\n * \n * @param options - Array with start index and length\n * @returns Filter function that returns substring\n */\nconst substr = (options?:string[]): FilterFn<string> => {\n  const opt1 = options?.[0] ?? optionsRequired('substr');\n  if (!validateNumberString(opt1)) {optionMustBeNumber('substr');}\n  const opt2 = options?.[1] ?? optionsRequired('substr');\n  if (!validateNumberString(opt2)) {optionMustBeNumber('substr');}\n  return (value: unknown): string => {\n    return String(value).substr(Number(opt1), Number(opt2));\n  }\n}\n\n/**\n * Pad filter - pads string to specified length from start.\n * \n * @param options - Array with target length and pad string (default: '0')\n * @returns Filter function that returns padded string\n */\nconst pad = (options?:string[]): FilterFn<string> => {\n  const opt1 = options?.[0] ?? optionsRequired('pad');\n  if (!validateNumberString(opt1)) {optionMustBeNumber('pad');}\n  const opt2 = options?.[1] ?? '0';\n  return (value: unknown): string => {\n    return String(value).padStart(Number(opt1), opt2);\n  }\n}\n\n/**\n * Repeat filter - repeats string specified number of times.\n * \n * @param options - Array with repeat count as first element\n * @returns Filter function that returns repeated string\n */\nconst rep = (options?:string[]): FilterFn<string> => {\n  const opt = options?.[0] ?? optionsRequired('rep');\n  if (!validateNumberString(opt)) {optionMustBeNumber('rep');}\n  return (value: unknown): string => {\n    return String(value).repeat(Number(opt));\n  }\n}\n\n/**\n * Reverse filter - reverses character order in string.\n * \n * @param options - Unused\n * @returns Filter function that returns reversed string\n */\nconst rev = (_options?:string[]): FilterFn<string> => {\n  return (value: unknown): string => {\n    return String(value).split('').reverse().join('');\n  }\n}\n\n/**\n * Integer filter - parses value to integer.\n * \n * @param options - Unused\n * @returns Filter function that returns integer\n */\nconst int = (_options?:string[]): FilterFn<number> => {\n  return (value: unknown): number => {\n    return parseInt(String(value), 10);\n  }\n}\n\n/**\n * Float filter - parses value to floating point number.\n * \n * @param options - Unused\n * @returns Filter function that returns float\n */\nconst float = (_options?:string[]): FilterFn<number> => {\n  return (value: unknown): number => {\n    return parseFloat(String(value));\n  }\n}\n\n/**\n * Round filter - rounds number to specified decimal places.\n * \n * @param options - Array with decimal places as first element (default: 0)\n * @returns Filter function that returns rounded number\n */\nconst round = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? '0';\n  if (!validateNumberString(opt)) {optionMustBeNumber('round');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('round');}\n    const optValue = Math.pow(10, Number(opt));\n    return Math.round(value * optValue) / optValue;\n  }\n}\n\n/**\n * Floor filter - rounds number down to specified decimal places.\n * \n * @param options - Array with decimal places as first element (default: 0)\n * @returns Filter function that returns floored number\n */\nconst floor = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? '0';\n  if (!validateNumberString(opt)) {optionMustBeNumber('floor');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('floor');}\n    const optValue = Math.pow(10, Number(opt));\n    return Math.floor(value * optValue) / optValue;\n  }\n}\n\n/**\n * Ceiling filter - rounds number up to specified decimal places.\n * \n * @param options - Array with decimal places as first element (default: 0)\n * @returns Filter function that returns ceiled number\n */\nconst ceil = (options?:string[]): FilterFn<number> => {\n  const opt = options?.[0] ?? '0';\n  if (!validateNumberString(opt)) {optionMustBeNumber('ceil');}\n  return (value: unknown): number => {\n    if (typeof value !== 'number') {valueMustBeNumber('ceil');}\n    const optValue = Math.pow(10, Number(opt));\n    return Math.ceil(value * optValue) / optValue;\n  }\n}\n\n/**\n * Percent filter - formats number as percentage string.\n * \n * @param options - Array with decimal places as first element (default: 0)\n * @returns Filter function that returns percentage string with '%'\n */\nconst percent = (options?:string[]): FilterFn<string> => {\n  const opt = options?.[0] ?? '0';\n  if (!validateNumberString(opt)) {optionMustBeNumber('percent');}\n  return (value: unknown): string => {\n    if (typeof value !== 'number') {valueMustBeNumber('percent');}\n    return `${(value * 100).toFixed(Number(opt))}%`;\n  }\n}\n\n/**\n * Unit filter - appends a CSS unit (or any suffix) to the value.\n *\n * A number alone does nothing in CSS, so without this the unit has to be built in\n * state — which drags presentation into the source of truth, and in the worst case\n * forces a whole derived array just to carry `\"42%\"` strings.\n * `style.height: samples.*.cpu|clamp(0,100)|fix(0)|unit(%)` keeps it on the wire.\n *\n * Accepts strings as well as numbers **on purpose**: the useful chains run through\n * `fix` / `percent`, which already return strings. Rejecting non-numbers here would\n * break exactly the combination this filter exists for.\n *\n * `null` / `undefined` pass through untouched rather than becoming `\"undefinedpx\"`,\n * so the binding layer's \"undefined skips the write, null clears\" semantics survive.\n *\n * @param options - Array with the unit/suffix as first element (required)\n * @returns Filter function that returns the value with the unit appended\n */\nconst unit = (options?:string[]): FilterFn<unknown> => {\n  const opt = options?.[0] ?? optionsRequired('unit');\n  return (value: unknown): unknown => {\n    if (value === null || typeof value === 'undefined') {return value;}\n    return String(value) + opt;\n  }\n}\n\n/**\n * Join filter - joins array elements into a string.\n *\n * The default separator is `\", \"` rather than `\",\"`: a bare comma is what `String()`\n * already produces without any filter, so defaulting to it would make `|join` a no-op.\n *\n * @param options - Array with separator as first element (default: ', ')\n * @returns Filter function that returns the joined string\n */\nconst join = (options?:string[]): FilterFn<string> => {\n  const opt = options?.[0] ?? ', ';\n  return (value: unknown): string => {\n    if (!Array.isArray(value)) {valueMustBeArray('join');}\n    return value.join(opt);\n  }\n}\n\n/**\n * Truncate filter - shortens a string and appends an ellipsis.\n *\n * The length option counts **kept characters**, not the total including the suffix,\n * matching the existing `slice(0, n)` reading. A string at or below the limit is\n * returned untouched (no suffix).\n *\n * @param options - Array with max kept length as first element and suffix as second (default: '…')\n * @returns Filter function that returns the truncated string\n */\nconst truncate = (options?:string[]): FilterFn<string> => {\n  const opt1 = options?.[0] ?? optionsRequired('truncate');\n  if (!validateNumberString(opt1)) {optionMustBeNumber('truncate');}\n  const maxLength = Number(opt1);\n  const suffix = options?.[1] ?? '…';\n  return (value: unknown): string => {\n    const v = String(value);\n    if (v.length <= maxLength) {return v;}\n    return v.slice(0, maxLength) + suffix;\n  }\n}\n\n/**\n * Date filter - formats Date object as localized date string.\n *\n * @param options - Array with locale string as first element (default: config.locale)\n * @returns Filter function that returns date string\n */\nconst date = (options?:string[]): FilterFn<string> => {\n  // 既定ロケールは適用のたびに読む（`locale` フィルタの注記を参照）\n  const explicit = options?.[0];\n  return (value: unknown): string => {\n    if (!(value instanceof Date))  {valueMustBeDate('date');}\n    return value.toLocaleDateString(explicit ?? config.locale);\n  }\n}\n\n/**\n * Time filter - formats Date object as localized time string.\n * \n * @param options - Array with locale string as first element (default: config.locale)\n * @returns Filter function that returns time string\n */\nconst time = (options?:string[]): FilterFn<string> => {\n  // 既定ロケールは適用のたびに読む（`locale` フィルタの注記を参照）\n  const explicit = options?.[0];\n  return (value: unknown): string => {\n    if (!(value instanceof Date)) {valueMustBeDate('time');}\n    return value.toLocaleTimeString(explicit ?? config.locale);\n  }\n}\n\n/**\n * DateTime filter - formats Date object as localized date and time string.\n * \n * @param options - Array with locale string as first element (default: config.locale)\n * @returns Filter function that returns datetime string\n */\nconst datetime = (options?:string[]): FilterFn<string> => {\n  // 既定ロケールは適用のたびに読む（`locale` フィルタの注記を参照）\n  const explicit = options?.[0];\n  return (value: unknown): string => {\n    if (!(value instanceof Date)) {valueMustBeDate('datetime');}\n    return value.toLocaleString(explicit ?? config.locale);\n  }\n}\n\n/**\n * Year-Month-Day filter - formats Date object as YYYY-MM-DD string.\n * \n * @param options - Array with separator string as first element (default: '-')\n * @returns Filter function that returns formatted date string\n */\nconst ymd = (options?:string[]): FilterFn<string> => {\n  const opt = options?.[0] ?? '-';\n  return (value: unknown): string => {\n    if (!(value instanceof Date)) {valueMustBeDate('ymd');}\n    const year = value.getFullYear().toString();\n    const month = (value.getMonth() + 1).toString().padStart(2, '0');\n    const day = value.getDate().toString().padStart(2, '0');\n    return `${year}${opt}${month}${opt}${day}`;\n  }\n}\n\n/**\n * Hour-Minute-Second filter - formats Date object as HH:MM:SS string.\n *\n * The counterpart of `ymd`: a fixed, zero-padded, locale-independent rendering with a\n * configurable separator, for when `time` (locale-formatted) is not stable enough.\n *\n * @param options - Array with separator string as first element (default: ':')\n * @returns Filter function that returns formatted time string\n */\nconst hms = (options?:string[]): FilterFn<string> => {\n  const opt = options?.[0] ?? ':';\n  return (value: unknown): string => {\n    if (!(value instanceof Date)) {valueMustBeDate('hms');}\n    const hours = value.getHours().toString().padStart(2, '0');\n    const minutes = value.getMinutes().toString().padStart(2, '0');\n    const seconds = value.getSeconds().toString().padStart(2, '0');\n    return `${hours}${opt}${minutes}${opt}${seconds}`;\n  }\n}\n\n/**\n * Falsy filter - checks if value is falsy, by JavaScript's own truthiness (`!value`: false, null,\n * undefined, 0, -0, 0n, '' and NaN). Before 3.0 the list was spelled out and missed 0n (B10).\n *\n * @param options - Unused\n * @returns Filter function that returns true for falsy values\n */\nconst falsy = (_options?:string[]): FilterFn<boolean> => {\n  return (value: unknown): boolean => !value;\n}\n\n/**\n * Truthy filter - checks if value is truthy.\n * \n * @param options - Unused\n * @returns Filter function that returns true for non-falsy values\n */\nconst truthy = (_options?:string[]): FilterFn<boolean> => {\n  // JavaScript's truthiness, the same as the `boolean` filter (B10)\n  return (value: unknown): boolean => !!value;\n}\n\n/**\n * Default filter - returns default value if input is falsy (JavaScript's truthiness, as `falsy`).\n * \n * @param options - Array with default value as first element\n * @returns Filter function that returns value or default\n */\nconst defaults = (options?:string[], literals?: readonly unknown[]): FilterFn<unknown> => {\n  const opt = options?.[0] ?? optionsRequired('defaults');\n  // The fallback is the typed literal (B9): defaults(0) gives 0, defaults(null) gives null, defaults('0') gives \"0\"\n  const fallback = literals !== undefined && literals.length > 0 ? literals[0] : opt;\n  return (value: unknown): unknown => {\n    if (!value) {return fallback;}\n    return value;\n  }\n}\n\n/**\n * Boolean filter - converts value to boolean.\n * \n * @param options - Unused\n * @returns Filter function that returns boolean\n */\nconst boolean = (_options?:string[]): FilterFn<boolean> => {\n  return (value: unknown): boolean => {\n    return Boolean(value);\n  }\n}\n\n/**\n * Number filter - converts value to number.\n * \n * @param options - Unused\n * @returns Filter function that returns number\n */\nconst number = (_options?:string[]): FilterFn<number> => {\n  return (value: unknown): number => {\n    return Number(value);\n  }\n}\n\n/**\n * String filter - converts value to string.\n * \n * @param options - Unused\n * @returns Filter function that returns string\n */\nconst string = (_options?:string[]): FilterFn<string> => {\n  return (value: unknown): string => {\n    return String(value);\n  }\n}\n\n/**\n * Null filter - converts empty string to null.\n * \n * @param options - Unused\n * @returns Filter function that returns null for empty string, otherwise original value\n */\nconst _null = (_options?:string[]): FilterFn<unknown> => {\n  return (value: unknown): unknown => {\n    return (value === \"\") ? null : value;\n  } \n}\n\nconst builtinFilters: FilterWithOptions = {\n  \"eq\": eq,\n  \"ne\": ne,\n  \"not\": not,\n\n  \"lt\": lt,\n  \"le\": le,\n  \"gt\": gt,\n  \"ge\": ge,\n\n  \"inc\": inc,\n  \"dec\": dec,\n  \"mul\": mul,\n  \"div\": div,\n  \"mod\": mod,\n  \"abs\": abs,\n  \"clamp\": clamp,\n\n  \"fix\": fix,\n  \"locale\": locale,\n  \"uc\": uc,\n  \"lc\": lc,\n  \"cap\": cap,\n  \"trim\": trim,\n  \"slice\": slice,\n  \"substr\": substr,\n  \"pad\": pad,\n  \"rep\": rep,\n  \"rev\": rev,\n  \"truncate\": truncate,\n  \"join\": join,\n\n  \"int\": int,\n  \"float\": float,\n  \"round\": round,\n  \"floor\": floor,\n  \"ceil\": ceil,\n  \"percent\": percent,\n  \"unit\": unit,\n\n  \"date\": date,\n  \"time\": time,\n  \"datetime\": datetime,\n  \"ymd\": ymd,\n  \"hms\": hms,\n\n  \"falsy\": falsy,\n  \"truthy\": truthy,\n  \"defaults\": defaults,\n\n  \"boolean\": boolean,\n  \"number\": number,\n  \"string\": string,\n  \"null\": _null,\n};\n\n/**\n * The argument count each built-in accepts, [min, max] — checked when the bindings are planned\n * (`[wcs/filter-arity]`, requirement B3), with the same bounds lint uses. It is the same data as\n * `builtinFilterMeta` (filters/filterMeta.ts) without the descriptions, so that installing the formats\n * does not pull the metadata into the page; a test keeps the two equal.\n */\nexport const builtinFilterArity: Readonly<Record<string, readonly [number, number]>> = {\n  eq: [1, 1],\n  not: [0, 0],\n  ne: [1, 1],\n  lt: [1, 1],\n  le: [1, 1],\n  gt: [1, 1],\n  ge: [1, 1],\n  inc: [0, 1],\n  dec: [0, 1],\n  mul: [1, 1],\n  div: [1, 1],\n  mod: [1, 1],\n  abs: [0, 0],\n  clamp: [2, 2],\n  fix: [0, 1],\n  locale: [0, 1],\n  uc: [0, 0],\n  lc: [0, 0],\n  cap: [0, 0],\n  trim: [0, 0],\n  slice: [1, 2],\n  substr: [1, 2],\n  pad: [1, 2],\n  rep: [1, 1],\n  rev: [0, 0],\n  truncate: [1, 2],\n  join: [0, 1],\n  int: [0, 0],\n  float: [0, 0],\n  round: [0, 1],\n  floor: [0, 1],\n  ceil: [0, 1],\n  percent: [0, 1],\n  unit: [1, 1],\n  date: [0, 0],\n  time: [0, 0],\n  datetime: [0, 0],\n  ymd: [0, 1],\n  hms: [0, 1],\n  falsy: [0, 0],\n  truthy: [0, 0],\n  defaults: [1, 1],\n  boolean: [0, 0],\n  number: [0, 0],\n  string: [0, 0],\n  null: [0, 0],\n};\n\nexport const outputBuiltinFilters = builtinFilters;\nexport const inputBuiltinFilters = builtinFilters;\n\nexport const builtinFiltersByFilterIOType = {\n  \"input\": inputBuiltinFilters,\n  \"output\": outputBuiltinFilters,\n} as const;\n\n/**\n * Retrieves built-in filter function by name and options.\n * \n * @param name - Filter name\n * @param options - Array of option strings\n * @returns Function that takes FilterWithOptions and returns filter function\n */\nexport const builtinFilterFn = (name:string, options: string[]) => (filters: FilterWithOptions) => {\n  const filter = filters[name];\n  if (!filter) {\n    // lint の wcs/filter-unknown と同じ語彙・同じ did-you-mean 規準（三面同語彙）。\n    raiseError(`[wcs/filter-unknown] filter not found: ${name}.${didYouMean(name, Object.keys(filters))}${LINT_HINT}`);\n  }\n  return filter(options);\n}\n\n","/**\n * formats/install.ts — 書式フィルタ群の install（設計案 §4、要件 D16）。\n *\n * `uc` / `date` / `round` / `truncate` … の実装を core の登録簿へ置く。core 自身が持つのは\n * エンジンが差し込む `not` だけなので、この機能を入れないページでは、宣言されたフィルタが\n * 束縛計画の段で `[wcs/filter-unknown]` として名指しで落ちる（黙って素通ししない）。\n */\nimport { registerFilters } from \"../core/filterRegistry\";\nimport { builtinFilterArity, inputBuiltinFilters, outputBuiltinFilters } from \"./builtinFilters\";\n\nlet installed = false;\n/** 冪等。full / auto では `bootstrapState()` が呼ぶ */\nexport function installFormats(): void {\n  if (installed) return;\n  installed = true;\n  registerFilters(\"input\", inputBuiltinFilters, builtinFilterArity);\n  registerFilters(\"output\", outputBuiltinFilters, builtinFilterArity);\n}\n","/**\n * features/formats.ts — 書式フィルタ群（@wcstack/state/features/formats）。\n * `|uc` `|date(…)` `|round(…)` のような宣言が要求する実関数を core の登録簿へ置く。\n */\nimport type { IStateFeature } from \"../core/features\";\nimport { installFormats } from \"../formats/install\";\n\nexport const formats: IStateFeature = {\n  name: \"formats\",\n  install(): void {\n    installFormats();\n  },\n};\nexport default formats;\n"],"names":["optionsRequired","fnName","raiseError","optionMustBeNumber","valueMustBeNumber","valueMustBeDate","validateNumberString","value","isNaN","Number","builtinFilters","eq","options","literals","opt","literal","undefined","length","ne","not","_options","lt","le","gt","ge","inc","dec","mul","div","mod","abs","Math","clamp","opt1","opt2","min","max","fix","toFixed","locale","explicit","toLocaleString","config","uc","String","toUpperCase","lc","toLowerCase","cap","v","charAt","slice","trim","numberedOpts","push","substr","pad","padStart","rep","repeat","rev","split","reverse","join","truncate","maxLength","suffix","Array","isArray","int","parseInt","float","parseFloat","round","optValue","pow","floor","ceil","percent","unit","date","Date","toLocaleDateString","time","toLocaleTimeString","datetime","ymd","year","getFullYear","toString","month","getMonth","day","getDate","hms","hours","getHours","minutes","getMinutes","seconds","getSeconds","falsy","truthy","defaults","fallback","boolean","Boolean","number","string","null","builtinFilterArity","outputBuiltinFilters","inputBuiltinFilters","installed","formats","name","install","registerFilters"],"mappings":"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"}

package/dist/split/features/recursion.d.ts

@@ -0,0 +1,9 @@
+import { I as IStateFeature } from '../chunks/features.js';
+
+/**
+ * features/recursion.ts — `$recursion` と `**`（@wcstack/state/features/recursion）。
+ */
+
+declare const recursion: IStateFeature;
+
+export { recursion as default, recursion };

package/dist/split/features/recursion.js

@@ -0,0 +1,2 @@
+import{a as e,N as t,g as n,r}from"../chunks/getAllPropertyDescriptors.js";import{R as s,D as i,W as o,M as a,r as c,g as l,s as h,m as u}from"../chunks/pathDiagnostics.js";import{g as f,a as d,s as p,b as g,c as m,d as v,e as w}from"../chunks/setAll.js";import{K as $,k as y,l as x,L as P,M as _,N as A,J as b,G as k}from"../chunks/binder.js";import{r as I}from"../chunks/errorGuidance.js";import"../chunks/checkDependency.js";import"../chunks/filterRegistry.js";function L(e){return-1!==e.indexOf(s)}function R(e,t){if(t===e.recursiveAnchor)return"";const n=e.recursiveAnchor+i;if(!t.startsWith(n))return null;const r=t.slice(e.recursiveAnchor.length);if(L(r))return null;const s=r.slice(i.length).split(i);return s[0]===o||s.some(e=>0===e.length)?null:r}function j(e){return 0===e.length?e:i+S(e.slice(i.length))}function O(e,t,n){const r=i+e.repeat,s=t.length<=n.length?t:n,o=t.length<=n.length?n:t;if(!o.endsWith(s))return!1;const a=o.slice(0,o.length-s.length);if(0===a.length)return!0;if(a.length%r.length!==0)return!1;for(let e=0;e<a.length;e+=r.length)if(!a.startsWith(r,e))return!1;return!0}function W(e,t,n){for(let r=n.length;r>0;r=n.lastIndexOf(i,r-1))if(O(e,t,n.slice(0,r)))return!0;return!1}function S(e){const t=e.split(i);for(let e=0;e<t.length;e++)t[e]===o||Number.isNaN(Number(t[e]))||(t[e]=o);return t.join(i)}function N(e,t){const n=e.repeat.split(i),r=i+e.repeat;let s=t;for(;s.startsWith(r);)s=s.slice(r.length);if(0===s.length||s===i+e.repeatList+i+"length")return!0;for(let e=1;e<n.length;e++)if(s===i+n.slice(0,e).join(i))return!0;return!1}function B(e,t,n){n<0&&I(`Recursion depth must not be negative (got ${n}).`);let r=e.anchor;for(let t=0;t<n;t++)r+=i+e.repeat;const s=r+t;let c=0;for(const e of s.split(i))e===o&&c++;return c>a&&I(`[wcs/recursion-depth-exceeded] Recursion on "${e.anchor}" reached depth ${n} ("${s}"), which needs ${c} wildcard levels — the limit is ${a}. Either the data nests deeper than the engine can address, or the tree contains a cycle.`),s}function E(e,t){return B(e,"",t)}function C(e,t,n){if(!n.startsWith(e.anchor))return null;if(t.length>0&&!n.endsWith(t))return null;if(n.length<e.anchor.length+t.length)return null;const r=n.slice(e.anchor.length,n.length-t.length);if(0===r.length)return 0;const s=i+e.repeat;let o=0,a=0;for(;a<r.length;){if(!r.startsWith(s,a))return null;a+=s.length,o++}return o}function G(e,t){if(0===e.addressStackLength)return null;const n=e.lastAddressStack;if(null===n)return null;const r=t.accessorFor(n.pathInfo.path);return null!==r?r.depth:function(e,t){const n=e.spec;if(!t.startsWith(n.anchor))return null;const r=i+n.repeat;let s=0,o=n.anchor.length;for(;t.startsWith(r,o);)o+=r.length,s++;return o!==t.length&&46!==t.charCodeAt(o)?null:s}(t,n.pathInfo.path)}function D(e,t,n){const r=e.recursionRegistry,s=R(r.spec,n);null===s&&I(c(n,r.spec.recursiveAnchor));const i=G(t,r);return null===i&&I(`[wcs/recursion-context] "${n}" uses "**", which is bound to the depth of the recursive getter being evaluated, and there is no recursion context here. Read it from inside a recursive getter or a row getter under "${r.spec.anchor}", or name a concrete depth (for example "${r.spec.anchor}${n.slice(r.spec.recursiveAnchor.length)}"). The depth comes from the innermost frame only: a plain getter reached from a recursive getter has no row of its own, so read "**" in the recursive getter and pass the value on.`),r.concretePathAt(s,i)}function M(e,t,n,r,s){const o=r.spec,a=[],c=new Map,h=[],u=o.repeatList,d=o.anchorList,p=new Set,g=new Set,m=(e,t,n)=>{const r=e.wildcardParentPathInfos;if(t>=r.length)return void a.push(y(e,n));const s=v(r[t],n,null).rows;for(let n=0;n<s.length;n++)m(e,t+1,s[n])};function v(r,s,i){const a=y(r,s),l=x(n.stateElement,a),h=f(e,a,t,n),d=null===i?null:((e,t,n)=>{if(!Array.isArray(t)||0===t.length)return null;const r=t;return p.has(r)&&I(`[wcs/recursion-cycle] "${e}" is reachable from itself: the recursion on "${o.anchor}" walked into a list that one of its own ancestors already owns. The data contains a cycle, which this version does not support.`),n.has(r)&&I(`[wcs/recursion-shared-list] "${e}" is the same array instance as a list reached from another node. The recursion on "${o.anchor}" needs a tree: give each node its own "${u}" array.`),r})(r.path,h,i),g=P(s,_(l),h);return c.set(l,Array.isArray(h)?h:[]),null!==d&&null!==i&&i.add(d),{rows:g.newIndexes,tracked:d}}const w=(e,t,n)=>{const{rows:o,tracked:c}=v(t,n,g);if(0===o.length)return;const f=(e=>{const t=h[e];if(void 0!==t)return t;const n=r.concretePathAt(s,e),o=0===s.length?n:r.concretePathAt("",e),a={nodePath:o,concretePathInfo:l(n),childListPathInfo:l(o+i+u)};return h[e]=a,a})(e),d=c;p.add(d);const $=f.concretePathInfo.wildcardCount===e+1;for(let t=0;t<o.length;t++){const n=o[t];$?a.push(y(f.concretePathInfo,n)):m(f.concretePathInfo,e+1,n),w(e+1,f.childListPathInfo,n)}p.delete(d)};w(0,l(d),null);for(const[e,t]of c)$(e,t);return a}function z(e,t,n,r,s,i,o){d(n);const a=n.stateElement.recursionRegistry,l=R(a.spec,r);null===l&&I(c(r,a.spec.recursiveAnchor));const u=j(l);Array.isArray(s)||I(h(r,'with "**" requires an explicit empty indexes array ([]) — the write API takes no context.')),s.length>0&&I(`[wcs/recursion-setall-form] $setAll("${r}", indexes, …) with "**" takes no partial prefix: a prefix cannot say which depth it applies to. Pass [] to broadcast to every depth.`),"function"==typeof i&&I(h(r,'with "**" does not take a mapper yet — the index tuple has a different length at each depth.')),!0===o?.spread&&I(h(r,'with "**" does not take { spread: true } — handing a flat array to a tree needs the author to know the walk order, which is not a usable contract.')),function(e,t,n){N(e,n)&&I(`[wcs/recursion-structural-write] "${t}" writes the recursion structure itself (a node, its "${e.repeatList}" list or that list's length, or an object on the way to that list). This version broadcasts to leaf properties only — replacing a node would invalidate the child addresses already resolved for this write.`)}(a.spec,r,u);const f=a.conflictingRecursiveGetter(u);null!==f&&I(`[wcs/recursion-readonly] "${r}" writes into the recursive getter "${f}", which has no setter — the two name the same family of concrete paths (or this path points inside the value that getter derives). Write the values it derives from instead.`);const g=M(e,t,n,a,l);let m=0;for(let r=0;r<g.length;r++)void 0!==i&&(p(e,g[r],i,t,n),m++);return m}const T={write(e,n){if(!0!==e.hasRecursion)return t;const r=e.recursionRegistry.recursiveGetterOwningPath(n.pathInfo);return null!==r&&I(`[wcs/recursion-readonly] "${n.pathInfo.path}" writes into the recursive getter "${r}" (this path is that getter at one depth, or a path inside the value it derives), which has no setter. Write the values it derives from instead.`),t},get(e,n,r,s){if(!0!==e.stateElement.hasRecursion)return t;if("$getAll"===n)return(t,i)=>{if(L(t)){if(void 0!==i)return function(e,t,n,r,s){const i=n.stateElement.recursionRegistry,o=R(i.spec,r);null===o&&I(c(r,i.spec.recursiveAnchor)),Array.isArray(s)||I(`[wcs/recursion-getall-form] $getAll("${r}", indexes) with "**" takes either no indexes (to read the depth of the recursive getter being evaluated) or [] (to walk every depth) — got ${null===s?"null":typeof s}.`),s.length>0&&I(`[wcs/recursion-getall-form] $getAll("${r}", indexes) with "**" takes no partial prefix: a prefix cannot say which depth it applies to. Omit the indexes to read the depth of the recursive getter being evaluated, or pass [] to walk every depth.`);const a=M(e,t,n,i,o),l=[];for(let r=0;r<a.length;r++)l.push(f(e,a[r],t,n));return l}(s,r,e,t,i);t=D(e.stateElement,e,t)}return g(s,n,r,e)(t,i)};if("$setAll"===n)return(t,i,o,a)=>L(t)?z(s,r,e,t,i,o,a):m(s,n,r,e)(t,i,o,a);if(36!==n.charCodeAt(0)&&L(n)){const t=v(D(e.stateElement,e,n)),i=w(s,t,r,e);return f(s,y(t.pathInfo,i),r,e)}return t}};let F=!1;function q(e,t){"string"==typeof t&&0!==t.length||I(`[wcs/recursion-declaration-invalid] ${u} ${e} must be a non-empty string.`);const n=t.split(i);n.some(e=>0===e.length)&&I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must not contain empty path segments.`),n.length<2&&I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must name a list element: a property path ending with "${i}${o}" (for example "nodes${i}${o}").`),n[n.length-1]!==o&&I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must end with "${i}${o}" — it names the element of the list, not the list itself.`),36===n[0].charCodeAt(0)&&I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must not start with "$" — that namespace is reserved.`),-1!==t.indexOf("#")&&I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must not contain "#" — that segment is reserved for mounts.`);for(let r=0;r<n.length-1;r++)n[r]===o&&I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must have exactly one "${o}", at the end. Wildcards in the middle are not supported in this version.`),n[r]===s&&I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must not contain "${s}" — the declaration is what gives "${s}" its meaning.`),isNaN(Number(n[r]))||I(`[wcs/recursion-declaration-invalid] ${u} ${e} "${t}" must not contain an index segment ("${n[r]}") — the recursion is declared over the shape of the tree, not over one row.`)}const H=new WeakSet;function J(e){return"function"==typeof e.get&&H.has(e.get)}function K(e,t,n){if(0!==n.size){for(const e of n){const n=Object.getOwnPropertyDescriptor(t,e);void 0!==n&&J(n)&&delete t[e]}for(const t of[e.staticDependency,e.dynamicDependency]){for(const e of n)t.delete(e);for(const[e,r]of t){let s=null;for(let e=0;e<r.length;e++)n.has(r[e])?s??=r.slice(0,e):s?.push(r[e]);null!==s&&(0===s.length?t.delete(e):t.set(e,s))}}!function(e,t,n){for(const r of n){const n=l(r),s=n.wildcardParentPathInfos,i=(t,r,o)=>{if(o===s.length)return void A(b(e,n,r),null);const a=0===o?0:s[o-1].segments.length+1;let c=t;for(const e of s[o].segments.slice(a))c=c?.[e];if(!Array.isArray(c))return;const l=k(c);if(null===l)return;const h=Math.min(l.length,c.length);for(let e=0;e<h;e++)i(c[e],l[e],o+1)};i(t,null,0)}}(e,t,n)}}const Q="[wcs/recursion-declaration-invalid]";class U{spec;_definitions=new Map;_accessors=new Map;_ownerByPath=new Map;_ownerByPathInfo=new WeakMap;_accessorByPathInfo=new WeakMap;_concreteBySuffix=new Map;_registeredListPaths=new Set;constructor(e,t){this.spec=e;const r=n(t);for(const[t,n]of Object.entries(r)){if(!L(t))continue;"function"==typeof n.set&&I(`${Q} Recursive setters are not supported in this version: "${t}". Declare a plain path setter, or write through the concrete path.`),"function"!=typeof n.get&&I(`${Q} "${t}" contains "**" but is not a getter. The recursion wildcard only names a family of computed paths.`);const r=R(e,t);null===r&&I(c(t,e.recursiveAnchor)),0===r.length&&I(`${Q} "${t}" names the recursive node itself. "**" names a computed path under a node (for example "${e.recursiveAnchor}${i}total"), not the node.`),N(e,j(r))&&I(`${Q} "${t}" names the recursion structure itself (a node, its "${e.repeatList}" list or that list's length, or an object on the way to that list). A recursive getter would hide the real child list at every depth — "**" names a computed leaf under a node (for example "${e.recursiveAnchor}${i}total").`),this._definitions.set(t,{recursivePath:t,suffix:r,get:n.get})}this._assertNoColliding(),this._assertNoConcreteCollision(r)}_assertNoConcreteCollision(e){for(const[t,n]of Object.entries(e)){if(L(t)||J(n))continue;const e=this._matchExpansion(t);null!==e&&I(`${Q} "${t}" is already defined on the state, so the recursive getter "${e}" cannot expand to it. Rename one of them.`)}}_assertNoColliding(){const e=Array.from(this._definitions.values());for(let t=0;t<e.length;t++)for(let n=t+1;n<e.length;n++)O(this.spec,e[t].suffix,e[n].suffix)&&I(`${Q} "${e[t].recursivePath}" and "${e[n].recursivePath}" expand to the same concrete path at different depths (they differ by whole repetitions of "${this.spec.repeat}"). Rename one of them.`)}get hasDefinitions(){return this._definitions.size>0}conflictingRecursiveGetter(e){for(const t of this._definitions.values())if(W(this.spec,t.suffix,e))return t.recursivePath;return null}recursiveGetterOwningPath(e){const t=this._ownerByPathInfo.get(e);if(void 0!==t)return t;const n=this.recursiveGetterOwning(e.path);return this._ownerByPathInfo.set(e,n),n}recursiveGetterOwning(e){const t=this._accessors.get(e);if(void 0!==t)return t.recursivePath;const n=S(e),r=this._ownerByPath.get(n);if(void 0!==r)return r;let s=null;if(n.startsWith(this.spec.anchor)){s=this._matchExpansion(n);for(let e=n.lastIndexOf(i);null===s&&e>this.spec.anchor.length;e=n.lastIndexOf(i,e-1))s=this._matchExpansion(n.slice(0,e))}return this._ownerByPath.set(n,s),s}_matchExpansion(e){for(const t of this._definitions.values())if(null!==C(this.spec,t.suffix,e))return t.recursivePath;return null}materializeForPathInfo(e,t){if(0===this._definitions.size)return null;const n=this._accessorByPathInfo.get(t);if(void 0!==n)return n;const r=this.materializeFor(e,t.path);return this._accessorByPathInfo.set(t,r),r}materializeFor(e,t){const n=this._accessors.get(t);if(void 0!==n)return n;if(!t.startsWith(this.spec.anchor))return null;let r=null,s=0;for(const e of this._definitions.values()){const n=C(this.spec,e.suffix,t);null!==n&&(null!==r&&I(`"${t}" matches both "${r.recursivePath}" and "${e.recursivePath}".`),r=e,s=n)}return null===r?null:this._define(e,r,s,t)}_define(e,t,n,r){const s=e.findStateDescriptor(r);void 0===s||J(s)||I(`"${r}" is already defined on the state, so the recursive getter "${t.recursivePath}" cannot expand to it. Rename one of them.`);const i=Object.freeze({recursivePath:t.recursivePath,depth:n}),o=t.get,a=function(){return o.call(this)};var c;return c=a,H.add(c),e.defineTreeAccessor(r,{get:a,enumerable:!1,configurable:!0}),this._registerListPaths(e,n),this._accessors.set(r,i),i}_registerListPaths(e,t){for(const n of function(e,t){const n=[];n.push(e.anchorList);for(let r=0;r<t;r++)n.push(E(e,r)+i+e.repeatList);return n}(this.spec,t))this._registeredListPaths.has(n)||(this._registeredListPaths.add(n),e.addListPath(n))}forgetGenerated(e,t){const n=new Set(this._accessors.keys());return K(e,t,n),n}concretePathAt(e,t){let n=this._concreteBySuffix.get(e);void 0===n&&(n=[],this._concreteBySuffix.set(e,n));let r=n[t];return void 0===r&&(r=B(this.spec,e,t),n[t]=r),r}accessorFor(e){return this._accessors.get(e)??null}get materializedPaths(){return new Set(this._accessors.keys())}}const V="recursionSpec",X="recursionRegistry",Y={order:5,validateEarly(e,t,n){const r=function(e){const t=e[u];if(void 0===t)return null;"object"==typeof t&&null!==t||I(`[wcs/recursion-declaration-invalid] ${u} must be an object mapping one anchor path to its repeating sub-path (for example { "nodes.*": "children.*" }).`);const n=Object.entries(t);0===n.length&&I(`[wcs/recursion-declaration-invalid] ${u} must declare exactly one anchor; it is empty.`),n.length>1&&I(`[wcs/recursion-declaration-invalid] ${u} declares ${n.length} anchors (${n.map(([e])=>`"${e}"`).join(", ")}). This version supports exactly one self-recursive anchor per state.`);const[r,a]=n[0];q("anchor",r),"string"!=typeof a&&I(`[wcs/recursion-declaration-invalid] ${u} entry "${r}" must map to the repeating sub-path as a string (for example "children${i}${o}").`),q("repeating sub-path",a);const c=r.slice(0,r.lastIndexOf(i)),l=a.slice(0,a.lastIndexOf(i)),h=c+i+s;return Object.freeze({anchor:r,repeat:a,recursiveAnchor:h,anchorList:c,repeatList:l})}(t);n.set(V,r),n.set(X,null===r?null:new U(r,t))},preCommit(e,t,n){const r=e.recursionRegistry;if(null!==r)for(const t of r.forgetGenerated(e,n.get("previousState")))e.addGeneratedPath?.(t);const s=n.get(X)??null;e.setRecursionRegistry?.(s),null!==s&&e.attachAddressHooks?.("recursion",u)},apply(e,t,n){const r=n.get(V)??null;null!==r&&e.addListPath(r.anchorList)}};let Z=!1;function ee(){Z||(Z=!0,F||(F=!0,e("recursion",T)),r("recursion",Y))}const te={name:"recursion",install(){ee()}};export{te as default,te as recursion};
+//# sourceMappingURL=recursion.js.map