haori 0.59.4 → 0.60.0

package/dist/index.d.ts

@@ -1409,7 +1409,7 @@ declare class ElementFragment extends Fragment {
      * 付け直しで描画済みの DOM から作り直すことになり、描いた結果を宣言として読み込み
      * ます（仕様「監視対象」の「走査した要素を外部のスクリプトが DOM の中で移したり、
      * 外して後で戻したりしても、宣言は保ちます」）。付け直しでは `Core.addNode()` が
-     * この断片をそのまま挿入して走査します。
+     * この断片をそのまま木へつなぎ直して走査します。
      *
      * DOM は既に動いているため、DOM からの除去は行いません（同じ親の中で順を変えた
      * 場合、ノードはまだ親の下にあります）。外部ライブラリ連携は、DOM から外れる要素と
@@ -1425,7 +1425,7 @@ declare class ElementFragment extends Fragment {
      * 外部ライブラリが配下に生成した DOM ごと取り込んでフォーム値の収集に載せます
      * （仕様「`data-external`」の「付け直した場合も、配下は走査した時点の構成のまま
      * 扱う」、課題 #42）。子の断片・属性・キャッシュ登録は保ち、付け直しでは
-     * `Core.addNode()` がこの断片をそのまま挿入して走査します。バインドデータの
+     * `Core.addNode()` がこの断片をそのまま木へつなぎ直して走査します。バインドデータの
      * キャッシュは、付け直しで親を設定するとき（`setParent()`）に部分木ごと捨てられる
      * ため、ここでは捨てません（捨てる行を外しても結果が変わらないことを確認済み）。
      *
@@ -1767,6 +1767,26 @@ declare class ElementFragment extends Fragment {
      * @returns エレメントの更新のPromise
      */
     private applyValue;
+    /**
+     * 値を行の配列で収集する入力欄（`data-value-type="lines"` の textarea）かどうかを
+     * 判定します。
+     *
+     * @returns 行の配列で収集する場合 true
+     */
+    collectsLines(): boolean;
+    /**
+     * `data-value-type="lines"` の textarea へ、行の配列を反映します。
+     *
+     * 改行でつないで書きます。DOM の内容が同じ行の配列を表している場合は書き換え
+     * ません。利用者が書いた空の行や前後の空白を、コミットの書き戻しで消さない
+     * ためです（仕様「`data-value-type`」）。
+     *
+     * @param value 反映する値（配列、または改行区切りの文字列）
+     * @param dispatchEvents input/change イベントを発火するかどうか
+     * @param origin 値の由来（通番と種別）
+     * @returns 反映完了の Promise
+     */
+    private writeLinesValue;
     /**
      * 値を持つ入力エレメント（テキスト系 / textarea / 単一選択 select）へ値を反映します。
      *
@@ -2146,14 +2166,26 @@ declare class ElementFragment extends Fragment {
      *
      * `data-value-type` を宣言した入力欄では、宣言した型へ正規化します（仕様
      * 「`data-value-type`」）。宣言は `type` より優先するため、`type="number"` へ
-     * `string` を宣言した場合は文字列になります。それ以外の要素では値をそのまま
-     * 返します。
+     * `string` を宣言した場合は文字列になります。`lines` を宣言した textarea では、
+     * 行の配列になります。それ以外の要素では値をそのまま返します。
      *
      * @param element 対象の入力要素
      * @param value 正規化する値
      * @returns 正規化後の値（宣言または `type="number"` に従う）
      */
     private normalizeValueForElement;
+    /**
+     * 値を行の配列へ正規化します。
+     *
+     * 改行で分け、各行の前後の空白を除き、空の行は捨てます（`\r\n` の `\r` は
+     * 前後の空白として除かれます）。配列が渡された場合は、各要素を行として同じ規則を
+     * 適用します。`null` と、配列の `null` の要素は空として扱います（仕様
+     * 「`data-value-type`」）。
+     *
+     * @param value 正規化する値
+     * @returns 行の配列
+     */
+    private static normalizeLinesValue;
     /**
      * 値を数値へ正規化します。
      *
@@ -2181,10 +2213,10 @@ declare class ElementFragment extends Fragment {
      * 入力欄に宣言された収集値の型（`data-value-type`）を解決します。
      *
      * 宣言は静的なものとして扱い、DOM の属性から直接読みます。宣言できるのは
-     * `boolean` / `number` / `string` で、対象は値を持つ入力（`<input>` のうち
-     * `checkbox` / `radio` / `file` を除くもの、`<textarea>`、単一選択の `<select>`）
-     * です。対象外の要素や未知の型は宣言が無いものとして扱い、開発モードで警告します
-     * （仕様「`data-value-type`」）。
+     * `boolean` / `number` / `string` / `lines` で、対象は値を持つ入力（`<input>` の
+     * うち `checkbox` / `radio` / `file` を除くもの、`<textarea>`、単一選択の
+     * `<select>`）です。`lines` は `<textarea>` だけです。対象外の要素や未知の型は
+     * 宣言が無いものとして扱い、開発モードで警告します（仕様「`data-value-type`」）。
      *
      * @param element 対象の要素
      * @returns 宣言された型。宣言が無い場合と無視する場合は null
@@ -2446,6 +2478,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;
     /**
      * 指定した参照ノードの後に子ノードを挿入します。
      *
@@ -4113,6 +4167,17 @@ export declare class Form {
      * @return Promise（メッセージの追加が完了したら解決される）
      */
     static addMessage(fragment: ElementFragment, key: string, message: string, level?: 'info' | 'warning' | 'error' | 'success'): Promise<void>;
+    /**
+     * キーに一致したフラグメントから、2 つめ以降のラジオボタンを除きます。
+     *
+     * 同じキーで収集するラジオボタンは 1 つの値を表すため、メッセージは最初の
+     * 1 つにだけ渡します（仕様「エラーハンドリング」）。ラジオの数だけ渡すと、
+     * 同じ文がラジオの数だけ並びます。
+     *
+     * @param fragments キーに一致したフラグメント
+     * @returns メッセージを渡すフラグメント
+     */
+    private static keepFirstRadio;
     /**
      * 指定されたキーに一致するフラグメントを検索します。
      *
@@ -4858,7 +4923,7 @@ declare interface ValueChangeOrigin {
  * リリース時に `package.json` と揃えて更新します（`tests/version.test.ts` が
  * 一致を検査します）。
  */
-export declare const version = "0.59.4";
+export declare const version = "0.60.0";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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