@shival99/z-ui 1.0.15 → 1.0.17

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

@@ -1,8 +1,9 @@
+import { ZFormatNumExcelOptions } from '@shival99/z-ui/utils';
+import * as i0 from '@angular/core';
+import { InjectionToken } from '@angular/core';
 import { HttpHeaders, HttpContext, HttpParams, HttpClient } from '@angular/common/http';
 import { Router } from '@angular/router';
 import { Observable } from 'rxjs';
-import * as i0 from '@angular/core';
-import { InjectionToken } from '@angular/core';
 import { TranslationObject, TranslateService } from '@ngx-translate/core';
 
 interface ZCacheEntry<T = unknown> {
@@ -67,6 +68,182 @@ declare class ZCacheService {
     static keys(): string[];
 }
 
+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 _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<ZExcelService>;
+}
+
 type ZHttpParamsType<T> = {
     [K in keyof T]: string | number | boolean | ReadonlyArray<string | number | boolean>;
 };
@@ -397,6 +574,62 @@ declare class ZThemeService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ZThemeService>;
 }
 
+declare const Z_EXCEL_COLORS: {
+    readonly 'green-50': "FFF0FDF4";
+    readonly 'green-100': "FFDCFCE7";
+    readonly 'green-200': "FFBBF7D0";
+    readonly 'green-300': "FF86EFAC";
+    readonly 'green-400': "FF4ADE80";
+    readonly 'green-500': "FF22C55E";
+    readonly 'blue-50': "FFEFF6FF";
+    readonly 'blue-100': "FFDBEAFE";
+    readonly 'blue-200': "FFBFDBFE";
+    readonly 'blue-300': "FF93C5FD";
+    readonly 'blue-400': "FF60A5FA";
+    readonly 'blue-500': "FF3B82F6";
+    readonly 'gray-50': "FFF9FAFB";
+    readonly 'gray-100': "FFF3F4F6";
+    readonly 'gray-200': "FFE5E7EB";
+    readonly 'gray-300': "FFD1D5DB";
+    readonly 'gray-400': "FF9CA3AF";
+    readonly 'gray-500': "FF6B7280";
+    readonly 'yellow-50': "FFFFFBEB";
+    readonly 'yellow-100': "FFFEF3C7";
+    readonly 'yellow-200': "FFFDE68A";
+    readonly 'yellow-300': "FFFCD34D";
+    readonly 'red-50': "FFFEF2F2";
+    readonly 'red-100': "FFFEE2E2";
+    readonly 'red-200': "FFFECACA";
+    readonly 'red-300': "FFFCA5A5";
+    readonly white: "FFFFFFFF";
+    readonly black: "FF000000";
+    readonly transparent: "00000000";
+};
+declare const Z_EXCEL_DEFAULT_CONFIG: ZExcelDefaultConfig;
+declare const Z_EXCEL_BORDER_THIN: {
+    top: {
+        style: "thin";
+    };
+    left: {
+        style: "thin";
+    };
+    bottom: {
+        style: "thin";
+    };
+    right: {
+        style: "thin";
+    };
+};
+declare const Z_EXCEL_CHAR_WIDTH_MAP: Record<string, number>;
+declare const Z_EXCEL_FONT_MULTIPLIERS: Record<string, number>;
+declare const Z_EXCEL_WIDTH_LIMITS: {
+    min: number;
+    max: number;
+    tableMin: number;
+    tableMax: number;
+    default: number;
+};
+
 interface ZTranslateConfig {
     /** Default language */
     defaultLang?: string;
@@ -412,5 +645,5 @@ interface ZTranslateI18nConfig {
     availableLangs?: string[];
 }
 
-export { ZCacheService, ZHttpAbstractService, ZIndexDbService, ZSubjectService, ZThemeService, ZTranslateService, Z_DARK_MODE_CACHE_KEY, Z_DEFAULT_THEME, Z_THEME_CACHE_KEY, Z_THEME_CONFIG, Z_THEME_CSS_MAP };
-export type { ZCacheConfig, ZCacheEntry, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbStoreConfig, ZThemeConfig, ZThemeName, ZTranslateConfig, ZTranslateI18nConfig };
+export { ZCacheService, ZExcelService, ZHttpAbstractService, ZIndexDbService, ZSubjectService, ZThemeService, ZTranslateService, Z_DARK_MODE_CACHE_KEY, Z_DEFAULT_THEME, 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_THEME_CACHE_KEY, Z_THEME_CONFIG, Z_THEME_CSS_MAP };
+export type { ZCacheConfig, ZCacheEntry, ZExcelAlign, ZExcelCell, ZExcelCellContext, ZExcelColumnConfig, ZExcelConfig, ZExcelDefaultConfig, ZExcelExportOptions, ZExcelExportResult, ZExcelFontConfig, ZExcelFromTableConfig, ZExcelHeaderColors, ZExcelHeaderContext, ZExcelSheetSource, ZExcelTableColumnConfig, ZExcelTableHeaderConfig, ZExcelToastHandler, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbStoreConfig, ZTableToExcelColumn, ZThemeConfig, ZThemeName, ZTranslateConfig, ZTranslateI18nConfig };

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

@@ -1,5 +1,6 @@
 import { WritableSignal } from '@angular/core';
 import { ClassValue } from 'clsx';
+import * as ExcelJS from 'exceljs';
 import { Observable } from 'rxjs';
 import { FormGroup, FormArray } from '@angular/forms';
 
@@ -33,20 +34,28 @@ interface ZFormatNumOptions {
     locale?: 'vi' | 'en';
     placeholder?: string;
 }
+declare const Z_EXCEL_NUMBER_FORMAT_MAP: Record<string, string>;
+interface ZFormatNumExcelOptions {
+    divide?: ZNumberDivide;
+    format?: string;
+    percent?: boolean;
+    emptyCheck?: ZEmptyCheck;
+}
 declare global {
     interface Navigator {
         userAgentData?: ZNavigatorUAData;
     }
 }
+type ZCapitalizeType = 'all' | 'sentence' | 'first';
 
 declare const zMergeClasses: (...inputs: ClassValue[]) => string;
 declare const zTransform: (value: boolean | string) => boolean;
 declare const zGenerateId: (prefix?: string) => string;
 declare const zNoop: () => undefined;
 declare const zFormatNum: (value: unknown, options?: ZFormatNumOptions) => string;
+declare const zFormatNumExcel: (cell: ExcelJS.Cell | undefined, value: unknown, options?: ZFormatNumExcelOptions) => number | undefined;
 declare const zUuid: () => string;
-declare const zCapitalCase: (text: string) => string;
-declare const zIsTextTruncated: (el: HTMLElement) => Promise<boolean>;
+declare const zCapitalCase: (text: string, type?: ZCapitalizeType) => string;
 declare const zDecodeUnicode: (str: string) => string;
 declare const zRandomColor: () => {
     hex: string;
@@ -106,5 +115,5 @@ interface ZFormDebugOptions {
     logLevel?: 'error' | 'warn' | 'log';
 }
 
-export { VIETNAMESE_MAP, Z_DIVIDE_SCALE, Z_LOCALE_MAP, debugFormInvalid, submitForm, zCapitalCase, zCleanObject, zConvertColorToArgb, zDebugFormInvalid, zDecodeUnicode, zDetectBrowser, zFormatNum, zGenerateId, zIsTextTruncated, zMergeClasses, zMiniSearch, zMiniSearch$, zNoop, zRandomColor, zRegisterEchartsTheme, zRemoveVietnamese, zSubmitForm, zTransform, zTreeBuild, zTreeFlatten, zUuid };
-export type { ZBrowserInfo, ZBrowserName, ZDeviceType, ZEchartsThemeOptions, ZEmptyCheck, ZFormDebugOptions, ZFormSubmitResult, ZFormatNumOptions, ZNavigatorUABrandVersion, ZNavigatorUAData, ZNumberDivide };
+export { VIETNAMESE_MAP, Z_DIVIDE_SCALE, Z_EXCEL_NUMBER_FORMAT_MAP, Z_LOCALE_MAP, debugFormInvalid, submitForm, zCapitalCase, zCleanObject, zConvertColorToArgb, zDebugFormInvalid, zDecodeUnicode, zDetectBrowser, zFormatNum, zFormatNumExcel, zGenerateId, zMergeClasses, zMiniSearch, zMiniSearch$, zNoop, zRandomColor, zRegisterEchartsTheme, zRemoveVietnamese, zSubmitForm, zTransform, zTreeBuild, zTreeFlatten, zUuid };
+export type { ZBrowserInfo, ZBrowserName, ZCapitalizeType, ZDeviceType, ZEchartsThemeOptions, ZEmptyCheck, ZFormDebugOptions, ZFormSubmitResult, ZFormatNumExcelOptions, ZFormatNumOptions, ZNavigatorUABrandVersion, ZNavigatorUAData, ZNumberDivide };