gp-grid-react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,211 @@
+import React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region ../core/src/types.d.ts
+type CellDataType = "text" | "number" | "boolean" | "date" | "dateString" | "dateTime" | "dateTimeString" | "object";
+type CellValue = string | number | boolean | Date | object | null;
+type Row = unknown;
+type SortDirection = "asc" | "desc";
+type SortModel = {
+  colId: string;
+  direction: SortDirection;
+};
+type FilterModel = Record<string, string>;
+interface ColumnDefinition {
+  field: string;
+  colId?: string;
+  cellDataType: CellDataType;
+  width: number;
+  headerName?: string;
+  editable?: boolean;
+  /** Renderer key for adapter lookup, or inline renderer function */
+  cellRenderer?: string;
+  editRenderer?: string;
+  headerRenderer?: string;
+}
+interface CellPosition {
+  row: number;
+  col: number;
+}
+interface CellRange {
+  startRow: number;
+  startCol: number;
+  endRow: number;
+  endCol: number;
+}
+interface DataSourceRequest {
+  pagination: {
+    pageIndex: number;
+    pageSize: number;
+  };
+  sort?: SortModel[];
+  filter?: FilterModel;
+}
+interface DataSourceResponse<TData = Row> {
+  rows: TData[];
+  totalRows: number;
+}
+interface DataSource<TData = Row> {
+  fetch(request: DataSourceRequest): Promise<DataSourceResponse<TData>>;
+}
+interface CreateSlotInstruction {
+  type: "CREATE_SLOT";
+  slotId: string;
+}
+interface DestroySlotInstruction {
+  type: "DESTROY_SLOT";
+  slotId: string;
+}
+interface AssignSlotInstruction {
+  type: "ASSIGN_SLOT";
+  slotId: string;
+  rowIndex: number;
+  rowData: Row;
+}
+interface MoveSlotInstruction {
+  type: "MOVE_SLOT";
+  slotId: string;
+  translateY: number;
+}
+interface SetActiveCellInstruction {
+  type: "SET_ACTIVE_CELL";
+  position: CellPosition | null;
+}
+interface SetSelectionRangeInstruction {
+  type: "SET_SELECTION_RANGE";
+  range: CellRange | null;
+}
+interface StartEditInstruction {
+  type: "START_EDIT";
+  row: number;
+  col: number;
+  initialValue: CellValue;
+}
+interface StopEditInstruction {
+  type: "STOP_EDIT";
+}
+interface CommitEditInstruction {
+  type: "COMMIT_EDIT";
+  row: number;
+  col: number;
+  value: CellValue;
+}
+interface SetContentSizeInstruction {
+  type: "SET_CONTENT_SIZE";
+  width: number;
+  height: number;
+}
+interface UpdateHeaderInstruction {
+  type: "UPDATE_HEADER";
+  colIndex: number;
+  column: ColumnDefinition;
+  sortDirection?: SortDirection;
+  sortIndex?: number;
+}
+interface StartFillInstruction {
+  type: "START_FILL";
+  sourceRange: CellRange;
+}
+interface UpdateFillInstruction {
+  type: "UPDATE_FILL";
+  targetRow: number;
+  targetCol: number;
+}
+interface CommitFillInstruction {
+  type: "COMMIT_FILL";
+  filledCells: Array<{
+    row: number;
+    col: number;
+    value: CellValue;
+  }>;
+}
+interface CancelFillInstruction {
+  type: "CANCEL_FILL";
+}
+interface DataLoadingInstruction {
+  type: "DATA_LOADING";
+}
+interface DataLoadedInstruction {
+  type: "DATA_LOADED";
+  totalRows: number;
+}
+interface DataErrorInstruction {
+  type: "DATA_ERROR";
+  error: string;
+}
+type GridInstruction = CreateSlotInstruction | DestroySlotInstruction | AssignSlotInstruction | MoveSlotInstruction | SetActiveCellInstruction | SetSelectionRangeInstruction | StartEditInstruction | StopEditInstruction | CommitEditInstruction | SetContentSizeInstruction | UpdateHeaderInstruction | StartFillInstruction | UpdateFillInstruction | CommitFillInstruction | CancelFillInstruction | DataLoadingInstruction | DataLoadedInstruction | DataErrorInstruction;
+interface CellRendererParams {
+  value: CellValue;
+  rowData: Row;
+  column: ColumnDefinition;
+  rowIndex: number;
+  colIndex: number;
+  isActive: boolean;
+  isSelected: boolean;
+  isEditing: boolean;
+}
+interface EditRendererParams extends CellRendererParams {
+  initialValue: CellValue;
+  onValueChange: (newValue: CellValue) => void;
+  onCommit: () => void;
+  onCancel: () => void;
+}
+interface HeaderRendererParams {
+  column: ColumnDefinition;
+  colIndex: number;
+  sortDirection?: SortDirection;
+  sortIndex?: number;
+  onSort: (direction: SortDirection | null, addToExisting: boolean) => void;
+}
+//#endregion
+//#region ../core/src/data-source.d.ts
+/**
+ * Creates a client-side data source that holds all data in memory.
+ * Sorting and filtering are performed client-side.
+ */
+declare function createClientDataSource<TData extends Row = Row>(data: TData[], options?: {
+  /** Custom field accessor for nested properties */
+  getFieldValue?: (row: TData, field: string) => CellValue;
+}): DataSource<TData>;
+type ServerFetchFunction<TData> = (request: DataSourceRequest) => Promise<DataSourceResponse<TData>>;
+/**
+ * Creates a server-side data source that delegates all operations to the server.
+ * The fetch function receives sort/filter/pagination params to pass to the API.
+ */
+declare function createServerDataSource<TData extends Row = Row>(fetchFn: ServerFetchFunction<TData>): DataSource<TData>;
+/**
+ * Convenience function to create a data source from an array.
+ * This provides backwards compatibility with the old `rowData` prop.
+ */
+declare function createDataSourceFromArray<TData extends Row = Row>(data: TData[]): DataSource<TData>;
+//#endregion
+//#region src/Grid.d.ts
+type ReactCellRenderer = (params: CellRendererParams) => React.ReactNode;
+type ReactEditRenderer = (params: EditRendererParams) => React.ReactNode;
+type ReactHeaderRenderer = (params: HeaderRendererParams) => React.ReactNode;
+interface GridProps<TData extends Row = Row> {
+  columns: ColumnDefinition[];
+  /** Data source for the grid */
+  dataSource?: DataSource<TData>;
+  /** Legacy: Raw row data (will be wrapped in a client data source) */
+  rowData?: TData[];
+  rowHeight: number;
+  headerHeight?: number;
+  overscan?: number;
+  /** Show filter row below headers */
+  showFilters?: boolean;
+  /** Debounce time for filter input (ms) */
+  filterDebounce?: number;
+  /** Enable dark mode styling */
+  darkMode?: boolean;
+  cellRenderers?: Record<string, ReactCellRenderer>;
+  editRenderers?: Record<string, ReactEditRenderer>;
+  headerRenderers?: Record<string, ReactHeaderRenderer>;
+  cellRenderer?: ReactCellRenderer;
+  editRenderer?: ReactEditRenderer;
+  headerRenderer?: ReactHeaderRenderer;
+}
+declare function Grid<TData extends Row = Row>(props: GridProps<TData>): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { type CellDataType, type CellPosition, type CellRange, type CellRendererParams, type CellValue, type ColumnDefinition, type DataSource, type DataSourceRequest, type DataSourceResponse, type EditRendererParams, type FilterModel, Grid, type GridInstruction, type GridProps, type HeaderRendererParams, type ReactCellRenderer, type ReactEditRenderer, type ReactHeaderRenderer, type Row, type SortDirection, type SortModel, createClientDataSource, createDataSourceFromArray, createServerDataSource };
+//# sourceMappingURL=index.d.ts.map