haori 0.60.0 → 0.61.0

package/dist/index.d.ts

@@ -394,6 +394,8 @@ export declare class Core {
      * @param next その経路の更新後の値（存在しない場合は `ABSENT_PATH`）
      * @param origin この更新の由来
      * @param path その経路（ルートは空文字）
+     * @param keyArgs 経路の形ごとの `data-each-key` の照合結果（この更新の中で共有する。
+     *   `Core.resolveEachKeyArg()`）
      * @returns 採用した値。その経路を持たせない場合は `ABSENT_PATH`
      */
     private static mergePathAuthority;
@@ -410,6 +412,7 @@ export declare class Core {
      * @param previous 更新前の値
      * @param next 更新後の値
      * @param path その経路
+     * @param keyArgs 経路の形ごとの `data-each-key` の照合結果（`Core.resolveEachKeyArg()`）
      * @returns 要素ごとのリストキー。要素へ降りない場合は null
      */
     private static resolveArrayPairing;
@@ -422,11 +425,26 @@ export declare class Core {
      * （`Core.resolveEachDeclarationPath()`）。経路の側は配列要素の区間（`[キー]`）を
      * 取り除いた形にします。宣言は「どの階層の配列か」しか表さないためです。
      *
+     * 照合の結果は、1 回の更新の中で経路の形ごとに使い回します（仕様
+     * 「`Core.setBindingData(element, data, options?)`」）。行ごとの入れ子の配列
+     * （`rows[7].items`）は形が同じなので、行の数だけ照合し直すと、時間が行数の
+     * 2 乗で増えます。照合は同期的に終わるため、更新の途中で宣言が変わることは
+     * ありません。
+     *
      * @param fragment 対象のフラグメント
      * @param path 配列の経路（`rows[7].items` のような形）
+     * @param keyArgs 経路の形ごとの照合結果。この更新の中で共有する
      * @returns リストキーに使うプロパティ名。宣言が無ければ null
      */
     private static resolveEachKeyArg;
+    /**
+     * 経路の形に対応する `data-each` の宣言を探し、その `data-each-key` を返します。
+     *
+     * @param root 起点の要素（経路の基準）
+     * @param shapePath 要素の区間を落とした配列の経路（`rows.items` のような形）
+     * @returns リストキーに使うプロパティ名。宣言が無ければ null
+     */
+    private static findEachKeyArg;
     /**
      * `data-each` の宣言を、起点の要素から見た絶対経路へ直します。
      *
@@ -565,9 +583,10 @@ export declare class Core {
      * フラグメントとその子要素を評価します。
      *
      * @param fragment 対象フラグメント
+     * @param skipFragments 評価しない子孫（要素は配下ごと、テキストはそのものを省く）
      * @return Promise (DOM操作が完了したときに解決される)
      */
-    static evaluateAll(fragment: ElementFragment, skipFragments?: ReadonlySet<ElementFragment>): Promise<void>;
+    static evaluateAll(fragment: ElementFragment, skipFragments?: ReadonlySet<Fragment>): Promise<void>;
     /**
      * data-derive / data-derive-name を評価し、子孫要素向けの派生値を更新します。
      *
@@ -668,9 +687,11 @@ export declare class Core {
      * それ以外の場合は表示します。
      *
      * @param fragment 対象フラグメント
+     * @param skipFragments 表示のままの分岐で評価しない子孫（`evaluateAll()` と同じ）。
+     *   表示へ切り替わった分岐では使わない（非表示のあいだ評価していないため）
      * @return Promise (DOM操作が完了したときに解決される)
      */
-    static evaluateIf(fragment: ElementFragment): Promise<void>;
+    static evaluateIf(fragment: ElementFragment, skipFragments?: ReadonlySet<Fragment>): Promise<void>;
     /**
      * data-if 表示時に data-load-* 手続きを発火します。
      *
@@ -788,12 +809,48 @@ export declare class Core {
      * 差分更新が不要な `data-each` の既存行について、子孫の再評価だけを行います。
      *
      * 行スコープの値だけで描画が決まるテンプレートでは、行の要素データが同値である
-     * 限り描画結果も変わらないため何もしません。
+     * 限り描画結果も変わらないため何もしません。行の外を参照するテンプレートでも、
+     * 行スコープの名前だけを参照する部分は評価しません（`collectRowLocalFragments()`）。
      *
      * @param fragment `data-each` コンテナのフラグメント
      * @returns 再評価完了の Promise
      */
     private static reevaluateEachRows;
+    /**
+     * 行の要素データが同値のときに評価を省ける、行の中の部分を集めます。
+     *
+     * 行スコープの名前（`data-each-arg` と `data-each-index`）だけを参照する要素
+     * （配下を含む）とテキストは、要素データが同値なら評価しても結果が変わりません。
+     * テンプレート全体が行スコープだけで描画できる場合（`isRowLocalEachTemplate()`）
+     * の判定を、要素とテキストの単位へ細かくしたものです。
+     *
+     * 降りるのは、名前を差し替えない要素（`keepsRowScopeNames()`）の配下だけです。
+     * それ以外の `data-*` を持つ要素（`data-bind`・`data-derive`・`data-each`・
+     * 手続きなど）は、配下へ公開する名前を変え得るため、その配下は省きません。
+     *
+     * @param container `data-each` コンテナのフラグメント
+     * @param row 行のフラグメント
+     * @returns 評価を省ける要素とテキストの集合
+     */
+    private static collectRowLocalFragments;
+    /**
+     * 要素が、配下へ公開する名前を差し替えないかどうかを返します。
+     *
+     * `data-*` として `data-if` と `data-row`（差分更新が行の根へ付けるリストキー）
+     * だけを持つ要素が該当します。
+     *
+     * @param fragment 判定対象フラグメント
+     * @returns 名前を差し替えないなら true
+     */
+    private static keepsRowScopeNames;
+    /**
+     * `data-each` が行スコープへ公開する名前を返します。
+     *
+     * @param fragment `data-each` コンテナのフラグメント
+     * @returns 名前の集合。`data-each-arg` が無い（要素データのキーが行スコープへ
+     *   直接展開され、名前を静的に決められない）場合は null
+     */
+    private static getEachScopeNames;
     /**
      * data-each 属性値を仕様に従って配列へ正規化します。
      *
@@ -4923,7 +4980,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.60.0";
+export declare const version = "0.61.0";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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