@wcstack/state 1.21.5 → 1.21.6

package/README.ja.md

@@ -867,6 +867,7 @@ export default {
 | `this.$resolve(path, indexes, value?)` | ワイルドカードパスを特定のインデックスで解決 |
 | `this.$postUpdate(path)` | 指定パスの更新通知を手動で発行 |
 | `this.$trackDependency(path)` | キャッシュ無効化のための依存関係を手動で登録 |
+| `this.$untrackDependency(fn)` | fn 実行中の依存追跡を抑止して値を読む（`$trackDependency` と対称） |
 | `this.$stateElement` | `IStateElement` インスタンスへのアクセス |
 | `this.$1`, `this.$2`, ... | 現在のループインデックス（1始まりの命名、0始まりの値） |
 

package/README.md

@@ -867,6 +867,7 @@ Inside state objects (getters / methods), the following APIs are available via `
 | `this.$resolve(path, indexes, value?)` | Resolve a wildcard path with specific indexes |
 | `this.$postUpdate(path)` | Manually trigger update notification for a path |
 | `this.$trackDependency(path)` | Manually register a dependency for cache invalidation |
+| `this.$untrackDependency(fn)` | Read values inside fn without registering dependencies (symmetric to `$trackDependency`) |
 | `this.$command.<name>` | Access a `CommandToken` declared in `$commandTokens` (see [Command Token](#command-token-method-binding)) |
 | `this.$stateElement` | Access to the `IStateElement` instance |
 | `this.$1`, `this.$2`, ... | Current loop index (1-based naming, 0-based value) |

package/dist/index.d.ts

@@ -440,6 +440,13 @@ interface WcsStateApi {
      * computed getter 内で動的にパスを組み立てる場合に使用。
      */
     $trackDependency(path: string): void;
+    /**
+     * コールバック実行中の依存追跡（動的依存・`$1` インデックス依存の登録）を
+     * 抑止して fn を実行し、その戻り値を返す（`$trackDependency` と対称）。
+     * リスト行 getter が「行外の単一値」を読みたいが、その値の変更で全行を
+     * 再評価させたくない場合に使う（該当行へ直接書き込む設計と組で用いる）。
+     */
+    $untrackDependency<T>(fn: () => T): T;
     /** `<wcs-state>` 要素への参照 */
     readonly $stateElement: HTMLElement;
     /**