ReoGrid ReoGrid Web

リリースノート

@reogrid/lite および @reogrid/pro の主な変更履歴。

フォーマットは Keep a Changelog に準拠し、 バージョニングは セマンティックバージョニング に従います。

v1.5.0

機能リリースです。目玉は Excel スタイルの検索と置換（Ctrl+F / Ctrl+H）、選択範囲・行・列のドラッグ移動、Excel 書式コードに対応したページヘッダー／フッター。さらに PDF エクスポートがロケール指定に対応し、CJK フォントを自動で埋め込みます。公開 API に破壊的変更はありません。

✨ ハイライト

  • ▸ 検索と置換（両エディション）。 Ctrl/Cmd+F・Ctrl/Cmd+H で開く組み込みバーが、シート・選択範囲・ブック全体（一致したシートを自動でアクティブ化）を検索します。大文字小文字の区別、セル内容の完全一致、正規表現に対応。一致はすべてキャンバス上でハイライトされ、Enter で順に移動、全置換は 1 手で元に戻せます。createReogrid({ showFindBar: false }) と grid.find / replaceAll などで独自 UI も構築できます。
  • ▸ 範囲・行・列の移動。 選択範囲の枠をドラッグしてブロックを移動（Excel と同じく移動先を上書き）、選択済みの行・列ヘッダーをドラッグすると切り取り＋挿入で並べ替えます。値・数式・スタイル・数値書式・セルタイプ・罫線・コメント・ロック状態が一緒に移動します。onBeforeRangeMove はキャンセル可能で、結合セルが分断されることはなく、移動は 1 件の undo エントリになります。
  • ▸ ページヘッダー・フッター（Pro）。 PrintSettings.headerFooter で、Excel と同じ書式コード（&P / &N / &D）を使い用紙の余白にページ番号・日付・シート名・ファイル名を印刷できます。奇数/偶数ページ別、先頭ページ別の帯にも対応。PDF エクスポートとページ分割印刷 HTML の両方で描画し、xlsx を往復します。
  • ▸ PDF エクスポートのロケール指定（Pro）。 saveAsPdf({ locale: 'zh-CN' }) でフォントのバイト列を持ち回ることなく適切な CJK フォントを埋め込みます。ja / zh-CN / zh-TW / ko は標準登録済みで、registerPdfFont で独自に追加できます。日本語フォントは簡体字中国語のビジネス頻出語の約 3 分の 1 しかカバーしないため、これが中国語出力の豆腐（□□□）を防ぎます。

+ 追加

  • ▸ 検索と置換。 instance.find / findNext / findPrevious / findAll / replace / replaceAll / clearFind / showFindBar / hideFindBar、およびワークシート側の worksheet.findAll ほか。オプションは matchCase、wholeCell、useRegex、lookIn（'formula' / 'value'）、order、range、includeHidden、インスタンスレベルの scope（'sheet' / 'selection' / 'workbook'）。非表示行・列、結合セルの従属セル、遅延ロードの未ロード行はスキップされ、保護セルが書き換わることはありません。
  • ▸ 範囲・行・列の移動。 RangeHandle.moveTo(row, column)、worksheet.moveRange / moveRows / moveColumns、事前判定の canMoveRange / canMoveRows / canMoveColumns、操作を無効化する worksheet.setRangeMoveEnabled(false)、そしてキャンセル可能な instance.onBeforeRangeMove と onAfterRangeMove イベント。
  • ▸ ページヘッダー・フッター（Pro）。 PrintSettings.headerFooter に帯ごとの左・中央・右セクション、differentOddEven / differentFirst で有効になる evenHeader / evenFooter・firstHeader / firstFooter、実際に反映される margins.header / margins.footer（Excel 既定 0.3 インチ）。背の高い帯は本文マージンを押し出すため、セルの上に重ならず 1 ページあたりの行数が減ります。
  • ▸ PDF の locale とフォントレジストリ（Pro）。 埋め込むフォントを指す ExportPdfOptions.locale。registerPdfFont、preloadPdfFont、getPdfFont、isPdfFontLoaded、isPdfFontRegistered、getRegisteredPdfFontTags、clearPdfFontCache を @reogrid/pro からエクスポート。エクスポートは同期のままなので、ロケールは自分で制御できる非同期地点で一度 preload してください。
  • ▸ instance.focus() — ホスト側のツールバーやメニュー操作のあとにグリッドへキーボードフォーカスを戻します。次のショートカット（undo/redo、コピー／貼り付け、矢印キー）がブラウザではなくグリッドに届きます。
  • ▸ worksheet.clearRowOutlines() / clearColumnOutlines()（Pro）と syncOutlines() — すべてのアウトライングループを 1 回で解除、または OutlineManager を直接操作したあとにアウトライン状態を再適用します。
  • ▸ WorksheetOptions.autoFitMaxScanRows（既定 1000）— 自動列幅調整が走査する行数の上限。巨大なシートでの文字幅計測コストを抑えます。

~ 変更

  • ▸ 列・行の境界のダブルクリックで選択範囲全体を自動調整。 A:D（や 3:6 行）を選択していずれかの境界をダブルクリックすると、Excel と同様に選択中のすべての列・行が調整されます。以前はポインタ直下の 1 本のみでした。
  • ▸ モニター変更時の HiDPI 再スケール。 devicePixelRatio の変化を監視するようになり、Retina と通常モニター間でウィンドウを移動しても、次に手動リサイズするまでキャンバスがぼやけたままになることがなくなりました。

🐛 修正

  • ▸ セル自体が画面外にスクロールしてもはみ出しテキストが描画され続けます。 右隣の空セルにはみ出した長い値が、そのセルの列がビューポートから出た途端に丸ごと消えていました。
  • ▸ ウィンドウ下部のドロップダウンが画面外ではなく上方向に開きます。 セルのドロップダウン（リスト入力規則／ドロップダウンセルタイプ）とオートフィルターのポップアップは、下に収まらない場合セルの上に反転し、水平方向もビューポート内に収まります。
  • ▸ フローティング画像がネイティブスクロールバーを覆わなくなり、最終行・最終列がスクロールバーの下に隠れなくなりました（Windows や、常時表示設定の macOS など、領域を占有するスクロールバー環境）。
  • ▸ ウィンドウ枠の固定後にスクロールバー末尾の無効な遊びが残らなくなりました — 構造変更時にスクロールスペーサーを再計算するようになり、ネイティブとワークシートのスクロール最大値が即座に一致します。
  • ▸ readReoGridJson() がワークシートにマージせず置き換えるようになり、2 つ目の文書を読み込んでも前の文書の行・スタイル・結合が下に残らなくなりました。また writeReoGridJson(worksheet) がシート名を保持し、保存のたびに Sheet1 に戻ることがなくなりました。
  • ▸ 数値書式付きの数式セルが一括再計算後に古い値を表示し続ける問題を修正（ソート・JSON 読み込み・帳票バインド・移動）。
  • ▸ PDF: pageSize の B4 / B5 / Tabloid / Executive が反映されます（従来は無警告で A4 にフォールバック）。グリッド線はシート自身の設定に従い、改ページ境界の罫線が両ページに印刷されます。
  • ▸ worksheet.selection が公開型定義に含まれるようになりました — ドキュメント記載のファサードは実行時には動作していましたが、同梱の .d.ts から欠落していました。
  • ▸ アウトライングループを解除すると、その行・列が再表示されます。 またグループ括弧の閉じ側の目印が、Excel と同じくトグルボタンから離れた端に描画されるようになりました。

v1.4.0

機能リリースです。目玉は Excel スタイルのページレイアウト＆印刷（改ページプレビュー）、自社のオリジナルエンジンによる PDF エクスポート、ピボットテーブル、テーブルスタイル（テーブルとして書式設定）、データの入力規則、レポートバインディング（テンプレート明細繰り返し）、セルコメント（メモ）、名前付き範囲 — そして日本語帳票向けの xlsx インポート忠実度の改善多数。公開 API に破壊的変更はありません。

✨ ハイライト

  • ▸ ページレイアウト＆印刷（Pro）。 ドラッグ可能な改ページのプレビュー、印刷設定モデル（用紙サイズ・向き・余白・倍率・ページ順）、手動改ページ、印刷範囲に対応。xlsx（pageSetup / pageMargins / rowBreaks / colBreaks）と JSON を往復します。
  • ▸ PDF エクスポート（Pro）。 自社のオリジナルエンジンによる PDF 生成 — 画面上の改ページプレビューと同一のページ割りで出力します。instance.exportPdf() / instance.saveAsPdf()。options.font に glyf TrueType フォントを渡します（ブラウザ用ヘルパー loadDefaultJapaneseFont()）。
  • ▸ ピボットテーブル（Pro）。 ソース範囲から再計算する API 駆動のライブピボット — 行・列・値・集計（sum / count / average / min / max ほか）。worksheet.createPivot(def)。
  • ▸ テーブルスタイル／テーブルとして書式設定（Pro）。 Excel 組み込みのテーブルスタイルをライブオーバーレイで描画（挿入/削除で縞模様が再配置）。実際の xl/tables/*.xml を xlsx で往復します。worksheet.addTable(range, options)。
  • ▸ データの入力規則（Pro）。 リスト、整数／小数／日付／時刻、文字列長、カスタム数式のルールに停止／注意／情報アラート付き。リストルールはドロップダウンを自動描画。読み込みは Lite でも動作します。
  • ▸ レポートバインディング／テンプレート明細繰り返し（Pro）。 ヘッダー／明細(×N)／フッターのテンプレートセクションを、バインドしたデータからその場に展開。{{token}} 補間、行ごとの数式シフト、フッター集計、帳票主導の改ページに対応。
  • ▸ セルコメント／メモ（Pro）。 クラシックな Excel コメント（セルごとに 1 件）を赤い角マーカーとホバーの吹き出しで表示。xlsx 読み込み、JSON 往復に対応。
  • ▸ 名前付き範囲／defined names。 ワークブックまたはシートスコープの =SUM(MyRange)、=Tax*2。カスケード再計算と xlsx・JSON 往復に対応。書き込みは Pro、読み込みは Lite でも動作します。

+ 追加

  • ▸ ページレイアウト＆印刷（Pro）。 PagingManager が PrintSettings と手動改ページを保持。改ページプレビューは青い破線（自動）と実線（手動／端）を描画し、改ページはドラッグで移動できます。ワークシートのデリゲータ：setPrintSettings、setShowPageBreaks、insertRowPageBreak / insertColumnPageBreak、getPrintPageRanges ほか。
  • ▸ PDF エクスポート（Pro）。 instance.exportPdf(options): Uint8Array と instance.saveAsPdf({ filename, ... }) が外部ライブラリなしでワークシートを描画。ページ割りレンダラーはセル背景、テキスト（配置・オーバーフロー・折り返し・交互行カラー・擬似ボールド）、グリッド線、罫線、結合セルの罫線、埋め込み画像、リッチテキストを描画します。
  • ▸ ピボットテーブル（Pro）。 ピボットエンジン＋worksheet.createPivot() がソース範囲からライブピボットを計算しグリッドに書き込み、refreshPivot / PivotHandle.update() で再計算。新デモ pivot-demo.html。*既知の制限：* 保存されたソース/出力範囲は行・列の挿入/削除でシフトしません — 構造編集後は refreshPivot を呼んでください。
  • ▸ テーブルスタイル／テーブルとして書式設定（Pro）。 worksheet.addTable / RangeHandle.formatAsTable(options) が OOXML スタイル名（既定 TableStyleMedium2）で縞模様のライブオーバーレイを適用し、挿入/削除で再配置。getTable / getTables は Lite で読み込み可。実際の xl/tables/tableN.xml と JSON を往復します。
  • ▸ データの入力規則（Pro）。 setValidation / removeValidation / clearValidations（Pro）＋ getValidations / validate（Lite）、RangeHandle.setValidation / CellHandle.setValidation。ルール：list、whole / decimal / date / time / textLength、custom、any。xlsx <dataValidations> と JSON を往復します。
  • ▸ レポートバインディング／テンプレート明細繰り返し（Pro）。 defineReportTemplate / bindReport / unbindReport（Pro）＋ getReportTemplate / getReportState（Lite）、instance.report ハンドル。pageBreakEvery: N で N レコードごとに手動改ページ。JSON 往復（sheet.reportTemplate）。
  • ▸ セルコメント／メモ（Pro）。 setComment / removeComment / clearComments / setCommentVisible（Pro）＋ getComment / hasComment（Lite）、CellHandle.setComment、RangeHandle.setComment。JSON を往復。xlsx は読み込み専用（VML 書き込みは保留）。
  • ▸ 名前付き範囲／defined names。 instance.defineName(name, address, scope?) / removeName / getName / getNames。xlsx <definedNames>（シートスコープは localSheetId）と JSON を往復します。
  • ▸ 永続的な範囲ハイライトオーバーレイ。 worksheet.setRangeHighlights が、選択／数式参照ハイライトとは独立に、範囲へ永続的な色付きオーバーレイを描画します。
  • ▸ xlsx インポート — 埋め込み OLE 画像オブジェクト（StaticDib）。 OLE オブジェクトとして保存された「図として貼り付け」のスクリーンショットを、DIB/BMP を抽出する最小 CFBF/OLE2 リーダーで表示します。

~ 変更

  • ▸ PDF エクスポートが改ページ／印刷設定モデルに追従。 新しい usePageBreaks オプションにより、用紙サイズ・向き・余白・倍率・ページ帯がすべて worksheet.getPrintSettings() と計算済みの改ページから取得され、画面上のプレビューと同一のページ割りで PDF を出力します。
  • ▸ エクスポートのファイル名が読み込み元のドキュメント名を既定に。 loadFromFile / loadFromUrl が元ファイルのベース名を記録し（getDocumentName() / setDocumentName()）、saveAsPdf と saveAsXlsx のダウンロード名の既定値に使用します（例：purchase-order.xlsx → purchase-order.pdf）。

🐛 修正

  • ▸ xlsx インポート — ロケール「短い日付」（numFmtId 14 / 22）が米国形式で表示。 組み込み 14/22 はロケール依存のため、東アジアの短い日付（yyyy/m/d）にマッピングするよう修正 — 既存の 27–36 / 50–58 の日本語マッピングと一貫し、国際的にも曖昧さがありません。
  • ▸ コピー — クリップボードが表示テキストではなく生値を保持。 両方のクリップボードペイロードが表示テキストを使用するように（日付セルはシリアル値 44985 ではなく 2023/2/28 をコピー）。結果が空の数式は空としてコピーされます。生値＋数値書式は data-rg-* 属性で引き続き往復します。
  • ▸ 画像オーバーレイがヘッダー上に描画されない。 フローティング画像をセル領域にクリップし、スクロール時に行・列ヘッダーへはみ出さないように。
  • ▸ xlsx インポート — 日本語帳票（発注書）。 ロケール予約の日付書式（numFmtId 27–36 / 50–58）が日付として描画され、ふりがなガイド（<rPh>）が共有文字列に漏れなくなり、_xlfn.IFS(…) の将来関数マーカーが #NAME? にならず解決されるように。
  • ▸ xlsx インポート — 小さなシートと複数行セル。 小さな使用範囲でグリッドが既定サイズ未満に縮まなくなり、_xHHHH_ エスケープ（_x000D_）をデコード、ハード改行を含む行が高さを自動調整するように。

! 既知の問題

  • ▸ セルコメントとピボットテーブルは JSON へは無損失で保存されますが、xlsx 対応は部分的です：コメントは読み込み専用（VML 書き込みは保留）、ピボットは描画済みセルのみ保存（<pivotTableDefinition> は保留）。

v1.3.0

機能リリースです。目玉はマルチシートワークブック — グリッドが N 枚のワークシートからなるワークブックになり、標準のシートタブバー、シートごとの Undo、ワークブック全体の xlsx/JSON 入出力、クロスシート数式参照（=Sheet1!A1）に対応しました。公開 API に破壊的変更はありません。

✨ ハイライト

  • ▸ マルチシートワークブック。 グリッドが N 枚のワークシート＋1 枚のアクティブシートからなるワークブックになり、標準のシートタブバー（追加・名前変更・削除・ドラッグ並べ替え・非表示・タブ色）を備えます。各シートが独自のデータ・選択・スクロール・固定・Undo 履歴を保持。新しい instance.workbook コーディネーター（addSheet / removeSheet / renameSheet / moveSheet / setActiveSheet / getSheets / onActiveSheetChange / onSheetsChange）。インスタンスでのワークブック全体 I/O：saveAsXlsx、loadXlsx / loadFromFile / loadFromUrl（全シートを読み込み）、toJson / loadJson。Lite / Pro 両対応で、ティアガードと行・列制限はシートごとに適用されます。
  • ▸ クロスシート数式参照。 数式から他シートのセルを参照できます：=Sheet1!A1、='My Sheet'!A1:B2、引用符なしの非 ASCII シート名（=シート1!A1）。集計関数と LOOKUP 系はクロスシート範囲に対応（=SUM(明細!A1:A3)）。Excel 互換のライフサイクル：シート名変更で参照式が書き換わり、シート削除で #REF!、行・列の挿入/削除は他シートの参照をシフト、クロスシート循環は #CYCLE! として検出。Lite / Pro 両対応。
  • ▸ アクティブシートに追従するインスタンスレベルイベント。 新しい instance.onSelectionChange / onCellValueChange / onBulkCellsChange / onScrollChange / onViewportSizeChange / onStructureChange / onContextMenu はアクティブシートのイベントを転送し、シート切り替え時に自動で張り替わります — シートごとの再バインドは不要です。

~ 変更

  • ▸ instance.worksheet と instance.actionManager はアクティブシートのものを返すゲッターになりました。既存のシングルシートコードはそのまま動作します。注意：シングルシート埋め込みでもデフォルトで高さ約 28px のシートタブバーが表示されます — 非表示にするには createReogrid({ showSheetTabs: false }) を渡してください。
  • ▸ マルチシート xlsx インポートはファイルを 1 回だけパースし、各シートのインポートで再利用します（従来は N シートで O(N) 回の再パース）。新しい parseXlsx() ヘルパーと ParsedXlsx 型を追加。
  • ▸ ワークブックのビュー状態が xlsx を往復します：アクティブシート、シートごとの非表示状態、シートタブ色をエクスポート時に書き出し、読み込み時に復元。ReoGrid-JSON もシートごとの view.showGridlines を保持します。

v1.2.3

パッチリリースです。非常に縦長／横長なシート（特に 1.2.2 で導入した 1,000,000 行の遅延ロードシナリオ）のネイティブスクロールを修正しました。公開 API に変更はありません。

🐛 修正

  • ▸ 巨大なシートが最終行までスクロールできるように。 ブラウザは要素のスクロール範囲を約 2^24 px で打ち切るため、1,000,000 行のシート（高さ約 22M px）は約 762,600 行目でスクロールが止まっていました。スクロールスペーサーを 14M px でキャップし、ネイティブスクロール位置をワークシート全域へ比例マッピングするように修正。ホイールのデルタも補正されるためスクロール速度は変わりません。キャップ未満のシートは正確な 1:1 マッピングのまま — 通常サイズのシートに挙動の変化はありません。

v1.2.2

目玉は 1,000,000 行のデータセットを表示する Pro 限定の遅延ロード・データソースです。ほかに Excel 風の横方向テキストオーバーフロー、General 表示での小数桁キャップ、Excel／Google Sheets に合わせた縦方向テキストメトリクスの修正、ドキュメント済みながら未エクスポートだった API を出荷するパッケージエントリ監査を含みます。公開 API に破壊的変更はありません。

✨ ハイライト

  • ▸ 遅延ロード・データソース（Pro）— 1,000,000 行のデータセットを表示。 worksheet.setDataSource(config) でオンデマンドの行ローダーを接続：可視行 ± 設定可能なバッファのみが、ユーザー提供の load(rows) コールバック（同期／非同期）経由でフェッチされます。リクエストは microtask でバッチ化・重複排除され、スクロール先読みは debounce され、洪水ガードが自動リクエストサイズを制限（全選択コピーがデータセット全体を走査しない）、エポックベースの無効化（invalidateAll() / invalidateRows()）が古い飛行中の結果を破棄します。loadCells / loadCellsAsync / reset で自動 detach。v1 は表示専用：未ロード行に対する数式・ソート・フィルタは非対応。型 DelayLoadConfig、DataRecord、DataLoadCallback、DataSourceHandle をエクスポート。
  • ▸ Excel 風の横方向テキストオーバーフロー。 折り返しなしで列幅より長いセルテキストが、隣の空セルへあふれて表示されるように。コンテンツ・明示的な塗りつぶし・結合セルを持つ最初のセルでクリップされます。あふれる方向は配置に従います（左揃え→右へ、右揃え→左へ、中央→両側）。
  • ▸ General 表示で長い小数をキャップ。 明示的な数値書式を持たない数値セルは、表示上の小数桁を上限（デフォルト 4 桁）に丸めます — 0.30000000000000004 → 0.3、=1/3 → 0.3333。表示のみ：保存値は完全精度を維持。createReogrid({ generalMaxFractionDigits }) で設定可能。

+ 追加

  • ▸ 新デモページ：delay-load-demo.html — 100 万行＋疑似サーバーレイテンシ、フェッチログ、行ジャンプ。
  • ▸ Lite / Pro の React・Vue ラッパーが v1.2 で告知済みのイベント props / emits を公開：onSelectionChange、onCellValueChange、onBulkCellsChange、onScrollChange、onViewportSizeChange、onStructureChange。Pro ラッパーの options は ReogridProOptions 型となり licenseKey を渡せます。
  • ▸ @reogrid/pro がセルタイプ登録 API（registerCellTypeHandler など）、NumberFormat、undo 可能なアクションクラス（ActionManager、ClipboardService、PasteAction など）、buildXlsxFromSnapshot、computeAutoFillValues / AutoFillAction、共通データ型をエクスポート。
  • ▸ @reogrid/lite が ReoGrid JSON I/O と共通データ型をエクスポート。KeyboardController.clipboardService がドキュメントどおり public readonly に。

🐛 修正

  • ▸ セルテキストの縦方向メトリクスを Excel / Google Sheets に一致させました：デフォルトフォントのセルが初回入力で行を自動拡張しない、インラインエディターが WYSIWYG に（レンダラーの行高と verticalAlign を反映）、下揃えテキストはセル下端近く（約 2 px）に配置。
  • ▸ 行高よりコンテンツが高いセルで中央／下揃えの縦配置が機能するように（従来は上端に固定）。
  • ▸ HTML／ブラウザ印刷の出力で結合セルの外周罫線を描画 — 結合されたタイトル行・注記ボックス・合計ボックスの外枠が失われなくなりました。

v1.2.1

パッチリリースです。1.2.0 で導入した数式参照編集に、グリッド上の参照ハイライトを Excel 風にドラッグで移動・リサイズする操作を追加しました。公開 API に変更はありません。

+ 追加

  • ▸ 数式参照ハイライトのドラッグ移動・ドラッグリサイズ。 数式の編集中に、参照矩形の点線枠をドラッグすると範囲全体が移動し、四隅のグリップをドラッグするとリサイズできます。式テキスト中に現れるその参照のすべての箇所が連動して書き換えられ、各トークンの絶対参照（$）フラグも保持されます。リサイズはセル中心を境界とし、ポインターがセルの中点を越えて初めてそのセルが範囲に出入りします（Excel および .NET 版と同じ挙動）。リサイズのホットゾーンが分かるよう各ハイライトに小さな色付きの角の四角を描画し、枠と角には move / nwse-resize / nesw-resize のホバーカーソルを表示します。

v1.2.0

機能リリースです。数式関数を 32 個から 109 個へ大幅拡充、セルエディターに Excel 風の色分けされた数式参照編集（クリックでのセル挿入）を追加、選択範囲にドラッグオートフィル用のハンドルを実装、条件付き書式ルールでサイドごとの罫線オーバーライドが可能になりました。React / Vue ラッパーはワークシートイベントをコンポーネント props として公開します。公開 API に破壊的変更はありません。

✨ ハイライト

  • ▸ オートフィル（ドラッグでのフィルハンドル）。 選択範囲の右下に表示される小さな四角をドラッグして、値を下／上／左／右に拡張できます。単一セルのドラッグはタイル状にコピー、2 つ以上の数値セルは等差数列として外挿（1, 2 → 3, 4, 5）、日付書式の単一セルは 1 日ずつ加算、数式は $ 固定参照を保ちつつ Excel と同じように相対参照をシフトします。スタイル・数値書式・セルタイプも伝播し、undo で元に戻せます。
  • ▸ Excel 風の数式参照編集。 数式（= 始まりのセル）を編集中に他のセルをクリックすると、そのセル番地がキャレット位置に挿入され、ドラッグで範囲に拡張できます。式中のユニークな参照ごとに共通パレットから色が割り当てられ、グリッド上の参照範囲も同色の点線矩形で囲まれます。結合セルを含む参照は結合領域全体を囲うように展開されます。
  • ▸ Enter キーで編集開始。 Mac に優しいデフォルト動作 — Enter で編集モードに入る（キャレットは末尾）。Numbers や Excel for Mac と同じ挙動です。F2 も引き続き使えます。
  • ▸ 組み込み数式関数を 109 個に拡充（従来は 32 個）。追加：VLOOKUP / HLOOKUP / INDEX / MATCH / XLOOKUP / XMATCH / ADDRESS、SUMIFS / COUNTIFS / AVERAGEIFS / MAXIFS / MINIFS / SWITCH、日付系 TODAY / NOW / DATE / YEAR / MONTH / DAY / HOUR / MINUTE / SECOND / WEEKDAY / EDATE / EOMONTH / DAYS / DATEDIF、数学 SUMPRODUCT / CEILING / FLOOR / MROUND / MEDIAN / LARGE / SMALL / RANK / EXP / LN / LOG / LOG10 / SIGN / PI / RAND / RANDBETWEEN、三角関数 SIN / COS / TAN / ASIN / ACOS / ATAN / ATAN2、文字列 SEARCH / EXACT / PROPER / CHAR / CODE、情報 ROW / COLUMN / ROWS / COLUMNS。
  • ▸ 条件付き書式でのサイドごとの罫線オーバーライド。 CF ルールに border ペイロードを持たせ、一致セルに対して右・上・下・左の罫線を個別に上書きできます。xlsx の <dxf><border> ラウンドトリップにも対応。
  • ▸ React / Vue ラッパーがワークシートイベントを props として公開。 選択・セル値変更・一括セル変更・スクロール・ビューポートサイズ・構造変更などのイベントを、worksheet.on*() を手動で購読することなく props として渡せます。
  • ▸ reogrid-json I/O をパッケージのメインエントリから再エクスポート。 ReoGrid Studio などワークシートを永続化するホストが、writeReoGridJson / readReoGridJson / parseReoGridJson および ReoGridJsonDocument / JsonWorksheet / JsonCell 型に対して、深いパスを掘ることなく @reogrid/lite / @reogrid/pro から直接アクセスできます。

+ 追加

  • ▸ ReogridOptions.autoFill（デフォルト true）と Worksheet.setAutoFillEnabled() でフィルハンドルを切り替え可能に。
  • ▸ プログラムからオートフィルを利用するための AutoFillAction と computeAutoFillValues() を公開。
  • ▸ Worksheet.setFormulaRefHighlights() / CanvasWorksheet.setFormulaRefHighlights()、およびエディターとグリッドレンダラーで共有する THEME.formulaRefColors パレット。
  • ▸ 条件付き書式の border ペイロード（right / top / bottom / left ごとにスタイルと色を指定）。エンジン評価・レンダラー・xlsx ライターまで一貫対応。
  • ▸ React コンポーネントのイベント props：onSelectionChange、onCellValueChange、onBulkCellValueChange、onScroll、onViewportSizeChange、onStructureChange（onReady に加えて）。
  • ▸ Vue コンポーネントは同じイベントセットを型付きペイロードで emit します。
  • ▸ @reogrid/lite / @reogrid/pro のメインエントリから writeReoGridJson、readReoGridJson、parseReoGridJson、および ReoGridJsonDocument / JsonWorksheet / JsonCell の各ドキュメント型と ReoGridJsonReadOptions / ReoGridJsonWriteOptions のオプション型を再エクスポート。
  • ▸ 10 カテゴリ・109 個すべての組み込み関数を網羅した数式関数リファレンスドキュメント。

~ 変更

  • ▸ エディターの数式参照ハイライトは、参照セル／範囲が結合領域と重なる場合に結合領域全体を囲うように展開されます（Google Sheets ではなく Excel と同じ挙動）。

🐛 修正

  • ▸ オートフィルのホバーカーソルをスクロールコンテナにも適用。フィルハンドルのヒット領域全体で十字カーソルが確実に表示されるようになりました。
  • ▸ 描画キャッシュキーに埋め込まれていた NUL バイトを | に置き換え。まれに発生する計測キャッシュの衝突や文字列処理上の挙動を回避します。

⚡ パフォーマンス

  • ▸ フレーム単位の Canvas ステートキャッシュにより、Book1.xlsx スクロール時の冗長な API 呼び出しを削減：ctx.font= 129 → 34（-74%）、ctx.fillStyle= 179 → 46（-74%）、ctx.measureText() 126 → 35（-72%）、save() / restore() 122 → 85（-30%）。実ブラウザではセルあたりのコストは ctx.font 解析と measureText のシェイピングが支配的なため、大きなシートでのスクロールが目に見えて滑らかになります。
  • ▸ 折り返し／複数行セル向けに layoutPlainTextLines() の結果をフレーム単位でキャッシュ。wrap-text を多用するテキスト中心のシートでは、スクロール時のフレームあたり処理量が大幅に減少します。単一行・折り返しなしのテキストはキャッシュをバイパスする高速経路を通ります。

v1.1.0

xlsx I/O の再現性とロード性能の向上、および .NET 版と同等のアウトライン読み書きを目的としたメンテナンスリリースです。公開 API に破壊的変更はありません。

✨ ハイライト

  • ▸ 大きなファイルの xlsx インポートが約 40% 高速化。 1945×503・約 44 万セルのシートのロードが 6.2 秒から 3.7 秒に短縮。
  • ▸ チャンク非同期ロード（LoadXlsxOptions.chunked）に対応。大きなファイルでも UI が固まらず、初回描画は数秒のフリーズではなく約 40 ms。デフォルトは従来どおり同期。
  • ▸ xlsx アウトラインのラウンドトリップ。 アウトラインレベル・非表示・折りたたみ状態・サマリー方向（上下／左右）の読み書きが、.NET 版と同等に。
  • ▸ ReoGrid JSON ファイル形式。 セル・スタイル・数値書式・リッチテキスト・結合・罫線・サイズ／表示状態・固定・条件付き書式・アウトライン・フィルター・セルタイプ・保護・交互行を、すべて無損失でシリアライズ。
  • ▸ アウトラインサマリー方向。 setRowSummaryBelow / setColumnSummaryRight でトグルボタンをグループの先頭側に切り替え。Excel と同様、アウトラインパネルの最内側に「すべて展開」用のスロットを確保。

+ 追加

  • ▸ LoadXlsxOptions.chunked — false（デフォルト・同期）、true（既定バッチサイズでチャンク）、または { batchSize } でバッチサイズを指定。await ws.loadFromFile(file, { chunked: true })。
  • ▸ Worksheet.loadCellsAsync(cells, { batchSize }) — バッチ間で yield しながら段階的に描画するチャンク非同期版。デフォルトバッチサイズは 5000 セル。
  • ▸ ReoGrid JSON 形式の読み書き API（writer + reader）。
  • ▸ 行・列アウトラインの xlsx 読み書きに対応：レベル、非表示、折りたたみ、サマリー方向。
  • ▸ Worksheet に setRowSummaryBelow(value) / setColumnSummaryRight(value) を追加（undo/redo 対応）。
  • ▸ 「すべて展開」アウトラインレベルボタン（アウトラインパネルの最内側スロット）。
  • ▸ autoFitColumns、autoFitRows、RowHandle / ColumnHandle の autoFit({ mode }) に AutoFitMode（'fit' | 'expandOnly' | 'shrinkOnly'）を追加。デフォルトの 'fit' は従来動作を維持。
  • ▸ 条件付き書式 cellIs ルールで value を value1 のエイリアスとして受け付けるように。between / notBetween では引き続き value2 が必要。両方指定された場合は value1 が優先。
  • ▸ xlsx インポートで、セル塗りつぶしのテーマカラーと tint を解決。
  • ▸ xlsx インポートで、<fgColor> に加え <bgColor> で表現された dxf 塗りつぶしも読み取り可能に。Excel が書き出した条件付き書式の塗りつぶしが正しく反映されます。
  • ▸ Code Runner（コード実行）デモページを追加。

~ 変更

  • ▸ xlsx インポート時、アウトラインと条件付き書式を非同期セル読み込みより前に適用。初回描画から正しい折りたたみ状態で表示され、展開後にスナップする挙動を解消。
  • ▸ Canvas のフォント文字列に常に汎用 sans-serif フォールバックを付与。指定フォントが未インストール（Office 未導入端末で「Aptos Narrow」を参照する xlsx など）でも、italic / bold プレフィックスが失われなくなりました。

🐛 修正

  • ▸ 非表示の行・列に含まれるセルの罫線を描画しないように修正。アウトライングループで A〜J 列を折りたたんだ際に、A 列の左罫線が行ヘッダー境界に縦線として残る不具合を解消。.NET 版と同等の挙動に。
  • ▸ xlsx インポート：プレーン共有文字列に対して cellXf/font で指定された太字が正しく描画されるように。従来はすべてのプレーン共有文字列がリッチテキスト扱いとなり、セルレベルのスタイルが無視されていました。
  • ▸ 数値書式の条件セクション（[=0]、[<>N]、[<N]、[<=N]、[>N]、[>=N]）を値の型と独立して評価するように修正。[=0]"-";m/d/yy のような書式コードで常に先頭セクションが選ばれる不具合を解消。
  • ▸ Excel シリアル日付エポックの 1 日ずれを修正。シリアル 45658 が期待どおり 2025-01-01 に解決されます。
  • ▸ xlsx インポート時に、テーマカラー・tint・<bgColor> で表現された dxf 塗りつぶし（Excel 出力ファイルでは一般的）を解決するように。
  • ▸ プレーンテキスト描画経路で複数単語のフォントファミリー（例：「Aptos Narrow」）が二重引用符で囲まれなくなりました。これにより Canvas 2D が italic / bold プレフィックスを無言で破棄する不具合を解消。
  • ▸ 非表示列の列ヘッダーラベルをスキップするように修正。アウトライングループの折りたたみ時に、次の表示列上にヘッダー文字が二重描画されなくなりました。
  • ▸ 折りたたまれた親により非表示となったグループのアウトライントグルとブラケット線をスキップ。内側のトグルが外側のトグル行に重ね描きされる不具合を解消。
  • ▸ 部分的に重なるアウトライングループを追加した場合、明確なエラーをスローするように。アウトライングループは厳密なツリー構造を成す必要があり、従来は交差により表示されるがクリックできない内側トグルが生成されていました。
  • ▸ 行・列両方のアウトラインパネルがある場合の、コーナー領域レベルボタンの当たり判定をレンダラーと整合。
  • ▸ 不正な条件付き書式 cellIs ルール（value1 欠落）が描画ループをクラッシュさせなくなり、ルールは単に不一致を返すように。
  • ▸ プレイグラウンドデモ：初回クリックで xlsx ファイルを開けるように修正（再描画まで worksheet=null の古いクロージャをツールバーが保持していました）。

⚡ パフォーマンス

  • ▸ xlsx エンドツーエンドロード時間（1945×503・約 44 万セルのテストファイル）：node で 6.2 秒 → 3.9 秒（-37%）。改善はパーサー、セル抽出ウォーク、ワークシート一括ロード経路、数式エンジンの初期再構築に及びます。
  • ▸ インポート時の行オートフィットを遅延評価に変更：先行測定はビューポート内の行のみ、それ以外の行は初めてスクロール表示された時点で測定。Book1 規模のシートで約 100 万件の無駄なセル訪問をスキップ。
  • ▸ チャンクインジェスト（{ chunked: true }）により、ユーザーから見て「固まる」時間を、数秒のフリーズから 16〜30 ms スライスへと分割。

v1.0.0

初の安定版リリース。これ以降、公開 API は semver の下で凍結され、1.0.0 以降の破壊的変更にはメジャーバージョンアップが必要となります。

✨ ハイライト

  • ▸ ハンドルベースの公開 API。 構造・スタイル操作はすべて、フラットなトップレベルメソッドではなくチェーン可能なハンドル（worksheet.row(i)、worksheet.column('B')、worksheet.range('A1:C5').setBold()、worksheet.selection.range?.setStyle(...)）経由で行います。今後はこの API に対して実装してください。
  • ▸ 内部 Manager レイヤリング。 Worksheet はエントリポイントとなり、状態変更は StyleOperations、SizingManager、VisibilityManager、StructureManager に分離。
  • ▸ 数式エンジン。 Lexer → parser → evaluator → 依存グラフ + 32 個の組み込み関数。インポートした xlsx 数式は再評価されます。tests/formula.spec.ts と tests/formula-ext.spec.ts に 151 件の数式テスト。
  • ▸ プラガブルなセルタイプ。 CellTypeHandler レジストリと 8 種類の組み込みタイプ：チェックボックス、ドロップダウン、ボタン、プログレス、レーティング、スパークライン（折れ線・面）、ハイパーリンク。
  • ▸ 条件付き書式（Pro）。 addConditionalFormat、removeConditionalFormat、clearConditionalFormats、getConditionalFormats。
  • ▸ セルツールチップ（Pro）。 setCellTooltip、showCellTooltip、hideCellTooltip、clearCellTooltip。
  • ▸ ブラウザ印刷（Pro）。 スタンドアロン関数 printWorksheet(...)。Lite ではアップグレード促進用の console.warn スタブとして提供。
  • ▸ xlsx ラウンドトリップ。 ReoGrid .NET 版とのクロスバリデーション付きインポート／エクスポート。
  • ▸ Lite / Pro ティアガード。 Lite は 100 行 × 26 列の上限を強制し、Pro 限定メソッドを公開ハンドル層と内部 Manager チョークポイントの両方でスタブ化。
  • ▸ React / Vue ラッパー。 別エントリポイントとして公開：@reogrid/lite/react、@reogrid/lite/vue、@reogrid/pro/react、@reogrid/pro/vue。

+ 追加

  • ▸ worksheet.reset(options?) — ワークシートを破棄せず、その場で空の状態に戻します。値、スタイル、セルタイプ、ヘッダードロップダウン、条件付き書式、セル保護、罫線、結合、非表示の行／列、アウトライン、固定枠、カスタム行／列サイズ、スクロール、選択を消去し、showGridLines を true にリセット。options.rows / options.columns でグリッドサイズも変更可能。CanvasWorksheet はさらに画像、オートフィルター、ツールチップも消去します。xlsx インポーターはロード前リセットとしてこれを使用。
  • ▸ シングル軸サイズ変更用の worksheet.rows.setCount(count) / worksheet.columns.setCount(count)（RowCollection / ColumnCollection）。
  • ▸ @reogrid/lite から printWorksheet を console.warn スタブとして再エクスポート。PRO_METHODS と統一されたガード機構を提供。
  • ▸ PRO_MANAGER_METHODS + applyLiteWorksheetGuards により Manager の裏口（structureManager.insertRows、visibilityManager.setRowHidden 等）を閉鎖。各ハンドルのエントリポイントがティアガードを迂回できなくなりました。
  • ▸ yarn test:perf スクリプトと tests/**/*-benchmark.spec.ts 命名規約。日常の yarn test を高速に保ちつつ、ベンチマークはオプトインで実行。
  • ▸ ワークシートコンテナに ResizeObserver を設置。flex／サイドバー／パネルのレイアウト変更にキャンバスが追従。
  • ▸ requestAnimationFrame ベースの描画バッチング（Worksheet.scheduleRender）。
  • ▸ 大規模データセットを高速にバルクロードする bulkSetCells() API。
  • ▸ Excel 流のキーボード選択：anchor + focus モデル、Shift+クリックでの選択拡張、方向認識する結合ナビゲーション、キーボード／ドラッグ時のオートスクロール。
  • ▸ グリッドにスナップしてリサイズする自動拡張型セルエディター。
  • ▸ tsconfig.json の stripInternal: true により、@internal メンバーが公開 .d.ts に漏れなくなりました。

~ 変更

  • ▸ 破壊的変更： worksheet.setRowCount(n) と worksheet.setColumnCount(n) を削除。代わりに worksheet.rows.setCount(n) / worksheet.columns.setCount(n)、または両軸を一括変更する worksheet.setGridSize(rows, cols) を使用してください。
  • ▸ 破壊的変更： worksheet.rows / worksheet.columns は RowCollection / ColumnCollection ハンドルを指すようになりました。数値カウントは worksheet.rowCount / worksheet.columnCount に移動。
  • ▸ 破壊的変更： worksheet.selection は bounds / isEmpty / activeCell / range / moveTo のみを公開する薄い SelectionHandle に。現在の選択に対するスタイル・値操作は、ハンドル上の委譲メソッドではなく worksheet.selection.range?.setBold() 経由で行ってください。
  • ▸ 破壊的変更： フラットな setSelection*Bold/Italic/Style/... メソッドを削除。ハンドル API（worksheet.range(...).setBold()）に置き換え。
  • ▸ KeyboardController は window ではなくワークシートコンテナでリッスン。同一ページ上の複数グリッドインスタンス間でキーボードイベントが交差しなくなりました。
  • ▸ CellEditor のインラインテキストエリアが position: fixed ではなく、ワークシートコンテナ基準の position: absolute を使用するように。CSS transform を持つ祖先要素、モーダルダイアログ、iframe 内での位置ずれを解消。
  • ▸ 結合セル描画：結合アンカーがスクロールアウトしている場合、最も上・最も左にある表示中セルからコンテンツを描画するように。

🐛 修正

  • ▸ COUNT(1, 1/0, 2) のような直接引数中のエラーが正しく伝播するように（Excel と同等の挙動）。範囲引数内のエラーは従来どおり無視されます。
  • ▸ 行／列削除後の #REF! が正しくキャッシュされるように（評価器の name ノードで EXCEL_ERROR_LITERALS が参照されておらず、#NAME? として表面化していた問題）。
  • ▸ ビッグデータデモにおける bulkSetCells の初回描画経路。
  • ▸ エディターの背景がセルの backgroundColor を尊重するように。
  • ▸ ポインター／エディター操作におけるダブルクリックと編集コミットの各種エッジケース。

− 削除

  • ▸ レガシーなフラット setSelection* API（ハンドル API を使用してください）。
  • ▸ worksheet.setRowCount / setColumnCount（コレクションの setCount を使用してください）。

! 既知の問題

  • ▸ worksheet.columnWidths / rowHeights 配列は JS 配列インデックス経由で変更可能（readonly で強制されていません）。
  • ▸ React の <Reogrid> はマウント後の options prop 変更を無視します（強制リマウントには key を使用）。
  • ▸ オートフィットは列あたり O(rows)。
  • ▸ devicePixelRatio は resize() ごとに 1 度のみ読み取られ、モニター変更時には更新されません。

生のチェンジログや過去のリリース履歴は、npm の @reogrid/lite パッケージページをご覧ください。

ニュースレター

開発の最新情報をお届けします

新しいリリース・機能追加・お知らせをいち早く受け取るには、
メーリングリストにご登録ください。