@ishibashi0112/spreadsheet-grid 0.4.0 → 0.6.0

package/dist/logic/exportCsv.d.ts

@@ -0,0 +1,11 @@
+import type { GridColumn } from '../model/gridTypes';
+export type SerializeRowsToCsvParams<T> = {
+    getRow: (viewIndex: number) => T;
+    startRow: number;
+    endRow: number;
+    columns: GridColumn<T>[];
+    delimiter?: string;
+    includeHeaders?: boolean;
+    bom?: boolean;
+};
+export declare const serializeRowsToCsv: <T>({ getRow, startRow, endRow, columns, delimiter, includeHeaders, bom, }: SerializeRowsToCsvParams<T>) => string;

package/dist/logic/gridState.d.ts

@@ -0,0 +1,13 @@
+import type { ColumnFilterValue, GridColumn, GridColumnState, GridFilterState, GridSortState, GridState } from '../model/gridTypes';
+export declare const GRID_STATE_VERSION = 2;
+export declare const cloneColumnFilterValue: (value: ColumnFilterValue) => ColumnFilterValue;
+export declare const extractColumnState: <T>(columns: GridColumn<T>[]) => GridColumnState[];
+export declare const buildGridState: (columnWidths: Record<string, number>, filters: GridFilterState, sort: GridSortState, columns?: GridColumnState[], version?: number) => GridState;
+export declare const migrateGridState: (input: unknown) => GridState;
+export declare const applyColumnState: <T>(currentColumns: GridColumn<T>[], savedColumnState: GridColumnState[], savedWidths: Record<string, number>) => GridColumn<T>[];
+export declare const isSameGridState: (a: GridState, b: GridState) => boolean;
+export type StateChangeDecision = {
+    emit: boolean;
+    nextLast: GridState | null;
+};
+export declare const decideStateChangeEmit: (prevLast: GridState | null, current: GridState, isDragging: boolean) => StateChangeDecision;

package/dist/logic/scrollTargets.d.ts

@@ -0,0 +1,22 @@
+import type { ScrollAlign } from '../model/gridTypes';
+export type VerticalScrollTargetParams = {
+    rowTop: number;
+    rowHeight: number;
+    headerHeight: number;
+    viewportHeight: number;
+    currentScrollTop: number;
+    align: ScrollAlign;
+    maxScrollTop?: number;
+};
+export declare const computeVerticalScrollTarget: ({ rowTop, rowHeight, headerHeight, viewportHeight, currentScrollTop, align, maxScrollTop, }: VerticalScrollTargetParams) => number;
+export type HorizontalScrollTargetParams = {
+    cellLeft: number;
+    cellWidth: number;
+    leftPaneWidth: number;
+    rightPaneWidth: number;
+    viewportWidth: number;
+    currentScrollLeft: number;
+    align: ScrollAlign;
+    maxScrollLeft?: number;
+};
+export declare const computeHorizontalScrollTarget: ({ cellLeft, cellWidth, leftPaneWidth, rightPaneWidth, viewportWidth, currentScrollLeft, align, maxScrollLeft, }: HorizontalScrollTargetParams) => number;

package/dist/model/gridActions.d.ts

@@ -1,4 +1,4 @@
-import type { CellCoord, ColumnFilterValue, GridSortEntry } from './gridTypes';
+import type { CellCoord, ColumnFilterValue, GridFilterState, GridSortEntry } from './gridTypes';
 export type GridUiAction = {
     type: 'cell/activate';
     cell: CellCoord | null;
@@ -35,7 +35,7 @@ export type GridUiAction = {
     startX: number;
     startWidth: number;
     minWidth: number;
-    maxWidth: number;
+    maxWidth?: number;
 } | {
     type: 'column/resizeUpdate';
     clientX: number;
@@ -59,6 +59,9 @@ export type GridUiAction = {
     columnKey: string;
 } | {
     type: 'filter/resetAll';
+} | {
+    type: 'filter/setAll';
+    filters: GridFilterState;
 } | {
     type: 'sort/set';
     entries: GridSortEntry[];
@@ -77,7 +80,7 @@ export declare const gridActions: {
     clearSelection: () => GridUiAction;
     startEdit: (cell: CellCoord) => GridUiAction;
     stopEdit: () => GridUiAction;
-    startColumnResize: (columnKey: string, startX: number, startWidth: number, minWidth: number, maxWidth: number) => GridUiAction;
+    startColumnResize: (columnKey: string, startX: number, startWidth: number, minWidth: number, maxWidth?: number) => GridUiAction;
     updateColumnResize: (clientX: number) => GridUiAction;
     endColumnResize: () => GridUiAction;
     syncColumnWidths: (widths: Record<string, number>) => GridUiAction;
@@ -86,6 +89,7 @@ export declare const gridActions: {
     setColumnFilter: (columnKey: string, value: ColumnFilterValue) => GridUiAction;
     clearColumnFilter: (columnKey: string) => GridUiAction;
     resetAllFilters: () => GridUiAction;
+    setAllFilters: (filters: GridFilterState) => GridUiAction;
     setSort: (entries: GridSortEntry[]) => GridUiAction;
     clearSort: () => GridUiAction;
 };

package/dist/model/gridTypes.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 export type GridRowKey = string | number;
 export type RowModel<T> = {
     getRowCount: () => number;
@@ -148,6 +148,8 @@ export type GridColumn<T> = {
     maxWidth?: number;
     flex?: number;
     resizable?: boolean;
+    suppressAutoSize?: boolean;
+    estimateCellWidth?: (row: T, column: GridColumn<T>) => number;
     autoHeight?: boolean;
     visible?: boolean;
     editable?: boolean;
@@ -243,7 +245,60 @@ export type GridClassNames = {
     rowHeaderCell?: string;
     iconButton?: string;
 };
+export type ScrollAlign = 'auto' | 'start' | 'center' | 'end';
+export type CsvExportScope = 'all' | 'selection' | 'visible';
+export type CsvExportOptions = {
+    scope?: CsvExportScope;
+    includeHeaders?: boolean;
+    delimiter?: string;
+    bom?: boolean;
+};
+export type GridColumnState = {
+    key: string;
+    visible?: boolean;
+    pinned?: GridColumnPinned;
+};
+export type GridState = {
+    version: number;
+    columnWidths: Record<string, number>;
+    filters: GridFilterState;
+    sort: GridSortState;
+    columns?: GridColumnState[];
+};
+export type SpreadsheetGridHandle<T> = {
+    scrollToRow: (viewRowIndex: number, options?: {
+        align?: ScrollAlign;
+    }) => void;
+    scrollToCell: (viewRowIndex: number, colIndex: number, options?: {
+        align?: ScrollAlign;
+    }) => void;
+    scrollToTop: () => void;
+    scrollToBottom: () => void;
+    getVisibleRowRange: () => {
+        startIndex: number;
+        endIndex: number;
+    } | null;
+    getActiveCell: () => CellCoord | null;
+    setActiveCell: (cell: CellCoord | null, options?: {
+        scrollIntoView?: boolean;
+    }) => void;
+    getSelection: () => GridSelection;
+    selectCell: (viewRowIndex: number, colIndex: number, options?: {
+        scrollIntoView?: boolean;
+    }) => void;
+    selectRange: (range: CellRange, options?: {
+        scrollIntoView?: boolean;
+    }) => void;
+    clearSelection: () => void;
+    getSelectedRows: () => T[];
+    exportCsv: (options?: CsvExportOptions) => string;
+    downloadCsv: (filename?: string, options?: CsvExportOptions) => void;
+    getState: () => GridState;
+    applyState: (state: GridState) => void;
+};
 export type SpreadsheetGridProps<T> = {
+    ref?: Ref<SpreadsheetGridHandle<T>>;
+    onStateChange?: (state: GridState) => void;
     rows?: T[];
     dataSource?: ServerSideDataSource<T>;
     serverSideRefreshToken?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ishibashi0112/spreadsheet-grid",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "React 19 製のカスタム仮想化データグリッド。100 万行対応の仮想化・3 ペイン固定列・ソート/フィルター・クライアント/サーバーサイド行モデル対応。",
   "keywords": [
     "react",