haori 0.67.0 → 0.68.0

package/dist/index.d.ts

@@ -189,6 +189,76 @@ export declare class Core {
      * @return 戻り値はありません。
      */
     static clearUserEditMarks(fragment: ElementFragment, upTo?: number): void;
+    /**
+     * 取得の応答で値が決まる入力欄から、ユーザー編集の印を解除します。
+     *
+     * 印が抑止するのは宣言バインド（`value` / `checked` / `selected` と `data-attr-*`）
+     * の再適用だけです。`name` で流し込まれる値は、印ではなく通番で適用の可否が
+     * 決まります（`ElementFragment.canApplyValue()`）。そのため、解除するのは宣言
+     * バインドが応答のキーを参照する欄に限ります。応答と関係のない宣言（定数や、
+     * 別のデータを参照する式）の欄の印まで解除すると、その応答の反映で入力した値が
+     * 既定値へ戻ります（仕様「ユーザー編集と宣言バインドの権威」）。
+     *
+     * @param fragment 応答を反映するフラグメント
+     * @param keys 応答が持つキー
+     * @param upTo この通し番号までの編集を解除対象とする
+     * @return 戻り値はありません。
+     */
+    static clearUserEditMarksSuppliedBy(fragment: ElementFragment, keys: readonly string[], upTo: number): void;
+    /** 宣言バインドで入力欄の値・チェックを決める属性の名前（接頭辞なし） */
+    private static readonly VALUE_BINDING_ATTRIBUTES;
+    /** 宣言バインドで `option` の選択を決める属性の名前（接頭辞なし） */
+    private static readonly OPTION_BINDING_ATTRIBUTES;
+    /**
+     * 指定した名前を参照する宣言バインドを持つ入力欄から、ユーザー編集の印を解除
+     * します。
+     *
+     * `option` の `selected` は所属する `<select>` の印で守られるため、`<select>` の
+     * 印を解除します（`ElementFragment.hasPendingCheckableUserEdit()` と同じ対応）。
+     * `option` の `value` など、選択を決めない宣言では解除しません。選択肢を取り直した
+     * だけで、`<select>` で選んだ値が既定値へ戻らないようにするためです。
+     *
+     * @param fragment 走査中のフラグメント
+     * @param names このフラグメントから見て応答の値に解決される名前
+     * @param upTo この通し番号までの編集を解除対象とする
+     * @return 戻り値はありません。
+     */
+    private static clearUserEditMarksReferencing;
+    /**
+     * 子のフラグメントから見て、応答の値に解決される名前を返します。
+     *
+     * 子が自身のバインドデータで同じ名前を持つと、その名前は子の値に解決されます
+     * （遮蔽）。`data-each` の行は例外で、行の名前（`data-each-arg` など）は要素データ
+     * に解決されるため、`data-each` の式が応答の値を参照していれば応答の値に解決
+     * されるとみなします。
+     *
+     * @param parent 親のフラグメント
+     * @param child 子のフラグメント
+     * @param names 親から見て応答の値に解決される名前
+     * @returns 子から見て応答の値に解決される名前
+     */
+    private static resolveNamesInChild;
+    /**
+     * 指定した属性の宣言バインド（素の属性の式と `data-attr-*`）が、指定した名前を
+     * 参照するかを判定します。
+     *
+     * @param fragment 判定対象のフラグメント
+     * @param attributes 属性の名前（接頭辞なし）
+     * @param names 名前の集合
+     * @returns 参照する場合 true
+     */
+    private static declaresReferencing;
+    /**
+     * 式のいずれかが、指定した名前のいずれかを参照するかを判定します。
+     *
+     * 参照名を取り出せない式（解析できない式や定数）は、どの名前も参照しないものと
+     * して扱います。
+     *
+     * @param expressions 式の一覧
+     * @param names 名前の集合
+     * @returns 参照する場合 true
+     */
+    private static referencesAny;
     /**
      * data-fetch の再評価状態を取得します。
      *
@@ -2115,6 +2185,21 @@ declare class ElementFragment extends Fragment {
      * @returns この編集の通番
      */
     markUserEditOnChange(): number;
+    /**
+     * 初期化中に受けた `change` によるユーザー編集を、受けた時点で記録します。
+     *
+     * 初期化中は `change` の手続きを `release()` まで保留しますが、編集の印まで保留
+     * すると、初回の取得の応答を反映する再評価が宣言バインドの評価結果で入力した値を
+     * 上書きします。そこで印だけを先に付けます。
+     *
+     * 時点の決め方は `markUserEditOnChange()` と同じで、直前の `change` より後に打鍵が
+     * あれば何もしません（打鍵の時点が記録済み）。**直前の `change` の記録は進めません。**
+     * 再生した手続きの `markUserEditOnChange()` がここで付けた印を「直前の `change` より
+     * 後の編集」として引き継ぎ、時点を再生の時点へ打ち直さないようにするためです。
+     *
+     * @returns 戻り値はありません。
+     */
+    markUserEditOnDeferredChange(): void;
     /**
      * この入力欄を最後にユーザーが編集したときの通し番号を返します。
      *
@@ -2203,6 +2288,18 @@ declare class ElementFragment extends Fragment {
      * @returns 控えた選択へ戻す関数
      */
     private static captureSelection;
+    /**
+     * ラジオボタンの群の今の選択を控え、その状態へ戻す関数を返します。
+     *
+     * 控えるのは同名のラジオボタンです。フォームでは絞りません。`checked` 属性の
+     * 書き込みで選択が変わるのは同じ群（同じフォームの同名の欄）だけで、ほかの欄は
+     * 控えた状態のまま戻すことになり、結果が変わらないためです。名前で絞るのは
+     * 走査する欄を減らすためです。
+     *
+     * @param radio 群に属するラジオボタン
+     * @returns 控えた選択へ戻す関数
+     */
+    private static captureRadioGroup;
     /**
      * チェック状態の宣言バインドについて、利用者の操作を記録する入力欄の編集の
      * 通し番号を返します。
@@ -5090,7 +5187,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.67.0";
+export declare const version = "0.68.0";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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