haori 0.46.2 → 0.47.2

package/dist/index.d.ts

@@ -550,6 +550,49 @@ export declare class Core {
      * @return 戻り値はありません。
      */
     private static logFalsyIfDiagnostics;
+    /**
+     * `data-each` コンテナの子のうち、行にならない固定要素かどうかを返します。
+     *
+     * 仕様「`data-each`」の `data-each-before` / `data-each-after`（「ループ前に表示
+     * する要素をマーク」「ループ後に表示する要素をマーク」）です。テンプレートの選定
+     * （`performEachUpdate`）でも同じ属性で除いています。
+     *
+     * @param fragment 判定する子フラグメント
+     * @returns 行にならない固定要素なら true
+     */
+    private static isEachFixedChild;
+    /**
+     * `data-each` コンテナが固定要素を持つかどうかを返します。
+     *
+     * 固定要素（`data-each-before` / `data-each-after`）はコンテナのスコープで評価する
+     * ため、配列が同値でも一覧の外のデータの更新で描画が変わります。行と行テンプレートは
+     * 行スコープで評価するため数えません。
+     *
+     * コンテナ直下のテキストノードは数えません。式を含むテキストは
+     * `hasNonEachDynamicElementState()` がすでに拾っており、ここで重ねても落ちるテストが
+     * 無いためです（`docs/ja/testing.md` の規則 3）。
+     *
+     * @param fragment `data-each` コンテナのフラグメント
+     * @returns 固定要素があれば true
+     */
+    private static hasEachFixedChildren;
+    /**
+     * `data-each` コンテナの固定要素とテキストノードを再評価します。
+     *
+     * 行と行テンプレートは `data-each` が管理するため `evaluateAll` は each コンテナの
+     * 子へ降りません。しかし固定要素（`data-each-before` / `data-each-after`）と
+     * コンテナ直下のテキストノードは行ではなく、仕様「`data-each`」の「固定要素と
+     * コンテナ直下のテキストノードは、行と違いコンテナのスコープで、バインドデータの
+     * 更新のたびに再評価します」に従ってコンテナのスコープで再評価します。
+     *
+     * これが無いと、ガイドが案内している「空のリストの場合のメッセージ」
+     * （`data-each-after` に `data-if="items.length === 0"` を書く形）が、配列が
+     * 変わっても初期の判定のまま固定されます。
+     *
+     * @param fragment `data-each` コンテナのフラグメント
+     * @returns 再評価完了の Promise
+     */
+    private static evaluateEachFixedChildren;
     /**
      * if要素を評価します。
      * 値が falsy（false・null・undefined・NaN・0・空文字列）の場合は非表示にし、
@@ -1194,6 +1237,19 @@ declare class ElementFragment extends Fragment {
      * @returns クローンされたフラグメント
      */
     clone(): ElementFragment;
+    /**
+     * `data-if` の非表示化が DOM へ書いた追随結果を落とします。
+     *
+     * 仕様「data-if の動作」の「判定の基準は内部状態であり、`style.display` や
+     * `data-if-false` は追随結果として扱う」に従います。内部状態を持たない要素
+     * （フラグメントを作る時点の要素、複製した要素）に追随結果が残っていると、
+     * 内部状態は「表示」なのに DOM は非表示という食い違いになり、`show()` は内部状態を
+     * 基準に何もしないため**表示に戻れません**。
+     *
+     * @param target 対象エレメント
+     * @returns 戻り値はありません。
+     */
+    private static dropIfVisibilityArtifacts;
     /**
      * clone 時に runtime の hidden 状態だけを落とします。
      */
@@ -3052,6 +3108,12 @@ export declare class Form {
     private static readonly COLLECTED_EXCLUDED_KEYS;
     /** 出現順への退避を知らせた理由（同じ理由を繰り返さないため） */
     private static readonly warnedPositionalRowFallbacks;
+    /**
+     * キーの無い派生一覧の収集を知らせた `data-each` の式。
+     *
+     * 収集は入力のたびに走るため、同じ宣言を繰り返し報告しないようにします。
+     */
+    private static readonly warnedDerivedRowsWithoutKey;
     /**
      * 収集した行配列に、行の識別情報を結び付けます。
      *
@@ -3089,6 +3151,21 @@ export declare class Form {
      * @param reason 退いた理由
      */
     private static warnPositionalRowFallback;
+    /**
+     * 派生一覧を `data-each-key` なしで収集する宣言を、開発モードで知らせます。
+     *
+     * `data-each-key` が無いとリストキーはインデックス由来（`__index_N`）になるため、
+     * 行と配列要素の対応は出現順と同じになります。絞り込んだ一覧
+     * （`data-each="rules.filter(...)"`）を `data-form-list="rules"` で収集する構成では
+     * 画面の並びが配列の並びと一致しないため、画面の 2 行目の値が配列の 2 番目の要素
+     * （絞り込みで除かれた要素）へ書き込まれます。収集値は画面のとおりに見えるので
+     * 気づけません（仕様「行の対応付けと `data-each-key`」の「`data-each-key` なし」）。
+     *
+     * 素の経路（`rules` / `dialog.rules`）は配列そのものを描くため対象外です。
+     *
+     * @param container `data-form-list` を持つコンテナのフラグメント
+     */
+    private static warnDerivedRowsWithoutKey;
     /**
      * 収集値を、直前のバインドデータへ重ねます。
      *
@@ -3223,6 +3300,14 @@ export declare class Form {
      * 配列に無いリストキーの行は、配列から消えた行が画面に残っているものとして落とし
      * ます。行の増減は配列を先に更新するため、配列に無い行は常に古い画面です。
      *
+     * 逆に、**収集した行に対応しない配列要素は元の位置に元の値のまま残します**（仕様
+     * 「行の対応付けと `data-each-key`」の「収集した行に対応しない配列要素」）。収集は
+     * 集められた行だけを集めるため、収集した行だけで組み立て直すと、絞り込んだ一覧
+     * （`data-each="rules.filter(...)"`）を `data-form-list="rules"` で収集する構成で、
+     * 絞り込みで除かれた要素が丸ごと失われます（行そのものを `data-if` で隠した場合も
+     * 同様です）。並びも土台の配列に従うため、配列を先に入れ替えて画面を描き直す前に
+     * 収集が走っても（`row-prev` の直後など）並びが巻き戻りません。
+     *
      * @param previous 直前の配列（配列要素が権威）
      * @param collected 収集した行配列
      * @returns 重ね合わせた配列。対応付けができない場合は null（出現順へ退く）
@@ -4279,7 +4364,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.46.2";
+export declare const version = "0.47.2";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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