@zengrid/core 1.0.7 → 1.2.0

package/dist/src/rendering/headers/header-registry.d.ts

@@ -0,0 +1,86 @@
+import type { HeaderRenderer } from './header-renderer.interface';
+/**
+ * HeaderRendererRegistry - Named header renderer lookup
+ *
+ * Manages a collection of header renderers by name for dynamic lookup.
+ * Uses SingletonFactory from @zengrid/shared for efficient instance management.
+ *
+ * @example
+ * ```typescript
+ * const registry = new HeaderRendererRegistry();
+ * registry.register('sortable', () => new SortableHeaderRenderer());
+ * registry.register('filterable', () => new FilterableHeaderRenderer());
+ *
+ * const renderer = registry.get('sortable'); // Returns SortableHeaderRenderer (cached)
+ * const fallback = registry.get('unknown'); // Returns TextHeaderRenderer (default)
+ * ```
+ */
+export declare class HeaderRendererRegistry {
+    private factory;
+    private defaultRenderer;
+    constructor();
+    /**
+     * Set the default renderer (typically TextHeaderRenderer)
+     * This should be called once during initialization
+     *
+     * @param renderer - Default header renderer instance
+     */
+    setDefaultRenderer(renderer: HeaderRenderer): void;
+    /**
+     * Register a header renderer with a name
+     *
+     * @param name - Unique renderer name (e.g., 'text', 'sortable', 'filterable')
+     * @param creator - Function that creates the renderer instance
+     *
+     * @example
+     * ```typescript
+     * registry.register('sortable', () => new SortableHeaderRenderer());
+     * ```
+     */
+    register(name: string, creator: () => HeaderRenderer): void;
+    /**
+     * Get a header renderer by name
+     *
+     * @param name - Renderer name (undefined returns default)
+     * @returns Renderer instance or default if not found
+     *
+     * @example
+     * ```typescript
+     * const renderer = registry.get('sortable'); // Get sortable renderer
+     * const defaultRenderer = registry.get(); // Get default renderer
+     * ```
+     */
+    get(name?: string): HeaderRenderer;
+    /**
+     * Check if a renderer is registered
+     *
+     * @param name - Renderer name
+     * @returns True if registered
+     */
+    has(name: string): boolean;
+    /**
+     * Unregister a renderer
+     *
+     * @param name - Renderer name
+     * @returns True if unregistered, false if not found or is default
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get all registered renderer names
+     *
+     * @returns Array of registered renderer names
+     */
+    get names(): string[];
+    /**
+     * Clear all renderers except default
+     */
+    clear(): void;
+    /**
+     * Get the default renderer
+     * Throws error if default renderer is not set
+     *
+     * @returns Default header renderer
+     */
+    private getDefaultRenderer;
+}
+//# sourceMappingURL=header-registry.d.ts.map

package/dist/src/rendering/headers/header-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-registry.d.ts","sourceRoot":"","sources":["../../../../src/rendering/headers/header-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,eAAe,CAA+B;;IAMtD;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIlD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,GAAG,IAAI;IAI3D;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc;IASlC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjC;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/src/rendering/headers/header-renderer.interface.d.ts

@@ -0,0 +1,106 @@
+import type { ColumnDef, ResolvedHeaderConfig } from '../../types';
+/**
+ * Sort direction for header rendering
+ */
+export type SortDirection = 'asc' | 'desc' | null;
+/**
+ * Parameters passed to header renderers for rendering a header cell
+ */
+export interface HeaderRenderParams {
+    /**
+     * Column index
+     */
+    columnIndex: number;
+    /**
+     * Column definition
+     */
+    column: ColumnDef;
+    /**
+     * Resolved header configuration
+     */
+    config: ResolvedHeaderConfig;
+    /**
+     * Column width in pixels
+     */
+    width: number;
+    /**
+     * Header height in pixels
+     */
+    height: number;
+    /**
+     * Current sort direction (if sortable)
+     */
+    sortDirection?: SortDirection;
+    /**
+     * Sort priority for multi-column sort (0 = primary sort)
+     */
+    sortPriority?: number;
+    /**
+     * Whether column has active filter
+     */
+    hasFilter?: boolean;
+    /**
+     * Whether column is being resized
+     */
+    isResizing?: boolean;
+    /**
+     * Whether header is hovered
+     */
+    isHovered?: boolean;
+    /**
+     * Whether header is focused
+     */
+    isFocused?: boolean;
+    /**
+     * Event emitter function for emitting grid events
+     */
+    emit?: (event: string, payload: any) => void;
+}
+/**
+ * Header renderer interface
+ *
+ * Follows the same pattern as CellRenderer for consistency.
+ * Renderers are responsible for creating and updating header content.
+ */
+export interface HeaderRenderer {
+    /**
+     * Initial render into a DOM element
+     * Called when header is first created
+     *
+     * @param element - DOM element to render into
+     * @param params - Rendering parameters
+     */
+    render(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Update an existing rendered element
+     * Called when header state changes (sort, filter, hover, etc.)
+     * Should be optimized for frequent calls
+     *
+     * @param element - DOM element to update
+     * @param params - Updated rendering parameters
+     */
+    update(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Cleanup before element is removed
+     * Called when column is removed or grid is destroyed
+     *
+     * @param element - DOM element to cleanup
+     */
+    destroy(element: HTMLElement): void;
+    /**
+     * Optional: Get CSS class to apply to header cell based on state
+     * Useful for conditional styling
+     *
+     * @param params - Rendering parameters
+     * @returns CSS class name or undefined
+     */
+    getHeaderClass?(params: HeaderRenderParams): string | undefined;
+    /**
+     * Optional: Get inline styles to apply to header cell
+     *
+     * @param params - Rendering parameters
+     * @returns Style object or undefined
+     */
+    getHeaderStyle?(params: HeaderRenderParams): Partial<CSSStyleDeclaration> | undefined;
+}
+//# sourceMappingURL=header-renderer.interface.d.ts.map

package/dist/src/rendering/headers/header-renderer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-renderer.interface.d.ts","sourceRoot":"","sources":["../../../../src/rendering/headers/header-renderer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,oBAAoB,CAAC;IAE7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE/D;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE/D;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAEpC;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAAC;IAEhE;;;;;OAKG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAC;CACvF"}

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

@@ -0,0 +1,8 @@
+/**
+ * Header rendering module barrel export
+ */
+export * from './header-renderer.interface';
+export * from './header-config-resolver';
+export * from './header-registry';
+export * from './renderers';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rendering/headers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { HeaderRenderer, HeaderRenderParams } from '../header-renderer.interface';
+/**
+ * CheckboxHeaderRenderer - Header renderer for select-all checkbox
+ *
+ * Displays a checkbox in the header that can be used for row selection.
+ * Typically used in the first column for bulk selection.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new CheckboxHeaderRenderer();
+ * renderer.render(element, {
+ *   columnIndex: 0,
+ *   column: { field: 'select', header: { text: '', type: 'checkbox' } },
+ *   config: { text: '', type: 'checkbox', interactive: true },
+ *   width: 40,
+ *   height: 40,
+ * });
+ * ```
+ */
+export declare class CheckboxHeaderRenderer implements HeaderRenderer {
+    render(element: HTMLElement, params: HeaderRenderParams): void;
+    update(element: HTMLElement, params: HeaderRenderParams): void;
+    destroy(element: HTMLElement): void;
+}
+//# sourceMappingURL=checkbox-header-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-header-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/headers/renderers/checkbox-header-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA0C9D,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAe9D,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAUpC"}

package/dist/src/rendering/headers/renderers/filterable-header-renderer.d.ts

@@ -0,0 +1,61 @@
+import { SortableHeaderRenderer } from './sortable-header-renderer';
+import type { HeaderRenderParams } from '../header-renderer.interface';
+/**
+ * FilterableHeaderRenderer - Header renderer with filter dropdown trigger
+ *
+ * Extends SortableHeaderRenderer and adds:
+ * - Filter dropdown trigger button
+ * - Active filter indicator
+ * - Filter icon/button with click handler
+ *
+ * @example
+ * ```typescript
+ * const renderer = new FilterableHeaderRenderer();
+ * renderer.render(element, {
+ *   columnIndex: 0,
+ *   column: { field: 'status', header: 'Status', filterable: true, sortable: true },
+ *   config: {
+ *     text: 'Status',
+ *     type: 'filterable',
+ *     interactive: true,
+ *     filterIndicator: { show: true, icon: '▼' }
+ *   },
+ *   hasFilter: true,
+ *   width: 200,
+ *   height: 40,
+ * });
+ * ```
+ */
+export declare class FilterableHeaderRenderer extends SortableHeaderRenderer {
+    /**
+     * Default filter icon
+     */
+    private static readonly DEFAULT_FILTER_ICON;
+    private static setFilterMeta;
+    private static getFilterMeta;
+    /**
+     * Initial render of filterable header
+     */
+    render(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Update filterable header
+     */
+    update(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Render filter trigger button
+     */
+    protected renderFilterTrigger(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Update filter trigger button state
+     */
+    protected updateFilterTrigger(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Get additional CSS class for filter state
+     */
+    getHeaderClass?(params: HeaderRenderParams): string | undefined;
+    /**
+     * Cleanup - remove filter button listeners
+     */
+    destroy(element: HTMLElement): void;
+}
+//# sourceMappingURL=filterable-header-renderer.d.ts.map

package/dist/src/rendering/headers/renderers/filterable-header-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterable-header-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/headers/renderers/filterable-header-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,wBAAyB,SAAQ,sBAAsB;IAClE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAO;IAElD,OAAO,CAAC,MAAM,CAAC,aAAa;IAW5B,OAAO,CAAC,MAAM,CAAC,aAAa;IAU5B;;OAEG;IACM,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAWvE;;OAEG;IACM,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAevE;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA0ErF;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAkBrF;;OAEG;IACM,cAAc,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS;IAWxE;;OAEG;IACM,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAW7C"}

package/dist/src/rendering/headers/renderers/icon-header-renderer.d.ts

@@ -0,0 +1,25 @@
+import type { HeaderRenderer, HeaderRenderParams } from '../header-renderer.interface';
+/**
+ * IconHeaderRenderer - Header renderer for icon-only headers
+ *
+ * Displays only an icon without text, useful for action columns or narrow columns.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new IconHeaderRenderer();
+ * renderer.render(element, {
+ *   columnIndex: 5,
+ *   column: { field: 'actions', header: { text: '', type: 'icon', leadingIcon: { content: '⋮' } } },
+ *   config: { text: '', type: 'icon', leadingIcon: { content: '⋮' }, interactive: true },
+ *   width: 50,
+ *   height: 40,
+ * });
+ * ```
+ */
+export declare class IconHeaderRenderer implements HeaderRenderer {
+    render(element: HTMLElement, params: HeaderRenderParams): void;
+    update(element: HTMLElement, params: HeaderRenderParams): void;
+    destroy(element: HTMLElement): void;
+    getHeaderClass?(params: HeaderRenderParams): string | undefined;
+}
+//# sourceMappingURL=icon-header-renderer.d.ts.map

package/dist/src/rendering/headers/renderers/icon-header-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-header-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/headers/renderers/icon-header-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAoE9D,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAmB9D,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAOnC,cAAc,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS;CAQhE"}

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

@@ -0,0 +1,9 @@
+/**
+ * Header renderers barrel export
+ */
+export { TextHeaderRenderer } from './text-header-renderer';
+export { SortableHeaderRenderer } from './sortable-header-renderer';
+export { FilterableHeaderRenderer } from './filterable-header-renderer';
+export { CheckboxHeaderRenderer } from './checkbox-header-renderer';
+export { IconHeaderRenderer } from './icon-header-renderer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/headers/renderers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/rendering/headers/renderers/sortable-header-renderer.d.ts

@@ -0,0 +1,64 @@
+import { TextHeaderRenderer } from './text-header-renderer';
+import type { HeaderRenderParams } from '../header-renderer.interface';
+/**
+ * SortableHeaderRenderer - Header renderer with sort indicators
+ *
+ * Extends TextHeaderRenderer and adds:
+ * - Sort direction indicators (ascending/descending arrows)
+ * - Click-to-sort functionality
+ * - Visual feedback for sorted state
+ *
+ * @example
+ * ```typescript
+ * const renderer = new SortableHeaderRenderer();
+ * renderer.render(element, {
+ *   columnIndex: 0,
+ *   column: { field: 'name', header: 'Name', sortable: true },
+ *   config: {
+ *     text: 'Name',
+ *     type: 'sortable',
+ *     interactive: true,
+ *     sortIndicator: { show: true, ascIcon: '▲', descIcon: '▼' }
+ *   },
+ *   sortDirection: 'asc',
+ *   width: 200,
+ *   height: 40,
+ * });
+ * ```
+ */
+export declare class SortableHeaderRenderer extends TextHeaderRenderer {
+    /**
+     * Default sort icons
+     */
+    private static readonly DEFAULT_ASC_ICON;
+    private static readonly DEFAULT_DESC_ICON;
+    /**
+     * Initial render of sortable header
+     */
+    render(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Update sortable header
+     */
+    update(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Render sort indicator element
+     */
+    protected renderSortIndicator(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Update sort indicator
+     */
+    protected updateSortIndicator(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Update sort icon based on sort direction
+     */
+    protected updateSortIcon(sortEl: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Setup sort click handler
+     */
+    protected setupSortClickHandler(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Get additional CSS class for sorted state
+     */
+    getHeaderClass?(params: HeaderRenderParams): string | undefined;
+}
+//# sourceMappingURL=sortable-header-renderer.d.ts.map

package/dist/src/rendering/headers/renderers/sortable-header-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortable-header-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/headers/renderers/sortable-header-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAEhD;;OAEG;IACM,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAiBvE;;OAEG;IACM,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAgBvE;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAqCrF;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAOrF;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA+C/E;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAmDvF;;OAEG;IACM,cAAc,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS;CAWzE"}

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

@@ -0,0 +1,59 @@
+import type { HeaderRenderer, HeaderRenderParams } from '../header-renderer.interface';
+import type { HeaderIcon } from '../../../types';
+/**
+ * TextHeaderRenderer - Default header renderer for simple text headers
+ *
+ * Supports:
+ * - Text content
+ * - Leading and trailing icons
+ * - Tooltips
+ * - Custom CSS classes and styles
+ * - Click handlers
+ *
+ * @example
+ * ```typescript
+ * const renderer = new TextHeaderRenderer();
+ * renderer.render(element, {
+ *   columnIndex: 0,
+ *   column: { field: 'name', header: 'Name' },
+ *   config: { text: 'Name', type: 'text', interactive: false },
+ *   width: 200,
+ *   height: 40,
+ * });
+ * ```
+ */
+export declare class TextHeaderRenderer implements HeaderRenderer {
+    /**
+     * Initial render of header content
+     */
+    render(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Update existing header content
+     */
+    update(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Cleanup before removal
+     */
+    destroy(element: HTMLElement): void;
+    /**
+     * Get additional CSS class for header cell
+     */
+    getHeaderClass?(params: HeaderRenderParams): string | undefined;
+    /**
+     * Create icon element
+     */
+    protected createIconElement(icon: HeaderIcon, columnIndex: number): HTMLElement;
+    /**
+     * Setup event handlers for header element
+     */
+    protected setupEventHandlers(element: HTMLElement, params: HeaderRenderParams): void;
+    /**
+     * Setup tooltip for header element
+     */
+    protected setupTooltip(element: HTMLElement, tooltip: any): void;
+    /**
+     * Show context menu
+     */
+    protected showContextMenu(_event: MouseEvent, params: HeaderRenderParams): void;
+}
+//# sourceMappingURL=text-header-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-header-renderer.d.ts","sourceRoot":"","sources":["../../../../../src/rendering/headers/renderers/text-header-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA+E9D;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA6B9D;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAcnC;;OAEG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS;IAU/D;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW;IA4B/E;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAyDpF;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAKhE;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;CAMhF"}

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"}