haori 0.24.0 → 0.26.0

package/dist/index.d.ts

@@ -68,6 +68,16 @@ export declare class Core {
     private static readonly DERIVE_SUBTREE_PROFILES;
     /** data-each の差分更新の再入制御状態 */
     private static readonly EACH_UPDATE_STATES;
+    /**
+     * data-each-rendered-change（既定の `once` モード）で change を発火済みの要素。
+     * 再帰的な発火ループを避けるため、要素ごとに一度だけ発火させるために使用します。
+     */
+    private static readonly EACH_RENDERED_CHANGE_FIRED;
+    /**
+     * data-each-rendered-change の不正な属性値を警告済みの要素。
+     * 描画確定ごとに同じ警告を出し続けないために使用します。
+     */
+    private static readonly EACH_RENDERED_CHANGE_WARNED;
     /**
      * 遅延属性かどうか（完全名で判定）を判定します。
      *
@@ -422,6 +432,40 @@ export declare class Core {
      * @param target data-each コンテナ要素
      */
     private static runEachRenderedScript;
+    /**
+     * data-each-rendered-change 属性に従い、描画確定後に対象要素へ `change`
+     * イベント（バブリングあり）を発火します。
+     *
+     * API から取得した候補を `data-each` で流し込んだ `<select>` について、
+     * 「既定選択を確定して初期データを取得する」パターンをインライン JS なしで
+     * 宣言できるようにするための属性です。`<select>` はブラウザが先頭 option を
+     * 自動選択するため、描画確定後の `change` がそのまま既定選択の確定になります。
+     *
+     * 描画行が 0 件のときは発火しません（確定すべき既定値が存在しないため）。
+     * この場合は初回発火の判定も消費しないため、行が入った最初の描画で発火します。
+     *
+     * 属性値による動作の違い:
+     * - 省略または `once`: 行が 1 件以上ある最初の描画確定時のみ発火する（既定）。
+     * - `always`: 描画確定ごとに毎回発火する。
+     *
+     * 既定を `once` にしているのは、`change` の手続きが `data-each` の取得元を
+     * 再バインドする構成（候補取得 → 選択確定 → 明細取得 → 再描画）で、毎回発火
+     * させると再帰的な発火ループになり得るためです。
+     *
+     * @param fragment data-each コンテナのフラグメント
+     */
+    private static runEachRenderedChange;
+    /**
+     * data-each コンテナに描画されている行数を返します。
+     *
+     * 行は差分更新で `data-row` 属性が付与されるため、それを数えます。
+     * `data-each-before` / `data-each-after` の固定要素や、テンプレート以外の
+     * 静的な子要素（`data-each-before` の付け忘れを含む）は行数に含めません。
+     *
+     * @param fragment data-each コンテナのフラグメント
+     * @returns 描画済みの行数
+     */
+    private static countEachRenderedRows;
     /**
      * data-each の差分更新本体を実行します（再入制御は呼び出し側で行います）。
      *
@@ -1150,6 +1194,25 @@ export declare class Form {
      * @param form フォームのElementFragment
      */
     static getValues(form: ElementFragment): Record<string, unknown>;
+    /**
+     * 入力エレメントから収集する値を解決します。
+     *
+     * `input[type=file]` は選択されたファイルを File オブジェクトとして返します
+     * （内部値は `C:\fakepath\...` の擬似パス文字列にしかならず送信に使えないため、
+     * DOM の `files` から直接取得する）。`multiple` 指定時は File の配列、単一選択時は
+     * File または未選択を表す null を返します。それ以外の要素は内部値を返します。
+     *
+     * @param fragment 対象のElementFragment
+     * @returns 収集する値
+     */
+    private static resolveCollectedValue;
+    /**
+     * `input[type=file]` かどうかを判定します。
+     *
+     * @param fragment 対象フラグメント
+     * @returns `input[type=file]` の場合 true
+     */
+    private static isFileInput;
     /**
      * フォーム内の各入力エレメントから値を取得し、オブジェクトとして返します。
      * 入力エレメントのname属性、data-form-object属性、data-form-list属性に基づいて値を整理します。
@@ -1524,6 +1587,29 @@ declare class Haori {
      * @returns 整形済み文字列。整形できない場合は空文字
      */
     static date(value: string | number | Date | null | undefined, format?: string, timeZone?: string): string;
+    /**
+     * 現在日時を指定フォーマットの文字列へ整形します。
+     *
+     * テンプレート式中の `haori.now(...)` と同じ実装です。戻り値は呼び出し時刻に
+     * 依存するため冪等ではありません。
+     *
+     * @param format フォーマット文字列（省略時は `yyyy/MM/dd HH:mm`）
+     * @param timeZone IANA タイムゾーン名（例 `Asia/Tokyo`）。省略時はローカルタイムゾーン
+     * @returns 整形済みの現在日時文字列
+     */
+    static now(format?: string, timeZone?: string): string;
+    /**
+     * 現在日付に日数を加減した日付を指定フォーマットの文字列へ整形します。
+     *
+     * テンプレート式中の `haori.today(...)` と同じ実装です。戻り値は呼び出し日に
+     * 依存するため冪等ではありません。
+     *
+     * @param offsetDays 現在日付に加減する日数（負数で過去方向、省略時は 0）
+     * @param format フォーマット文字列（省略時は `yyyy-MM-dd`）
+     * @param timeZone IANA タイムゾーン名（例 `Asia/Tokyo`）。省略時はローカルタイムゾーン
+     * @returns 整形済みの日付文字列。timeZone が不正な場合は空文字
+     */
+    static today(offsetDays?: number, format?: string, timeZone?: string): string;
     /**
      * 数値を桁区切り・小数桁付きの文字列へ整形します。
      *
@@ -1821,7 +1907,7 @@ declare class TextFragment extends Fragment {
     evaluate(): Promise<void>;
 }
 
-export declare const version = "0.24.0";
+export declare const version = "0.26.0";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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