@zengrid/core 1.0.1

package/dist/src/rendering/cache/renderer-cache.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-cache.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cache/renderer-cache.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAElD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAErD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH"}

package/dist/src/rendering/cell-pool/cell-pool.d.ts

@@ -0,0 +1,36 @@
+import type { CellPool as ICellPool, CellPoolOptions, CellPoolStats } from './cell-pool.interface';
+/**
+ * CellPool - DOM element pooling for performance
+ *
+ * Maintains a pool of reusable cell DOM elements to avoid
+ * expensive creation/destruction during scrolling.
+ *
+ * @example
+ * ```typescript
+ * const container = document.querySelector('.zg-cells');
+ * const pool = new CellPool({ container, initialSize: 100 });
+ *
+ * // Acquire cell
+ * const cell = pool.acquire('0-0');
+ * cell.style.left = '0px';
+ * cell.style.top = '0px';
+ *
+ * // Release when scrolled out
+ * pool.release('0-0');
+ * ```
+ */
+export declare class CellPool implements ICellPool {
+    private container;
+    private active;
+    private pool;
+    private maxSize;
+    constructor(options: CellPoolOptions);
+    acquire(key: string): HTMLElement;
+    release(key: string): void;
+    releaseExcept(activeKeys: Set<string>): void;
+    get stats(): CellPoolStats;
+    clear(): void;
+    private createElement;
+    private resetElement;
+}
+//# sourceMappingURL=cell-pool.d.ts.map

package/dist/src/rendering/cell-pool/cell-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-pool.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cell-pool/cell-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,IAAI,SAAS,EACrB,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAS,YAAW,SAAS;IACxC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,eAAe;IAWpC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAmBjC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAkB1B,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAe5C,IAAI,KAAK,IAAI,aAAa,CAMzB;IAED,KAAK,IAAI,IAAI;IAcb,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/src/rendering/cell-pool/cell-pool.interface.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Options for creating a CellPool
+ */
+export interface CellPoolOptions {
+    /**
+     * Parent container element for pooled cells
+     */
+    container: HTMLElement;
+    /**
+     * Number of cells to pre-create
+     * @default 100
+     */
+    initialSize?: number;
+    /**
+     * Maximum number of cells to keep in pool
+     * Excess cells are removed from DOM
+     * @default 500
+     */
+    maxSize?: number;
+}
+/**
+ * Pool statistics
+ */
+export interface CellPoolStats {
+    /**
+     * Number of cells currently in use
+     */
+    active: number;
+    /**
+     * Number of cells available in pool
+     */
+    pooled: number;
+    /**
+     * Total number of cells (active + pooled)
+     */
+    total: number;
+}
+/**
+ * CellPool interface
+ *
+ * Manages a pool of reusable DOM elements for cells.
+ * Reduces DOM creation/destruction overhead during scrolling.
+ */
+export interface CellPool {
+    /**
+     * Acquire a cell element from the pool
+     * Returns existing active cell if already acquired with this key
+     *
+     * @param key - Unique cell identifier (e.g., "row-col")
+     * @returns DOM element for the cell
+     */
+    acquire(key: string): HTMLElement;
+    /**
+     * Release a cell back to the pool
+     * Cleans up the element and makes it available for reuse
+     *
+     * @param key - Cell identifier
+     */
+    release(key: string): void;
+    /**
+     * Release all cells except those in the provided set
+     * Useful for releasing cells that scrolled out of view
+     *
+     * @param activeKeys - Set of keys to keep active
+     */
+    releaseExcept(activeKeys: Set<string>): void;
+    /**
+     * Get pool statistics
+     */
+    readonly stats: CellPoolStats;
+    /**
+     * Clear all cells from pool and DOM
+     */
+    clear(): void;
+}
+//# sourceMappingURL=cell-pool.interface.d.ts.map

package/dist/src/rendering/cell-pool/cell-pool.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-pool.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cell-pool/cell-pool.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;IAElC;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/src/rendering/cell-pool/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CellPool - DOM element pooling for performance
+ */
+export type { CellPoolOptions, CellPoolStats } from './cell-pool.interface';
+export { CellPool } from './cell-pool';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rendering/cell-pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cell-pool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/rendering/cell-positioner/cell-positioner.d.ts

@@ -0,0 +1,46 @@
+import type { CellPositioner as ICellPositioner, CellPositionerOptions } from './cell-positioner.interface';
+import type { CellRef } from '../../types';
+/**
+ * CellPositioner - Orchestrates cell rendering
+ *
+ * Coordinates VirtualScroller, CellPool, and RendererRegistry
+ * to efficiently render only visible cells.
+ *
+ * @example
+ * ```typescript
+ * const positioner = new CellPositioner({
+ *   scroller: virtualScroller,
+ *   pool: cellPool,
+ *   registry: rendererRegistry,
+ *   getData: (row, col) => data[row][col],
+ *   getColumn: (col) => columns[col],
+ * });
+ *
+ * // Render on scroll
+ * viewport.addEventListener('scroll', (e) => {
+ *   positioner.renderVisibleCells(e.target.scrollTop, e.target.scrollLeft);
+ * });
+ * ```
+ */
+export declare class CellPositioner implements ICellPositioner {
+    private scroller;
+    private pool;
+    private registry;
+    private cache;
+    private getData;
+    private getRowData;
+    private getColumn;
+    private isSelected;
+    private isActive;
+    private isEditing;
+    private lastRange;
+    private renderedCells;
+    constructor(options: CellPositionerOptions);
+    renderVisibleCells(scrollTop: number, scrollLeft: number): void;
+    updateCells(cells: CellRef[]): void;
+    refresh(): void;
+    destroy(): void;
+    private renderCell;
+    private getCellKey;
+}
+//# sourceMappingURL=cell-positioner.d.ts.map

package/dist/src/rendering/cell-positioner/cell-positioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-positioner.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cell-positioner/cell-positioner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,IAAI,eAAe,EACjC,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAC;AAIzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,UAAU,CAAmD;IACrE,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,SAAS,CAAkD;IAEnE,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,aAAa,CAAkC;gBAE3C,OAAO,EAAE,qBAAqB;IAa1C,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA0B/D,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IASnC,OAAO,IAAI,IAAI;IAWf,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,UAAU;IAmGlB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/src/rendering/cell-positioner/cell-positioner.interface.d.ts

@@ -0,0 +1,86 @@
+import type { CellRef, ColumnDef } from '../../types';
+import type { VirtualScroller } from '../virtual-scroller';
+import type { CellPool } from '../cell-pool';
+import type { RendererRegistry } from '../renderers';
+import type { IRendererCache } from '../cache';
+/**
+ * Options for creating a CellPositioner
+ */
+export interface CellPositionerOptions {
+    /**
+     * VirtualScroller instance for calculating visible ranges
+     */
+    scroller: VirtualScroller;
+    /**
+     * CellPool instance for element reuse
+     */
+    pool: CellPool;
+    /**
+     * RendererRegistry instance for renderer lookup
+     */
+    registry: RendererRegistry;
+    /**
+     * Renderer cache instance (optional)
+     */
+    cache?: IRendererCache;
+    /**
+     * Function to get cell data value
+     */
+    getData: (row: number, col: number) => any;
+    /**
+     * Function to get full row data (optional, for composite renderers)
+     */
+    getRowData?: (row: number) => any;
+    /**
+     * Function to get column definition (optional)
+     */
+    getColumn?: (col: number) => ColumnDef | undefined;
+    /**
+     * Function to check if cell is selected
+     * @default () => false
+     */
+    isSelected?: (row: number, col: number) => boolean;
+    /**
+     * Function to check if cell is active (has focus)
+     * @default () => false
+     */
+    isActive?: (row: number, col: number) => boolean;
+    /**
+     * Function to check if cell is being edited
+     * @default () => false
+     */
+    isEditing?: (row: number, col: number) => boolean;
+}
+/**
+ * CellPositioner interface
+ *
+ * Orchestrates cell rendering by coordinating VirtualScroller,
+ * CellPool, and RendererRegistry.
+ */
+export interface CellPositioner {
+    /**
+     * Render visible cells based on scroll position
+     * This is the main rendering entry point
+     *
+     * @param scrollTop - Vertical scroll position in pixels
+     * @param scrollLeft - Horizontal scroll position in pixels
+     */
+    renderVisibleCells(scrollTop: number, scrollLeft: number): void;
+    /**
+     * Update specific cells without re-rendering entire range
+     * Useful for selection changes, editing state, etc.
+     *
+     * @param cells - Array of cell references to update
+     */
+    updateCells(cells: CellRef[]): void;
+    /**
+     * Force refresh all currently visible cells
+     * Re-renders cells using their current renderers
+     */
+    refresh(): void;
+    /**
+     * Cleanup and release all resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=cell-positioner.interface.d.ts.map

package/dist/src/rendering/cell-positioner/cell-positioner.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-positioner.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cell-positioner/cell-positioner.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;IAE1B;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;IAE3C;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;IAElC;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;IAEnD;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAEnD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAEjD;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhE;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEpC;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/src/rendering/cell-positioner/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CellPositioner - Orchestrates cell rendering
+ */
+export type { CellPositionerOptions } from './cell-positioner.interface';
+export { CellPositioner } from './cell-positioner';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rendering/cell-positioner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cell-positioner/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/rendering/height-provider/height-provider.interface.d.ts

@@ -0,0 +1,62 @@
+/**
+ * HeightProvider interface for configurable row height calculation
+ *
+ * Provides a strategy pattern for calculating row heights and positions.
+ * Implementations can provide uniform heights, variable heights, or custom logic.
+ */
+export interface HeightProvider {
+    /**
+     * Get the height of a specific row
+     * @param index - Row index
+     * @returns Height in pixels
+     * @complexity O(1)
+     */
+    getHeight(index: number): number;
+    /**
+     * Get the Y offset where a row starts
+     * @param index - Row index
+     * @returns Offset in pixels from top
+     * @complexity O(1) for uniform, O(1) for variable (cached)
+     */
+    getOffset(index: number): number;
+    /**
+     * Get the total height of all rows
+     * @returns Total height in pixels
+     * @complexity O(1)
+     */
+    getTotalHeight(): number;
+    /**
+     * Find which row contains a given Y offset
+     * @param offset - Y position in pixels
+     * @returns Row index at that offset
+     * @complexity O(1) for uniform, O(log n) for variable
+     */
+    findIndexAtOffset(offset: number): number;
+    /**
+     * Update the height of a specific row (optional)
+     * @param index - Row index
+     * @param height - New height in pixels
+     * @complexity Varies by implementation
+     */
+    setHeight?(index: number, height: number): void;
+    /**
+     * Total number of rows
+     */
+    readonly length: number;
+}
+/**
+ * Options for creating a height provider
+ */
+export interface HeightProviderOptions {
+    /**
+     * Total number of rows
+     */
+    rowCount: number;
+    /**
+     * Height value(s):
+     * - number: uniform height for all rows
+     * - number[]: individual heights per row
+     */
+    height: number | number[];
+}
+//# sourceMappingURL=height-provider.interface.d.ts.map

package/dist/src/rendering/height-provider/height-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"height-provider.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/height-provider/height-provider.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;;;;OAKG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B"}

package/dist/src/rendering/height-provider/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * HeightProvider - Strategy pattern for row height calculation
+ */
+export type { HeightProvider, HeightProviderOptions } from './height-provider.interface';
+export { UniformHeightProvider } from './uniform-height-provider';
+export { VariableHeightProvider } from './variable-height-provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rendering/height-provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/height-provider/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/rendering/height-provider/uniform-height-provider.d.ts

@@ -0,0 +1,31 @@
+import type { HeightProvider } from './height-provider.interface';
+/**
+ * UniformHeightProvider - Fixed height for all rows
+ *
+ * Provides constant-time O(1) operations for all methods.
+ * Ideal for grids where all rows have the same height.
+ *
+ * @example
+ * ```typescript
+ * const provider = new UniformHeightProvider(30, 1000);
+ * provider.getHeight(0); // 30
+ * provider.getOffset(10); // 300
+ * provider.findIndexAtOffset(450); // 15
+ * ```
+ */
+export declare class UniformHeightProvider implements HeightProvider {
+    private rowHeight;
+    private rowCount;
+    /**
+     * Create a uniform height provider
+     * @param height - Height in pixels for all rows
+     * @param length - Total number of rows
+     */
+    constructor(height: number, length: number);
+    getHeight(index: number): number;
+    getOffset(index: number): number;
+    getTotalHeight(): number;
+    findIndexAtOffset(offset: number): number;
+    get length(): number;
+}
+//# sourceMappingURL=uniform-height-provider.d.ts.map

package/dist/src/rendering/height-provider/uniform-height-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniform-height-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/height-provider/uniform-height-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAY1C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAShC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAShC,cAAc,IAAI,MAAM;IAIxB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAYzC,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/src/rendering/height-provider/variable-height-provider.d.ts

@@ -0,0 +1,33 @@
+import type { HeightProvider } from './height-provider.interface';
+/**
+ * VariableHeightProvider - Variable heights using PrefixSumArray
+ *
+ * Supports different height for each row using prefix sums for efficient lookup.
+ * - O(1) for getHeight, getOffset, getTotalHeight
+ * - O(log n) for findIndexAtOffset (binary search)
+ * - O(n) for setHeight (updates all prefix sums after the changed index)
+ *
+ * @example
+ * ```typescript
+ * const heights = [30, 40, 50, 30, 60];
+ * const provider = new VariableHeightProvider(heights);
+ * provider.getHeight(2); // 50
+ * provider.getOffset(2); // 70 (30 + 40)
+ * provider.findIndexAtOffset(100); // 2
+ * ```
+ */
+export declare class VariableHeightProvider implements HeightProvider {
+    private heights;
+    /**
+     * Create a variable height provider
+     * @param heights - Array of heights for each row
+     */
+    constructor(heights: number[]);
+    getHeight(index: number): number;
+    getOffset(index: number): number;
+    getTotalHeight(): number;
+    findIndexAtOffset(offset: number): number;
+    setHeight(index: number, height: number): void;
+    get length(): number;
+}
+//# sourceMappingURL=variable-height-provider.d.ts.map

package/dist/src/rendering/height-provider/variable-height-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-height-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/height-provider/variable-height-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,OAAO,CAAiB;IAEhC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE;IAQ7B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC,cAAc,IAAI,MAAM;IAIxB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIzC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO9C,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/src/rendering/renderers/advanced-cell-renderer.d.ts

@@ -0,0 +1,105 @@
+import type { CellRenderer, RenderParams } from './renderer.interface';
+/**
+ * Composite element configuration
+ */
+export interface CompositeElement {
+    /**
+     * Element type
+     */
+    type: 'icon' | 'text' | 'badge' | 'custom';
+    /**
+     * Function to extract value from render params
+     */
+    getValue: (params: RenderParams) => any;
+    /**
+     * Additional CSS class
+     */
+    className?: string;
+    /**
+     * Custom renderer (for 'custom' type only)
+     */
+    renderer?: CellRenderer;
+}
+/**
+ * Conditional styling rule
+ */
+export interface ConditionalStyle {
+    /**
+     * Condition function
+     */
+    condition: (params: RenderParams) => boolean;
+    /**
+     * CSS class to apply when condition is true
+     */
+    className?: string;
+    /**
+     * Inline styles to apply when condition is true
+     */
+    style?: Partial<CSSStyleDeclaration>;
+}
+/**
+ * Options for AdvancedCellRenderer
+ */
+export interface AdvancedCellRendererOptions {
+    /**
+     * Composite elements to render
+     */
+    elements: CompositeElement[];
+    /**
+     * Conditional styling rules
+     */
+    conditions?: ConditionalStyle[];
+    /**
+     * Layout direction
+     * @default 'horizontal'
+     */
+    layout?: 'horizontal' | 'vertical';
+    /**
+     * Gap between elements in pixels
+     * @default 4
+     */
+    gap?: number;
+}
+/**
+ * AdvancedCellRenderer - Composite elements with conditional styling
+ *
+ * Supports rendering multiple elements in a single cell (icon + text + badge)
+ * and applying conditional styles based on cell value or state.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new AdvancedCellRenderer({
+ *   elements: [
+ *     {
+ *       type: 'icon',
+ *       getValue: (params) => params.rowData?.status === 'active' ? '✓' : '✗',
+ *     },
+ *     {
+ *       type: 'text',
+ *       getValue: (params) => params.value,
+ *     },
+ *     {
+ *       type: 'badge',
+ *       getValue: (params) => params.rowData?.count,
+ *     },
+ *   ],
+ *   conditions: [
+ *     {
+ *       condition: (params) => params.value < 0,
+ *       className: 'negative-value',
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+export declare class AdvancedCellRenderer implements CellRenderer {
+    private options;
+    constructor(options: AdvancedCellRendererOptions);
+    render(element: HTMLElement, params: RenderParams): void;
+    update(element: HTMLElement, params: RenderParams): void;
+    destroy(element: HTMLElement): void;
+    private createCompositeElement;
+    private updateCompositeElement;
+    private applyConditions;
+}
+//# sourceMappingURL=advanced-cell-renderer.d.ts.map

package/dist/src/rendering/renderers/advanced-cell-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-cell-renderer.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/renderers/advanced-cell-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE3C;;OAEG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,GAAG,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC;IAE7C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IAEnC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,OAAO,CAA8B;gBAEjC,OAAO,EAAE,2BAA2B;IAQhD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAkBxD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAexD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAMnC,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,eAAe;CAmBxB"}

package/dist/src/rendering/renderers/image-renderer.d.ts

@@ -0,0 +1,60 @@
+import type { CellRenderer, RenderParams } from './renderer.interface';
+/**
+ * Options for ImageRenderer
+ */
+export interface ImageRendererOptions {
+    /**
+     * Fallback image URL if primary image fails to load
+     */
+    fallbackSrc?: string;
+    /**
+     * CSS object-fit property
+     * @default 'contain'
+     */
+    fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+    /**
+     * Placeholder to show while image loads
+     * Can be a URL or 'skeleton' for skeleton loader
+     */
+    placeholder?: string;
+    /**
+     * Alt text for accessibility
+     * @default ''
+     */
+    alt?: string;
+}
+/**
+ * ImageRenderer - Image display with lazy loading
+ *
+ * Renders images with lazy loading, fallback support, and object-fit options.
+ * Handles both string URLs and object values with 'src' property.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new ImageRenderer({
+ *   fit: 'cover',
+ *   fallbackSrc: '/images/placeholder.png',
+ * });
+ * renderer.render(element, { value: 'https://example.com/image.jpg', ...otherParams });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using object value
+ * renderer.render(element, {
+ *   value: { src: 'https://example.com/image.jpg', alt: 'Product photo' },
+ *   ...otherParams
+ * });
+ * ```
+ */
+export declare class ImageRenderer implements CellRenderer {
+    private options;
+    constructor(options?: ImageRendererOptions);
+    render(element: HTMLElement, params: RenderParams): void;
+    update(element: HTMLElement, params: RenderParams): void;
+    destroy(element: HTMLElement): void;
+    private updateImage;
+    private extractSrc;
+    private extractAlt;
+}
+//# sourceMappingURL=image-renderer.d.ts.map

package/dist/src/rendering/renderers/image-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-renderer.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/renderers/image-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;IAE3D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,GAAE,oBAAyB;IAQ9C,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAsBxD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAWxD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKnC,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,UAAU;CAInB"}

package/dist/src/rendering/renderers/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cell Renderers - DOM-based cell content rendering
+ */
+export type { CellRenderer, RenderParams } from './renderer.interface';
+export { RendererRegistry } from './renderer-registry';
+export { TextRenderer } from './text-renderer';
+export { NumberRenderer } from './number-renderer';
+export type { NumberRendererOptions } from './number-renderer';
+export { ImageRenderer } from './image-renderer';
+export type { ImageRendererOptions } from './image-renderer';
+export { AdvancedCellRenderer } from './advanced-cell-renderer';
+export type { AdvancedCellRendererOptions, CompositeElement, ConditionalStyle, } from './advanced-cell-renderer';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rendering/renderers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/renderers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}