@zengrid/core 1.0.6 → 1.1.0

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

@@ -39,11 +39,52 @@ export interface HeightProvider {
      * @complexity Varies by implementation
      */
     setHeight?(index: number, height: number): void;
+    /**
+     * Batch update multiple row heights efficiently (optional)
+     * More efficient than calling setHeight multiple times
+     * @param updates - Map of row index to new height
+     * @complexity Varies by implementation
+     */
+    batchSetHeight?(updates: Map<number, number>): void;
+    /**
+     * Subscribe to height changes (optional)
+     * @param callback - Function called when any height changes
+     * @returns Unsubscribe function
+     */
+    subscribe?(callback: (row: number, height: number) => void): () => void;
     /**
      * Total number of rows
      */
     readonly length: number;
 }
+/**
+ * Callback for height changes
+ */
+export type HeightChangeCallback = (row: number, height: number) => void;
+/**
+ * Extended interface for dynamic height providers
+ * Supports invalidation and measurement status
+ */
+export interface DynamicHeightProvider extends HeightProvider {
+    /**
+     * Mark a row for re-measurement
+     * @param row - Row index to invalidate
+     */
+    invalidate(row: number): void;
+    /**
+     * Mark all rows for re-measurement
+     */
+    invalidateAll(): void;
+    /**
+     * Get current measurement status
+     * @returns Object with measured, pending, and total counts
+     */
+    getMeasurementStatus(): {
+        measured: number;
+        pending: number;
+        total: number;
+    };
+}
 /**
  * Options for creating a height provider
  */

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

@@ -1 +1 @@
-{"version":3,"file":"height-provider.interface.d.ts","sourceRoot":"","sources":["../../../../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"}
+{"version":3,"file":"height-provider.interface.d.ts","sourceRoot":"","sources":["../../../../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;;;;;OAKG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAExE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,aAAa,IAAI,IAAI,CAAC;IAEtB;;;OAGG;IACH,oBAAoB,IAAI;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rendering/height-provider/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/src/rendering/height-provider/segment-tree-height-provider.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SegmentTreeHeightProvider - O(log n) height updates using Segment Tree
+ *
+ * Uses SegmentTree from @zengrid/shared for efficient height management:
+ * - O(log n) single height updates (vs O(n) with PrefixSumArray)
+ * - O(log n) batch updates for k rows
+ * - O(log n) offset-to-index lookups
+ * - O(1) total height queries
+ *
+ * Performance comparison (100,000 rows):
+ * - Single update: PrefixSumArray O(n) = ~100k operations, SegmentTree O(log n) = ~17 operations
+ * - Batch 100 updates: PrefixSumArray O(k*n) = ~10M operations, SegmentTree O(k log n) = ~1700 operations
+ *
+ * Ideal for auto row height mode where frequent height updates occur during scrolling.
+ */
+import type { HeightProvider, HeightChangeCallback } from './height-provider.interface';
+export declare class SegmentTreeHeightProvider implements HeightProvider {
+    private tree;
+    private heights;
+    private subscribers;
+    private rowCount;
+    /**
+     * Creates a new SegmentTreeHeightProvider
+     * @param rowCount - Total number of rows
+     * @param defaultHeight - Initial height for all rows
+     */
+    constructor(rowCount: number, defaultHeight: number);
+    /**
+     * 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
+     * Uses segment tree range query for prefix sum
+     * @param index - Row index
+     * @returns Offset in pixels from top
+     * @complexity O(log n)
+     */
+    getOffset(index: number): number;
+    /**
+     * Get the total height of all rows
+     * @returns Total height in pixels
+     * @complexity O(log n)
+     */
+    getTotalHeight(): number;
+    /**
+     * Find which row contains a given Y offset
+     * Uses binary search on cumulative offsets
+     * @param offset - Y position in pixels
+     * @returns Row index at that offset
+     * @complexity O(log n) - binary search with O(log n) getOffset queries
+     */
+    findIndexAtOffset(offset: number): number;
+    /**
+     * Update the height of a specific row
+     * @param index - Row index
+     * @param height - New height in pixels
+     * @complexity O(log n)
+     */
+    setHeight(index: number, height: number): void;
+    /**
+     * Batch update multiple row heights efficiently
+     * @param updates - Map of row index to new height
+     * @complexity O(k log n) for k updates
+     */
+    batchSetHeight(updates: Map<number, number>): void;
+    /**
+     * Subscribe to height changes
+     * @param callback - Function called when any height changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: HeightChangeCallback): () => void;
+    /**
+     * Notify all subscribers of a height change
+     * @param row - Row that changed
+     * @param height - New height
+     */
+    private notifySubscribers;
+    /**
+     * Total number of rows
+     */
+    get length(): number;
+}
+//# sourceMappingURL=segment-tree-height-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"segment-tree-height-provider.d.ts","sourceRoot":"","sources":["../../../../src/rendering/height-provider/segment-tree-height-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExF,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAmBnD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOhC;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAWhC;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAOxB;;;;;;OAMG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IA4BzC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAoB9C;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IA8BlD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAOrD;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"uniform-height-provider.d.ts","sourceRoot":"","sources":["../../../../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"}
+{"version":3,"file":"uniform-height-provider.d.ts","sourceRoot":"","sources":["../../../../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;IAOhC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOhC,cAAc,IAAI,MAAM;IAIxB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAYzC,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

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

@@ -1,4 +1,4 @@
-import type { CellRenderer, RenderParams } from './renderer.interface';
+import type { CellRenderer, RenderParams } from '../renderer.interface';
 /**
  * Composite element configuration
  */

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

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-cell-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/advanced-cell/advanced-cell-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;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;IAiBxD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAexD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAMnC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,eAAe;CAmBxB"}

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

@@ -0,0 +1,3 @@
+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/advanced-cell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/advanced-cell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,148 @@
+import type { CellRenderer, RenderParams } from '../renderer.interface';
+/**
+ * Configuration options for ButtonRenderer
+ */
+export interface ButtonRendererOptions {
+    /** Button label text (string or function that returns label based on params) */
+    label?: string | ((params: RenderParams) => string);
+    /** Custom CSS class for the button */
+    className?: string;
+    /** Callback when button is clicked (default: logs warning) */
+    onClick?: (params: RenderParams) => void;
+    /** Whether the button should be disabled (boolean or function) */
+    disabled?: boolean | ((params: RenderParams) => boolean);
+    /** Optional icon HTML or emoji to display before label */
+    icon?: string;
+    /** Button variant/type for styling */
+    variant?: 'button' | 'primary' | 'secondary' | 'danger' | 'success' | 'warning';
+    /** Button size */
+    size?: 'small' | 'medium' | 'large';
+}
+/**
+ * ButtonRenderer - Renders clickable action buttons in grid cells
+ *
+ * Features:
+ * - Clickable buttons with custom onClick handlers
+ * - Dynamic or static labels
+ * - Disabled state support (static or computed per row)
+ * - Optional icon support (emoji or HTML)
+ * - 6 button variants for different styles (button, primary, secondary, danger, success, warning)
+ * - 3 size variants (small, medium, large)
+ * - Full ARIA accessibility support
+ * - Efficient event handling with proper cleanup
+ * - Data attributes for debugging and testing
+ *
+ * Performance: Optimized for virtual scrolling with update() method
+ *
+ * @example
+ * ```typescript
+ * // Simple button
+ * const renderer = new ButtonRenderer({
+ *   label: 'Delete',
+ *   onClick: (params) => {
+ *     console.log('Delete row:', params.cell.row);
+ *   }
+ * });
+ *
+ * // Dynamic label based on row data
+ * const renderer = new ButtonRenderer({
+ *   label: (params) => params.rowData?.status === 'active' ? 'Deactivate' : 'Activate',
+ *   onClick: (params) => {
+ *     toggleStatus(params.rowData);
+ *   }
+ * });
+ *
+ * // With icon and disabled state
+ * const renderer = new ButtonRenderer({
+ *   label: 'Edit',
+ *   icon: '✏️',
+ *   variant: 'primary',
+ *   size: 'large',
+ *   disabled: (params) => params.rowData?.locked === true,
+ *   onClick: (params) => {
+ *     editRow(params.rowData);
+ *   }
+ * });
+ * ```
+ */
+export declare class ButtonRenderer implements CellRenderer {
+    private options;
+    private eventHandlers;
+    private currentParams;
+    /**
+     * Creates a new ButtonRenderer instance
+     *
+     * @param options - Configuration options for the button renderer
+     */
+    constructor(options?: ButtonRendererOptions);
+    /**
+     * Initial render - creates button structure
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update existing button - called on value/state changes
+     * Optimized for performance during scrolling
+     */
+    update(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Cleanup before element returns to pool
+     */
+    destroy(element: HTMLElement): void;
+    /**
+     * Optional: Return CSS class based on button state
+     */
+    getCellClass(params: RenderParams): string | undefined;
+    /**
+     * Get the button label text
+     */
+    private getLabel;
+    /**
+     * Check if the button is disabled
+     */
+    private isDisabled;
+    /**
+     * Apply button styles based on variant, size, and disabled state
+     */
+    private applyButtonStyles;
+    /**
+     * Get button padding based on size
+     */
+    private getButtonPadding;
+    /**
+     * Get button font size based on size
+     */
+    private getButtonFontSize;
+    /**
+     * Get button background color based on variant
+     */
+    private getButtonColor;
+    /**
+     * Get button text color based on variant
+     */
+    private getButtonTextColor;
+}
+/**
+ * Factory function to create a ButtonRenderer instance
+ *
+ * @example
+ * ```typescript
+ * // In column definition
+ * const column = {
+ *   field: 'action',
+ *   header: 'Actions',
+ *   renderer: 'button', // Registered name
+ * };
+ *
+ * // Or create directly
+ * const renderer = createButtonRenderer({
+ *   label: 'Delete',
+ *   variant: 'danger',
+ *   icon: '🗑️',
+ *   onClick: (params) => {
+ *     console.log('Delete row:', params.cell.row);
+ *   }
+ * });
+ * ```
+ */
+export declare function createButtonRenderer(options: ButtonRendererOptions): ButtonRenderer;
+//# sourceMappingURL=button-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"button-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/button/button-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,CAAC;IACpD,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACzC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC;IACzD,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAChF,kBAAkB;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,OAAO,CAOb;IACF,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,aAAa,CAAiC;IAEtD;;;;OAIG;gBACS,OAAO,GAAE,qBAA0B;IAwB/C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAqCxD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA2DxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAiBnC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IActD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAc3B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEnF"}

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

@@ -0,0 +1,3 @@
+export { ButtonRenderer, createButtonRenderer } from './button-renderer';
+export type { ButtonRendererOptions } from './button-renderer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/button/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,92 @@
+import type { CellRenderer, RenderParams } from '../renderer.interface';
+/**
+ * Configuration options for CheckboxRenderer
+ */
+export interface CheckboxRendererOptions {
+    /** Value to consider as checked (default: true) */
+    checkedValue?: any;
+    /** Value to consider as unchecked (default: false) */
+    uncheckedValue?: any;
+    /** Whether the checkbox is disabled */
+    disabled?: boolean;
+    /** Whether to show indeterminate state for null values */
+    indeterminate?: boolean;
+    /** Callback when checkbox value changes */
+    onChange?: (value: any, params: RenderParams) => void;
+    /** Custom CSS class for the checkbox */
+    className?: string;
+}
+/**
+ * CheckboxRenderer - Renders a checkbox for boolean/tri-state values
+ *
+ * Features:
+ * - Checked/unchecked/indeterminate states
+ * - Disabled state support
+ * - Custom checked/unchecked values (not just boolean)
+ * - ARIA attributes for accessibility
+ * - Efficient update() for value changes
+ *
+ * Performance: Optimized for virtual scrolling with update() method
+ *
+ * @example
+ * ```typescript
+ * const renderer = new CheckboxRenderer({
+ *   checkedValue: 1,
+ *   uncheckedValue: 0,
+ *   indeterminate: true,
+ *   onChange: (value, params) => {
+ *     console.log(`Row ${params.cell.row} changed to:`, value);
+ *   }
+ * });
+ * ```
+ */
+export declare class CheckboxRenderer implements CellRenderer {
+    private options;
+    private eventHandlers;
+    constructor(options?: CheckboxRendererOptions);
+    /**
+     * Initial render - creates checkbox structure
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update existing checkbox - called on value/state changes
+     * Optimized for performance during scrolling
+     */
+    update(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Cleanup before element returns to pool
+     */
+    destroy(element: HTMLElement): void;
+    /**
+     * Optional: Return CSS class based on checked state
+     */
+    getCellClass(params: RenderParams): string | undefined;
+    /**
+     * Check if a value is considered "checked"
+     */
+    private isValueChecked;
+    /**
+     * Update ARIA attributes for accessibility
+     */
+    private updateAriaAttributes;
+}
+/**
+ * Factory function to create CheckboxRenderer
+ *
+ * @example
+ * ```typescript
+ * // In column definition
+ * const column = {
+ *   field: 'selected',
+ *   header: 'Select',
+ *   renderer: 'checkbox', // Registered name
+ * };
+ *
+ * // Or create directly
+ * const renderer = createCheckboxRenderer({
+ *   onChange: (value, params) => updateSelection(params.cell.row, value)
+ * });
+ * ```
+ */
+export declare function createCheckboxRenderer(options?: CheckboxRendererOptions): CheckboxRenderer;
+//# sourceMappingURL=checkbox-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/checkbox/checkbox-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,sDAAsD;IACtD,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,aAAa,CAAkC;gBAE3C,OAAO,GAAE,uBAA4B;IAajD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA8CxD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAuBxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAgBnC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAOtD;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA0B7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CAE9F"}

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

@@ -0,0 +1,3 @@
+export { CheckboxRenderer, createCheckboxRenderer } from './checkbox-renderer';
+export type { CheckboxRendererOptions } from './checkbox-renderer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/checkbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,213 @@
+import type { CellRenderer, RenderParams } from '../renderer.interface';
+/**
+ * Chip/tag object interface
+ */
+export interface Chip {
+    /** Chip label text */
+    label: string;
+    /** Chip value (defaults to label if not provided) */
+    value?: string | number;
+    /** Chip background color (CSS color string) */
+    color?: string;
+    /** Chip text color (CSS color string) */
+    textColor?: string;
+    /** Custom CSS class for the chip */
+    className?: string;
+    /** Whether this chip is removable (overrides global removable option) */
+    removable?: boolean;
+    /** Custom data associated with the chip */
+    data?: any;
+}
+/**
+ * Configuration options for ChipRenderer
+ */
+export interface ChipRendererOptions {
+    /**
+     * Array of chips to display, or function that returns chips based on params
+     * Can be an array directly from the cell value or computed from params
+     */
+    chips?: Chip[] | ((params: RenderParams) => Chip[]);
+    /**
+     * Maximum number of chips to display before showing "+N more"
+     * Default: undefined (show all chips)
+     */
+    maxChips?: number;
+    /**
+     * Whether chips can be removed by clicking the × button
+     * Default: false
+     */
+    removable?: boolean;
+    /**
+     * Callback when a chip is removed
+     * @param chip - The chip that was removed
+     * @param params - Render parameters
+     */
+    onRemove?: (chip: Chip, params: RenderParams) => void;
+    /**
+     * Callback when a chip is clicked
+     * @param chip - The chip that was clicked
+     * @param params - Render parameters
+     */
+    onClick?: (chip: Chip, params: RenderParams) => void;
+    /**
+     * Default background color for chips without explicit color
+     * Default: '#e0e0e0'
+     */
+    defaultColor?: string;
+    /**
+     * Default text color for chips without explicit textColor
+     * Default: '#333333'
+     */
+    defaultTextColor?: string;
+    /**
+     * Size of chips (small, medium, large)
+     * Default: 'medium'
+     */
+    size?: 'small' | 'medium' | 'large';
+    /**
+     * Custom CSS class for the chip container
+     */
+    containerClassName?: string;
+    /**
+     * Text to show for overflow count (e.g., "+N more")
+     * Default: (count) => `+${count} more`
+     */
+    overflowText?: (count: number) => string;
+    /**
+     * Chip overflow behavior when chips exceed container width
+     * - 'collapse': Show limited chips with "+N more" indicator (uses maxChips)
+     * - 'wrap': Allow chips to wrap to multiple lines (increases row height)
+     * - 'scroll': Enable horizontal scrolling without visible scrollbar
+     * Default: 'scroll'
+     */
+    overflowMode?: 'collapse' | 'wrap' | 'scroll';
+    /**
+     * Show tooltip with all chips when using collapse or scroll mode
+     * Default: true
+     */
+    showOverflowTooltip?: boolean;
+}
+/**
+ * ChipRenderer - Renders chips/tags in grid cells
+ *
+ * Features:
+ * - Display multiple chips/tags with custom colors
+ * - Removable chips with × button and onRemove callback
+ * - Clickable chips with onClick handler
+ * - Overflow handling with "+N more" indicator
+ * - Custom colors per chip or default color
+ * - Multiple size options (small, medium, large)
+ * - Full ARIA accessibility support
+ * - Efficient event handling with proper cleanup
+ * - Data attributes for debugging and testing
+ * - XSS protection with HTML escaping
+ * - Optimized update() method for virtual scrolling
+ *
+ * Performance: Can render 1000+ chip cells in < 100ms
+ *
+ * @example
+ * ```typescript
+ * // Simple chips from array value
+ * const renderer = new ChipRenderer({
+ *   chips: (params) => params.value || [] // value is array of Chip objects
+ * });
+ *
+ * // Chips with colors and removal
+ * const renderer = new ChipRenderer({
+ *   chips: [
+ *     { label: 'Active', color: '#4caf50', textColor: '#fff' },
+ *     { label: 'Premium', color: '#ffc107', textColor: '#000' }
+ *   ],
+ *   removable: true,
+ *   onRemove: (chip, params) => {
+ *     console.log('Removed chip:', chip.label);
+ *     // Update data source
+ *   }
+ * });
+ *
+ * // Chips with overflow limit
+ * const renderer = new ChipRenderer({
+ *   chips: (params) => params.rowData?.tags || [], // tags is array of Chip objects
+ *   maxChips: 3,
+ *   onClick: (chip, params) => {
+ *     console.log('Clicked chip:', chip.label);
+ *   }
+ * });
+ * ```
+ */
+export declare class ChipRenderer implements CellRenderer {
+    private options;
+    private eventHandlers;
+    /**
+     * Creates a new ChipRenderer instance
+     *
+     * @param options - Configuration options for the chip renderer
+     */
+    constructor(options?: ChipRendererOptions);
+    /**
+     * Initial render - creates chip structure
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update existing chips - called on value/state changes
+     * Optimized for performance during scrolling
+     */
+    update(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Cleanup before element returns to pool
+     */
+    destroy(element: HTMLElement): void;
+    /**
+     * Optional: Return CSS class based on chip count
+     */
+    getCellClass(params: RenderParams): string | undefined;
+    /**
+     * Get chips array from options or params
+     */
+    private getChips;
+    /**
+     * Creates a chip DOM element
+     */
+    private createChipElement;
+    /**
+     * Creates an overflow indicator element
+     */
+    private createOverflowElement;
+    /**
+     * Clears event handlers for the given element
+     */
+    private clearEventHandlers;
+    /**
+     * Get chip padding based on size
+     */
+    private getChipPadding;
+    /**
+     * Get chip font size based on size
+     */
+    private getChipFontSize;
+}
+/**
+ * Factory function to create a ChipRenderer instance
+ *
+ * @example
+ * ```typescript
+ * // In column definition
+ * const column = {
+ *   field: 'tags',
+ *   header: 'Tags',
+ *   renderer: 'chip', // Registered name
+ * };
+ *
+ * // Or create directly
+ * const renderer = createChipRenderer({
+ *   chips: (params) => params.value || [],
+ *   removable: true,
+ *   maxChips: 5,
+ *   onRemove: (chip, params) => {
+ *     console.log('Removed:', chip.label);
+ *   }
+ * });
+ * ```
+ */
+export declare function createChipRenderer(options?: ChipRendererOptions): ChipRenderer;
+//# sourceMappingURL=chip-renderer.d.ts.map