@zengrid/core 1.0.7 → 1.2.0

package/dist/src/types/grid.d.ts

@@ -0,0 +1,373 @@
+/**
+ * Grid configuration and state types
+ */
+import type { RendererCacheConfig } from '../rendering/cache';
+import type { OperationMode } from '@zengrid/shared';
+import type { CellRef, CellRange } from './cell';
+import type { ColumnDef, SortIcons } from './column';
+import type { SortState } from './sort';
+import type { FilterModel, FilterExpression } from './filter';
+import type { DataLoadRequest, DataLoadResponse } from './data';
+import type { PaginationConfig } from './pagination';
+import type { LoadingConfig } from './loading';
+import type { ZenGridTheme } from '../theming/theme.interface';
+/**
+ * Grid options
+ */
+export interface GridOptions {
+    rowCount: number;
+    colCount: number;
+    rowHeight: number | number[];
+    colWidth: number | number[];
+    columns?: ColumnDef[];
+    /**
+     * Theme to apply - a theme ID string (e.g. 'dark', 'material') or a full ZenGridTheme object
+     */
+    theme?: string | ZenGridTheme;
+    /**
+     * Automatically switch between light/dark themes based on prefers-color-scheme
+     * When enabled, uses 'light' theme for light mode and 'dark' theme for dark mode
+     */
+    autoTheme?: boolean;
+    enableSelection?: boolean;
+    enableMultiSelection?: boolean;
+    /**
+     * Selection type (cell, row, column, or range)
+     * @default 'cell'
+     */
+    selectionType?: 'cell' | 'row' | 'column' | 'range';
+    enableKeyboardNavigation?: boolean;
+    enableA11y?: boolean;
+    /** Number of rows to render beyond visible area (default: 10) - prevents blank areas during fast scrolling */
+    overscanRows?: number;
+    /** Number of columns to render beyond visible area (default: 5) - prevents blank areas during fast scrolling */
+    overscanCols?: number;
+    enableCellPooling?: boolean;
+    rendererCache?: RendererCacheConfig;
+    sortIcons?: SortIcons;
+    /**
+     * Data loading mode
+     * - 'frontend': All data loaded in memory (default)
+     * - 'backend': Data loaded on-demand via onDataRequest
+     * - 'auto': Use backend if onDataRequest provided, else frontend
+     */
+    dataMode?: OperationMode;
+    /**
+     * Sort mode
+     * - 'frontend': Sort in memory using IndexMap (default)
+     * - 'backend': Delegate sorting to server via onSortRequest
+     * - 'auto': Use backend if onSortRequest provided, else frontend
+     */
+    sortMode?: OperationMode;
+    /**
+     * Filter mode
+     * - 'frontend': Filter in memory (default)
+     * - 'backend': Delegate filtering to server via onFilterRequest
+     * - 'auto': Use backend if onFilterRequest provided, else frontend
+     */
+    filterMode?: OperationMode;
+    /**
+     * Backend data loading callback
+     * Called when dataMode is 'backend' or 'auto' (with callback present)
+     * Application should fetch data based on request parameters
+     */
+    onDataRequest?: (request: DataLoadRequest) => Promise<DataLoadResponse>;
+    /**
+     * Backend sorting callback
+     * Called when sortMode is 'backend' or 'auto' (with callback present)
+     * Application should fetch sorted data and call grid.setData()
+     */
+    onSortRequest?: (sortState: SortState[]) => Promise<void> | void;
+    /**
+     * Backend filtering callback
+     * Called when filterMode is 'backend' or 'auto' (with callback present)
+     * Application should fetch filtered data and call grid.setData()
+     *
+     * Receives FilterExpression which contains:
+     * - SQL query with parameters (if using SQL-like syntax)
+     * - Filter models (if using traditional approach)
+     *
+     * @example SQL-like filtering
+     * ```typescript
+     * onFilterRequest: async (filter) => {
+     *   if (filter.type === 'sql') {
+     *     // Backend receives: filter.sql = "age > ? AND status = ?"
+     *     // Backend receives: filter.params = [18, 'active']
+     *     const data = await api.get('/data', {
+     *       filter: filter.sql,
+     *       params: filter.params
+     *     });
+     *     grid.setData(data);
+     *   }
+     * }
+     * ```
+     */
+    onFilterRequest?: (filterExpression: FilterExpression) => Promise<void> | void;
+    /**
+     * Pagination configuration
+     */
+    pagination?: PaginationConfig;
+    /**
+     * Loading indicator configuration
+     */
+    loading?: LoadingConfig;
+    /**
+     * Automatically update viewport when container size changes (default: true)
+     * Uses ResizeObserver to detect changes from:
+     * - Window resize
+     * - Dev tools open/close
+     * - Sidebar collapse/expand
+     * - Parent container size changes
+     *
+     * Set to false for manual control via grid.updateViewport()
+     */
+    autoResize?: boolean;
+    /**
+     * Enable column resize feature (default: true)
+     */
+    enableColumnResize?: boolean;
+    /**
+     * Column resize configuration
+     */
+    columnResize?: {
+        /** Width of resize handle detection zone in pixels (default: 6) */
+        resizeZoneWidth?: number;
+        /** Default minimum width for all columns (default: 30) */
+        defaultMinWidth?: number;
+        /** Default maximum width for all columns (default: Infinity) */
+        defaultMaxWidth?: number;
+        /** Maximum rows to sample for auto-fit (default: 100) */
+        autoFitSampleSize?: number;
+        /** Padding to add to auto-fit width (default: 16) */
+        autoFitPadding?: number;
+        /** Skip header width when auto-fitting columns (default: false - headers included) */
+        skipHeaderOnAutoSize?: boolean;
+        /** Show visual resize handles (default: true) */
+        showHandles?: boolean;
+        /** Show preview line during drag (default: true) */
+        showPreview?: boolean;
+        /** Auto-fit all columns on initial load (default: false) */
+        autoFitOnLoad?: boolean;
+    };
+    /**
+     * Enable column drag and drop reordering (default: true)
+     */
+    enableColumnDrag?: boolean;
+    /**
+     * Column drag configuration
+     */
+    columnDrag?: {
+        /** Drag threshold in pixels before drag starts (default: 5) */
+        dragThreshold?: number;
+        /** Show ghost element during drag (default: true) */
+        showGhost?: boolean;
+        /** Show drop indicator (default: true) */
+        showDropIndicator?: boolean;
+        /** Show adjacent column highlights (default: true) */
+        showAdjacentHighlights?: boolean;
+        /** Enable touch support (default: true) */
+        enableTouch?: boolean;
+        /** Long press duration for touch in ms (default: 500) */
+        touchLongPressDuration?: number;
+        /** Enable keyboard navigation (default: true) */
+        enableKeyboard?: boolean;
+    };
+    /**
+     * Enable infinite scrolling (dynamic data loading)
+     */
+    infiniteScrolling?: {
+        /** Enable infinite scrolling (default: false) */
+        enabled?: boolean;
+        /** Number of rows from the bottom to trigger data loading (default: 20) */
+        threshold?: number;
+        /** Initial row count (will grow as more data loads) */
+        initialRowCount?: number;
+        /** Enable sliding window to limit memory usage (default: false) */
+        enableSlidingWindow?: boolean;
+        /** Maximum number of rows to keep in memory (default: 1000) */
+        windowSize?: number;
+        /** Row count threshold to trigger pruning old rows (default: windowSize + 200) */
+        pruneThreshold?: number;
+        /** Callback when old rows are pruned from memory */
+        onDataPruned?: (prunedRowCount: number, newVirtualOffset: number) => void;
+    };
+    /**
+     * Infinite scrolling data loader callback
+     * Called when user scrolls near the bottom and more data is needed
+     *
+     * @param currentRowCount - Current total rows in the grid
+     * @returns Promise resolving to new rows to append
+     *
+     * @example
+     * ```typescript
+     * onLoadMoreRows: async (currentRowCount) => {
+     *   const response = await fetch(`/api/data?offset=${currentRowCount}&limit=100`);
+     *   const newRows = await response.json();
+     *   return newRows;
+     * }
+     * ```
+     */
+    onLoadMoreRows?: (currentRowCount: number) => Promise<any[][]>;
+    /**
+     * Row height mode
+     * - 'fixed': All rows use fixed height from rowHeight option (default)
+     * - 'auto': Automatically measure and adjust row heights based on content
+     * - 'content-aware': Measure only rows with height-affecting columns
+     */
+    rowHeightMode?: 'fixed' | 'auto' | 'content-aware';
+    /**
+     * Row height configuration options
+     * Only applies when rowHeightMode is 'auto' or 'content-aware'
+     */
+    rowHeightConfig?: RowHeightConfig;
+    /**
+     * Global cell overflow configuration
+     * Can be overridden per-column via ColumnDef.overflow
+     */
+    cellOverflow?: CellOverflowConfig;
+    onScroll?: (scrollTop: number, scrollLeft: number) => void;
+    onCellClick?: (row: number, col: number) => void;
+    onCellDoubleClick?: (row: number, col: number) => void;
+    onCellContextMenu?: (row: number, col: number, event: MouseEvent) => void;
+    onSelectionChange?: (selection: CellRange[]) => void;
+    onPageChange?: (page: number, pageSize: number) => void;
+    onColumnWidthsChange?: (widths: number[]) => void;
+}
+/**
+ * Grid state
+ */
+export interface GridState {
+    data: any[][];
+    selection: CellRange[];
+    activeCell: CellRef | null;
+    sortState: SortState[];
+    filterState: FilterModel[];
+    scrollPosition: {
+        top: number;
+        left: number;
+    };
+    editingCell: CellRef | null;
+}
+/**
+ * Column state snapshot for persistence
+ */
+export interface ColumnStateSnapshot {
+    id?: string;
+    field?: string;
+    width?: number;
+    visible?: boolean;
+    order?: number;
+}
+/**
+ * Grid state snapshot for persistence
+ */
+export interface GridStateSnapshot {
+    columns?: ColumnStateSnapshot[];
+    sortState?: SortState[];
+    filterState?: FilterModel[];
+}
+/**
+ * Grid export options
+ */
+export interface GridExportOptions {
+    /** Rows to export */
+    rows?: 'all' | 'filtered' | 'selected' | number[];
+    /** Columns to export */
+    columns?: 'all' | 'visible' | number[];
+    /** Include header row */
+    includeHeaders?: boolean;
+    /** Custom delimiter (default: comma for CSV) */
+    delimiter?: string;
+}
+/**
+ * Row height configuration options
+ */
+export interface RowHeightConfig {
+    /**
+     * Default row height in pixels
+     * Used as initial estimate and fallback
+     * @default 30
+     */
+    defaultHeight?: number;
+    /**
+     * Minimum row height constraint in pixels
+     * @default 20
+     */
+    minHeight?: number;
+    /**
+     * Maximum row height constraint in pixels
+     * @default 200
+     */
+    maxHeight?: number;
+    /**
+     * When to measure row heights (for 'auto' mode)
+     * - 'render': Measure when row enters viewport (lazy, recommended)
+     * - 'scroll-end': Measure after scroll stops (debounced)
+     * - 'on-demand': Only measure via explicit API call
+     * @default 'render'
+     */
+    measureTiming?: 'render' | 'scroll-end' | 'on-demand';
+    /**
+     * Number of rows to measure per animation frame
+     * Lower = smoother but slower, Higher = faster but may cause jank
+     * @default 10
+     */
+    measureBatchSize?: number;
+    /**
+     * Debounce delay for batch height updates (in milliseconds)
+     * Prevents layout thrashing by batching multiple height changes
+     * @default 16 (approx 1 frame at 60fps)
+     */
+    debounceMs?: number;
+    /**
+     * Cache measured heights for performance
+     * Disable if content changes frequently
+     * @default true
+     */
+    cacheHeights?: boolean;
+    /**
+     * Columns that can affect row height (for 'content-aware' mode)
+     * Only these columns will be measured
+     * If undefined, all columns are considered
+     */
+    heightAffectingColumns?: string[];
+    /**
+     * Custom height calculator function
+     * Overrides automatic measurement
+     * @param row - Row index
+     * @param rowData - Full row data
+     * @returns Height in pixels
+     */
+    heightCalculator?: (row: number, rowData: any) => number;
+    /**
+     * Callback when row heights change
+     * Useful for persistence or synchronization
+     * @param heights - Map of row index to height
+     */
+    onHeightsChange?: (heights: Map<number, number>) => void;
+}
+/**
+ * Cell overflow configuration
+ */
+export interface CellOverflowConfig {
+    /**
+     * Overflow handling mode
+     * - 'clip': Hide overflow content (default)
+     * - 'ellipsis': Show ellipsis (...) for overflow
+     * - 'wrap': Allow text wrapping (multi-line)
+     * - 'expand': Expand row height to fit content (requires auto row height mode)
+     * - 'scroll': Enable horizontal scrolling
+     */
+    mode: 'clip' | 'ellipsis' | 'wrap' | 'expand' | 'scroll';
+    /**
+     * Maximum lines before truncation (only for 'wrap' mode)
+     * @default undefined (no limit)
+     */
+    maxLines?: number;
+    /**
+     * Show overflow indicator (e.g., "..." or scroll arrows)
+     * @default true
+     */
+    showIndicator?: boolean;
+}
+//# sourceMappingURL=grid.d.ts.map

package/dist/src/types/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/types/grid.ts"],"names":[],"mappings":"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"}

package/dist/src/types/header.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Header configuration types
+ */
+/**
+ * Header type discriminator
+ */
+export type HeaderType = 'text' | 'checkbox' | 'icon' | 'sortable' | 'filterable' | 'custom';
+/**
+ * Icon position within header
+ */
+export type IconPosition = 'leading' | 'trailing';
+/**
+ * Header icon configuration
+ */
+export interface HeaderIcon {
+    /** Icon content (HTML string, SVG, or emoji) */
+    content: string;
+    /** Icon position relative to text */
+    position: IconPosition;
+    /** Optional CSS class for the icon */
+    className?: string;
+    /** Optional click handler */
+    onClick?: (event: MouseEvent, columnIndex: number) => void;
+}
+/**
+ * Header tooltip configuration
+ */
+export interface HeaderTooltip {
+    /** Tooltip content (can be HTML) */
+    content: string;
+    /** Tooltip position */
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    /** Delay before showing (ms) */
+    delay?: number;
+}
+/**
+ * Header context menu item
+ */
+export interface HeaderContextMenuItem {
+    /** Menu item label */
+    label: string;
+    /** Menu item icon (optional) */
+    icon?: string;
+    /** Click handler */
+    action: (columnIndex: number) => void;
+    /** Whether item is disabled */
+    disabled?: boolean;
+    /** Separator after this item */
+    separator?: boolean;
+}
+/**
+ * Sort indicator configuration
+ */
+export interface SortIndicatorConfig {
+    /** Show sort indicator */
+    show: boolean;
+    /** Custom ascending icon */
+    ascIcon?: string;
+    /** Custom descending icon */
+    descIcon?: string;
+    /** Position of sort indicator */
+    position?: IconPosition;
+}
+/**
+ * Filter indicator configuration
+ */
+export interface FilterIndicatorConfig {
+    /** Show filter dropdown trigger */
+    show: boolean;
+    /** Custom filter icon */
+    icon?: string;
+    /** Filter dropdown component type */
+    dropdownType?: 'text' | 'select' | 'date' | 'number' | 'custom';
+    /** Custom dropdown renderer name (when dropdownType is 'custom') */
+    customDropdown?: string;
+}
+/**
+ * Full header configuration
+ */
+export interface HeaderConfig {
+    /** Header display text */
+    text: string;
+    /** Header type (determines default rendering behavior) */
+    type?: HeaderType;
+    /** Leading icon */
+    leadingIcon?: HeaderIcon;
+    /** Trailing icon */
+    trailingIcon?: HeaderIcon;
+    /** Tooltip configuration */
+    tooltip?: HeaderTooltip;
+    /** Additional CSS classes */
+    className?: string;
+    /** Inline styles */
+    style?: Partial<CSSStyleDeclaration>;
+    /** Click handler */
+    onClick?: (event: MouseEvent, columnIndex: number) => void;
+    /** Double-click handler */
+    onDoubleClick?: (event: MouseEvent, columnIndex: number) => void;
+    /** Context menu items */
+    contextMenu?: HeaderContextMenuItem[];
+    /** Sort indicator configuration */
+    sortIndicator?: SortIndicatorConfig;
+    /** Filter indicator configuration */
+    filterIndicator?: FilterIndicatorConfig;
+    /** Custom renderer name (for type: 'custom') */
+    renderer?: string;
+    /** Custom data passed to renderer */
+    rendererData?: any;
+    /** Whether header is interactive (enables hover/focus states) */
+    interactive?: boolean;
+}
+/**
+ * Resolved header config (after applying defaults)
+ */
+export interface ResolvedHeaderConfig extends Required<Pick<HeaderConfig, 'text' | 'type' | 'interactive'>> {
+    leadingIcon?: HeaderIcon;
+    trailingIcon?: HeaderIcon;
+    tooltip?: HeaderTooltip;
+    className?: string;
+    style?: Partial<CSSStyleDeclaration>;
+    onClick?: (event: MouseEvent, columnIndex: number) => void;
+    onDoubleClick?: (event: MouseEvent, columnIndex: number) => void;
+    contextMenu?: HeaderContextMenuItem[];
+    sortIndicator?: SortIndicatorConfig;
+    filterIndicator?: FilterIndicatorConfig;
+    renderer?: string;
+    rendererData?: any;
+}
+//# sourceMappingURL=header.d.ts.map

package/dist/src/types/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../src/types/header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,UAAU,GACV,MAAM,GACN,UAAU,GACV,YAAY,GACZ,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAChE,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,mBAAmB;IACnB,WAAW,CAAC,EAAE,UAAU,CAAC;IAEzB,oBAAoB;IACpB,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAErC,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3D,2BAA2B;IAC3B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjE,yBAAyB;IACzB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAEtC,mCAAmC;IACnC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,qCAAqC;IACrC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IAExC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,YAAY,CAAC,EAAE,GAAG,CAAC;IAEnB,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,QAAQ,CACpD,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,CACpD;IACC,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB"}

package/dist/src/types/index.d.ts

@@ -1,133 +1,14 @@
 /**
- * Core type definitions for ZenGrid
- */
-/**
- * Reference to a specific cell in the grid
- */
-export interface CellRef {
-    row: number;
-    col: number;
-}
-/**
- * A rectangular range of cells
- */
-export interface CellRange {
-    startRow: number;
-    startCol: number;
-    endRow: number;
-    endCol: number;
-}
-/**
- * The currently visible range after virtual scrolling calculation
- */
-export interface VisibleRange {
-    startRow: number;
-    endRow: number;
-    startCol: number;
-    endCol: number;
-}
-/**
- * Cell position and dimensions (for absolute positioning)
- */
-export interface CellPosition {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/**
- * Sort direction
- */
-export type SortDirection = 'asc' | 'desc' | null;
-/**
- * Sort state for a column
- */
-export interface SortState {
-    column: number;
-    direction: SortDirection;
-    sortIndex?: number;
-}
-/**
- * Filter operator types
- */
-export type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'blank' | 'notBlank';
-/**
- * Filter condition
- */
-export interface FilterCondition {
-    operator: FilterOperator;
-    value?: any;
-}
-/**
- * Filter model for a column
- */
-export interface FilterModel {
-    column: number;
-    conditions: FilterCondition[];
-    logic?: 'AND' | 'OR';
-}
-/**
- * Column definition
- */
-export interface ColumnDef {
-    field: string;
-    header: string;
-    width: number;
-    minWidth?: number;
-    maxWidth?: number;
-    resizable?: boolean;
-    sortable?: boolean;
-    filterable?: boolean;
-    editable?: boolean;
-    type?: 'text' | 'number' | 'date' | 'boolean';
-    renderer?: string;
-    editor?: string;
-    formatter?: (value: any) => string;
-    parser?: (value: string) => any;
-}
-/**
- * Grid configuration options
- */
-export interface GridOptions {
-    rowCount: number;
-    colCount: number;
-    columns?: ColumnDef[];
-    rowHeight: number | number[];
-    colWidth: number | number[];
-    headerHeight?: number;
-    enableSelection?: boolean;
-    enableMultiSelection?: boolean;
-    enableEditing?: boolean;
-    enableSorting?: boolean;
-    enableFiltering?: boolean;
-    enableKeyboardNavigation?: boolean;
-    enableA11y?: boolean;
-    locale?: string;
-    direction?: 'ltr' | 'rtl';
-    overscanRows?: number;
-    overscanCols?: number;
-    enableCellPooling?: boolean;
-    theme?: string;
-    customCSS?: string;
-    onCellClick?: (cell: CellRef) => void;
-    onCellDoubleClick?: (cell: CellRef) => void;
-    onCellChange?: (cell: CellRef, oldValue: any, newValue: any) => void;
-    onSelectionChange?: (ranges: CellRange[]) => void;
-    onScroll?: (scrollTop: number, scrollLeft: number) => void;
-}
-/**
- * Grid state (internal)
- */
-export interface GridState {
-    data: any[][];
-    selection: CellRange[];
-    activeCell: CellRef | null;
-    sortState: SortState[];
-    filterState: FilterModel[];
-    scrollPosition: {
-        top: number;
-        left: number;
-    };
-    editingCell: CellRef | null;
-}
+ * Core types for ZenGrid
+ * Re-exports all types from domain-specific modules
+ */
+export * from './cell';
+export * from './column';
+export * from './header';
+export * from './sort';
+export * from './filter';
+export * from './pagination';
+export * from './loading';
+export * from './data';
+export * from './grid';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}