haori 0.59.3 → 0.59.5

package/dist/index.d.ts

@@ -1402,6 +1402,22 @@ declare class ElementFragment extends Fragment {
      * @return 除去のPromise
      */
     remove(unmount?: boolean): Promise<void>;
+    /**
+     * 監視が観測した取り外しを、内部の木を保ったまま反映します。
+     *
+     * 外部のスクリプトによる移動は「取り外し → 追加」として観測されます。木を捨てると、
+     * 付け直しで描画済みの DOM から作り直すことになり、描いた結果を宣言として読み込み
+     * ます（仕様「監視対象」の「走査した要素を外部のスクリプトが DOM の中で移したり、
+     * 外して後で戻したりしても、宣言は保ちます」）。付け直しでは `Core.addNode()` が
+     * この断片をそのまま木へつなぎ直して走査します。
+     *
+     * DOM は既に動いているため、DOM からの除去は行いません（同じ親の中で順を変えた
+     * 場合、ノードはまだ親の下にあります）。外部ライブラリ連携は、DOM から外れる要素と
+     * 同じく破棄します。
+     *
+     * @returns 戻り値はありません。
+     */
+    detachObserved(): void;
     /**
      * `data-external` の要素を、内部のフラグメント木を保ったまま親から外します。
      *
@@ -1409,7 +1425,7 @@ declare class ElementFragment extends Fragment {
      * 外部ライブラリが配下に生成した DOM ごと取り込んでフォーム値の収集に載せます
      * （仕様「`data-external`」の「付け直した場合も、配下は走査した時点の構成のまま
      * 扱う」、課題 #42）。子の断片・属性・キャッシュ登録は保ち、付け直しでは
-     * `Core.addNode()` がこの断片をそのまま挿入して走査します。バインドデータの
+     * `Core.addNode()` がこの断片をそのまま木へつなぎ直して走査します。バインドデータの
      * キャッシュは、付け直しで親を設定するとき（`setParent()`）に部分木ごと捨てられる
      * ため、ここでは捨てません（捨てる行を外しても結果が変わらないことを確認済み）。
      *
@@ -2405,6 +2421,22 @@ declare class ElementFragment extends Fragment {
      * @returns 挿入位置。解決できない場合はnull
      */
     private resolveInsertionPointFromDom;
+    /**
+     * 子ノードを HTML で置き換えます（`{{{ }}}` の描画）。
+     *
+     * 外す子ノードと挿入した子ノードは、監視の取り込みの対象外へ登録します。取り込むと、
+     * 式を持つテキストの断片が取り外しとして木から外れ、挿入した HTML が新しい子として
+     * 走査されます。以降のバインドの更新で式が評価されなくなり、挿入した HTML の中まで
+     * 評価されます（仕様「`{{{ expression }}}`」の「バインドの更新のたびに評価し直し」と
+     * 「挿入した HTML は走査の対象外です」）。
+     *
+     * 描画キューの中から呼びます。登録は、監視が書き込みを処理した後に、戻り値の関数で
+     * 解除します。
+     *
+     * @param html 挿入する HTML
+     * @returns 監視の除外の登録を解除する関数
+     */
+    replaceChildNodesWithHtml(html: string): () => void;
     /**
      * 子ノードを参照ノードの前に挿入します。
      * 参照ノードがnullの場合、親の最後に追加されます。
@@ -2414,6 +2446,28 @@ declare class ElementFragment extends Fragment {
      * @return 挿入のPromise
      */
     insertBefore(newChild: Fragment, referenceChild: Fragment | null, referenceNodeOverride?: Node | null): Promise<void>;
+    /**
+     * 監視が観測した追加を、DOM を動かさずに内部の木へ反映します。
+     *
+     * ノードは既に DOM 上の追加された位置にあります。DOM から外して付け直すと、開いた
+     * popover・`showModal()` で開いた `<dialog>` のモーダル状態・フォーカスが失われます
+     * （仕様「監視対象」の「外部のスクリプトが DOM に追加したノードは、追加された位置の
+     * まま取り込み、DOM から外して付け直すことはしません」）。
+     *
+     * @param newChild 追加された子ノード
+     * @param referenceChild 追加された位置の次の子ノード（末尾の場合は null）
+     * @returns 戻り値はありません。
+     */
+    attachObserved(newChild: Fragment, referenceChild: Fragment | null): void;
+    /**
+     * 子ノードを内部の木の参照ノードの前へつなぎます。DOM は操作しません。
+     *
+     * @param newChild 新しい子ノード
+     * @param referenceChild 参照ノード（末尾の場合は null）
+     * @param referenceNodeOverride DOM で挿入する位置の次のノード（省略時は参照ノード）
+     * @returns DOM で挿入する位置の次のノード
+     */
+    private linkChild;
     /**
      * 指定した参照ノードの後に子ノードを挿入します。
      *
@@ -4826,7 +4880,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.59.3";
+export declare const version = "0.59.5";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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