@shival99/z-ui 2.0.52 → 2.0.54

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

@@ -531,6 +531,13 @@ interface ZTableBulkActionClickEvent<T = unknown> extends ZTableBulkActionContex
     key: string;
     action: ZTableBulkActionItem<T>;
 }
+interface ZTableCellSelectionOptions {
+    enabled?: boolean;
+    range?: boolean;
+    contextMenu?: boolean;
+    copyWithHeaders?: boolean;
+}
+type ZTableCellSelectionConfig = boolean | ZTableCellSelectionOptions;
 type ZTableExcelExportScope = 'selected' | 'filtered' | 'all';
 interface ZTableExcelExportContext<T = unknown> extends ZTableBulkActionContext<T> {
     data: T[];
@@ -796,6 +803,8 @@ interface ZTableConfig<T> {
     search?: ZTableSearchConfig | boolean;
     /** Floating bulk action bar shown when rows are selected */
     bulkAction?: ZTableBulkActionConfig<T> | boolean;
+    /** Bật chọn cell/range và copy giống spreadsheet. Mặc định bật. */
+    cellSelection?: ZTableCellSelectionConfig;
     /** Bật menu chuột phải để chèn dòng khi bảng có cell editContent. */
     enableContentRowInsert?: boolean;
     enableRowPinning?: boolean;
@@ -904,9 +913,11 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _bulkBarTimer;
     private _contentRowMenuOutsideTimer;
     private _contentRowMenuOutsideCleanup;
+    private _cellInteractionOutsideCleanup;
     private readonly _activeColumnVisibilityPopover;
     private _hasInitializedColumnPinning;
     private _isFitColumnScheduled;
+    private _skipNextConfigSave;
     /** Merged loading state from both zLoading input and config.loading */
     protected readonly isLoading: _angular_core.Signal<boolean>;
     /** True during debounced async state transitions (sort/filter processing) */
@@ -933,10 +944,30 @@ declare class ZTableComponent<T> implements AfterViewInit {
     } | null>;
     protected readonly contentRowMenu: _angular_core.WritableSignal<{
         row: Row<T>;
+        columnId?: string;
+        left: number;
+        top: number;
+    } | null>;
+    protected readonly activeCell: _angular_core.WritableSignal<{
+        rowId: string;
+        columnId: string;
+    } | null>;
+    protected readonly cellSelectionAnchor: _angular_core.WritableSignal<{
+        rowId: string;
+        columnId: string;
+    } | null>;
+    protected readonly cellSelectionFocus: _angular_core.WritableSignal<{
+        rowId: string;
+        columnId: string;
+    } | null>;
+    protected readonly cellMenu: _angular_core.WritableSignal<{
+        rowId: string;
+        columnId: string;
         left: number;
         top: number;
     } | null>;
     protected readonly contentRowMenuControl: _angular_core.WritableSignal<ZPopoverControl | null>;
+    protected readonly cellMenuControl: _angular_core.WritableSignal<ZPopoverControl | null>;
     protected readonly contentRowClipboard: _angular_core.WritableSignal<T[]>;
     protected readonly columnSizingState: _angular_core.WritableSignal<ColumnSizingState>;
     private readonly _columnBaseSizing;
@@ -1004,6 +1035,25 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly hasRowDragColumn: _angular_core.Signal<boolean>;
     protected readonly hasContentEditableColumns: _angular_core.Signal<boolean>;
     protected readonly canUseContentRowInsert: _angular_core.Signal<boolean>;
+    protected readonly canUseRowSelection: _angular_core.Signal<boolean>;
+    protected readonly cellSelectionOptions: _angular_core.Signal<Required<ZTableCellSelectionOptions>>;
+    protected readonly canUseCellSelection: _angular_core.Signal<boolean>;
+    protected readonly selectedCellIds: _angular_core.Signal<Set<string>>;
+    protected readonly visualSelectedCellIds: _angular_core.Signal<Set<string>>;
+    protected readonly hasMultipleSelectedCells: _angular_core.Signal<boolean>;
+    protected readonly canCopyCellMenuSelection: _angular_core.Signal<boolean>;
+    protected readonly selectedCellRangeInsets: _angular_core.Signal<Map<string, {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    }>>;
+    protected readonly selectedCellEdgeIds: _angular_core.Signal<{
+        top: Set<string>;
+        right: Set<string>;
+        bottom: Set<string>;
+        left: Set<string>;
+    }>;
     protected readonly contentRowDeleteCount: _angular_core.Signal<number>;
     protected readonly canMoveContentRowUp: _angular_core.Signal<boolean>;
     protected readonly canMoveContentRowDown: _angular_core.Signal<boolean>;
@@ -1112,6 +1162,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly virtualizer: _shival99_angular_virtual.AngularVirtualizer<HTMLDivElement, Element>;
     private readonly _measureVirtualItems;
     private readonly _rowDragAutoScroll;
+    private readonly _rowDragCellSelectionCleanup;
     constructor();
     ngAfterViewInit(): void;
     /**
@@ -1146,6 +1197,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _checkLastRowTouchesBottom;
     private _getTbodyViewportElement;
     private _handleColumnSizingChange;
+    private _clampColumnSizing;
     private _syncColumnBaseSizing;
     private _scheduleFitColumnWidths;
     private _applyFitColumnWidths;
@@ -1174,12 +1226,19 @@ declare class ZTableComponent<T> implements AfterViewInit {
     toggleHeaderFooterShadow(): void;
     onActionClick(event: ZTableActionClickEvent<T>): void;
     protected setContentRowMenuControl(control: ZPopoverControl): void;
+    protected setCellMenuControl(control: ZPopoverControl): void;
+    protected clearCellMenu(): void;
     protected clearContentRowMenu(): void;
-    protected openContentRowMenu(event: MouseEvent, row: Row<T>): void;
+    protected onCellPointerDown(event: PointerEvent, row: Row<T>, columnId: string): void;
+    protected onCellPointerEnter(event: PointerEvent, row: Row<T>, columnId: string): void;
+    protected openCellMenu(event: MouseEvent, row: Row<T>, columnId: string): void;
+    protected openContentRowMenu(event: MouseEvent, row: Row<T>, columnId?: string): void;
     protected insertContentRow(position: ZTableRowInsertPosition): void;
     protected deleteContentRows(): void;
     private _removeDeletedRowsFromSelection;
     protected onContentTableKeydown(event: KeyboardEvent): void;
+    protected copySelectedCells(includeHeaders: boolean): void;
+    protected copyContentCell(): void;
     protected copyContentRows(rowId?: string): void;
     protected pasteContentRows(position: ZTableRowInsertPosition, rowId?: string): void;
     protected moveContentRow(direction: ZTableRowMoveDirection): void;
@@ -1189,6 +1248,28 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _getContentRowsForRowAction;
     private _getContentRowActionTarget;
     private _isEditableKeyboardTarget;
+    private _isContentEditorTarget;
+    private _getContentEditClipboardText;
+    private _getSelectedTextFromEditor;
+    protected isCellInSelectedRange(rowId: string, columnId: string): boolean;
+    private _listenCellInteractionOutside;
+    private _hasCellInteractionState;
+    private _isInsideCellInteractionBoundary;
+    private _clearCellInteractionState;
+    private _getCellSelectionId;
+    private _getSelectedCellRange;
+    private _getSelectedCellVisualRects;
+    private _getRenderedCellVisualRect;
+    private _hasOutsideVisualNeighbor;
+    private _getCellVisualSlotId;
+    private _buildSelectedCellsText;
+    private _getSelectableColumnIds;
+    private _isSelectableCellColumn;
+    private _isIgnoredCellSelectionTarget;
+    private _isCellSelectionDragTarget;
+    private _formatCellClipboardValue;
+    private _getColumnCopyHeader;
+    private _writeClipboardText;
     private _getContentEditTriggerTarget;
     private _clearContentEditCell;
     private _listenContentRowMenuOutside;
@@ -1215,7 +1296,13 @@ declare class ZTableComponent<T> implements AfterViewInit {
     hideActiveColumnVisibilityPopover(): void;
     hideColumnPopoversOnOutsideClick(optionsPopover: ZPopoverDirective): void;
     openSettingsDrawerFromColumnMenu(...popovers: ZPopoverDirective[]): void;
+    autosizeColumn(columnId: string): void;
+    autosizeAllColumns(): void;
+    resetColumns(): void;
     private _isColumnHiddenFromVisibilityMenu;
+    private _setMeasuredColumnWidth;
+    private _measureColumnContentWidth;
+    private _defaultColumnPinning;
     private _setColumnPinning;
     private _areColumnIdListsEqual;
     moveColumnLeft(columnId: string): void;
@@ -1263,7 +1350,7 @@ declare class ZTableFilterComponent<T> {
     protected readonly sortOptions: _angular_core.Signal<ZSelectOption<string>[]>;
     protected readonly draftFilters: _angular_core.WritableSignal<ZTableDraftFilterCondition[]>;
     protected readonly draftLegacyFilterValue: _angular_core.WritableSignal<unknown>;
-    protected readonly draftSortState: _angular_core.WritableSignal<false | "desc" | "asc">;
+    protected readonly draftSortState: _angular_core.WritableSignal<false | "asc" | "desc">;
     protected readonly columnFilterValue: _angular_core.Signal<unknown>;
     protected readonly effectiveFilterValue: _angular_core.Signal<unknown>;
     protected readonly sortState: _angular_core.Signal<false | _tanstack_angular_table.SortDirection>;
@@ -1285,7 +1372,7 @@ declare class ZTableFilterComponent<T> {
     protected readonly filterBadgeCount: _angular_core.Signal<number>;
     protected readonly hasFilterValue: _angular_core.Signal<boolean>;
     protected readonly isActive: _angular_core.Signal<boolean>;
-    protected readonly draftSortValue: _angular_core.Signal<"none" | "desc" | "asc">;
+    protected readonly draftSortValue: _angular_core.Signal<"asc" | "desc" | "none">;
     protected readonly rangeMinValue: _angular_core.Signal<any>;
     protected readonly rangeMaxValue: _angular_core.Signal<any>;
     protected readonly dateValue: _angular_core.Signal<Date | null>;
@@ -1353,7 +1440,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<"sm" | "default" | "lg" | "xs" | "xl" | null | undefined>;
+    readonly zDropdownButtonSize: _angular_core.InputSignal<"default" | "sm" | "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>;