@zengrid/core 1.0.7 → 1.2.0

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;IAsCxD;;;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

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

@@ -0,0 +1 @@
+{"version":3,"file":"chip-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/chip/chip-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,EAAE,CAAC,CAAC;IACpD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACrD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC9C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,OAAO,CAWO;IACtB,OAAO,CAAC,aAAa,CAGnB;IAEF;;;;OAIG;gBACS,OAAO,GAAE,mBAAwB;IAc7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAmBxD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA2ExD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IASnC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAkBtD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAahB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8GzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,eAAe;CAWxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAElF"}

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

@@ -0,0 +1,3 @@
+export { ChipRenderer, createChipRenderer } from './chip-renderer';
+export type { ChipRendererOptions, Chip } from './chip-renderer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/chip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/rendering/renderers/date-range/date-range-renderer.d.ts

@@ -0,0 +1,128 @@
+import type { CellRenderer, RenderParams } from '../renderer.interface';
+/**
+ * Date range value type
+ */
+export interface DateRange {
+    start: Date | null;
+    end: Date | null;
+}
+/**
+ * Supported date format patterns
+ */
+export type DateFormat = 'MM/DD/YYYY' | 'DD/MM/YYYY' | 'YYYY-MM-DD' | 'DD-MM-YYYY' | 'MM-DD-YYYY' | 'YYYY/MM/DD' | 'locale';
+/**
+ * Configuration options for DateRangeRenderer
+ */
+export interface DateRangeRendererOptions {
+    /** Date format pattern (default: 'MM/DD/YYYY') */
+    format?: DateFormat;
+    /** Locale string for date formatting (e.g., 'en-US', 'de-DE') */
+    locale?: string;
+    /** Separator between start and end dates (default: ' - ') */
+    separator?: string;
+    /** Show calendar icon */
+    showCalendar?: boolean;
+    /** Show duration in days */
+    showDuration?: boolean;
+    /** Custom CSS class for the date range element */
+    className?: string;
+    /** Display format for invalid dates */
+    invalidDateText?: string;
+    /** Display format for null/undefined values */
+    emptyDateText?: string;
+    /** Time zone for date formatting */
+    timeZone?: string;
+    /** Callback when date range is clicked */
+    onClick?: (range: DateRange | null, params: RenderParams) => void;
+    /** Color for start date */
+    startColor?: string;
+    /** Color for end date */
+    endColor?: string;
+    /** Show as chips/badges */
+    chipStyle?: boolean;
+}
+/**
+ * DateRangeRenderer - Renders formatted date ranges with visual styling
+ *
+ * Features:
+ * - Multiple date format patterns
+ * - Locale-aware formatting
+ * - Visual separation between start and end dates
+ * - Duration calculation and display
+ * - LRU cache for performance
+ * - Chip/badge styling option
+ * - ARIA attributes for accessibility
+ *
+ * @example
+ * ```typescript
+ * const renderer = new DateRangeRenderer({
+ *   format: 'DD/MM/YYYY',
+ *   showDuration: true,
+ *   chipStyle: true
+ * });
+ * ```
+ */
+export declare class DateRangeRenderer implements CellRenderer {
+    private options;
+    private formatterCache;
+    private dateStringCache;
+    private eventHandlers;
+    constructor(options?: DateRangeRendererOptions);
+    /**
+     * Initial render - creates date range display structure
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update existing date range - called on value/state changes
+     */
+    update(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Cleanup before element returns to pool
+     */
+    destroy(element: HTMLElement): void;
+    /**
+     * Optional: Return CSS class based on date range validity
+     */
+    getCellClass(params: RenderParams): string | undefined;
+    /**
+     * Parse value into a DateRange object
+     */
+    private parseRange;
+    /**
+     * Parse value into a Date object
+     */
+    private parseDate;
+    /**
+     * Format date according to the configured format and locale
+     */
+    private formatDate;
+    /**
+     * Format date using Intl.DateTimeFormat (locale-aware)
+     */
+    private formatWithLocale;
+    /**
+     * Format date using a specific pattern
+     */
+    private formatWithPattern;
+    /**
+     * Calculate duration in days between two dates
+     */
+    private calculateDuration;
+    /**
+     * Apply chip/badge styles to date elements
+     */
+    private applyChipStyles;
+    /**
+     * Create calendar icon element
+     */
+    private createCalendarIcon;
+    /**
+     * Set ARIA attributes for accessibility
+     */
+    private setAriaAttributes;
+}
+/**
+ * Factory function to create DateRangeRenderer
+ */
+export declare function createDateRangeRenderer(options?: DateRangeRendererOptions): DateRangeRenderer;
+//# sourceMappingURL=date-range-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date-range-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/date-range/date-range-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAClE,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,OAAO,CAOb;IACF,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,aAAa,CAAuC;gBAEhD,OAAO,GAAE,wBAA6B;IAsBlD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAyExD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAgFxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAcnC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAkBtD;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,UAAU;IA2BlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA2C1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,GAAG,iBAAiB,CAEjG"}

package/dist/src/rendering/renderers/date-range/index.d.ts

@@ -0,0 +1,3 @@
+export { DateRangeRenderer, createDateRangeRenderer } from './date-range-renderer';
+export type { DateRangeRendererOptions, DateRange, DateFormat } from './date-range-renderer';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rendering/renderers/date-range/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/date-range/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}