haori 0.47.2 → 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>;
     /**
      * 変化した経路ごとに適用可否を判定し、棄却した経路を前の値のまま残したデータを
      * 返します。
@@ -1315,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）で直列実行します。並行呼出による適用順の逆転（古いデータが後から
@@ -4364,7 +4403,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.47.2";
+export declare const version = "0.47.3";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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