haori 0.47.0 → 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 状態だけを落とします。
      */
@@ -4308,7 +4364,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.47.0";
+export declare const version = "0.47.2";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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