@shival99/z-ui 1.0.12 → 1.0.13

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

@@ -3,10 +3,6 @@ import { ClassValue } from 'clsx';
 import { Observable } from 'rxjs';
 import { FormGroup, FormArray } from '@angular/forms';
 
-/**
- * Z-Common Types
- * Common utility types
- */
 type ZBrowserName = 'Chrome' | 'Edge' | 'Firefox' | 'Safari' | 'Opera' | 'IE' | 'Unknown' | string;
 type ZDeviceType = 'mobile' | 'tablet' | 'desktop';
 interface ZBrowserInfo {
@@ -25,68 +21,55 @@ interface ZNavigatorUAData {
     mobile: boolean;
     platform: string;
 }
+type ZNumberDivide = 'none' | 'thousand' | 'million' | 'billion';
+type ZEmptyCheck = 'strict' | 'includeZero';
+declare const Z_DIVIDE_SCALE: Record<ZNumberDivide, number>;
+declare const Z_LOCALE_MAP: Record<string, string>;
+interface ZFormatNumOptions {
+    divide?: ZNumberDivide;
+    format?: string;
+    percent?: boolean;
+    emptyCheck?: ZEmptyCheck;
+    locale?: 'vi' | 'en';
+    placeholder?: string;
+}
 declare global {
     interface Navigator {
         userAgentData?: ZNavigatorUAData;
     }
 }
 
-/**
- * Z-Common Utils
- * Common utility functions for z-ui library
- * All functions are prefixed with 'z' for consistency
- */
-
-/** Merge Tailwind CSS classes with clsx */
 declare const zMergeClasses: (...inputs: ClassValue[]) => string;
-/** Transform boolean-like values to boolean */
 declare const zTransform: (value: boolean | string) => boolean;
-/** Generate a unique ID with optional prefix */
 declare const zGenerateId: (prefix?: string) => string;
 declare const zNoop: () => undefined;
-/** Simple UUID generator */
+declare const zFormatNum: (value: unknown, options?: ZFormatNumOptions) => string;
 declare const zUuid: () => string;
-/** Capitalize each word in a string */
 declare const zCapitalCase: (text: string) => string;
-/** Check if text is truncated (requires element to be rendered) */
 declare const zIsTextTruncated: (el: HTMLElement) => Promise<boolean>;
-/** Decode unicode escape sequences */
 declare const zDecodeUnicode: (str: string) => string;
-/** Generate a random color in hex, rgb, and hsl formats */
 declare const zRandomColor: () => {
     hex: string;
     rgb: string;
     hsl: string;
 };
-/** Convert color string to ARGB format */
 declare const zConvertColorToArgb: (color: string) => string;
-/** Clean null/undefined values from object recursively */
 declare const zCleanObject: <T = unknown>(obj: T) => T;
-/** Flatten tree structure to flat array */
 declare const zTreeFlatten: <T extends Record<string, unknown>>(list: T[], keyMap: keyof T, parentKeyMap: keyof T, sortFn?: (a: T, b: T) => number) => (T & {
     level: number;
     parentsKey: string[];
 })[];
-/** Build tree structure from flat array */
 declare const zTreeBuild: <T extends Record<string, unknown>>(list: T[], keyMap: keyof T, parentKeyMap: keyof T, sortFn?: (a: T, b: T) => number) => (T & {
     level: number;
     parentsKey: string[];
     children: unknown[];
 })[];
-/** Vietnamese character map for normalization */
 declare const VIETNAMESE_MAP: Record<string, string>;
-/** Remove Vietnamese diacritics from string */
 declare const zRemoveVietnamese: (str: string) => string;
-/** Full-text search using MiniSearch */
 declare const zMiniSearch: <T>(data: T[], query: string, fields: (keyof T | string)[]) => T[];
-/** Full-text search as Observable with loading state */
 declare const zMiniSearch$: <T>(data: T[], query: string, fields: (keyof T | string)[], loading?: WritableSignal<boolean>, fakeDelay?: number) => Observable<T[]>;
-/** Detect browser information */
 declare const zDetectBrowser: () => ZBrowserInfo;
 
-/**
- * Z-Echarts Types
- */
 interface ZEchartsThemeOptions {
     /** Theme name (default: 'zTheme') */
     themeName?: string;
@@ -94,23 +77,11 @@ interface ZEchartsThemeOptions {
     fontFamily?: string;
 }
 
-/**
- * Z-Echarts Utils
- * ECharts utility functions
- */
-
 /**
  * Register custom Z-UI theme for ECharts
  * @param options - Theme configuration options
  */
 declare function zRegisterEchartsTheme(options?: ZEchartsThemeOptions): void;
-/** @deprecated Use zRegisterEchartsTheme instead */
-declare const registerEchartsMsgTheme: () => void;
-
-/**
- * Z-Form Utils
- * Form utility functions
- */
 
 /**
  * Submit form and mark invalid controls as dirty
@@ -129,17 +100,11 @@ declare const zDebugFormInvalid: (form: FormGroup, parentKey?: string) => void;
 /** Legacy alias */
 declare const debugFormInvalid: (form: FormGroup, parentKey?: string) => void;
 
-/**
- * Z-Form Types
- * Form utility types
- */
-/** Form submit result */
 type ZFormSubmitResult = boolean;
-/** Form debug options */
 interface ZFormDebugOptions {
     showValid?: boolean;
     logLevel?: 'error' | 'warn' | 'log';
 }
 
-export { VIETNAMESE_MAP, debugFormInvalid, registerEchartsMsgTheme, submitForm, zCapitalCase, zCleanObject, zConvertColorToArgb, zDebugFormInvalid, zDecodeUnicode, zDetectBrowser, zGenerateId, zIsTextTruncated, zMergeClasses, zMiniSearch, zMiniSearch$, zNoop, zRandomColor, zRegisterEchartsTheme, zRemoveVietnamese, zSubmitForm, zTransform, zTreeBuild, zTreeFlatten, zUuid };
-export type { ZBrowserInfo, ZBrowserName, ZDeviceType, ZEchartsThemeOptions, ZFormDebugOptions, ZFormSubmitResult, ZNavigatorUABrandVersion, ZNavigatorUAData };
+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 };

package/types/z-ui.d.ts

@@ -1,4 +1,3 @@
-/** Z-UI library version */
 declare const Z_UI_VERSION = "1.0.1";
 
 export { Z_UI_VERSION };