@shival99/z-ui 2.5.2 → 2.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shival99/z-ui",
-  "version": "2.5.2",
+  "version": "2.5.4",
   "description": "Z-UI: Modern Angular UI Component Library - A comprehensive, high-performance design system built with Angular 22, featuring 45+ customizable components with dark mode, accessibility, and enterprise-ready features.",
   "keywords": [
     "angular",
@@ -83,7 +83,6 @@
     "exceljs": "^4.4.0",
     "file-saver": "^2.0.5",
     "hls.js": ">=1.6.0",
-    "mammoth": ">=1.12.0",
     "minisearch": ">=7.0.0",
     "ng-animated-icons": ">=1.9.0",
     "ng2-pdfjs-viewer": ">=26.0.0",
@@ -168,9 +167,6 @@
     "docx-preview": {
       "optional": true
     },
-    "mammoth": {
-      "optional": true
-    },
     "ng2-pdfjs-viewer": {
       "optional": true
     },
@@ -191,9 +187,21 @@
     },
     "tiptap-extension-resize-image": {
       "optional": true
+    },
+    "exceljs": {
+      "optional": true
+    },
+    "file-saver": {
+      "optional": true
+    },
+    "xlsx": {
+      "optional": true
     }
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "**/*.css",
+    "**/z-media-player/**"
+  ],
   "engines": {
     "node": ">=18.0.0"
   },
@@ -419,6 +427,14 @@
       "types": "./types/shival99-z-ui-services.d.ts",
       "default": "./fesm2022/shival99-z-ui-services.mjs"
     },
+    "./services/excel": {
+      "types": "./types/shival99-z-ui-services-excel.d.ts",
+      "default": "./fesm2022/shival99-z-ui-services-excel.mjs"
+    },
+    "./services/office": {
+      "types": "./types/shival99-z-ui-services-office.d.ts",
+      "default": "./fesm2022/shival99-z-ui-services-office.mjs"
+    },
     "./utils": {
       "types": "./types/shival99-z-ui-utils.d.ts",
       "default": "./fesm2022/shival99-z-ui-utils.mjs"

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

@@ -179,6 +179,7 @@ declare class ZAutocompleteComponent<T = unknown> implements OnInit, ControlValu
     private _asyncRequestId;
     private _lastFilteredOptionsLength;
     private _shouldScrollActiveOption;
+    private _pendingServerSearchScrollReset;
     /** Guards against focus+click both requesting an open on the same gesture, which doubled CD cycles. */
     private _openRequested;
     /** Stores input value before keyboard navigation for ESC revert */
@@ -282,7 +283,7 @@ declare class ZAutocompleteComponent<T = unknown> implements OnInit, ControlValu
 
 declare const zAutocompleteInputVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "error" | "disabled" | "readonly" | "open" | null | undefined;
+    zStatus?: "default" | "open" | "error" | "disabled" | "readonly" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZAutocompleteInputVariants = VariantProps<typeof zAutocompleteInputVariants>;
 declare const zAutocompleteOptionVariants: (props?: ({

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

@@ -435,16 +435,16 @@ declare class ZCalendarComponent implements OnInit, ControlValueAccessor {
 
 declare const zCalendarVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "disabled" | "readonly" | "open" | "error" | null | undefined;
+    zStatus?: "default" | "disabled" | "open" | "error" | "readonly" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zCalendarDayVariants: (props?: ({
-    state?: "default" | "disabled" | "today" | "selected" | "inRange" | "rangeStart" | "rangeEnd" | "rangeSingle" | "otherMonth" | "hovered" | null | undefined;
+    state?: "default" | "today" | "selected" | "inRange" | "rangeStart" | "rangeEnd" | "rangeSingle" | "disabled" | "otherMonth" | "hovered" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zCalendarMonthVariants: (props?: ({
-    state?: "default" | "current" | "disabled" | "selected" | null | undefined;
+    state?: "default" | "selected" | "disabled" | "current" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zCalendarYearVariants: (props?: ({
-    state?: "default" | "current" | "disabled" | "selected" | null | undefined;
+    state?: "default" | "selected" | "disabled" | "current" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 
 export { ZCalendarComponent, zCalendarDayVariants, zCalendarMonthVariants, zCalendarVariants, zCalendarYearVariants };

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

@@ -169,21 +169,20 @@ declare class ZOverlayService {
 }
 
 /**
- * Khoá scroll trang khi overlay toàn màn hình (modal/drawer) mở — thay cho
- * `scrollStrategies.block()` của CDK. Đếm tham chiếu để modal-trong-modal không mở khoá sớm.
+ * Khoá scroll trang khi modal/drawer mở — thay `scrollStrategies.block()` của CDK, đếm tham chiếu
+ * để modal-trong-modal không mở khoá sớm.
  *
- * Chống layout shift bằng cách đo gutter thật của `<html>` rồi bù vào body trước khi khoá overflow.
- * Không giữ `scrollbar-gutter: stable` trong lúc overlay mở: fixed backdrop/panel khi đó bị giới
- * hạn theo layout viewport và hở một dải scrollbar ở mép phải trên Windows.
+ * Chống layout shift bằng cách GIỮ NGUYÊN gutter của scrollbar thay vì bù trừ sau khi mất nó:
+ * đo gutter thật của `<html>`, nếu trang đang dành chỗ cho scrollbar thì gắn `.z-scroll-locked-gutter`
+ * để CSS ép `scrollbar-gutter: stable`. Chiều rộng layout không đổi nên không có gì nhảy và scrollbar
+ * không bị nhả ra rồi trả lại. Đổi lại layout viewport hẹp hơn 100vw, overlay `fixed` vẫn phủ kín nhờ
+ * `.z-overlay-global { contain: paint }` trong `overlay.css`.
  *
- * Lưu ý: phải đo bằng `getBoundingClientRect()` của `<html>`, không dùng `documentElement.clientWidth`
- * — với root element thuộc tính đó trả về kích thước viewport nên luôn cộng thêm chiều rộng scrollbar
- * khi `overflow: hidden`, dẫn tới bù thừa và làm UI co lại đúng bằng chiều rộng scrollbar.
+ * Safari < 18.4 chưa có `scrollbar-gutter` nên vẫn nhả gutter — phải đo lại sau khi khoá, phần thật sự
+ * mất mới bù vào `body.paddingRight` và ghi ra `--z-scroll-lock-gutter` cho app bù tiếp element `fixed`.
  *
- * Hiệu số được ghi ra biến CSS `--z-scroll-lock-gutter` để app bù thêm cho element `position: fixed`
- * của riêng mình nếu cần.
- *
- * Vị trí scroll vẫn được lưu để khôi phục nếu ứng dụng thay đổi scroll programmatically trong lúc khoá.
+ * Phải đo bằng `getBoundingClientRect()`, không dùng `documentElement.clientWidth`: với root element
+ * thuộc tính đó trả về kích thước viewport nên luôn cộng thêm chiều rộng scrollbar khi `overflow: hidden`.
  */
 declare class ZScrollLockService {
     private readonly _document;

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

@@ -213,6 +213,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected readonly treeDirection: _angular_core.WritableSignal<"none" | "forward" | "back">;
     protected readonly config: _angular_core.Signal<ZSelectConfig<T>>;
     protected readonly hasAsyncOptions: _angular_core.Signal<boolean>;
+    protected readonly hasPaginatedOptions: _angular_core.Signal<boolean>;
     protected readonly sourceOptions: _angular_core.Signal<ZSelectOption<T>[]>;
     protected readonly asyncSelectedOptions: _angular_core.Signal<ZSelectOption<T>[]>;
     protected readonly isLoading: _angular_core.Signal<boolean>;
@@ -258,7 +259,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     protected readonly isEmptyData: _angular_core.Signal<boolean>;
     protected readonly isNoSearchResults: _angular_core.Signal<boolean>;
     protected readonly optionsMaxHeight: _angular_core.Signal<number>;
-    protected readonly currentStatus: _angular_core.Signal<"default" | "disabled" | "readonly" | "open" | "error">;
+    protected readonly currentStatus: _angular_core.Signal<"default" | "open" | "error" | "disabled" | "readonly">;
     private readonly _shouldShowValidation;
     protected readonly hasError: _angular_core.Signal<boolean>;
     protected readonly errorMessage: _angular_core.Signal<string>;
@@ -276,6 +277,7 @@ declare class ZSelectComponent<T = unknown> implements OnInit, ControlValueAcces
     private _onTouched;
     private _ngControl;
     private readonly _isNgModel;
+    private _pendingServerSearchScrollReset;
     constructor();
     ngOnInit(): void;
     writeValue(value: T | T[] | null): void;
@@ -369,7 +371,7 @@ declare const TAG_COLORS: ZSelectTagColor[];
 declare const zSelectVariants: (props?: ({
     zVariant?: "default" | "ghost" | null | undefined;
     zSize?: "sm" | "default" | "lg" | null | undefined;
-    zStatus?: "default" | "error" | "disabled" | "readonly" | "open" | null | undefined;
+    zStatus?: "default" | "open" | "error" | "disabled" | "readonly" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const zSelectTagVariants: (props?: ({
     zSize?: "sm" | "default" | "lg" | null | undefined;

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

@@ -2168,7 +2168,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<"asc" | "desc" | "none">;
+    protected readonly draftSortValue: _angular_core.Signal<"none" | "asc" | "desc">;
     protected readonly rangeMinValue: _angular_core.Signal<any>;
     protected readonly rangeMaxValue: _angular_core.Signal<any>;
     protected readonly dateValue: _angular_core.Signal<Date | null>;
@@ -2240,7 +2240,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>;

package/types/shival99-z-ui-services-excel.d.ts

@@ -0,0 +1,36 @@
+import { ZExcelConfig, ZExcelExportOptions, ZExcelFromTableConfig, ZExcelExportResult } from '@shival99/z-ui/services';
+import * as i0 from '@angular/core';
+
+declare class ZExcelService {
+    private static _isHeaderConfig;
+    private static _getHeaderConfig;
+    exportExcel<T = unknown>(config: ZExcelConfig<T>, options?: ZExcelExportOptions): Promise<void>;
+    exportFromTable<T = unknown>(config: ZExcelFromTableConfig<T>, options?: ZExcelExportOptions): Promise<void>;
+    exportFromElement(elementId: string, fileName?: string, options?: ZExcelExportOptions): Promise<void>;
+    exportFromElementXlsx(elementId: string, fileName?: string, options?: ZExcelExportOptions): Promise<void>;
+    static exportExcelStatic<T = unknown>(config: ZExcelConfig<T>): Promise<ZExcelExportResult>;
+    static exportFromElementStatic(elementId: string, fileName?: string): Promise<ZExcelExportResult>;
+    private _saveFile;
+    private _convertTableColumnsToExcel;
+    private static _flattenColumns;
+    private static _calculateHeaderLevels;
+    private static _createHeaderRows;
+    private static _buildHeaderStructure;
+    private static _getLeafCount;
+    private static _getCellValue;
+    private static _processMergeRegions;
+    private static _applyAutoFitWidth;
+    private static _applyAutoFitWidthForTable;
+    private static _getMergedColumnSpan;
+    private static _calculateCellWidth;
+    private static _processTableElement;
+    private static _parseContentValue;
+    private static _applyCellFormatFromHTML;
+    private static _getExcelAlignment;
+    private static _getExcelVerticalAlignment;
+    private static _formatTimestamp;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZExcelService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+export { ZExcelService };

package/types/shival99-z-ui-services-office.d.ts

@@ -0,0 +1,15 @@
+import { ZGalleryOfficeRenderResult } from '@shival99/z-ui/services';
+import * as i0 from '@angular/core';
+
+declare class ZGalleryOfficeRenderService {
+    renderDoc(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
+    renderSheet(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
+    renderSlide(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
+    private _toUniverWorkbook;
+    private _toUniverCellData;
+    private _observeDocxZoom;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZGalleryOfficeRenderService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+export { ZGalleryOfficeRenderService };

package/types/shival99-z-ui-services.d.ts

@@ -1,12 +1,12 @@
 import * as i0 from '@angular/core';
 import { Type, TemplateRef, ViewContainerRef, EventEmitter, ComponentRef, Signal, InjectionToken } from '@angular/core';
 import { ZOverlayRef } from '@shival99/z-ui/components/z-overlay';
-import { ZFormatNumExcelOptions } from '@shival99/z-ui/utils';
 import { HttpHeaders, HttpContext, HttpParams, HttpClient } from '@angular/common/http';
 import { Router } from '@angular/router';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
 import { TranslationObject, TranslateService } from '@ngx-translate/core';
+import { ZFormatNumExcelOptions } from '@shival99/z-ui/utils';
 
 interface ZCacheEntry<T = unknown> {
     data: T;
@@ -155,198 +155,6 @@ declare class ZDynamicService {
     static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
-type ZExcelAlign = 'left' | 'center' | 'right';
-interface ZExcelTableColumnConfig<T = unknown> {
-    id: string;
-    visible?: boolean | (() => boolean);
-    accessorKey?: keyof T & string;
-    accessorFn?: (row: T) => unknown;
-    header?: string | {
-        content?: string | (() => string);
-        align?: ZExcelAlign;
-    };
-    size?: number;
-    columns?: ZExcelTableColumnConfig<T>[];
-}
-interface ZExcelTableHeaderConfig {
-    content?: string | (() => string);
-    class?: string;
-    style?: Record<string, string>;
-    align?: string;
-    tooltip?: string | object;
-    rowSpan?: number;
-    colSpan?: number;
-}
-interface ZExcelCell {
-    value: unknown;
-    font?: {
-        name?: string;
-        size?: number;
-        bold?: boolean;
-        italic?: boolean;
-        color?: {
-            argb?: string;
-        };
-    };
-    fill?: {
-        type?: string;
-        pattern?: string;
-        fgColor?: {
-            argb?: string;
-        };
-    };
-    alignment?: {
-        horizontal?: 'left' | 'center' | 'right';
-        vertical?: 'top' | 'middle' | 'bottom';
-        wrapText?: boolean;
-    };
-    border?: {
-        top?: {
-            style?: string;
-        };
-        left?: {
-            style?: string;
-        };
-        bottom?: {
-            style?: string;
-        };
-        right?: {
-            style?: string;
-        };
-    };
-    note?: string;
-    numFmt?: string;
-}
-interface ZExcelCellContext<T> {
-    row: T;
-    rowIndex: number;
-    data: T[];
-    cell: ZExcelCell;
-}
-interface ZExcelHeaderContext {
-    colIndex: number;
-    cell: ZExcelCell;
-}
-interface ZExcelColumnConfig<T = unknown> {
-    id: string;
-    header?: string;
-    accessorKey?: keyof T & string;
-    accessorFn?: (row: T, rowIndex: number, data: T[]) => unknown;
-    width?: number;
-    autoFit?: boolean;
-    align?: ZExcelAlign;
-    headerAlign?: ZExcelAlign;
-    rowSpan?: number | ((row: T, rowIndex: number, data: T[]) => number);
-    colSpan?: number | ((row: T, rowIndex: number, data: T[]) => number);
-    headerRowSpan?: number;
-    headerColSpan?: number;
-    format?: (context: ZExcelCellContext<T>) => void;
-    formatNum?: ZFormatNumExcelOptions;
-    formatHeader?: (cell: ZExcelCell) => void;
-    note?: (row: T, rowIndex: number, data: T[]) => string | undefined;
-    columns?: ZExcelColumnConfig<T>[];
-    visible?: boolean;
-}
-interface ZExcelSheetSource<T = unknown> {
-    sheetName?: string;
-    data: T[];
-}
-interface ZExcelConfig<T = unknown> {
-    fileName?: string;
-    columns: ZExcelColumnConfig<T>[];
-    source: ZExcelSheetSource<T>[];
-}
-interface ZExcelToastHandler {
-    success?: (message: string) => void;
-    error?: (message: string) => void;
-}
-interface ZExcelExportOptions {
-    addTimestamp?: boolean;
-    showNotification?: boolean;
-    /**
-     * Optional toast handler for showing success/error notifications.
-     * If not provided, no notifications will be shown.
-     */
-    toast?: ZExcelToastHandler;
-}
-interface ZExcelExportResult {
-    buffer: ArrayBuffer;
-    fileName: string;
-}
-interface ZExcelFontConfig {
-    name: string;
-    size: number;
-    bold?: boolean;
-}
-interface ZExcelHeaderColors {
-    level0: string;
-    level1: string;
-    [key: string]: string;
-}
-interface ZExcelDefaultConfig {
-    font: ZExcelFontConfig;
-    headerFont: ZExcelFontConfig;
-    headerColors: ZExcelHeaderColors;
-}
-type ZTableToExcelColumn<T> = Omit<ZExcelColumnConfig<T>, 'header'> & {
-    header?: string | ((col: ZExcelTableColumnConfig<T>) => string);
-};
-interface ZExcelFromTableConfig<T = unknown> {
-    fileName?: string;
-    tableColumns: ZExcelTableColumnConfig<T>[];
-    excelOverrides?: Partial<Record<string, Partial<ZExcelColumnConfig<T>>>>;
-    source: ZExcelSheetSource<T>[];
-    excludeColumns?: string[];
-    headerResolver?: (col: ZExcelTableColumnConfig<T>) => string;
-}
-
-declare class ZExcelService {
-    private static _isHeaderConfig;
-    private static _getHeaderConfig;
-    exportExcel<T = unknown>(config: ZExcelConfig<T>, options?: ZExcelExportOptions): Promise<void>;
-    exportFromTable<T = unknown>(config: ZExcelFromTableConfig<T>, options?: ZExcelExportOptions): Promise<void>;
-    exportFromElement(elementId: string, fileName?: string, options?: ZExcelExportOptions): Promise<void>;
-    exportFromElementXlsx(elementId: string, fileName?: string, options?: ZExcelExportOptions): Promise<void>;
-    static exportExcelStatic<T = unknown>(config: ZExcelConfig<T>): Promise<ZExcelExportResult>;
-    static exportFromElementStatic(elementId: string, fileName?: string): Promise<ZExcelExportResult>;
-    private _saveFile;
-    private _convertTableColumnsToExcel;
-    private static _flattenColumns;
-    private static _calculateHeaderLevels;
-    private static _createHeaderRows;
-    private static _buildHeaderStructure;
-    private static _getLeafCount;
-    private static _getCellValue;
-    private static _processMergeRegions;
-    private static _applyAutoFitWidth;
-    private static _applyAutoFitWidthForTable;
-    private static _getMergedColumnSpan;
-    private static _calculateCellWidth;
-    private static _processTableElement;
-    private static _parseContentValue;
-    private static _applyCellFormatFromHTML;
-    private static _getExcelAlignment;
-    private static _getExcelVerticalAlignment;
-    private static _formatTimestamp;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ZExcelService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
-}
-
-interface ZGalleryOfficeRenderResult {
-    dispose: () => void;
-}
-
-declare class ZGalleryOfficeRenderService {
-    renderDoc(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
-    renderSheet(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
-    renderSlide(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
-    private _toUniverWorkbook;
-    private _toUniverCellData;
-    private _observeDocxZoom;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ZGalleryOfficeRenderService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
-}
-
 type ZHttpParamsType<T> = {
     [K in keyof T]: string | number | boolean | ReadonlyArray<string | number | boolean>;
 };
@@ -752,6 +560,151 @@ declare function zStripLegacyScopedCacheKey(key: string): string;
 declare const Z_DYNAMIC_DATA: InjectionToken<unknown>;
 declare const Z_DYNAMIC_ANIMATION_DURATION = 150;
 
+type ZExcelAlign = 'left' | 'center' | 'right';
+interface ZExcelTableColumnConfig<T = unknown> {
+    id: string;
+    visible?: boolean | (() => boolean);
+    accessorKey?: keyof T & string;
+    accessorFn?: (row: T) => unknown;
+    header?: string | {
+        content?: string | (() => string);
+        align?: ZExcelAlign;
+    };
+    size?: number;
+    columns?: ZExcelTableColumnConfig<T>[];
+}
+interface ZExcelTableHeaderConfig {
+    content?: string | (() => string);
+    class?: string;
+    style?: Record<string, string>;
+    align?: string;
+    tooltip?: string | object;
+    rowSpan?: number;
+    colSpan?: number;
+}
+interface ZExcelCell {
+    value: unknown;
+    font?: {
+        name?: string;
+        size?: number;
+        bold?: boolean;
+        italic?: boolean;
+        color?: {
+            argb?: string;
+        };
+    };
+    fill?: {
+        type?: string;
+        pattern?: string;
+        fgColor?: {
+            argb?: string;
+        };
+    };
+    alignment?: {
+        horizontal?: 'left' | 'center' | 'right';
+        vertical?: 'top' | 'middle' | 'bottom';
+        wrapText?: boolean;
+    };
+    border?: {
+        top?: {
+            style?: string;
+        };
+        left?: {
+            style?: string;
+        };
+        bottom?: {
+            style?: string;
+        };
+        right?: {
+            style?: string;
+        };
+    };
+    note?: string;
+    numFmt?: string;
+}
+interface ZExcelCellContext<T> {
+    row: T;
+    rowIndex: number;
+    data: T[];
+    cell: ZExcelCell;
+}
+interface ZExcelHeaderContext {
+    colIndex: number;
+    cell: ZExcelCell;
+}
+interface ZExcelColumnConfig<T = unknown> {
+    id: string;
+    header?: string;
+    accessorKey?: keyof T & string;
+    accessorFn?: (row: T, rowIndex: number, data: T[]) => unknown;
+    width?: number;
+    autoFit?: boolean;
+    align?: ZExcelAlign;
+    headerAlign?: ZExcelAlign;
+    rowSpan?: number | ((row: T, rowIndex: number, data: T[]) => number);
+    colSpan?: number | ((row: T, rowIndex: number, data: T[]) => number);
+    headerRowSpan?: number;
+    headerColSpan?: number;
+    format?: (context: ZExcelCellContext<T>) => void;
+    formatNum?: ZFormatNumExcelOptions;
+    formatHeader?: (cell: ZExcelCell) => void;
+    note?: (row: T, rowIndex: number, data: T[]) => string | undefined;
+    columns?: ZExcelColumnConfig<T>[];
+    visible?: boolean;
+}
+interface ZExcelSheetSource<T = unknown> {
+    sheetName?: string;
+    data: T[];
+}
+interface ZExcelConfig<T = unknown> {
+    fileName?: string;
+    columns: ZExcelColumnConfig<T>[];
+    source: ZExcelSheetSource<T>[];
+}
+interface ZExcelToastHandler {
+    success?: (message: string) => void;
+    error?: (message: string) => void;
+}
+interface ZExcelExportOptions {
+    addTimestamp?: boolean;
+    showNotification?: boolean;
+    /**
+     * Optional toast handler for showing success/error notifications.
+     * If not provided, no notifications will be shown.
+     */
+    toast?: ZExcelToastHandler;
+}
+interface ZExcelExportResult {
+    buffer: ArrayBuffer;
+    fileName: string;
+}
+interface ZExcelFontConfig {
+    name: string;
+    size: number;
+    bold?: boolean;
+}
+interface ZExcelHeaderColors {
+    level0: string;
+    level1: string;
+    [key: string]: string;
+}
+interface ZExcelDefaultConfig {
+    font: ZExcelFontConfig;
+    headerFont: ZExcelFontConfig;
+    headerColors: ZExcelHeaderColors;
+}
+type ZTableToExcelColumn<T> = Omit<ZExcelColumnConfig<T>, 'header'> & {
+    header?: string | ((col: ZExcelTableColumnConfig<T>) => string);
+};
+interface ZExcelFromTableConfig<T = unknown> {
+    fileName?: string;
+    tableColumns: ZExcelTableColumnConfig<T>[];
+    excelOverrides?: Partial<Record<string, Partial<ZExcelColumnConfig<T>>>>;
+    source: ZExcelSheetSource<T>[];
+    excludeColumns?: string[];
+    headerResolver?: (col: ZExcelTableColumnConfig<T>) => string;
+}
+
 declare const Z_EXCEL_COLORS: {
     readonly 'green-50': "FFF0FDF4";
     readonly 'green-100': "FFDCFCE7";
@@ -814,6 +767,10 @@ declare const Z_INDEXDB_MAX_VERSION = 1000;
 
 declare const Z_LANG_TO_LOCALE: Record<string, string>;
 
+interface ZGalleryOfficeRenderResult {
+    dispose: () => void;
+}
+
 interface ZTranslateConfig {
     /** Default language */
     defaultLang?: string;
@@ -830,5 +787,5 @@ interface ZTranslateI18nConfig {
 }
 declare const Z_LANG_CACHE_KEY = "Z_LANGUAGE";
 
-export { ZCacheService, ZDynamicRef, ZDynamicService, ZExcelService, ZGalleryOfficeRenderService, ZHttpAbstractService, ZIndexDbService, ZOverlayContainerService, ZOverlayZIndexService, ZSubjectService, ZThemeService, ZTranslateService, Z_CACHE_DEFAULT_PREFIX, Z_CACHE_SCOPE_SEPARATOR, Z_DB_SCOPE_SEPARATOR, Z_DEFAULT_THEME, Z_DYNAMIC_ANIMATION_DURATION, Z_DYNAMIC_DATA, Z_EXCEL_BORDER_THIN, Z_EXCEL_CHAR_WIDTH_MAP, Z_EXCEL_COLORS, Z_EXCEL_DEFAULT_CONFIG, Z_EXCEL_FONT_MULTIPLIERS, Z_EXCEL_WIDTH_LIMITS, Z_HTTP_DEFAULT_CONFIG, Z_INDEXDB_BATCH_SIZE, Z_INDEXDB_DEFAULT_CONFIG, Z_INDEXDB_MAX_VERSION, Z_LANG_CACHE_KEY, Z_LANG_TO_LOCALE, Z_STORAGE_SCOPE_FALLBACK, Z_THEME_CONFIG, Z_THEME_CSS_MAP, Z_THEME_PREFERENCES_CACHE_KEY, zBuildLegacyScopedCacheKey, zBuildLegacyScopedDbName, zBuildScopedCacheKey, zBuildScopedDbName, zConfigureStorageAppName, zGetStorageAppName, zNormalizeStorageAppName, zStripLegacyScopedCacheKey, zStripScopedCacheKey };
+export { ZCacheService, ZDynamicRef, ZDynamicService, ZHttpAbstractService, ZIndexDbService, ZOverlayContainerService, ZOverlayZIndexService, ZSubjectService, ZThemeService, ZTranslateService, Z_CACHE_DEFAULT_PREFIX, Z_CACHE_SCOPE_SEPARATOR, Z_DB_SCOPE_SEPARATOR, Z_DEFAULT_THEME, Z_DYNAMIC_ANIMATION_DURATION, Z_DYNAMIC_DATA, Z_EXCEL_BORDER_THIN, Z_EXCEL_CHAR_WIDTH_MAP, Z_EXCEL_COLORS, Z_EXCEL_DEFAULT_CONFIG, Z_EXCEL_FONT_MULTIPLIERS, Z_EXCEL_WIDTH_LIMITS, Z_HTTP_DEFAULT_CONFIG, Z_INDEXDB_BATCH_SIZE, Z_INDEXDB_DEFAULT_CONFIG, Z_INDEXDB_MAX_VERSION, Z_LANG_CACHE_KEY, Z_LANG_TO_LOCALE, Z_STORAGE_SCOPE_FALLBACK, Z_THEME_CONFIG, Z_THEME_CSS_MAP, Z_THEME_PREFERENCES_CACHE_KEY, zBuildLegacyScopedCacheKey, zBuildLegacyScopedDbName, zBuildScopedCacheKey, zBuildScopedDbName, zConfigureStorageAppName, zGetStorageAppName, zNormalizeStorageAppName, zStripLegacyScopedCacheKey, zStripScopedCacheKey };
 export type { ZCacheConfig, ZCacheEntry, ZDynamicContent, ZDynamicOptions, ZDynamicResult, ZDynamicTemplateContext, ZExcelAlign, ZExcelCell, ZExcelCellContext, ZExcelColumnConfig, ZExcelConfig, ZExcelDefaultConfig, ZExcelExportOptions, ZExcelExportResult, ZExcelFontConfig, ZExcelFromTableConfig, ZExcelHeaderColors, ZExcelHeaderContext, ZExcelSheetSource, ZExcelTableColumnConfig, ZExcelTableHeaderConfig, ZExcelToastHandler, ZGalleryOfficeRenderResult, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbGetOptions, ZIndexDbSetOptions, ZIndexDbStoreConfig, ZTableToExcelColumn, ZThemeConfig, ZThemeName, ZThemePreferences, ZTranslateConfig, ZTranslateI18nConfig };