@shival99/z-ui 1.9.25 → 1.9.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shival99/z-ui",
-  "version": "1.9.25",
+  "version": "1.9.27",
   "description": "Z-UI: Modern Angular UI Component Library - A comprehensive, high-performance design system built with Angular 20+, featuring 40+ customizable components with dark mode, accessibility, and enterprise-ready features.",
   "keywords": [
     "angular",

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

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { Signal, OnInit, ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { ZPopoverControl } from '@shival99/z-ui/components/z-popover';
+import { ZSelectOption } from '@shival99/z-ui/components/z-select';
 import { ZEvent } from '@shival99/z-ui/utils';
 import { ClassValue } from 'clsx';
 import * as class_variance_authority_types from 'class-variance-authority/types';
@@ -204,6 +205,7 @@ declare class ZCalendarComponent implements OnInit, ControlValueAccessor {
     protected readonly period: _angular_core.WritableSignal<"AM" | "PM">;
     protected readonly inputDisplayValue: _angular_core.WritableSignal<string>;
     protected readonly activePresetKey: _angular_core.WritableSignal<string | null>;
+    protected readonly quickSelectOptions: _angular_core.Signal<ZSelectOption<string>[]>;
     protected readonly uiState: _angular_core.WritableSignal<{
         hasViewChanged: boolean;
         hasEndViewChanged: boolean;
@@ -318,6 +320,7 @@ declare class ZCalendarComponent implements OnInit, ControlValueAccessor {
     protected onQuarterClick(quarterIndex: number): void;
     protected onMonthSelect(monthIndex: number): void;
     protected onQuickSelect(preset: ZQuickSelectPreset): void;
+    protected onQuickSelectKeyChange(key: string | null): void;
     protected onTodayClick(): void;
     protected onClear(event: MouseEvent): void;
     protected onCancelClick(): void;
@@ -351,6 +354,7 @@ declare class ZCalendarComponent implements OnInit, ControlValueAccessor {
     private _handleRangeSelection;
     private _updateTimeToDate;
     private _detectMatchingPreset;
+    private _isQuickSelectPresetDisabled;
     private _applyValue;
     private _getEmitValue;
     private _getValidationErrors;

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

@@ -1,11 +1,12 @@
 import * as _tanstack_angular_table from '@tanstack/angular-table';
-import { RowData, SortingState, ColumnFiltersState, PaginationState, RowSelectionState, ExpandedState, HeaderContext, CellContext, FlexRenderComponent, Row, ColumnPinningState, RowPinningState, VisibilityState, ColumnOrderState, Column, createAngularTable, Table, ColumnDef } from '@tanstack/angular-table';
+import { RowData, RowSelectionState, HeaderContext, CellContext, FlexRenderComponent, Row, SortingState, ColumnFiltersState, PaginationState, ExpandedState, ColumnPinningState, RowPinningState, VisibilityState, ColumnOrderState, 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 * as _angular_core from '@angular/core';
 import { TemplateRef, Type, AfterViewInit, ElementRef, OnDestroy, OnInit } from '@angular/core';
 import { CdkDragDrop, CdkDragEnd } from '@angular/cdk/drag-drop';
+import { ConnectedPosition } from '@angular/cdk/overlay';
 import { ClassValue } from 'clsx';
 import { NgScrollbar } from 'ngx-scrollbar';
 import { ZAutocompleteType, ZAutocompleteOption } from '@shival99/z-ui/components/z-autocomplete';
@@ -15,6 +16,7 @@ import * as _shival99_z_ui_components_z_select from '@shival99/z-ui/components/z
 import { ZSelectOption } from '@shival99/z-ui/components/z-select';
 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 { ZExcelColumnConfig, ZExcelExportOptions } from '@shival99/z-ui/services';
 import * as _shival99_z_ui_components_z_table from '@shival99/z-ui/components/z-table';
 import { ZDateRange } from '@shival99/z-ui/components/z-calendar';
 import { ZDropdownMenuItem } from '@shival99/z-ui/components/z-dropdown-menu';
@@ -181,6 +183,7 @@ interface ZTableControl<T> {
     toggleSettings: () => void;
     resetFilters: () => void;
     resetSorting: () => void;
+    clearSelection: () => void;
     addItem: (item: T) => void;
     updateItem: (id: string | number, updates: Partial<T>, fieldKey?: keyof T) => void;
     deleteItem: (id: string | number, fieldKey?: keyof T) => void;
@@ -377,6 +380,59 @@ interface ZTableActionClickEvent<T = unknown> {
     rowId: string;
     action: ZTableActionItem<T>;
 }
+interface ZTableBulkActionContext<T = unknown> {
+    selectedRows: T[];
+    selectedRowIds: string[];
+    selection: RowSelectionState;
+}
+interface ZTableBulkActionHandlerContext<T = unknown> extends ZTableBulkActionContext<T> {
+    exportExcel: (config: ZTableExcelExportConfig<T>) => Promise<void>;
+}
+interface ZTableBulkActionItem<T = unknown> extends Omit<ZTableActionItem<ZTableBulkActionContext<T>>, 'disabled' | 'hidden'> {
+    disabled?: boolean | ((context: ZTableBulkActionContext<T>) => boolean);
+    hidden?: boolean | ((context: ZTableBulkActionContext<T>) => boolean);
+    handler?: (context: ZTableBulkActionHandlerContext<T>) => void | false | Promise<void | false>;
+}
+interface ZTableBulkActionViewItem<T = unknown> {
+    action: ZTableBulkActionItem<T>;
+    disabled: boolean;
+}
+type ZTableBulkActionList<T = unknown> = ZTableBulkActionItem<T>[] | ((context: ZTableBulkActionContext<T>) => ZTableBulkActionItem<T>[]);
+interface ZTableBulkActionOptions<T = unknown> {
+    enabled?: boolean;
+    /** Custom actions rendered when rows are selected. */
+    actions?: ZTableBulkActionList<T>;
+    maxVisible?: number;
+    selectedLabel?: string;
+    clearLabel?: string;
+}
+type ZTableBulkActionConfig<T = unknown> = ZTableBulkActionOptions<T> | ZTableBulkActionList<T>;
+interface ZTableBulkActionClickEvent<T = unknown> extends ZTableBulkActionContext<T> {
+    key: string;
+    action: ZTableBulkActionItem<T>;
+}
+type ZTableExcelExportScope = 'selected' | 'filtered' | 'all';
+interface ZTableExcelExportContext<T = unknown> extends ZTableBulkActionContext<T> {
+    data: T[];
+    columns: ZTableColumnConfig<T>[];
+}
+interface ZTableExcelExportConfig<T = unknown> {
+    enabled?: boolean;
+    /** Built-in action key. Use the same key in bulkAction to override the button. */
+    actionKey?: string;
+    actionLabel?: string;
+    actionIcon?: ZIcon;
+    actionIconSize?: string;
+    fileName?: string | ((context: ZTableExcelExportContext<T>) => string);
+    sheetName?: string;
+    /** Shortcut for `scope: 'all'`. */
+    exportAll?: boolean;
+    scope?: ZTableExcelExportScope;
+    excludeColumns?: string[];
+    excelOverrides?: Partial<Record<string, Partial<ZExcelColumnConfig<T>>>>;
+    headerResolver?: (col: ZTableColumnConfig<T>) => string;
+    options?: ZExcelExportOptions;
+}
 /**
  * @deprecated Use `ZTableBodyColumnConfig.actions` directly with an action array
  * or `(row) => action[]`, and set `actionMaxVisible` on the body config when needed.
@@ -390,7 +446,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';
+type ZTableChangeType = 'page' | 'sort' | 'filter' | 'search' | 'select' | 'expand' | 'rowSelect' | 'rowSelectAll' | 'rowExpand' | 'rowDrag' | 'cellClick' | 'cellEdit' | 'action' | 'bulkAction';
 interface ZTableChangeEventBase {
     type: ZTableChangeType;
 }
@@ -446,6 +502,10 @@ interface ZTableActionChange<T> extends ZTableChangeEventBase {
     type: 'action';
     data: ZTableActionClickEvent<T>;
 }
+interface ZTableBulkActionChange<T> extends ZTableChangeEventBase {
+    type: 'bulkAction';
+    data: ZTableBulkActionClickEvent<T>;
+}
 interface ZTableCellEditChange<T> extends ZTableChangeEventBase {
     type: 'cellEdit';
     data: ZTableCellEditEvent<T>;
@@ -463,7 +523,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>;
+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>;
 /** Initial table state — applied on first render, before any cached config is loaded */
 interface ZTableInitialState {
     columnPinning?: ColumnPinningState;
@@ -585,6 +645,8 @@ interface ZTableConfig<T> {
     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;
     enableRowPinning?: boolean;
     enableColumnPinning?: boolean;
     enableColumnOrdering?: boolean;
@@ -652,6 +714,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     /** Visual variant: 'default' has card shadow, 'borderless' has no container border */
     readonly zVariant: _angular_core.InputSignal<"default" | "borderless">;
     private readonly _destroy$;
+    private readonly _zExcel;
     private readonly _zTranslate;
     /** Prevents recursive scroll sync between thead/tbody/tfoot */
     private readonly _isSyncingScroll;
@@ -663,6 +726,8 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _settingsDebounceTimeout;
     /** Debounces filter change emissions to server */
     private _filterEmitDebounceTimeout;
+    /** Keeps the bulk bar mounted long enough for its exit animation */
+    private _bulkBarTimer;
     /** 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) */
@@ -705,12 +770,18 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly showHorizontalBorder: _angular_core.WritableSignal<boolean>;
     protected readonly showVerticalBorder: _angular_core.WritableSignal<boolean>;
     protected readonly showHeaderFooterShadow: _angular_core.WritableSignal<boolean>;
+    protected readonly bulkBarMounted: _angular_core.WritableSignal<boolean>;
+    protected readonly bulkBarClosing: _angular_core.WritableSignal<boolean>;
+    protected readonly bulkBarConfig: _angular_core.WritableSignal<ZTableBulkActionOptions<T> | null>;
+    protected readonly bulkBarContext: _angular_core.WritableSignal<ZTableBulkActionContext<T> | null>;
+    protected readonly bulkBarItems: _angular_core.WritableSignal<ZTableBulkActionViewItem<T>[]>;
     /** True when table body is scrolled away from left edge (shows left pin shadow) */
     protected readonly hasScrollLeft: _angular_core.WritableSignal<boolean>;
     /** True when table has right-pinned columns and body isn't scrolled to the end */
     protected readonly hasScrollRight: _angular_core.WritableSignal<boolean>;
     /** Maps row IDs to measured DOM heights for pinned row offset calculations */
     protected readonly pinnedRowHeights: _angular_core.WritableSignal<Record<string, number>>;
+    protected readonly defaultBulkActions: _angular_core.Signal<ZTableBulkActionItem<T>[]>;
     /** Bumped to force recomputation of pinned column IDs after programmatic pin changes */
     private readonly _columnPinVersion;
     /** Bumped to trigger data refresh (e.g., after addItem/deleteItem via control API) */
@@ -838,6 +909,17 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly columnSizeVars: _angular_core.Signal<Record<string, number>>;
     protected readonly table: ReturnType<typeof createAngularTable<T>>;
     private readonly _virtualGroupCount;
+    protected readonly selectedRowIds: _angular_core.Signal<string[]>;
+    protected readonly selectedRows: _angular_core.Signal<T[]>;
+    protected readonly bulkActionContext: _angular_core.Signal<ZTableBulkActionContext<T>>;
+    protected readonly bulkActionConfig: _angular_core.Signal<ZTableBulkActionOptions<T> | null>;
+    protected readonly bulkActionItems: _angular_core.Signal<{
+        action: ZTableBulkActionItem<T>;
+        disabled: boolean;
+    }[]>;
+    protected readonly showBulkBar: _angular_core.Signal<boolean>;
+    protected readonly bulkBarPositions: ConnectedPosition[];
+    private readonly _bulkBarExitDuration;
     /** Virtualizer instance — operates on groups rather than individual rows */
     protected readonly virtualizer: _shival99_angular_virtual.AngularVirtualizer<HTMLDivElement, Element>;
     private readonly _measureVirtualItems;
@@ -849,6 +931,18 @@ declare class ZTableComponent<T> implements AfterViewInit {
      * if no children are selected, the parent is deselected.
      */
     private _handleRowSelectionWithParents;
+    protected clearSelection(): void;
+    protected onBulkActionClick(item: ZTableBulkActionItem<T>): Promise<void>;
+    private _resolveBulkActionList;
+    private _createBulkActionHandlerContext;
+    private _exportSelectionToExcel;
+    private _createExcelExportContext;
+    private _getExcelExportData;
+    private _getExcelExportFileName;
+    private _toExcelTableColumns;
+    private _getExcelColumnHeader;
+    private _getExcelColumnHeaderAlign;
+    private _clearBulkBarTimer;
     /**
      * Wraps state mutations with a debounced processing indicator.
      * Shows a brief loading state to prevent UI flicker during
@@ -1119,4 +1213,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, ZTableCellEditChange, ZTableCellEditEvent, ZTableChangeEvent, ZTableColumn, ZTableColumnConfig, ZTableConfig, ZTableControl, ZTableEditCellChangeEvent, ZTableEditConfig, ZTableEditSize, ZTableEditType, ZTableFilterChangeEvent, ZTableFilterConfig, ZTableFilterType, ZTablePageChangeEvent, ZTablePaginationConfig, ZTableRowExpandEvent, ZTableRowSelectEvent, ZTableSavedConfig, ZTableSearchChangeEvent, ZTableSearchConfig, ZTableSortChangeEvent, ZTableSortConfig };
+export type { ZTableActionBodyConfig, ZTableActionClickEvent, ZTableActionColumnConfig, ZTableActionItem, ZTableActionList, ZTableBulkActionClickEvent, ZTableBulkActionConfig, ZTableBulkActionContext, ZTableBulkActionHandlerContext, ZTableBulkActionItem, ZTableBulkActionList, ZTableBulkActionOptions, ZTableBulkActionViewItem, ZTableCellEditChange, ZTableCellEditEvent, ZTableChangeEvent, ZTableColumn, ZTableColumnConfig, ZTableConfig, ZTableControl, ZTableEditCellChangeEvent, ZTableEditConfig, ZTableEditSize, ZTableEditType, ZTableExcelExportConfig, ZTableExcelExportContext, ZTableExcelExportScope, ZTableFilterChangeEvent, ZTableFilterConfig, ZTableFilterType, ZTablePageChangeEvent, ZTablePaginationConfig, ZTableRowExpandEvent, ZTableRowSelectEvent, ZTableSavedConfig, ZTableSearchChangeEvent, ZTableSearchConfig, ZTableSortChangeEvent, ZTableSortConfig };