@sdcorejs/angular 19.1.6 → 19.2.1

package/components/tab-router/src/services/tab-router.service.d.ts

@@ -3,24 +3,24 @@ import { BehaviorSubject } from 'rxjs';
 import { SdTabAction } from '../actions/tab-router.action';
 import { SdTabComponentBuilder } from '../decorators/tab.decorator';
 import { SdTabEvent } from '../events/tab-router.event';
-import { SdTab } from '../models/tab-router.model';
+import { SdTabRouterTab } from '../models/tab-router.model';
 import * as i0 from "@angular/core";
 export declare class SdTabRouterService {
     #private;
     events: BehaviorSubject<SdTabEvent>;
     actions: BehaviorSubject<SdTabAction | undefined>;
     builders: BehaviorSubject<SdTabComponentBuilder[]>;
-    currentTabChanges: BehaviorSubject<SdTab | undefined>;
-    newTabs: BehaviorSubject<SdTab | undefined>;
-    updateTabs: BehaviorSubject<SdTab | undefined>;
+    currentTabChanges: BehaviorSubject<SdTabRouterTab | undefined>;
+    newTabs: BehaviorSubject<SdTabRouterTab | undefined>;
+    updateTabs: BehaviorSubject<SdTabRouterTab | undefined>;
     addBuilder: (builder: SdTabComponentBuilder) => void;
-    get currentTab(): SdTab | undefined;
+    get currentTab(): SdTabRouterTab | undefined;
     get currentKey(): string | null;
-    setCurrentTab: (tab: SdTab) => void;
-    pushEvent: (tab: SdTab, Event: Type<SdTabEvent>) => void;
+    setCurrentTab: (tab: SdTabRouterTab) => void;
+    pushEvent: (tab: SdTabRouterTab, Event: Type<SdTabEvent>) => void;
     setOptions: () => void;
-    close: (tab?: SdTab) => void;
-    updateTab: (tab: SdTab) => void;
+    close: (tab?: SdTabRouterTab) => void;
+    updateTab: (tab: SdTabRouterTab) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdTabRouterService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdTabRouterService>;
 }

package/components/table/index.d.ts

@@ -1,4 +1,5 @@
 export * from './src/directives/sd-table-cell-def.directive';
+export * from './src/directives/sd-table-command-header-def.directive';
 export * from './src/directives/sd-table-expand-def.directive';
 export * from './src/directives/sd-table-filter-def.directive';
 export * from './src/directives/sd-table-footer-def.directive';

package/components/table/src/components/config/config.component.d.ts

@@ -1,7 +1,7 @@
 import { MatTable } from '@angular/material/table';
 import { SdModal } from '@sdcorejs/angular/components/modal';
 import { SdTableColumn } from '../../models/table-column.model';
-import { ConfiguredTable, ConfiguredTableResult } from '../../models/table-option-config.model';
+import { ConfiguredColumn, ConfiguredTable, ConfiguredTableResult } from '../../models/table-option-config.model';
 import { SdTableOption } from '../../models/table-option.model';
 import * as i0 from "@angular/core";
 export declare class ConfigComponent {
@@ -19,6 +19,11 @@ export declare class ConfigComponent {
     close: () => void;
     onSave: () => void;
     onReset: () => Promise<void>;
+    /**
+     * Cột đang tắt hiển thị thì tiêu đề / độ rộng / cố định / giới hạn ký tự đều vô nghĩa —
+     * khoá chúng lại để row nói rõ trạng thái, chỉ chừa ô "Hiển thị" để bật lại.
+     */
+    isRowDisabled: (item: ConfiguredColumn) => boolean;
     dropTable(event: any): void;
     handleMouseDown(): void;
     handleMouseUp(): void;

package/components/table/src/components/desktop-cell/view/view.component.d.ts

@@ -19,6 +19,7 @@ export declare class ViewComponent {
     truncateWidth: import("@angular/core").Signal<string | undefined>;
     constructor();
     toggle: () => void;
+    onViewKeydown: (event: KeyboardEvent) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ViewComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ViewComponent, "view", never, { "autoId": { "alias": "autoId"; "required": true; "isSignal": true; }; "column": { "alias": "column"; "required": true; "isSignal": true; }; "item": { "alias": "item"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/components/table/src/components/filter/external-filter/external-filter.component.d.ts

@@ -4,7 +4,7 @@ import * as i0 from "@angular/core";
 export declare class ExternalFilterComponent {
     #private;
     autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
-    filter: import("@angular/core").InputSignal<SdTableOptionFilter<any> | undefined>;
+    filter: import("@angular/core").InputSignal<SdTableOptionFilter<unknown> | undefined>;
     externalFilters: import("@angular/core").InputSignal<SdTableExternalFilter[] | null | undefined>;
     filterRegister: import("@angular/core").InputSignal<TableFilterRegister | undefined>;
     externalFilter: import("@angular/core").WritableSignal<Record<string, any>>;

package/components/table/src/components/filter/mobile-filter/mobile-filter.component.d.ts

@@ -19,7 +19,7 @@ import * as i0 from "@angular/core";
  */
 export declare class MobileFilterComponent {
     autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
-    filter: import("@angular/core").InputSignal<SdTableOptionFilter<any> | undefined>;
+    filter: import("@angular/core").InputSignal<SdTableOptionFilter<unknown> | undefined>;
     externalFilters: import("@angular/core").InputSignal<SdTableExternalFilter[] | null | undefined>;
     columns: import("@angular/core").InputSignal<SdTableColumn[] | null | undefined>;
     filterDefs: import("@angular/core").InputSignal<readonly SdTableFilterDefDirective[] | null | undefined>;

package/components/table/src/components/selector-action/action-filter.pipe.d.ts

@@ -4,8 +4,15 @@ import { SdTableItem } from '../../models/table-item.model';
 import { SdButton } from '@sdcorejs/angular/components/button';
 import { SdUnwrapSignal } from '@sdcorejs/angular/utilities/models';
 import * as i0 from "@angular/core";
+/**
+ * Resolves the bulk actions a selection is allowed to run.
+ *
+ * why: tách khỏi pipe để component đọc được cùng KẾT QUẢ trong `computed()` — quick-action chỉ
+ * được mở khi danh sách này KHÔNG rỗng, mà điều đó phải quyết định trong TS chứ không thể suy ra
+ * từ một pipe chỉ chạy trong template.
+ */
+export declare function sdResolveTableActions(selectedItems: SdTableItem[] | undefined, actions: SdTableAction[] | undefined): Action[];
 export declare class ActionFilterPipe implements PipeTransform {
-    #private;
     transform: (selectedItems: SdTableItem[] | undefined, actions: SdTableAction[] | undefined) => Action[];
     static ɵfac: i0.ɵɵFactoryDeclaration<ActionFilterPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<ActionFilterPipe, "actionFilter", true>;

package/components/table/src/components/selector-action/selector-action.component.d.ts

@@ -10,6 +10,8 @@ export declare class SelectorActionComponent {
     clear: import("@angular/core").OutputEmitterRef<void>;
     autoId: import("@angular/core").Signal<string>;
     message: import("@angular/core").Signal<string>;
+    /** Bulk actions the current selection is allowed to run. */
+    actions: import("@angular/core").Signal<Action[]>;
     opened: import("@angular/core").Signal<boolean>;
     onClear: () => void;
     onClickAction: (action: Action) => void;

package/components/table/src/directives/index.d.ts

@@ -2,5 +2,6 @@ export * from './sd-table-column-filter-def.directive';
 export * from './sticky-shadow.directive';
 export * from './sd-table-title-def.directive';
 export * from './sd-table-cell-def.directive';
+export * from './sd-table-command-header-def.directive';
 export * from './sd-table-group-def.directive';
 export * from './sd-column-resize.directive';

package/components/table/src/directives/sd-table-command-header-def.directive.d.ts

@@ -0,0 +1,24 @@
+import { TemplateRef } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Nội dung cho ô HEADER của cột command.
+ *
+ * Ô đó vốn để trống — chỉ giữ chỗ cho các nút thao tác bên dưới — nên đây là chỗ tự nhiên để đặt
+ * một hành động cấp bảng (thường là "thêm dòng") mà không tốn thêm một dải riêng dưới bảng.
+ *
+ * Không có input: cột command chỉ có một, khác `sdTableCellDef` / `sdTableTitleDef` vốn phải chỉ
+ * đích danh field.
+ *
+ * ```html
+ * <sd-table [option]="option">
+ *   <ng-template sdTableCommandHeaderDef>
+ *     <sd-button prefixIcon="add" type="text" (click)="addRow()"></sd-button>
+ *   </ng-template>
+ * </sd-table>
+ * ```
+ */
+export declare class SdTableCommandHeaderDefDirective {
+    templateRef: TemplateRef<unknown>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdTableCommandHeaderDefDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdTableCommandHeaderDefDirective, "[sdTableCommandHeaderDef]", never, {}, {}, never, never, true, never>;
+}

package/components/table/src/models/table-column.model.d.ts

@@ -3,8 +3,25 @@ import { SdBadge } from '@sdcorejs/angular/components/badge';
 import type { SdSearch } from '@sdcorejs/angular/forms/models';
 import { NestedKeyOf, Operator } from '@sdcorejs/utils/models';
 import { SdUnwrapSignal } from '@sdcorejs/angular/utilities/models';
-export type SdTableColumn<T = any> = SdTableColumnText<T> | SdTableColumnNumber<T> | SdTableColumnBool<T> | SdTableColumnDate<T> | SdTableColumnValues<T> | SdTableColumnLazyValues<T> | SdTableColumnChildren<T>;
-export type SdTableColumnTransformFunc<T = any> = (value: any, rowData: T, args?: {
+export type SdTableColumn<T = unknown> = SdTableColumnText<T> | SdTableColumnNumber<T> | SdTableColumnBool<T> | SdTableColumnDate<T> | SdTableColumnValues<T> | SdTableColumnLazyValues<T> | SdTableColumnChildren<T>;
+/**
+ * Cột bảng dùng ở các API **không quan tâm kiểu hàng** — chúng chỉ đọc `field` / `type` / `hidden` /
+ * `filter` và không bao giờ chạm vào dữ liệu hàng (service filter, `SdConvertToPagingReq`, …).
+ *
+ * why: `SdTableColumn<T>` **bất biến (invariant)** theo `T`, vì `T` xuất hiện ở CẢ HAI chiều:
+ * - covariant — `field: NestedKeyOf<T>`;
+ * - contravariant — `transform` / `tooltip` / `click` / `useBadge` / `htmlTemplate` đều nhận `rowData: T`.
+ *
+ * Vì bất biến nên KHÔNG tồn tại siêu kiểu chung: `SdTableColumn<unknown>` hỏng ở chiều contravariant,
+ * `SdTableColumn<never>` hỏng ở chiều covariant (`field` co về `never`). Trước đây default generic là
+ * `any` nên mọi thứ gán được cho nhau — không phải vì kiểu đúng, mà vì `any` tắt kiểm tra hai chiều.
+ *
+ * Public default đã siết sang `unknown` (consumer viết `SdTableColumn<User>` sẽ được suy luận thật và
+ * báo lỗi khi dùng sai). Riêng vài vị trí tham số NỘI BỘ row-agnostic dưới đây vẫn cần một escape
+ * hatch: alias này khoanh vùng `any` vào đúng một chỗ có tài liệu, thay vì rải `any` khắp API công khai.
+ */
+export type SdTableColumnAnyRow = SdTableColumn<any>;
+export type SdTableColumnTransformFunc<T = unknown> = (value: any, rowData: T, args?: {
     isExport?: boolean;
 }) => string | Promise<string>;
 interface Badge {
@@ -13,8 +30,8 @@ interface Badge {
     icon?: SdUnwrapSignal<SdBadge['icon']>;
     title?: SdUnwrapSignal<SdBadge['title']>;
 }
-type UseBadgeFunc<T = any> = (value: any, rowData: T) => Badge;
-type UseBadgeValuesFunc<T = any, K = any> = (value: any, rowData: T, items: K[]) => Badge;
+type UseBadgeFunc<T = unknown> = (value: any, rowData: T) => Badge;
+type UseBadgeValuesFunc<T = unknown, K = unknown> = (value: any, rowData: T, items: K[]) => Badge;
 interface ColumnTitleOption {
     title: string;
     templateRef?: TemplateRef<any>;
@@ -27,7 +44,7 @@ interface ColumnCellOption {
         type?: 'more' | 'tooltip';
     };
 }
-interface SdTableColumnBase<T = any> {
+interface SdTableColumnBase<T = unknown> {
     title: string | ColumnTitleOption;
     cell?: ColumnCellOption;
     width?: string;
@@ -58,12 +75,12 @@ interface SdTableColumnBase<T = any> {
         description?: string;
     };
 }
-interface SdTableColumnText<T = any> extends SdTableColumnBase<T> {
+interface SdTableColumnText<T = unknown> extends SdTableColumnBase<T> {
     field: NestedKeyOf<T>;
     type: 'string';
     useBadge?: UseBadgeFunc<T>;
 }
-interface SdTableColumnNumber<T = any> extends SdTableColumnBase<T> {
+interface SdTableColumnNumber<T = unknown> extends SdTableColumnBase<T> {
     field: NestedKeyOf<T>;
     type: 'number';
     useBadge?: UseBadgeFunc<T>;
@@ -71,7 +88,7 @@ interface SdTableColumnNumber<T = any> extends SdTableColumnBase<T> {
         type?: 'split-number';
     };
 }
-interface SdTableColumnBool<T = any> extends SdTableColumnBase<T> {
+interface SdTableColumnBool<T = unknown> extends SdTableColumnBase<T> {
     field: NestedKeyOf<T>;
     type: 'boolean';
     useBadge?: UseBadgeFunc<T>;
@@ -80,7 +97,7 @@ interface SdTableColumnBool<T = any> extends SdTableColumnBase<T> {
         displayOnFalse?: string;
     };
 }
-interface SdTableColumnDate<T = any> extends SdTableColumnBase<T> {
+interface SdTableColumnDate<T = unknown> extends SdTableColumnBase<T> {
     field: NestedKeyOf<T>;
     type: 'date' | 'datetime' | 'time';
     useBadge?: UseBadgeFunc<T>;
@@ -88,7 +105,7 @@ interface SdTableColumnDate<T = any> extends SdTableColumnBase<T> {
         type?: 'daterange' | 'date' | 'split-date';
     };
 }
-export interface SdTableColumnValues<T = any, K = Record<string, any>> extends SdTableColumnBase<T> {
+export interface SdTableColumnValues<T = unknown, K = Record<string, any>> extends SdTableColumnBase<T> {
     field: NestedKeyOf<T>;
     type: 'values';
     useBadge?: UseBadgeValuesFunc<T, K>;
@@ -99,7 +116,7 @@ export interface SdTableColumnValues<T = any, K = Record<string, any>> extends S
         selection?: 'MULTIPLE';
     };
 }
-export interface SdTableColumnLazyValues<T = any, K = Record<string, any>> extends SdTableColumnBase<T> {
+export interface SdTableColumnLazyValues<T = unknown, K = Record<string, any>> extends SdTableColumnBase<T> {
     field: NestedKeyOf<T>;
     type: 'lazy-values';
     useBadge?: UseBadgeFunc<T>;
@@ -111,8 +128,8 @@ export interface SdTableColumnLazyValues<T = any, K = Record<string, any>> exten
         selection?: 'MULTIPLE';
     };
 }
-export type SdTableColumnNormal<T = any> = Exclude<SdTableColumn<T>, SdTableColumnChildren<T>>;
-export interface SdTableColumnChildren<T = any> extends SdTableColumnBase<T> {
+export type SdTableColumnNormal<T = unknown> = Exclude<SdTableColumn<T>, SdTableColumnChildren<T>>;
+export interface SdTableColumnChildren<T = unknown> extends SdTableColumnBase<T> {
     field: string;
     type: 'children';
     children: SdTableColumnNormal<T>[];

package/components/table/src/models/table-item.model.d.ts

@@ -1,5 +1,6 @@
 import { SdBadge } from '@sdcorejs/angular/components/badge';
 import { SdUnwrapSignal } from '@sdcorejs/angular/utilities/models';
+import type { SdTableGroupDefContext } from '../directives/sd-table-group-def.directive';
 export interface SdTableMetaSelector {
     selectable?: boolean;
     isSelected?: boolean;
@@ -41,6 +42,12 @@ export interface SdTableDisplay {
 export interface SdTableMetaGroup<T = any> {
     /** Children items thuộc group này (chỉ set trên group header row). */
     items?: SdTableItem<T>[];
+    /**
+     * Raw data của children (`items.map(i => i.data)`).
+     * why: precompute 1 lần lúc SdGroupPipe dựng header — trước đây `groupContext()`
+     * map lại mảng này ở MỖI change-detection pass cho MỖI group row.
+     */
+    data?: T[];
     /** true = row này là synthetic group header (sinh bởi SdGroupPipe). */
     isGroupHeader?: boolean;
     /** Hash key của group (= Utilities.hash(values)). */
@@ -49,6 +56,20 @@ export interface SdTableMetaGroup<T = any> {
     values?: Record<string, any>;
     /** Trạng thái expand. Chỉ ý nghĩa khi `option.group.collapsible = true`. */
     isExpanded?: boolean;
+    /**
+     * true nếu MỌI selectable child trong group đã được chọn.
+     * why: cache thay cho `isGroupAllSelected(item)` gọi trong template — hàm đó duyệt
+     * toàn bộ children mỗi CD pass. Cập nhật ở selection sync path (`#updateSelectedItems`).
+     */
+    isSelected?: boolean;
+    /** true nếu chỉ MỘT PHẦN children được chọn (partial). Cache — xem `isSelected`. */
+    indeterminate?: boolean;
+    /**
+     * Context ổn định truyền cho template `sdTableGroupDef`.
+     * why: giữ NGUYÊN reference qua các CD pass để `ngTemplateOutlet` không phải
+     * dựng lại embedded view; giá trị bên trong được mutate tại chỗ khi selection đổi.
+     */
+    context?: SdTableGroupDefContext<T>;
 }
 export interface SdTableMeta<T> {
     id: string;
@@ -57,9 +78,17 @@ export interface SdTableMeta<T> {
     expand?: SdTableMetaExpand;
     group?: SdTableMetaGroup<T>;
     tree?: SdTableMetaTree<T>;
+    /**
+     * Style inline của cả row, resolve từ `option.style.rowCss` MỘT LẦN mỗi lần render.
+     * why: template bind `[ngStyle]` trực tiếp vào đây; gọi `rowCss(...)` trong binding
+     * trả object MỚI mỗi CD pass → KeyValueDiffer phải diff lại toàn bộ row mỗi pass.
+     */
+    rowStyle?: Record<string, string> | null;
 }
 export interface SdTableItem<T = any> {
     meta: SdTableMeta<T>;
     data: T;
 }
-export declare const MapToSdTableItem: <T = any>(item: T) => SdTableItem<T>;
+/** Resolve id cho một row data. Xem chú thích ở `rowIdByData` để biết thứ tự ưu tiên. */
+export declare const resolveTableItemId: <T = any>(item: T, rowKey?: string) => string;
+export declare const MapToSdTableItem: <T = any>(item: T, rowKey?: string) => SdTableItem<T>;

package/components/table/src/models/table-option-selector.model.d.ts

@@ -27,14 +27,15 @@ export interface SdTableOptionSelector<T = any> {
      *
      * - Default (false): selection bị mất khi data items được re-fetch (server-side) hoặc
      *   item references thay đổi. Action bar chỉ hiển thị số item selected ở page hiện tại.
-     * - Enabled (true): table giữ map nội bộ selectedItems theo `meta.id` (hash của data).
+     * - Enabled (true): table giữ map nội bộ selectedItems theo `meta.id`.
      *   Sau mỗi #render, restore `isSelected` cho item nào id đã có trong map.
      *   `selectedTableItems()` trả về TOÀN BỘ item đã chọn xuyên trang (kể cả off-page),
      *   nên action bar + callback `click(items)` nhận đầy đủ data đang được chọn.
      *
-     * Lưu ý: matching dựa trên `Utilities.hash(data)` — hai item có cùng data shape sẽ
-     * trùng id (mong muốn). Nếu data có timestamp/random field thay đổi giữa các lần fetch,
-     * id sẽ khác và selection không restore được.
+     * ⚠️ Matching dựa trên `meta.id`. Không khai báo `option.rowKey` thì id được sinh theo
+     * IDENTITY của object data — sống qua filter/sort/paging phía client, nhưng KHÔNG sống
+     * qua một lần fetch mới của server (object mới → id mới). Với `type: 'server'`, HÃY
+     * khai báo `option.rowKey` trỏ vào field định danh của dòng.
      */
     preserveSelection?: boolean;
 }

package/components/table/src/models/table-option.model.d.ts

@@ -20,6 +20,18 @@ interface SdTableBaseOption<T = any> {
      * ví dụ các option có hỗ trợ cache/config theo key.
      */
     key?: string;
+    /**
+     * Field định danh của MỘT DÒNG (hỗ trợ dot-notation, vd `'id'` hoặc `'user.id'`).
+     *
+     * Table dùng giá trị này làm `SdTableItem.meta.id` — khoá cho `trackBy` của mat-table,
+     * cho `preserveSelection`, cho trạng thái bung của tree và cho các `data-autoid` theo dòng.
+     *
+     * Không truyền thì table tự sinh id theo IDENTITY của object data (ổn định trong suốt
+     * vòng đời object, nhưng KHÔNG sống sót qua một lần fetch mới của server). Vì vậy hãy
+     * khai báo `rowKey` khi dùng `preserveSelection`, `tree` với `type: 'server'`, hoặc khi
+     * cần autoId theo dòng ổn định cho E2E.
+     */
+    rowKey?: string;
     /**
      * Cấu hình hiển thị/phục hồi config của table.
      * Xem thêm kiểu chi tiết tại `TableOptionConfig`.

package/components/table/src/pipes/sd-group.pipe.d.ts

@@ -1,6 +1,7 @@
 import { PipeTransform } from '@angular/core';
 import { SdTableOption } from '../models/table-option.model';
 import { SdTableItem } from '../models/table-item.model';
+import { SdGroupHeaderHost } from '../services/table-selection/table-selection.util';
 import * as i0 from "@angular/core";
 export declare class SdGroupPipe implements PipeTransform {
     /**
@@ -14,10 +15,13 @@ export declare class SdGroupPipe implements PipeTransform {
      * expand/collapse qua các lần transform. Pipe đọc state từ Map; nếu key chưa tồn tại,
      * dùng `!option.group.defaultCollapsed`. Pipe ghi state về Map cho lần read sau.
      *
+     * `host` (optional, owned by component) — nhận danh sách header vừa sinh (để component
+     * sync selection state) và cung cấp callback toggle cho template context.
+     *
      * @example
-     * `_items | sdGroup: _tableOption : groupExpandState`
+     * `_items | sdGroup: _tableOption : groupExpandState : groupHost`
      */
-    transform(items: SdTableItem[], gridOption: SdTableOption, expandState?: Map<string, boolean>): SdTableItem[];
+    transform(items: SdTableItem[], gridOption: SdTableOption, expandState?: Map<string, boolean>, host?: SdGroupHeaderHost): SdTableItem[];
     static ɵfac: i0.ɵɵFactoryDeclaration<SdGroupPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<SdGroupPipe, "sdGroup", true>;
 }

package/components/table/src/services/table-filter/table-filter.model.d.ts

@@ -2,7 +2,7 @@ import { TemplateRef } from '@angular/core';
 import type { SdSearch } from '@sdcorejs/angular/forms/models';
 import { NestedKeyOf, Operator, Order, PagingReq } from '@sdcorejs/utils/models';
 import { Observable } from 'rxjs';
-import { SdTableColumn } from '../../models/table-column.model';
+import { SdTableColumn, SdTableColumnAnyRow } from '../../models/table-column.model';
 export interface SdTableQuickFilter {
     code: string;
     columnFilter: Record<string, any>;
@@ -18,7 +18,7 @@ export interface TableFilterValue {
     notReload?: boolean;
     filtered?: boolean;
 }
-export interface SdTableFilterRequest<T = any> {
+export interface SdTableFilterRequest<T = unknown> {
     columnOperator: Record<NestedKeyOf<T>, Operator>;
     rawColumnFilter: Record<NestedKeyOf<T>, any>;
     rawExternalFilter: Record<string, any>;
@@ -29,7 +29,7 @@ export interface SdTableFilterRequest<T = any> {
     isExported?: boolean;
     visibledColumns?: SdTableColumn[];
 }
-export interface SdTableOptionFilter<T = any> {
+export interface SdTableOptionFilter<T = unknown> {
     /** Key định danh nếu muốn lưu cache */
     key?: string;
     /** Có bật cache giá trị filter hay không */
@@ -54,13 +54,13 @@ export interface SdTableOptionFilter<T = any> {
     onClearFilter?: () => void;
 }
 export declare const SdConvertToPagingReq: (filterRequest: SdTableFilterRequest, args: {
-    columns?: SdTableColumn[];
+    columns?: SdTableColumnAnyRow[];
     externalFilters?: SdTableExternalFilter[];
     fieldMapping?: Record<string, string>;
     orders?: Order[];
 }) => PagingReq;
-export declare type SdTableExternalFilter<TData = any> = TextFilter<TData> | DateFilter<TData> | DateTimeFilter<TData> | DateRangeFilter<TData> | NumberFilter<TData> | ValuesFilter<TData> | LazyValuesFilter<TData> | BooleanFilter<TData> | CustomFilter<TData>;
-interface BaseFilter<TData = any> {
+export declare type SdTableExternalFilter<TData = unknown> = TextFilter<TData> | DateFilter<TData> | DateTimeFilter<TData> | DateRangeFilter<TData> | NumberFilter<TData> | ValuesFilter<TData> | LazyValuesFilter<TData> | BooleanFilter<TData> | CustomFilter<TData>;
+interface BaseFilter<TData = unknown> {
     field: string;
     title: string;
     defaultShowing?: boolean;
@@ -70,23 +70,23 @@ interface BaseFilter<TData = any> {
     data?: TData;
     onChange?: (value: any) => void;
 }
-interface TextFilter<TData = any> extends BaseFilter<TData> {
+interface TextFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'string';
     default?: string;
 }
-interface DateFilter<TData = any> extends BaseFilter<TData> {
+interface DateFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'date';
     default?: Date | string;
     minDate?: string | number | Date;
     maxDate?: string | number | Date;
 }
-interface DateTimeFilter<TData = any> extends BaseFilter<TData> {
+interface DateTimeFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'datetime';
     default?: Date | string;
     minDate?: string | number | Date;
     maxDate?: string | number | Date;
 }
-interface DateRangeFilter<TData = any> extends BaseFilter<TData> {
+interface DateRangeFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'daterange';
     enableTime?: boolean;
     minDate?: string | number | Date;
@@ -96,11 +96,11 @@ interface DateRangeFilter<TData = any> extends BaseFilter<TData> {
         to?: Date | string;
     };
 }
-interface NumberFilter<TData = any> extends BaseFilter<TData> {
+interface NumberFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'number';
     default?: number;
 }
-interface ValuesFilter<TData = any> extends BaseFilter<TData> {
+interface ValuesFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'values';
     option: {
         valueField: string;
@@ -110,7 +110,7 @@ interface ValuesFilter<TData = any> extends BaseFilter<TData> {
     };
     default?: string | string[];
 }
-interface LazyValuesFilter<TData = any> extends BaseFilter<TData> {
+interface LazyValuesFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'lazy-values';
     option: {
         valueField: string;
@@ -120,7 +120,7 @@ interface LazyValuesFilter<TData = any> extends BaseFilter<TData> {
     };
     default?: string | string[];
 }
-interface BooleanFilter<TData = any> extends BaseFilter<TData> {
+interface BooleanFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'boolean';
     option?: {
         displayOnTrue?: string;
@@ -128,7 +128,7 @@ interface BooleanFilter<TData = any> extends BaseFilter<TData> {
     };
     default?: boolean;
 }
-interface CustomFilter<TData = any> extends BaseFilter<TData> {
+interface CustomFilter<TData = unknown> extends BaseFilter<TData> {
     type: 'custom';
     filterDef?: TemplateRef<any>;
     default?: any;

package/components/table/src/services/table-filter/table-filter.service.d.ts

@@ -1,6 +1,6 @@
 import { Operator } from '@sdcorejs/utils/models';
 import { SdTableFilterDefDirective } from '../../directives/sd-table-filter-def.directive';
-import { SdTableColumn } from '../../models/table-column.model';
+import { SdTableColumnAnyRow } from '../../models/table-column.model';
 import { SdTableExternalFilter, SdTableOptionFilter, TableFilterRegister } from './table-filter.model';
 import * as i0 from "@angular/core";
 export declare class SdTableFilterService {
@@ -10,7 +10,7 @@ export declare class SdTableFilterService {
     constructor(...args: unknown[]);
     register: (filter: SdTableOptionFilter | undefined, args: {
         id: string;
-        columns: SdTableColumn[] | undefined;
+        columns: SdTableColumnAnyRow[] | undefined;
         externalFilters: SdTableExternalFilter[] | undefined;
         filterDefs: SdTableFilterDefDirective[] | undefined;
         columnOperator?: Record<string, Operator>;

package/components/table/src/services/table-format/table-format.service.d.ts

@@ -10,7 +10,7 @@ export declare class TableFormatService {
     /**
      * Chuyển đổi dữ liệu thô thành SdTableItem kèm các thiết lập hiển thị (Display Meta)
      */
-    format<T = any>(rawItems: T[], columns: SdTableColumn[], cacheValues: Record<string, any[]>, cacheObjValues: Record<string, Record<string, string>>): Promise<SdTableItem<T>[]>;
+    format<T = unknown>(rawItems: T[], columns: SdTableColumn<T>[], cacheValues: Record<string, any[]>, cacheObjValues: Record<string, Record<string, string>>, rowKey?: string): Promise<SdTableItem<T>[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<TableFormatService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<TableFormatService>;
 }

package/components/table/src/services/table-selection/selection-action.util.d.ts

@@ -0,0 +1,24 @@
+import { SdTableItem } from '../../models/table-item.model';
+import { SdTableOptionSelector } from '../../models/table-option-selector.model';
+/**
+ * Thu thập danh sách action key khả dụng cho MỘT row.
+ *
+ * why: ghi thẳng vào 2 mảng do caller cấp (in-place) thay vì `return` mảng mới —
+ * hàm này chạy trong đường render (mỗi CD pass, mỗi row) nên không được cấp phát
+ * mảng mới mỗi lần gọi. Caller reset độ dài mảng trước khi gọi.
+ *
+ * Key = `Utilities.hash(action)`, khớp với `ActionFilterPipe` để action bar lọc
+ * đúng action chung của mọi item đang chọn.
+ */
+export declare const collectRowActionKeys: <T>(rowData: SdTableItem<T>, selection: SdTableOptionSelector | undefined, actions: string[], groupedActions: string[]) => void;
+/**
+ * Checkbox "chọn tất cả" ở header có hiển thị hay không.
+ *
+ * why: trước đây là pure pipe `async` với `await setTimeout(500)` bên trong. Sleep đó
+ * che một vấn đề THỨ TỰ change-detection: pipe đọc `meta.selector.actions` — mảng do
+ * `SdSelectionVisiblePipe` ghi ở cell BODY, mà CDK render header TRƯỚC body, nên ở pass
+ * đầu mảng luôn rỗng. Hệ quả: checkbox hiện trễ 500ms và mỗi lần re-eval lại đẻ thêm
+ * một timer không ai dọn. Ở đây tự tính key action từ `selection` nên không phụ thuộc
+ * pipe nào chạy trước → quyết định được ngay trong pass hiện tại, không cần timer.
+ */
+export declare const resolveSelectAllVisible: <T>(items: SdTableItem<T>[], selection: SdTableOptionSelector | undefined) => boolean;

package/components/table/src/services/table-selection/table-selection.util.d.ts

@@ -1,8 +1,39 @@
 import { SdTableItem } from '../../models/table-item.model';
 import { SdTableOptionTree } from '../../models/table-option-tree.model';
+import type { SdTableGroupDefContext } from '../../directives/sd-table-group-def.directive';
 export declare const getSelectionRows: <T>(roots: SdTableItem<T>[], treeOpt?: SdTableOptionTree<T>) => SdTableItem<T>[];
 export declare const getSelectedRowData: <T>(rows: SdTableItem<T>[]) => T[];
 export declare const applyDefaultSelected: <T>(roots: SdTableItem<T>[], treeOpt: SdTableOptionTree<T> | undefined, defaultSelected?: (row: T) => boolean) => void;
 export declare const resolveSelectAllState: <T>(visibleRows: SdTableItem<T>[]) => boolean;
 export declare const restorePreservedSelection: <T>(visibleRows: SdTableItem<T>[], preservedSelectedMap: Map<string, SdTableItem<T>>) => void;
 export declare const syncPreservedSelection: <T>(visibleRows: SdTableItem<T>[], preservedSelectedMap: Map<string, SdTableItem<T>>) => SdTableItem<T>[];
+/**
+ * Cầu nối giữa `SdGroupPipe` (nơi group header được sinh ra) và `SdTable`.
+ *
+ * why: pipe dựng header nhưng KHÔNG biết method của component, còn component thì không
+ * giữ mảng output của pipe. Host là một object DUY NHẤT, ổn định do component sở hữu:
+ * pipe đổ header vào `headers` để component sync lại selection state sau này, và mượn
+ * `toggleExpand`/`toggleSelect` để gắn vào template context.
+ */
+export interface SdGroupHeaderHost<T = any> {
+    /** Sink các group header của lần transform gần nhất. Pipe clear + fill lại mỗi lần. */
+    headers: SdTableItem<T>[];
+    toggleExpand: (header: SdTableItem<T>) => void;
+    toggleSelect: (header: SdTableItem<T>) => void;
+}
+/**
+ * Tính lại `isSelected` / `indeterminate` của một group header và ĐỒNG BỘ sang context.
+ *
+ * why: template trước đây bind `[checked]="isGroupAllSelected(item)"` +
+ * `[indeterminate]="isGroupIndeterminate(item)"` — mỗi binding duyệt toàn bộ children,
+ * mỗi CD pass, cho mỗi group row (và `groupContext()` duyệt thêm lần nữa). Giờ tính MỘT
+ * lần ở selection sync path rồi cache lên meta; template chỉ đọc property.
+ * Một vòng duyệt duy nhất thay cho cặp `every` + `some`.
+ */
+export declare const syncGroupSelectionMeta: <T>(header: SdTableItem<T>) => void;
+/**
+ * Dựng context truyền cho template `sdTableGroupDef`.
+ * Chỉ gọi MỘT lần cho mỗi header (lúc pipe sinh header); sau đó reference được giữ
+ * nguyên và giá trị bên trong cập nhật qua `syncGroupSelectionMeta`.
+ */
+export declare const buildGroupHeaderContext: <T>(header: SdTableItem<T>, host?: SdGroupHeaderHost<T>) => SdTableGroupDefContext<T>;

package/components/table/src/services/tree/tree.util.d.ts

@@ -42,8 +42,9 @@ export declare const subtreeMatches: <T>(data: T, predicate: (data: T) => boolea
  * Lọc mảng children: chỉ giữ child có subtree khớp `predicate`.
  *
  * Trả về MẢNG MỚI nhưng GIỮ NGUYÊN object reference của từng child (không clone)
- * — nhờ vậy `meta.id` (hash từ data) ổn định, selection / trạng thái bung không
- * bị mất khi từ khoá search đổi. Đây là bước "prune" của tính năng search-con.
+ * — nhờ vậy `meta.id` (bám theo identity của object data, hoặc theo `option.rowKey`)
+ * ổn định, selection / trạng thái bung không bị mất khi từ khoá search đổi. Đây là
+ * bước "prune" của tính năng search-con.
  */
 export declare const filterMatchingChildren: <T>(children: T[], predicate: (data: T) => boolean, option?: SdTableOptionTree) => T[];
 export declare const getVisibleChildrenData: <T>(data: T, option: SdTableOptionTree<T>, predicate?: (data: T) => boolean) => T[];