haori 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -66,6 +66,8 @@ export declare class Core {
     private static readonly REACTIVE_IMPORT_STATES;
     /** data-derive subtree skip の開発用プロファイル */
     private static readonly DERIVE_SUBTREE_PROFILES;
+    /** data-each の差分更新の再入制御状態 */
+    private static readonly EACH_UPDATE_STATES;
     /**
      * 遅延属性かどうか（完全名で判定）を判定します。
      *
@@ -217,6 +219,30 @@ export declare class Core {
      * @returns Promise (DOM操作が完了したときに解決される)
      */
     static setBindingData(element: HTMLElement, data: Record<string, unknown>, skipFragments?: ReadonlySet<ElementFragment>): Promise<void>;
+    /**
+     * 指定要素の式評価で見えるバインディングスコープをダンプします（デバッグ用）。
+     *
+     * 式（`data-if` / `{{...}}` など）の識別子は、その要素を起点に DOM のネストを
+     * たどって解決されます（内側のスコープが外側を上書き）。本メソッドは解決済みの
+     * スコープ（`resolved`）と、各キーがどの要素・どの種類（`bind` または `derive`）に
+     * 由来するか（`sources`）を返します。開発モード時はコンソールにも出力します。
+     *
+     * 注意: フォームの入力値（`name` 属性）は、変更（change）や明示的な同期が行われる
+     * までフォームの binding data に反映されません。したがって初期表示時点では、入力名と
+     * 同名の識別子は**外側のスコープ**にフォールバックして解決されます。
+     *
+     * @param element 対象要素
+     * @return 解決済みスコープと各キーの由来情報
+     */
+    static dumpScope(element: HTMLElement): {
+        resolved: Record<string, unknown>;
+        sources: Record<string, {
+            value: unknown;
+            source: string;
+            kind: 'bind' | 'derive';
+            depth: number;
+        }>;
+    };
     /**
      * data-bind 属性の値をパースします。
      *
@@ -283,21 +309,74 @@ export declare class Core {
      * @returns Promise (DOM操作が完了したときに解決される)
      */
     static evaluateText(fragment: TextFragment): Promise<void>;
+    /**
+     * data-if の評価値が「非表示」とみなされるかどうかを判定します。
+     *
+     * JavaScript の falsy 判定に準拠し、`false`・`null`・`undefined`・`NaN` に加えて
+     * `0`・空文字列 `''` も非表示とします（例: `data-if="items.length"` は要素数 0 で
+     * 非表示）。空配列 `[]` や空オブジェクト `{}` は JavaScript 同様 truthy なので表示されます。
+     *
+     * @param condition data-if の評価結果
+     * @return 非表示とみなす場合は true
+     */
+    private static isHiddenIfCondition;
     /**
      * if要素を評価します。
-     * 値がfalse、null、undefined、NaNの場合は非表示にし、それ以外の場合は表示します。
+     * 値が falsy（false・null・undefined・NaN・0・空文字列）の場合は非表示にし、
+     * それ以外の場合は表示します。
      *
      * @param fragment 対象フラグメント
      * @return Promise (DOM操作が完了したときに解決される)
      */
     static evaluateIf(fragment: ElementFragment): Promise<void>;
+    /**
+     * data-if 表示時に data-load-* 手続きを発火します。
+     *
+     * 対象要素が data-load-* 属性を持つ場合のみ、load 種別の Procedure を1回実行します。
+     * 結果は待機せず（fire-and-forget）、表示処理の完了をブロックしません。
+     *
+     * @param fragment 対象フラグメント
+     * @return 戻り値はありません。
+     */
+    private static triggerLoadOnShow;
+    /**
+     * data-each フラグメントの差分更新の再入制御状態を取得します。
+     *
+     * @param fragment 対象フラグメント
+     * @return 再入制御状態
+     */
+    private static getEachUpdateState;
     /**
      * each要素を評価します。
      * 非表示または未マウントの場合は処理をスキップします。
      *
+     * 同一フラグメントに対する差分更新が並行・再入しないように直列化します。
+     * 実行中に再度呼び出された場合は再評価要求を記録し、現在進行中の更新の完了
+     * Promise（後続の再実行も含む）を返します。これにより、bind 直後のリアクティブ
+     * 再評価が重なっても data-each の描画が破壊されず、かつ呼び出し元（`evaluateAll`→
+     * `setBindingData`→`haori:bindcomplete`）が**最終的な DOM 反映まで確実に待機**できます。
+     *
      * @param fragment 対象フラグメント
+     * @return 差分更新（再実行を含む）の完了 Promise
      */
     static evaluateEach(fragment: ElementFragment): Promise<void>;
+    /**
+     * data-each の差分更新を、再評価要求が無くなるまで直列に繰り返し実行します。
+     * 進行中・後続の再実行を含む完了 Promise を state に保持し、再入した呼び出し元が
+     * 同じ Promise を待てるようにします。
+     *
+     * @param fragment 対象フラグメント
+     * @param state 再入制御状態
+     * @return すべての差分更新が安定するまでの完了 Promise
+     */
+    private static runEachUpdateLoop;
+    /**
+     * data-each の差分更新本体を実行します（再入制御は呼び出し側で行います）。
+     *
+     * @param fragment 対象フラグメント
+     * @return 差分更新完了の Promise
+     */
+    private static performEachUpdate;
     /**
      * data-each 属性値を仕様に従って配列へ正規化します。
      *
@@ -1042,10 +1121,15 @@ export declare class Form {
      */
     private static findFragmentByKeyParts;
     /**
-     * 対象のフラグメントがフォームフラグメントであればそれを返し、
-     * そうでなければ先祖要素をたどってフォームフラグメントを探します。
+     * 対象のフラグメントがフォームコンテナであればそれを返し、
+     * そうでなければ先祖要素をたどってフォームコンテナを探します。
+     *
+     * フォームコンテナは `<form>` 要素、または `data-form` 属性を持つ任意の要素です。
+     * 後者は `<table>` 内など `<form>` を直接置けない箇所で、`<tr>` などを値収集の
+     * コンテナとして扱うために使用します（`data-click-form` 等が対象を探す際に利用）。
      *
-     * @param fragment
+     * @param fragment 探索の起点フラグメント
+     * @returns フォームコンテナのフラグメント。見つからなければ null
      */
     static getFormFragment(fragment: ElementFragment): ElementFragment | null;
 }
@@ -1161,6 +1245,18 @@ declare class Haori {
      * @return 戻り値はありません。
      */
     static setRuntime(runtime: string): void;
+    /**
+     * 進行中・追従して投入されるものを含め、すべてのレンダリングタスクの完了を待ちます。
+     *
+     * `data-each` の大量行のように複数フレームに分割される描画でも、安定して完了する
+     * まで待機します。Playwright などの外部テストから、タブ切り替えやクリック後に
+     * 描画完了を安全に待機するために利用できます。
+     *
+     * 例: `await page.evaluate(() => Haori.waitForRenders())`
+     *
+     * @return すべてのレンダリングが完了したら解決される Promise
+     */
+    static waitForRenders(): Promise<void>;
     /**
      * 通知ダイアログを表示します。
      *
@@ -1288,6 +1384,13 @@ export declare class Queue {
      * 全てのキュー処理が完了するまで待機します。
      */
     static wait(): Promise<void>;
+    /**
+     * レンダリング（追従して投入されるタスクを含む）が安定して完了するまで待機します。
+     *
+     * @param maxIterations 無限ループ防止の最大反復回数
+     * @returns レンダリングが安定するまで解決されない Promise
+     */
+    static waitForIdle(maxIterations?: number): Promise<void>;
 }
 
 /**
@@ -1343,6 +1446,16 @@ declare class TextFragment extends Fragment {
     evaluate(): Promise<void>;
 }
 
-export declare const version = "0.4.13";
+export declare const version = "0.9.0";
+
+/**
+ * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。
+ *
+ * iife グローバルからは `Haori.waitForRenders()`、ESM では
+ * `import {waitForRenders} from 'haori'` で利用できます。
+ *
+ * @return すべてのレンダリングが完了したら解決される Promise
+ */
+export declare const waitForRenders: () => Promise<void>;
 
 export { }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "haori",
-    "version": "0.7.0",
+    "version": "0.9.0",
     "description": "A lightweight HTML-first UI engine powered by declarative data bindings and expressions.",
     "scripts": {
         "dev": "vite",

package/dist/src/core.d.ts

@@ -20,6 +20,8 @@ export default class Core {
     private static readonly REACTIVE_IMPORT_STATES;
     /** data-derive subtree skip の開発用プロファイル */
     private static readonly DERIVE_SUBTREE_PROFILES;
+    /** data-each の差分更新の再入制御状態 */
+    private static readonly EACH_UPDATE_STATES;
     /**
      * 遅延属性かどうか（完全名で判定）を判定します。
      *
@@ -171,6 +173,30 @@ export default class Core {
      * @returns Promise (DOM操作が完了したときに解決される)
      */
     static setBindingData(element: HTMLElement, data: Record<string, unknown>, skipFragments?: ReadonlySet<ElementFragment>): Promise<void>;
+    /**
+     * 指定要素の式評価で見えるバインディングスコープをダンプします（デバッグ用）。
+     *
+     * 式（`data-if` / `{{...}}` など）の識別子は、その要素を起点に DOM のネストを
+     * たどって解決されます（内側のスコープが外側を上書き）。本メソッドは解決済みの
+     * スコープ（`resolved`）と、各キーがどの要素・どの種類（`bind` または `derive`）に
+     * 由来するか（`sources`）を返します。開発モード時はコンソールにも出力します。
+     *
+     * 注意: フォームの入力値（`name` 属性）は、変更（change）や明示的な同期が行われる
+     * までフォームの binding data に反映されません。したがって初期表示時点では、入力名と
+     * 同名の識別子は**外側のスコープ**にフォールバックして解決されます。
+     *
+     * @param element 対象要素
+     * @return 解決済みスコープと各キーの由来情報
+     */
+    static dumpScope(element: HTMLElement): {
+        resolved: Record<string, unknown>;
+        sources: Record<string, {
+            value: unknown;
+            source: string;
+            kind: 'bind' | 'derive';
+            depth: number;
+        }>;
+    };
     /**
      * data-bind 属性の値をパースします。
      *
@@ -237,21 +263,74 @@ export default class Core {
      * @returns Promise (DOM操作が完了したときに解決される)
      */
     static evaluateText(fragment: TextFragment): Promise<void>;
+    /**
+     * data-if の評価値が「非表示」とみなされるかどうかを判定します。
+     *
+     * JavaScript の falsy 判定に準拠し、`false`・`null`・`undefined`・`NaN` に加えて
+     * `0`・空文字列 `''` も非表示とします（例: `data-if="items.length"` は要素数 0 で
+     * 非表示）。空配列 `[]` や空オブジェクト `{}` は JavaScript 同様 truthy なので表示されます。
+     *
+     * @param condition data-if の評価結果
+     * @return 非表示とみなす場合は true
+     */
+    private static isHiddenIfCondition;
     /**
      * if要素を評価します。
-     * 値がfalse、null、undefined、NaNの場合は非表示にし、それ以外の場合は表示します。
+     * 値が falsy（false・null・undefined・NaN・0・空文字列）の場合は非表示にし、
+     * それ以外の場合は表示します。
      *
      * @param fragment 対象フラグメント
      * @return Promise (DOM操作が完了したときに解決される)
      */
     static evaluateIf(fragment: ElementFragment): Promise<void>;
+    /**
+     * data-if 表示時に data-load-* 手続きを発火します。
+     *
+     * 対象要素が data-load-* 属性を持つ場合のみ、load 種別の Procedure を1回実行します。
+     * 結果は待機せず（fire-and-forget）、表示処理の完了をブロックしません。
+     *
+     * @param fragment 対象フラグメント
+     * @return 戻り値はありません。
+     */
+    private static triggerLoadOnShow;
+    /**
+     * data-each フラグメントの差分更新の再入制御状態を取得します。
+     *
+     * @param fragment 対象フラグメント
+     * @return 再入制御状態
+     */
+    private static getEachUpdateState;
     /**
      * each要素を評価します。
      * 非表示または未マウントの場合は処理をスキップします。
      *
+     * 同一フラグメントに対する差分更新が並行・再入しないように直列化します。
+     * 実行中に再度呼び出された場合は再評価要求を記録し、現在進行中の更新の完了
+     * Promise（後続の再実行も含む）を返します。これにより、bind 直後のリアクティブ
+     * 再評価が重なっても data-each の描画が破壊されず、かつ呼び出し元（`evaluateAll`→
+     * `setBindingData`→`haori:bindcomplete`）が**最終的な DOM 反映まで確実に待機**できます。
+     *
      * @param fragment 対象フラグメント
+     * @return 差分更新（再実行を含む）の完了 Promise
      */
     static evaluateEach(fragment: ElementFragment): Promise<void>;
+    /**
+     * data-each の差分更新を、再評価要求が無くなるまで直列に繰り返し実行します。
+     * 進行中・後続の再実行を含む完了 Promise を state に保持し、再入した呼び出し元が
+     * 同じ Promise を待てるようにします。
+     *
+     * @param fragment 対象フラグメント
+     * @param state 再入制御状態
+     * @return すべての差分更新が安定するまでの完了 Promise
+     */
+    private static runEachUpdateLoop;
+    /**
+     * data-each の差分更新本体を実行します（再入制御は呼び出し側で行います）。
+     *
+     * @param fragment 対象フラグメント
+     * @return 差分更新完了の Promise
+     */
+    private static performEachUpdate;
     /**
      * data-each 属性値を仕様に従って配列へ正規化します。
      *

package/dist/src/core.d.ts.map

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

package/dist/src/core.js

@@ -411,10 +411,7 @@ class Core {
     static shouldSkipChildInitialization(fragment, stopAtEach) {
         const condition = fragment.getAttribute(`${Env.prefix}if`);
         if (fragment.hasAttribute(`${Env.prefix}if`) &&
-            (condition === false ||
-                condition === undefined ||
-                condition === null ||
-                Number.isNaN(condition))) {
+            Core.isHiddenIfCondition(condition)) {
             return true;
         }
         return stopAtEach && fragment.hasAttribute(`${Env.prefix}each`);
@@ -541,6 +538,67 @@ class Core {
         HaoriEvent.bindChange(element, previous, data, 'manual');
         return chain.then(() => undefined);
     }
+    /**
+     * 指定要素の式評価で見えるバインディングスコープをダンプします（デバッグ用）。
+     *
+     * 式（`data-if` / `{{...}}` など）の識別子は、その要素を起点に DOM のネストを
+     * たどって解決されます（内側のスコープが外側を上書き）。本メソッドは解決済みの
+     * スコープ（`resolved`）と、各キーがどの要素・どの種類（`bind` または `derive`）に
+     * 由来するか（`sources`）を返します。開発モード時はコンソールにも出力します。
+     *
+     * 注意: フォームの入力値（`name` 属性）は、変更（change）や明示的な同期が行われる
+     * までフォームの binding data に反映されません。したがって初期表示時点では、入力名と
+     * 同名の識別子は**外側のスコープ**にフォールバックして解決されます。
+     *
+     * @param element 対象要素
+     * @return 解決済みスコープと各キーの由来情報
+     */
+    static dumpScope(element) {
+        const fragment = Fragment.get(element);
+        if (!fragment) {
+            return { resolved: {}, sources: {} };
+        }
+        const resolved = fragment.getBindingData();
+        const sources = {};
+        const describe = (frag) => {
+            const target = frag.getTarget();
+            if (target.id) {
+                return `#${target.id}`;
+            }
+            return target.tagName.toLowerCase();
+        };
+        const record = (data, frag, kind, depth) => {
+            if (!data) {
+                return;
+            }
+            for (const key of Object.keys(data)) {
+                if (!(key in sources)) {
+                    sources[key] = {
+                        value: data[key],
+                        source: describe(frag),
+                        kind,
+                        depth,
+                    };
+                }
+            }
+        };
+        let current = fragment;
+        let depth = 0;
+        while (current) {
+            // 子孫から見ると derive は同要素の bind より優先されるため derive を先に記録する。
+            // ただし起点要素自身の derive は自身のスコープには現れない（子孫にのみ公開）。
+            if (current !== fragment) {
+                record(current.getRawDerivedBindingData(), current, 'derive', depth);
+            }
+            record(current.getRawBindingData(), current, 'bind', depth);
+            current = current.getParent();
+            depth += 1;
+        }
+        if (Dev.isEnabled()) {
+            Log.info('[Haori]', 'scope dump for', element, { resolved, sources });
+        }
+        return { resolved, sources };
+    }
     /**
      * data-bind 属性の値をパースします。
      *
@@ -827,9 +885,23 @@ class Core {
     static evaluateText(fragment) {
         return fragment.evaluate();
     }
+    /**
+     * data-if の評価値が「非表示」とみなされるかどうかを判定します。
+     *
+     * JavaScript の falsy 判定に準拠し、`false`・`null`・`undefined`・`NaN` に加えて
+     * `0`・空文字列 `''` も非表示とします（例: `data-if="items.length"` は要素数 0 で
+     * 非表示）。空配列 `[]` や空オブジェクト `{}` は JavaScript 同様 truthy なので表示されます。
+     *
+     * @param condition data-if の評価結果
+     * @return 非表示とみなす場合は true
+     */
+    static isHiddenIfCondition(condition) {
+        return !condition;
+    }
     /**
      * if要素を評価します。
-     * 値がfalse、null、undefined、NaNの場合は非表示にし、それ以外の場合は表示します。
+     * 値が falsy（false・null・undefined・NaN・0・空文字列）の場合は非表示にし、
+     * それ以外の場合は表示します。
      *
      * @param fragment 対象フラグメント
      * @return Promise (DOM操作が完了したときに解決される)
@@ -837,15 +909,14 @@ class Core {
     static evaluateIf(fragment) {
         const promises = [];
         const condition = fragment.getAttribute(`${Env.prefix}if`);
-        if (condition === false ||
-            condition === undefined ||
-            condition === null ||
-            Number.isNaN(condition)) {
+        if (Core.isHiddenIfCondition(condition)) {
             promises.push(fragment.hide().then(() => {
                 HaoriEvent.hide(fragment.getTarget());
             }));
         }
         else {
+            // 非表示→表示への遷移を検出するため、show() 前の表示状態を退避する。
+            const wasVisible = fragment.isVisible();
             const childPromises = [];
             fragment.getChildren().forEach(child => {
                 if (child instanceof ElementFragment) {
@@ -860,21 +931,118 @@ class Core {
             });
             promises.push(fragment.show().then(() => {
                 HaoriEvent.show(fragment.getTarget());
+                // 非表示→表示へ遷移したときだけ data-load-* を発火する。
+                // ボタンや div などネイティブの load イベントが発生しない要素でも、
+                // data-if による表示（haori:show）を契機に data-load-* を実行できるようにする。
+                // 毎回の再評価で発火させると無限ループや過剰実行を招くため、遷移時に限定する。
+                if (!wasVisible) {
+                    Core.triggerLoadOnShow(fragment);
+                }
             }));
             promises.push(Promise.all(childPromises).then(() => undefined));
         }
         return Promise.all(promises).then(() => undefined);
     }
+    /**
+     * data-if 表示時に data-load-* 手続きを発火します。
+     *
+     * 対象要素が data-load-* 属性を持つ場合のみ、load 種別の Procedure を1回実行します。
+     * 結果は待機せず（fire-and-forget）、表示処理の完了をブロックしません。
+     *
+     * @param fragment 対象フラグメント
+     * @return 戻り値はありません。
+     */
+    static triggerLoadOnShow(fragment) {
+        const loadPrefix = `${Env.prefix}load-`;
+        const hasLoadAttribute = fragment
+            .getTarget()
+            .getAttributeNames()
+            .some(name => name.startsWith(loadPrefix));
+        if (!hasLoadAttribute) {
+            return;
+        }
+        void new Procedure(fragment, 'load').run().catch(error => {
+            Log.error('[Haori]', 'data-load procedure error (on show):', error);
+        });
+    }
+    /**
+     * data-each フラグメントの差分更新の再入制御状態を取得します。
+     *
+     * @param fragment 対象フラグメント
+     * @return 再入制御状態
+     */
+    static getEachUpdateState(fragment) {
+        let state = Core.EACH_UPDATE_STATES.get(fragment);
+        if (!state) {
+            state = { running: false, rerunRequested: false, settled: null };
+            Core.EACH_UPDATE_STATES.set(fragment, state);
+        }
+        return state;
+    }
     /**
      * each要素を評価します。
      * 非表示または未マウントの場合は処理をスキップします。
      *
+     * 同一フラグメントに対する差分更新が並行・再入しないように直列化します。
+     * 実行中に再度呼び出された場合は再評価要求を記録し、現在進行中の更新の完了
+     * Promise（後続の再実行も含む）を返します。これにより、bind 直後のリアクティブ
+     * 再評価が重なっても data-each の描画が破壊されず、かつ呼び出し元（`evaluateAll`→
+     * `setBindingData`→`haori:bindcomplete`）が**最終的な DOM 反映まで確実に待機**できます。
+     *
      * @param fragment 対象フラグメント
+     * @return 差分更新（再実行を含む）の完了 Promise
      */
     static evaluateEach(fragment) {
         if (!fragment.isVisible() || !fragment.isMounted()) {
             return Promise.resolve();
         }
+        const state = Core.getEachUpdateState(fragment);
+        if (state.running) {
+            // 実行中は再評価要求を記録し、進行中の settle Promise を待つ
+            // （最新データの描画完了まで待てるようにする）。
+            state.rerunRequested = true;
+            return state.settled ?? Promise.resolve();
+        }
+        return Core.runEachUpdateLoop(fragment, state);
+    }
+    /**
+     * data-each の差分更新を、再評価要求が無くなるまで直列に繰り返し実行します。
+     * 進行中・後続の再実行を含む完了 Promise を state に保持し、再入した呼び出し元が
+     * 同じ Promise を待てるようにします。
+     *
+     * @param fragment 対象フラグメント
+     * @param state 再入制御状態
+     * @return すべての差分更新が安定するまでの完了 Promise
+     */
+    static runEachUpdateLoop(fragment, state) {
+        state.running = true;
+        // 新しい描画サイクルの開始時に完了マーカーを外す。
+        fragment.getTarget().removeAttribute(`${Env.prefix}each-done`);
+        const settled = (async () => {
+            try {
+                do {
+                    state.rerunRequested = false;
+                    await Core.performEachUpdate(fragment);
+                } while (state.rerunRequested);
+                // 全行の描画が安定して完了したことを示すマーカーを付与する。
+                // 外部テストは `[data-each-done]` を待機して描画完了を検知できる。
+                fragment.getTarget().setAttribute(`${Env.prefix}each-done`, '');
+            }
+            finally {
+                state.running = false;
+                state.settled = null;
+            }
+        })();
+        state.settled = settled;
+        return settled;
+    }
+    /**
+     * data-each の差分更新本体を実行します（再入制御は呼び出し側で行います）。
+     *
+     * @param fragment 対象フラグメント
+     * @return 差分更新完了の Promise
+     */
+    static performEachUpdate(fragment) {
         const data = Core.resolveEachItems(fragment);
         if (data === null) {
             return Promise.reject(new Error('Invalid each attribute.'));
@@ -1331,7 +1499,11 @@ class Core {
         return Promise.all(removalPromises)
             .then(() => chain)
             .then(() => {
-            // eachupdateイベントを発火
+            // eachupdate イベントを発火する。
+            // chain は全新規行の initializeFreshEachRow（= 行内容の描画）完了まで await
+            // しているため、本イベントは「今回の差分で追加・削除・並べ替えされた全行が
+            // DOM に反映され、各行の {{...}} 補間などの内容描画が完了した後」に発火する。
+            // これにより外部から data-each の描画完了を検知できる（仕様上の保証）。
             const validNewKeys = newKeys.filter((key) => key !== null);
             const validSrcKeys = srcKeys.filter((key) => key !== null);
             const validSrcKeySet = new Set(validSrcKeys);
@@ -1560,5 +1732,7 @@ Core.REACTIVE_FETCH_STATES = new WeakMap();
 Core.REACTIVE_IMPORT_STATES = new WeakMap();
 /** data-derive subtree skip の開発用プロファイル */
 Core.DERIVE_SUBTREE_PROFILES = new WeakMap();
+/** data-each の差分更新の再入制御状態 */
+Core.EACH_UPDATE_STATES = new WeakMap();
 export default Core;
 //# sourceMappingURL=core.js.map