@acorex/components 22.2.12 → 22.2.14

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex/components",
-  "version": "22.2.12",
+  "version": "22.2.14",
   "peerDependencies": {
-    "@acorex/core": "22.2.12",
-    "@acorex/cdk": "22.2.12",
+    "@acorex/core": "22.2.14",
+    "@acorex/cdk": "22.2.14",
     "@angular/aria": ">=22.1.0",
     "polytype": ">=0.17.0",
     "hammerjs": ">=2.0.8",

package/types/acorex-components-data-table.d.ts

@@ -1,7 +1,7 @@
 import * as i2 from '@acorex/cdk/common';
 import { AXSortOrder, MXBaseComponent, AXDataSource, AXStyleColorType, AXEvent, AXButtonClickEvent, AXStyleLookType, AXClickEvent, AXItemClickEvent, AXValueChangedEvent } from '@acorex/cdk/common';
 import * as i0 from '@angular/core';
-import { TemplateRef, EventEmitter, WritableSignal, ChangeDetectorRef, OnInit, AfterViewInit, Signal, QueryList } from '@angular/core';
+import { QueryList, TemplateRef, EventEmitter, WritableSignal, ChangeDetectorRef, OnInit, AfterViewInit, Signal } from '@angular/core';
 import * as i11 from '@acorex/core/format';
 import { AXFormatOptions } from '@acorex/core/format';
 import * as i8 from '@acorex/components/button';
@@ -39,6 +39,12 @@ declare abstract class AXDataTableColumnComponent {
     hasTitle: boolean;
     sortIndex: number | undefined;
     sortOrder: AXSortOrder | undefined;
+    childColumns: QueryList<AXDataTableColumnComponent>;
+    /** Set by the data table when this leaf sits under a fixed top-level band. */
+    effectiveFixed: 'start' | 'end' | undefined;
+    get isBand(): boolean;
+    getLeafColumns(): AXDataTableColumnComponent[];
+    getHeaderDepth(): number;
     abstract get renderCellTemplate(): TemplateRef<unknown>;
     abstract get renderHeaderTemplate(): TemplateRef<unknown>;
     abstract get renderFooterTemplate(): TemplateRef<unknown>;
@@ -46,7 +52,7 @@ declare abstract class AXDataTableColumnComponent {
     abstract get name(): string;
     get cssClass(): string | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXDataTableColumnComponent, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXDataTableColumnComponent>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AXDataTableColumnComponent, never, never, { "caption": { "alias": "caption"; "required": false; }; "width": { "alias": "width"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "allowSorting": { "alias": "allowSorting"; "required": false; }; "allowResizing": { "alias": "allowResizing"; "required": false; }; "hasTitle": { "alias": "hasTitle"; "required": false; }; "sortIndex": { "alias": "sortIndex"; "required": false; }; "sortOrder": { "alias": "sortOrder"; "required": false; }; }, {}, ["childColumns"], never, true, never>;
 }
 
 type AXDataTableCssClassValue = string | null | undefined;
@@ -212,9 +218,13 @@ declare abstract class AXBaseDataTable extends MXBaseComponent {
      */
     getColumnHighlightColor(column: AXDataTableColumnComponent): AXDataTableRowColorType | null;
     /**
-     * Returns column CSS classes for header and body cells (`cssClass` + temporary highlight).
+     * Returns the CSS class of a highlighted column, applied to its header and body cells.
      */
     getColumnCssClass(column: AXDataTableColumnComponent): string;
+    /**
+     * Header `<th>` classes: column highlight + column `cssClass` (e.g. `ax-select-column`).
+     */
+    getHeadColumnCssClass(column: AXDataTableColumnComponent): string;
     /**
      * Returns the temporary highlight state for a row, if any.
      */
@@ -456,7 +466,7 @@ declare class AXDataTableTextColumnComponent extends AXDataTableColumnComponent
      */
     formatOptions: AXFormatOptions;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXDataTableTextColumnComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXDataTableTextColumnComponent, "ax-text-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "allowSorting": { "alias": "allowSorting"; "required": false; }; "allowResizing": { "alias": "allowResizing"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "hasTitle": { "alias": "hasTitle"; "required": false; }; "customExpandIcon": { "alias": "customExpandIcon"; "required": false; }; "customCollapseIcon": { "alias": "customCollapseIcon"; "required": false; }; "dataField": { "alias": "dataField"; "required": false; }; "expandHandler": { "alias": "expandHandler"; "required": false; }; "wrapText": { "alias": "wrapText"; "required": false; }; "translate": { "alias": "translate"; "required": false; }; "cellTemplate": { "alias": "cellTemplate"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; "format": { "alias": "format"; "required": false; }; "formatOptions": { "alias": "formatOptions"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXDataTableTextColumnComponent, "ax-text-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "allowSorting": { "alias": "allowSorting"; "required": false; }; "allowResizing": { "alias": "allowResizing"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "hasTitle": { "alias": "hasTitle"; "required": false; }; "customExpandIcon": { "alias": "customExpandIcon"; "required": false; }; "customCollapseIcon": { "alias": "customCollapseIcon"; "required": false; }; "dataField": { "alias": "dataField"; "required": false; }; "expandHandler": { "alias": "expandHandler"; "required": false; }; "wrapText": { "alias": "wrapText"; "required": false; }; "translate": { "alias": "translate"; "required": false; }; "cellTemplate": { "alias": "cellTemplate"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; "format": { "alias": "format"; "required": false; }; "formatOptions": { "alias": "formatOptions"; "required": false; }; }, {}, never, ["*"], true, never>;
 }
 
 type AXRowCommandItem = AXButtonItemListItem & {
@@ -542,7 +552,7 @@ declare class AXRowDropdownCommandColumnComponent extends AXBaseRowCommandColumn
      */
     protected handleOnItemClick(e: AXItemClickEvent<AXButtonItemComponent>, data: unknown): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXRowDropdownCommandColumnComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowDropdownCommandColumnComponent, "ax-dropdown-command-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "emptyStateTemplate": { "alias": "emptyStateTemplate"; "required": false; }; "emptyStateText": { "alias": "emptyStateText"; "required": false; }; "items": { "alias": "items"; "required": false; }; }, { "onItemClick": "onItemClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowDropdownCommandColumnComponent, "ax-dropdown-command-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "emptyStateTemplate": { "alias": "emptyStateTemplate"; "required": false; }; "emptyStateText": { "alias": "emptyStateText"; "required": false; }; "items": { "alias": "items"; "required": false; }; }, { "onItemClick": "onItemClick"; }, never, ["*"], true, never>;
 }
 /**
  * A column for displaying command buttons in a data table.
@@ -604,7 +614,7 @@ declare class AXRowCommandColumnComponent extends AXBaseRowCommandColumnComponen
     protected getCommandId(rowData: unknown, item: AXRowCommandItem): string;
     protected handleOnItemClick(e: AXClickEvent, item: AXRowCommandItem, data: unknown): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXRowCommandColumnComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowCommandColumnComponent, "ax-command-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "items": { "alias": "items"; "required": false; }; }, { "onItemClick": "onItemClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowCommandColumnComponent, "ax-command-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "items": { "alias": "items"; "required": false; }; }, { "onItemClick": "onItemClick"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -652,7 +662,7 @@ declare class AXRowExpandColumnComponent extends AXDataTableColumnComponent {
      */
     get loadingEnabled(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXRowExpandColumnComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowExpandColumnComponent, "ax-expand-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowExpandColumnComponent, "ax-expand-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; }, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -724,16 +734,24 @@ declare class AXRowIndexColumnComponent extends AXDataTableColumnComponent imple
      */
     get cssClass(): string | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXRowIndexColumnComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowIndexColumnComponent, "ax-index-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "padZero": { "alias": "padZero"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowIndexColumnComponent, "ax-index-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "padZero": { "alias": "padZero"; "required": false; }; }, {}, never, ["*"], true, never>;
 }
 
 /**
  * Column component that provides checkboxes for row selection in a data table.
+ * The header shows a split control: the checkbox selects all visible rows; the chevron opens
+ * a menu with reverse selection and unselect actions for visible rows.
  *
  * @category Components
  */
 declare class AXRowSelectColumnComponent extends AXDataTableColumnComponent {
     private grid;
+    /**
+     * When enabled, shows a header dropdown with reverse and unselect actions for visible rows.
+     *
+     * @defaultValue `false`
+     */
+    advanceSelect: i0.InputSignal<boolean>;
     /**
      *  @ignore
      */
@@ -748,6 +766,7 @@ declare class AXRowSelectColumnComponent extends AXDataTableColumnComponent {
     private _contentHeaderTemplate;
     /**
      * Gets the template used to render the column header.
+     * Renders the header checkbox; when {@link advanceSelect} is enabled, a chevron opens a menu with Reverse and Unselect actions scoped to visible rows.
      */
     get renderHeaderTemplate(): TemplateRef<unknown>;
     /**
@@ -766,14 +785,37 @@ declare class AXRowSelectColumnComponent extends AXDataTableColumnComponent {
      *  @ignore
      */
     private getDataSourceKey;
+    /**
+     *  @ignore
+     */
+    private resolveSelectableRows;
     /**
      *  @ignore
      */
     protected isSelected(item: unknown): boolean;
+    /**
+     * Header checkbox model: `true` when every visible row is selected, `false` when none are,
+     * and `null` for a partial (indeterminate) selection.
+     *
+     * @ignore
+     */
+    headerCheckboxValue(rows: unknown[] | null | undefined, selectedRows?: unknown[]): boolean;
+    /**
+     *  @ignore
+     */
+    onHeaderSelectAll(e: AXValueChangedEvent, rows: unknown[] | null | undefined): void;
+    /**
+     *  @ignore
+     */
+    onHeaderReverseSelect(rows: unknown[] | null | undefined): void;
     /**
      *  @ignore
      */
-    protected checkAllSelected(rows: any): boolean;
+    onHeaderUnselect(rows: unknown[] | null | undefined): void;
+    /**
+     *  @ignore
+     */
+    protected checkAllSelected(rows: unknown[] | null | undefined, selectedRows?: unknown[]): boolean | null;
     /**
      *  @ignore
      */
@@ -781,7 +823,15 @@ declare class AXRowSelectColumnComponent extends AXDataTableColumnComponent {
     /**
      *  @ignore
      */
-    protected handleSelectAll(e: AXValueChangedEvent, rows: any): void;
+    protected handleSelectAll(e: AXValueChangedEvent, rows: unknown[] | null | undefined): void;
+    /**
+     *  @ignore
+     */
+    protected handleReverseSelect(rows: unknown[] | null | undefined): void;
+    /**
+     *  @ignore
+     */
+    protected handleUnselect(rows: unknown[] | null | undefined): void;
     /**
      * Indicates whether loading is enabled for the column.
      */
@@ -791,7 +841,30 @@ declare class AXRowSelectColumnComponent extends AXDataTableColumnComponent {
      */
     get cssClass(): string | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXRowSelectColumnComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowSelectColumnComponent, "ax-select-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXRowSelectColumnComponent, "ax-select-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "advanceSelect": { "alias": "advanceSelect"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+interface DataTableBandHeaderCell {
+    type: 'band';
+    caption: string;
+    colspan: number;
+    /** Top-level column used for drag-reorder on the first header row. */
+    column: AXDataTableColumnComponent;
+}
+interface DataTableLeafHeaderCell {
+    type: 'leaf';
+    column: AXDataTableColumnComponent;
+    rowspan: number;
+}
+interface DataTableGapHeaderCell {
+    type: 'gap';
+}
+type DataTableHeaderCell = DataTableBandHeaderCell | DataTableLeafHeaderCell | DataTableGapHeaderCell;
+interface DataTableHeaderRowModel {
+    start: DataTableHeaderCell[];
+    normal: DataTableHeaderCell[];
+    end: DataTableHeaderCell[];
+    includeSpacer: boolean;
 }
 
 /**
@@ -845,24 +918,75 @@ declare class AXDataTableComponent extends AXBaseDataTable implements OnInit, Af
     /**
      *  @ignore
      */
-    protected columnsList: WritableSignal<any[]>;
+    protected columnsList: WritableSignal<AXDataTableColumnComponent[]>;
+    /**
+     * Top-level column tree (bands and leaves) in display order.
+     * @ignore
+     */
+    protected topLevelColumnsList: WritableSignal<AXDataTableColumnComponent[]>;
+    /**
+     *  @ignore
+     */
+    protected headerDepth: Signal<number>;
     /**
      *  @ignore
      */
-    protected endFixedColumnsList: Signal<any[]>;
+    protected headerRows: Signal<DataTableHeaderRowModel[]>;
     /**
      *  @ignore
      */
-    protected startFixedColumnsList: Signal<any[]>;
+    protected topLevelEndFixedColumnsList: Signal<AXDataTableColumnComponent[]>;
     /**
      *  @ignore
      */
-    protected normalColumnsList: Signal<any[]>;
+    protected topLevelStartFixedColumnsList: Signal<AXDataTableColumnComponent[]>;
+    /**
+     *  @ignore
+     */
+    protected topLevelNormalColumnsList: Signal<AXDataTableColumnComponent[]>;
+    /**
+     *  @ignore
+     */
+    protected endFixedColumnsList: Signal<AXDataTableColumnComponent[]>;
+    /**
+     *  @ignore
+     */
+    protected startFixedColumnsList: Signal<AXDataTableColumnComponent[]>;
+    /**
+     *  @ignore
+     */
+    protected normalColumnsList: Signal<AXDataTableColumnComponent[]>;
     /**
      * True when a text column owns the tree expander. That column stays `width: auto`
      * so leftover table space is used for nested indent instead of the empty spacer.
      */
     protected hasTreeFillColumn: Signal<boolean>;
+    /**
+     *  @ignore
+     */
+    protected isSelectColumn(column: AXDataTableColumnComponent): column is AXRowSelectColumnComponent;
+    /**
+     * @ignore
+     */
+    protected getEffectiveFixed(column: AXDataTableColumnComponent): 'start' | 'end' | undefined;
+    /**
+     * @ignore
+     */
+    protected isHeaderBandCell(cell: DataTableHeaderCell): cell is DataTableBandHeaderCell;
+    /**
+     * @ignore
+     */
+    protected isHeaderGapCell(cell: DataTableHeaderCell): boolean;
+    /**
+     * @ignore
+     */
+    protected asLeafHeaderCell(cell: DataTableHeaderCell): DataTableLeafHeaderCell;
+    /**
+     * @ignore
+     */
+    protected isTopLevelColumn(column: AXDataTableColumnComponent): boolean;
+    private refreshColumnStructure;
+    private watchBandChildren;
     /**
      *  @ignore
      */
@@ -871,6 +995,7 @@ declare class AXDataTableComponent extends AXBaseDataTable implements OnInit, Af
         startWidth: number;
         column: AXDataTableColumnComponent | null;
         thElement: HTMLElement | null;
+        colElement: HTMLElement | null;
         /** True when the resize handle sits on the column's trailing edge in screen coordinates. */
         resizeFromTrailingEdge: boolean;
     };
@@ -1182,6 +1307,11 @@ declare class AXDataTableComponent extends AXBaseDataTable implements OnInit, Af
      *  @ignore
      */
     private resetResizingProcess;
+    /**
+     * Index of a leaf column in `<colgroup>` (start → normal → spacer → end).
+     */
+    private getColumnColIndex;
+    private resolveColElementForColumn;
     /**
      *  @ignore
      */