@zengrid/core 1.0.6 → 1.1.0

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

@@ -3,11 +3,13 @@
  */
 export type { CellRenderer, RenderParams } from './renderer.interface';
 export { RendererRegistry } from './renderer-registry';
-export { TextRenderer } from './text-renderer';
-export { NumberRenderer } from './number-renderer';
-export type { NumberRendererOptions } from './number-renderer';
-export { ImageRenderer } from './image-renderer';
-export type { ImageRendererOptions } from './image-renderer';
-export { AdvancedCellRenderer } from './advanced-cell-renderer';
-export type { AdvancedCellRendererOptions, CompositeElement, ConditionalStyle, } from './advanced-cell-renderer';
+export { TextRenderer } from './text';
+export { NumberRenderer } from './number';
+export type { NumberRendererOptions } from './number';
+export { ImageRenderer } from './image';
+export type { ImageRendererOptions } from './image';
+export { AdvancedCellRenderer } from './advanced-cell';
+export type { AdvancedCellRendererOptions, CompositeElement, ConditionalStyle, } from './advanced-cell';
+export { DatePickerRenderer, createDatePickerRenderer, TimePickerRenderer, createTimePickerRenderer, DateTimePickerRenderer, createDateTimePickerRenderer, DateRenderer, createDateRenderer, TimeRenderer, createTimeRenderer, DateTimeRenderer, createDateTimeRenderer, } from './datetime';
+export type { DatePickerRendererOptions, TimePickerRendererOptions, DateTimePickerRendererOptions, DateRendererOptions, TimeRendererOptions, DateTimeRendererOptions, TimeValue, TimeFormat, } from './datetime';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rendering/renderers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rendering/renderers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,4BAA4B,EAE5B,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,3 @@
+export { LinkRenderer, createLinkRenderer } from './link-renderer';
+export type { LinkRendererOptions } from './link-renderer';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,124 @@
+import type { CellRenderer, RenderParams } from '../renderer.interface';
+/**
+ * Configuration options for LinkRenderer
+ */
+export interface LinkRendererOptions {
+    /** Link target attribute: '_blank' (new tab) or '_self' (same tab, default) */
+    target?: '_blank' | '_self';
+    /** Custom CSS class for the link */
+    className?: string;
+    /** Callback when link is clicked (can prevent default navigation) */
+    onClick?: (url: string, params: RenderParams) => void | boolean;
+    /** URL prefix to prepend to all links (e.g., 'https://') */
+    urlPrefix?: string;
+    /** Field name to use for href if different from display value */
+    hrefField?: string;
+    /** Whether to add rel="noopener noreferrer" for security (default: true for _blank) */
+    noOpener?: boolean;
+    /** Custom label to display instead of the URL */
+    label?: string | ((params: RenderParams) => string);
+    /** Whether the link should be disabled (not clickable) */
+    disabled?: boolean | ((params: RenderParams) => boolean);
+}
+/**
+ * LinkRenderer - Renders clickable hyperlinks in grid cells
+ *
+ * Features:
+ * - Clickable hyperlinks with configurable targets (_blank, _self)
+ * - URL prefix support for relative URLs
+ * - Separate href field support (display one value, link to another)
+ * - Custom onClick handler with default prevention
+ * - Security: automatic rel="noopener noreferrer" for _blank targets
+ * - ARIA attributes for accessibility
+ * - Disabled state support
+ * - Custom label support (static or function)
+ *
+ * Performance: Optimized for virtual scrolling with update() method
+ *
+ * @example
+ * ```typescript
+ * // Simple link renderer
+ * const renderer = new LinkRenderer({
+ *   target: '_blank',
+ *   urlPrefix: 'https://'
+ * });
+ *
+ * // With custom href field
+ * const renderer = new LinkRenderer({
+ *   hrefField: 'url',
+ *   target: '_blank',
+ *   onClick: (url, params) => {
+ *     console.log('Clicked:', url);
+ *     return false; // Prevent default navigation
+ *   }
+ * });
+ *
+ * // With custom label
+ * const renderer = new LinkRenderer({
+ *   label: 'Click here',
+ *   hrefField: 'url'
+ * });
+ *
+ * // With dynamic label and disabled
+ * const renderer = new LinkRenderer({
+ *   label: (params) => params.rowData?.linkText || 'Link',
+ *   disabled: (params) => !params.rowData?.active
+ * });
+ * ```
+ */
+export declare class LinkRenderer implements CellRenderer {
+    private options;
+    private eventHandlers;
+    constructor(options?: LinkRendererOptions);
+    /**
+     * Initial render - creates link structure
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update existing link - 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 link state
+     */
+    getCellClass(params: RenderParams): string | undefined;
+    /**
+     * Get the URL to link to
+     */
+    private getUrl;
+    /**
+     * Get the display label for the link
+     */
+    private getLabel;
+    /**
+     * Check if the link is disabled
+     */
+    private isDisabled;
+}
+/**
+ * Factory function to create a LinkRenderer instance
+ *
+ * @example
+ * ```typescript
+ * // In column definition
+ * const column = {
+ *   field: 'website',
+ *   header: 'Website',
+ *   renderer: 'link', // Registered name
+ * };
+ *
+ * // Or create directly
+ * const renderer = createLinkRenderer({
+ *   target: '_blank',
+ *   urlPrefix: 'https://example.com/',
+ *   onClick: (url) => console.log('Navigating to:', url)
+ * });
+ * ```
+ */
+export declare function createLinkRenderer(options?: LinkRendererOptions): LinkRenderer;
+//# sourceMappingURL=link-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/link/link-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC;IAChE,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,CAAC;IACpD,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,aAAa,CAAuC;gBAEhD,OAAO,GAAE,mBAAwB;IAS7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAqDxD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAuDxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAgBnC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAetD;;OAEG;IACH,OAAO,CAAC,MAAM;IA2Bd;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;IACH,OAAO,CAAC,UAAU;CAWnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAElF"}

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

@@ -0,0 +1,3 @@
+export { NumberRenderer } from './number-renderer';
+export type { NumberRendererOptions } from './number-renderer';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,4 +1,4 @@
-import type { CellRenderer, RenderParams } from './renderer.interface';
+import type { CellRenderer, RenderParams } from '../renderer.interface';
 /**
  * Options for NumberRenderer
  */

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

@@ -0,0 +1 @@
+{"version":3,"file":"number-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/number/number-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;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/progress-bar/index.d.ts

@@ -0,0 +1,3 @@
+export { ProgressBarRenderer, createProgressBarRenderer } from './progress-bar-renderer';
+export type { ProgressBarRendererOptions, ProgressColorThreshold } from './progress-bar-renderer';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/rendering/renderers/progress-bar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/progress-bar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzF,YAAY,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/rendering/renderers/progress-bar/progress-bar-renderer.d.ts

@@ -0,0 +1,134 @@
+import type { CellRenderer, RenderParams } from '../renderer.interface';
+/**
+ * Color threshold configuration for progress bar
+ */
+export interface ProgressColorThreshold {
+    /** Threshold value (0-100) */
+    value: number;
+    /** Color to use when progress >= threshold */
+    color: string;
+}
+/**
+ * Configuration options for ProgressBarRenderer
+ */
+export interface ProgressBarRendererOptions {
+    /** Minimum value (default: 0) */
+    min?: number;
+    /** Maximum value (default: 100) */
+    max?: number;
+    /** Whether to show percentage text (default: true) */
+    showValue?: boolean;
+    /** Custom format function for displayed value */
+    valueFormatter?: (value: number, percentage: number) => string;
+    /** Single color for progress bar */
+    color?: string;
+    /** Color thresholds for dynamic coloring (e.g., red < 30, yellow < 70, green >= 70) */
+    colorThresholds?: ProgressColorThreshold[];
+    /** Background color for empty portion */
+    backgroundColor?: string;
+    /** Height of progress bar in pixels (default: 20) */
+    height?: number;
+    /** Border radius in pixels (default: 4) */
+    borderRadius?: number;
+    /** Whether to animate progress bar (default: false) */
+    animated?: boolean;
+    /** Custom CSS class for the progress bar */
+    className?: string;
+    /** Callback when progress bar is clicked */
+    onClick?: (value: number, params: RenderParams) => void;
+}
+/**
+ * ProgressBarRenderer - Renders a visual progress bar (0-100%)
+ *
+ * Features:
+ * - Visual progress bar with customizable colors
+ * - Percentage text display (optional)
+ * - Color thresholds (e.g., red/yellow/green based on value)
+ * - Min/max value support for custom ranges
+ * - Custom value formatting
+ * - Smooth animations (optional)
+ * - ARIA attributes for accessibility
+ * - Event handlers for interactions
+ *
+ * Performance: Optimized for virtual scrolling with update() method
+ *
+ * @example
+ * ```typescript
+ * const renderer = new ProgressBarRenderer({
+ *   colorThresholds: [
+ *     { value: 0, color: '#dc3545' },  // red for 0-30%
+ *     { value: 30, color: '#ffc107' }, // yellow for 30-70%
+ *     { value: 70, color: '#28a745' }  // green for 70-100%
+ *   ],
+ *   showValue: true,
+ *   animated: true
+ * });
+ * ```
+ */
+export declare class ProgressBarRenderer implements CellRenderer {
+    private options;
+    private eventHandlers;
+    constructor(options?: ProgressBarRendererOptions);
+    /**
+     * Initial render - creates progress bar structure
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update existing progress bar - called on value 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 progress value
+     */
+    getCellClass(params: RenderParams): string | undefined;
+    /**
+     * Parse value to number
+     */
+    private parseValue;
+    /**
+     * Calculate percentage from value
+     */
+    private calculatePercentage;
+    /**
+     * Get color for progress bar based on percentage
+     */
+    private getProgressColor;
+    /**
+     * Create container element
+     */
+    private createContainer;
+    /**
+     * Set ARIA attributes for accessibility
+     */
+    private setAriaAttributes;
+}
+/**
+ * Factory function to create ProgressBarRenderer
+ *
+ * @example
+ * ```typescript
+ * // In column definition
+ * const column = {
+ *   field: 'completion',
+ *   header: 'Progress',
+ *   renderer: 'progress', // Registered name
+ * };
+ *
+ * // Or create directly
+ * const renderer = createProgressBarRenderer({
+ *   colorThresholds: [
+ *     { value: 0, color: '#dc3545' },
+ *     { value: 50, color: '#ffc107' },
+ *     { value: 80, color: '#28a745' }
+ *   ],
+ *   animated: true
+ * });
+ * ```
+ */
+export declare function createProgressBarRenderer(options?: ProgressBarRendererOptions): ProgressBarRenderer;
+//# sourceMappingURL=progress-bar-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress-bar-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/progress-bar/progress-bar-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iDAAiD;IACjD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,eAAe,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC3C,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,OAAO,CAOb;IACF,OAAO,CAAC,aAAa,CAAuC;gBAEhD,OAAO,GAAE,0BAA+B;IAmBpD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA6DxD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA4CxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAenC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAgBtD;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAO1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAErB"}

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

@@ -0,0 +1,108 @@
+/**
+ * Shared Utilities for Cell Renderers
+ *
+ * Common helper functions and classes used across multiple renderers.
+ */
+/**
+ * Simple LRU (Least Recently Used) Cache
+ *
+ * Used by DateRenderer and DropdownRenderer for caching formatted values
+ * and filtered options to improve performance.
+ *
+ * @template K - Key type
+ * @template V - Value type
+ */
+export declare class SimpleLRUCache<K, V> {
+    private cache;
+    private maxSize;
+    constructor(maxSize: number);
+    /**
+     * Get a value from the cache
+     * Moves the accessed item to the end (most recently used)
+     */
+    get(key: K): V | undefined;
+    /**
+     * Set a value in the cache
+     * Evicts the oldest item if cache exceeds max size
+     */
+    set(key: K, value: V): void;
+    /**
+     * Check if a key exists in the cache
+     */
+    has(key: K): boolean;
+    /**
+     * Clear all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Get the current size of the cache
+     */
+    get size(): number;
+}
+/**
+ * Escape HTML to prevent XSS attacks
+ *
+ * Converts HTML special characters to their entity equivalents.
+ * Used by renderers that need to safely display user-provided content.
+ *
+ * @param text - Text to escape
+ * @returns Escaped HTML-safe text
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Deep equality comparison for values
+ *
+ * Used by renderers to determine if a value has actually changed
+ * and whether update() needs to modify the DOM.
+ *
+ * Handles:
+ * - Primitives (string, number, boolean, null, undefined)
+ * - Arrays (recursive comparison)
+ * - Objects (recursive comparison)
+ * - Dates
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns True if values are deeply equal
+ */
+export declare function deepEqual(a: any, b: any): boolean;
+/**
+ * Format a number as a percentage
+ *
+ * Helper for ProgressBarRenderer and other numeric displays.
+ *
+ * @param value - Numeric value
+ * @param decimals - Number of decimal places (default: 0)
+ * @returns Formatted percentage string
+ */
+export declare function formatPercentage(value: number, decimals?: number): string;
+/**
+ * Clamp a number between min and max values
+ *
+ * @param value - Value to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Clamped value
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Check if a value is a valid URL
+ *
+ * Used by LinkRenderer for validation.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid URL
+ */
+export declare function isValidUrl(value: string): boolean;
+/**
+ * Add URL prefix if needed
+ *
+ * Used by LinkRenderer to handle relative URLs.
+ *
+ * @param url - URL to process
+ * @param prefix - Prefix to add for relative URLs
+ * @returns Complete URL
+ */
+export declare function addUrlPrefix(url: string, prefix?: string): string;
+export declare function generateId(prefix?: string): string;
+//# sourceMappingURL=renderer-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-utils.d.ts","sourceRoot":"","sources":["../../../../src/rendering/renderers/renderer-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,qBAAa,cAAc,CAAC,CAAC,EAAE,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAK3B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAY1B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAkB3B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CA+BjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAcjE;AAWD,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAa,GAAG,MAAM,CAExD"}

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

@@ -0,0 +1,3 @@
+export { SelectRenderer, createSelectRenderer } from './select-renderer';
+export type { SelectRendererOptions, SelectOption } from './select-renderer';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,150 @@
+import type { CellRenderer, RenderParams } from '../renderer.interface';
+/**
+ * Option definition for SelectRenderer
+ */
+export interface SelectOption {
+    /** Display label for the option */
+    label: string;
+    /** Value for the option */
+    value: any;
+    /** Whether this option is disabled */
+    disabled?: boolean;
+    /** Optional group for categorization */
+    group?: string;
+}
+/**
+ * Configuration options for SelectRenderer
+ */
+export interface SelectRendererOptions {
+    /** Array of select options (default: empty array with warning) */
+    options?: SelectOption[];
+    /** Placeholder text when no value is selected */
+    placeholder?: string;
+    /** Callback when value changes */
+    onChange?: (value: any, params: RenderParams) => void;
+    /** Custom CSS class for the select element */
+    className?: string;
+    /** Allow multiple selections */
+    multiple?: boolean;
+    /** Size attribute for select (number of visible options) */
+    size?: number;
+}
+/**
+ * SelectRenderer - Renders a native HTML select element for choosing from options
+ *
+ * Features:
+ * - Native <select> HTML element (better mobile support)
+ * - Single and multi-select modes
+ * - Option grouping with <optgroup>
+ * - Deep value comparison for complex option values
+ * - Simpler alternative to DropdownRenderer
+ * - Full ARIA attributes for accessibility
+ * - Lightweight and performant
+ * - Optimized update() method for virtual scrolling
+ *
+ * Use SelectRenderer when:
+ * - You want native browser behavior
+ * - Mobile support is important
+ * - You don't need custom styling or search
+ * - Simplicity is preferred over customization
+ *
+ * Use DropdownRenderer when:
+ * - You need searchable/filterable options
+ * - Custom styling is required
+ * - You need custom option rendering
+ * - Desktop-first experience
+ *
+ * @example
+ * ```typescript
+ * // Simple select with static options
+ * const renderer = new SelectRenderer({
+ *   options: [
+ *     { label: 'Active', value: 'active' },
+ *     { label: 'Inactive', value: 'inactive' },
+ *     { label: 'Pending', value: 'pending' }
+ *   ],
+ *   onChange: (value, params) => {
+ *     console.log('Status changed to:', value);
+ *   }
+ * });
+ *
+ * // Multi-select with grouping
+ * const renderer = new SelectRenderer({
+ *   options: [
+ *     { label: 'Red', value: 'red', group: 'Colors' },
+ *     { label: 'Green', value: 'green', group: 'Colors' },
+ *     { label: 'Circle', value: 'circle', group: 'Shapes' },
+ *     { label: 'Square', value: 'square', group: 'Shapes' }
+ *   ],
+ *   multiple: true,
+ *   size: 6
+ * });
+ * ```
+ */
+export declare class SelectRenderer implements CellRenderer {
+    private options;
+    private eventHandlers;
+    private currentParams;
+    /**
+     * Creates a new SelectRenderer instance
+     */
+    constructor(options?: SelectRendererOptions);
+    /**
+     * Initial render - creates select structure
+     */
+    render(element: HTMLElement, params: RenderParams): void;
+    /**
+     * Update existing select - 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 selection state
+     */
+    getCellClass(params: RenderParams): string | undefined;
+    /**
+     * Create a single option element
+     */
+    private createOptionElement;
+    /**
+     * Check if a value is selected
+     */
+    private isValueSelected;
+    /**
+     * Group options by their group property
+     */
+    private groupOptions;
+    /**
+     * Set ARIA attributes for accessibility
+     */
+    private setAriaAttributes;
+}
+/**
+ * Factory function to create SelectRenderer
+ *
+ * @example
+ * ```typescript
+ * // In column definition
+ * const column = {
+ *   field: 'status',
+ *   header: 'Status',
+ *   renderer: 'select', // Registered name
+ * };
+ *
+ * // Or create directly
+ * const renderer = createSelectRenderer({
+ *   options: [
+ *     { label: 'Active', value: 'active' },
+ *     { label: 'Inactive', value: 'inactive' },
+ *     { label: 'Pending', value: 'pending' }
+ *   ],
+ *   onChange: (value) => console.log('Status changed to:', value)
+ * });
+ * ```
+ */
+export declare function createSelectRenderer(options: SelectRendererOptions): SelectRenderer;
+//# sourceMappingURL=select-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/select/select-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,GAAG,CAAC;IACX,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,OAAO,CAGb;IACF,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,aAAa,CAAiC;IAEtD;;OAEG;gBACS,OAAO,GAAE,qBAA0B;IAmB/C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA8DxD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA6DxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAiBnC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAiBtD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAQ1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEnF"}

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

@@ -0,0 +1,2 @@
+export { TextRenderer } from './text-renderer';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,4 +1,4 @@
-import type { CellRenderer, RenderParams } from './renderer.interface';
+import type { CellRenderer, RenderParams } from '../renderer.interface';
 /**
  * TextRenderer - Default renderer for text content
  *

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/renderers/text/text-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;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.map

@@ -1 +1 @@
-{"version":3,"file":"spatial-hit-tester.d.ts","sourceRoot":"","sources":["../../../src/rendering/spatial-hit-tester.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAS,KAAK,cAAc,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;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"}
+{"version":3,"file":"spatial-hit-tester.d.ts","sourceRoot":"","sources":["../../../src/rendering/spatial-hit-tester.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAS,KAAK,cAAc,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;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;IAI/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

@@ -1,6 +1,6 @@
 /**
  * VirtualScroller - Calculate visible ranges for virtual scrolling
  */
-export type { VirtualScrollerOptions, CellPosition, } from './virtual-scroller.interface';
+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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rendering/virtual-scroller/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}