@zengrid/core 1.0.1

package/dist/src/i18n/locale-manager.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Locale configuration
+ */
+export interface LocaleConfig {
+    /**
+     * Locale code (e.g., 'en-US', 'ar-SA')
+     */
+    code: string;
+    /**
+     * Text direction
+     */
+    direction: 'ltr' | 'rtl';
+    /**
+     * Decimal separator
+     */
+    decimalSeparator: string;
+    /**
+     * Thousands separator
+     */
+    thousandsSeparator: string;
+    /**
+     * Date format
+     */
+    dateFormat: string;
+    /**
+     * Time format
+     */
+    timeFormat: string;
+    /**
+     * First day of week (0 = Sunday, 1 = Monday)
+     */
+    firstDayOfWeek: number;
+    /**
+     * Translations
+     */
+    translations?: Record<string, string>;
+}
+/**
+ * LocaleManager - Manages localization and formatting
+ *
+ * Provides locale-aware formatting for numbers, dates, and text.
+ * Supports custom locales and translations.
+ *
+ * @example
+ * ```typescript
+ * const locale = new LocaleManager('ar-SA');
+ *
+ * // Format number
+ * const formatted = locale.formatNumber(1234.56);
+ * // Returns: '١٬٢٣٤٫٥٦' (Arabic numerals)
+ *
+ * // Get direction
+ * const dir = locale.getDirection(); // 'rtl'
+ *
+ * // Translate string
+ * const text = locale.translate('loading');
+ * ```
+ */
+export declare class LocaleManager {
+    private locale;
+    private numberFormatter;
+    private dateFormatter;
+    constructor(localeCode?: string);
+    /**
+     * Get current locale code
+     */
+    getLocaleCode(): string;
+    /**
+     * Get text direction
+     */
+    getDirection(): 'ltr' | 'rtl';
+    /**
+     * Format a number
+     * @param value - Number to format
+     * @param options - Intl.NumberFormat options
+     */
+    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+    /**
+     * Format a date
+     * @param date - Date to format
+     * @param options - Intl.DateTimeFormat options
+     */
+    formatDate(date: Date, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Format currency
+     * @param value - Amount
+     * @param currency - Currency code (e.g., 'USD', 'EUR')
+     */
+    formatCurrency(value: number, currency: string): string;
+    /**
+     * Format percentage
+     * @param value - Percentage value (0-1)
+     */
+    formatPercent(value: number): string;
+    /**
+     * Get decimal separator
+     */
+    getDecimalSeparator(): string;
+    /**
+     * Get thousands separator
+     */
+    getThousandsSeparator(): string;
+    /**
+     * Get first day of week
+     */
+    getFirstDayOfWeek(): number;
+    /**
+     * Translate a string
+     * @param key - Translation key
+     * @param fallback - Fallback text if not found
+     */
+    translate(key: string, fallback?: string): string;
+    /**
+     * Register a custom locale
+     * @param config - Locale configuration
+     */
+    static registerLocale(config: LocaleConfig): void;
+    /**
+     * Get available locales
+     */
+    static getAvailableLocales(): string[];
+}
+//# sourceMappingURL=locale-manager.d.ts.map

package/dist/src/i18n/locale-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/i18n/locale-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IAEzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAgFD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,aAAa,CAAsB;gBAE/B,UAAU,GAAE,MAAgB;IAQxC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,YAAY,IAAI,KAAK,GAAG,KAAK;IAI7B;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM;IASvE;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM;IASpE;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IASvD;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUpC;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjD;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIjD;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,MAAM,EAAE;CAGvC"}

package/dist/src/i18n/rtl-support.d.ts

@@ -0,0 +1,120 @@
+/**
+ * RTL (Right-to-Left) support options
+ */
+export interface RTLSupportOptions {
+    /**
+     * Grid container element
+     */
+    container: HTMLElement;
+    /**
+     * Text direction
+     * @default 'ltr'
+     */
+    direction?: 'ltr' | 'rtl';
+    /**
+     * Auto-detect direction from document
+     * @default true
+     */
+    autoDetect?: boolean;
+    /**
+     * Callback when direction changes
+     */
+    onDirectionChange?: (direction: 'ltr' | 'rtl') => void;
+}
+/**
+ * RTLSupport - Manages Right-to-Left layout support
+ *
+ * Handles RTL layout for Arabic, Hebrew, Persian, and other RTL languages:
+ * - Direction detection and switching
+ * - RTL-aware column positioning
+ * - Scroll position normalization (browser compatibility)
+ * - Direction-aware hit testing
+ *
+ * @example
+ * ```typescript
+ * const rtl = new RTLSupport({
+ *   container: gridElement,
+ *   direction: 'rtl',
+ * });
+ *
+ * // Get direction-aware column offset
+ * const offset = rtl.getColumnOffset(col, totalWidth, colWidth);
+ *
+ * // Normalize scroll position
+ * const normalized = rtl.normalizeScrollLeft(scrollLeft, scrollWidth, clientWidth);
+ * ```
+ */
+export declare class RTLSupport {
+    private container;
+    private direction;
+    private onDirectionChange?;
+    constructor(options: RTLSupportOptions);
+    /**
+     * Get current text direction
+     */
+    getDirection(): 'ltr' | 'rtl';
+    /**
+     * Set text direction
+     * @param direction - New direction
+     */
+    setDirection(direction: 'ltr' | 'rtl'): void;
+    /**
+     * Check if RTL mode is active
+     */
+    isRTL(): boolean;
+    /**
+     * Get direction-aware column offset
+     * @param col - Column index
+     * @param totalWidth - Total grid width
+     * @param colOffsetLTR - Column offset in LTR mode
+     * @returns Direction-aware offset
+     */
+    getColumnOffset(_col: number, totalWidth: number, colOffsetLTR: number): number;
+    /**
+     * Normalize scroll position for RTL
+     *
+     * Different browsers handle RTL scrolling differently:
+     * - Chrome/Safari: scrollLeft is negative in RTL
+     * - Firefox: scrollLeft is positive but reversed
+     * - Edge: scrollLeft is positive
+     *
+     * This normalizes to always return positive values.
+     *
+     * @param scrollLeft - Raw scroll left value
+     * @param scrollWidth - Scroll container width
+     * @param clientWidth - Visible width
+     * @returns Normalized scroll position (always positive)
+     */
+    normalizeScrollLeft(scrollLeft: number, scrollWidth: number, clientWidth: number): number;
+    /**
+     * Denormalize scroll position for setting
+     * @param normalizedScrollLeft - Normalized scroll position
+     * @param scrollWidth - Scroll container width
+     * @param clientWidth - Visible width
+     * @returns Browser-specific scroll value
+     */
+    denormalizeScrollLeft(normalizedScrollLeft: number, scrollWidth: number, clientWidth: number): number;
+    /**
+     * Get direction-aware horizontal alignment
+     * @param align - Logical alignment ('start' or 'end')
+     * @returns Physical alignment ('left' or 'right')
+     */
+    getPhysicalAlignment(align: 'start' | 'end'): 'left' | 'right';
+    /**
+     * Apply direction to container
+     */
+    private applyDirection;
+    /**
+     * Detect text direction from document or language
+     */
+    private detectDirection;
+    /**
+     * Detect browser RTL scroll behavior
+     */
+    private detectScrollBehavior;
+    /**
+     * Destroy RTL support
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=rtl-support.d.ts.map

package/dist/src/i18n/rtl-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl-support.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/i18n/rtl-support.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,KAAK,IAAI,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,iBAAiB,CAAC,CAAqC;gBAEnD,OAAO,EAAE,iBAAiB;IAetC;;OAEG;IACH,YAAY,IAAI,KAAK,GAAG,KAAK;IAI7B;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI;IAW5C;;OAEG;IACH,KAAK,IAAI,OAAO;IAIhB;;;;;;OAMG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAS/E;;;;;;;;;;;;;;OAcG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IA0BzF;;;;;;OAMG;IACH,qBAAqB,CACnB,oBAAoB,EAAE,MAAM,EAC5B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,MAAM;IAsBT;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO;IAQ9D;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsC5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/src/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ZenGrid Core - Community Edition
+ * High-performance data grid library
+ *
+ * @packageDocumentation
+ */
+export * from './types';
+export { SparseMatrix } from '@zengrid/shared/data-structures/sparse-matrix';
+export type { SparseMatrixOptions, ReadonlySparseMatrix } from '@zengrid/shared/data-structures/sparse-matrix';
+export { ColumnStore } from '@zengrid/shared/data-structures/column-store';
+export type { ColumnStoreOptions, ColumnDefinition, ColumnType, AggregateOperation, AggregationResult } from '@zengrid/shared/data-structures/column-store';
+export type { HeightProvider, HeightProviderOptions } from './rendering/height-provider';
+export { UniformHeightProvider, VariableHeightProvider } from './rendering/height-provider';
+export type { WidthProvider, WidthProviderOptions } from './rendering/width-provider';
+export { UniformWidthProvider, VariableWidthProvider } from './rendering/width-provider';
+export type { VirtualScrollerOptions, CellPosition } from './rendering/virtual-scroller';
+export { VirtualScroller } from './rendering/virtual-scroller';
+export type { CellPoolOptions, CellPoolStats } from './rendering/cell-pool';
+export { CellPool } from './rendering/cell-pool';
+export type { CellPositionerOptions } from './rendering/cell-positioner';
+export { CellPositioner } from './rendering/cell-positioner';
+export type { CellRenderer, RenderParams } from './rendering/renderers';
+export { RendererRegistry, TextRenderer, NumberRenderer, ImageRenderer, AdvancedCellRenderer } from './rendering/renderers';
+export type { NumberRendererOptions, ImageRendererOptions, AdvancedCellRendererOptions, CompositeElement, ConditionalStyle, } from './rendering/renderers';
+export type { IRendererCache, RendererCacheConfig, CachedRenderContent } from './rendering/cache';
+export { RendererCache } from './rendering/cache';
+export type { DataAccessor } from './data/data-accessor';
+export type { IndexMap, IndexMapOptions } from './data/index-map';
+export { createIndexMap, createIdentityIndexMap } from './data/index-map';
+export type { RowSorter, SortOptions, NullPosition } from './features/sorting';
+export { SingleColumnSorter } from './features/sorting';
+export type { ColumnConstraints, ColumnResizeOptions, ResizeState, ResizeZoneResult, AutoFitCalculatorOptions, } from './features/column-resize';
+export { ColumnResizeManager, AutoFitCalculator, ResizeHandleRenderer, ResizePreview, } from './features/column-resize';
+export { normalizeRange, mergeRanges, containsCell, rangesIntersect } from './selection/range-utils';
+export { createHitTester } from './selection/hit-tester';
+export { Grid } from './grid';
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAE/G,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAG5J,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE5F,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC5H,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1E,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AA6B9B,eAAO,MAAM,OAAO,UAAU,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Keyboard navigation for ZenGrid
+ */
+export { KeyboardNavigator } from './keyboard-navigator';
+export type { KeyboardNavigatorOptions } from './keyboard-navigator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/keyboard/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/keyboard/keyboard-navigator.d.ts

@@ -0,0 +1,171 @@
+import type { CellRef } from '../types';
+import type { FocusManager } from '../a11y/focus-manager';
+import type { EventEmitter } from '../events/event-emitter';
+import type { GridEvents } from '../events/grid-events';
+/**
+ * Keyboard navigator options
+ */
+export interface KeyboardNavigatorOptions {
+    /**
+     * Grid container element
+     */
+    container: HTMLElement;
+    /**
+     * Focus manager instance
+     */
+    focusManager: FocusManager;
+    /**
+     * Event emitter for grid events
+     */
+    events?: EventEmitter<GridEvents>;
+    /**
+     * Total row count
+     */
+    rowCount: number;
+    /**
+     * Total column count
+     */
+    colCount: number;
+    /**
+     * Rows per page (for Page Up/Down)
+     * @default 20
+     */
+    pageSize?: number;
+    /**
+     * Enable selection with Shift+Arrow
+     * @default true
+     */
+    enableSelection?: boolean;
+    /**
+     * Enable editing with Enter/F2
+     * @default true
+     */
+    enableEditing?: boolean;
+    /**
+     * Callback to start editing
+     */
+    onStartEdit?: (cell: CellRef) => void;
+    /**
+     * Callback to cancel editing
+     */
+    onCancelEdit?: () => void;
+    /**
+     * Callback for copy (Ctrl+C)
+     */
+    onCopy?: () => void;
+    /**
+     * Callback for cut (Ctrl+X)
+     */
+    onCut?: () => void;
+    /**
+     * Callback for paste (Ctrl+V)
+     */
+    onPaste?: () => void;
+    /**
+     * Callback for select all (Ctrl+A)
+     */
+    onSelectAll?: () => void;
+}
+/**
+ * KeyboardNavigator - Handles all keyboard interactions
+ *
+ * Implements comprehensive keyboard navigation:
+ * - Arrow keys: Cell navigation
+ * - Page Up/Down: Page navigation
+ * - Home/End: Row navigation
+ * - Ctrl+Home/End: Grid navigation
+ * - Enter/F2: Start editing
+ * - Escape: Cancel editing
+ * - Tab/Shift+Tab: Navigate cells
+ * - Ctrl+C/V/X: Clipboard
+ * - Ctrl+A: Select all
+ * - Shift+Arrow: Range selection
+ *
+ * @example
+ * ```typescript
+ * const navigator = new KeyboardNavigator({
+ *   container: gridElement,
+ *   focusManager,
+ *   rowCount: 100000,
+ *   colCount: 10,
+ *   onStartEdit: (cell) => {
+ *     console.log('Start editing:', cell);
+ *   },
+ *   onCopy: () => {
+ *     console.log('Copy selected cells');
+ *   },
+ * });
+ *
+ * // Keyboard events are automatically handled
+ * // Call destroy() when done
+ * navigator.destroy();
+ * ```
+ */
+export declare class KeyboardNavigator {
+    private container;
+    private focusManager;
+    private events?;
+    private rowCount;
+    private colCount;
+    private pageSize;
+    private enableSelection;
+    private enableEditing;
+    private onStartEdit?;
+    private onCancelEdit?;
+    private onCopy?;
+    private onCut?;
+    private onPaste?;
+    private onSelectAll?;
+    private isSelecting;
+    private selectionStart;
+    constructor(options: KeyboardNavigatorOptions);
+    /**
+     * Attach keyboard event listeners
+     */
+    private attachEventListeners;
+    /**
+     * Handle keydown events
+     */
+    private handleKeyDown;
+    /**
+     * Handle navigation keys
+     */
+    private handleNavigationKey;
+    /**
+     * Handle clipboard keys
+     */
+    private handleClipboardKey;
+    /**
+     * Handle editing keys
+     */
+    private handleEditingKey;
+    /**
+     * Handle Tab navigation
+     */
+    private handleTabNavigation;
+    /**
+     * Start range selection
+     */
+    private startSelection;
+    /**
+     * Extend selection as focus moves
+     */
+    private handleSelectionExtend;
+    /**
+     * Handle keyup events
+     */
+    private handleKeyUp;
+    /**
+     * End range selection
+     */
+    private endSelection;
+    /**
+     * Update grid size
+     */
+    updateSize(rowCount: number, colCount: number): void;
+    /**
+     * Destroy keyboard navigator
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=keyboard-navigator.d.ts.map

package/dist/src/keyboard/keyboard-navigator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-navigator.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/keyboard/keyboard-navigator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAC,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,aAAa,CAAU;IAE/B,OAAO,CAAC,WAAW,CAAC,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAwB;gBAElC,OAAO,EAAE,wBAAwB;IAoB7C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,aAAa,CAmDnB;IAEF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiE3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,WAAW,CAiBjB;IAEF;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

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

@@ -0,0 +1,3 @@
+export { RendererCache } from './renderer-cache';
+export type { IRendererCache, RendererCacheConfig, CachedRenderContent, } from './renderer-cache.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,100 @@
+import type { IRendererCache, RendererCacheConfig, CachedRenderContent } from './renderer-cache.interface';
+/**
+ * RendererCache - Caches rendered cell content to improve performance
+ *
+ * Uses LRUCache to automatically evict least recently used entries.
+ * Reduces re-rendering by caching HTML content based on cell data.
+ *
+ * **Performance Benefits:**
+ * - 20-30% reduction in render time for repeated content
+ * - Smoother scrolling, especially with complex renderers
+ * - Lower CPU usage during scroll
+ *
+ * **Cache Key Strategy:**
+ * The cache key is generated from:
+ * - Cell value (serialized)
+ * - Renderer name
+ * - Column field (for uniqueness)
+ * - Selected/active/editing state
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const cache = new RendererCache({
+ *   capacity: 1000,
+ *   trackStats: true,
+ * });
+ *
+ * // Check cache before rendering
+ * const cached = cache.get(cacheKey);
+ * if (cached) {
+ *   element.innerHTML = cached.html;
+ * } else {
+ *   // Render and cache
+ *   renderer.render(element, params);
+ *   cache.set(cacheKey, { html: element.innerHTML });
+ * }
+ * ```
+ *
+ * @example With Statistics
+ * ```typescript
+ * const stats = cache.getStats();
+ * console.log(`Hit Rate: ${(stats.hitRate * 100).toFixed(2)}%`);
+ * console.log(`Cache Size: ${stats.size}/${stats.capacity}`);
+ * ```
+ */
+export declare class RendererCache implements IRendererCache {
+    private cache;
+    private config;
+    constructor(config?: RendererCacheConfig);
+    /**
+     * Get cached content for a cell
+     */
+    get(key: string): CachedRenderContent | undefined;
+    /**
+     * Set cached content for a cell
+     */
+    set(key: string, content: CachedRenderContent): void;
+    /**
+     * Check if content is cached
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all cached content
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        capacity: number;
+        hitRate: number;
+        hits: number;
+        misses: number;
+        evictions: number;
+    };
+    /**
+     * Generate cache key for a cell
+     *
+     * @param row - Row index
+     * @param col - Column index
+     * @param value - Cell value
+     * @param rendererName - Renderer name
+     * @param state - Cell state (selected, active, editing)
+     * @returns Cache key
+     */
+    static generateKey(_row: number, col: number, value: any, rendererName: string, state?: {
+        isSelected?: boolean;
+        isActive?: boolean;
+        isEditing?: boolean;
+    }): string;
+    /**
+     * Resize cache capacity
+     */
+    resize(newCapacity: number): void;
+    /**
+     * Enable or disable caching
+     */
+    setEnabled(enabled: boolean): void;
+}
+//# sourceMappingURL=renderer-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-cache.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/rendering/cache/renderer-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,MAAM,CAAgC;gBAElC,MAAM,GAAE,mBAAwB;IAgB5C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAOjD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAOpD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAOzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;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;IAYD;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GACA,MAAM;IAST;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAMnC"}

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

@@ -0,0 +1,89 @@
+/**
+ * Renderer Cache Configuration
+ */
+export interface RendererCacheConfig {
+    /**
+     * Whether to enable renderer caching
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Maximum number of cached entries
+     * @default 1000
+     */
+    capacity?: number;
+    /**
+     * Cache strategy
+     * @default 'lru'
+     */
+    strategy?: 'lru';
+    /**
+     * Time-to-live in milliseconds (0 = infinite)
+     * @default 0
+     */
+    ttl?: number;
+    /**
+     * Track cache statistics
+     * @default false
+     */
+    trackStats?: boolean;
+}
+/**
+ * Cached render content
+ */
+export interface CachedRenderContent {
+    /**
+     * The rendered HTML string
+     */
+    html: string;
+    /**
+     * CSS classes to apply
+     */
+    classes?: string[];
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * Renderer Cache Interface
+ */
+export interface IRendererCache {
+    /**
+     * Get cached content for a cell
+     *
+     * @param key - Cache key
+     * @returns Cached content or undefined
+     */
+    get(key: string): CachedRenderContent | undefined;
+    /**
+     * Set cached content for a cell
+     *
+     * @param key - Cache key
+     * @param content - Content to cache
+     */
+    set(key: string, content: CachedRenderContent): void;
+    /**
+     * Check if content is cached
+     *
+     * @param key - Cache key
+     * @returns True if cached
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all cached content
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        capacity: number;
+        hitRate: number;
+        hits: number;
+        misses: number;
+        evictions: number;
+    };
+}
+//# sourceMappingURL=renderer-cache.interface.d.ts.map