@shival99/z-ui 2.0.29 → 2.0.31

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

@@ -5,20 +5,23 @@ import * as _shival99_z_ui_components_z_input from '@shival99/z-ui/components/z-
 import { 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, CdkDragEnd } from '@angular/cdk/drag-drop';
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { ConnectedPosition } from '@angular/cdk/overlay';
+import { ZButtonVariants } from '@shival99/z-ui/components/z-button';
 import { 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 * 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 { 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';
+import * as _shival99_z_ui_components_z_table from '@shival99/z-ui/components/z-table';
 
 /**
  * Z-Table Type Definitions
@@ -55,6 +58,9 @@ interface ZTableIconPart {
     strokeWidth?: number;
 }
 type ZTableAlign = 'left' | 'center' | 'right';
+type ZTableBodyContentType = 'default' | 'tag';
+type ZTableColumnType = 'data' | 'select' | 'expand' | 'rowDrag' | 'rowPin' | 'actions';
+type ZTableTagColor = ZTagColor;
 /**
  * Body cell content — supports static values, Angular templates/components,
  * or a function that receives the cell context and returns dynamic content.
@@ -228,6 +234,10 @@ interface ZTableHeaderColumnConfig<T> {
  */
 interface ZTableBodyColumnConfig<T> {
     content?: ZTableCellContent<T>;
+    /** Built-in visual treatment for the rendered body content. */
+    type?: ZTableBodyContentType;
+    /** Semantic color used when type is "tag". */
+    tagColor?: ZTableTagColor | ((info: CellContext<T, unknown>) => ZTableTagColor);
     class?: string | ((info: CellContext<T, unknown>) => string);
     style?: Record<string, string> | ((info: CellContext<T, unknown>) => Record<string, string>);
     align?: ZTableAlign;
@@ -276,6 +286,8 @@ interface ZTableFooterColumnConfig<T> {
 interface ZTableColumnConfig<T> {
     /** Unique column identifier — must be stable across re-renders */
     id: string;
+    /** Semantic column role. Falls back to legacy id/body detection when omitted. */
+    type?: ZTableColumnType;
     /** Pre-filter visibility — unlike columnVisibility, this removes the column entirely */
     visible?: boolean | (() => boolean);
     /** Object property key for simple accessor — mutually exclusive with accessorFn */
@@ -647,6 +659,13 @@ interface ZTableConfig<T> {
     getRowId?: (row: T, index: number, parent: T | undefined, data: T[]) => string;
     /** Sub-row accessor for tree/hierarchical data */
     getSubRows?: (row: T, index: number, parent: T | undefined, data: T[]) => T[] | undefined;
+    /** Class applied to the row and its cells. Cell body classes take precedence on conflicts. */
+    rowClass?: string | ((row: Row<T>) => string);
+    /**
+     * Style applied to the row and its cells. Cell body styles take precedence on conflicts.
+     * Fixed-size virtual rows keep the height configured by virtual.size.
+     */
+    rowStyle?: Record<string, string> | ((row: Row<T>) => Record<string, string>);
     /** @deprecated Use totalCount instead */
     totalRows?: number;
     /** true = enable with defaults; object = full virtual scroll config */
@@ -711,6 +730,18 @@ interface ZResolvedEditConfig {
     disabled: boolean;
     readonly: boolean;
 }
+type ZTableDragEntity = 'row' | 'settings-column';
+type ZTableDropEdge = 'top' | 'bottom';
+interface ZTableDragData {
+    tableId: string;
+    entity: ZTableDragEntity;
+    itemId: string;
+}
+interface ZTableDragDropData {
+    source: ZTableDragData;
+    target: ZTableDragData;
+    edge: ZTableDropEdge;
+}
 /**
  * Extends TanStack's TableMeta to add a custom `updateData` callback.
  * This is used by inline edit cells to notify the table of value changes.
@@ -721,6 +752,9 @@ declare module '@tanstack/angular-table' {
     }
 }
 
+type ZTableBulkActionRenderItem<T> = ZTableBulkActionViewItem<T> & {
+    buttonType: ZButtonVariants['zType'];
+};
 declare class ZTableComponent<T> implements AfterViewInit {
     /** Unified change event — parent listens to this for all table interactions */
     readonly zChange: _angular_core.OutputEmitterRef<ZTableChangeEvent<T>>;
@@ -737,6 +771,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 _dragService;
     private readonly _zExcel;
     private readonly _zTranslate;
     /** Prevents recursive scroll sync between thead/tbody/tfoot */
@@ -747,16 +782,18 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _resizeObserver;
     /** Debounces rapid settings changes (visibility/pin toggles) */
     private _settingsDebounceTimeout;
+    private _visibilityDebounceTimeout;
     /** Debounces filter change emissions to server */
     private _filterEmitDebounceTimeout;
     /** Keeps the bulk bar mounted long enough for its exit animation */
     private _bulkBarTimer;
     private readonly _activeColumnVisibilityPopover;
+    private _hasInitializedColumnPinning;
     /** 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) */
     protected readonly isProcessing: _angular_core.WritableSignal<boolean>;
-    protected readonly isDraggingRow: _angular_core.WritableSignal<boolean>;
+    protected readonly dragInstanceId: string;
     protected readonly theadWrapper: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
     protected readonly tbodyContainer: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
     protected readonly tbodyWrapper: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
@@ -798,7 +835,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     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>[]>;
+    protected readonly bulkBarItems: _angular_core.WritableSignal<ZTableBulkActionRenderItem<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 */
@@ -842,7 +879,9 @@ declare class ZTableComponent<T> implements AfterViewInit {
         config: ZTableActionColumnConfig<T>;
         width: number;
     } | null>;
+    private readonly _actionColumnRows;
     protected readonly hasActionColumn: _angular_core.Signal<boolean>;
+    private readonly _fixedColumnPinning;
     protected readonly hasFiltering: _angular_core.Signal<boolean>;
     protected readonly hasLocalFiltering: _angular_core.Signal<boolean>;
     protected readonly hasSorting: _angular_core.Signal<boolean>;
@@ -900,6 +939,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly virtualRightSpacerWidth: _angular_core.Signal<number>;
     protected readonly renderedColumnCount: _angular_core.Signal<number>;
     protected readonly orderedLeafColumns: _angular_core.Signal<Column<T, unknown>[]>;
+    protected readonly fillColumnId: _angular_core.Signal<string | null>;
     protected readonly hideableColumns: _angular_core.Signal<Column<T, unknown>[]>;
     protected readonly orderedHeaderGroups: _angular_core.Signal<{
         id: string;
@@ -938,16 +978,14 @@ declare class ZTableComponent<T> implements AfterViewInit {
     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 bulkActionItems: _angular_core.Signal<ZTableBulkActionRenderItem<T>[]>;
     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;
+    private readonly _rowDragAutoScroll;
     constructor();
     ngAfterViewInit(): void;
     /**
@@ -979,6 +1017,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _refreshPinnedRowHeights;
     private _checkVerticalScroll;
     private _checkLastRowTouchesBottom;
+    private _getTbodyViewportElement;
     private _checkHorizontalScroll;
     private _updateScrollShadowState;
     hasRightPinnedColumns(): boolean;
@@ -989,11 +1028,8 @@ declare class ZTableComponent<T> implements AfterViewInit {
      * Giữ tạm để các consumer/template cũ còn compile trong giai đoạn chuyển đổi.
      */
     handleSort(event: Event, handler?: (event: unknown) => void): void;
-    onColumnDrop(event: CdkDragDrop<string[]>): void;
-    onRowDragStarted(): void;
-    onRowDragEnded(_event: CdkDragEnd<Row<T>>): void;
-    onRowDrop(event: CdkDragDrop<Row<T>[]>): void;
-    private _resolveRowDragDropIndex;
+    protected _handleDragDrop(event: ZTableDragDropData): void;
+    private _handleRowDrop;
     onToggleAllColumns(): void;
     onPageChange(event: {
         pageIndex: number;
@@ -1018,10 +1054,15 @@ declare class ZTableComponent<T> implements AfterViewInit {
     hideColumnPopoversOnOutsideClick(optionsPopover: ZPopoverDirective): void;
     openSettingsDrawerFromColumnMenu(...popovers: ZPopoverDirective[]): void;
     private _isColumnHiddenFromVisibilityMenu;
+    private _setColumnPinning;
+    private _areColumnIdListsEqual;
     moveColumnLeft(columnId: string): void;
     moveColumnRight(columnId: string): void;
     isFirstMovableColumn(columnId: string): boolean;
     isLastMovableColumn(columnId: string): boolean;
+    private _isFixedLeadingColumnId;
+    private _isRowPinColumnId;
+    private _isSpecialColumnId;
     /** Saves current column layout, sizing, pinning, and visibility to ZCacheService */
     private _saveConfig;
     private _collectColumnInfo;
@@ -1243,6 +1284,8 @@ declare const getHeaderConfig: <T>(col: ZTableColumnConfig<T> | undefined) => {
  */
 declare const getBodyConfig: <T>(col: ZTableColumnConfig<T> | undefined, ctx?: CellContext<T, unknown>) => {
     content: ZTableCellContent<T> | undefined;
+    type: "default";
+    tagColor: "primary";
     class: string | undefined;
     style: Record<string, string> | undefined;
     align: string | undefined;
@@ -1253,6 +1296,8 @@ declare const getBodyConfig: <T>(col: ZTableColumnConfig<T> | undefined, ctx?: C
     tooltip: string | object | undefined;
 } | {
     content: ZTableCellContent<T> | undefined;
+    type: _shival99_z_ui_components_z_table.ZTableBodyContentType;
+    tagColor: _shival99_z_ui_components_z_tags.ZTagColor | ((info: CellContext<T, unknown>) => _shival99_z_ui_components_z_table.ZTableTagColor);
     class: string | ((info: CellContext<T, unknown>) => string) | undefined;
     style: Record<string, string> | undefined;
     align: ZTableAlign | undefined;
@@ -1299,4 +1344,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, 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 };
+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 };

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

@@ -20,8 +20,8 @@ interface ZTab {
     badge?: string | number;
     template?: TemplateRef<unknown>;
 }
-type ZTabsType = 'line' | 'default' | 'enclosed' | 'enclosed-solid' | 'soft' | 'pill' | 'solid' | 'underline' | 'underlined' | 'badge' | 'sharp' | 'vertical-sharp' | 'code-line';
-type ZTabsSize = 'sm' | 'default' | 'lg';
+type ZTabsType = 'line' | 'soft' | 'segment' | 'folder' | 'folder-soft' | 'folder-solid' | 'underline' | 'underlined' | 'badge' | 'sharp' | 'sharp-line' | 'vertical-sharp' | 'code-line';
+type ZTabsSize = 'xs' | 'sm' | 'default' | 'lg';
 type ZTabsOrientation = 'horizontal' | 'vertical';
 
 declare class ZTabsComponent implements OnInit, AfterViewInit, OnDestroy {
@@ -36,6 +36,7 @@ declare class ZTabsComponent implements OnInit, AfterViewInit, OnDestroy {
     readonly zLazy: _angular_core.InputSignal<boolean>;
     readonly zDestroyInactive: _angular_core.InputSignal<boolean>;
     readonly zTabsOnly: _angular_core.InputSignal<boolean>;
+    readonly zShowContentWrapper: _angular_core.InputSignal<boolean>;
     readonly zReloadable: _angular_core.InputSignal<boolean>;
     readonly zEmitOnActiveClick: _angular_core.InputSignal<boolean>;
     readonly zCache: _angular_core.InputSignal<boolean>;
@@ -53,6 +54,9 @@ declare class ZTabsComponent implements OnInit, AfterViewInit, OnDestroy {
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     protected readonly tabsClasses: _angular_core.Signal<string>;
+    protected readonly contentWrapperFramed: _angular_core.Signal<boolean>;
+    protected readonly tabsListHasBottomPadding: _angular_core.Signal<boolean>;
+    protected readonly verticalTabsScrollable: _angular_core.Signal<boolean>;
     protected getTabItemClasses(_tab: ZTab): string;
     protected selectTab(tab: ZTab, scrollToView?: boolean): void;
     protected isTabActive(tab: ZTab): boolean;
@@ -67,16 +71,16 @@ declare class ZTabsComponent implements OnInit, AfterViewInit, OnDestroy {
     private _getCacheKey;
     protected scrollToActiveDropdownItem(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZTabsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZTabsComponent, "z-tabs", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zTabs": { "alias": "zTabs"; "required": true; "isSignal": true; }; "zType": { "alias": "zType"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zOrientation": { "alias": "zOrientation"; "required": false; "isSignal": true; }; "zLazy": { "alias": "zLazy"; "required": false; "isSignal": true; }; "zDestroyInactive": { "alias": "zDestroyInactive"; "required": false; "isSignal": true; }; "zTabsOnly": { "alias": "zTabsOnly"; "required": false; "isSignal": true; }; "zReloadable": { "alias": "zReloadable"; "required": false; "isSignal": true; }; "zEmitOnActiveClick": { "alias": "zEmitOnActiveClick"; "required": false; "isSignal": true; }; "zCache": { "alias": "zCache"; "required": false; "isSignal": true; }; "zCacheKey": { "alias": "zCacheKey"; "required": false; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": false; "isSignal": true; }; }, { "activeTab": "activeTabChange"; "zTabChange": "zTabChange"; }, ["tabPanels"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZTabsComponent, "z-tabs", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zTabs": { "alias": "zTabs"; "required": true; "isSignal": true; }; "zType": { "alias": "zType"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zOrientation": { "alias": "zOrientation"; "required": false; "isSignal": true; }; "zLazy": { "alias": "zLazy"; "required": false; "isSignal": true; }; "zDestroyInactive": { "alias": "zDestroyInactive"; "required": false; "isSignal": true; }; "zTabsOnly": { "alias": "zTabsOnly"; "required": false; "isSignal": true; }; "zShowContentWrapper": { "alias": "zShowContentWrapper"; "required": false; "isSignal": true; }; "zReloadable": { "alias": "zReloadable"; "required": false; "isSignal": true; }; "zEmitOnActiveClick": { "alias": "zEmitOnActiveClick"; "required": false; "isSignal": true; }; "zCache": { "alias": "zCache"; "required": false; "isSignal": true; }; "zCacheKey": { "alias": "zCacheKey"; "required": false; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": false; "isSignal": true; }; }, { "activeTab": "activeTabChange"; "zTabChange": "zTabChange"; }, ["tabPanels"], never, true, never>;
 }
 
 declare const zTabsVariants: (props?: ({
-    zType?: "line" | "default" | "enclosed" | "enclosed-solid" | "soft" | "pill" | "solid" | "underline" | "underlined" | "badge" | "sharp" | "vertical-sharp" | "code-line" | null | undefined;
+    zType?: "line" | "soft" | "segment" | "folder" | "folder-soft" | "folder-solid" | "underline" | "underlined" | "badge" | "sharp" | "sharp-line" | "vertical-sharp" | "code-line" | null | undefined;
     zOrientation?: "horizontal" | "vertical" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zTabItemVariants: (props?: ({
-    zType?: "line" | "default" | "enclosed" | "enclosed-solid" | "soft" | "pill" | "solid" | "underline" | "underlined" | "badge" | "sharp" | "vertical-sharp" | "code-line" | null | undefined;
-    zSize?: "default" | "sm" | "lg" | null | undefined;
+    zType?: "line" | "soft" | "segment" | "folder" | "folder-soft" | "folder-solid" | "underline" | "underlined" | "badge" | "sharp" | "sharp-line" | "vertical-sharp" | "code-line" | null | undefined;
+    zSize?: "xs" | "sm" | "default" | "lg" | null | undefined;
     zOrientation?: "horizontal" | "vertical" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZTabsVariants = VariantProps<typeof zTabsVariants>;

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

@@ -18,6 +18,9 @@ interface ZTagRandomColorCache {
     text: string;
     border: string;
     hoverBg: string;
+    darkBg?: string;
+    darkText?: string;
+    darkHoverBg?: string;
 }
 interface ZTagConfig {
     size: ZTagSize;

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

@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
 import { InjectionToken, EnvironmentProviders, OnDestroy } from '@angular/core';
 import { ClassValue } from 'clsx';
 import { ExternalToast } from '@shival99/ngx-sonner';
+import { ZIcon } from '@shival99/z-ui/components/z-icon';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
@@ -32,6 +33,25 @@ interface ZToasterConfig {
     zDir?: ZToastDir;
 }
 declare const Z_TOASTER_DEFAULT_CONFIG: ZToasterConfig;
+interface ZCustomToastAction {
+    label: string;
+    onClick: (toastId: string | number) => void;
+    zType?: 'primary' | 'secondary' | 'outline' | 'text' | 'danger';
+}
+interface ZCustomToastConfig {
+    title: string;
+    description?: string;
+    type?: 'success' | 'error' | 'warning' | 'info' | 'avatar' | 'image' | 'progress' | 'default';
+    icon?: string;
+    avatarUrl?: string;
+    avatarOnline?: boolean;
+    avatarBadgeIcon?: string;
+    imageUrl?: string;
+    progress?: number;
+    actions?: ZCustomToastAction[];
+    closeable?: boolean;
+    toastId?: string | number;
+}
 
 declare class ZToastComponent {
     private readonly _themeService;
@@ -61,6 +81,18 @@ declare class ZToastComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZToastComponent, "z-toast, z-toaster", ["zToast"], { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zVariant": { "alias": "zVariant"; "required": false; "isSignal": true; }; "zTheme": { "alias": "zTheme"; "required": false; "isSignal": true; }; "zPosition": { "alias": "zPosition"; "required": false; "isSignal": true; }; "zRichColors": { "alias": "zRichColors"; "required": false; "isSignal": true; }; "zExpand": { "alias": "zExpand"; "required": false; "isSignal": true; }; "zDuration": { "alias": "zDuration"; "required": false; "isSignal": true; }; "zVisibleToasts": { "alias": "zVisibleToasts"; "required": false; "isSignal": true; }; "zCloseButton": { "alias": "zCloseButton"; "required": false; "isSignal": true; }; "zToastOptions": { "alias": "zToastOptions"; "required": false; "isSignal": true; }; "zDir": { "alias": "zDir"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare class ZToastCustomComponent {
+    private readonly _toastService;
+    readonly config: _angular_core.InputSignal<ZCustomToastConfig>;
+    protected dismiss(): void;
+    protected handleAction(action: ZCustomToastAction): void;
+    protected getFeaturedIconName(): ZIcon;
+    protected getFeaturedIconContainerClasses(): string;
+    protected getActionClasses(action: ZCustomToastAction): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZToastCustomComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZToastCustomComponent, "z-toast-custom", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Provides global toast configuration options
  * Use this in app.config.ts: providers: [provideZToast({ zPosition: 'top-right' })]
@@ -103,6 +135,7 @@ declare class ZToastService implements OnDestroy {
     info(message: string, options?: ZToastOptions): string | number;
     loading(message: string, options?: ZToastOptions): string | number;
     promise<T>(promise: Promise<T>, messages: ZToastPromiseMessages<T>): string | number | undefined;
+    custom(config: ZCustomToastConfig, options?: ZToastOptions): string | number;
     dismiss(toastId?: string | number): void;
     dismissAll(): void;
     destroy(): void;
@@ -123,5 +156,5 @@ declare const zToastVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZToastVariants = VariantProps<typeof zToastVariants>;
 
-export { ZToastComponent, ZToastService, Z_TOASTER_CONFIG, Z_TOASTER_DEFAULT_CONFIG, Z_TOAST_DATA, provideZToast, zToastVariants };
-export type { ZToastDir, ZToastOptions, ZToastPosition, ZToastPromiseMessages, ZToastTheme, ZToastType, ZToastVariants, ZToasterConfig };
+export { ZToastComponent, ZToastCustomComponent, ZToastService, Z_TOASTER_CONFIG, Z_TOASTER_DEFAULT_CONFIG, Z_TOAST_DATA, provideZToast, zToastVariants };
+export type { ZCustomToastAction, ZCustomToastConfig, ZToastDir, ZToastOptions, ZToastPosition, ZToastPromiseMessages, ZToastTheme, ZToastType, ZToastVariants, ZToasterConfig };