haori 0.44.1 → 0.45.2

package/dist/index.d.ts

@@ -439,6 +439,17 @@ export declare class Core {
             depth: number;
         }>;
     };
+    /**
+     * スコープの解決結果と由来を収集します。
+     *
+     * `dumpScope()` の本体です。こちらは出力しません。診断（`data-if` の falsy 報告）は
+     * 自分で 1 行だけ出すため、ここで出すと同じ内容が二重に出て、再描画のたびに
+     * コンソールへ積み上がります。
+     *
+     * @param element 対象要素
+     * @return 解決済みスコープと各キーの由来情報
+     */
+    private static collectScope;
     /**
      * data-bind 属性の値をパースします。
      *
@@ -1753,6 +1764,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;
     /**
      * チェック状態の宣言バインドについて、再適用を抑止すべきかを判定します。
      *
@@ -2465,6 +2497,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` の初期化を行います。
      *
@@ -4161,7 +4243,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.44.1";
+export declare const version = "0.45.2";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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