@zengrid/core 1.0.1

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

@@ -0,0 +1,71 @@
+import type { CellRenderer, RenderParams } from './renderer.interface';
+/**
+ * Options for NumberRenderer
+ */
+export interface NumberRendererOptions {
+    /**
+     * Locale for number formatting (e.g., 'en-US', 'de-DE')
+     * @default undefined (uses browser default)
+     */
+    locale?: string;
+    /**
+     * Minimum fraction digits
+     * @default 0
+     */
+    minimumFractionDigits?: number;
+    /**
+     * Maximum fraction digits
+     * @default 2
+     */
+    maximumFractionDigits?: number;
+    /**
+     * Number formatting style
+     * @default 'decimal'
+     */
+    style?: 'decimal' | 'currency' | 'percent';
+    /**
+     * Currency code (required if style is 'currency')
+     */
+    currency?: string;
+    /**
+     * CSS class for negative numbers
+     * @default 'zg-cell-negative'
+     */
+    negativeClass?: string;
+}
+/**
+ * NumberRenderer - Formatted number display
+ *
+ * Renders numbers with locale-aware formatting using Intl.NumberFormat.
+ * Supports decimal, currency, and percentage formats.
+ * Applies conditional styling for negative numbers.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new NumberRenderer({
+ *   minimumFractionDigits: 2,
+ *   maximumFractionDigits: 2,
+ * });
+ * renderer.render(element, { value: 1234.5, ...otherParams });
+ * // Displays: "1,234.50"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const currencyRenderer = new NumberRenderer({
+ *   style: 'currency',
+ *   currency: 'USD',
+ * });
+ * renderer.render(element, { value: 1234.5, ...otherParams });
+ * // Displays: "$1,234.50"
+ * ```
+ */
+export declare class NumberRenderer implements CellRenderer {
+    private formatter;
+    private negativeClass;
+    constructor(options?: NumberRendererOptions);
+    render(element: HTMLElement, params: RenderParams): void;
+    update(element: HTMLElement, params: RenderParams): void;
+    destroy(element: HTMLElement): void;
+}
+//# sourceMappingURL=number-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number-renderer.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/renderers/number-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,qBAA0B;IAU/C,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAKxD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAYxD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAIpC"}

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

@@ -0,0 +1,55 @@
+import type { CellRenderer } from './renderer.interface';
+/**
+ * RendererRegistry - Named renderer lookup
+ *
+ * Manages a collection of renderers by name for dynamic lookup.
+ * Provides a default text renderer for fallback.
+ *
+ * @example
+ * ```typescript
+ * const registry = new RendererRegistry();
+ * registry.register('number', new NumberRenderer());
+ * registry.register('image', new ImageRenderer());
+ *
+ * const renderer = registry.get('number'); // Returns NumberRenderer
+ * const fallback = registry.get('unknown'); // Returns TextRenderer (default)
+ * ```
+ */
+export declare class RendererRegistry {
+    private renderers;
+    private defaultRenderer;
+    constructor();
+    /**
+     * Register a renderer with a name
+     * @param name - Unique renderer name
+     * @param renderer - Renderer instance
+     */
+    register(name: string, renderer: CellRenderer): void;
+    /**
+     * Get a renderer by name
+     * @param name - Renderer name (undefined returns default)
+     * @returns Renderer instance or default if not found
+     */
+    get(name: string | undefined): CellRenderer;
+    /**
+     * Check if a renderer is registered
+     * @param name - Renderer name
+     * @returns True if registered
+     */
+    has(name: string): boolean;
+    /**
+     * Unregister a renderer
+     * @param name - Renderer name
+     * @returns True if unregistered, false if not found or is default
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get all registered renderer names
+     */
+    get names(): string[];
+    /**
+     * Clear all renderers except default
+     */
+    clear(): void;
+}
+//# sourceMappingURL=renderer-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-registry.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/renderers/renderer-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,eAAe,CAAe;;IAOtC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIpD;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY;IAK3C;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjC;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/src/rendering/renderers/renderer.interface.d.ts

@@ -0,0 +1,79 @@
+import type { CellRef, CellPosition, ColumnDef } from '../../types';
+/**
+ * Parameters passed to renderers for rendering a cell
+ */
+export interface RenderParams {
+    /**
+     * Cell coordinates
+     */
+    cell: CellRef;
+    /**
+     * Cell position and dimensions
+     */
+    position: CellPosition;
+    /**
+     * Cell data value
+     */
+    value: any;
+    /**
+     * Column definition (if available)
+     */
+    column?: ColumnDef;
+    /**
+     * Full row data (for composite renderers that need access to other columns)
+     */
+    rowData?: any;
+    /**
+     * Whether the cell is currently selected
+     */
+    isSelected: boolean;
+    /**
+     * Whether the cell is the active cell (has focus)
+     */
+    isActive: boolean;
+    /**
+     * Whether the cell is currently being edited
+     */
+    isEditing: boolean;
+}
+/**
+ * Cell renderer interface
+ *
+ * Renderers are responsible for displaying cell content in DOM elements.
+ * They support both initial render and incremental updates for performance.
+ */
+export interface CellRenderer {
+    /**
+     * Initial render into a DOM element
+     * Called when a cell is first displayed or when switching renderers
+     *
+     * @param element - DOM element to render into (from cell pool)
+     * @param params - Rendering parameters
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update an existing rendered element
+     * Called when cell value or state changes but renderer type remains the same
+     * Should be optimized for frequent calls (e.g., during scrolling)
+     *
+     * @param element - DOM element to update
+     * @param params - Updated rendering parameters
+     */
+    update(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Cleanup before element is returned to pool
+     * Called when cell is scrolled out of view
+     *
+     * @param element - DOM element to cleanup
+     */
+    destroy(element: HTMLElement): void;
+    /**
+     * Optional: Get CSS class to apply to the cell based on its state
+     * Useful for conditional styling
+     *
+     * @param params - Rendering parameters
+     * @returns CSS class name or undefined
+     */
+    getCellClass?(params: RenderParams): string | undefined;
+}
+//# sourceMappingURL=renderer.interface.d.ts.map

package/dist/src/rendering/renderers/renderer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/renderers/renderer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC;IAEX;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAEzD;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAEzD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAEpC;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;CACzD"}

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

@@ -0,0 +1,20 @@
+import type { CellRenderer, RenderParams } from './renderer.interface';
+/**
+ * TextRenderer - Default renderer for text content
+ *
+ * Displays cell values as plain text with automatic string coercion.
+ * Handles null/undefined values by displaying empty string.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new TextRenderer();
+ * renderer.render(element, { value: 'Hello', ...otherParams });
+ * ```
+ */
+export declare class TextRenderer implements CellRenderer {
+    render(element: HTMLElement, params: RenderParams): void;
+    update(element: HTMLElement, params: RenderParams): void;
+    destroy(element: HTMLElement): void;
+    private formatValue;
+}
+//# sourceMappingURL=text-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-renderer.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/renderers/text-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAKxD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAIxD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKnC,OAAO,CAAC,WAAW;CAIpB"}

package/dist/src/rendering/spatial-hit-tester.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Spatial Hit Tester using RTree
+ *
+ * Provides fast hit testing for finding cells at mouse/touch coordinates.
+ */
+import { type Rectangle } from '@zengrid/shared/data-structures/rtree';
+/**
+ * Cell reference
+ */
+export interface CellRef {
+    row: number;
+    col: number;
+}
+/**
+ * SpatialHitTester - Fast hit testing using RTree spatial index
+ *
+ * Maintains a spatial index of rendered cells for O(log n) hit testing.
+ *
+ * @example
+ * ```typescript
+ * const hitTester = new SpatialHitTester();
+ *
+ * // Register cells as they're rendered
+ * hitTester.registerCell(0, 0, { minX: 0, minY: 0, maxX: 100, maxY: 30 });
+ * hitTester.registerCell(0, 1, { minX: 100, minY: 0, maxX: 200, maxY: 30 });
+ *
+ * // Find cell at mouse position
+ * const cell = hitTester.getCellAtPoint(150, 15);
+ * // { row: 0, col: 1 }
+ * ```
+ */
+export declare class SpatialHitTester {
+    private spatialIndex;
+    private renderedCells;
+    /**
+     * Register a rendered cell with its screen coordinates
+     *
+     * @param row - Row index
+     * @param col - Column index
+     * @param rect - Bounding rectangle on screen
+     */
+    registerCell(row: number, col: number, rect: Rectangle): void;
+    /**
+     * Unregister a cell (e.g., when it scrolls out of view)
+     *
+     * @param row - Row index
+     * @param col - Column index
+     */
+    unregisterCell(row: number, col: number): void;
+    /**
+     * Find cell at mouse/touch coordinates
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @returns Cell reference or null if no cell at point
+     */
+    getCellAtPoint(x: number, y: number): CellRef | null;
+    /**
+     * Find all cells in a rectangular region (e.g., selection box)
+     *
+     * @param rect - Search rectangle
+     * @returns Array of cell references
+     */
+    getCellsInRect(rect: Rectangle): CellRef[];
+    /**
+     * Find cells near a point (for touch targets with margin)
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param maxDistance - Maximum distance in pixels
+     * @param maxResults - Maximum number of results
+     * @returns Array of nearest cells, sorted by distance
+     */
+    getCellsNear(x: number, y: number, maxDistance?: number, maxResults?: number): CellRef[];
+    /**
+     * Check if a cell is currently registered
+     *
+     * @param row - Row index
+     * @param col - Column index
+     * @returns true if cell is registered
+     */
+    hasCell(row: number, col: number): boolean;
+    /**
+     * Get the bounding rectangle of a registered cell
+     *
+     * @param row - Row index
+     * @param col - Column index
+     * @returns Bounding rectangle or null if not registered
+     */
+    getCellRect(row: number, col: number): Rectangle | null;
+    /**
+     * Clear all registered cells (e.g., on scroll or resize)
+     */
+    clear(): void;
+    /**
+     * Get statistics about the spatial index
+     */
+    getStats(): {
+        cellCount: number;
+        treeHeight: number;
+        nodeCount: number;
+    };
+    /**
+     * Generate unique cell ID
+     */
+    private getCellId;
+}
+//# sourceMappingURL=spatial-hit-tester.d.ts.map

package/dist/src/rendering/spatial-hit-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-hit-tester.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/rendering/spatial-hit-tester.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,aAAa,CAAqC;IAE1D;;;;;;OAMG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAc7D;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAU9C;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAOpD;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE;IAI1C;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,MAAW,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO,EAAE;IAM/F;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB;IAUD;;OAEG;IACH,OAAO,CAAC,SAAS;CAGlB"}

package/dist/src/rendering/virtual-scroller/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * VirtualScroller - Calculate visible ranges for virtual scrolling
+ */
+export type { VirtualScrollerOptions, CellPosition, } from './virtual-scroller.interface';
+export { VirtualScroller } from './virtual-scroller';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rendering/virtual-scroller/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/virtual-scroller/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,sBAAsB,EACtB,YAAY,GACb,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/rendering/virtual-scroller/virtual-scroller.d.ts

@@ -0,0 +1,56 @@
+import type { VirtualScroller as IVirtualScroller, VirtualScrollerOptions, CellPosition } from './virtual-scroller.interface';
+import type { HeightProvider } from '../height-provider';
+import type { WidthProvider } from '../width-provider';
+import type { VisibleRange } from '../../types';
+/**
+ * VirtualScroller implementation
+ *
+ * Calculates visible ranges for virtual scrolling with configurable height/width strategies.
+ * Uses PrefixSumArray (via providers) for efficient offset-to-index lookups.
+ *
+ * @example
+ * ```typescript
+ * const scroller = new VirtualScroller({
+ *   rowCount: 10000,
+ *   colCount: 20,
+ *   rowHeight: 30,
+ *   colWidth: 100,
+ *   viewportWidth: 800,
+ *   viewportHeight: 600,
+ * });
+ *
+ * const visible = scroller.calculateVisibleRange(1000, 0);
+ * // { startRow: 30, endRow: 53, startCol: 0, endCol: 10 }
+ * ```
+ */
+export declare class VirtualScroller implements IVirtualScroller {
+    private heightProvider;
+    private widthProvider;
+    private rows;
+    private cols;
+    private vpWidth;
+    private vpHeight;
+    private overscanRows;
+    private overscanCols;
+    constructor(options: VirtualScrollerOptions);
+    calculateVisibleRange(scrollTop: number, scrollLeft: number): VisibleRange;
+    getCellPosition(row: number, col: number): CellPosition;
+    getRowAtOffset(offset: number): number;
+    getColAtOffset(offset: number): number;
+    getRowOffset(row: number): number;
+    getColOffset(col: number): number;
+    getRowHeight(row: number): number;
+    getColWidth(col: number): number;
+    getTotalHeight(): number;
+    getTotalWidth(): number;
+    updateRowHeight(row: number, height: number): void;
+    updateColWidth(col: number, width: number): void;
+    setViewport(width: number, height: number): void;
+    get rowCount(): number;
+    get colCount(): number;
+    get viewportWidth(): number;
+    get viewportHeight(): number;
+    getWidthProvider(): WidthProvider;
+    getHeightProvider(): HeightProvider;
+}
+//# sourceMappingURL=virtual-scroller.d.ts.map

package/dist/src/rendering/virtual-scroller/virtual-scroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-scroller.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/virtual-scroller/virtual-scroller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,IAAI,gBAAgB,EACnC,sBAAsB,EACtB,YAAY,EACb,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,sBAAsB;IAiC3C,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY;IAkC1E,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY;IASvD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAItC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAItC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIjC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIjC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIjC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIhC,cAAc,IAAI,MAAM;IAIxB,aAAa,IAAI,MAAM;IAIvB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IASlD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAShD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQhD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,gBAAgB,IAAI,aAAa;IAIjC,iBAAiB,IAAI,cAAc;CAGpC"}

package/dist/src/rendering/virtual-scroller/virtual-scroller.interface.d.ts

@@ -0,0 +1,170 @@
+import type { HeightProvider } from '../height-provider';
+import type { WidthProvider } from '../width-provider';
+import type { VisibleRange } from '../../types';
+/**
+ * Options for creating a VirtualScroller
+ */
+export interface VirtualScrollerOptions {
+    /**
+     * Total number of rows
+     */
+    rowCount: number;
+    /**
+     * Total number of columns
+     */
+    colCount: number;
+    /**
+     * Viewport width in pixels
+     */
+    viewportWidth: number;
+    /**
+     * Viewport height in pixels
+     */
+    viewportHeight: number;
+    /**
+     * Custom height provider (optional)
+     * If not provided, auto-selected based on rowHeight
+     */
+    heightProvider?: HeightProvider;
+    /**
+     * Row height(s) - used if heightProvider not provided
+     * - number: uniform height for all rows
+     * - number[]: individual heights per row
+     * @default 30
+     */
+    rowHeight?: number | number[];
+    /**
+     * Custom width provider (optional)
+     * If not provided, auto-selected based on colWidth
+     */
+    widthProvider?: WidthProvider;
+    /**
+     * Column width(s) - used if widthProvider not provided
+     * - number: uniform width for all columns
+     * - number[]: individual widths per column
+     * @default 100
+     */
+    colWidth?: number | number[];
+    /**
+     * Number of rows to render beyond visible area (buffer)
+     * @default 3
+     */
+    overscanRows?: number;
+    /**
+     * Number of columns to render beyond visible area (buffer)
+     * @default 2
+     */
+    overscanCols?: number;
+}
+/**
+ * Cell position and dimensions
+ */
+export interface CellPosition {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * VirtualScroller interface
+ *
+ * Calculates which rows and columns are visible based on scroll position.
+ * Uses HeightProvider and WidthProvider strategies for flexible dimension handling.
+ */
+export interface VirtualScroller {
+    /**
+     * Calculate the visible range of rows and columns
+     * @param scrollTop - Vertical scroll position in pixels
+     * @param scrollLeft - Horizontal scroll position in pixels
+     * @returns Visible range with overscan buffer
+     */
+    calculateVisibleRange(scrollTop: number, scrollLeft: number): VisibleRange;
+    /**
+     * Get the position and dimensions of a specific cell
+     * @param row - Row index
+     * @param col - Column index
+     * @returns Cell position (x, y, width, height)
+     */
+    getCellPosition(row: number, col: number): CellPosition;
+    /**
+     * Find which row is at a given Y offset
+     * @param offset - Y position in pixels
+     * @returns Row index
+     */
+    getRowAtOffset(offset: number): number;
+    /**
+     * Find which column is at a given X offset
+     * @param offset - X position in pixels
+     * @returns Column index
+     */
+    getColAtOffset(offset: number): number;
+    /**
+     * Get the Y offset where a row starts
+     * @param row - Row index
+     * @returns Y offset in pixels
+     */
+    getRowOffset(row: number): number;
+    /**
+     * Get the X offset where a column starts
+     * @param col - Column index
+     * @returns X offset in pixels
+     */
+    getColOffset(col: number): number;
+    /**
+     * Get the height of a specific row
+     * @param row - Row index
+     * @returns Height in pixels
+     */
+    getRowHeight(row: number): number;
+    /**
+     * Get the width of a specific column
+     * @param col - Column index
+     * @returns Width in pixels
+     */
+    getColWidth(col: number): number;
+    /**
+     * Get the total height of all rows
+     * @returns Total height in pixels
+     */
+    getTotalHeight(): number;
+    /**
+     * Get the total width of all columns
+     * @returns Total width in pixels
+     */
+    getTotalWidth(): number;
+    /**
+     * Update the height of a specific row
+     * @param row - Row index
+     * @param height - New height in pixels
+     */
+    updateRowHeight(row: number, height: number): void;
+    /**
+     * Update the width of a specific column
+     * @param col - Column index
+     * @param width - New width in pixels
+     */
+    updateColWidth(col: number, width: number): void;
+    /**
+     * Update the viewport dimensions
+     * @param width - New viewport width
+     * @param height - New viewport height
+     */
+    setViewport(width: number, height: number): void;
+    /**
+     * Total number of rows
+     */
+    readonly rowCount: number;
+    /**
+     * Total number of columns
+     */
+    readonly colCount: number;
+    /**
+     * Viewport width in pixels
+     */
+    readonly viewportWidth: number;
+    /**
+     * Viewport height in pixels
+     */
+    readonly viewportHeight: number;
+}
+//# sourceMappingURL=virtual-scroller.interface.d.ts.map

package/dist/src/rendering/virtual-scroller/virtual-scroller.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-scroller.interface.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/virtual-scroller/virtual-scroller.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE9B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC;IAE3E;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;IAExD;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAElC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAElC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAElC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC;IAEzB;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC;IAExB;;;;OAIG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC"}

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

@@ -0,0 +1,7 @@
+/**
+ * WidthProvider - Strategy pattern for column width calculation
+ */
+export type { WidthProvider, WidthProviderOptions } from './width-provider.interface';
+export { UniformWidthProvider } from './uniform-width-provider';
+export { VariableWidthProvider } from './variable-width-provider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/width-provider/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { WidthProvider } from './width-provider.interface';
+/**
+ * UniformWidthProvider - Fixed width for all columns
+ *
+ * Provides constant-time O(1) operations for all methods.
+ * Ideal for grids where all columns have the same width.
+ *
+ * @example
+ * ```typescript
+ * const provider = new UniformWidthProvider(100, 50);
+ * provider.getWidth(0); // 100
+ * provider.getOffset(10); // 1000
+ * provider.findIndexAtOffset(550); // 5
+ * ```
+ */
+export declare class UniformWidthProvider implements WidthProvider {
+    private colWidth;
+    private colCount;
+    /**
+     * Create a uniform width provider
+     * @param width - Width in pixels for all columns
+     * @param length - Total number of columns
+     */
+    constructor(width: number, length: number);
+    getWidth(index: number): number;
+    getOffset(index: number): number;
+    getTotalWidth(): number;
+    findIndexAtOffset(offset: number): number;
+    get length(): number;
+}
+//# sourceMappingURL=uniform-width-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uniform-width-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/width-provider/uniform-width-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;OAIG;gBACS,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAYzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAS/B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAShC,aAAa,IAAI,MAAM;IAIvB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAYzC,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}