haori 0.47.0 → 0.47.3

package/dist/index.d.ts

@@ -315,6 +315,19 @@ export declare class Core {
      * 経路が存在しないことを表す番兵。`undefined` を値として持つ経路と区別します。
      */
     private static readonly ABSENT_PATH;
+    /**
+     * 宣言データとして外へ出すデータから予約キーを取り除きます。
+     *
+     * `_fetch` / `_poll` は内部バインディングデータにのみ持つ実行時の値で、宣言
+     * データとしては外へ出しません（仕様「`data-bind`」）。内部データ側は予約キーを
+     * 引き継ぐため（`ElementFragment.setBindingData()`）、出口の側で取り除かないと、
+     * `data-bind` 属性が数秒ごとの状態遷移で書き換わり続け、`data-{event}-copy` は
+     * 別の要素のフェッチ状態をコピー先へ運びます。
+     *
+     * @param data 外へ出すバインドデータ
+     * @returns 予約キーを除いたデータ
+     */
+    static withoutReservedBindingKeys(data: Record<string, unknown>): Record<string, unknown>;
     /**
      * 変化した経路ごとに適用可否を判定し、棄却した経路を前の値のまま残したデータを
      * 返します。
@@ -550,6 +563,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 +1250,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 状態だけを落とします。
      */
@@ -1259,9 +1328,35 @@ declare class ElementFragment extends Fragment {
     /**
      * バインドデータを設定します。
      *
+     * 予約キー（`_` 始まりのエンジン管理変数）は、新しいデータが同じキーを持たない
+     * 限り引き継ぎます（仕様「`data-bind`」）。予約キーは `data-bind` 属性へ書き出さ
+     * ないため、宣言を取り込む側も外部から属性を書き換える側もこの値を運べません。
+     * 引き継がないと、`data-if` が真になったときの子の初期化や外部からの書き換えの
+     * たびに `_fetch` / `_poll` が消え、注入した状態が「まだ何も起きていない」状態と
+     * 区別できなくなります。明示的に落とす場合はキー自体を持たせてください
+     * （`{_fetch: undefined}`）。
+     *
      * @param data バインドデータ
      */
     setBindingData(data: Record<string, unknown>): void;
+    /**
+     * 新しいバインドデータへ、現在の予約キーのうち引き継ぐものを足します。
+     *
+     * @param data 新しいバインドデータ
+     * @returns 予約キーを引き継いだバインドデータ
+     */
+    private withRetainedReservedKeys;
+    /**
+     * 予約キー（エンジン管理変数）かどうかを判定します。
+     *
+     * `_fetch` / `_poll` など、Haori が実行時に注入し、`data-bind` 属性へ書き出さない
+     * 値が対象です（仕様「`data-bind`」）。`data-bind` 属性へのミラー
+     * （`Core.setBindingData()`）も同じ判定で対象から外します。
+     *
+     * @param key 判定対象のキー
+     * @returns 予約キーなら true
+     */
+    static isReservedBindingKey(key: string): boolean;
     /**
      * バインドデータ更新に伴う DOM 反映・再評価を、同一フラグメントでは呼出順
      * （FIFO）で直列実行します。並行呼出による適用順の逆転（古いデータが後から
@@ -4308,7 +4403,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.47.0";
+export declare const version = "0.47.3";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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