@threestarsoftware/tssgrid 0.1.22 → 0.1.24

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 TssGrid の各リリースの変更点。日付は JST。形式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) 準拠（ゆるめ）。
 数値は特記なき限り**自社調べ**（headless Chrome / Windows 11・環境差あり）。
 
+## [0.1.24] - 2026-10-08
+
+### 追加
+- **遅延ロード（`setRowCount` / `fillRows` / `onViewportChange`）のサンプルを追加** — `examples/lazy-load.html`。AG Grid の Infinite Row Model 相当＝**10万件を一度に取らず、仮想スクロールで見える範囲だけ取得**する型を動く例に。①`setRowCount(total)` で確保（未取得は「読込中」表示）→ ②`onViewportChange(start,end)` で要る範囲を受け → ③`fillRows(start, rows)` で流し込む。ブロック単位取得（取得済み/取得中はスキップ）＋サーバ呼び出しログで「可視ぶんだけ取得」を可視化。README のページネーション節からリンク。コア変更なし。
+
+## [0.1.23] - 2026-10-08
+
+### 追加
+- **`TssGrid.zen2han(s)` / `TssGrid.esc(s)` を公開 static として型定義（`.d.ts`）に追加**（コア）— 全角→半角ユーティリティ（内部名 `_zen2han` を公開名 `zen2han` にリネーム）と HTML エスケープ `esc` を、**TypeScript から型付きで呼べる**ように宣言。`number`/`date`/`time` の組込 parse で使うほか、**カスタム `parse`/`format` から `TssGrid.zen2han(v)` を再利用**できる（例: 和暦・年月日の自前パーサの前処理で全角も吸収）。挙動は不変。
+
 ## [0.1.22] - 2026-10-07
 
 ### 追加

package/README.md

@@ -364,7 +364,7 @@ async function load() {
 // 前/次/ページ番号は <button> で外に置き、go(p) → load() を呼ぶ
 ```
 - **`total` が返るサーバ**: 「全何件・何ページ」まで出せる（上の例）。**`total` が無い（cursor のみ）**: ページ番号は出せないので **`appendRows` で「もっと読む」＝無限スクロール型**に。
-- **1本の長いスクロールで必要分だけ取得**したいなら、ページ送りでなく `setRowCount(total)` ＋ `onViewportChange` ＋ `fillRows(start, rows)`（AG Grid の Infinite Row Model 相当・上の「メソッド」参照）。
+- **1本の長いスクロールで必要分だけ取得**したいなら、ページ送りでなく `setRowCount(total)` ＋ `onViewportChange(start,end)` ＋ `fillRows(start, rows)`（AG Grid の Infinite Row Model 相当・`virtual:true` 前提／未取得行は「読込中」表示）。動く例: [`examples/lazy-load.html`](https://tssgrid.threestarsoftware.co.jp/examples/lazy-load.html)（10万件を見える範囲だけ取得）。
 - sort/filter をサーバ側でやる場合も同じ＝**操作 → 再 fetch → `setData`**（遅延スクロール型なら `onSortFilterChange` で委譲）。
 
 ### 同梱プラグイン: ヘッダ オートフィルタ（filter UI）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threestarsoftware/tssgrid",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "軽量・ノービルド・日本語IME堅牢な編集グリッド（vanilla JS / 依存なし / MIT）。Excel ライクな入力画面を <script> タグ1本で。",
   "license": "MIT",
   "author": "ThreeStarSoftware (https://www.threestarsoftware.co.jp/)",

package/src/tssgrid.d.ts

@@ -489,6 +489,13 @@ export declare class TssGrid {
   /** 遅延ロード: 未取得行を表す sentinel。setRowCount が未取得ぶんを data[r] に入れ、fillRows で実データへ差し替える。 */
   static readonly PENDING: unique symbol;
 
+  /** 全角→半角（数字・符号・小数点・カンマ・%・¥・空白＋日付/時刻の区切り ／：）。IME 誤入力対策のユーティリティ。
+   *  number/date/time の組込 parse で使うほか、カスタム `parse`/`format` から `TssGrid.zen2han(v)` として呼べる。 */
+  static zen2han(s: string): string;
+
+  /** HTML エスケープ（`&` `<` `>`）。`format` で HTML を組む時などに。 */
+  static esc(s: any): string;
+
   [k: string]: any;
 }
 

package/src/tssgrid.js

@@ -961,7 +961,7 @@
     static _colLabel(n) { let s = ''; n = n | 0; do { s = String.fromCharCode(65 + (n % 26)) + s; n = Math.floor(n / 26) - 1; } while (n >= 0); return s; }
     // 入力文字列 → 'yyyy-mm-dd'（不正は null）。yyyymmdd / yyyy-mm-dd / yyyy/mm/dd / yyyy.mm.dd を許容。
     static _parseDate(s) {
-      s = TssGrid._zen2han(String(s).trim());   // IME ON の全角（２０２６／０１／０１ 等）も半角化して受理
+      s = TssGrid.zen2han(String(s).trim());   // IME ON の全角（２０２６／０１／０１ 等）も半角化して受理
       if (s === '') return null;
       let y, m, d;
       const sep = /^(\d{4})[-/.](\d{1,2})[-/.](\d{1,2})$/.exec(s);
@@ -974,7 +974,7 @@
     // 入力文字列 → 24時間制 'HH:MM' / 'HH:MM:SS'（不正は null）。24h と 12h(AM/PM) の両方を受理。
     static _parseTime(s) {
       // IME ON の全角（９：３０ 等）も半角化して受理
-      const m = /^(\d{1,2}):(\d{2})(?::(\d{2}))?\s*([AaPp][.]?[Mm][.]?)?$/.exec(TssGrid._zen2han(String(s).trim()));
+      const m = /^(\d{1,2}):(\d{2})(?::(\d{2}))?\s*([AaPp][.]?[Mm][.]?)?$/.exec(TssGrid.zen2han(String(s).trim()));
       if (!m) return null;
       let h = +m[1]; const mi = +m[2], se = m[3] == null ? null : +m[3];
       const ap = m[4] ? m[4][0].toLowerCase() : null;  // 'a' | 'p' | null
@@ -991,9 +991,10 @@
       return h + ':' + m[2] + (m[3] != null ? ':' + m[3] : '') + ' ' + ap;
     }
     // CellFormat: 入力(グルーピング/前後綴り混じり) → 正規化した数値文字列（保存値）。不正は null。
-    // 全角→半角（数値・日付・時刻文脈）。数字・符号・小数点・カンマ・%・¥・空白＋日付/時刻の区切り（／：）を半角化。
+    // 全角→半角（公開 static ユーティリティ）。数字・符号・小数点・カンマ・%・¥・空白＋日付/時刻の区切り（／：）を半角化。
     // 業務フォームの IME 誤入力対策（IME ON のまま「２０２６／０１／０１」「９：３０」等を打っても弾かず半角で受理）。
-    static _zen2han(s) {
+    // 内部（number/date/time の parse）で使うほか、カスタム parse/format から TssGrid.zen2han(v) として呼べる。
+    static zen2han(s) {
       return String(s)
         .replace(/[０-９]/g, ch => String.fromCharCode(ch.charCodeAt(0) - 0xFEE0))
         .replace(/＋/g, '+').replace(/[－−ー―]/g, '-')
@@ -1003,7 +1004,7 @@
     }
     static _parseNumber(v, cfg) {
       let s = String(v).trim();
-      if (cfg.zenkaku !== false) s = TssGrid._zen2han(s);   // 既定で全角→半角（cfg.zenkaku:false で無効化）
+      if (cfg.zenkaku !== false) s = TssGrid.zen2han(s);   // 既定で全角→半角（cfg.zenkaku:false で無効化）
       if (cfg.prefix) s = s.split(cfg.prefix).join('');
       if (cfg.suffix) s = s.split(cfg.suffix).join('');
       s = s.replace(/,/g, '').replace(/\s/g, '');