@competer/primeng-table 19.1.8 → 19.2.0

package/lib/components/ecs-primeng-table/ecs-primeng-table.d.ts

@@ -6,6 +6,7 @@ import { ECSPrimengTableService } from './ecs-primeng-table.service';
 import { DeviceType, CellOverflowBehaviour, DataAlignHorizontal, DataAlignVertical, DataType, FrozenColumnAlign, TableViewSaveMode } from '../../enums';
 import { IColumnMetadata, IPredefinedFilter, ITablePagedResponse, ITableView, ITableOptions } from '../../interfaces';
 import { ECSPrimengTableNotificationService } from '../../services';
+import { TreeRow, TreeTableState } from '../../utils/tree-table-state';
 import * as i0 from "@angular/core";
 export declare class ECSPrimengTable implements OnInit, AfterViewInit, OnDestroy {
     private tableService;
@@ -18,6 +19,9 @@ export declare class ECSPrimengTable implements OnInit, AfterViewInit, OnDestroy
     private destroyed;
     constructor(tableService: ECSPrimengTableService, notification: ECSPrimengTableNotificationService);
     tableOptions: ITableOptions;
+    treeState?: TreeTableState;
+    private treeQuery?;
+    private treeStateRestored;
     onRowCheckboxChange: EventEmitter<{
         rowID: any;
         selected: boolean;
@@ -38,8 +42,21 @@ export declare class ECSPrimengTable implements OnInit, AfterViewInit, OnDestroy
     showExportModal: boolean;
     showColumnSelector: boolean;
     selectedRowsCheckbox: any[];
+    selectAllLoading: boolean;
+    private selectionQuery?;
+    private selectionQueryKey;
+    private matchingSelectionKeys?;
     dt: Table;
     globalSearchText: string | null;
+    private appliedGlobalSearchText;
+    private globalSearchManaged;
+    private globalSearchTimer?;
+    /** The applied query stays separate from text being typed during the debounce. */
+    get effectiveGlobalSearchText(): string | null;
+    private cancelGlobalSearch;
+    private restoreGlobalSearch;
+    private globalSearchOption;
+    onGlobalSearchInput(value: string): void;
     tableViewsList: ITableView[];
     tableViews_menuItems: any[];
     DataType: typeof DataType;
@@ -87,6 +104,12 @@ export declare class ECSPrimengTable implements OnInit, AfterViewInit, OnDestroy
     get compactHeader(): boolean;
     get compactRows(): boolean;
     get actionColumnWidth(): number;
+    getColumnHeaderGroups(columns: IColumnMetadata[]): {
+        field: string;
+        label: string;
+        colspan: number;
+        frozenColumnAlign: FrozenColumnAlign;
+    }[];
     private isInitiallyVisible;
     private updateResponsiveViewport;
     private buttonVisible;
@@ -143,6 +166,16 @@ export declare class ECSPrimengTable implements OnInit, AfterViewInit, OnDestroy
     private selectorRowFilterBuilder;
     revertDateTimeZoneFilters(inputFilter: any): any;
     handleTableDataResponse(body: ITablePagedResponse): void;
+    private generateViewData;
+    private treeFetcher;
+    private syncTreeRows;
+    toggleTreeRow(event: Event, row: TreeRow): Promise<void>;
+    loadMoreTreeRows(event: Event, row: TreeRow): Promise<void>;
+    get treeColumn(): string | undefined;
+    treePageChange(event: {
+        first?: number;
+        rows?: number;
+    }): void;
     clearFilters(dt: Table, force?: boolean, onlyGlobalFilter?: boolean): void;
     clearSorts(dt: Table, force?: boolean): void;
     hasToClearSorts(dt: Table, force?: boolean): boolean;
@@ -184,6 +217,9 @@ export declare class ECSPrimengTable implements OnInit, AfterViewInit, OnDestroy
     getDataAlignHorizontalAsText(dataAlignHorizontal: DataAlignHorizontal): string;
     getDataAlignVerticalAsText(dataAlignVertical: DataAlignVertical): string;
     isRowCheckboxSelected(rowID: any): boolean;
+    get allMatchingRowsSelected(): boolean;
+    get matchingRowsPartiallySelected(): boolean;
+    toggleAllMatchingRows(checked: boolean): Promise<void>;
     onRowChekboxChange(event: any, rowID: any): void;
     rowSelect(event: TableRowSelectEvent<any>): void;
     rowUnselect(event: TableRowUnSelectEvent<any>): void;

package/lib/components/ecs-primeng-table/ecs-primeng-table.service.d.ts

@@ -43,6 +43,7 @@ export declare class ECSPrimengTableService {
     sortViews(tableSaveViewList: ITableView[]): void;
     updateViewsMenuItems(tableSaveViewList: ITableView[]): MenuItem[];
     viewsSaveToDatabase(tableSaveViewList: ITableView[], setListEndpoint: string, tableViewSaveKey: string): Observable<HttpResponse<any>>;
+    fetchSelectionKeys(endpoint: string, request: ITableQueryRequest): Observable<HttpResponse<any[]>>;
     viewGenerateData(dt: Table, globalSearchText: string | null, currentPage: number, currentRowsPerPage: number, modifyFiltersFn: (filters: any) => any): ITableViewData;
     computeColumnWidths(dt: Table): any;
     computeTableWidth(dt: Table): any;

package/lib/interfaces/columns-metadata.interface.d.ts

@@ -10,6 +10,7 @@ export interface IColumnMetadata {
     field: string;
     /** Display name or ngx-translate key. Translated only for display; field and metadata are preserved. */
     header: string;
+    headerGroup?: string | null;
     /** The type of data contained in the column. */
     dataType: DataType;
     /** Optional presentation; ProgressBar renders numeric values on a 0–100 scale. */

package/lib/interfaces/table-options.interface.d.ts

@@ -1,7 +1,9 @@
 import { DataAlignHorizontal, DataAlignVertical, TableViewSaveMode } from "../enums";
 import { IColumnMetadata, IPredefinedFilter, ITableButton } from "../interfaces";
+import { ITreeTableOptions } from '../utils/tree-table-state';
 /** Configuration options for ECS Primeng table */
 export interface ITableOptions {
+    tree?: ITreeTableOptions;
     /** Optional responsive behavior. Existing applications keep their current buttons by default. */
     responsive?: {
         /** CSS viewport width where Tablet starts. Default: 768. */
@@ -308,6 +310,13 @@ export interface ITableOptions {
          * Configurations related to the row checkbox selector.
          */
         checkboxSelector?: {
+            /** Show a header checkbox selecting all filtered rows across every page. Default: false. Requires urlSelectAll. */
+            selectAllEnabled?: boolean;
+            /** POST endpoint receiving ITableQueryRequest and returning an array of selectable rowID values.
+             * Must apply the same filters and authorization as the data endpoint, without pagination.
+             * If enabledCondition is used, enforce equivalent eligibility here for unloaded rows.
+             */
+            urlSelectAll?: string;
             /**
              * If `true`, a new column with checkboxes will be displayed. Users can select or unselect rows using these checkboxes. Additionally an option to filter by this column will be enabled.
              *
@@ -423,6 +432,10 @@ export interface ITableOptions {
     };
     /** Configurations related to the global filter functionality of the table. */
     globalFilter?: {
+        /** Minimum trimmed input length before searching. Optional; default: 0. */
+        minLength?: number;
+        /** Milliseconds without typing before searching. Optional; default: 0 (existing behavior). */
+        debounceTime?: number;
         /**
          * Enables or disables the global filter input.
          *

package/lib/interfaces/table-view-data.interface.d.ts

@@ -7,6 +7,8 @@ import { IColumnMetadata } from "./columns-metadata.interface";
  * Includes information about displayed columns, widths, sorting, filtering, and pagination.
  */
 export interface ITableViewData {
+    treeExpandedKeys?: (string | number)[];
+    treeChildPages?: Record<string, number>;
     /** Array of columns currently visible in the table. */
     columnsShown: IColumnMetadata[];
     /** The total width of the table in pixels. */

package/lib/services/table-state.service.d.ts

@@ -10,6 +10,9 @@ export interface ITableNavigationState {
     globalSearchText: string | null;
     currentPage: number;
     currentRowsPerPage: number;
+    treeMode?: 'all' | 'onDemand' | 'pagedChildren';
+    treeExpandedKeys?: (string | number)[];
+    treeChildPages?: Record<string, number>;
 }
 /**
  * Provide on the parent COMPONENT containing the list and detail router outlet.

package/lib/utils/tree-table-state.d.ts

@@ -0,0 +1,66 @@
+export type TreeKey = string | number;
+export type TreeRow = Record<string, unknown>;
+export type TreeLoadMode = 'all' | 'onDemand' | 'pagedChildren';
+export interface ITreeTableOptions {
+    keyExpr: string;
+    parentIdExpr: string;
+    rootValue?: TreeKey | null;
+    hasItemsExpr?: string;
+    column: string;
+    loadMode?: TreeLoadMode;
+}
+export interface ITreeResponse {
+    data: TreeRow[];
+    page: number;
+    totalRecords: number;
+    totalRecordsNotFiltered: number;
+    ancestorKeys?: TreeKey[];
+}
+export interface ITreeRequest {
+    roots: boolean;
+    parentId: TreeKey | null;
+    loadMode: TreeLoadMode;
+    page: number;
+    pageSize: number;
+}
+export declare class TreeTableState {
+    readonly options: ITreeTableOptions;
+    readonly expanded: Set<TreeKey>;
+    private readonly nodes;
+    private readonly children;
+    private readonly totals;
+    private readonly pages;
+    private entries;
+    private roots;
+    private allRoots;
+    private version;
+    private readonly pending;
+    private restoredPages;
+    visible: TreeRow[];
+    loading: boolean;
+    page: number;
+    pageSize: number;
+    totalRecords: number;
+    totalRecordsNotFiltered: number;
+    constructor(options: ITreeTableOptions);
+    get mode(): TreeLoadMode;
+    get rootValue(): TreeKey | null;
+    key(row: TreeRow): TreeKey;
+    restore(keys?: TreeKey[], pages?: Record<string, number>): void;
+    snapshotPages(): Record<string, number>;
+    depth(row: TreeRow): number;
+    isMore(row: TreeRow): boolean;
+    moreParent(row: TreeRow): TreeKey | undefined;
+    isExpanded(row: TreeRow): boolean;
+    isLoading(row: TreeRow): boolean;
+    hasChildren(row: TreeRow): boolean;
+    cancel(): void;
+    load(page: number, pageSize: number, fetch: (request: ITreeRequest) => Promise<ITreeResponse>): Promise<boolean>;
+    toggle(row: TreeRow, fetch: (request: ITreeRequest) => Promise<ITreeResponse>): Promise<void>;
+    loadMore(row: TreeRow, fetch: (request: ITreeRequest) => Promise<ITreeResponse>): Promise<void>;
+    private insert;
+    private buildAll;
+    private fetchChildren;
+    private hasMore;
+    private rebuild;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@competer/primeng-table",
-  "version": "19.1.8",
+  "version": "19.2.0",
   "description": "Community-maintained fork of ECS. Reusable Angular PrimeNG table component with advanced server-side filters. Designed to offload filtering logic to any backend API.",
   "author": "ECS (Eternal CODE Studio); ComPeter",
   "license": "MIT",

package/public-api.d.ts

@@ -4,6 +4,7 @@ export * from './lib/interfaces/predefined-filter.interface';
 export * from './lib/interfaces/table-button.interface';
 export * from './lib/interfaces/table-options.interface';
 export * from "./lib/utils/create-table-options";
+export * from './lib/utils/tree-table-state';
 export * from './lib/services';
 export * from './lib/components/ecs-primeng-table/ecs-primeng-table';
 export * from './lib/components/ecs-primeng-table/ecs-primeng-table.service';