@ishibashi0112/spreadsheet-grid 0.28.1 → 0.29.1

package/dist/model/gridTypes.d.ts

@@ -239,6 +239,13 @@ export type CellStyleContext<T> = {
     isEditing: boolean;
     readOnly: boolean;
 };
+export type RowStyleContext<T> = {
+    row: T;
+    rowIndex: number;
+    sourceRowIndex: number;
+    rowKey: GridRowKey;
+    isSelected: boolean;
+};
 export type CellRenderState = {
     isActive: boolean;
     isSelected: boolean;
@@ -362,7 +369,7 @@ export type GridColumn<T> = {
     valueFormatter?: CellValueFormatter<T>;
     renderHeader?: (ctx: HeaderRenderContext<T>) => ReactNode;
     filterType?: ColumnFilterTypeOption;
-    filterOptions?: GridSelectFilterOption[];
+    filterOptions?: readonly GridSelectFilterOption[];
     dateFilterPresets?: false | readonly DateFilterPresetOption[];
     filterFn?: (row: T, filterValue: unknown) => boolean;
     editor?: GridColumnEditor<T>;
@@ -502,6 +509,15 @@ export type GridClassNames = {
     iconButton?: string;
 };
 export type ScrollAlign = 'auto' | 'start' | 'center' | 'end';
+export type GridScrollPosition = {
+    top: number;
+    left: number;
+};
+export type GridScrollEventParams = {
+    top: number;
+    left: number;
+    source: 'user' | 'api';
+};
 /**
  * エクスポートの対象範囲です(exportCsv / downloadCsv / getExportData で共通)。
  * - `'view'`     : ビュー行全体(フィルター/ソート/列可視・固定順を反映)。**既定値**。スクロール位置に依存しません。
@@ -562,6 +578,13 @@ export type SpreadsheetGridHandle<T> = {
         startIndex: number;
         endIndex: number;
     } | null;
+    getScrollPosition: () => GridScrollPosition | null;
+    setScrollPosition: (position: {
+        top?: number;
+        left?: number;
+    }, options?: {
+        behavior?: 'auto' | 'smooth';
+    }) => void;
     getActiveCell: () => CellCoord | null;
     setActiveCell: (cell: CellCoord | null, options?: {
         scrollIntoView?: boolean;
@@ -622,12 +645,13 @@ export type ScrollHintOptions<T = unknown> = {
 export type SpreadsheetGridProps<T> = {
     ref?: Ref<SpreadsheetGridHandle<T>>;
     onStateChange?: (state: GridState) => void;
-    rows?: T[];
+    onScroll?: (params: GridScrollEventParams) => void;
+    rows?: readonly T[];
     dataSource?: ServerSideDataSource<T>;
     serverSideRefreshToken?: number;
     onServerSideLoadError?: (error: unknown, params: ServerSideLoadErrorParams) => void;
     onServerSideWriteError?: (error: unknown, params: ServerSideWriteErrorParams<T>) => void;
-    columns: GridColumn<T>[];
+    columns: readonly GridColumn<T>[];
     onRowsChange?: (nextRows: T[]) => void;
     onColumnsChange?: (nextColumns: GridColumn<T>[]) => void;
     rowKeyGetter?: (row: T, index: number) => GridRowKey;
@@ -683,7 +707,7 @@ export type SpreadsheetGridProps<T> = {
     renderBottomBar?: (context: SpreadsheetGridSlotContext<T>) => ReactNode;
     className?: string;
     classNames?: GridClassNames;
-    getRowClassName?: (row: T, rowIndex: number) => string | undefined;
+    getRowClassName?: (row: T, rowIndex: number, ctx: RowStyleContext<T>) => string | undefined;
     enableContextMenu?: boolean;
     getContextMenuItems?: (params: GridContextMenuParams<T>) => GridContextMenuItem[];
     onContextMenuOpen?: (params: GridContextMenuParams<T>) => void;

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+export type JsdomLayoutStubOptions = {
+    width?: number;
+    height?: number;
+};
+export declare function installJsdomLayoutStubs(options?: JsdomLayoutStubOptions): () => void;

package/dist/testing.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e={}){let t=e.width??1200,n=e.height??600,r=Element.prototype,i=HTMLElement.prototype,a=Object.getOwnPropertyDescriptor(i,`clientHeight`),o=Object.getOwnPropertyDescriptor(i,`clientWidth`),s=r.getBoundingClientRect,c=globalThis.ResizeObserver,l=r.scrollTo;Object.defineProperty(i,"clientHeight",{configurable:!0,get:()=>n}),Object.defineProperty(i,"clientWidth",{configurable:!0,get:()=>t}),r.getBoundingClientRect=()=>({x:0,y:0,top:0,left:0,bottom:n,right:t,width:t,height:n,toJSON:()=>({})});class u{callback;constructor(e){this.callback=e}observe(e){let r={inlineSize:t,blockSize:n};this.callback([{target:e,contentRect:{width:t,height:n,top:0,left:0},borderBoxSize:[r],contentBoxSize:[r]}],this)}unobserve(){}disconnect(){}}return globalThis.ResizeObserver=u,r.scrollTo||=()=>{},()=>{a?Object.defineProperty(i,"clientHeight",a):delete i.clientHeight,o?Object.defineProperty(i,"clientWidth",o):delete i.clientWidth,r.getBoundingClientRect=s,globalThis.ResizeObserver=c,r.scrollTo=l}}exports.installJsdomLayoutStubs=e;

package/dist/testing.js

@@ -0,0 +1,51 @@
+//#region src/components/spreadsheet-grid/testing/index.ts
+function e(e = {}) {
+	let t = e.width ?? 1200, n = e.height ?? 600, r = Element.prototype, i = HTMLElement.prototype, a = Object.getOwnPropertyDescriptor(i, "clientHeight"), o = Object.getOwnPropertyDescriptor(i, "clientWidth"), s = r.getBoundingClientRect, c = globalThis.ResizeObserver, l = r.scrollTo;
+	Object.defineProperty(i, "clientHeight", {
+		configurable: !0,
+		get: () => n
+	}), Object.defineProperty(i, "clientWidth", {
+		configurable: !0,
+		get: () => t
+	}), r.getBoundingClientRect = () => ({
+		x: 0,
+		y: 0,
+		top: 0,
+		left: 0,
+		bottom: n,
+		right: t,
+		width: t,
+		height: n,
+		toJSON: () => ({})
+	});
+	class u {
+		callback;
+		constructor(e) {
+			this.callback = e;
+		}
+		observe(e) {
+			let r = {
+				inlineSize: t,
+				blockSize: n
+			};
+			this.callback([{
+				target: e,
+				contentRect: {
+					width: t,
+					height: n,
+					top: 0,
+					left: 0
+				},
+				borderBoxSize: [r],
+				contentBoxSize: [r]
+			}], this);
+		}
+		unobserve() {}
+		disconnect() {}
+	}
+	return globalThis.ResizeObserver = u, r.scrollTo ||= () => {}, () => {
+		a ? Object.defineProperty(i, "clientHeight", a) : delete i.clientHeight, o ? Object.defineProperty(i, "clientWidth", o) : delete i.clientWidth, r.getBoundingClientRect = s, globalThis.ResizeObserver = c, r.scrollTo = l;
+	};
+}
+//#endregion
+export { e as installJsdomLayoutStubs };

package/dist/view/GridBodyLayer.d.ts

@@ -1,6 +1,6 @@
 import type { CSSProperties, PointerEvent, ReactNode } from 'react';
 import type { SelectionSnapshot } from '../model/gridSelectors';
-import type { CellCoord, CellRenderState, GridColumn, RowModel, RowSelectionState, SpreadsheetGridProps } from '../model/gridTypes';
+import type { CellCoord, CellRenderState, GridColumn, RowModel, RowSelectionState, RowStyleContext, SpreadsheetGridProps } from '../model/gridTypes';
 import type { PaneColumnEntry } from '../logic/geometry';
 import type { GridPaneKind } from './GridHeaderRow';
 type VirtualRowLike = {
@@ -40,7 +40,7 @@ type GridBodyLayerProps<T> = {
     onCellPointerEnter: (cell: CellCoord, event: PointerEvent<HTMLDivElement>) => void;
     onCellDoubleClick: (cell: CellCoord) => void;
     renderCellContent: (row: T, rowIndex: number, column: GridColumn<T>, colIndex: number, cellState: CellRenderState) => ReactNode;
-    getRowClassName?: (row: T, rowIndex: number) => string | undefined;
+    getRowClassName?: (row: T, rowIndex: number, ctx: RowStyleContext<T>) => string | undefined;
     bodyCellClassName?: string;
     bodyRowClassName?: string;
     rowHeaderCellClassName?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ishibashi0112/spreadsheet-grid",
-  "version": "0.28.1",
+  "version": "0.29.1",
   "description": "React 19 製のカスタム仮想化データグリッド。100 万行対応の仮想化・3 ペイン固定列・ソート/フィルター・クライアント/サーバーサイド行モデル対応。",
   "keywords": [
     "react",
@@ -40,6 +40,11 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.cjs"
+    },
     "./style.css": "./dist/style.css",
     "./style.layer.css": "./dist/style.layer.css"
   },