@ishibashi0112/spreadsheet-grid 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,3 @@
1
+ import type { CsvExportScope } from '../model/gridTypes';
2
+ export type NormalizedCsvExportScope = 'view' | 'raw' | 'rendered' | 'selection';
3
+ export declare const normalizeExportScope: (scope: CsvExportScope) => NormalizedCsvExportScope;
@@ -311,7 +311,21 @@ export type GridClassNames = {
311
311
  iconButton?: string;
312
312
  };
313
313
  export type ScrollAlign = 'auto' | 'start' | 'center' | 'end';
314
- export type CsvExportScope = 'all' | 'selection' | 'visible';
314
+ /**
315
+ * エクスポートの対象範囲です(exportCsv / downloadCsv / getExportData で共通)。
316
+ * - `'view'` : ビュー行全体(フィルター/ソート/列可視・固定順を反映)。**既定値**。スクロール位置に依存しません。
317
+ * - `'raw'` : 全ソース行(`rows` 配列順)。フィルターもソートも無視します(列は可視列・固定順に従います)。
318
+ * serverSide はソース行配列を持たないため `'view'` 相当へフォールバックします(console.warn を出力)。
319
+ * - `'rendered'` : 仮想化ウィンドウ(いま描画中の行のみ・オーバースキャン込み)。結果はスクロール位置に依存します。
320
+ * - `'selection'`: 現在の選択範囲(セル/行/列)。選択なしのときは空(CSV は空文字 / データは空配列)を返します。
321
+ */
322
+ export type CsvExportScope = 'view' | 'raw' | 'rendered' | 'selection' | DeprecatedCsvExportScope;
323
+ /**
324
+ * 後方互換エイリアスです(実行時挙動は新名称と完全同一): `'all'` → `'view'` / `'visible'` → `'rendered'`。
325
+ * @deprecated `'visible'` は「フィルターで見えている行」ではなく「描画中の行(仮想化ウィンドウ)」を
326
+ * 指すため誤読のもとになります。新規コードでは `'view'` / `'rendered'` を使用してください。
327
+ */
328
+ export type DeprecatedCsvExportScope = 'all' | 'visible';
315
329
  export type CsvExportOptions = {
316
330
  scope?: CsvExportScope;
317
331
  includeHeaders?: boolean;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ishibashi0112/spreadsheet-grid",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "description": "React 19 製のカスタム仮想化データグリッド。100 万行対応の仮想化・3 ペイン固定列・ソート/フィルター・クライアント/サーバーサイド行モデル対応。",
5
5
  "keywords": [
6
6
  "react",