cats-data-grid 2.0.58 → 2.0.61

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnChanges, OnInit, ElementRef, EventEmitter, Renderer2, NgZone, ChangeDetectorRef, SimpleChanges } from '@angular/core';
+import { OnChanges, OnInit, ElementRef, EventEmitter, Renderer2, NgZone, ChangeDetectorRef, SimpleChanges, DoCheck, AfterViewInit, OnDestroy } from '@angular/core';
 
 declare class CatsDataGridService {
     constructor();
@@ -116,6 +116,8 @@ declare class CatsDataGridComponent implements OnChanges, OnInit {
     draggedRowData: any;
     firstCol: any;
     isRowSelected: boolean;
+    onRowClicked: EventEmitter<any>;
+    onCellClicked: EventEmitter<any>;
     constructor(renderer: Renderer2, zone: NgZone, cd: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
@@ -156,6 +158,7 @@ declare class CatsDataGridComponent implements OnChanges, OnInit {
      * @returns void
      */
     applyAllFilters(): void;
+    evaluateFieldValue(row: any, field: string): any;
     resetFilter(col: any): void;
     removeActiveFilter(col: any): void;
     /**
@@ -470,8 +473,10 @@ declare class CatsDataGridComponent implements OnChanges, OnInit {
     clearAllFilter(): void;
     onBtFirstClick(): void;
     onBtLastClick(): void;
+    onRowClick(row: any): void;
+    onCellClick(row: any, col: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CatsDataGridComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CatsDataGridComponent, "cats-data-grid", never, { "tableOptions": { "alias": "tableOptions"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "sortingRequired": { "alias": "sortingRequired"; "required": false; }; "checkBoxSelection": { "alias": "checkBoxSelection"; "required": false; }; "checkboxSelectionType": { "alias": "checkboxSelectionType"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; "colDefs": { "alias": "colDefs"; "required": false; }; "paginationRequired": { "alias": "paginationRequired"; "required": false; }; "selectedRowEmpty": { "alias": "selectedRowEmpty"; "required": false; }; "filterRequired": { "alias": "filterRequired"; "required": false; }; "threeDotsMenuRequired": { "alias": "threeDotsMenuRequired"; "required": false; }; "settingsRequired": { "alias": "settingsRequired"; "required": false; }; "settingsClicked": { "alias": "settingsClicked"; "required": false; }; "resetPage": { "alias": "resetPage"; "required": false; }; "rowId": { "alias": "rowId"; "required": false; }; "height": { "alias": "height"; "required": false; }; "groupByRequired": { "alias": "groupByRequired"; "required": false; }; "pageSizeList": { "alias": "pageSizeList"; "required": false; }; "groupByField": { "alias": "groupByField"; "required": false; }; "appliedFilters": { "alias": "appliedFilters"; "required": false; }; "rowGripFieldName": { "alias": "rowGripFieldName"; "required": false; }; "pageNumber": { "alias": "pageNumber"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "dynamicGroupingFiltering": { "alias": "dynamicGroupingFiltering"; "required": false; }; }, { "onPaginationChange": "onPaginationChange"; "onCheckboxSelection": "onCheckboxSelection"; "onScrollEmitter": "onScrollEmitter"; "filter": "filter"; "onHideSettings": "onHideSettings"; "appliedFiltersEvent": "appliedFiltersEvent"; "activeGroupsEvent": "activeGroupsEvent"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CatsDataGridComponent, "cats-data-grid", never, { "tableOptions": { "alias": "tableOptions"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "sortingRequired": { "alias": "sortingRequired"; "required": false; }; "checkBoxSelection": { "alias": "checkBoxSelection"; "required": false; }; "checkboxSelectionType": { "alias": "checkboxSelectionType"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; "colDefs": { "alias": "colDefs"; "required": false; }; "paginationRequired": { "alias": "paginationRequired"; "required": false; }; "selectedRowEmpty": { "alias": "selectedRowEmpty"; "required": false; }; "filterRequired": { "alias": "filterRequired"; "required": false; }; "threeDotsMenuRequired": { "alias": "threeDotsMenuRequired"; "required": false; }; "settingsRequired": { "alias": "settingsRequired"; "required": false; }; "settingsClicked": { "alias": "settingsClicked"; "required": false; }; "resetPage": { "alias": "resetPage"; "required": false; }; "rowId": { "alias": "rowId"; "required": false; }; "height": { "alias": "height"; "required": false; }; "groupByRequired": { "alias": "groupByRequired"; "required": false; }; "pageSizeList": { "alias": "pageSizeList"; "required": false; }; "groupByField": { "alias": "groupByField"; "required": false; }; "appliedFilters": { "alias": "appliedFilters"; "required": false; }; "rowGripFieldName": { "alias": "rowGripFieldName"; "required": false; }; "pageNumber": { "alias": "pageNumber"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "dynamicGroupingFiltering": { "alias": "dynamicGroupingFiltering"; "required": false; }; }, { "onPaginationChange": "onPaginationChange"; "onCheckboxSelection": "onCheckboxSelection"; "onScrollEmitter": "onScrollEmitter"; "filter": "filter"; "onHideSettings": "onHideSettings"; "appliedFiltersEvent": "appliedFiltersEvent"; "activeGroupsEvent": "activeGroupsEvent"; "onRowClicked": "onRowClicked"; "onCellClicked": "onCellClicked"; }, never, never, true, never>;
 }
 
 declare class CommonRendererComponent {
@@ -615,5 +620,426 @@ declare class CommonRendererComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<CommonRendererComponent, "lib-common-renderer", never, {}, {}, never, never, true, never>;
 }
 
-export { CatsDataGridComponent, CatsDataGridService, ColDefs, CommonRendererComponent };
-export type { ColumnFilter, FilterCondition };
+interface CatsTreeTableColumn {
+    field: string;
+    header?: string;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    class?: string;
+    colId?: string;
+    sortable?: boolean;
+    filterable?: boolean;
+    filterType?: 'text' | 'number' | 'date' | 'set';
+    leftPinned?: boolean;
+    rightPinned?: boolean;
+    leftOffset?: number;
+    rightOffset?: number;
+    active?: boolean;
+    filters?: TreeFilterCondition[];
+    options?: any[];
+    filteredOptions?: any[];
+    selectedValues?: Set<any>;
+    cellRenderer?: any;
+    cellRendererParams?: any;
+}
+interface TreeFilterCondition {
+    filterOperation: string;
+    filterValue: any;
+}
+interface CatsTreeRowOptions {
+    showCheckbox?: boolean;
+    showToggle?: boolean;
+    showNodeIcon?: boolean;
+    showLink?: boolean;
+    disabled?: boolean;
+}
+interface CatsTreeExpandEvent<T = any> {
+    node: T;
+    level: number;
+    path: T[];
+    expanded: boolean;
+}
+interface CatsTreeSelectionChangeEvent<T = any> {
+    node: T;
+    level: number;
+    path: T[];
+    checked: boolean;
+    selectedNodes: T[];
+}
+interface CatsTreeLinkClickEvent<T = any> {
+    node: T;
+    level: number;
+    path: T[];
+    url: string | null;
+}
+type RowKind = 'node' | 'loading' | 'no-data';
+interface RowView<T = any> {
+    kind: RowKind;
+    level: number;
+    path: T[];
+    node: T;
+    trackKey: string | number;
+}
+declare class CommonTreeTableComponent<T = any> implements OnChanges, DoCheck, AfterViewInit, OnDestroy {
+    private renderer;
+    private zone;
+    private cd;
+    tableAreaRef: ElementRef<HTMLElement>;
+    pinMenu?: ElementRef<HTMLElement>;
+    data: T[];
+    columns: CatsTreeTableColumn[];
+    idField: string;
+    labelField: string;
+    childrenField: string;
+    treeColumnField?: string;
+    indentPx: number;
+    showHeader: boolean;
+    expandIcon: string;
+    collapseIcon: string;
+    iconBasePath: string;
+    showCheckbox: boolean;
+    showNodeIcon: boolean;
+    noDataText: string;
+    loadingText: string;
+    emitExpandAlways: boolean;
+    sortingRequired: boolean;
+    filterRequired: boolean;
+    threeDotsMenuRequired: boolean;
+    settingsRequired: boolean;
+    settingsClicked: boolean;
+    checkBoxSelection: boolean;
+    checkboxSelectionType: 'multiple' | 'single';
+    paginationRequired: boolean;
+    pageSizeList: number[];
+    totalRecords: number;
+    resetPage: boolean;
+    isExpandable: (node: T, level: number, path: T[]) => boolean;
+    rowOptionsResolver: (node: T, level: number, path: T[]) => CatsTreeRowOptions;
+    nodeIconResolver: (node: T, level: number, path: T[], expanded: boolean) => string | null;
+    linkResolver: (node: T, level: number, path: T[]) => string | null;
+    nodeToggle: EventEmitter<CatsTreeExpandEvent<T>>;
+    selectionChange: EventEmitter<CatsTreeSelectionChangeEvent<T>>;
+    linkClick: EventEmitter<CatsTreeLinkClickEvent<T>>;
+    onHideSettings: EventEmitter<any>;
+    onPaginationChange: EventEmitter<any>;
+    protected rows: RowView<T>[];
+    pageDetails: any;
+    recordsToShow: any;
+    sortingColumnIndex: number | null;
+    sortingType: {
+        [key: number]: string;
+    };
+    filteredData: T[];
+    originalRowData: T[];
+    activeFilters: Map<string, any>;
+    appliedFilters: any[];
+    menuVisible: boolean[];
+    dragOverIndex: number | null;
+    draggedIndex: number | null;
+    activeFilterIndex: number | null;
+    resizingColumnIndex: number | null;
+    startX: number;
+    startWidth: number;
+    isResizing: boolean;
+    showMoveIcon: {
+        [key: number]: boolean;
+    };
+    showPin: boolean;
+    pinActionClicked: Record<string, string>;
+    columnDraggable: boolean[];
+    showPageSizeList: boolean;
+    activeAll: boolean;
+    atLeastOneColumnChecked: boolean;
+    selectedRow: T[];
+    originalColumns: CatsTreeTableColumn[];
+    private removeMouseMove;
+    private removeMouseUp;
+    private rafId;
+    private removeDragOver;
+    private removeDrop;
+    filterOptions: {
+        label: string;
+        value: string;
+    }[];
+    numberFilterOptions: {
+        label: string;
+        value: string;
+    }[];
+    private expandedKeys;
+    private selectedKeys;
+    private fallbackKey;
+    private fallbackSeq;
+    private resolvedTreeColumnField?;
+    constructor(renderer: Renderer2, zone: NgZone, cd: ChangeDetectorRef);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngDoCheck(): void;
+    protected get treeColumn(): CatsTreeTableColumn;
+    /**
+     * Initialize column properties for filtering, sorting, and customization
+     */
+    private initializeColumns;
+    /**
+     * Extract unique values from data for set filter
+     */
+    private extractUniqueValues;
+    /**
+     * Sort data based on column and sorting type
+     */
+    protected onSortingRowData(sortingColumnIndex: number, col: CatsTreeTableColumn): void;
+    /**
+     * Sort from the three-dots menu with an explicit direction (matches `cats-data-grid` UX).
+     */
+    protected onSort(col: CatsTreeTableColumn, type: string, sortingColumIndex: number): void;
+    /**
+     * Apply sorting to the row data
+     */
+    private applySort;
+    /**
+     * Apply all active filters
+     */
+    applyAllFilters(): void;
+    /**
+     * Evaluate text filter condition
+     */
+    private evaluateTextFilterCondition;
+    /**
+     * Toggle column filter visibility
+     */
+    protected toggleFilter(col: CatsTreeTableColumn, index: number, event: MouseEvent): void;
+    /**
+     * Reset filter for a column
+     */
+    protected resetFilter(col: CatsTreeTableColumn): void;
+    /**
+     * Start column resize
+     */
+    protected startResize(event: MouseEvent, index: number): void;
+    /**
+     * Handle mouse move during resize
+     */
+    private onMouseMove;
+    /**
+     * Stop column resize
+     */
+    private stopResize;
+    /**
+     * Handle column drag start
+     */
+    protected onDragStart(event: DragEvent, index: number): void;
+    /**
+     * Handle column drag over
+     */
+    protected onDragOver(event: DragEvent, index: number): void;
+    /**
+     * Handle column drop
+     */
+    protected onDrop(event: DragEvent, index: number): void;
+    /**
+     * Handle drag end
+     */
+    protected onDragEnd(): void;
+    /**
+     * Pin column to left or right
+     */
+    protected pinColumn(col: CatsTreeTableColumn, index: number, direction: string): void;
+    protected showPinActions(event: MouseEvent): void;
+    protected hidePinActions(): void;
+    /**
+     * Update pinned column offsets
+     */
+    protected updatePinnedOffsets(): void;
+    /**
+     * Filter set options based on search text
+     */
+    protected filterSetOptions(col: CatsTreeTableColumn, event: any): void;
+    /**
+     * Toggle set filter option
+     */
+    protected toggleSetOption(col: CatsTreeTableColumn, option: any, event: any): void;
+    /**
+     * Toggle select all in set filter
+     */
+    protected toggleSelectAllSetFilter(col: CatsTreeTableColumn, event: any): void;
+    /**
+     * Get column style
+     */
+    protected getStyle(col: CatsTreeTableColumn): any;
+    /**
+     * Toggle column visibility
+     */
+    protected changeActiveColSelection(event: Event, col: CatsTreeTableColumn): void;
+    /**
+     * Compute minimum table width based on active column widths
+     */
+    protected getTableMinWidth(): number;
+    /**
+     * Select/deselect all columns
+     */
+    protected activeAllSelection(event: Event): void;
+    /**
+     * Hide settings
+     */
+    protected hideSettings(): void;
+    /**
+     * Close all menus
+     */
+    protected onClickOutside(): void;
+    /**
+     * Open column menu
+     */
+    protected openMenu(event: MouseEvent, col: CatsTreeTableColumn, index: number): void;
+    /**
+     * Recursively select all children of a node
+     */
+    private selectAllChildren;
+    /**
+     * Recursively deselect all children of a node
+     */
+    private deselectAllChildren;
+    /**
+     * Recursively select all nodes in the tree
+     */
+    private selectAllNodes;
+    /**
+     * Recursively deselect all nodes in the tree
+     */
+    private deselectAllNodes;
+    /**
+     * Check if all children of a node are selected
+     */
+    private areAllChildrenSelected;
+    /**
+     * Check if any children of a node are selected
+     */
+    private areAnyChildrenSelected;
+    /**
+     * Update parent node selection based on children state
+     */
+    private updateParentSelection;
+    /**
+     * On header checkbox change - select all nodes hierarchically
+     */
+    protected onHeaderCheckboxChange(event: any): void;
+    /**
+     * On row checkbox change
+     */
+    protected onRowCheckboxChange(event: any, node: T): void;
+    /**
+     * Check if all rows are selected
+     */
+    protected checkAllSelected(): boolean;
+    /**
+     * Check if some rows are selected (indeterminate state)
+     */
+    protected checkIndeterminate(): boolean;
+    /**
+     * Check if row is selected
+     */
+    protected isRowSelected(node: T): boolean;
+    /**
+     * Check if a node has indeterminate selection state (some but not all children selected)
+     */
+    protected isNodeIndeterminate(node: T): boolean;
+    /**
+     * Check header checkbox indeterminate state
+     */
+    protected checkHeaderIndeterminate(): boolean;
+    /**
+     * Check if header checkbox should be checked
+     */
+    protected checkHeaderChecked(): boolean;
+    protected toggle(node: T, level: number, path: T[]): void;
+    protected isExpanded(node: T): boolean;
+    protected onCheckboxChange(node: T, level: number, path: T[], checked: boolean): void;
+    protected isChecked(node: T): boolean;
+    protected onLinkClicked(e: MouseEvent, node: T, level: number, path: T[]): void;
+    protected resolveIconSrc(icon: string | null): string | null;
+    protected getValue(node: T, fieldPath: string): any;
+    protected isNodeRow(row: RowView<T>): boolean;
+    protected rowOptions(row: RowView<T>): CatsTreeRowOptions;
+    protected showToggleFor(row: RowView<T>): boolean;
+    protected showCheckboxFor(row: RowView<T>): boolean;
+    protected showNodeIconFor(row: RowView<T>): boolean;
+    protected showLinkFor(row: RowView<T>): boolean;
+    protected isDisabledRow(row: RowView<T>): boolean;
+    protected labelFor(row: RowView<T>): any;
+    protected toggleIconFor(row: RowView<T>): string;
+    protected nodeIconFor(row: RowView<T>): string | null;
+    protected linkUrlFor(row: RowView<T>): string | null;
+    /**
+     * Set page count based on total records and page size
+     */
+    protected setPageCount(): void;
+    /**
+     * On page size changed
+     */
+    protected onPageSizeChanged(event: any): void;
+    /**
+     * On first button click
+     */
+    protected onBtFirstClick(): void;
+    /**
+     * On previous button click
+     */
+    protected onBtPrevClick(): void;
+    /**
+     * On next button click
+     */
+    protected onBtNextClick(): void;
+    /**
+     * On last button click
+     */
+    protected onBtLastClick(): void;
+    /**
+     * Go to selected page
+     */
+    protected goToSelectedPage(event: any): void;
+    /**
+   * @description method to reset table configuration
+   * @author Tarun Kumar
+   * @param none
+   * @returns void
+   */
+    resetPagination(): void;
+    /**
+     * Convert to number
+     */
+    protected convertToNumber(val: any): number;
+    private getChildren;
+    private rebuildRows;
+    private walk;
+    private getNodeKey;
+    private getSelectedNodes;
+    /**
+     * Autosize column to fit content
+     */
+    protected autosizeColumn(col: CatsTreeTableColumn, index: number): void;
+    /**
+     * Autosize all columns
+     */
+    protected autosizeAllColumns(): void;
+    /**
+     * Group by column
+     */
+    protected groupByColumn(col: CatsTreeTableColumn, index: number): void;
+    /**
+     * Show column chooser
+     */
+    protected showColumnChooser(colIdx: number): void;
+    /**
+     * Reset columns to original state
+     */
+    protected resetColumns(): void;
+    /**
+     * Save column state
+     */
+    private saveColumnState;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CommonTreeTableComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CommonTreeTableComponent<any>, "cats-tree-table", never, { "data": { "alias": "data"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "idField": { "alias": "idField"; "required": false; }; "labelField": { "alias": "labelField"; "required": false; }; "childrenField": { "alias": "childrenField"; "required": false; }; "treeColumnField": { "alias": "treeColumnField"; "required": false; }; "indentPx": { "alias": "indentPx"; "required": false; }; "showHeader": { "alias": "showHeader"; "required": false; }; "expandIcon": { "alias": "expandIcon"; "required": false; }; "collapseIcon": { "alias": "collapseIcon"; "required": false; }; "iconBasePath": { "alias": "iconBasePath"; "required": false; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; }; "showNodeIcon": { "alias": "showNodeIcon"; "required": false; }; "noDataText": { "alias": "noDataText"; "required": false; }; "loadingText": { "alias": "loadingText"; "required": false; }; "emitExpandAlways": { "alias": "emitExpandAlways"; "required": false; }; "sortingRequired": { "alias": "sortingRequired"; "required": false; }; "filterRequired": { "alias": "filterRequired"; "required": false; }; "threeDotsMenuRequired": { "alias": "threeDotsMenuRequired"; "required": false; }; "settingsRequired": { "alias": "settingsRequired"; "required": false; }; "settingsClicked": { "alias": "settingsClicked"; "required": false; }; "checkBoxSelection": { "alias": "checkBoxSelection"; "required": false; }; "checkboxSelectionType": { "alias": "checkboxSelectionType"; "required": false; }; "paginationRequired": { "alias": "paginationRequired"; "required": false; }; "pageSizeList": { "alias": "pageSizeList"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "resetPage": { "alias": "resetPage"; "required": false; }; "isExpandable": { "alias": "isExpandable"; "required": false; }; "rowOptionsResolver": { "alias": "rowOptionsResolver"; "required": false; }; "nodeIconResolver": { "alias": "nodeIconResolver"; "required": false; }; "linkResolver": { "alias": "linkResolver"; "required": false; }; }, { "nodeToggle": "nodeToggle"; "selectionChange": "selectionChange"; "linkClick": "linkClick"; "onHideSettings": "onHideSettings"; "onPaginationChange": "onPaginationChange"; }, never, never, true, never>;
+}
+
+export { CatsDataGridComponent, CatsDataGridService, ColDefs, CommonRendererComponent, CommonTreeTableComponent };
+export type { CatsTreeExpandEvent, CatsTreeLinkClickEvent, CatsTreeRowOptions, CatsTreeSelectionChangeEvent, CatsTreeTableColumn, ColumnFilter, FilterCondition, TreeFilterCondition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cats-data-grid",
-  "version": "2.0.58",
+  "version": "2.0.61",
   "peerDependencies": {
     "@angular/core": ">=18 <22",
     "@angular/common": ">=18 <22"