@zengrid/core 1.0.1

package/dist/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@zengrid/core",
+  "version": "1.0.0",
+  "description": "High-performance data grid library with 14 advanced data structures and virtual scrolling",
+  "main": "./index.cjs.js",
+  "module": "./index.esm.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "module": "./index.esm.js",
+      "types": "./index.d.ts",
+      "import": "./index.cjs.mjs",
+      "default": "./index.cjs.js"
+    },
+    "./styles/*": "./dist/src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "grid",
+    "data-grid",
+    "table",
+    "spreadsheet",
+    "virtual-scroll",
+    "datagrid",
+    "angular",
+    "react",
+    "vue"
+  ],
+  "author": "ZenGrid Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Balaji2682/zengrid.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Balaji2682/zengrid/issues"
+  },
+  "homepage": "https://github.com/Balaji2682/zengrid#readme",
+  "dependencies": {
+    "@zengrid/shared": "^1.0.0"
+  },
+  "peerDependencies": {},
+  "devDependencies": {}
+}

package/dist/src/a11y/aria-manager.d.ts

@@ -0,0 +1,171 @@
+import type { CellRef, SortDirection } from '../types';
+/**
+ * ARIA Manager options
+ */
+export interface ARIAManagerOptions {
+    /**
+     * Grid container element
+     */
+    container: HTMLElement;
+    /**
+     * Total row count
+     */
+    rowCount: number;
+    /**
+     * Total column count
+     */
+    colCount: number;
+    /**
+     * Label for screen readers
+     * @default 'Data grid'
+     */
+    label?: string;
+    /**
+     * Description for screen readers
+     */
+    description?: string;
+    /**
+     * Enable live region announcements
+     * @default true
+     */
+    enableLiveRegion?: boolean;
+}
+/**
+ * ARIA Manager - Accessibility features for screen readers
+ *
+ * Implements WCAG 2.1 AA compliance through:
+ * - Proper ARIA roles (grid, gridcell, rowheader, columnheader)
+ * - Dynamic aria-rowindex and aria-colindex
+ * - aria-selected state management
+ * - aria-sort for sortable columns
+ * - Live region for announcements
+ *
+ * @example
+ * ```typescript
+ * const aria = new ARIAManager({
+ *   container: gridElement,
+ *   rowCount: 100000,
+ *   colCount: 10,
+ *   label: 'Employee data grid',
+ * });
+ *
+ * // Mark cell as selected
+ * aria.setCellSelected(cellElement, 0, 0, true);
+ *
+ * // Announce to screen reader
+ * aria.announce('Data loaded successfully');
+ *
+ * // Update sort indicator
+ * aria.setColumnSort(headerElement, 0, 'asc');
+ * ```
+ */
+export declare class ARIAManager {
+    private container;
+    private rowCount;
+    private colCount;
+    private liveRegion;
+    private announceTimeout;
+    constructor(options: ARIAManagerOptions);
+    /**
+     * Setup grid container ARIA roles and attributes
+     */
+    private setupGridRole;
+    /**
+     * Setup live region for screen reader announcements
+     */
+    private setupLiveRegion;
+    /**
+     * Set cell ARIA attributes
+     * @param element - Cell element
+     * @param row - Row index (0-based)
+     * @param col - Column index (0-based)
+     */
+    setCellAttributes(element: HTMLElement, row: number, col: number): void;
+    /**
+     * Set cell selected state
+     * @param element - Cell element
+     * @param row - Row index
+     * @param col - Column index
+     * @param selected - Selected state
+     */
+    setCellSelected(element: HTMLElement, row: number, col: number, selected: boolean): void;
+    /**
+     * Set header cell attributes
+     * @param element - Header element
+     * @param col - Column index
+     * @param label - Column label
+     */
+    setHeaderAttributes(element: HTMLElement, col: number, label: string): void;
+    /**
+     * Set row header attributes
+     * @param element - Row header element
+     * @param row - Row index
+     * @param label - Row label
+     */
+    setRowHeaderAttributes(element: HTMLElement, row: number, label: string): void;
+    /**
+     * Set column sort indicator
+     * @param element - Column header element
+     * @param col - Column index
+     * @param direction - Sort direction ('asc', 'desc', or null)
+     */
+    setColumnSort(element: HTMLElement, col: number, direction: SortDirection): void;
+    /**
+     * Set cell as editable
+     * @param element - Cell element
+     * @param editable - Whether cell is editable
+     */
+    setCellEditable(element: HTMLElement, editable: boolean): void;
+    /**
+     * Set cell as disabled
+     * @param element - Cell element
+     * @param disabled - Whether cell is disabled
+     */
+    setCellDisabled(element: HTMLElement, disabled: boolean): void;
+    /**
+     * Announce message to screen readers
+     * @param message - Message to announce
+     * @param priority - Announcement priority ('polite' or 'assertive')
+     */
+    announce(message: string, priority?: 'polite' | 'assertive'): void;
+    /**
+     * Update grid size
+     * @param rowCount - New row count
+     * @param colCount - New column count
+     */
+    updateSize(rowCount: number, colCount: number): void;
+    /**
+     * Set active cell (for keyboard navigation)
+     * @param element - Cell element
+     * @param cell - Cell reference
+     */
+    setActiveCell(element: HTMLElement, cell: CellRef): void;
+    /**
+     * Clear active cell
+     */
+    clearActiveCell(): void;
+    /**
+     * Announce range selection
+     * @param startRow - Start row (0-based)
+     * @param startCol - Start column (0-based)
+     * @param endRow - End row (0-based)
+     * @param endCol - End column (0-based)
+     */
+    announceRangeSelection(startRow: number, startCol: number, endRow: number, endCol: number): void;
+    /**
+     * Announce filter applied
+     * @param visibleRows - Number of visible rows
+     * @param totalRows - Total rows
+     */
+    announceFilter(visibleRows: number, totalRows: number): void;
+    /**
+     * Announce data load
+     * @param rowCount - Number of rows loaded
+     */
+    announceDataLoad(rowCount: number): void;
+    /**
+     * Destroy manager and cleanup
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=aria-manager.d.ts.map

package/dist/src/a11y/aria-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/a11y/aria-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,eAAe,CAAuB;gBAElC,OAAO,EAAE,kBAAkB;IAcvC;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IASvE;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAUxF;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO3E;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO9E;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IAYhF;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAQ9D;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI9D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAQ,GAAG,WAAsB,GAAG,IAAI;IAqB5E;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUpD;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAUxD;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;;;;;OAMG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAShG;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM5D;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,OAAO,IAAI,IAAI;CAmBhB"}

package/dist/src/a11y/focus-manager.d.ts

@@ -0,0 +1,124 @@
+import type { CellRef } from '../types';
+import type { ARIAManager } from './aria-manager';
+/**
+ * Focus Manager options
+ */
+export interface FocusManagerOptions {
+    /**
+     * Grid container element
+     */
+    container: HTMLElement;
+    /**
+     * ARIA manager instance
+     */
+    ariaManager?: ARIAManager;
+    /**
+     * Callback to get cell element
+     */
+    getCellElement: (row: number, col: number) => HTMLElement | null;
+    /**
+     * Callback when active cell changes
+     */
+    onActiveCellChange?: (cell: CellRef | null, previousCell: CellRef | null) => void;
+}
+/**
+ * FocusManager - Manages keyboard focus using roving tabindex pattern
+ *
+ * Implements the roving tabindex pattern for grid navigation:
+ * - Only one cell is focusable at a time (tabindex="0")
+ * - All other cells have tabindex="-1"
+ * - Arrow keys move focus between cells
+ * - Tab key exits the grid
+ *
+ * @example
+ * ```typescript
+ * const focus = new FocusManager({
+ *   container: gridElement,
+ *   getCellElement: (row, col) => document.getElementById(`cell-${row}-${col}`),
+ *   onActiveCellChange: (cell) => {
+ *     console.log('Active cell:', cell);
+ *   },
+ * });
+ *
+ * // Set active cell
+ * focus.setActiveCell({ row: 0, col: 0 });
+ *
+ * // Move focus
+ * focus.moveFocus('down'); // Moves to row 1
+ * focus.moveFocus('right'); // Moves to col 1
+ * ```
+ */
+export declare class FocusManager {
+    private container;
+    private ariaManager?;
+    private getCellElement;
+    private onActiveCellChange?;
+    private activeCell;
+    private focusedElement;
+    constructor(options: FocusManagerOptions);
+    /**
+     * Get current active cell
+     */
+    getActiveCell(): CellRef | null;
+    /**
+     * Set active cell and update focus
+     * @param cell - Cell to make active
+     * @param focus - Whether to actually focus the element (default true)
+     */
+    setActiveCell(cell: CellRef | null, focus?: boolean): void;
+    /**
+     * Move focus in a direction
+     * @param direction - Direction to move ('up', 'down', 'left', 'right')
+     * @param rowCount - Total row count
+     * @param colCount - Total column count
+     * @returns Whether focus moved successfully
+     */
+    moveFocus(direction: 'up' | 'down' | 'left' | 'right', rowCount: number, colCount: number): boolean;
+    /**
+     * Move focus by page (Page Up/Down)
+     * @param direction - 'up' or 'down'
+     * @param pageSize - Number of rows per page
+     * @param rowCount - Total row count
+     */
+    movePageFocus(direction: 'up' | 'down', pageSize: number, rowCount: number): boolean;
+    /**
+     * Move to first cell in row (Home)
+     */
+    moveToRowStart(): boolean;
+    /**
+     * Move to last cell in row (End)
+     * @param colCount - Total column count
+     */
+    moveToRowEnd(colCount: number): boolean;
+    /**
+     * Move to first cell in grid (Ctrl+Home)
+     */
+    moveToGridStart(): boolean;
+    /**
+     * Move to last cell in grid (Ctrl+End)
+     * @param rowCount - Total row count
+     * @param colCount - Total column count
+     */
+    moveToGridEnd(rowCount: number, colCount: number): boolean;
+    /**
+     * Focus the grid container
+     */
+    focusGrid(): void;
+    /**
+     * Check if grid or a cell has focus
+     */
+    hasFocus(): boolean;
+    /**
+     * Render focus ring on active cell
+     */
+    renderFocusRing(): void;
+    /**
+     * Clear focus
+     */
+    clearFocus(): void;
+    /**
+     * Destroy focus manager
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=focus-manager.d.ts.map

package/dist/src/a11y/focus-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/a11y/focus-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IAEjE;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;CACnF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,cAAc,CAAmD;IACzE,OAAO,CAAC,kBAAkB,CAAC,CAA+D;IAE1F,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,cAAc,CAA4B;gBAEtC,OAAO,EAAE,mBAAmB;IAOxC;;OAEG;IACH,aAAa,IAAI,OAAO,GAAG,IAAI;IAI/B;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,GAAE,OAAc,GAAG,IAAI;IAuDhE;;;;;;OAMG;IACH,SAAS,CACP,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC3C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO;IAgCV;;;;;OAKG;IACH,aAAa,CACX,SAAS,EAAE,IAAI,GAAG,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO;IAkBV;;OAEG;IACH,cAAc,IAAI,OAAO;IAQzB;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUvC;;OAEG;IACH,eAAe,IAAI,OAAO;IAQ1B;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAc1D;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAOnB;;OAEG;IACH,eAAe,IAAI,IAAI;IAOvB;;OAEG;IACH,UAAU,IAAI,IAAI;IAoBlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB"}

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

@@ -0,0 +1,8 @@
+/**
+ * Accessibility (a11y) features for ZenGrid
+ */
+export { ARIAManager } from './aria-manager';
+export type { ARIAManagerOptions } from './aria-manager';
+export { FocusManager } from './focus-manager';
+export type { FocusManagerOptions } from './focus-manager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/a11y/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/data/data-accessor/array-accessor.d.ts

@@ -0,0 +1,38 @@
+import type { DataAccessor } from './data-accessor.interface';
+/**
+ * DataAccessor adapter for 2D arrays
+ *
+ * Provides unified access to array-based data for sorting/filtering/searching.
+ */
+export declare class ArrayAccessor<T = any> implements DataAccessor<T> {
+    private data;
+    private _colCount;
+    constructor(data: T[][]);
+    getValue(row: number, col: number | string): T | undefined;
+    getRow(row: number): Iterable<[number, T]>;
+    getColumn(col: number | string): Iterable<[number, T]>;
+    get rowCount(): number;
+    get colCount(): number;
+    getColumnIds(): ReadonlyArray<number>;
+}
+/**
+ * Create a DataAccessor from a 2D array
+ *
+ * @param data - 2D array of data
+ * @returns DataAccessor instance
+ *
+ * @example
+ * ```typescript
+ * const data = [
+ *   ['Alice', 25, true],
+ *   ['Bob', 30, false],
+ *   ['Charlie', 35, true]
+ * ];
+ *
+ * const accessor = createArrayAccessor(data);
+ * accessor.getValue(0, 0); // 'Alice'
+ * accessor.getValue(1, 1); // 30
+ * ```
+ */
+export declare function createArrayAccessor<T>(data: T[][]): DataAccessor<T>;
+//# sourceMappingURL=array-accessor.d.ts.map

package/dist/src/data/data-accessor/array-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-accessor.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/data/data-accessor/array-accessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,CAAC,EAAE,EAAE;IAKvB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS;IAmB1D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAc1C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAuBtD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,YAAY,IAAI,aAAa,CAAC,MAAM,CAAC;CAGtC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAEnE"}

package/dist/src/data/data-accessor/column-store-accessor.d.ts

@@ -0,0 +1,41 @@
+import type { ColumnStore as IColumnStore } from '@zengrid/shared';
+import type { DataAccessor } from './data-accessor.interface';
+/**
+ * DataAccessor adapter for ColumnStore
+ *
+ * Provides unified access to column-oriented data for sorting/filtering/searching.
+ */
+export declare class ColumnStoreAccessor implements DataAccessor<any> {
+    private store;
+    constructor(store: IColumnStore);
+    getValue(row: number, col: number | string): any | undefined;
+    getRow(row: number): Iterable<[string, any]>;
+    getColumn(col: number | string): Iterable<[number, any]>;
+    get rowCount(): number;
+    get colCount(): number;
+    getColumnIds(): ReadonlyArray<string>;
+}
+/**
+ * Create a DataAccessor from a ColumnStore
+ *
+ * @param store - ColumnStore instance
+ * @returns DataAccessor instance
+ *
+ * @example
+ * ```typescript
+ * const store = new ColumnStore({
+ *   rowCount: 100,
+ *   columns: [
+ *     { name: 'id', type: 'int32' },
+ *     { name: 'name', type: 'string' },
+ *     { name: 'price', type: 'float64' }
+ *   ]
+ * });
+ *
+ * const accessor = createColumnStoreAccessor(store);
+ * accessor.getValue(0, 'name'); // Get by column name
+ * accessor.getValue(0, 1); // Get by column index
+ * ```
+ */
+export declare function createColumnStoreAccessor(store: IColumnStore): DataAccessor<any>;
+//# sourceMappingURL=column-store-accessor.d.ts.map

package/dist/src/data/data-accessor/column-store-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-store-accessor.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/data/data-accessor/column-store-accessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,YAAY,CAAC,GAAG,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAe;gBAEhB,KAAK,EAAE,YAAY;IAI/B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,GAAG,SAAS;IAY5D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAM5C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAWxD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,YAAY,IAAI,aAAa,CAAC,MAAM,CAAC;CAGtC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,GAClB,YAAY,CAAC,GAAG,CAAC,CAEnB"}

package/dist/src/data/data-accessor/data-accessor.interface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Abstraction layer for accessing grid data from different sources
+ *
+ * Enables sorting/filtering/searching to work with any data structure
+ * (SparseMatrix, ColumnStore, or plain arrays).
+ */
+export interface DataAccessor<T = any> {
+    /**
+     * Get value at specific cell
+     * @param row - Row index
+     * @param col - Column identifier (number for SparseMatrix, string for ColumnStore)
+     * @returns Cell value or undefined if not present
+     */
+    getValue(row: number, col: number | string): T | undefined;
+    /**
+     * Get all values in a row
+     * @param row - Row index
+     * @returns Iterable of [column, value] pairs
+     */
+    getRow(row: number): Iterable<[number | string, T]>;
+    /**
+     * Get all values in a column
+     * @param col - Column identifier
+     * @returns Iterable of [row, value] pairs
+     */
+    getColumn(col: number | string): Iterable<[number, T]>;
+    /**
+     * Total number of rows in data source
+     */
+    readonly rowCount: number;
+    /**
+     * Total number of columns
+     */
+    readonly colCount: number;
+    /**
+     * Get list of column identifiers
+     * @returns Array of column identifiers (numbers or strings)
+     */
+    getColumnIds(): ReadonlyArray<number | string>;
+}
+//# sourceMappingURL=data-accessor.interface.d.ts.map

package/dist/src/data/data-accessor/data-accessor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-accessor.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/data/data-accessor/data-accessor.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAE3D;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,YAAY,IAAI,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAChD"}

package/dist/src/data/data-accessor/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * DataAccessor - Unified interface for accessing different data sources
+ * @packageDocumentation
+ */
+export type { DataAccessor } from './data-accessor.interface';
+export { SparseMatrixAccessor, createSparseMatrixAccessor, } from './sparse-matrix-accessor';
+export { ColumnStoreAccessor, createColumnStoreAccessor, } from './column-store-accessor';
+export { ArrayAccessor, createArrayAccessor } from './array-accessor';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/data/data-accessor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/data/data-accessor/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/data/data-accessor/sparse-matrix-accessor.d.ts

@@ -0,0 +1,39 @@
+import type { ReadonlySparseMatrix } from '@zengrid/shared';
+import type { DataAccessor } from './data-accessor.interface';
+/**
+ * DataAccessor adapter for SparseMatrix
+ *
+ * Provides unified access to sparse matrix data for sorting/filtering/searching.
+ */
+export declare class SparseMatrixAccessor<T = any> implements DataAccessor<T> {
+    private matrix;
+    private _rowCount;
+    private _colCount;
+    constructor(matrix: ReadonlySparseMatrix<T>, rowCount: number, colCount: number);
+    getValue(row: number, col: number | string): T | undefined;
+    getRow(row: number): Iterable<[number, T]>;
+    getColumn(col: number | string): Iterable<[number, T]>;
+    get rowCount(): number;
+    get colCount(): number;
+    getColumnIds(): ReadonlyArray<number>;
+}
+/**
+ * Create a DataAccessor from a SparseMatrix
+ *
+ * @param matrix - Sparse matrix instance
+ * @param rowCount - Total number of rows (including empty rows)
+ * @param colCount - Total number of columns (including empty columns)
+ * @returns DataAccessor instance
+ *
+ * @example
+ * ```typescript
+ * const matrix = new SparseMatrix<number>();
+ * matrix.set(0, 1, 42);
+ * matrix.set(5, 3, 99);
+ *
+ * const accessor = createSparseMatrixAccessor(matrix, 10, 5);
+ * accessor.getValue(0, 1); // 42
+ * ```
+ */
+export declare function createSparseMatrixAccessor<T>(matrix: ReadonlySparseMatrix<T>, rowCount: number, colCount: number): DataAccessor<T>;
+//# sourceMappingURL=sparse-matrix-accessor.d.ts.map

package/dist/src/data/data-accessor/sparse-matrix-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse-matrix-accessor.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/data/data-accessor/sparse-matrix-accessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,oBAAoB,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAM/E,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS;IAS1D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAM1C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAWtD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,YAAY,IAAI,aAAa,CAAC,MAAM,CAAC;CAGtC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,YAAY,CAAC,CAAC,CAAC,CAEjB"}