@shival99/z-ui 2.1.5 → 2.1.7

package/types/shival99-z-ui-components-z-table.d.ts

@@ -7,7 +7,7 @@ import * as _angular_core from '@angular/core';
 import { TemplateRef, Type, AfterViewInit, ElementRef, OnInit } from '@angular/core';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { ConnectedPosition } from '@angular/cdk/overlay';
-import { ZPopoverControl, ZPopoverDirective } from '@shival99/z-ui/components/z-popover';
+import { ZPopoverPosition, ZPopoverTrigger, ZPopoverControl, ZPopoverDirective } from '@shival99/z-ui/components/z-popover';
 import { ClassValue } from 'clsx';
 import { NgScrollbar } from 'ngx-scrollbar';
 import { ZAutocompleteType, ZAutocompleteOption } from '@shival99/z-ui/components/z-autocomplete';
@@ -17,7 +17,7 @@ import { ZSelectOption, ZSelectConfig, ZSelectMode } from '@shival99/z-ui/compon
 import * as _shival99_z_ui_components_z_tags from '@shival99/z-ui/components/z-tags';
 import { ZTagColor } from '@shival99/z-ui/components/z-tags';
 import * as _shival99_z_ui_components_z_tooltip from '@shival99/z-ui/components/z-tooltip';
-import { ZTooltipConfig, ZTooltipContent } from '@shival99/z-ui/components/z-tooltip';
+import { ZTooltipConfig, ZTooltipContent, ZTooltipTrigger } from '@shival99/z-ui/components/z-tooltip';
 import { ZExcelColumnConfig, ZExcelExportOptions } from '@shival99/z-ui/services';
 import { ZDateRange } from '@shival99/z-ui/components/z-calendar';
 import { ZDropdownMenuItem } from '@shival99/z-ui/components/z-dropdown-menu';
@@ -78,6 +78,43 @@ interface ZTableGroupLabelContext<T> {
     rows: Row<T>[];
 }
 type ZTableGroupLabelFormatter<T> = (context: ZTableGroupLabelContext<T>) => string;
+type ZTablePopoverContent = string | TemplateRef<unknown>;
+interface ZTablePopoverConfig {
+    content?: ZTablePopoverContent;
+    position?: ZPopoverPosition;
+    trigger?: ZPopoverTrigger;
+    class?: string;
+    showDelay?: number;
+    hideDelay?: number;
+    disabled?: boolean;
+    offset?: number;
+    width?: 'auto' | 'trigger' | number;
+    manualClose?: boolean;
+    outsideClickClose?: boolean;
+    scrollClose?: boolean;
+    sticky?: boolean;
+    showArrow?: boolean;
+    keyboardSafe?: boolean;
+}
+type ZTableBodyPopoverConfig<T> = string | ZTablePopoverConfig | TemplateRef<unknown> | ((info: CellContext<T, unknown>) => string | ZTablePopoverConfig | TemplateRef<unknown>);
+interface ZTableGroupTotalContext<T> {
+    columnId: string;
+    rows: Row<T>[];
+    value: unknown;
+    depth: number;
+}
+type ZTableGroupTotalContent<T> = 'sum' | ((context: ZTableGroupTotalContext<T>) => unknown);
+interface ZTableGroupTotalConfig<T = unknown> {
+    columnId: string;
+    content?: ZTableGroupTotalContent<T>;
+    class?: string;
+    tooltip?: string | TemplateRef<unknown> | ZTableTooltipConfig;
+    popover?: ZTablePopoverContent | ZTablePopoverConfig;
+}
+interface ZTableTooltipConfig extends ZTooltipConfig {
+    trigger?: ZTooltipTrigger;
+}
+type ZTableBodyTooltipConfig<T> = string | ZTableTooltipConfig | TemplateRef<unknown> | ((info: CellContext<T, unknown>) => string | ZTableTooltipConfig | TemplateRef<unknown>);
 /** Available column filter value input hints */
 type ZTableFilterValueType = 'text' | 'number';
 type ZTableFilterUi = 'basic' | 'advanced' | 'custom';
@@ -287,7 +324,8 @@ interface ZTableBodyColumnConfig<T> {
     colSpan?: number | ((info: CellContext<T, unknown>) => number);
     contentClass?: string | ((info: CellContext<T, unknown>) => string);
     contentStyle?: Record<string, string> | ((info: CellContext<T, unknown>) => Record<string, string>);
-    tooltip?: string | ZTooltipConfig | ((info: CellContext<T, unknown>) => string | ZTooltipConfig);
+    tooltip?: ZTableBodyTooltipConfig<T>;
+    popover?: ZTableBodyPopoverConfig<T>;
     /**
      * Action buttons rendered inside this cell.
      *
@@ -397,8 +435,10 @@ interface ZTableServerGroup {
     count?: number;
     /** Đang fetch rows cho group này (hiển thị loading trong group). */
     loading?: boolean;
+    /** Tổng theo cột do server cung cấp, key là columnId. */
+    totals?: Record<string, unknown>;
 }
-interface ZTableGroupingConfig {
+interface ZTableGroupingConfig<T = unknown> {
     enabled?: boolean;
     mode?: ZTableGroupingMode;
     /** Các cột được phép group từ header menu. */
@@ -408,6 +448,8 @@ interface ZTableGroupingConfig {
     allowHeaderMenu?: boolean;
     defaultExpanded?: boolean;
     showCount?: boolean;
+    /** Cấu hình các cột cần hiển thị tổng trên group row. */
+    totals?: ZTableGroupTotalConfig<T>[];
     /**
      * Cột đang group ở chế độ server (bắt buộc cho server grouping vì table không tự suy ra).
      * Nếu bỏ trống, dùng phần tử đầu của `columns`.
@@ -896,7 +938,7 @@ interface ZTableConfig<T> {
     enableColumnPinning?: boolean;
     enableColumnOrdering?: boolean;
     enableColumnSorting?: boolean;
-    enableGrouping?: ZTableGroupingConfig | boolean;
+    enableGrouping?: ZTableGroupingConfig<T> | boolean;
     pagination?: ZTablePaginationConfig;
     initialState?: ZTableInitialState;
     loading?: boolean;
@@ -981,6 +1023,7 @@ interface ZTableGroupRowItem {
     expanded: boolean;
     /** Server grouping: group đang fetch child rows. */
     loading?: boolean;
+    totals?: Record<string, unknown>;
 }
 interface ZTableDataRowItem<T> {
     type: 'row';
@@ -1211,7 +1254,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly hasSorting: _angular_core.Signal<boolean>;
     protected readonly hasLocalSorting: _angular_core.Signal<boolean>;
     protected readonly hasServerFiltering: _angular_core.Signal<boolean>;
-    protected readonly groupingConfig: _angular_core.Signal<ZTableGroupingConfig>;
+    protected readonly groupingConfig: _angular_core.Signal<ZTableGroupingConfig<T>>;
     /** EN/VI: true khi grouping chạy ở chế độ server (group meta do server cung cấp). */
     protected readonly isServerGrouping: _angular_core.Signal<boolean>;
     protected readonly canUseGrouping: _angular_core.Signal<boolean>;
@@ -1220,6 +1263,8 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly activeGroupingColumnIds: _angular_core.Signal<string[]>;
     protected readonly activeGroupingColumnId: _angular_core.Signal<string>;
     protected readonly groupingColumnMap: _angular_core.Signal<Record<string, boolean>>;
+    protected readonly groupTotalColumnMap: _angular_core.Signal<Record<string, boolean>>;
+    protected readonly groupTotalConfigMap: _angular_core.Signal<Record<string, ZTableGroupTotalConfig<T>>>;
     protected readonly groupableColumnMap: _angular_core.Signal<Record<string, boolean>>;
     protected readonly groupingHeaderMenuMap: _angular_core.Signal<Record<string, boolean>>;
     protected readonly groupedCenterRowItems: _angular_core.Signal<ZTableGroupedRowItem<T>[]>;
@@ -1231,6 +1276,8 @@ declare class ZTableComponent<T> implements AfterViewInit {
      * Child rows lấy từ `getCenterRows()` (data parent đã fetch) và gán vào group theo value.
      */
     private _buildServerGroupedItems;
+    private _getGroupTotals;
+    private _sumGroupColumn;
     /**
      * EN: Flat list of body rows in the exact order they are rendered. When grouping is active the
      *     center rows are re-ordered group-by-group, so the flat `table.getRowModel().rows` no longer
@@ -1658,13 +1705,13 @@ declare class ZTableFilterComponent<T> {
 
 declare class ZTableIconTextComponent {
     readonly zText: _angular_core.InputSignal<string>;
-    readonly zTooltip: _angular_core.InputSignal<string | ZTooltipConfig>;
+    readonly zTooltip: _angular_core.InputSignal<ZTooltipConfig | ZTooltipContent>;
     readonly zTriggerElement: _angular_core.InputSignal<HTMLElement | null>;
     private readonly _hostEl;
     private readonly _zTranslate;
     protected readonly triggerEl: _angular_core.Signal<any>;
     protected readonly translatedParts: _angular_core.Signal<ZTableIconPart[]>;
-    protected readonly tooltipContent: _angular_core.Signal<string>;
+    protected readonly tooltipContent: _angular_core.Signal<ZTooltipContent>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZTableIconTextComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZTableIconTextComponent, "z-table-icon-text", never, { "zText": { "alias": "zText"; "required": false; "isSignal": true; }; "zTooltip": { "alias": "zTooltip"; "required": false; "isSignal": true; }; "zTriggerElement": { "alias": "zTriggerElement"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -1673,7 +1720,7 @@ declare class ZTableActionsComponent<T = unknown> {
     readonly zConfig: _angular_core.InputSignal<ZTableActionColumnConfig<T>>;
     readonly zRow: _angular_core.InputSignal<T>;
     readonly zRowId: _angular_core.InputSignal<string>;
-    readonly zDropdownButtonSize: _angular_core.InputSignal<"default" | "sm" | "lg" | "xs" | "xl" | null | undefined>;
+    readonly zDropdownButtonSize: _angular_core.InputSignal<"sm" | "default" | "lg" | "xs" | "xl" | null | undefined>;
     readonly zActionClick: _angular_core.OutputEmitterRef<ZTableActionClickEvent<T>>;
     protected readonly allActions: _angular_core.Signal<ZTableActionItem<T>[]>;
     protected readonly shouldShowAsButtons: _angular_core.Signal<boolean>;
@@ -1778,6 +1825,7 @@ declare const getBodyConfig: <T>(col: ZTableColumnConfig<T> | undefined, ctx?: C
     contentClass: string | undefined;
     contentStyle: Record<string, string> | undefined;
     tooltip: string | object | undefined;
+    popover: string | object | undefined;
 } | {
     content: ZTableCellContent<T> | undefined;
     type: _shival99_z_ui_components_z_table.ZTableBodyContentType;
@@ -1789,7 +1837,8 @@ declare const getBodyConfig: <T>(col: ZTableColumnConfig<T> | undefined, ctx?: C
     colSpan: number | undefined;
     contentClass: string | ((info: CellContext<T, unknown>) => string) | undefined;
     contentStyle: Record<string, string> | undefined;
-    tooltip: string | _shival99_z_ui_components_z_tooltip.ZTooltipConfig | ((info: CellContext<T, unknown>) => string | _shival99_z_ui_components_z_tooltip.ZTooltipConfig) | undefined;
+    tooltip: ZTableBodyTooltipConfig<T> | undefined;
+    popover: ZTableBodyPopoverConfig<T> | undefined;
 };
 declare const getFooterConfig: <T>(col: ZTableColumnConfig<T> | undefined, footerRowIndex?: number) => {
     content: ZTableHeaderContent<T> | undefined;

package/types/shival99-z-ui-components-z-tooltip.d.ts

@@ -17,6 +17,7 @@ type ZTooltipContent = string | TemplateRef<unknown>;
 interface ZTooltipConfig {
     content?: ZTooltipContent;
     position?: ZTooltipPosition;
+    trigger?: ZTooltipTrigger;
     type?: ZTooltipVariants['zType'];
     size?: ZTooltipVariants['zSize'];
     class?: string;