haori 0.46.2 → 0.47.0

package/dist/index.d.ts

@@ -3052,6 +3052,12 @@ export declare class Form {
     private static readonly COLLECTED_EXCLUDED_KEYS;
     /** 出現順への退避を知らせた理由（同じ理由を繰り返さないため） */
     private static readonly warnedPositionalRowFallbacks;
+    /**
+     * キーの無い派生一覧の収集を知らせた `data-each` の式。
+     *
+     * 収集は入力のたびに走るため、同じ宣言を繰り返し報告しないようにします。
+     */
+    private static readonly warnedDerivedRowsWithoutKey;
     /**
      * 収集した行配列に、行の識別情報を結び付けます。
      *
@@ -3089,6 +3095,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 +3244,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 +4308,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.46.2";
+export declare const version = "0.47.0";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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