haori 0.13.2 → 0.15.0

package/dist/index.d.ts

@@ -1377,6 +1377,48 @@ declare class Haori {
      * @returns 表示要素の配列
      */
     static pages(totalPages: number, current: number, options?: PagesOptions): PageItem[];
+    /**
+     * `YYYY-MM` 形式の年月文字列に月数を加算します。
+     *
+     * テンプレート式中の `haori.monthAdd(...)` と同じ実装です。
+     *
+     * @param value 基準となる年月（`YYYY-MM` 形式）
+     * @param delta 加算する月数（負数で過去方向）
+     * @returns 加算後の年月（`YYYY-MM` 形式）。不正な入力は空文字
+     */
+    static monthAdd(value: string | null | undefined, delta: number): string;
+    /**
+     * 基準月から過去方向へ `count + 1` 個の年月配列を降順で返します。
+     *
+     * テンプレート式中の `haori.monthRange(...)` と同じ実装です。
+     *
+     * @param count 基準月から遡る月数（戻り値の要素数は `count + 1`）
+     * @param base 基準月（`YYYY-MM` 形式、省略時は現在月）
+     * @returns 年月情報の降順配列。不正な入力は空配列
+     */
+    static monthRange(count: number, base?: string): MonthItem[];
+    /**
+     * ページレスポンスから表示用サマリーを作ります。
+     *
+     * テンプレート式中の `haori.pageSummary(...)` と同じ実装です。
+     *
+     * @param page ページ情報（`number`・`size`・`totalElements`／`totalCount` 等）
+     * @param visibleCount 現在表示している件数（省略可）
+     * @returns 表示サマリー
+     */
+    static pageSummary(page: Record<string, unknown> | null | undefined, visibleCount?: number): PageSummary;
+    /**
+     * 配列から `item[key]` が指定値に一致する最初の要素を返します。
+     *
+     * テンプレート式中の `haori.findBy(...)` と同じ実装です。比較は文字列化して
+     * 行い、一致が無ければ null を返します。
+     *
+     * @param array 検索対象の配列
+     * @param key 比較に使うプロパティ名
+     * @param value 一致させたい値（文字列化して比較）
+     * @returns 一致した最初の要素。無ければ null
+     */
+    static findBy(array: unknown, key: string, value: unknown): unknown;
 }
 export { Haori }
 export default Haori;
@@ -1423,6 +1465,16 @@ export declare class Log {
     static error(message: string, ...args: unknown[]): void;
 }
 
+/**
+ * `monthRange()` が返す1要素分の情報です。
+ */
+declare interface MonthItem {
+    /** 年月（`YYYY-MM` 形式） */
+    targetMonth: string;
+    /** 表示用ラベル（`YYYY/MM` 形式） */
+    label: string;
+}
+
 /**
  * `pages()` が返す1要素分の情報です。
  */
@@ -1455,6 +1507,20 @@ declare interface PagesOptions {
     boundary?: number;
 }
 
+/**
+ * `pageSummary()` が返すページ表示サマリーです。
+ */
+declare interface PageSummary {
+    /** 表示中の先頭要素の通し番号（1 始まり）。0 件のときは 0 */
+    start: number;
+    /** 表示中の末尾要素の通し番号（1 始まり）。0 件のときは 0 */
+    end: number;
+    /** 総件数 */
+    total: number;
+    /** 総件数が 0 のとき true */
+    empty: boolean;
+}
+
 /**
  * @fileoverview 汎用非同期キュー機能
  *
@@ -1543,7 +1609,7 @@ declare class TextFragment extends Fragment {
     evaluate(): Promise<void>;
 }
 
-export declare const version = "0.13.2";
+export declare const version = "0.15.0";
 
 /**
  * すべてのレンダリングタスク（追従投入分を含む）の完了を待ちます。

package/package.json

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