haori 0.44.0 → 0.45.1

package/dist/index.d.ts

@@ -1753,6 +1753,27 @@ declare class ElementFragment extends Fragment {
      * @return 戻り値はありません。
      */
     private static warnUnresolvedAttribute;
+    /**
+     * 型の食い違う厳密比較を報告済みの宣言。
+     * 再評価ごとに警告すると開発コンソールが埋まるため、同じ宣言は一度だけ報告する。
+     */
+    private static readonly loggedTypeMismatchedComparisons;
+    /**
+     * 開発モードで、型の食い違う厳密比較を警告します。
+     *
+     * `===` / `!==` の両辺の型が違うと、値が同じでも比較は必ず偽になります。API 由来
+     * の数値の `id` と、フォームの収集値（文字列）を比べる宣言で起きやすく、
+     * `data-attr-selected` / `data-attr-checked` では「選択やチェックが付かない」、
+     * その他の `data-attr-*` では「属性が消える」という形でしか現れません。原因の
+     * 属性とテンプレート、両辺の型を名指しで報告します。
+     *
+     * @param rawName 生の属性名
+     * @param template 宣言されたテンプレート
+     * @param types 両辺の型
+     * @param element 対象エレメント
+     * @return 戻り値はありません。
+     */
+    private static warnTypeMismatchedComparison;
     /**
      * チェック状態の宣言バインドについて、再適用を抑止すべきかを判定します。
      *
@@ -1862,6 +1883,24 @@ declare class ElementFragment extends Fragment {
      * @returns 同期対象の場合true
      */
     static isValuePropertyTarget(element: Element): element is HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+    /**
+     * 利用者が打鍵で値を変えられる入力欄かどうかを判定します。
+     *
+     * `readonly` の欄は打鍵で値が変わらないため、宣言バインドの再適用から守るべき
+     * 未コミットの入力を持ちません。それでいて `disabled` と違いタブ移動の対象には
+     * なるため、フォーカスを保護の条件にすると「算出値を入れた欄がタブ移動の行き先に
+     * なっただけで評価結果に追従しなくなる」ことになります。そこで `readonly` の欄は
+     * 保護の対象外とします（仕様「`data-attr-*`」）。
+     *
+     * `<select>` に `readonly` はないため常に編集できる扱いです。`disabled` も対象に
+     * しません。`disabled` の要素はフォーカスされないため保護に掛かる経路が無く、
+     * 「編集した欄を送信中だけ `disabled` にする」使い方で入力を評価結果へ巻き戻して
+     * しまう恐れがあるためです。
+     *
+     * @param element 判定対象のエレメント
+     * @returns 利用者が打鍵で値を変えられる場合 true
+     */
+    private static isUserEditableValue;
     /**
      * 内部の値をDOMの値と同期します。
      * changeイベント時など、DOM値が変更された後に呼び出されます。
@@ -2447,6 +2486,56 @@ export declare class Form {
      * @returns 収集キー。どちらも無い場合は null
      */
     static resolveFieldName(fragment: ElementFragment): unknown;
+    /**
+     * 行の入力欄のうち、新しい要素データと値が食い違う収集キーに属するものだけ、
+     * ユーザー編集の印を解除します。
+     *
+     * 行への `data-{event}-copy` で使います。コピーが優先するのは**コピーしたキー**
+     * なので（仕様「編集可能な行への書き込み」）、行の印を丸ごと解除すると、コピー
+     * していないキーの編集まで宣言バインドの評価結果へ明け渡してしまいます。評価が
+     * 要素データと食い違う構成（数値の `id` と文字列の収集値を厳密比較する
+     * `data-attr-selected` など）では、その欄の確定した編集が静かに消えます。
+     *
+     * 判定は**行の収集値と新しい要素データの突き合わせ**で行います。コピーしたキーは
+     * 値が変わるため食い違い、コピーしていないキーは編集がすでに要素データへ確定して
+     * いるため一致します。要素データが変わらない書き戻し（入力欄の状態が要素データへ
+     * 確定していない構成）でも、画面と食い違うキーだけが対象になります。
+     *
+     * @param row 行のフラグメント
+     * @param item 新しい要素データ
+     * @returns 戻り値はありません。
+     */
+    static clearRowUserEditMarksForChangedKeys(row: ElementFragment, item: Record<string, unknown>): void;
+    /**
+     * 収集値と要素データの値が同じ内容かどうかを判定します。
+     *
+     * 直列化できない値（循環参照など）は「違う」と扱います。
+     *
+     * @param left 比較元の値
+     * @param right 比較先の値
+     * @returns 同じ内容なら true
+     */
+    private static isSameCollectedValue;
+    /**
+     * 指定した収集キーに属する部分木のユーザー編集の印を解除します。
+     *
+     * @param fragment 走査中のフラグメント
+     * @param row 行のフラグメント（収集キーの起点）
+     * @param keys 対象の収集キー
+     * @returns 戻り値はありません。
+     */
+    private static clearUserEditMarksForKeys;
+    /**
+     * 行の中の要素が属する、収集値の**最上位**キーを返します。
+     *
+     * 行から要素までの間にある `data-form-object` / `data-form-list` と `name`
+     * （`data-form-name`）のうち、行に最も近いものが最上位キーです。
+     *
+     * @param fragment 対象フラグメント
+     * @param row 行のフラグメント
+     * @returns 最上位の収集キー。無い場合は null
+     */
+    private static resolveRowTopLevelKey;
     /**
      * `data-form-name` の初期化を行います。
      *
@@ -4143,7 +4232,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.44.0";
+export declare const version = "0.45.1";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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