@wcstack/state 2.2.0 → 2.3.0

package/dist/manifest.esm.js

@@ -1079,6 +1079,7 @@ const STATE_EVENT_TOKENS_NAME = "$eventTokens";
 const STATE_ON_NAME = "$on";
 const STATE_STREAMS_NAME = "$streams";
 const STATE_WATCH_NAME = "$watch";
+const STATE_RECURSION_NAME = "$recursion";
 const STATE_LIST_KEYS_NAME = "$listKeys";
 const STATE_STREAM_STATUS_NAMESPACE_NAME = "$streamStatus";
 const STATE_STREAM_ERROR_NAMESPACE_NAME = "$streamError";
@@ -1157,6 +1158,7 @@ function getWcsManifest() {
             STATE_STREAMS_NAME,
             STATE_WATCH_NAME,
             STATE_LIST_KEYS_NAME,
+            STATE_RECURSION_NAME,
             STATE_STREAM_STATUS_NAMESPACE_NAME,
             STATE_STREAM_ERROR_NAMESPACE_NAME,
         ],

package/dist/parser.esm.js

@@ -33,6 +33,17 @@ for (let i = 0; i < MAX_WILDCARD_DEPTH; i++) {
     tmpIndexByIndexName[`${INDEX_PARAM_PREFIX}${i + 1}`] = i;
 }
 Object.freeze(tmpIndexByIndexName);
+/**
+ * 再帰ワイルドカード。オーサリング層（$recursion 宣言・getter キー・API 引数）にだけ
+ * 現れ、PathInfo には決して降ろさない — wildcardCount が不定になると ListIndex 連鎖長・
+ * $1..$n・$resolve の厳密一致・走査の段数が同時に壊れる
+ * （docs/state-recursive-path-design.md §2-1）。
+ */
+const RECURSION_WILDCARD = "**";
+
+function raiseError(message) {
+    throw new Error(`[@wcstack/state] ${message}`);
+}
 
 const _cache = new Map();
 /**
@@ -51,6 +62,16 @@ function getPathInfo(path) {
     if (typeof pathInfo !== "undefined") {
         return pathInfo;
     }
+    // 再帰ワイルドカードはオーサリング層の記号で、ここへ降りてきてはならない
+    // （降ろすと wildcardCount が不定になり ListIndex 連鎖長・$1..$n・$resolve の
+    //  厳密一致・走査の段数が同時に壊れる。設計書 D2）。到達したということは、
+    // `**` を解釈しない消費者に `**` パスが渡ったということ。通常のパスはこの検査を
+    // 初回 intern のときにしか払わない（`**` パスは intern されないので読むたびに落ちる）。
+    if (path.indexOf(RECURSION_WILDCARD) !== -1) {
+        raiseError(`[wcs/recursion-unsupported] "${path}" uses "${RECURSION_WILDCARD}", which is not accepted here. ` +
+            `It is only meaningful in a $recursion declaration, in a recursive getter key, and in the path ` +
+            `argument of $getAll / $setAll — and only when the state declares a $recursion anchor.`);
+    }
     pathInfo = Object.freeze(new PathInfo(path));
     _cache.set(path, pathInfo);
     return pathInfo;
@@ -219,10 +240,6 @@ function didYouMean(input, candidates) {
  */
 const LINT_HINT = " Validate statically: npx @wcstack/lint <file>.";
 
-function raiseError(message) {
-    throw new Error(`[@wcstack/state] ${message}`);
-}
-
 const STRUCTURAL_BINDING_TYPE_SET = new Set([
     "if",
     "elseif",

package/dist/wcs-manifest.json

@@ -643,6 +643,7 @@
     "$streams",
     "$watch",
     "$listKeys",
+    "$recursion",
     "$streamStatus",
     "$streamError"
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/state",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Reactive state management with declarative data binding for Web Components. Zero dependencies, buildless.",
   "type": "module",
   "main": "./dist/index.esm.js",