@wcstack/state 1.3.11

package/dist/proxy/StateHandler.js

@@ -0,0 +1,91 @@
+import { raiseError } from "../raiseError";
+import { getStateElementByName } from "../stateElementByName";
+import { get as trapGet } from "./traps/get";
+import { set as trapSet } from "./traps/set";
+import { MAX_LOOP_DEPTH } from "../define";
+class StateHandler {
+    _stateElement;
+    _stateName;
+    _addressStack = Array(MAX_LOOP_DEPTH).fill(undefined);
+    _addressStackIndex = -1;
+    _loopContext;
+    _mutability;
+    constructor(rootNode, stateName, mutability) {
+        this._stateName = stateName;
+        const stateElement = getStateElementByName(rootNode, this._stateName);
+        if (stateElement === null) {
+            raiseError(`StateHandler: State element with name "${this._stateName}" not found.`);
+        }
+        this._stateElement = stateElement;
+        this._mutability = mutability;
+    }
+    get stateName() {
+        return this._stateName;
+    }
+    get stateElement() {
+        return this._stateElement;
+    }
+    get lastAddressStack() {
+        let address = undefined;
+        if (this._addressStackIndex >= 0) {
+            address = this._addressStack[this._addressStackIndex];
+        }
+        if (typeof address === "undefined") {
+            raiseError(`Last address stack is undefined.`);
+        }
+        return address;
+    }
+    get addressStackLength() {
+        return this._addressStackIndex + 1;
+    }
+    get loopContext() {
+        return this._loopContext;
+    }
+    pushAddress(address) {
+        this._addressStackIndex++;
+        if (this._addressStackIndex >= MAX_LOOP_DEPTH) {
+            raiseError(`Exceeded maximum address stack depth of ${MAX_LOOP_DEPTH}. Possible infinite loop.`);
+        }
+        this._addressStack[this._addressStackIndex] = address;
+    }
+    popAddress() {
+        if (this._addressStackIndex < 0) {
+            return null;
+        }
+        const address = this._addressStack[this._addressStackIndex];
+        if (typeof address === "undefined") {
+            raiseError(`Address stack at index ${this._addressStackIndex} is undefined.`);
+        }
+        this._addressStack[this._addressStackIndex] = undefined;
+        this._addressStackIndex--;
+        return address;
+    }
+    setLoopContext(loopContext) {
+        this._loopContext = loopContext;
+    }
+    clearLoopContext() {
+        this._loopContext = undefined;
+    }
+    get(target, prop, receiver) {
+        return trapGet(target, prop, receiver, this);
+    }
+    set(target, prop, value, receiver) {
+        if (this._mutability === "readonly") {
+            raiseError(`State "${this._stateName}" is readonly.`);
+        }
+        return trapSet(target, prop, value, receiver, this);
+    }
+    has(target, prop) {
+        return Reflect.has(target, prop);
+        //    return Reflect.has(target, prop) || this.symbols.has(prop) || this.apis.has(prop);
+    }
+}
+export function createStateProxy(rootNode, state, stateName, mutability) {
+    const handler = new StateHandler(rootNode, stateName, mutability);
+    const stateProxy = new Proxy(state, handler);
+    return stateProxy;
+}
+export const __private__ = {
+    StateHandler,
+};
+//# sourceMappingURL=StateHandler.js.map

package/dist/proxy/StateHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateHandler.js","sourceRoot":"","sources":["../../src/proxy/StateHandler.ts"],"names":[],"mappings":"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"}

package/dist/proxy/apis/connectedCallback.d.ts

@@ -0,0 +1,18 @@
+/**
+ * connectedCallback.ts
+ *
+ * StateClassのライフサイクルフック「$connectedCallback」を呼び出すユーティリティ関数です。
+ *
+ * 主な役割:
+ * - オブジェクト（target）に$connectedCallbackメソッドが定義されていれば呼び出す
+ * - コールバックはtargetのthisコンテキストで呼び出し、IReadonlyStateProxy（receiver）を引数として渡す
+ * - 非同期関数として実行可能（await対応）
+ *
+ * 設計ポイント:
+ * - Reflect.getで$connectedCallbackプロパティを安全に取得
+ * - 存在しない場合は何もしない
+ * - ライフサイクル管理やカスタム初期化処理に利用
+ */
+import { IStateHandler } from "../types";
+export declare function connectedCallback(target: object, _prop: PropertyKey, receiver: any, _handler: IStateHandler): Promise<void>;
+//# sourceMappingURL=connectedCallback.d.ts.map

package/dist/proxy/apis/connectedCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectedCallback.d.ts","sourceRoot":"","sources":["../../../src/proxy/apis/connectedCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC,CAKd"}

package/dist/proxy/apis/connectedCallback.js

@@ -0,0 +1,23 @@
+/**
+ * connectedCallback.ts
+ *
+ * StateClassのライフサイクルフック「$connectedCallback」を呼び出すユーティリティ関数です。
+ *
+ * 主な役割:
+ * - オブジェクト（target）に$connectedCallbackメソッドが定義されていれば呼び出す
+ * - コールバックはtargetのthisコンテキストで呼び出し、IReadonlyStateProxy（receiver）を引数として渡す
+ * - 非同期関数として実行可能（await対応）
+ *
+ * 設計ポイント:
+ * - Reflect.getで$connectedCallbackプロパティを安全に取得
+ * - 存在しない場合は何もしない
+ * - ライフサイクル管理やカスタム初期化処理に利用
+ */
+import { STATE_CONNECTED_CALLBACK_NAME } from "../../define";
+export async function connectedCallback(target, _prop, receiver, _handler) {
+    const callback = Reflect.get(target, STATE_CONNECTED_CALLBACK_NAME);
+    if (typeof callback === "function") {
+        await callback.call(receiver);
+    }
+}
+//# sourceMappingURL=connectedCallback.js.map

package/dist/proxy/apis/connectedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectedCallback.js","sourceRoot":"","sources":["../../../src/proxy/apis/connectedCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,KAAkB,EAClB,QAAa,EACb,QAAuB;IAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;IACpE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/proxy/apis/disconnectedCallback.d.ts

@@ -0,0 +1,17 @@
+/**
+ * disconnectedCallback.ts
+ *
+ * StateClassのライフサイクルフック「$disconnectedCallback」を呼び出すユーティリティ関数です。
+ *
+ * 主な役割:
+ * - オブジェクト（target）に$disconnectedCallbackメソッドが定義されていれば呼び出す
+ * - コールバックはtargetのthisコンテキストで呼び出し、IReadonlyStateProxy（receiver）を引数として渡す
+ *
+ * 設計ポイント:
+ * - Reflect.getで$disconnectedCallbackプロパティを安全に取得
+ * - 存在しない場合は何もしない
+ * - ライフサイクル管理やクリーンアップ処理に利用
+ */
+import { IStateHandler } from "../types";
+export declare function disconnectedCallback(target: object, _prop: PropertyKey, receiver: any, _handler: IStateHandler): void;
+//# sourceMappingURL=disconnectedCallback.d.ts.map

package/dist/proxy/apis/disconnectedCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnectedCallback.d.ts","sourceRoot":"","sources":["../../../src/proxy/apis/disconnectedCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,aAAa,GACtB,IAAI,CAKN"}

package/dist/proxy/apis/disconnectedCallback.js

@@ -0,0 +1,22 @@
+/**
+ * disconnectedCallback.ts
+ *
+ * StateClassのライフサイクルフック「$disconnectedCallback」を呼び出すユーティリティ関数です。
+ *
+ * 主な役割:
+ * - オブジェクト（target）に$disconnectedCallbackメソッドが定義されていれば呼び出す
+ * - コールバックはtargetのthisコンテキストで呼び出し、IReadonlyStateProxy（receiver）を引数として渡す
+ *
+ * 設計ポイント:
+ * - Reflect.getで$disconnectedCallbackプロパティを安全に取得
+ * - 存在しない場合は何もしない
+ * - ライフサイクル管理やクリーンアップ処理に利用
+ */
+import { STATE_DISCONNECTED_CALLBACK_NAME } from "../../define";
+export function disconnectedCallback(target, _prop, receiver, _handler) {
+    const callback = Reflect.get(target, STATE_DISCONNECTED_CALLBACK_NAME);
+    if (typeof callback === "function") {
+        callback.call(receiver);
+    }
+}
+//# sourceMappingURL=disconnectedCallback.js.map

package/dist/proxy/apis/disconnectedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnectedCallback.js","sourceRoot":"","sources":["../../../src/proxy/apis/disconnectedCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAGhE,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,KAAkB,EAClB,QAAa,EACb,QAAuB;IAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IACvE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/proxy/apis/getAll.d.ts

@@ -0,0 +1,11 @@
+/**
+ * getAllReadonly
+ *
+ * ワイルドカードを含む State パスから、対象となる全要素を配列で取得する。
+ * Throws: LIST-201（インデックス未解決）、BIND-201（ワイルドカード情報不整合）
+ */
+import { IStateHandler } from "../types";
+type GetAllFunction = (path: string, indexes?: number[]) => any[];
+export declare function getAll(target: object, prop: PropertyKey, receiver: any, handler: IStateHandler): GetAllFunction;
+export {};
+//# sourceMappingURL=getAll.d.ts.map

package/dist/proxy/apis/getAll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAll.d.ts","sourceRoot":"","sources":["../../../src/proxy/apis/getAll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;AAElE,wBAAgB,MAAM,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,aAAa,GACrB,cAAc,CAuGd"}

package/dist/proxy/apis/getAll.js

@@ -0,0 +1,87 @@
+/**
+ * getAllReadonly
+ *
+ * ワイルドカードを含む State パスから、対象となる全要素を配列で取得する。
+ * Throws: LIST-201（インデックス未解決）、BIND-201（ワイルドカード情報不整合）
+ */
+import { getPathInfo } from "../../address/PathInfo";
+import { createStateAddress } from "../../address/StateAddress";
+import { createListDiff } from "../../list/createListDiff";
+import { raiseError } from "../../raiseError";
+import { getByAddress } from "../methods/getByAddress";
+import { getContextListIndex } from "../methods/getContextListIndex";
+import { resolve } from "./resolve";
+// ToDo: IAbsoluteStateAddressに変更する
+const lastValueByListAddress = new WeakMap();
+export function getAll(target, prop, receiver, handler) {
+    const resolveFn = resolve(target, prop, receiver, handler);
+    return (path, indexes) => {
+        const newValueByAddress = new Map();
+        const pathInfo = getPathInfo(path);
+        if (handler.addressStackLength > 0) {
+            const lastInfo = handler.lastAddressStack?.pathInfo ?? null;
+            const stateElement = handler.stateElement;
+            if (lastInfo !== null && lastInfo.path !== pathInfo.path) {
+                // gettersに含まれる場合は依存関係を登録
+                if (stateElement.getterPaths.has(lastInfo.path)) {
+                    stateElement.addDynamicDependency(pathInfo.path, lastInfo.path);
+                }
+            }
+        }
+        if (typeof indexes === "undefined") {
+            for (let i = 0; i < pathInfo.wildcardParentPathInfos.length; i++) {
+                const wildcardPattern = pathInfo.wildcardParentPathInfos[i];
+                const listIndex = getContextListIndex(handler, wildcardPattern.path);
+                if (listIndex) {
+                    indexes = listIndex.indexes;
+                    break;
+                }
+            }
+            if (typeof indexes === "undefined") {
+                indexes = [];
+            }
+        }
+        const walkWildcardPattern = (wildcardParentPathInfos, wildcardIndexPos, listIndex, indexes, indexPos, parentIndexes, results) => {
+            const wildcardParentPathInfo = wildcardParentPathInfos[wildcardIndexPos] ?? null;
+            if (wildcardParentPathInfo === null) {
+                results.push(parentIndexes);
+                return;
+            }
+            const wildcardAddress = createStateAddress(wildcardParentPathInfo, listIndex);
+            const oldValue = lastValueByListAddress.get(wildcardAddress);
+            const newValue = getByAddress(target, wildcardAddress, receiver, handler);
+            const listDiff = createListDiff(listIndex, oldValue, newValue);
+            const listIndexes = listDiff.newIndexes;
+            const index = indexes[indexPos] ?? null;
+            newValueByAddress.set(wildcardAddress, newValue);
+            if (index === null) {
+                for (let i = 0; i < listIndexes.length; i++) {
+                    const listIndex = listIndexes[i];
+                    walkWildcardPattern(wildcardParentPathInfos, wildcardIndexPos + 1, listIndex, indexes, indexPos + 1, parentIndexes.concat(listIndex.index), results);
+                }
+            }
+            else {
+                const listIndex = listIndexes[index] ??
+                    raiseError(`ListIndex not found: ${wildcardParentPathInfo.path}`);
+                if ((wildcardIndexPos + 1) < wildcardParentPathInfos.length) {
+                    walkWildcardPattern(wildcardParentPathInfos, wildcardIndexPos + 1, listIndex, indexes, indexPos + 1, parentIndexes.concat(listIndex.index), results);
+                }
+                else {
+                    // 最終ワイルドカード層まで到達しているので、結果を確定
+                    results.push(parentIndexes.concat(listIndex.index));
+                }
+            }
+        };
+        const resultIndexes = [];
+        walkWildcardPattern(pathInfo.wildcardParentPathInfos, 0, null, indexes, 0, [], resultIndexes);
+        const resultValues = [];
+        for (let i = 0; i < resultIndexes.length; i++) {
+            resultValues.push(resolveFn(pathInfo.path, resultIndexes[i]));
+        }
+        for (const [address, newValue] of newValueByAddress.entries()) {
+            lastValueByListAddress.set(address, newValue);
+        }
+        return resultValues;
+    };
+}
+//# sourceMappingURL=getAll.js.map

package/dist/proxy/apis/getAll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAll.js","sourceRoot":"","sources":["../../../src/proxy/apis/getAll.ts"],"names":[],"mappings":"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"}

package/dist/proxy/apis/postUpdate.d.ts

@@ -0,0 +1,5 @@
+import { IStateHandler } from "../types";
+type PostFunction = (path: string) => void;
+export declare function postUpdate(target: object, _prop: PropertyKey, receiver: any, handler: IStateHandler): PostFunction;
+export {};
+//# sourceMappingURL=postUpdate.d.ts.map

package/dist/proxy/apis/postUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postUpdate.d.ts","sourceRoot":"","sources":["../../../src/proxy/apis/postUpdate.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAe,MAAM,UAAU,CAAC;AAGtD,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3C,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,aAAa,GACrB,YAAY,CA8Bd"}

package/dist/proxy/apis/postUpdate.js

@@ -0,0 +1,30 @@
+import { getAbsolutePathInfo } from "../../address/AbsolutePathInfo";
+import { createAbsoluteStateAddress } from "../../address/AbsoluteStateAddress";
+import { getResolvedAddress } from "../../address/ResolvedAddress";
+import { createStateAddress } from "../../address/StateAddress";
+import { dirtyCacheEntryByAbsoluteStateAddress } from "../../cache/cacheEntryByAbsoluteStateAddress";
+import { walkDependency } from "../../dependency/walkDependency";
+import { getUpdater } from "../../updater/updater";
+import { getListIndex } from "../methods/getListIndex";
+export function postUpdate(target, _prop, receiver, handler) {
+    const stateElement = handler.stateElement;
+    return (path) => {
+        const resolvedAddress = getResolvedAddress(path);
+        const listIndex = getListIndex(target, resolvedAddress, receiver, handler);
+        const address = createStateAddress(resolvedAddress.pathInfo, listIndex);
+        const absPathInfo = getAbsolutePathInfo(stateElement, address.pathInfo);
+        const absAddress = createAbsoluteStateAddress(absPathInfo, address.listIndex);
+        const updater = getUpdater();
+        updater.enqueueAbsoluteAddress(absAddress);
+        // 依存関係のあるキャッシュを無効化（ダーティ）、更新対象として登録
+        walkDependency(handler.stateName, handler.stateElement, address, handler.stateElement.staticDependency, handler.stateElement.dynamicDependency, handler.stateElement.listPaths, receiver, "new", (depAddress) => {
+            // キャッシュを無効化（ダーティ）
+            const absDepPathInfo = getAbsolutePathInfo(stateElement, depAddress.pathInfo);
+            const absDepAddress = createAbsoluteStateAddress(absDepPathInfo, depAddress.listIndex);
+            dirtyCacheEntryByAbsoluteStateAddress(absDepAddress);
+            // 更新対象として登録
+            updater.enqueueAbsoluteAddress(absDepAddress);
+        });
+    };
+}
+//# sourceMappingURL=postUpdate.js.map

package/dist/proxy/apis/postUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postUpdate.js","sourceRoot":"","sources":["../../../src/proxy/apis/postUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,qCAAqC,EAAE,MAAM,8CAA8C,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,MAAM,UAAU,UAAU,CACxB,MAAc,EACd,KAAkB,EAClB,QAAa,EACb,OAAsB;IAEtB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1C,OAAO,CAAC,IAAY,EAAQ,EAAE;QAC5B,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,kBAAkB,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,0BAA0B,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAC3C,mCAAmC;QACnC,cAAc,CACZ,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,YAAY,EACpB,OAAO,EACP,OAAO,CAAC,YAAY,CAAC,gBAAgB,EACrC,OAAO,CAAC,YAAY,CAAC,iBAAiB,EACtC,OAAO,CAAC,YAAY,CAAC,SAAS,EAC9B,QAAuB,EACvB,KAAK,EACL,CAAC,UAAyB,EAAE,EAAE;YAC5B,kBAAkB;YAClB,MAAM,cAAc,GAAG,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC9E,MAAM,aAAa,GAAG,0BAA0B,CAAC,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;YACvF,qCAAqC,CAAC,aAAa,CAAC,CAAC;YACrD,YAAY;YACZ,OAAO,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC,CACF,CAAC;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/proxy/apis/resolve.d.ts

@@ -0,0 +1,22 @@
+/**
+ * resolve.ts
+ *
+ * StateClassのAPIとして、パス（path）とインデックス（indexes）を指定して
+ * Stateの値を取得・設定するための関数（resolve）の実装です。
+ *
+ * 主な役割:
+ * - 文字列パス（path）とインデックス配列（indexes）から、該当するState値の取得・設定を行う
+ * - ワイルドカードや多重ループを含むパスにも対応
+ * - value未指定時は取得（getByRef）、指定時は設定（setByRef）を実行
+ *
+ * 設計ポイント:
+ * - getStructuredPathInfoでパスを解析し、ワイルドカード階層ごとにリストインデックスを解決
+ * - handler.engine.getListIndexesSetで各階層のリストインデックス集合を取得
+ * - getByRef/setByRefで値の取得・設定を一元的に処理
+ * - 柔軟なバインディングやAPI経由での利用が可能
+ */
+import { IStateHandler } from "../types";
+type ResolveFunction = (path: string, indexes: number[], value?: any) => any;
+export declare function resolve(target: object, _prop: PropertyKey, receiver: any, handler: IStateHandler): ResolveFunction;
+export {};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/proxy/apis/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/proxy/apis/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;AAE7E,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,aAAa,GACrB,eAAe,CAyCjB"}

package/dist/proxy/apis/resolve.js

@@ -0,0 +1,65 @@
+/**
+ * resolve.ts
+ *
+ * StateClassのAPIとして、パス（path）とインデックス（indexes）を指定して
+ * Stateの値を取得・設定するための関数（resolve）の実装です。
+ *
+ * 主な役割:
+ * - 文字列パス（path）とインデックス配列（indexes）から、該当するState値の取得・設定を行う
+ * - ワイルドカードや多重ループを含むパスにも対応
+ * - value未指定時は取得（getByRef）、指定時は設定（setByRef）を実行
+ *
+ * 設計ポイント:
+ * - getStructuredPathInfoでパスを解析し、ワイルドカード階層ごとにリストインデックスを解決
+ * - handler.engine.getListIndexesSetで各階層のリストインデックス集合を取得
+ * - getByRef/setByRefで値の取得・設定を一元的に処理
+ * - 柔軟なバインディングやAPI経由での利用が可能
+ */
+import { getPathInfo } from "../../address/PathInfo";
+import { createStateAddress } from "../../address/StateAddress";
+import { getListIndexesByList } from "../../list/listIndexesByList";
+import { raiseError } from "../../raiseError";
+import { getByAddress } from "../methods/getByAddress";
+import { setByAddress } from "../methods/setByAddress";
+export function resolve(target, _prop, receiver, handler) {
+    return (path, indexes, value) => {
+        const pathInfo = getPathInfo(path);
+        if (handler.addressStackLength > 0) {
+            const lastInfo = handler.lastAddressStack?.pathInfo ?? null;
+            const stateElement = handler.stateElement;
+            if (lastInfo !== null && lastInfo.path !== pathInfo.path) {
+                // gettersに含まれる場合は依存関係を登録
+                if (stateElement.getterPaths.has(lastInfo.path)) {
+                    stateElement.addDynamicDependency(pathInfo.path, lastInfo.path);
+                }
+            }
+        }
+        if (pathInfo.wildcardParentPathInfos.length > indexes.length) {
+            raiseError(`indexes length is insufficient: ${path}`);
+        }
+        // ワイルドカード階層ごとにListIndexを解決していく
+        let listIndex = null;
+        for (let i = 0; i < pathInfo.wildcardParentPathInfos.length; i++) {
+            const wildcardParentPathInfo = pathInfo.wildcardParentPathInfos[i];
+            const wildcardAddress = createStateAddress(wildcardParentPathInfo, listIndex);
+            const tmpValue = getByAddress(target, wildcardAddress, receiver, handler);
+            const listIndexes = getListIndexesByList(tmpValue);
+            if (listIndexes == null) {
+                raiseError(`ListIndexes not found: ${wildcardParentPathInfo.path}`);
+            }
+            const index = indexes[i];
+            listIndex = listIndexes[index] ??
+                raiseError(`ListIndex not found: ${wildcardParentPathInfo.path}`);
+        }
+        // ToDo:WritableかReadonlyかを判定して適切なメソッドを呼び出す
+        const address = createStateAddress(pathInfo, listIndex);
+        const hasSetValue = typeof value !== "undefined";
+        if (!hasSetValue) {
+            return getByAddress(target, address, receiver, handler);
+        }
+        else {
+            setByAddress(target, address, value, receiver, handler);
+        }
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/proxy/apis/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/proxy/apis/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAKvD,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,KAAkB,EAClB,QAAa,EACb,OAAsB;IAEtB,OAAO,CAAC,IAAY,EAAE,OAAiB,EAAE,KAAW,EAAO,EAAE;QAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,OAAO,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,QAAQ,IAAI,IAAI,CAAC;YAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;YAC1C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACzD,yBAAyB;gBACzB,IAAI,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChD,YAAY,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,CAAC,uBAAuB,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7D,UAAU,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,+BAA+B;QAC/B,IAAI,SAAS,GAAsB,IAAI,CAAC;QACxC,KAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChE,MAAM,sBAAsB,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;YACnE,MAAM,eAAe,GAAG,kBAAkB,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;YAC9E,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;gBACxB,UAAU,CAAC,0BAA0B,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC;gBAC5B,UAAU,CAAC,wBAAwB,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,2CAA2C;QAC3C,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,WAAW,CAAC;QACjD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/proxy/apis/trackDependency.d.ts

@@ -0,0 +1,34 @@
+/**
+ * trackDependency.ts
+ *
+ * StateClassのAPIとして、getterチェーン中に参照されたパス間の
+ * 依存関係を動的に登録するための関数（trackDependency）の実装です。
+ *
+ * 主な役割:
+ * - 現在解決中のStatePropertyRef（lastRefStack）を取得
+ * - pathManager.gettersに登録されているgetterの場合のみ依存を追跡
+ * - 自身と同一パターンでない参照に対してaddDynamicDependencyを呼び出す
+ *
+ * 設計ポイント:
+ * - lastRefStackが存在しない場合はSTATE-202エラーを発生させる
+ * - getter同士の再帰（自己依存）は登録しない
+ * - 動的依存はpathManagerに集約し、キャッシュの無効化に利用する
+ */
+import { IStateHandler } from "../types";
+/**
+ * 現在解決中のgetterから、指定されたパスへの動的依存を登録する関数を返します。
+ *
+ * - pathManager.gettersに登録されているgetterのみ依存追跡を行う
+ * - 自己参照は除外し、異なるパターン間の依存だけを記録
+ * - 動的依存はpathManager.addDynamicDependencyで集中管理される
+ *
+ * @param target   プロキシ対象オブジェクト
+ * @param prop     アクセスされたプロパティキー
+ * @param receiver プロキシレシーバ
+ * @param handler  StateClassハンドラ
+ * @returns        引数pathで指定されたパターンへの依存を登録する無名関数
+ */
+type TrackDependencyFunction = (path: string) => void;
+export declare function trackDependency(_target: object, _prop: PropertyKey, _receiver: any, handler: IStateHandler): TrackDependencyFunction;
+export {};
+//# sourceMappingURL=trackDependency.d.ts.map

package/dist/proxy/apis/trackDependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackDependency.d.ts","sourceRoot":"","sources":["../../../src/proxy/apis/trackDependency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;GAYG;AAEH,KAAK,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,aAAa,GACrB,uBAAuB,CAazB"}

package/dist/proxy/apis/trackDependency.js

@@ -0,0 +1,32 @@
+/**
+ * trackDependency.ts
+ *
+ * StateClassのAPIとして、getterチェーン中に参照されたパス間の
+ * 依存関係を動的に登録するための関数（trackDependency）の実装です。
+ *
+ * 主な役割:
+ * - 現在解決中のStatePropertyRef（lastRefStack）を取得
+ * - pathManager.gettersに登録されているgetterの場合のみ依存を追跡
+ * - 自身と同一パターンでない参照に対してaddDynamicDependencyを呼び出す
+ *
+ * 設計ポイント:
+ * - lastRefStackが存在しない場合はSTATE-202エラーを発生させる
+ * - getter同士の再帰（自己依存）は登録しない
+ * - 動的依存はpathManagerに集約し、キャッシュの無効化に利用する
+ */
+import { raiseError } from "../../raiseError";
+export function trackDependency(_target, _prop, _receiver, handler) {
+    return (path) => {
+        if (handler.addressStackLength === 0) {
+            raiseError(`No active state reference to track dependency for path "${path}".`);
+        }
+        const lastInfo = handler.lastAddressStack?.pathInfo ??
+            raiseError('Internal error: lastAddressStack is null');
+        const stateElement = handler.stateElement;
+        if (handler.stateElement.getterPaths.has(lastInfo.path) &&
+            lastInfo.path !== path) {
+            stateElement.addDynamicDependency(path, lastInfo.path);
+        }
+    };
+}
+//# sourceMappingURL=trackDependency.js.map

package/dist/proxy/apis/trackDependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackDependency.js","sourceRoot":"","sources":["../../../src/proxy/apis/trackDependency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmB9C,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,KAAkB,EAClB,SAAc,EACd,OAAsB;IAEtB,OAAO,CAAC,IAAY,EAAQ,EAAE;QAC5B,IAAI,OAAO,CAAC,kBAAkB,KAAK,CAAC,EAAE,CAAC;YACrC,UAAU,CAAC,2DAA2D,IAAI,IAAI,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,QAAQ;YACjD,UAAU,CAAC,0CAA0C,CAAC,CAAC;QACzD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC1C,IAAI,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrD,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACzB,YAAY,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/proxy/apis/updatedCallback.d.ts

@@ -0,0 +1,28 @@
+/**
+ * updatedCallback.ts
+ *
+ * Utility function to invoke the StateClass lifecycle hook "$updatedCallback".
+ *
+ * Main responsibilities:
+ * - Invokes $updatedCallback method if defined on the object (target)
+ * - Callback is invoked with target's this context, passing IReadonlyStateProxy (receiver) as argument
+ * - Executable as async function (await compatible)
+ *
+ * Design points:
+ * - Safely retrieves $updatedCallback property using Reflect.get
+ * - Does nothing if the callback doesn't exist
+ * - Used for lifecycle management and update handling logic
+ */
+import { IAbsoluteStateAddress } from "../../address/types";
+import { IStateHandler } from "../types";
+/**
+ * Invokes the $updatedCallback lifecycle hook if defined on the target.
+ * Aggregates updated paths and their indexes before passing to the callback.
+ * @param target - Target object to check for callback
+ * @param refs - Array of state property references that were updated
+ * @param receiver - State proxy to pass as this context
+ * @param handler - State handler (unused but part of signature)
+ * @returns Promise or void depending on callback implementation
+ */
+export declare function updatedCallback(target: object, refs: IAbsoluteStateAddress[], receiver: any, handler: IStateHandler): unknown;
+//# sourceMappingURL=updatedCallback.d.ts.map

package/dist/proxy/apis/updatedCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updatedCallback.d.ts","sourceRoot":"","sources":["../../../src/proxy/apis/updatedCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,qBAAqB,EAAE,EAC7B,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,aAAa,GACrB,OAAO,CA2BT"}

package/dist/proxy/apis/updatedCallback.js

@@ -0,0 +1,56 @@
+/**
+ * updatedCallback.ts
+ *
+ * Utility function to invoke the StateClass lifecycle hook "$updatedCallback".
+ *
+ * Main responsibilities:
+ * - Invokes $updatedCallback method if defined on the object (target)
+ * - Callback is invoked with target's this context, passing IReadonlyStateProxy (receiver) as argument
+ * - Executable as async function (await compatible)
+ *
+ * Design points:
+ * - Safely retrieves $updatedCallback property using Reflect.get
+ * - Does nothing if the callback doesn't exist
+ * - Used for lifecycle management and update handling logic
+ */
+import { STATE_UPDATED_CALLBACK_NAME } from "../../define";
+/**
+ * Invokes the $updatedCallback lifecycle hook if defined on the target.
+ * Aggregates updated paths and their indexes before passing to the callback.
+ * @param target - Target object to check for callback
+ * @param refs - Array of state property references that were updated
+ * @param receiver - State proxy to pass as this context
+ * @param handler - State handler (unused but part of signature)
+ * @returns Promise or void depending on callback implementation
+ */
+export function updatedCallback(target, refs, receiver, handler) {
+    const callback = Reflect.get(target, STATE_UPDATED_CALLBACK_NAME);
+    if (typeof callback === "function") {
+        const paths = new Set();
+        // ToDo:現状では1階層のみのワイルドカードに対応。多階層対応は後回し
+        const indexesListByPath = {};
+        for (const ref of refs) {
+            const pathInfo = ref.absolutePathInfo.pathInfo;
+            let pathName;
+            if (ref.absolutePathInfo.stateName === handler.stateName) {
+                pathName = pathInfo.path;
+            }
+            else {
+                pathName = pathInfo.path + "@" + ref.absolutePathInfo.stateName;
+            }
+            paths.add(pathName);
+            if (pathInfo.wildcardCount > 0) {
+                const indexes = ref.listIndex.indexes ?? [];
+                const indexesList = indexesListByPath[pathName];
+                if (typeof indexesList === "undefined") {
+                    indexesListByPath[pathName] = [indexes];
+                }
+                else {
+                    indexesList.push(indexes);
+                }
+            }
+        }
+        return callback.call(receiver, Array.from(paths), indexesListByPath);
+    }
+}
+//# sourceMappingURL=updatedCallback.js.map

package/dist/proxy/apis/updatedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updatedCallback.js","sourceRoot":"","sources":["../../../src/proxy/apis/updatedCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAG3D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAA6B,EAC7B,QAAa,EACb,OAAsB;IAEtB,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC3E,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAgB,IAAI,GAAG,EAAE,CAAC;QACrC,sCAAsC;QACtC,MAAM,iBAAiB,GAAoC,EAAE,CAAC;QAC9D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YAC/C,IAAI,QAAQ,CAAC;YACb,IAAI,GAAG,CAAC,gBAAgB,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;gBACzD,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,QAAQ,CAAC,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAClE,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpB,IAAI,QAAQ,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,SAAU,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC7C,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;gBAChD,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;oBACvC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}