@shival99/z-ui 2.0.45 → 2.0.47

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

@@ -2,18 +2,18 @@ import * as _tanstack_angular_table from '@tanstack/angular-table';
 import { RowData, RowSelectionState, HeaderContext, CellContext, FlexRenderComponent, Row, SortingState, ColumnFiltersState, PaginationState, ExpandedState, ColumnPinningState, RowPinningState, VisibilityState, ColumnOrderState, ColumnSizingState, Column, createAngularTable, Table, ColumnDef } from '@tanstack/angular-table';
 import * as _shival99_angular_virtual from '@shival99/angular-virtual';
 import * as _shival99_z_ui_components_z_input from '@shival99/z-ui/components/z-input';
-import { ZInputSize } from '@shival99/z-ui/components/z-input';
+import { ZInputAlign, ZInputSize } from '@shival99/z-ui/components/z-input';
 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 { ZPopoverDirective } from '@shival99/z-ui/components/z-popover';
+import { 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';
 import { ZButtonVariants } from '@shival99/z-ui/components/z-button';
 import { ZIcon, ZIconVariants } from '@shival99/z-ui/components/z-icon';
-import { ZSelectOption, ZSelectConfig } from '@shival99/z-ui/components/z-select';
+import { ZSelectOption, ZSelectConfig, ZSelectMode } from '@shival99/z-ui/components/z-select';
 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';
@@ -147,6 +147,41 @@ interface ZTableFilterConfig<T = unknown> {
     filterOptions?: ZSelectOption[];
 }
 type ZTableEditSize = 'sm' | 'default' | 'lg';
+type ZTableEditContentType = 'text' | 'number' | 'select' | 'date';
+interface ZTableEditContentConfig<T = unknown> {
+    type?: ZTableEditContentType;
+    options?: unknown[] | ((row: T) => unknown[]);
+    placeholder?: string | ((row: T) => string);
+    class?: string | ((row: T) => string);
+    style?: Record<string, string> | ((row: T) => Record<string, string>);
+    size?: ZTableEditSize;
+    disabled?: boolean | ((row: T) => boolean);
+    readonly?: boolean | ((row: T) => boolean);
+    align?: ZInputAlign;
+    prefix?: string;
+    suffix?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    mask?: string;
+    decimalPlaces?: number;
+    allowNegative?: boolean;
+    thousandSeparator?: string;
+    decimalMarker?: '.' | ',' | ['.', ','];
+    optionLabelKey?: string;
+    optionValueKey?: string;
+    selectConfig?: Partial<ZSelectConfig<unknown>>;
+    selectMode?: ZSelectMode;
+    mode?: ZSelectMode;
+    selectShowSearch?: boolean;
+    selectWrap?: boolean;
+    maxTagCount?: number;
+    dateFormat?: string;
+    dateValueType?: 'date' | 'iso' | 'string';
+    minDate?: Date | null;
+    maxDate?: Date | null;
+    allowClear?: boolean;
+}
 interface ZTableEditConfig<T = unknown> {
     enabled?: boolean;
     /** Edit type - can be static or dynamic per row */
@@ -260,6 +295,8 @@ interface ZTableBodyColumnConfig<T> {
     enabledClick?: boolean;
     /** Enable inline editing — true uses defaults, or pass full config */
     edit?: ZTableEditConfig<T> | boolean;
+    /** Cho phép sửa trực tiếp trong cell theo kiểu Excel, không render editor component. */
+    editContent?: ZTableEditContentConfig<T> | boolean;
     /** Control cell content visibility. When false, the cell is rendered but content is hidden. */
     visible?: boolean | ((info: CellContext<T, unknown>) => boolean);
 }
@@ -371,6 +408,54 @@ interface ZTableRowDragEvent<T> {
     currentIndex: number;
     data: T[];
 }
+type ZTableRowInsertPosition = 'above' | 'below';
+interface ZTableRowInsertEvent<T> {
+    row: T;
+    rowId: string;
+    /** Index trong row model đang hiển thị. */
+    rowIndex: number;
+    /** Index trong mảng data gốc. */
+    sourceIndex: number;
+    position: ZTableRowInsertPosition;
+}
+interface ZTableRowDeleteEvent<T> {
+    rows: T[];
+    rowIds: string[];
+    /** Index trong row model đang hiển thị. */
+    rowIndexes: number[];
+    /** Index trong mảng data gốc. */
+    sourceIndexes: number[];
+}
+interface ZTableRowCopyEvent<T> {
+    rows: T[];
+    rowIds: string[];
+    /** Index trong row model đang hiển thị. */
+    rowIndexes: number[];
+    /** Index trong mảng data gốc. */
+    sourceIndexes: number[];
+}
+interface ZTableRowPasteEvent<T> {
+    rows: T[];
+    targetRow: T;
+    targetRowId: string;
+    /** Index trong row model đang hiển thị. */
+    targetRowIndex: number;
+    /** Index trong mảng data gốc. */
+    targetSourceIndex: number;
+    position: ZTableRowInsertPosition;
+}
+type ZTableRowMoveDirection = 'up' | 'down';
+interface ZTableRowMoveEvent<T> {
+    row: T;
+    rowId: string;
+    direction: ZTableRowMoveDirection;
+    /** Index trong row model đang hiển thị. */
+    previousIndex: number;
+    currentIndex: number;
+    /** Index trong mảng data gốc. */
+    previousSourceIndex: number;
+    currentSourceIndex: number;
+}
 interface ZTableSortChangeEvent {
     sorting: SortingState;
 }
@@ -481,7 +566,7 @@ interface ZTableActionColumnConfig<T = unknown> {
 }
 type ZTableActionBodyConfig<T = unknown> = ZTableActionColumnConfig<T> | (ZTableActionList<T> & Partial<ZTableActionColumnConfig<T>>);
 /** All possible change event types — used as discriminant in ZTableChangeEvent */
-type ZTableChangeType = 'page' | 'sort' | 'filter' | 'search' | 'select' | 'expand' | 'rowSelect' | 'rowSelectAll' | 'rowExpand' | 'rowDrag' | 'cellClick' | 'cellEdit' | 'action' | 'bulkAction';
+type ZTableChangeType = 'page' | 'sort' | 'filter' | 'search' | 'select' | 'expand' | 'rowSelect' | 'rowSelectAll' | 'rowExpand' | 'rowDrag' | 'rowInsert' | 'rowDelete' | 'rowCopy' | 'rowPaste' | 'rowMove' | 'cellClick' | 'cellEdit' | 'action' | 'bulkAction';
 interface ZTableChangeEventBase {
     type: ZTableChangeType;
 }
@@ -513,6 +598,26 @@ interface ZTableRowDragChange<T> extends ZTableChangeEventBase {
     type: 'rowDrag';
     data: ZTableRowDragEvent<T>;
 }
+interface ZTableRowInsertChange<T> extends ZTableChangeEventBase {
+    type: 'rowInsert';
+    data: ZTableRowInsertEvent<T>;
+}
+interface ZTableRowDeleteChange<T> extends ZTableChangeEventBase {
+    type: 'rowDelete';
+    data: ZTableRowDeleteEvent<T>;
+}
+interface ZTableRowCopyChange<T> extends ZTableChangeEventBase {
+    type: 'rowCopy';
+    data: ZTableRowCopyEvent<T>;
+}
+interface ZTableRowPasteChange<T> extends ZTableChangeEventBase {
+    type: 'rowPaste';
+    data: ZTableRowPasteEvent<T>;
+}
+interface ZTableRowMoveChange<T> extends ZTableChangeEventBase {
+    type: 'rowMove';
+    data: ZTableRowMoveEvent<T>;
+}
 interface ZTableCellClickChange<T> extends ZTableChangeEventBase {
     type: 'cellClick';
     data: ZTableCellClickEvent<T>;
@@ -558,7 +663,7 @@ interface ZTableCellEditChange<T> extends ZTableChangeEventBase {
  * }
  * ```
  */
-type ZTableChangeEvent<T> = ZTablePageChange | ZTableSortChange | ZTableFilterChange | ZTableSearchChange | ZTableSelectChange | ZTableExpandChange | ZTableRowSelectChange<T> | ZTableRowSelectAllChange<T> | ZTableRowExpandChange<T> | ZTableRowDragChange<T> | ZTableCellClickChange<T> | ZTableCellEditChange<T> | ZTableActionChange<T> | ZTableBulkActionChange<T>;
+type ZTableChangeEvent<T> = ZTablePageChange | ZTableSortChange | ZTableFilterChange | ZTableSearchChange | ZTableSelectChange | ZTableExpandChange | ZTableRowSelectChange<T> | ZTableRowSelectAllChange<T> | ZTableRowExpandChange<T> | ZTableRowDragChange<T> | ZTableRowInsertChange<T> | ZTableRowDeleteChange<T> | ZTableRowCopyChange<T> | ZTableRowPasteChange<T> | ZTableRowMoveChange<T> | ZTableCellClickChange<T> | ZTableCellEditChange<T> | ZTableActionChange<T> | ZTableBulkActionChange<T>;
 /** Initial table state — applied on first render, before any cached config is loaded */
 interface ZTableInitialState {
     columnPinning?: ColumnPinningState;
@@ -683,12 +788,16 @@ interface ZTableConfig<T> {
     /** Show the settings drawer toggle button */
     enableSettings?: boolean;
     enableColumnResizing?: boolean;
+    /** Giữ kích thước cột ban đầu và chỉ kéo giãn cột dữ liệu cuối để lấp đầy bảng. */
+    fitContentWidth?: boolean;
     /** When true, shift-click sorting is simulated automatically */
     enableMultiSort?: boolean;
     /** true = enable with defaults; object = full search bar config */
     search?: ZTableSearchConfig | boolean;
     /** Floating bulk action bar shown when rows are selected */
     bulkAction?: ZTableBulkActionConfig<T> | boolean;
+    /** Bật menu chuột phải để chèn dòng khi bảng có cell editContent. */
+    enableContentRowInsert?: boolean;
     enableRowPinning?: boolean;
     enableColumnPinning?: boolean;
     enableColumnOrdering?: boolean;
@@ -700,6 +809,8 @@ interface ZTableConfig<T> {
     expandedRowTemplate?: TemplateRef<{
         $implicit: Row<T>;
     }>;
+    /** Render z-table con độc lập khi dòng mở rộng không dùng custom template. */
+    subTableConfig?: ZTableConfig<unknown> | ((row: Row<T>) => ZTableConfig<unknown> | undefined);
     /** Template rendered when no data matches */
     emptyTemplate?: TemplateRef<void>;
     /** Template rendered during loading state */
@@ -774,6 +885,8 @@ declare class ZTableComponent<T> implements AfterViewInit {
     readonly zVariant: _angular_core.InputSignal<"default" | "borderless">;
     private readonly _destroy$;
     private readonly _dragService;
+    private readonly _host;
+    private readonly _document;
     private readonly _zExcel;
     private readonly _zTranslate;
     /** Prevents recursive scroll sync between thead/tbody/tfoot */
@@ -789,6 +902,8 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _filterEmitDebounceTimeout;
     /** Keeps the bulk bar mounted long enough for its exit animation */
     private _bulkBarTimer;
+    private _contentRowMenuOutsideTimer;
+    private _contentRowMenuOutsideCleanup;
     private readonly _activeColumnVisibilityPopover;
     private _hasInitializedColumnPinning;
     private _isFitColumnScheduled;
@@ -812,6 +927,17 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly rowPinning: _angular_core.WritableSignal<RowPinningState>;
     protected readonly columnFilters: _angular_core.WritableSignal<ColumnFiltersState>;
     protected readonly globalFilter: _angular_core.WritableSignal<string>;
+    protected readonly activeContentEditCell: _angular_core.WritableSignal<{
+        rowId: string;
+        columnId: string;
+    } | null>;
+    protected readonly contentRowMenu: _angular_core.WritableSignal<{
+        row: Row<T>;
+        left: number;
+        top: number;
+    } | null>;
+    protected readonly contentRowMenuControl: _angular_core.WritableSignal<ZPopoverControl | null>;
+    protected readonly contentRowClipboard: _angular_core.WritableSignal<T[]>;
     protected readonly columnSizingState: _angular_core.WritableSignal<ColumnSizingState>;
     private readonly _columnBaseSizing;
     /** Note: pageIndex is 1-based here; converted to 0-based for TanStack via _tanstackPagination */
@@ -876,6 +1002,11 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly hasSelectColumn: _angular_core.Signal<boolean>;
     protected readonly hasExpandColumn: _angular_core.Signal<boolean>;
     protected readonly hasRowDragColumn: _angular_core.Signal<boolean>;
+    protected readonly hasContentEditableColumns: _angular_core.Signal<boolean>;
+    protected readonly canUseContentRowInsert: _angular_core.Signal<boolean>;
+    protected readonly contentRowDeleteCount: _angular_core.Signal<number>;
+    protected readonly canMoveContentRowUp: _angular_core.Signal<boolean>;
+    protected readonly canMoveContentRowDown: _angular_core.Signal<boolean>;
     protected readonly canUseRowDrag: _angular_core.Signal<boolean>;
     protected readonly isVirtualRowDragEnabled: _angular_core.Signal<boolean>;
     protected readonly isRowDragEnabled: _angular_core.Signal<boolean>;
@@ -1001,6 +1132,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _getExcelColumnHeader;
     private _getExcelColumnHeaderAlign;
     private _clearBulkBarTimer;
+    private _clearContentRowMenuOutsideListener;
     /**
      * Wraps state mutations with a debounced processing indicator.
      * Shows a brief loading state to prevent UI flicker during
@@ -1041,8 +1173,35 @@ declare class ZTableComponent<T> implements AfterViewInit {
     onSearchChange(value: string | number | null): void;
     toggleHeaderFooterShadow(): void;
     onActionClick(event: ZTableActionClickEvent<T>): void;
+    protected setContentRowMenuControl(control: ZPopoverControl): void;
+    protected clearContentRowMenu(): void;
+    protected openContentRowMenu(event: MouseEvent, row: Row<T>): void;
+    protected insertContentRow(position: ZTableRowInsertPosition): void;
+    protected deleteContentRows(): void;
+    private _removeDeletedRowsFromSelection;
+    protected onContentTableKeydown(event: KeyboardEvent): void;
+    protected copyContentRows(rowId?: string): void;
+    protected pasteContentRows(position: ZTableRowInsertPosition, rowId?: string): void;
+    protected moveContentRow(direction: ZTableRowMoveDirection): void;
+    private _getContentRowsToDelete;
+    private _getRowSourceIndex;
+    private _getRowVisibleIndex;
+    private _getContentRowsForRowAction;
+    private _getContentRowActionTarget;
+    private _isEditableKeyboardTarget;
+    private _getContentEditTriggerTarget;
+    private _clearContentEditCell;
+    private _listenContentRowMenuOutside;
     onCellClick(row: Row<T>, columnId: string, value: unknown): void;
     onCellEdit(event: ZTableEditCellChangeEvent<T>): void;
+    onContentEditStart(event: MouseEvent, rowId: string, columnId: string): void;
+    onContentEditKeydown(event: KeyboardEvent, rowId: string, columnId: string): void;
+    onContentEditCommit(newValue: unknown, row: Row<T>, columnId: string, oldValue: unknown): void;
+    onContentEditCancel(): void;
+    private _getContentEditDirection;
+    private _findContentEditTarget;
+    private _findHorizontalContentEditTarget;
+    private _restoreContentEditFocus;
     openSettingsDrawer(): void;
     onPendingColumnDrop(event: CdkDragDrop<string[]>): void;
     onVisibleColumnsChange(values: (string | number)[]): void;
@@ -1071,6 +1230,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _collectColumnInfo;
     /** Loads cached config from ZCacheService; validates schema compatibility first */
     private _loadConfigCache;
+    private _getConfigCacheKey;
     /**
      * Validates cached column info against current config.
      * Returns false if columns have been added/removed/renamed since cache was saved,
@@ -1193,7 +1353,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>;
@@ -1347,4 +1507,4 @@ declare const findColumnConfig: <T>(columnId: string, columns: ZTableColumnConfi
 declare function columnConfigToColumnDef<T>(config: ZTableColumnConfig<T>): ColumnDef<T>;
 
 export { ZTableActionsComponent, ZTableComponent, ZTableEditCellComponent, ZTableFilterComponent, ZTableIconTextComponent, columnConfigToColumnDef, findColumnConfig, getBodyConfig, getFooterConfig, getHeaderConfig, isBodyConfig, isFooterConfig, isHeaderConfig };
-export type { ZTableActionBodyConfig, ZTableActionClickEvent, ZTableActionColumnConfig, ZTableActionItem, ZTableActionList, ZTableAdvancedFilterType, ZTableBodyContentType, ZTableBulkActionClickEvent, ZTableBulkActionConfig, ZTableBulkActionContext, ZTableBulkActionHandlerContext, ZTableBulkActionItem, ZTableBulkActionList, ZTableBulkActionOptions, ZTableBulkActionViewItem, ZTableCellEditChange, ZTableCellEditEvent, ZTableChangeEvent, ZTableColumn, ZTableColumnConfig, ZTableConfig, ZTableControl, ZTableEditCellChangeEvent, ZTableEditConfig, ZTableEditSize, ZTableEditType, ZTableExcelExportConfig, ZTableExcelExportContext, ZTableExcelExportScope, ZTableFilterChangeEvent, ZTableFilterCondition, ZTableFilterConfig, ZTableFilterJoinOperator, ZTableFilterOperator, ZTableFilterOptionSource, ZTableFilterUi, ZTableFilterValueType, ZTablePageChangeEvent, ZTablePaginationConfig, ZTableRowExpandEvent, ZTableRowSelectEvent, ZTableSearchChangeEvent, ZTableSearchConfig, ZTableSortChangeEvent, ZTableSortConfig, ZTableTagColor };
+export type { ZTableActionBodyConfig, ZTableActionClickEvent, ZTableActionColumnConfig, ZTableActionItem, ZTableActionList, ZTableAdvancedFilterType, ZTableBodyContentType, ZTableBulkActionClickEvent, ZTableBulkActionConfig, ZTableBulkActionContext, ZTableBulkActionHandlerContext, ZTableBulkActionItem, ZTableBulkActionList, ZTableBulkActionOptions, ZTableBulkActionViewItem, ZTableCellEditChange, ZTableCellEditEvent, ZTableChangeEvent, ZTableColumn, ZTableColumnConfig, ZTableConfig, ZTableControl, ZTableEditCellChangeEvent, ZTableEditConfig, ZTableEditContentConfig, ZTableEditContentType, ZTableEditSize, ZTableEditType, ZTableExcelExportConfig, ZTableExcelExportContext, ZTableExcelExportScope, ZTableFilterChangeEvent, ZTableFilterCondition, ZTableFilterConfig, ZTableFilterJoinOperator, ZTableFilterOperator, ZTableFilterOptionSource, ZTableFilterUi, ZTableFilterValueType, ZTablePageChangeEvent, ZTablePaginationConfig, ZTableRowCopyChange, ZTableRowCopyEvent, ZTableRowDeleteChange, ZTableRowDeleteEvent, ZTableRowExpandEvent, ZTableRowInsertChange, ZTableRowInsertEvent, ZTableRowInsertPosition, ZTableRowMoveChange, ZTableRowMoveDirection, ZTableRowMoveEvent, ZTableRowPasteChange, ZTableRowPasteEvent, ZTableRowSelectEvent, ZTableSearchChangeEvent, ZTableSearchConfig, ZTableSortChangeEvent, ZTableSortConfig, ZTableTagColor };